fixo-cli 1.0.0

package/dist/agent/hooks.js

@@ -0,0 +1,214 @@
+/**
+ * hooks.ts — PreToolUse / PostToolUse hook engine.
+ *
+ * Phase 3.4 spec:
+ *   - Two hook events supported: `PreToolUse` and `PostToolUse`.
+ *     No `Stop`, `Notification`, or `SessionStart` (PRD §3.4
+ *     hard rule).
+ *   - Storage: `<cwd>/.fixo/hooks.json`. Schema is a map of
+ *     event name → list of hook commands.
+ *   - Hooks are *sync* `spawn` calls. The hook command's
+ *     stdin receives a JSON document of the form
+ *     `{event, tool, args, sessionId}`. The command's stdout
+ *     (if any) is parsed as JSON
+ *     `{decision, reason?, modifiedArgs?}`. A non-zero exit
+ *     is treated as a deny with a default reason.
+ *   - Pre-hook decisions: `allow` (pass), `deny` (block),
+ *     `modify` (replace args before re-validation).
+ *   - Post-hook decisions: `allow` (no-op), `deny` (force
+ *     the result to be marked as denied — the tool has
+ *     already executed, but the post-hook can flag it).
+ *     `modifiedArgs` on a post-hook is not honoured (the
+ *     tool has already run).
+ *   - After a pre-hook `modify`, the modified args are
+ *     re-validated through `WorkspaceGuard.resolve()` to
+ *     guard against hook escape attempts.
+ *   - A 5-second wall-clock timeout protects against
+ *     runaway hooks.
+ *   - Every fired hook emits a `hook_fired` telemetry event
+ *     with the decision and the duration.
+ */
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { recordTelemetry, telemetry } from './telemetry.js';
+import { WorkspaceGuard } from '../workspace-guard.js';
+const DEFAULT_TIMEOUT_MS = 5000;
+const HOOKS_PATH_FOR = (cwd) => path.join(cwd, '.fixo', 'hooks.json');
+/** Read `.fixo/hooks.json` from cwd. Returns null if absent. */
+export function loadHooksFile(cwd) {
+    const p = HOOKS_PATH_FOR(cwd);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        const raw = JSON.parse(fs.readFileSync(p, 'utf-8'));
+        if (raw.version !== 1 || !Array.isArray(raw.hooks))
+            return null;
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+/** Save the hooks file. Used by /hooks slash command. */
+export function saveHooksFile(cwd, file) {
+    const p = HOOKS_PATH_FOR(cwd);
+    try {
+        fs.mkdirSync(path.dirname(p), { recursive: true });
+        fs.writeFileSync(p, JSON.stringify(file, null, 2));
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, error: err.message };
+    }
+}
+/** Hooks for a given event. */
+export function getHooksForEvent(cwd, event) {
+    const file = loadHooksFile(cwd);
+    if (!file)
+        return [];
+    return file.hooks.filter(h => h.event === event && (h.enabled ?? true));
+}
+/**
+ * Run a single hook synchronously with a 5s default timeout.
+ * The hook's stdin receives the JSON payload; the stdout
+ * (if present) is parsed as a HookCommandResult.
+ */
+function runHook(spec, payload, timeoutMs) {
+    const payloadJson = JSON.stringify(payload);
+    let result;
+    try {
+        result = spawnSync(spec.command, spec.args ?? [], {
+            input: payloadJson,
+            encoding: 'utf-8',
+            timeout: timeoutMs,
+            maxBuffer: 1024 * 1024, // 1 MiB stdout cap
+        });
+    }
+    catch (err) {
+        return { decision: 'deny', reason: `hook failed to spawn: ${err.message}` };
+    }
+    if (result.error) {
+        return { decision: 'deny', reason: `hook error: ${result.error.message}` };
+    }
+    if (result.status !== 0) {
+        const stderrText = typeof result.stderr === 'string' ? result.stderr : '';
+        return {
+            decision: 'deny',
+            reason: `hook exited with status ${result.status}${stderrText ? `: ${stderrText.slice(0, 200)}` : ''}`,
+        };
+    }
+    const stdout = (typeof result.stdout === 'string' ? result.stdout : '').trim();
+    if (stdout.length === 0) {
+        // Hook succeeded with no output → default allow.
+        return { decision: 'allow' };
+    }
+    try {
+        const parsed = JSON.parse(stdout);
+        const decision = parsed.decision === 'allow' || parsed.decision === 'deny' || parsed.decision === 'modify'
+            ? parsed.decision
+            : 'allow';
+        return {
+            decision,
+            reason: typeof parsed.reason === 'string' ? parsed.reason : undefined,
+            modifiedArgs: parsed.modifiedArgs && typeof parsed.modifiedArgs === 'object'
+                ? parsed.modifiedArgs
+                : undefined,
+        };
+    }
+    catch {
+        // Hook wrote garbage — treat as a soft allow (the
+        // contract is "stdout is JSON; if not, ignore").
+        return { decision: 'allow' };
+    }
+}
+/**
+ * Fire all hooks for an event, in declaration order. The
+ * first non-`allow` decision wins. Returns the aggregated
+ * result.
+ */
+export function fireHooks(cwd, event, payload) {
+    const start = Date.now();
+    const specs = getHooksForEvent(cwd, event);
+    let aggDecision = 'allow';
+    let aggReason;
+    let aggModifiedArgs;
+    let lastHookId = null;
+    for (const spec of specs) {
+        const res = runHook(spec, { ...payload, event, cwd }, spec.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+        lastHookId = spec.id;
+        recordTelemetry(telemetry.hookFired({
+            hook: `${spec.id}:${payload.tool}:${res.decision}`,
+            phase: event === 'PreToolUse' ? 'pre' : 'post',
+            matched: res.decision !== 'allow',
+            durationMs: Date.now() - start,
+        }));
+        if (res.decision === 'deny') {
+            return {
+                fired: true,
+                decision: 'deny',
+                reason: res.reason ?? `hook ${spec.id} denied`,
+                durationMs: Date.now() - start,
+                hookId: spec.id,
+            };
+        }
+        if (res.decision === 'modify') {
+            aggDecision = 'modify';
+            if (res.modifiedArgs)
+                aggModifiedArgs = res.modifiedArgs;
+            if (res.reason)
+                aggReason = res.reason;
+        }
+    }
+    return {
+        fired: specs.length > 0,
+        decision: aggDecision,
+        reason: aggReason,
+        modifiedArgs: aggModifiedArgs,
+        durationMs: Date.now() - start,
+        hookId: lastHookId,
+    };
+}
+/**
+ * Apply a pre-hook's `modify` decision: re-validate
+ * `modifiedArgs` through `WorkspaceGuard.resolve()` to
+ * prevent an attacker-controlled hook from writing outside
+ * the workspace. The check is a *best-effort* scan: any
+ * `path`/`filePath`/`cwd` field in the args must resolve
+ * inside `cwd` (relative paths are fine).
+ */
+export function applyModifiedArgs(cwd, original, modified) {
+    const guard = new WorkspaceGuard(cwd);
+    // We re-validate any path-shaped field.
+    const pathKeys = ['path', 'filePath', 'filepath', 'src', 'dst', 'cwd', 'outputPath', 'inputPath'];
+    for (const key of pathKeys) {
+        if (!(key in modified))
+            continue;
+        const value = modified[key];
+        if (typeof value !== 'string')
+            continue;
+        // If the value is a relative path or equals cwd, it
+        // resolves inside the workspace by construction. Only
+        // absolute paths are checked.
+        if (!path.isAbsolute(value))
+            continue;
+        if (value === cwd)
+            continue;
+        try {
+            guard.resolve(value, 'modified-args');
+        }
+        catch (err) {
+            return {
+                ok: false,
+                args: original,
+                reason: `pre-hook attempted to inject out-of-workspace path: ${err.message}`,
+            };
+        }
+    }
+    return { ok: true, args: modified };
+}
+/** Get the hooks file path for a cwd (test-only introspection). */
+export function getHooksPath(cwd) {
+    return HOOKS_PATH_FOR(cwd);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/agent/hooks.js.map

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

package/dist/agent/mcp-bridge.d.ts

@@ -0,0 +1,13 @@
+import type { ChatToolDefinition } from '../shared/types.js';
+export declare class McpBridgeManager {
+    private clients;
+    private toolsMap;
+    private registeredTools;
+    initialize(cwd: string): Promise<void>;
+    private loadProjectMcpConfig;
+    getTools(): ChatToolDefinition[];
+    hasTool(name: string): boolean;
+    executeTool(name: string, args: any): Promise<string>;
+    shutdown(): void;
+}
+//# sourceMappingURL=mcp-bridge.d.ts.map

package/dist/agent/mcp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-bridge.d.ts","sourceRoot":"","sources":["../../src/agent/mcp-bridge.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAkE;IAClF,OAAO,CAAC,eAAe,CAA4B;IAE7C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B5C,OAAO,CAAC,oBAAoB;IAgB5B,QAAQ,IAAI,kBAAkB,EAAE;IAIhC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB3D,QAAQ,IAAI,IAAI;CAQjB"}

package/dist/agent/mcp-bridge.js

@@ -0,0 +1,86 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { McpClient } from './mcp-client.js';
+export class McpBridgeManager {
+    clients = new Map();
+    toolsMap = new Map();
+    registeredTools = [];
+    async initialize(cwd) {
+        const config = this.loadProjectMcpConfig(cwd);
+        if (!config || !config.mcpServers)
+            return;
+        for (const [name, serverConfig] of Object.entries(config.mcpServers)) {
+            const client = new McpClient(name, serverConfig);
+            const ok = await client.start();
+            if (ok) {
+                this.clients.set(name, client);
+                try {
+                    const tools = await client.listTools();
+                    for (const tool of tools) {
+                        const registeredName = `mcp_local_${name}_${tool.name}`;
+                        this.toolsMap.set(registeredName, { client, originalName: tool.name });
+                        this.registeredTools.push({
+                            type: 'function',
+                            function: {
+                                name: registeredName,
+                                description: tool.description || '',
+                                parameters: tool.inputSchema || { type: 'object', properties: {} },
+                            },
+                        });
+                    }
+                }
+                catch (e) {
+                    console.error(`[MCP Bridge] Failed to load tools for local server ${name}:`, e);
+                }
+            }
+        }
+    }
+    loadProjectMcpConfig(cwd) {
+        const ymlPath = path.join(cwd, '.fixo.yml');
+        const yamlPath = path.join(cwd, '.fixo.yaml');
+        let configPath = fs.existsSync(ymlPath) ? ymlPath : fs.existsSync(yamlPath) ? yamlPath : null;
+        if (configPath) {
+            try {
+                const content = fs.readFileSync(configPath, 'utf-8');
+                return yaml.load(content);
+            }
+            catch (e) {
+                console.warn(`[MCP Bridge] Failed to parse project MCP config:`, e);
+            }
+        }
+        return null;
+    }
+    getTools() {
+        return this.registeredTools;
+    }
+    hasTool(name) {
+        return this.toolsMap.has(name);
+    }
+    async executeTool(name, args) {
+        const mapping = this.toolsMap.get(name);
+        if (!mapping) {
+            throw new Error(`Local MCP tool ${name} not registered`);
+        }
+        const result = await mapping.client.callTool(mapping.originalName, args);
+        if (result && Array.isArray(result.content)) {
+            return result.content
+                .map((c) => {
+                if (c.type === 'text')
+                    return c.text;
+                return JSON.stringify(c);
+            })
+                .join('\n');
+        }
+        return JSON.stringify(result);
+    }
+    shutdown() {
+        for (const client of this.clients.values()) {
+            client.stop();
+        }
+        this.clients.clear();
+        this.toolsMap.clear();
+        this.registeredTools = [];
+    }
+}
+//# sourceMappingURL=mcp-bridge.js.map

package/dist/agent/mcp-bridge.js.map

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

package/dist/agent/mcp-client.d.ts

@@ -0,0 +1,24 @@
+export interface McpServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export declare class McpClient {
+    private serverName;
+    private config;
+    private process;
+    private nextId;
+    private pendingRequests;
+    private rl;
+    private initialized;
+    constructor(serverName: string, config: McpServerConfig);
+    start(): Promise<boolean>;
+    private handleMessage;
+    private sendRequest;
+    private sendNotification;
+    private initializeConnection;
+    listTools(): Promise<any[]>;
+    callTool(name: string, args: any): Promise<any>;
+    stop(): void;
+}
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/agent/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/agent/mcp-client.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,eAAe,CAAoF;IAC3G,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,WAAW,CAAS;gBAEhB,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe;IAKjD,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAsC/B,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,gBAAgB;YAUV,oBAAoB;IAS5B,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAW3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAQrD,IAAI;CAcL"}

package/dist/agent/mcp-client.js

@@ -0,0 +1,146 @@
+import { spawn } from 'child_process';
+import readline from 'readline';
+export class McpClient {
+    serverName;
+    config;
+    process = null;
+    nextId = 1;
+    pendingRequests = new Map();
+    rl = null;
+    initialized = false;
+    constructor(serverName, config) {
+        this.serverName = serverName;
+        this.config = config;
+    }
+    async start() {
+        try {
+            const env = { ...process.env, ...this.config.env };
+            this.process = spawn(this.config.command, this.config.args || [], {
+                env,
+                stdio: ['pipe', 'pipe', 'inherit'],
+            });
+            this.process.on('error', (err) => {
+                console.error(`[MCP Client] Failed to start server ${this.serverName}:`, err);
+            });
+            this.process.on('exit', (code, signal) => {
+                if (code !== 0 && code !== null) {
+                    console.warn(`[MCP Client] Server ${this.serverName} exited with code ${code}`);
+                }
+            });
+            this.rl = readline.createInterface({
+                input: this.process.stdout,
+                terminal: false,
+            });
+            this.rl.on('line', (line) => {
+                this.handleMessage(line);
+            });
+            // Initialize connection
+            await this.initializeConnection();
+            this.initialized = true;
+            return true;
+        }
+        catch (e) {
+            console.error(`[MCP Client] Error starting server ${this.serverName}:`, e);
+            this.stop();
+            return false;
+        }
+    }
+    handleMessage(line) {
+        try {
+            const msg = JSON.parse(line);
+            if (msg.jsonrpc === '2.0' && msg.id !== undefined) {
+                const pending = this.pendingRequests.get(msg.id);
+                if (pending) {
+                    this.pendingRequests.delete(msg.id);
+                    if (msg.error) {
+                        pending.reject(new Error(msg.error.message || JSON.stringify(msg.error)));
+                    }
+                    else {
+                        pending.resolve(msg.result);
+                    }
+                }
+            }
+        }
+        catch (e) {
+            // Ignored / malformed line
+        }
+    }
+    sendRequest(method, params) {
+        return new Promise((resolve, reject) => {
+            if (!this.process || !this.process.stdin) {
+                return reject(new Error(`MCP server ${this.serverName} process not running`));
+            }
+            const id = this.nextId++;
+            const req = {
+                jsonrpc: '2.0',
+                id,
+                method,
+                params,
+            };
+            const timeoutId = setTimeout(() => {
+                if (this.pendingRequests.has(id)) {
+                    this.pendingRequests.delete(id);
+                    reject(new Error(`MCP request timeout for method ${method} on server ${this.serverName}`));
+                }
+            }, 20000);
+            this.pendingRequests.set(id, {
+                resolve: (val) => { clearTimeout(timeoutId); resolve(val); },
+                reject: (err) => { clearTimeout(timeoutId); reject(err); }
+            });
+            this.process.stdin.write(JSON.stringify(req) + '\n');
+        });
+    }
+    sendNotification(method, params) {
+        if (!this.process || !this.process.stdin)
+            return;
+        const notif = {
+            jsonrpc: '2.0',
+            method,
+            params,
+        };
+        this.process.stdin.write(JSON.stringify(notif) + '\n');
+    }
+    async initializeConnection() {
+        await this.sendRequest('initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'fixo-cli', version: '1.0.0' },
+        });
+        this.sendNotification('notifications/initialized');
+    }
+    async listTools() {
+        if (!this.initialized)
+            return [];
+        try {
+            const res = await this.sendRequest('tools/list', {});
+            return res.tools || [];
+        }
+        catch (e) {
+            console.error(`[MCP Client] Failed to list tools for ${this.serverName}:`, e);
+            return [];
+        }
+    }
+    async callTool(name, args) {
+        if (!this.initialized)
+            throw new Error(`MCP Client ${this.serverName} not initialized`);
+        return this.sendRequest('tools/call', {
+            name,
+            arguments: args,
+        });
+    }
+    stop() {
+        if (this.rl) {
+            this.rl.close();
+            this.rl = null;
+        }
+        if (this.process) {
+            this.process.kill();
+            this.process = null;
+        }
+        for (const [id, pending] of this.pendingRequests.entries()) {
+            pending.reject(new Error(`MCP client ${this.serverName} stopped`));
+        }
+        this.pendingRequests.clear();
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/agent/mcp-client.js.map

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

package/dist/agent/mcp-manager.d.ts

@@ -0,0 +1,13 @@
+import type { ChatToolDefinition } from '../shared/types.js';
+export declare class McpManager {
+    private clients;
+    private toolsMap;
+    private registeredTools;
+    initialize(): Promise<void>;
+    private loadMcpConfig;
+    getTools(): ChatToolDefinition[];
+    hasTool(name: string): boolean;
+    executeTool(name: string, args: any): Promise<string>;
+    shutdown(): void;
+}
+//# sourceMappingURL=mcp-manager.d.ts.map

package/dist/agent/mcp-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-manager.d.ts","sourceRoot":"","sources":["../../src/agent/mcp-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAkE;IAClF,OAAO,CAAC,eAAe,CAA4B;IAE7C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BjC,OAAO,CAAC,aAAa;IAarB,QAAQ,IAAI,kBAAkB,EAAE;IAIhC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB3D,QAAQ,IAAI,IAAI;CAQjB"}

package/dist/agent/mcp-manager.js

@@ -0,0 +1,84 @@
+import os from 'os';
+import path from 'path';
+import fs from 'fs';
+import { McpClient } from './mcp-client.js';
+export class McpManager {
+    clients = new Map();
+    toolsMap = new Map();
+    registeredTools = [];
+    async initialize() {
+        const config = this.loadMcpConfig();
+        if (!config || !config.mcpServers)
+            return;
+        for (const [name, serverConfig] of Object.entries(config.mcpServers)) {
+            const client = new McpClient(name, serverConfig);
+            const ok = await client.start();
+            if (ok) {
+                this.clients.set(name, client);
+                try {
+                    const tools = await client.listTools();
+                    for (const tool of tools) {
+                        const registeredName = `mcp_${name}_${tool.name}`;
+                        this.toolsMap.set(registeredName, { client, originalName: tool.name });
+                        this.registeredTools.push({
+                            type: 'function',
+                            function: {
+                                name: registeredName,
+                                description: tool.description || '',
+                                parameters: tool.inputSchema || { type: 'object', properties: {} },
+                            },
+                        });
+                    }
+                }
+                catch (e) {
+                    console.error(`[MCP Manager] Failed to load tools for server ${name}:`, e);
+                }
+            }
+        }
+    }
+    loadMcpConfig() {
+        const homeDir = os.homedir();
+        const configPath = path.join(homeDir, '.freellmapi', 'mcp.json');
+        if (fs.existsSync(configPath)) {
+            try {
+                return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            }
+            catch (e) {
+                console.warn(`[MCP Manager] Failed to parse MCP config:`, e);
+            }
+        }
+        return null;
+    }
+    getTools() {
+        return this.registeredTools;
+    }
+    hasTool(name) {
+        return this.toolsMap.has(name);
+    }
+    async executeTool(name, args) {
+        const mapping = this.toolsMap.get(name);
+        if (!mapping) {
+            throw new Error(`MCP tool ${name} not registered`);
+        }
+        const result = await mapping.client.callTool(mapping.originalName, args);
+        if (result && Array.isArray(result.content)) {
+            return result.content
+                .map((c) => {
+                if (c.type === 'text')
+                    return c.text;
+                return JSON.stringify(c);
+            })
+                .join('\n');
+        }
+        return JSON.stringify(result);
+    }
+    shutdown() {
+        for (const client of this.clients.values()) {
+            client.stop();
+        }
+        this.clients.clear();
+        this.toolsMap.clear();
+        this.registeredTools = [];
+    }
+}
+//# sourceMappingURL=mcp-manager.js.map

package/dist/agent/mcp-manager.js.map

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