@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

package/dist/mcp/client/config.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-006: MCP server configuration persistence.
+ *
+ * Read/write/merge server configurations from mcp-servers.json.
+ * Uses the same atomic temp-file + rename pattern as session modules.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMcpServersConfigPath = getMcpServersConfigPath;
+exports.readMcpServersConfig = readMcpServersConfig;
+exports.writeMcpServersConfig = writeMcpServersConfig;
+exports.upsertServerConfig = upsertServerConfig;
+exports.removeServerConfig = removeServerConfig;
+exports.mergeMcpServersConfig = mergeMcpServersConfig;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const types_1 = require("./types");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function emptyServersFile() {
+    return { schemaVersion: types_1.MCP_SERVERS_SCHEMA_VERSION, servers: [] };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Resolve the path to mcp-servers.json within a state directory. */
+function getMcpServersConfigPath(stateDir) {
+    return path.join(stateDir, "mcp-servers.json");
+}
+/** Read server configurations. Returns empty list on missing/corrupt file. */
+async function readMcpServersConfig(stateDir) {
+    const filePath = getMcpServersConfigPath(stateDir);
+    let raw;
+    try {
+        raw = await node_fs_1.promises.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT")
+            return emptyServersFile();
+        return emptyServersFile();
+    }
+    try {
+        const data = JSON.parse(raw);
+        return {
+            schemaVersion: typeof data.schemaVersion === "string" ? data.schemaVersion : types_1.MCP_SERVERS_SCHEMA_VERSION,
+            servers: Array.isArray(data.servers) ? data.servers : [],
+        };
+    }
+    catch {
+        return emptyServersFile();
+    }
+}
+/** Write server configurations atomically. */
+async function writeMcpServersConfig(stateDir, config) {
+    const filePath = getMcpServersConfigPath(stateDir);
+    const dir = path.dirname(filePath);
+    const tempPath = `${filePath}.tmp.${process.pid}`;
+    await node_fs_1.promises.mkdir(dir, { recursive: true });
+    await node_fs_1.promises.writeFile(tempPath, JSON.stringify(config, null, 2), "utf8");
+    await node_fs_1.promises.rename(tempPath, filePath);
+}
+/**
+ * Add or update a server configuration.
+ * If a server with the same name exists, it is replaced.
+ */
+async function upsertServerConfig(stateDir, server) {
+    const config = await readMcpServersConfig(stateDir);
+    const idx = config.servers.findIndex((s) => s.name === server.name);
+    if (idx >= 0) {
+        config.servers[idx] = server;
+    }
+    else {
+        config.servers.push(server);
+    }
+    await writeMcpServersConfig(stateDir, config);
+    return config;
+}
+/** Remove a server configuration by name. Returns true if removed. */
+async function removeServerConfig(stateDir, serverName) {
+    const config = await readMcpServersConfig(stateDir);
+    const before = config.servers.length;
+    config.servers = config.servers.filter((s) => s.name !== serverName);
+    if (config.servers.length === before)
+        return false;
+    await writeMcpServersConfig(stateDir, config);
+    return true;
+}
+/**
+ * Merge an array of server configs into the existing configuration.
+ * Servers with matching names are replaced; new ones are appended.
+ */
+async function mergeMcpServersConfig(stateDir, incoming) {
+    const config = await readMcpServersConfig(stateDir);
+    for (const server of incoming) {
+        const idx = config.servers.findIndex((s) => s.name === server.name);
+        if (idx >= 0) {
+            config.servers[idx] = server;
+        }
+        else {
+            config.servers.push(server);
+        }
+    }
+    await writeMcpServersConfig(stateDir, config);
+    return config;
+}

package/dist/mcp/client/executor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-TOOLS-025: MCP Tool Executor.
+ *
+ * Executes MCP tools via the McpClientManager, providing a simplified
+ * interface for tool invocation with timing and error handling.
+ */
+import type { McpToolResult } from "./types";
+import type { McpClientManager } from "./manager";
+export interface McpToolExecutionRequest {
+    /** Server name (must be connected). */
+    serverName: string;
+    /** Tool name as exposed by the server. */
+    toolName: string;
+    /** Tool arguments. */
+    args: Record<string, unknown>;
+}
+export declare class McpToolExecutor {
+    private readonly _manager;
+    constructor(manager: McpClientManager);
+    /** Execute an MCP tool and return the result with timing. */
+    execute(request: McpToolExecutionRequest): Promise<McpToolResult>;
+    /**
+     * Execute an MCP tool by qualified name "server:tool".
+     * Convenience wrapper around execute().
+     */
+    executeByQualifiedName(qualifiedName: string, args: Record<string, unknown>): Promise<McpToolResult>;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/mcp/client/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/mcp/client/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAMlD,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;gBAEhC,OAAO,EAAE,gBAAgB;IAIrC,6DAA6D;IACvD,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBvE;;;OAGG;IACG,sBAAsB,CAC1B,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC;CAe1B"}

package/dist/mcp/client/executor.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-TOOLS-025: MCP Tool Executor.
+ *
+ * Executes MCP tools via the McpClientManager, providing a simplified
+ * interface for tool invocation with timing and error handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpToolExecutor = void 0;
+// ---------------------------------------------------------------------------
+// McpToolExecutor
+// ---------------------------------------------------------------------------
+class McpToolExecutor {
+    _manager;
+    constructor(manager) {
+        this._manager = manager;
+    }
+    /** Execute an MCP tool and return the result with timing. */
+    async execute(request) {
+        const start = Date.now();
+        try {
+            const result = await this._manager.callTool(request.serverName, request.toolName, request.args);
+            return {
+                ...result,
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                content: [{ type: "text", text: message }],
+                error: message,
+                durationMs: Date.now() - start,
+            };
+        }
+    }
+    /**
+     * Execute an MCP tool by qualified name "server:tool".
+     * Convenience wrapper around execute().
+     */
+    async executeByQualifiedName(qualifiedName, args) {
+        const colonIdx = qualifiedName.indexOf(":");
+        if (colonIdx < 0) {
+            return {
+                success: false,
+                content: [{ type: "text", text: `Invalid qualified tool name "${qualifiedName}" — expected "server:tool"` }],
+                error: `Invalid qualified tool name "${qualifiedName}" — expected "server:tool"`,
+            };
+        }
+        return this.execute({
+            serverName: qualifiedName.slice(0, colonIdx),
+            toolName: qualifiedName.slice(colonIdx + 1),
+            args,
+        });
+    }
+}
+exports.McpToolExecutor = McpToolExecutor;

package/dist/mcp/client/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-006: MCP Client barrel exports.
+ */
+export type { McpTransportType, McpServerConfig, McpServersFile, McpConnectionStatus, McpServerConnection, McpToolParameterSchema, McpToolInfo, McpToolResult, } from "./types";
+export { MCP_SERVERS_SCHEMA_VERSION } from "./types";
+export { getMcpServersConfigPath, readMcpServersConfig, writeMcpServersConfig, upsertServerConfig, removeServerConfig, mergeMcpServersConfig, } from "./config";
+export { McpClientManager, type McpClientTransport, type McpTransportFactory, type McpClientManagerOptions, } from "./manager";
+export { McpToolRegistry, type McpToolRegistryOptions, } from "./toolRegistry";
+export { McpToolExecutor, type McpToolExecutionRequest, } from "./executor";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAGrD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC"}

package/dist/mcp/client/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-006: MCP Client barrel exports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpToolExecutor = exports.McpToolRegistry = exports.McpClientManager = exports.mergeMcpServersConfig = exports.removeServerConfig = exports.upsertServerConfig = exports.writeMcpServersConfig = exports.readMcpServersConfig = exports.getMcpServersConfigPath = exports.MCP_SERVERS_SCHEMA_VERSION = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "MCP_SERVERS_SCHEMA_VERSION", { enumerable: true, get: function () { return types_1.MCP_SERVERS_SCHEMA_VERSION; } });
+// Config persistence
+var config_1 = require("./config");
+Object.defineProperty(exports, "getMcpServersConfigPath", { enumerable: true, get: function () { return config_1.getMcpServersConfigPath; } });
+Object.defineProperty(exports, "readMcpServersConfig", { enumerable: true, get: function () { return config_1.readMcpServersConfig; } });
+Object.defineProperty(exports, "writeMcpServersConfig", { enumerable: true, get: function () { return config_1.writeMcpServersConfig; } });
+Object.defineProperty(exports, "upsertServerConfig", { enumerable: true, get: function () { return config_1.upsertServerConfig; } });
+Object.defineProperty(exports, "removeServerConfig", { enumerable: true, get: function () { return config_1.removeServerConfig; } });
+Object.defineProperty(exports, "mergeMcpServersConfig", { enumerable: true, get: function () { return config_1.mergeMcpServersConfig; } });
+// Client manager
+var manager_1 = require("./manager");
+Object.defineProperty(exports, "McpClientManager", { enumerable: true, get: function () { return manager_1.McpClientManager; } });
+// Tool registry
+var toolRegistry_1 = require("./toolRegistry");
+Object.defineProperty(exports, "McpToolRegistry", { enumerable: true, get: function () { return toolRegistry_1.McpToolRegistry; } });
+// Tool executor
+var executor_1 = require("./executor");
+Object.defineProperty(exports, "McpToolExecutor", { enumerable: true, get: function () { return executor_1.McpToolExecutor; } });

package/dist/mcp/client/manager.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-006: MCP Client Manager.
+ *
+ * Manages named MCP server connections with connect/disconnect lifecycle,
+ * status tracking, and optional reconnection. The manager does NOT directly
+ * depend on @modelcontextprotocol/sdk/client — instead it uses a pluggable
+ * transport factory so tests and consumers can inject their own.
+ */
+import type { McpServerConfig, McpServerConnection, McpToolInfo, McpToolResult } from "./types";
+/**
+ * Minimal transport interface that the manager uses to interact with
+ * an MCP server. Consumers provide a factory that creates these.
+ */
+export interface McpClientTransport {
+    /** Connect to the server. Throws on failure. */
+    connect(): Promise<void>;
+    /** Disconnect gracefully. */
+    disconnect(): Promise<void>;
+    /** List available tools. */
+    listTools(): Promise<McpToolInfo[]>;
+    /** Call a tool by name with arguments. */
+    callTool(toolName: string, args: Record<string, unknown>): Promise<McpToolResult>;
+}
+/** Factory function that creates a transport for a given server config. */
+export type McpTransportFactory = (config: McpServerConfig) => McpClientTransport;
+export interface McpClientManagerOptions {
+    /** State directory for reading mcp-servers.json. */
+    stateDir: string;
+    /** Factory for creating transports. */
+    transportFactory: McpTransportFactory;
+    /** Injectable delay function for testing (default: setTimeout-based). */
+    delayFn?: (ms: number) => Promise<void>;
+}
+export declare class McpClientManager {
+    private readonly _stateDir;
+    private readonly _transportFactory;
+    private readonly _delay;
+    private readonly _connections;
+    private _initialized;
+    constructor(options: McpClientManagerOptions);
+    /** Initialize the manager: load server configs, optionally auto-connect. */
+    initialize(autoConnect?: boolean): Promise<void>;
+    /** Connect to a named server. Deduplicates concurrent connect attempts. */
+    connect(serverName: string): Promise<McpServerConnection>;
+    /**
+     * Attempt reconnection for a server that was previously connected.
+     * Retries up to maxReconnectAttempts with exponential backoff.
+     * Deduplicates concurrent reconnect calls.
+     * Returns the final connection state (may be 'error' if all retries exhausted).
+     */
+    reconnect(serverName: string): Promise<McpServerConnection>;
+    /** Disconnect from a named server. */
+    disconnect(serverName: string): Promise<McpServerConnection>;
+    /** Disconnect all servers and release resources. */
+    disconnectAll(): Promise<void>;
+    /** Get connection status for a named server. */
+    getConnection(serverName: string): McpServerConnection | undefined;
+    /** List all tracked connections. */
+    listConnections(): McpServerConnection[];
+    /** List tools available on a connected server. */
+    listTools(serverName: string): Promise<McpToolInfo[]>;
+    /** Call a tool on a connected server. */
+    callTool(serverName: string, toolName: string, args: Record<string, unknown>): Promise<McpToolResult>;
+    /** Whether the manager has been initialized. */
+    get initialized(): boolean;
+    /** Get the config for a server. */
+    getServerConfig(serverName: string): McpServerConfig | undefined;
+    private _doReconnect;
+    private _doConnect;
+    private _setStatus;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/mcp/client/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/mcp/client/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EAEnB,WAAW,EACX,aAAa,EACd,MAAM,SAAS,CAAC;AAOjB;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,6BAA6B;IAC7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,4BAA4B;IAC5B,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACnF;AAED,2EAA2E;AAC3E,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,eAAe,KAAK,kBAAkB,CAAC;AAMlF,MAAM,WAAW,uBAAuB;IACtC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAuBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsB;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,uBAAuB;IAM5C,4EAA4E;IACtE,UAAU,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBtD,2EAA2E;IACrE,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuB/D;;;;;OAKG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAwBjE,sCAAsC;IAChC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqBlE,oDAAoD;IAC9C,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC,gDAAgD;IAChD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIlE,oCAAoC;IACpC,eAAe,IAAI,mBAAmB,EAAE;IAIxC,kDAAkD;IAC5C,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQ3D,yCAAyC;IACnC,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC;IAQzB,gDAAgD;IAChD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,mCAAmC;IACnC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;YAQlD,YAAY;YAgCZ,UAAU;IAsBxB,OAAO,CAAC,UAAU;CAInB"}

package/dist/mcp/client/manager.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-006: MCP Client Manager.
+ *
+ * Manages named MCP server connections with connect/disconnect lifecycle,
+ * status tracking, and optional reconnection. The manager does NOT directly
+ * depend on @modelcontextprotocol/sdk/client — instead it uses a pluggable
+ * transport factory so tests and consumers can inject their own.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpClientManager = void 0;
+const config_1 = require("./config");
+/** Default delay (ms) between reconnection attempts. */
+const RECONNECT_BASE_DELAY_MS = 1000;
+// ---------------------------------------------------------------------------
+// McpClientManager
+// ---------------------------------------------------------------------------
+const defaultDelay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+class McpClientManager {
+    _stateDir;
+    _transportFactory;
+    _delay;
+    _connections = new Map();
+    _initialized = false;
+    constructor(options) {
+        this._stateDir = options.stateDir;
+        this._transportFactory = options.transportFactory;
+        this._delay = options.delayFn ?? defaultDelay;
+    }
+    /** Initialize the manager: load server configs, optionally auto-connect. */
+    async initialize(autoConnect) {
+        const file = await (0, config_1.readMcpServersConfig)(this._stateDir);
+        for (const config of file.servers) {
+            this._connections.set(config.name, {
+                config,
+                connection: {
+                    name: config.name,
+                    status: "disconnected",
+                    lastStatusChange: new Date().toISOString(),
+                    reconnectAttempts: 0,
+                },
+                transport: undefined,
+                connectPromise: undefined,
+            });
+        }
+        this._initialized = true;
+        if (autoConnect) {
+            const autoServers = file.servers.filter((s) => s.autoConnect);
+            await Promise.allSettled(autoServers.map((s) => this.connect(s.name)));
+        }
+    }
+    /** Connect to a named server. Deduplicates concurrent connect attempts. */
+    async connect(serverName) {
+        const record = this._connections.get(serverName);
+        if (!record) {
+            throw new Error(`MCP server "${serverName}" not found in configuration`);
+        }
+        if (record.connection.status === "connected") {
+            return record.connection;
+        }
+        // Deduplicate in-flight connect attempts
+        if (record.connectPromise) {
+            return record.connectPromise;
+        }
+        record.connectPromise = this._doConnect(record);
+        try {
+            return await record.connectPromise;
+        }
+        finally {
+            record.connectPromise = undefined;
+        }
+    }
+    /**
+     * Attempt reconnection for a server that was previously connected.
+     * Retries up to maxReconnectAttempts with exponential backoff.
+     * Deduplicates concurrent reconnect calls.
+     * Returns the final connection state (may be 'error' if all retries exhausted).
+     */
+    async reconnect(serverName) {
+        const record = this._connections.get(serverName);
+        if (!record) {
+            throw new Error(`MCP server "${serverName}" not found in configuration`);
+        }
+        const maxAttempts = record.config.maxReconnectAttempts ?? 3;
+        if (!record.config.reconnect || maxAttempts <= 0) {
+            throw new Error(`Reconnection is not enabled for server "${serverName}"`);
+        }
+        // Deduplicate concurrent reconnect calls
+        if (record.connectPromise) {
+            return record.connectPromise;
+        }
+        record.connectPromise = this._doReconnect(record, maxAttempts);
+        try {
+            return await record.connectPromise;
+        }
+        finally {
+            record.connectPromise = undefined;
+        }
+    }
+    /** Disconnect from a named server. */
+    async disconnect(serverName) {
+        const record = this._connections.get(serverName);
+        if (!record) {
+            throw new Error(`MCP server "${serverName}" not found in configuration`);
+        }
+        if (record.transport) {
+            try {
+                await record.transport.disconnect();
+            }
+            catch {
+                // Best-effort disconnect
+            }
+            record.transport = undefined;
+        }
+        record.connectPromise = undefined;
+        this._setStatus(record, "disconnected");
+        record.connection.error = undefined;
+        return record.connection;
+    }
+    /** Disconnect all servers and release resources. */
+    async disconnectAll() {
+        const names = [...this._connections.keys()];
+        await Promise.allSettled(names.map((n) => this.disconnect(n)));
+    }
+    /** Get connection status for a named server. */
+    getConnection(serverName) {
+        return this._connections.get(serverName)?.connection;
+    }
+    /** List all tracked connections. */
+    listConnections() {
+        return [...this._connections.values()].map((r) => r.connection);
+    }
+    /** List tools available on a connected server. */
+    async listTools(serverName) {
+        const record = this._connections.get(serverName);
+        if (!record?.transport || record.connection.status !== "connected") {
+            throw new Error(`MCP server "${serverName}" is not connected`);
+        }
+        return record.transport.listTools();
+    }
+    /** Call a tool on a connected server. */
+    async callTool(serverName, toolName, args) {
+        const record = this._connections.get(serverName);
+        if (!record?.transport || record.connection.status !== "connected") {
+            throw new Error(`MCP server "${serverName}" is not connected`);
+        }
+        return record.transport.callTool(toolName, args);
+    }
+    /** Whether the manager has been initialized. */
+    get initialized() {
+        return this._initialized;
+    }
+    /** Get the config for a server. */
+    getServerConfig(serverName) {
+        return this._connections.get(serverName)?.config;
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    async _doReconnect(record, maxAttempts) {
+        this._setStatus(record, "reconnecting");
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            record.connection.reconnectAttempts = attempt;
+            // Exponential backoff: 1s, 2s, 4s, ...
+            const delayMs = RECONNECT_BASE_DELAY_MS * Math.pow(2, attempt - 1);
+            await this._delay(delayMs);
+            const transport = this._transportFactory(record.config);
+            record.transport = transport;
+            try {
+                await transport.connect();
+                this._setStatus(record, "connected");
+                record.connection.connectedAt = new Date().toISOString();
+                record.connection.reconnectAttempts = 0;
+                record.connection.error = undefined;
+                return record.connection;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                record.connection.error = message;
+                record.transport = undefined;
+            }
+        }
+        // All retries exhausted
+        this._setStatus(record, "error");
+        return record.connection;
+    }
+    async _doConnect(record) {
+        this._setStatus(record, "connecting");
+        const transport = this._transportFactory(record.config);
+        record.transport = transport;
+        try {
+            await transport.connect();
+            this._setStatus(record, "connected");
+            record.connection.connectedAt = new Date().toISOString();
+            record.connection.reconnectAttempts = 0;
+            record.connection.error = undefined;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            this._setStatus(record, "error");
+            record.connection.error = message;
+            record.transport = undefined;
+            throw err;
+        }
+        return record.connection;
+    }
+    _setStatus(record, status) {
+        record.connection.status = status;
+        record.connection.lastStatusChange = new Date().toISOString();
+    }
+}
+exports.McpClientManager = McpClientManager;

package/dist/mcp/client/toolRegistry.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Status: NOT INTEGRATED YET
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-TOOLS-025: MCP Tool Registry.
+ *
+ * Maintains a cached index of tools across all connected MCP servers.
+ * Supports refresh, search, and lookup by qualified name (server:tool).
+ */
+import type { McpToolInfo } from "./types";
+import type { McpClientManager } from "./manager";
+export interface McpToolRegistryOptions {
+    /** TTL for cached tool listings (ms). 0 = never expire (infinite cache). Default: 60000. */
+    cacheTtlMs?: number;
+}
+export declare class McpToolRegistry {
+    private readonly _manager;
+    private readonly _cacheTtlMs;
+    private readonly _cache;
+    constructor(manager: McpClientManager, options?: McpToolRegistryOptions);
+    /**
+     * Refresh tool listings from all connected servers.
+     * Returns the total number of tools indexed.
+     */
+    refreshAll(): Promise<number>;
+    /** Refresh tools for a specific server. */
+    refreshServer(serverName: string): Promise<McpToolInfo[]>;
+    /**
+     * Get all known tools across all servers.
+     * Returns cached data when available and not expired.
+     */
+    getAllTools(): McpToolInfo[];
+    /** Get tools for a specific server from cache. */
+    getToolsForServer(serverName: string): McpToolInfo[];
+    /**
+     * Search tools by name or description substring (case-insensitive).
+     * Searches across all cached servers.
+     */
+    searchTools(query: string): McpToolInfo[];
+    /**
+     * Look up a tool by qualified name "serverName:toolName".
+     * Returns undefined if not found in cache.
+     */
+    getToolByQualifiedName(qualifiedName: string): McpToolInfo | undefined;
+    /** Clear the entire cache. */
+    clearCache(): void;
+    /** Number of non-expired tools currently in cache (across all servers). */
+    get cachedToolCount(): number;
+    private _isExpired;
+}
+//# sourceMappingURL=toolRegistry.d.ts.map

package/dist/mcp/client/toolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../../src/mcp/client/toolRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAMlD,MAAM,WAAW,sBAAsB;IACrC,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAWD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;gBAE/C,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAKvE;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAgBnC,2CAA2C;IACrC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAM/D;;;OAGG;IACH,WAAW,IAAI,WAAW,EAAE;IAS5B,kDAAkD;IAClD,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE;IAMpD;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE;IAUzC;;;OAGG;IACH,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAYtE,8BAA8B;IAC9B,UAAU,IAAI,IAAI;IAIlB,2EAA2E;IAC3E,IAAI,eAAe,IAAI,MAAM,CAO5B;IAMD,OAAO,CAAC,UAAU;CAInB"}