refactor(controller): invoke agents directly in MCP handler#1855
refactor(controller): invoke agents directly in MCP handler#1855onematchfox wants to merge 2 commits into
Conversation
There was a problem hiding this comment.
Pull request overview
Refactors the controller’s MCP invoke_agent tool path to avoid an HTTP round-trip through the controller’s own A2A listener by invoking agents in-process via a new shared AgentClientRegistry owned/populated by A2ARegistrar.
Changes:
- Added
AgentClientRegistryand wiredA2ARegistrarto keep it in sync with agent add/update/delete events. - Updated MCP handler to send A2A messages via the registry (direct client invocation) and to recover auth sessions from
RequestExtraheaders for token propagation. - Updated app wiring and added MCP auth-propagation tests.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| go/core/pkg/app/app.go | Wires A2ARegistrar and passes its ClientRegistry() into the MCP handler. |
| go/core/internal/mcp/mcp_handler.go | Switches MCP invocation to registry-based A2A client calls; rehydrates auth session from MCP RequestExtra. |
| go/core/internal/mcp/mcp_handler_test.go | Adds coverage for auth propagation behavior through MCP -> A2A. |
| go/core/internal/a2a/agent_client_registry.go | Introduces a thread-safe registry of A2A clients keyed by agent route. |
| go/core/internal/a2a/a2a_registrar.go | Populates/cleans the registry alongside existing mux handler lifecycle. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| // NewMCPHandler creates a new MCP handler that bridges MCP tool calls directly | ||
| // to agent A2A clients, bypassing the controller's own HTTP A2A listener. | ||
| func NewMCPHandler(kubeClient client.Client, agentClients *a2a.AgentClientRegistry, authenticator auth.AuthProvider) (*MCPHandler, error) { | ||
| handler := &MCPHandler{ | ||
| kubeClient: kubeClient, | ||
| a2aBaseURL: a2aBaseURL, | ||
| a2aTimeout: a2aTimeout, | ||
| agentClients: agentClients, | ||
| authenticator: authenticator, | ||
| } |
| @@ -194,7 +189,6 @@ func (h *MCPHandler) handleInvokeAgent(ctx context.Context, req *mcpsdk.CallTool | |||
| }, InvokeAgentOutput{}, nil | |||
| } | |||
| agentRef := agentNS + "/" + agentName | |||
7a6babf to
496c320
Compare
Replace the HTTP round-trip through the controller's own A2A listener with direct invocation via a new `AgentClientRegistry`. The registry is owned by `A2ARegistrar`, which already maintains an `A2AClient` per agent for its HTTP mux — the registry gives the MCP handler access to those same clients without an extra network hop. The old approach routed through the controller's public A2A endpoint, meaning requests could traverse the external network (and any ingress or load-balancer in front of it) unnecessarily. The new path stays in-process. The old handler also cached its own `A2AClient` per agent in a `sync.Map` with no eviction, so clients for deleted agents would remain indefinitely. The registry is kept consistent by the registrar's add/update/delete lifecycle, eliminating that staleness. `A2ARegistrar.upsertAgentHandler` writes to both the HTTP mux (for inbound /api/a2a/<ns>/<name>/ routing) and the registry (for direct invocation). The registry is exposed via `ClientRegistry()` and passed to `NewMCPHandler` in app.go. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Brian Fox <878612+onematchfox@users.noreply.github.com>
496c320 to
b4fde78
Compare
|
Now rebased and adjusted to account for #1853 being closed |
| func (a *A2ARegistrar) ClientRegistry() *AgentClientRegistry { | ||
| return a.clientRegistry | ||
| } |
There was a problem hiding this comment.
I think this can be avoided if we just construct the client registry outside of this component and pass it into here AND the mcp handler, what do you think? I personally prefer injecting dependencies that way.
Replace the HTTP round-trip through the controller's own A2A listener with direct invocation via a new
AgentClientRegistry. The registry is owned byA2ARegistrar, which already maintains anA2AClientper agent for its HTTP mux — the registry gives the MCP handler access to those same clients without an extra network hop.The old approach routed through the controller's public A2A endpoint, meaning requests could traverse the external network (and any ingress or load-balancer in front of it) unnecessarily. The new path stays in-process.
The old handler also cached its own
A2AClientper agent in async.Mapwith no eviction, so clients for deleted agents would remain indefinitely. The registry is kept consistent by the registrar's add/update/delete lifecycle, eliminating that staleness.A2ARegistrar.upsertAgentHandlerwrites to both the HTTP mux (for inbound /api/a2a/// routing) and the registry (for direct invocation). The registry is exposed viaClientRegistry()and passed toNewMCPHandlerin app.go.Note:- currently includes changes from #1853 as well since this needs to adjust the tests added in that PR.