feat(ai): add Invocations protocol lifecycle support by m5i-work · Pull Request #9901 · Azure/azure-dev

Wei Meng (m5i-work) · 2026-09-07T08:15:56Z

Summary

Extends the shared lifecycle command group from #9900 with support for the Invocations wire protocol. It does not introduce another command group.

routes invocations show --protocol invocations to one GET
routes invocations cancel --protocol invocations to the cancel POST
accepts the shared --id selector; protocol can instead be inferred from the selected agent or --agent-endpoint
saves only the current Invocation ID, separately from the current Response ID
preserves existing synchronous, SSE, raw, and 202 Accepted polling behavior on create, including the accepted-body restoration used for ID extraction
rejects invocations follow --protocol invocations and invoke --long-running --protocol invocations for now
keeps new Invocations lifecycle/identity/state helpers in invoke_invocation.go and shared command dispatch in invocations.go; existing create, sync/SSE, and polling methods stay in invoke.go to avoid relocation-only diff
preserves explicit target selection without changing current state

CLI

azd ai agent invoke "message" --protocol invocations
azd ai agent invocations show --protocol invocations [--id <id>]
azd ai agent invocations cancel --protocol invocations [--id <id>]

The protocol need not be repeated when inferable. Explicit IDs work with protocol endpoint URLs without local state. Lifecycle requests do not inherit a saved session or create context.

Validation

go test ./...
go build ./...
go fix ./...
focused race tests
shared resolver tests verify endpoint-derived protocol selection and independent current IDs
scripted HTTP dispatch tests verify Invocations GET/cancel methods and rejection of unsupported follow without network requests
existing ID extraction, body restoration, raw, and LRO tests

Earlier live validation against the supplied Invocations reference agent passed create/poll and one-shot retrieval. That reference agent returns cancel_invocation not implemented for cancel, so successful cancellation cannot be live-validated against it.

Base: #9900
Fixes #9780
Part of #9676
Supersedes #9706.

Interactive scenarios

Uses the offline invocation help/validation scenarios introduced in #9900. Shared PR impact mapping changes are deferred to #9996. No new live/cloud test infrastructure or scenario execution is included.

Approval boundary

This PR no longer changes .github/skills/foundry-extension-scenario-pr-regression/references/impact-mapping.md. All mapping additions and its line-ending cleanup are isolated in follow-up #9996, so separate .github/ owner approval does not block this feature PR.

azure-pipelines · 2026-09-07T08:16:21Z

Azure Pipelines: Successfully started running 1 pipeline(s). 21 pipeline(s) were filtered out due to trigger conditions. There may be pipelines that require an authorized user to comment /azp run to run.

Wei Meng (m5i-work) · 2026-09-07T10:30:11Z

Live E2E validation

Built and installed the full stack with azd x build, then tested against the supplied longrun-invocations-v2-ref endpoint using {"steps":3,"delay_ms":200}.

Passed:

existing 202 Accepted behavior captured the Invocation ID, polled, and completed all 3 steps
invocations show --invocation-id ... --output table returned the completed Invocation
implicit invocations show selected the saved current Invocation and returned the full JSON result
lifecycle GET worked using only the Invocation ID/current endpoint, without persisted session context

Reference-agent limitation:

POST /invocations/{id}/cancel returned HTTP 404 with cancel_invocation not implemented. The CLI surfaced a classified cancellation failure. This supplied reference agent validates create/poll and one-shot GET, but cannot validate the successful cancel path; that path remains unit-tested.

Copilot

🟡 Changes recommended

A new Go line exceeds the repo’s enforced 125-character limit (lll) and is expected to fail linting until wrapped.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review details

Files reviewed: 11/11 changed files
Comments generated: 1
Review effort level: Lite

Copilot

🟢 Approval recommended

The implementation is coherent and well-covered by targeted tests, with only minor documentation wording to consider.

Review details

Files reviewed: 11/11 changed files
Comments generated: 1
Review effort level: Lite

Copilot

🟡 Changes recommended

There is a concrete resource-handling issue in invoke.go where defer resp.Body.Close() is registered before invocationIDFromResponse may replace resp.Body, leading to inconsistent closing behavior.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Review details

