@adhd/agent-mcp 2.0.1 → 2.1.0

package/src/clients/http-client.d.ts

@@ -1,24 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import type { ToolDefinition } from "../providers/types.js";
-import type { McpHttpConfig, McpSseConfig } from "../validation/index.js";
-import type { IMcpClient } from "./types.js";
-declare abstract class BaseHttpMcpClient implements IMcpClient {
-    protected readonly serverName: string;
-    protected client: Client | null;
-    constructor(serverName: string);
-    listTools(): Promise<ToolDefinition[]>;
-    callTool(toolName: string, args: unknown, signal?: AbortSignal): Promise<unknown>;
-    close(): Promise<void>;
-}
-export declare class HttpMcpClient extends BaseHttpMcpClient {
-    private readonly config;
-    constructor(serverName: string, config: McpHttpConfig);
-    connect(): Promise<void>;
-}
-export declare class SseMcpClient extends BaseHttpMcpClient {
-    private readonly config;
-    constructor(serverName: string, config: McpSseConfig);
-    connect(): Promise<void>;
-}
-export {};
-//# sourceMappingURL=http-client.d.ts.map

package/src/clients/http-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAInE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,uBAAe,iBAAkB,YAAW,UAAU;IAGtC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM;IAFjD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAER,UAAU,EAAE,MAAM;IAE3C,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAgBtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B;AAED,qBAAa,aAAc,SAAQ,iBAAiB;IAG5C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADvB,UAAU,EAAE,MAAM,EACD,MAAM,EAAE,aAAa;IAKpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAmBjC;AAED,qBAAa,YAAa,SAAQ,iBAAiB;IAG3C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADvB,UAAU,EAAE,MAAM,EACD,MAAM,EAAE,YAAY;IAKnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA0BjC"}

package/src/clients/http-client.js

@@ -1,98 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
-import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import { ToolError } from "../validation/errors.js";
-class BaseHttpMcpClient {
-    serverName;
-    client = null;
-    constructor(serverName) {
-        this.serverName = serverName;
-    }
-    async listTools() {
-        if (!this.client) {
-            throw new ToolError("MCP_CLIENT_ERROR", `Client '${this.serverName}' not connected`);
-        }
-        const response = await this.client.listTools();
-        return response.tools.map(tool => ({
-            name: tool.name,
-            description: tool.description ?? "",
-            inputSchema: tool.inputSchema ?? {
-                type: "object",
-                properties: {},
-            },
-        }));
-    }
-    async callTool(toolName, args, signal) {
-        if (!this.client) {
-            throw new ToolError("MCP_CLIENT_ERROR", `Client '${this.serverName}' not connected`);
-        }
-        // Thread the caller's cancellation/timeout signal so a task cancel
-        // interrupts this in-flight call (DEBT-003).
-        const result = await this.client.callTool({
-            name: toolName,
-            arguments: args,
-        }, undefined, signal ? { signal } : undefined);
-        if (result.isError) {
-            throw new ToolError("MCP_CLIENT_ERROR", `Tool '${toolName}' on server '${this.serverName}' returned an error: ${JSON.stringify(result.content)}`);
-        }
-        return result.content;
-    }
-    async close() {
-        try {
-            await this.client?.close();
-        }
-        catch {
-            // ignore close errors
-        }
-        this.client = null;
-    }
-}
-export class HttpMcpClient extends BaseHttpMcpClient {
-    config;
-    constructor(serverName, config) {
-        super(serverName);
-        this.config = config;
-    }
-    async connect() {
-        const url = new URL(this.config.url);
-        const transport = new StreamableHTTPClientTransport(url, {
-            requestInit: {
-                headers: this.config.headers,
-                signal: this.config.timeoutMs
-                    ? AbortSignal.timeout(this.config.timeoutMs)
-                    : undefined,
-            },
-        });
-        const client = new Client({ name: "agent-mcp-client", version: "1.0.0" }, { capabilities: {} });
-        this.client = client;
-        await client.connect(transport);
-    }
-}
-export class SseMcpClient extends BaseHttpMcpClient {
-    config;
-    constructor(serverName, config) {
-        super(serverName);
-        this.config = config;
-    }
-    async connect() {
-        const url = new URL(this.config.url);
-        const transport = new SSEClientTransport(url, {
-            eventSourceInit: {
-                fetch: (input, init) => fetch(input, {
-                    ...init,
-                    headers: {
-                        ...init?.headers,
-                        ...this.config.headers,
-                    },
-                    signal: this.config.timeoutMs
-                        ? AbortSignal.timeout(this.config.timeoutMs)
-                        : undefined,
-                }),
-            },
-        });
-        const client = new Client({ name: "agent-mcp-client", version: "1.0.0" }, { capabilities: {} });
-        this.client = client;
-        await client.connect(transport);
-    }
-}
-//# sourceMappingURL=http-client.js.map

