feat(toolboxes): support RemoteA2A and GroundingWithCustomSearch tool types

[hund030]

Summary

Extends azd ai toolbox with two additional project-connection categories so they can be attached as toolbox tools. Follow-up to #8203, which shipped the toolbox surface with RemoteTool (MCP) and CognitiveSearch (Azure AI Search).

Project connection category	Toolbox tools[].type	Extra per-tool input
RemoteA2A	a2a_preview	none
GroundingWithCustomSearch	web_search (with custom_search_configuration)	--instance-name (Bing custom-search instance)

Changes

New tool types

• New ConnectionType constants RemoteA2A and GroundingWithCustomSearch in internal/foundry/connections.
• buildToolEntry gains two cases plus an instanceName parameter; cross-category flag validation (--index rejected outside CognitiveSearch, --instance-name rejected outside GroundingWithCustomSearch) is centralized at the top of the function and trims whitespace once so --index " " is treated as empty.
• New --instance-name flag on toolbox connection add; new instance_name field on the --from-file connection spec; --from-file mode rejects both flags with a clear error.
• Refreshed help text, --from-file JSON/YAML examples, and the "unsupported category" error message. Fixed pre-existing stale azd ai toolbox add usage strings to azd ai toolbox connection add.
• Two new error codes: missing_instance_name, unsupported_instance_name_flag.

Display-layer plumbing

• toolEntryReferences now recognizes custom_search_configuration.project_connection_id, so connection remove and duplicate detection work for web_search tools.
• extractConnectionTools (toolbox connection list) emits rows for a2a_preview and the connection-backed web_search variant; built-in web_search (no custom_search_configuration) is still skipped.
• describeToolDetail (toolbox show table) is now type-agnostic: any entry with a connection ID surfaces as (connection:<id>), otherwise (builtin). New connection-backed tool shapes recognized by toolEntryReferences are surfaced automatically.

Validation

• Unit tests pin the JSON shape of each new tool entry, required-input validation, whitespace-trim behavior, and extractConnectionTools rows for all five entry shapes including malformed cases (internal/cmd/toolbox_helpers_test.go).
• Live end-to-end against a Foundry project: azd ai toolbox create --from-file published a single version with mcp + a2a_preview + web_search entries; subsequent connection remove calls peeled each off (the toolEntryReferences fix was caught by this run).
• BrowserTool is intentionally not included: the service-side ARM contract for that category is not yet deployed in test regions; tracked separately.

Out of scope

• BrowserTool (browser_automation_preview) — pending service rollout.
• BingCustomSearch (bing_custom_search_preview) — separate category with its own search_configurations[] shape.
• A2APreviewTool.base_url / agent_card_path — defer until requested.

[Copilot]

Pull request overview

This PR extends the azure.ai.toolboxes azd extension to support attaching two additional Foundry project-connection categories as toolbox tools: RemoteA2A (emitted as a2a_preview) and GroundingWithCustomSearch (emitted as web_search with custom_search_configuration.instance_name).

Changes:

• Adds new connection category constants and corresponding buildToolEntry cases, including --instance-name support and centralized cross-category flag validation.
• Expands tool connection reference detection to include custom_search_configuration.project_connection_id so remove/duplicate detection works for web_search.
• Updates file input schema/help and adds/updates unit tests to cover new tool entry shapes and validation paths.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
cli/azd/extensions/azure.ai.toolboxes/internal/foundry/connections/client.go	Adds new connection category constants for tool-capable connections.
cli/azd/extensions/azure.ai.toolboxes/internal/exterrors/codes.go	Introduces error codes for missing/unsupported --instance-name.
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_shared.go	Extends connection-id reference scanning to cover web_search nested configuration.
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_helpers_test.go	Updates helper tests for new tool shapes and removal/duplicate detection.
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_help.go	Updates --from-file examples and supported category documentation.
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_files.go	Extends connection spec schema with instance_name.
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_create.go	Wires InstanceName through when building tool entries from file specs.
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_connection.go	Adds new tool entry builders and centralizes flag/category validation.
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_connection_add.go	Adds --instance-name flag and validates incompatibility with --from-file.
cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_commands_test.go	Updates buildToolEntry callsites for new signature.

[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

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

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (2)

cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_show.go:180

• The comment for firstConnectionID is now stale: the function delegates to toolEntryReferences, which also recognizes top-level project_connection_id on a2a_preview and nested custom_search_configuration.project_connection_id on web_search. Update the comment so it matches the actual recognized shapes (or refer to toolEntryReferences’ doc) to avoid misleading future changes.

// firstConnectionID returns the first project_connection_id referenced by a
// tool entry — top-level on `mcp` tools, or nested under
// azure_ai_search.indexes[] for search tools.
func firstConnectionID(tool map[string]any) string {

cli/azd/extensions/azure.ai.toolboxes/internal/cmd/toolbox_connection_list.go:99

• The new a2a_preview extraction path isn’t covered by tests. Consider extending the existing connection list tests (e.g., TestRunConnectionListWith_EmitsAllShapes) to include an a2a_preview tool entry and assert it appears in the JSON/table output rows, so regressions in this switch are caught.

		toolType, _ := t["type"].(string)
		toolName, _ := t["name"].(string)
		switch toolType {
		case "mcp", "a2a_preview":
			if id, ok := t["project_connection_id"].(string); ok && id != "" {
				rows = append(rows, map[string]string{
					"name":          toolName,
					"connection":    shortConnectionName(id),
					"connection_id": id,
					"type":          toolType,
				})

[trangevi]

/check-enforcer override