Azure AI Agents: add next-step guidance and doctor diagnostics#8198

Open

antriksh30 wants to merge 84 commits into

antriksh30:antrikshjain/next-step-implementation

Commits on May 20, 2026

chore: ignore local design-spec mirror folder (.tmp/)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): scaffold nextstep package and isTerminal helper

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add AssembleState to nextstep package

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): scope nextstep state to azure.ai.agent services

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add nextstep resolver, OpenAPI extractor, and error vocabulary

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): apply consensus fixes to nextstep resolver

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): clarify shellEscapeSingleQuoted doc comment

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): drop stale line reference in shellEscapeSingleQuoted doc

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): silent fetchOpenAPISpec + wire cache-only OpenAPI probe

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): detect missing env vars during nextstep state assembly

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): exclude defaulted env refs from missing-vars detection

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): wire init success path to nextstep resolver

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): reserve trailing slot in nextstep renderer for follow-up nudges

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents/nextstep): trailing collision now keeps the most-deferred footer

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents/run): resolver-driven Next: block on local run

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): align local OpenAPI cache key + restore "After startup" preamble

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): resolve local agent service once in invocationsLocal (no double prompt)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): wire invoke.go success paths to nextstep.ResolveAfterInvoke

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): TTY-gate Next: emission in invoke success helper

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): wire invoke failure paths to ResolveAfterInvoke

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): gate invocations-protocol failure Next: by HTTP status

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents/nextstep): match AgentVersionStatus wire values to API

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents/cmd): wire show.go to nextstep resolver

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents/cmd/show): drop dead nil guard + doubled blank line

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): correctness fixes from 2.6 cross-pollinated review

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): correct divergent-name invoke suggestion (G3)

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): close symmetric G3 in invoke-success suggestion (G4)

Antriksh Jain
and
Copilot
committed
chore(azure.ai.agents): doc + test cleanup from 2.6/2.6.3/2.6.4 reviews

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): include api-version on remote OpenAPI spec fetch
Antriksh Jain
committed
feat(azure.ai.agents): add FormatNextForNote renderer for artifact embeds

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): wire deploy-hook Next: block on host artifact

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): scope deploy-hook Next: block to deployed service + canonical README

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): scaffold doctor package types and runner

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): apply 4.1 consensus review fixes for doctor package

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): align doctor types to design spec

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): doctor local checks 1-3 (grpc-extension, azure-yaml, environment-selected)

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): doctor local checks — 3-of-3 review fix-ups (transport-error suggestions, unparseable-version message, version-agnostic Suggestion)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add doctor local checks 4-6 (agent service, project endpoint, agent.yaml)

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): doctor checks 5-6 — 3-of-3 review fix-ups (skip-cascade + production-equivalent YAML validation)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): wire azd ai agent doctor command

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): doctor next-step accuracy + comment correctness (review fix-ups)

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): ResolveAfterInit suggests `azd provision` when project endpoint is unset

Antriksh Jain
and
Copilot
committed
feat(nextstep): surface {{NAME}} placeholders left over in agent.yaml

Antriksh Jain
and
Copilot
committed
[azure.ai.agents] nextstep: surface every fix-up category after init/doctor, broaden placeholder regex

Antriksh Jain
and
Copilot
committed
[azure.ai.agents] agent_yaml: name the unresolved placeholders in the post-substitution warning

Antriksh Jain
and
Copilot
committed
Fix premature unresolved-placeholder warning during init

Antriksh Jain
and
Copilot
committed
feat(extensions/azure.ai.agents): suggest `azd provision` after init's deploy-new path

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): pending-provision reasons foundation (4.11)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): tag model_deployment pending provision (4.12)

Antriksh Jain
and
Copilot
committed
fix(azure.ai.agents): route init-from-code trailer through nextstep (4.12.1)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): migrate project trailer to pending-provision tag (4.13)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): tag acr + app_insights pending provision (4.14)

Antriksh Jain
and
Copilot
committed
test(azure.ai.agents): cover "drain last pending-provision tag" path (4.14.1)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): classify infra vs manual vars via Bicep outputs (5.1.C1)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): enrich manual-vars Next: block with run follow-up (P5.1 C3)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add monitor --follow secondary after invoke --local success (P5.1 C4)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): align `show` non-Active branches with issue #7975 vocabulary (P5.1 C5)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): qualify single-agent post-deploy `Next:` block (P5.1 C6, fix B9)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add invoke-local secondary to init "everything ready" Next: (P5.1 C7)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add doctor check `local.manual-env-vars` (P5.1 C9)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): scaffold doctor remote-check pipeline (P5.1 C10)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add doctor check remote.auth (P5.1 C11)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add doctor check remote.foundry-endpoint (P5.1 C12)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add doctor check remote.rbac (P5.1 C16)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add doctor check remote.agent-status (P5.1 C17)

Antriksh Jain
and
Copilot
committed
Phase 5 commit C8: run live OpenAPI probe + post-bind Next: emission

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): add doctor check remote.agent-identity-roles (P5.1 C12)

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): walk agent.manifest.yaml into nextstep.State (P5.1 C2)

Antriksh Jain
and
Copilot
committed
Phase 5 C13: doctor `remote.model-deployments` check

Antriksh Jain
and
Copilot
committed
feat(azure.ai.agents): doctor local.toolboxes check (P5.1 C14)

Antriksh Jain
and
Copilot
committed
azd ai agent doctor: add remote.connections check (C15)

Antriksh Jain
and
Copilot
committed
azd ai agent doctor: address 3-reviewer pass on C13/C14/C15

Antriksh Jain
and
Copilot
committed
azd ai agent next: prefer README payload placeholder

Antriksh Jain
and
Copilot
committed
azd ai agent show: omit next_step for active agents

Antriksh Jain
and
Copilot
committed
azd ai agent doctor: stream text checks

Antriksh Jain
and
Copilot
committed
azd ai agents: trim verbose comments

Antriksh Jain
and
Copilot
committed
azd ai agents: fix doctor CI failures

Antriksh Jain
and
Copilot
committed
azd ai agents: restore existing comments

Antriksh Jain
and
Copilot
committed
azd ai agents: validate service-relative paths
Antriksh Jain
committed
azd ai agents: remove unused nextstep auth state

Antriksh Jain
and
Copilot
committed
azd ai agents: centralize nextstep stdout gating

Antriksh Jain
and
Copilot
committed
azd ai agents: redact doctor auth UPN by default

Antriksh Jain
and
Copilot
committed
azd ai agents: pin AgentVersionIdle wire value in nextstep test

Antriksh Jain
and
Copilot
committed
azd ai agents: restore .tmp/ gitignore entry and untrack scratch files

Antriksh Jain
and
Copilot
committed