package/src/clients/http-client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/http-client.ts"],"names":[],"mappings":"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"}

package/src/clients/in-process.d.ts

@@ -1,27 +0,0 @@
-import type { ToolDefinition } from "../providers/types.js";
-import type { ExecutionContext } from "../validation/index.js";
-import type { IMcpClient } from "./types.js";
-export type InProcessToolHandler = (toolName: string, args: unknown, ctx: ExecutionContext) => Promise<unknown>;
-export type InProcessToolDescriptor = {
-    name: string;
-    description: string;
-    inputSchema: Record<string, unknown>;
-};
-/**
- * InProcessMcpClient routes tool calls directly to runtime handler
- * functions without any network round-trip.
- *
- * This is the client used when an agent definition includes an
- * "agent-mcp" server entry — it allows recursive delegation while
- * preserving the ExecutionContext thread.
- */
-export declare class InProcessMcpClient implements IMcpClient {
-    private readonly tools;
-    private readonly handler;
-    private readonly context;
-    constructor(tools: InProcessToolDescriptor[], handler: InProcessToolHandler, context: ExecutionContext);
-    listTools(): Promise<ToolDefinition[]>;
-    callTool(toolName: string, args: unknown, signal?: AbortSignal): Promise<unknown>;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=in-process.d.ts.map

package/src/clients/in-process.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"in-process.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/in-process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAAG,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,gBAAgB,KACpB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,MAAM,uBAAuB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IAE7C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,KAAK,EAAE,uBAAuB,EAAE,EAChC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,gBAAgB;IAGxC,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAQtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IASjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/src/clients/in-process.js

@@ -1,37 +0,0 @@
-/**
- * InProcessMcpClient routes tool calls directly to runtime handler
- * functions without any network round-trip.
- *
- * This is the client used when an agent definition includes an
- * "agent-mcp" server entry — it allows recursive delegation while
- * preserving the ExecutionContext thread.
- */
-export class InProcessMcpClient {
-    tools;
-    handler;
-    context;
-    constructor(tools, handler, context) {
-        this.tools = tools;
-        this.handler = handler;
-        this.context = context;
-    }
-    async listTools() {
-        return this.tools.map(t => ({
-            name: t.name,
-            description: t.description,
-            inputSchema: t.inputSchema,
-        }));
-    }
-    async callTool(toolName, args, signal) {
-        // If the task was already cancelled/timed out, don't start the in-process
-        // call (which would spin up a recursive sub-task). Mid-flight cancellation
-        // of an in-process sub-task is handled by that sub-task's own cancellation
-        // signal via the task registry, not by this signal. (DEBT-003)
-        signal?.throwIfAborted();
-        return this.handler(toolName, args, this.context);
-    }
-    async close() {
-        // no-op — in-process, nothing to tear down
-    }
-}
-//# sourceMappingURL=in-process.js.map

package/src/clients/in-process.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"in-process.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/in-process.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IAEN;IACA;IACA;IAHrB,YACqB,KAAgC,EAChC,OAA6B,EAC7B,OAAyB;QAFzB,UAAK,GAAL,KAAK,CAA2B;QAChC,YAAO,GAAP,OAAO,CAAsB;QAC7B,YAAO,GAAP,OAAO,CAAkB;IAC3C,CAAC;IAEJ,KAAK,CAAC,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACxB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC7B,CAAC,CAAC,CAAC;IACR,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,IAAa,EAAE,MAAoB;QAChE,0EAA0E;QAC1E,2EAA2E;QAC3E,2EAA2E;QAC3E,+DAA+D;QAC/D,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,KAAK;QACP,2CAA2C;IAC/C,CAAC;CACJ"}

package/src/clients/index.d.ts

