[dotnet-port-api] Forward A2A request config to hosted agents

[Michelle Clayton (michelle-clayton-work)]

Summary

Ported the .NET hosted-A2A request-configuration forwarding behavior so Go hosted agents can observe inbound message/send configuration. This adds agent.WithAdditionalProperties, adds a2aprovider.NewHandler plus a2aprovider.WithRequestConfigForwarding(), forwards request metadata/config into hosted-agent run options under a2aprovider.RequestConfigurationPropertyKey, and updates the hosted A2A example and parity docs.

Ported .NET PRs

• .NET: Forward A2A MessageSendParams.Configuration in the A2A adapter agent-framework#7365 - forward inbound A2A MessageSendParams.configuration to hosted agents
• Upstream commit: 2694120383be5e9e152b36b02e27b79b379970cf

Breaking Changes

No.

Tests and Examples

• go test ./agent ./provider/a2aprovider ./examples/05-end-to-end/a2a_client_server/a2a_server
• Added hosted A2A tests covering forwarded request metadata/config and preserved server-controlled run mode
• Updated examples/05-end-to-end/a2a_client_server/a2a_server/main.go to use a2aprovider.NewHandler

Notes

• a2aprovider.NewHandler enables request-config forwarding by default for hosted A2A handlers.
• Lower-level integrations that still call a2asrv.NewHandler(a2aprovider.NewExecutor(...)) can opt in explicitly with a2aprovider.WithRequestConfigForwarding().
• This keeps Go aligned with the upstream hosted-A2A behavior without changing server-side background-response policy.

Generated by .NET to Go API Porting Agent · 1.6K AIC · ⌖ 26.8 AIC · ⊞ 21.7K · ◷

Closes #765

[Copilot]

🟢 Approval recommended

The change set is cohesive and tested, with only a minor non-blocking performance nit (redundant map cloning) noted.

Pull request overview

Ports the hosted-A2A request configuration forwarding behavior so Go hosted agents can observe inbound message/send configuration and request metadata via agent run options, aligning with upstream .NET behavior.

Changes:

• Added agent.WithAdditionalProperties to carry provider/protocol-specific request metadata into an agent run.
• Introduced a2aprovider.NewHandler and a2aprovider.WithRequestConfigForwarding() to forward inbound A2A configuration into hosted-agent run options under a2aprovider.RequestConfigurationPropertyKey.
• Updated hosted A2A tests, the end-to-end hosted A2A example, and parity docs to reflect the new handler helper and forwarding behavior.

File summaries

File	Description
agent/options.go	Adds WithAdditionalProperties option for passing request metadata into agent runs.
provider/a2aprovider/executor.go	Forwards request metadata into hosted-agent run options.
provider/a2aprovider/handler.go	New helper handler + interceptor to inject request config into metadata under a stable key.
provider/a2aprovider/hosting_test.go	Adds coverage for metadata/config forwarding and run-mode preservation.
examples/05-end-to-end/a2a_client_server/a2a_server/main.go	Migrates sample to a2aprovider.NewHandler.
docs/dotnet-go-sdk-feature-comparison.md	Updates feature parity notes for hosted A2A forwarding behavior.

Review details

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

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Michelle Clayton (michelle-clayton-work)]

Copilot resolve merge conflicts and address PR feedback

[Copilot]

Copilot resolve merge conflicts and address PR feedback

Resolved the merge conflicts and addressed the metadata-cloning feedback in 84bfcc9; added the required workflow permission fix in c214815.

[github-actions]

Scope: public API, user-visible behavior, examples

Changed Go contract:

• agent.WithAdditionalProperties(props map[string]any) Option (new exported run option)
• a2aprovider.NewHandler(hostedAgent *agent.Agent, cfg ExecutorConfig, options ...a2asrv.RequestHandlerOption) a2asrv.RequestHandler (new)
• a2aprovider.WithRequestConfigForwarding() a2asrv.RequestHandlerOption (new)
• a2aprovider.RequestConfigurationPropertyKey = "a2a.configuration" (new)
• executor.newRunOptions now forwards execCtx.Metadata via agent.WithAdditionalProperties
• examples/05-end-to-end/a2a_client_server/a2a_server/main.go updated to use a2aprovider.NewHandler

Upstream evidence reviewed:

• dotnet/src/Microsoft.Agents.AI.Hosting.A2A/A2AAgentHandler.cs — CreateRunOptions(RequestContext, ...) unconditionally sets AgentRunOptions.AdditionalProperties["a2a.configuration"] = context.Configuration whenever context.Configuration is non-null, for all three request paths (HandleNewMessageAsync, HandleTaskUpdateAsync, streaming). No opt-in flag gates this in A2AAgentHandler or A2AServerRegistrationOptions.cs.
• dotnet/tests/Microsoft.Agents.AI.Hosting.A2A.UnitTests/A2AAgentHandlerTests.cs (via PR #7365) — verifies config forwarding is on by default.
• .NET: Forward A2A MessageSendParams.Configuration in the A2A adapter agent-framework#7365 — confirms this is an unconditional default-on forward, matching the Go PR's a2aprovider.NewHandler default.

Result: aligned

The Go port's default-on config forwarding via a2aprovider.NewHandler matches the .NET A2AAgentHandler.CreateRunOptions behavior, which also forwards MessageSendParams.Configuration unconditionally with no opt-in gate. The Go WithRequestConfigForwarding() escape hatch for lower-level a2asrv.NewHandler(a2aprovider.NewExecutor(...)) integrations is a reasonable Go-specific accommodation and doesn't diverge from upstream semantics, since upstream has no equivalent lower-level composition seam to gate. agent.WithAdditionalProperties is a straightforward parallel to AgentRunOptions.AdditionalProperties, and naming (RequestConfigurationPropertyKey / ConfigurationPropertyKey, same "a2a.configuration" string value) is consistent. No behavior or naming divergence found.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• github.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "github.com"

See Network Configuration for more information.

Generated by Go API Consistency Review Agent for #999 · copilot · auto · 44.2 AIC · ⌖ 5.39 AIC · ⊞ 9.5K · ◷