feat(agents): add azd ai agent delete command

[v1212]

Summary

Adds azd ai agent delete [name] command to delete a hosted agent from the Foundry service.

Fixes #8520

CLI Help

Delete a hosted agent and all of its versions.

If the agent has active sessions, deletion will fail unless --force is passed.
Use --force to terminate active sessions and delete the agent.

The agent name is resolved from the azd environment when omitted.

Usage:
  agent delete [name] [flags]

Examples:
  # Delete agent (auto-resolves name from azure.yaml)
  azd ai agent delete

  # Delete a specific agent by name
  azd ai agent delete my-agent

  # Force-delete even if active sessions exist
  azd ai agent delete my-agent --force

Flags:
      --force   Force deletion even if the agent has active sessions
  -h, --help    help for delete

Global Flags:
  -C, --cwd string           Sets the current working directory
      --debug                Enables debug and diagnostics logging
  -e, --environment string   The name of the environment to use
      --no-prompt            Runs without prompts
  -o, --output string        The output format (supported: json, none) (default "none")

Behavior

Scenario	Result
azd ai agent delete	Auto-resolves agent name from azure.yaml, deletes (fails if active sessions)
azd ai agent delete my-agent	Deletes the named agent (fails if active sessions)
azd ai agent delete --force	Force-deletes, terminates any active sessions
azd ai agent delete --output json	Returns structured JSON response
Agent not found	Error: agent not found, suggests azd ai agent show
Active sessions exist (no --force)	Error: suggests --force or azd ai agent sessions delete

API Mapping (Vienna)

DELETE /agents/{agentName}?api-version=v1&force={true|false}

Source: AgentController.cs:649 - [FromQuery] bool force = false

Note: No [FoundryFeatures(...)] gate on DeleteAgent (management-plane operation).

Changes

File	Change
cmd/delete.go	New delete command implementation
cmd/delete_test.go	Command structure tests (args, flags)
cmd/root.go	Register newDeleteCommand
agent_api/operations.go	Add force bool param to DeleteAgent()
agent_api/operations_test.go	Tests for force=true/false URL encoding, 404 handling
exterrors/codes.go	Add OpDeleteAgent, CodeAgentNotFound, CodeAgentHasActiveSessions

Testing

• All existing tests pass (no breaking changes to DeleteAgent callers - there were none)
• New tests verify:
  • Command accepts 0 or 1 positional arg, rejects 2+
  • --force flag registered with default=false
  • DeleteAgent client sends correct force=true / force=false in URL query
  • 404 response returns error

[github-actions]

📋 Prioritization Note

Thanks for the contribution! The linked issue isn't in the current milestone yet.
Review may take a bit longer — reach out to @rajeshkamal5050 or @kristenwomack if you'd like to discuss prioritization.

[Copilot]

Pull request overview

Adds a new azd ai agent delete [name] command to the Azure AI Agents extension to delete a hosted agent (optionally force-deleting when active sessions exist), and wires the underlying client operation + error codes needed to support the UX.

Changes:

• Add agent delete cobra command and action implementation (including --force and --output json/none).
• Extend AgentClient.DeleteAgent to include a force query parameter and add URL/404 tests.
• Introduce delete-specific external error codes + operation name and register the new command in the root command tree.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
cli/azd/extensions/azure.ai.agents/internal/pkg/agents/agent_api/operations.go	Extends DeleteAgent API call to include force query parameter.
cli/azd/extensions/azure.ai.agents/internal/pkg/agents/agent_api/operations_test.go	Adds tests for force=true/false query encoding and 404 behavior.
cli/azd/extensions/azure.ai.agents/internal/exterrors/codes.go	Adds delete operation name and delete-specific validation error codes.
cli/azd/extensions/azure.ai.agents/internal/cmd/root.go	Registers the new delete command under the extension root.
cli/azd/extensions/azure.ai.agents/internal/cmd/delete.go	Implements the new agent delete command, confirmation prompt, error mapping, output formatting, and env-var cleanup.
cli/azd/extensions/azure.ai.agents/internal/cmd/delete_test.go	Adds basic command shape tests (args + --force flag presence/default).

[v1212]

Addressed Copilot review comments:

Comment 1 (name resolution): This follows the same pattern as \show, \invoke, \monitor, and \session\ commands they all pass the positional arg to
esolveAgentServiceFromProject\ which uses it as the azure.yaml service name to look up the deployed agent name from env vars. This is the established convention in this extension.

Comment 2 (cancellation handling): Fixed now returns \�xterrors.Cancelled()\ instead of printing to stdout. Consistent with the rest of the codebase.

Comment 3 (test coverage): Added error classification tests for 404 \CodeAgentNotFound, 409 \CodeAgentHasActiveSessions\ (verifying suggestion mentions --force), and 500 \ServiceError. Same pattern as session_test.go.