@@ -1,7 +0,0 @@
-export type { IMcpClient } from "./types.js";
-export { InProcessMcpClient } from "./in-process.js";
-export type { InProcessToolHandler, InProcessToolDescriptor } from "./in-process.js";
-export { StdioMcpClient } from "./stdio-client.js";
-export { HttpMcpClient, SseMcpClient } from "./http-client.js";
-export { McpClientRegistry } from "./registry.js";
-//# sourceMappingURL=index.d.ts.map

package/src/clients/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/src/clients/index.js

@@ -1,5 +0,0 @@
-export { InProcessMcpClient } from "./in-process.js";
-export { StdioMcpClient } from "./stdio-client.js";
-export { HttpMcpClient, SseMcpClient } from "./http-client.js";
-export { McpClientRegistry } from "./registry.js";
-//# sourceMappingURL=index.js.map

package/src/clients/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/src/clients/registry.d.ts

@@ -1,54 +0,0 @@
-import type { ToolDefinition } from "../providers/types.js";
-import type { ExecutionContext, McpServerConfig } from "../validation/index.js";
-import type { InProcessToolDescriptor, InProcessToolHandler } from "./in-process.js";
-import type { IMcpClient } from "./types.js";
-/**
- * McpClientRegistry — per-task lifetime.
- *
- * Created fresh for each task() call and torn down in the Orchestrator's
- * finally block via closeAll(). Never reused across tasks.
- *
- * Self-referential detection (routes to InProcessMcpClient):
- *   1. Key === "agent-mcp" (always applies)
- *   2. URL matches selfUrl (only when selfUrl is defined — http/sse transport)
- *      When TRANSPORT=stdio, selfUrl is undefined and only condition 1 applies.
- */
-export declare class McpClientRegistry {
-    private readonly mcpServers;
-    private readonly selfUrl;
-    private readonly inProcessDescriptors;
-    private readonly inProcessHandler;
-    private readonly context;
-    private readonly clients;
-    private readonly connectPromises;
-    private readonly toolTargets;
-    constructor(mcpServers: Record<string, McpServerConfig>, selfUrl: string | undefined, inProcessDescriptors: InProcessToolDescriptor[], inProcessHandler: InProcessToolHandler, context: ExecutionContext);
-    private isSelfReferential;
-    /**
-     * Map a (possibly model-normalized) server name back to a configured key.
-     * OpenAI-compatible/local models rewrite '-' → '_', so a tool call to
-     * 'agent_mcp__…' must still resolve to the configured 'agent-mcp' server.
-     */
-    private resolveServerName;
-    private getOrCreateClient;
-    /** Get a client for a specific server, connecting lazily if needed */
-    getClient(name: string): Promise<IMcpClient>;
-    /**
-     * List all tools across all configured servers.
-     * Prefixes each tool name with "<server>__<tool>" for disambiguation.
-     */
-    listAllTools(): Promise<ToolDefinition[]>;
-    /**
-     * Resolve a tool name AS RETURNED BY A MODEL back to its real { server, tool }.
-     * Tries the exact advertised name, then the normalized form (handles models
-     * that rewrite '-' → '_'), then falls back to a literal `__` split for names
-     * the registry never advertised (preserves prior behavior).
-     */
-    resolveToolName(advertised: string): {
-        server: string;
-        tool: string;
-    };
-    /** Tear down all clients — called from Orchestrator's finally block */
-    closeAll(): Promise<void>;
-}
-//# sourceMappingURL=registry.d.ts.map

package/src/clients/registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAIrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAStB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IAIpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuD;gBAG9D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,oBAAoB,EAAE,uBAAuB,EAAE,EAC/C,gBAAgB,EAAE,oBAAoB,EACtC,OAAO,EAAE,gBAAgB;IAG9C,OAAO,CAAC,iBAAiB;IAczB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;YAMX,iBAAiB;IAkD/B,sEAAsE;IAChE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlD;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IA4B/C;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAcrE,uEAAuE;IACjE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAgBlC"}

package/src/clients/registry.js

@@ -1,164 +0,0 @@
-import { logger } from "../logger.js";
-import { InProcessMcpClient } from "./in-process.js";
-import { HttpMcpClient, SseMcpClient } from "./http-client.js";
-import { StdioMcpClient } from "./stdio-client.js";
-import { TOOL_NAME_SEPARATOR, normalizeToolName } from "./tool-naming.js";
-/**
- * McpClientRegistry — per-task lifetime.
- *
- * Created fresh for each task() call and torn down in the Orchestrator's
- * finally block via closeAll(). Never reused across tasks.
- *
- * Self-referential detection (routes to InProcessMcpClient):
- *   1. Key === "agent-mcp" (always applies)
- *   2. URL matches selfUrl (only when selfUrl is defined — http/sse transport)
- *      When TRANSPORT=stdio, selfUrl is undefined and only condition 1 applies.
- */
-export class McpClientRegistry {
-    mcpServers;
-    selfUrl;
-    inProcessDescriptors;
-    inProcessHandler;
-    context;
-    clients = new Map();
-    connectPromises = new Map();
-    // advertised tool name (and its normalized form) → real { server, tool }.
-    // Populated by listAllTools(); lets resolveToolName() recover the real target
-    // even when a model rewrites '-' → '_' in the name it calls back with.
-    toolTargets = new Map();
-    constructor(mcpServers, selfUrl, inProcessDescriptors, inProcessHandler, context) {
-        this.mcpServers = mcpServers;
-        this.selfUrl = selfUrl;
-        this.inProcessDescriptors = inProcessDescriptors;
-        this.inProcessHandler = inProcessHandler;
-        this.context = context;
-    }
-    isSelfReferential(name, config) {
-        if (name === "agent-mcp")
-            return true;
-        if (this.selfUrl &&
-            (config.transport === "http" || config.transport === "sse") &&
-            config.url === this.selfUrl) {
-            return true;
-        }
-        return false;
-    }
-    /**
-     * Map a (possibly model-normalized) server name back to a configured key.
-     * OpenAI-compatible/local models rewrite '-' → '_', so a tool call to
-     * 'agent_mcp__…' must still resolve to the configured 'agent-mcp' server.
-     */
-    resolveServerName(name) {
-        if (this.mcpServers[name])
-            return name;
-        const norm = normalizeToolName(name);
-        return Object.keys(this.mcpServers).find((k) => normalizeToolName(k) === norm) ?? name;
-    }
-    async getOrCreateClient(rawName) {
-        const name = this.resolveServerName(rawName);
-        const existing = this.clients.get(name);
-        if (existing)
-            return existing;
-        const config = this.mcpServers[name];
-        if (!config) {
-            throw new Error(`No MCP server config found for server: '${rawName}'`);
-        }
-        if (this.isSelfReferential(name, config)) {
-            const client = new InProcessMcpClient(this.inProcessDescriptors, this.inProcessHandler, this.context);
-            this.clients.set(name, client);
-            return client;
-        }
-        // Create and connect the appropriate transport client
-        let connectPromise = this.connectPromises.get(name);
-        if (connectPromise) {
-            await connectPromise;
-            return this.clients.get(name);
-        }
-        let client;
-        if (config.transport === "stdio") {
-            client = new StdioMcpClient(name, config);
-        }
-        else if (config.transport === "http") {
-            client = new HttpMcpClient(name, config);
-        }
-        else if (config.transport === "sse") {
-            client = new SseMcpClient(name, config);
-        }
-        else {
-            const exhaustive = config;
-            throw new Error(`Unknown MCP transport: ${exhaustive.transport}`);
-        }
-        connectPromise = client.connect().then(() => {
-            this.clients.set(name, client);
-            logger.debug({ server: name }, "MCP client connected");
-        });
-        this.connectPromises.set(name, connectPromise);
-        await connectPromise;
-        return this.clients.get(name);
-    }
-    /** Get a client for a specific server, connecting lazily if needed */
-    async getClient(name) {
-        return this.getOrCreateClient(name);
-    }
-    /**
-     * List all tools across all configured servers.
-     * Prefixes each tool name with "<server>__<tool>" for disambiguation.
-     */
-    async listAllTools() {
-        const allTools = [];
-        for (const serverName of Object.keys(this.mcpServers)) {
-            try {
-                const client = await this.getOrCreateClient(serverName);
-                const tools = await client.listTools();
-                for (const tool of tools) {
-                    const advertised = `${serverName}${TOOL_NAME_SEPARATOR}${tool.name}`;
-                    const target = { server: serverName, tool: tool.name };
-                    // Index both the advertised name and its normalized form so a
-                    // model that rewrites '-' → '_' still resolves to the real target.
-                    this.toolTargets.set(advertised, target);
-                    this.toolTargets.set(normalizeToolName(advertised), target);
-                    allTools.push({ ...tool, name: advertised });
-                }
-            }
-            catch (error) {
-                logger.warn({ server: serverName, error }, "Failed to list tools from MCP server");
-            }
-        }
-        return allTools;
-    }
-    /**
-     * Resolve a tool name AS RETURNED BY A MODEL back to its real { server, tool }.
-     * Tries the exact advertised name, then the normalized form (handles models
-     * that rewrite '-' → '_'), then falls back to a literal `__` split for names
-     * the registry never advertised (preserves prior behavior).
-     */
-    resolveToolName(advertised) {
-        const hit = this.toolTargets.get(advertised) ??
-            this.toolTargets.get(normalizeToolName(advertised));
-        if (hit)
-            return hit;
-        const i = advertised.indexOf(TOOL_NAME_SEPARATOR);
-        return i === -1
-            ? { server: advertised, tool: advertised }
-            : {
-                server: advertised.slice(0, i),
-                tool: advertised.slice(i + TOOL_NAME_SEPARATOR.length),
-            };
-    }
-    /** Tear down all clients — called from Orchestrator's finally block */
-    async closeAll() {
-        const closePromises = Array.from(this.clients.entries()).map(async ([name, client]) => {
-            try {
-                await client.close();
-                logger.debug({ server: name }, "MCP client closed");
-            }
-            catch (error) {
-                logger.warn({ server: name, error }, "Error closing MCP client");
-            }
-        });
-        await Promise.allSettled(closePromises);
-        this.clients.clear();
-        this.connectPromises.clear();
-    }
-}
-//# sourceMappingURL=registry.js.map

package/src/clients/registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/registry.ts"],"names":[],"mappings":"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"}

package/src/clients/stdio-client.d.ts

@@ -1,16 +0,0 @@
-import type { ToolDefinition } from "../providers/types.js";
-import type { McpStdioConfig } from "../validation/index.js";
-import type { IMcpClient } from "./types.js";
-export declare class StdioMcpClient implements IMcpClient {
-    private readonly serverName;
-    private readonly config;
-    private client;
-    private transport;
-    private childProcess;
-    constructor(serverName: string, config: McpStdioConfig);
-    connect(): Promise<void>;
-    listTools(): Promise<ToolDefinition[]>;
-    callTool(toolName: string, args: unknown, callerSignal?: AbortSignal): Promise<unknown>;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=stdio-client.d.ts.map

package/src/clients/stdio-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stdio-client.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/stdio-client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAAa,cAAe,YAAW,UAAU;IAMzC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAN3B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,YAAY,CAA6B;gBAG5B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc;IAGrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCxB,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAgBtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAgCvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB/B"}

package/src/clients/stdio-client.js

@@ -1,97 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { logger } from "../logger.js";
-import { config } from "../config.js";
-import { ToolError } from "../validation/errors.js";
-export class StdioMcpClient {
-    serverName;
-    config;
-    client = null;
-    transport = null;
-    childProcess = null;
-    constructor(serverName, config) {
-        this.serverName = serverName;
-        this.config = config;
-    }
-    async connect() {
-        const transport = new StdioClientTransport({
-            command: this.config.command,
-            args: this.config.args ?? [],
-            env: {
-                ...config.subprocessEnv(),
-                ...this.config.env,
-            },
-        });
-        this.transport = transport;
-        // Capture child process reference for lifecycle management.
-        // The StdioClientTransport exposes it after start().
-        const client = new Client({ name: "agent-mcp-client", version: "1.0.0" }, { capabilities: {} });
-        this.client = client;
-        await client.connect(transport);
-        // Attach exit handler to the underlying child process.
-        // StdioClientTransport exposes `process` after connect().
-        const childProc = transport.process;
-        if (childProc) {
-            this.childProcess = childProc;
-            childProc.on("exit", (code, signal) => {
-                logger.warn({
-                    server: this.serverName,
-                    exitCode: code,
-                    signal,
-                }, "MCP child process exited unexpectedly");
-            });
-        }
-    }
-    async listTools() {
-        if (!this.client) {
-            throw new ToolError("MCP_CLIENT_ERROR", `Client '${this.serverName}' not connected`);
-        }
-        const response = await this.client.listTools();
-        return response.tools.map(tool => ({
-            name: tool.name,
-            description: tool.description ?? "",
-            inputSchema: tool.inputSchema ?? {
-                type: "object",
-                properties: {},
-            },
-        }));
-    }
-    async callTool(toolName, args, callerSignal) {
-        if (!this.client) {
-            throw new ToolError("MCP_CLIENT_ERROR", `Client '${this.serverName}' not connected`);
-        }
-        // Compose the caller's cancellation/timeout signal (DEBT-003 — lets a
-        // task cancel interrupt this in-flight call) with the client-level
-        // per-call timeout. Either may fire first.
-        const timeoutSignal = this.config.timeoutMs
-            ? AbortSignal.timeout(this.config.timeoutMs)
-            : undefined;
-        const signal = callerSignal && timeoutSignal
-            ? AbortSignal.any([callerSignal, timeoutSignal])
-            : (callerSignal ?? timeoutSignal);
-        const result = await this.client.callTool({ name: toolName, arguments: args }, undefined, signal ? { signal } : undefined);
-        if (result.isError) {
-            throw new ToolError("MCP_CLIENT_ERROR", `Tool '${toolName}' on server '${this.serverName}' returned an error: ${JSON.stringify(result.content)}`);
-        }
-        return result.content;
-    }
-    async close() {
-        try {
-            await this.client?.close();
-        }
-        catch {
-            // ignore close errors
-        }
-        if (this.childProcess && !this.childProcess.killed) {
-            this.childProcess.kill("SIGTERM");
-            // Force-kill after 5 seconds if still alive
-            const killTimer = setTimeout(() => {
-                if (this.childProcess && !this.childProcess.killed) {
-                    this.childProcess.kill("SIGKILL");
-                }
-            }, 5_000);
-            killTimer.unref();
-        }
-    }
-}
-//# sourceMappingURL=stdio-client.js.map

package/src/clients/stdio-client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stdio-client.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/stdio-client.ts"],"names":[],"mappings":"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"}

package/src/clients/tool-naming.d.ts

@@ -1,44 +0,0 @@
-/**
- * Tool-name encoding shared across the registry and the orchestrator.
- *
- * Tools are advertised to the model as `<server>__<tool>`. Many OpenAI-compatible
- * and local models (e.g. LM Studio / qwen) restrict function names to
- * `[A-Za-z0-9_]` and silently rewrite other characters — notably `-` → `_` — so
- * an advertised `agent-mcp__agent` comes back from the model as
- * `agent_mcp__agent`. A literal lookup then fails ("No MCP server config found
- * for server: 'agent_mcp'"), which breaks recursion (the `agent-mcp` key) and any
- * MCP server whose name contains a hyphen. Anthropic preserves the name, so this
- * only bites the OpenAI-compatible providers — but the round-trip must be robust
- * for ALL of them.
- *
- * The fix: index both the advertised name and its normalized form, and normalize
- * the model's returned name the same way before resolving.
- */
-export declare const TOOL_NAME_SEPARATOR = "__";
-/** Normalize a tool name to the charset models restrict function names to. */
-export declare function normalizeToolName(name: string): string;
-export interface ResolvedToolName {
-    server: string;
-    tool: string;
-}
-/**
- * Resolve a tool name AS RETURNED BY A MODEL into { server, tool }.
- *
- * - A qualified `<server>__<tool>` name splits on the separator (prior behavior).
- * - A **bare** `<tool>` name (no separator) is resolved against the tool names the
- *   model was actually advertised: if exactly one advertised tool has that
- *   tool-part it is used; if several do, an actionable error lists the qualified
- *   candidates; if none do, it falls back to a literal split so downstream
- *   "unknown tool / no server config" handling still applies.
- *
- * Background (BACKLOG DEBT-004): capable models frequently emit the bare tool
- * name (`agent` / `task`) instead of the advertised `agent-mcp__agent`, which used
- * to hard-fail the whole task with "Invalid tool name (missing server prefix)".
- * Since the separator is unambiguous in advertised names, a bare name that maps to
- * exactly one advertised tool can be resolved deterministically.
- *
- * @param rawName    the tool name the model returned
- * @param advertised the advertised tool names the model was given (`<server>__<tool>`)
- */
-export declare function resolveToolCallName(rawName: string, advertised?: readonly string[]): ResolvedToolName;
-//# sourceMappingURL=tool-naming.d.ts.map

package/src/clients/tool-naming.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-naming.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/tool-naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB;AAUD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,SAAS,MAAM,EAAO,GAAG,gBAAgB,CAkBzG"}