Files reviewed: 12/12 changed files
Comments generated: 1
Review effort level: Lite

Copilot

Copilot reviewed 11 out of 11 changed files in this pull request and generated no new comments.

…eaders

…tion

Travis Angevine (trangevi) · 2026-09-11T17:17:39Z

+	if err != nil {
+		return err
+	}
+	if resp.StatusCode < http.StatusBadRequest && invocationID != "" && rc.azdClient != nil && agentKey != "" {


[azd-code-reviewer][low] Add a test that exercises this create-to-current-ID wiring, not only invocationIDFromResponse and the store in isolation. The current tests would still pass if this call were removed, used the wrong agentKey, saved after an HTTP failure, or skipped raw/202 responses. Cover a successful header ID, a body-only 202 ID, and preservation of the previous selection on an error response so the PR’s core persistence behavior is protected end to end.

Travis Angevine (trangevi) · 2026-09-11T17:17:39Z

+	if err != nil {
+		return fmt.Errorf("read Invocation cancel result: %w", err)
+	}
+	if resp.StatusCode >= http.StatusBadRequest {


[azd-code-reviewer][low] Cover the terminal-state fallback in the Invocations HTTP tests. The existing cancel cases exercise a successful POST and an active Invocation after a rejected POST, but not this branch where the GET reports completed, failed, or cancelled and the command intentionally converts the rejection into success. That behavior is part of the lifecycle contract and is implemented separately from the already-tested Responses path.

azure-sdk-automation · 2026-09-11T18:43:38Z

azure.ai.agents PR build

Note

This is an unsigned development build. Install it only if you trust this PR.

Install the extension:

azd ext install "https://azuresdkartifacts.z5.web.core.windows.net/azd/extensions/pr/9901/azure-ai-agents.zip"

Version: 1.0.0-beta.14.pr.9901.6818578
Merge commit: 9b4f1c6

Wei Meng (m5i-work) requested review from JeffreyCA, Glenn Harper (glharper), Hui Miao (huimiu), Zhijie Huang (hund030), John Miller (therealjohn), Travis Angevine (trangevi) and JianW (v1212) as code owners September 7, 2026 08:15

microsoft-github-policy-service Bot assigned Wei Meng (m5i-work) Sep 7, 2026

This was referenced Sep 7, 2026

Support long-running agent work with unified invocation lifecycle commands #9676

Open

feat(ai): retrieve the latest saved Invocation #9706

Closed

Retrieve the latest saved Invocation #9780

Open

github-actions Bot added the ext-agents azure.ai.agents extension label Sep 7, 2026

Wei Meng (m5i-work) marked this pull request as draft September 7, 2026 08:50

Wei Meng (m5i-work) force-pushed the m5i/9676-invocations-primitives branch 4 times, most recently from ad72ff7 to 6b86614 Compare September 7, 2026 10:23

Wei Meng (m5i-work) force-pushed the m5i/9676-invocations-primitives branch 2 times, most recently from 646639b to 7e303a9 Compare September 8, 2026 08:15

Wei Meng (m5i-work) mentioned this pull request Sep 8, 2026

feat(ai): add unified invocation lifecycle commands #9900

Merged

Wei Meng (m5i-work) force-pushed the m5i/9676-invocations-primitives branch from 7e303a9 to 08a31fc Compare September 9, 2026 06:39

Wei Meng (m5i-work) changed the title ~~feat(ai): add orthogonal Invocations primitives~~ feat(ai): add Invocations protocol lifecycle support Sep 9, 2026

Wei Meng (m5i-work) force-pushed the m5i/9676-invocations-primitives branch 5 times, most recently from 0a7758c to 0538801 Compare September 10, 2026 04:48

Copilot AI reviewed Sep 10, 2026

View reviewed changes

Comment thread cli/azd/extensions/azure.ai.agents/internal/cmd/invoke_invocation.go

Copilot AI review requested due to automatic review settings September 10, 2026 06:04

Wei Meng (m5i-work) force-pushed the m5i/9676-invocations-primitives branch from 4a1187a to 4b64798 Compare September 10, 2026 06:04

Copilot started reviewing on behalf of Wei Meng (m5i-work) September 10, 2026 06:04 View session

Copilot AI reviewed Sep 10, 2026

View reviewed changes

Comment thread cli/azd/extensions/azure.ai.agents/docs/specs/long-running-agent-invoke.md Outdated

Copilot AI review requested due to automatic review settings September 10, 2026 06:26

Wei Meng (m5i-work) force-pushed the m5i/9676-invocations-primitives branch from 4b64798 to 8f55bc0 Compare September 10, 2026 06:26

Wei Meng (m5i-work) requested review from Rick Winter (RickWinter), Daniel Jurek (danieljurek), Richard Park (richardpark-msft), tg-msft and Victor Vazquez (vhvb1989) as code owners September 10, 2026 06:26

Copilot started reviewing on behalf of Wei Meng (m5i-work) September 10, 2026 06:27 View session

Copilot AI reviewed Sep 10, 2026

View reviewed changes

Comment thread cli/azd/extensions/azure.ai.agents/internal/cmd/invoke.go

Travis Angevine (trangevi) reviewed Sep 10, 2026

View reviewed changes

Comment thread cli/azd/extensions/azure.ai.agents/internal/cmd/invoke_invocation.go

Comment thread cli/azd/extensions/azure.ai.agents/internal/cmd/invoke_invocation.go Outdated

Wei Meng (m5i-work) force-pushed the m5i/9676-invocations-primitives branch from 8f55bc0 to c27f607 Compare September 11, 2026 01:26

Copilot AI review requested due to automatic review settings September 11, 2026 01:26

Copilot started reviewing on behalf of Wei Meng (m5i-work) September 11, 2026 01:27 View session

Wei Meng (m5i-work) mentioned this pull request Sep 11, 2026

docs(ai): map invocation lifecycle scenarios to PR changes #9996

Open

Copilot AI reviewed Sep 11, 2026

View reviewed changes

Wei Meng (m5i-work) force-pushed the m5i/9676-invocations-primitives branch from c27f607 to 326c28c Compare September 11, 2026 01:37

Base automatically changed from m5i/9676-responses-primitives to main September 11, 2026 04:01

Wei Meng (m5i-work) added 4 commits September 11, 2026 12:01

feat(ai): support Invocations protocol in shared lifecycle commands

43cb4f0

refactor(ai): document Invocation helpers and drop lifecycle custom h…

9e1ddf8

…eaders

docs(ai): clarify Invocation behavior and scenario mapping

b650178

fix(ai): validate Invocation headers and explain unsupported cancella…

b176807

…tion

Wei Meng (m5i-work) force-pushed the m5i/9676-invocations-primitives branch from 326c28c to b176807 Compare September 11, 2026 04:01

Travis Angevine (trangevi) approved these changes Sep 11, 2026

View reviewed changes

Navigation Menu

Uh oh!

feat(ai): add Invocations protocol lifecycle support - #9901

feat(ai): add Invocations protocol lifecycle support#9901
Wei Meng (m5i-work) wants to merge 4 commits into
mainfrom
m5i/9676-invocations-primitives

Wei Meng (m5i-work) commented Sep 7, 2026 •

edited

Loading

Uh oh!

azure-pipelines Bot commented Sep 7, 2026

Uh oh!

Wei Meng (m5i-work) commented Sep 7, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Travis Angevine (trangevi) Sep 11, 2026

Uh oh!

Travis Angevine (trangevi) Sep 11, 2026

Uh oh!

azure-sdk-automation Bot commented Sep 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

Wei Meng (m5i-work) commented Sep 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

CLI

Validation

Interactive scenarios

Approval boundary

Uh oh!

azure-pipelines Bot commented Sep 7, 2026

Uh oh!

Wei Meng (m5i-work) commented Sep 7, 2026

Live E2E validation

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟢 Approval recommended

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Travis Angevine (trangevi) Sep 11, 2026

Choose a reason for hiding this comment

Uh oh!

Travis Angevine (trangevi) Sep 11, 2026

Choose a reason for hiding this comment

Uh oh!

azure-sdk-automation Bot commented Sep 11, 2026

azure.ai.agents PR build

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Wei Meng (m5i-work) commented Sep 7, 2026 •

edited

Loading