Skip to content

[docs] Update documentation for features from 2026-03-19#5

Open
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/update-2026-03-19-58f09b25ff6617fa
Open

[docs] Update documentation for features from 2026-03-19#5
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/update-2026-03-19-58f09b25ff6617fa

Conversation

@github-actions

Copy link
Copy Markdown

Documentation Updates - 2026-03-19

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

  • CopilotService gRPC API (from #7172) — New gRPC service enabling extensions to interact with GitHub Copilot agent capabilities programmatically.
  • azure.ai.agents v0.1.16-preview (from #7141, #7175, #7181) — New file operations commands and breaking change to show/monitor commands.

Changes Made

  • Updated cli/azd/docs/extensions/extension-framework.md:
    • Added Copilot Service to both Table of Contents sections (top-level and gRPC Services section)
    • Added full Copilot Service documentation section covering all 7 RPCs: Initialize, ListSessions, SendMessage, GetUsageMetrics, GetFileChanges, GetMessages, and StopSession
    • Includes message schemas, field descriptions, Go usage example, and use cases
  • Updated cli/azd/extensions/azure.ai.agents/CHANGELOG.md:
    • Added 0.1.16-preview release entry with new features and breaking changes

Merged PRs Referenced

  • #7172 — feat: add CopilotService gRPC service for extension framework
  • #7141 — [Agent Extension] Add file operations for hosted agent sessions
  • #7175 — fix: improve input validation, error handling, and path safety
  • #7181 — [Agents Extension] Update show and monitor commands to not require parameters
  • #7190 — Prepare azure.ai.agents 0.1.16-preview patch release

Notes

Generated by Daily Documentation Updater ·

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/daily-doc-updater.md@346204513ecfa08b81566450d7d599556807389f
  • expires on Mar 21, 2026, 7:58 PM UTC

- Add CopilotService gRPC service documentation to extension-framework.md
- Add azure.ai.agents 0.1.16-preview CHANGELOG entry

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels Mar 19, 2026
@github-actions
github-actions Bot requested a review from weikanglim as a code owner March 19, 2026 19:58
@github-actions github-actions Bot added documentation Improvements or additions to documentation automation labels Mar 19, 2026
weikanglim pushed a commit that referenced this pull request Apr 13, 2026
…zure#7501)

* fix: gracefully handle missing AKS cluster during postprovision hook

When infrastructure doesn't include AKS resources, the postprovision
lifecycle hook in the AKS service target fails fatally trying to set up
the Kubernetes context. This is expected in multi-phase provisioning
workflows where AKS gets provisioned later.

Modified setK8sContext() to detect the postprovision event and skip
gracefully (with a user-visible warning) instead of failing when:
- GetTargetResource returns an error (resource not found)
- Target resource has an empty name (SupportsDelayedProvisioning)
- Cluster credentials are unavailable (ensureClusterContext fails)
- Namespace creation fails (ensureNamespace fails)

The predeploy event path is unchanged and still fails fatally, ensuring
deployment-time errors are not masked.

Extracted skipPostprovisionK8sSetup() helper to eliminate repeated
warning/log/return-nil pattern across all four skip points.

Fixes Azure#3272

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* address review: propagate ctx cancellation, add namespace failure test

- skipPostprovisionK8sSetup now checks ctx.Err() before returning nil
  to avoid swallowing context cancellation/timeouts (Ctrl+C)
- Added Test_Postprovision_Skips_When_Namespace_Fails covering the
  ensureNamespace failure path during postprovision

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* refactor: address MQ review — typed constant, DRY helper, ctx cancellation test

- Replace magic string 'postprovision' with typed postProvisionEvent constant
- Extract postprovisionK8sError() helper to eliminate 4 identical if-blocks
- Add nil-guard on targetResource before calling ResourceName()
- Fix log.Printf double newline and redundant .Error() call
- Add Test_Postprovision_Propagates_Context_Cancellation to cover
  the ctx.Err() safety valve in skipPostprovisionK8sSetup

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: address review feedback — event guards, constants, test assertions

- Route targetResource==nil through event-aware postprovisionK8sError
  so predeploy doesn't silently skip (thread #1, High)
- Add preDeployEvent constant replacing raw "predeploy" strings for
  consistency with postProvisionEvent (thread #2)
- Add console message assertions to graceful-skip tests verifying the
  warning was actually emitted (thread #3)
- Add predeploy failure tests for credential and namespace error paths
  confirming errors propagate for non-postprovision events (thread #4)
- Refactor createAksServiceTarget to delegate to
  createAksServiceTargetWithResourceManager, eliminating ~40 lines of
  duplication (thread #5)
- Add structured telemetry span (AksPostprovisionSkipEvent) to the
  graceful-skip path for production monitoring (thread #6)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: address re-review - telemetry span, DRY assertions, ErrorContains

- Use span.End() with skip.reason attribute instead of EndWithStatus()
  to avoid marking intentional skips as errors in telemetry dashboards
- Extract assertSkipWarningEmitted helper to deduplicate console
  assertion blocks across two test functions
- Add ErrorContains assertion in Test_Predeploy_Fails_When_Credentials_Fail
  for consistency with sibling namespace test

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: narrow postprovision graceful skip to not-found only

Address @weikanglim's feedback: limit the graceful skip path to
the explicit delayed-provisioning case (empty ResourceName) only.
GetTargetResource, ensureClusterContext, and ensureNamespace errors
now propagate during postprovision — real failures are no longer masked.

Removed postprovisionK8sError helper. Fixed gofmt import ordering.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants