@nac3/forge-cli 0.2.0-alpha.5 → 0.2.0-alpha.59z.119

package/dist/mcp/config.js

@@ -0,0 +1,116 @@
+/**
+ * MCP feature flag config (alpha.59p.3).
+ *
+ * Per Pablo's directive 2026-06-02: "Quiero que la parte MCP sea
+ * activable/desactivable por configuracion." Default OFF. Until
+ * the user runs `yf mcp enable`, NO MCP code path activates --
+ * no subprocesses spawned, no stubs in the manifest, no endpoints
+ * exposed.
+ *
+ * Storage: $YF_CONFIG_DIR/config.json
+ *   {
+ *     "mcp": {
+ *       "enabled": false,
+ *       "bridges_path": "~/.yujin-forge/mcp_bridges.json",
+ *       "discover_default_limit": 5,
+ *       "transient_tools_ttl_turns": 5,
+ *       "max_concurrent_servers": 8
+ *     }
+ *   }
+ *
+ * Spec: docs/MCP_BRIDGE_PLAN.md (v2) sec 3.3.
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const DEFAULT = {
+    enabled: false,
+    bridges_path: '', // resolved at read time
+    discover_default_limit: 5,
+    transient_tools_ttl_turns: 5,
+    max_concurrent_servers: 8,
+};
+function configDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    return process.env.YF_CONFIG_DIR || path.join(home, '.yujin-forge');
+}
+function configPath() {
+    return path.join(configDir(), 'config.json');
+}
+function defaultBridgesPath() {
+    return path.join(configDir(), 'mcp_bridges.json');
+}
+/** Read the whole config.json. Returns {} when missing or
+ *  malformed (never throws). */
+async function readWholeConfig() {
+    try {
+        const raw = await fs.readFile(configPath(), 'utf-8');
+        const j = JSON.parse(raw);
+        return (j && typeof j === 'object') ? j : {};
+    }
+    catch {
+        return {};
+    }
+}
+async function writeWholeConfig(obj) {
+    await fs.mkdir(configDir(), { recursive: true });
+    const tmp = configPath() + '.tmp';
+    await fs.writeFile(tmp, JSON.stringify(obj, null, 2), 'utf-8');
+    await fs.rename(tmp, configPath());
+}
+/** Read the MCP section + apply defaults. */
+export async function readMcpConfig() {
+    const whole = await readWholeConfig();
+    const raw = (whole.mcp && typeof whole.mcp === 'object') ? whole.mcp : {};
+    return {
+        enabled: raw.enabled === true,
+        bridges_path: (typeof raw.bridges_path === 'string' && raw.bridges_path)
+            ? String(raw.bridges_path)
+            : defaultBridgesPath(),
+        discover_default_limit: typeof raw.discover_default_limit === 'number' && raw.discover_default_limit > 0
+            ? raw.discover_default_limit
+            : DEFAULT.discover_default_limit,
+        transient_tools_ttl_turns: typeof raw.transient_tools_ttl_turns === 'number' && raw.transient_tools_ttl_turns >= 0
+            ? raw.transient_tools_ttl_turns
+            : DEFAULT.transient_tools_ttl_turns,
+        max_concurrent_servers: typeof raw.max_concurrent_servers === 'number' && raw.max_concurrent_servers > 0
+            ? raw.max_concurrent_servers
+            : DEFAULT.max_concurrent_servers,
+    };
+}
+/** Patch the mcp section. Other top-level keys preserved. */
+export async function patchMcpConfig(patch) {
+    const whole = await readWholeConfig();
+    const current = await readMcpConfig();
+    const next = { ...current, ...patch };
+    whole.mcp = next;
+    await writeWholeConfig(whole);
+    return next;
+}
+/** Convenience: am I allowed to do MCP work? Default false.
+ *  Honours the env override YF_MCP_DISABLED=1 even when config
+ *  says enabled (kill-switch for incident response). */
+export async function mcpEnabled() {
+    const envOff = process.env.YF_MCP_DISABLED;
+    if (envOff === '1' || envOff === 'true' || envOff === 'yes')
+        return false;
+    const cfg = await readMcpConfig();
+    return cfg.enabled === true;
+}
+/** Synchronous variant for paths that cannot async (e.g. system
+ *  prompt assembly that already has the config loaded). Reads
+ *  cached value if available, else returns false. */
+let _cachedEnabled = null;
+export function mcpEnabledSync() {
+    const envOff = process.env.YF_MCP_DISABLED;
+    if (envOff === '1' || envOff === 'true' || envOff === 'yes')
+        return false;
+    return _cachedEnabled === true;
+}
+export async function primeSyncCache() {
+    _cachedEnabled = await mcpEnabled();
+}
+/* Test seam. */
+export const _internal = { configPath, defaultBridgesPath };
+//# sourceMappingURL=config.js.map

package/dist/mcp/config.js.map

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

package/dist/mcp/protocol_client.d.ts

@@ -0,0 +1,63 @@
+/**
+ * F101 slice 4 FULL (alpha.59z.39) -- MCP protocol client.
+ *
+ * Three transports behind one interface:
+ *   - http_rest  : default for slice 4 minimal-compatible bridges
+ *                  (GET /tools, POST /tools/<slug>/invoke).
+ *   - stdio      : spawn a local subprocess + speak JSON-RPC over
+ *                  stdin/stdout (the canonical MCP transport).
+ *   - sse        : open EventSource-style HTTP + send JSON-RPC
+ *                  requests over POST; receive streamed responses.
+ *
+ * Each transport implements MCPClient with two methods:
+ *   - listTools(): returns the bridge's tool catalogue.
+ *   - invokeTool(toolSlug, args, authHeaders): forwards the call,
+ *     returns the result object.
+ *
+ * The protocol is auto-selected from the bridge declaration:
+ *   - bridge.protocol === 'stdio'  -> spawn (uses bridge.command)
+ *   - bridge.protocol === 'sse'    -> SSE over endpoint
+ *   - default                       -> http_rest
+ *
+ * ASCII-only.
+ */
+import type { MCPBridge } from './bridge_registry.js';
+export interface MCPTool {
+    id: string;
+    label?: string;
+    description?: string;
+    /** Optional JSON Schema; clients can request it lazily via
+     *  discover-tools when not pre-populated. */
+    schema?: Record<string, unknown>;
+}
+export interface MCPListToolsResult {
+    ok: true;
+    tools: MCPTool[];
+    count: number;
+}
+export interface MCPListToolsError {
+    ok: false;
+    error: string;
+    detail?: string;
+}
+export interface MCPInvokeResult {
+    ok: true;
+    response: unknown;
+}
+export interface MCPInvokeError {
+    ok: false;
+    error: string;
+    detail?: string;
+    partial_response?: unknown;
+}
+export interface MCPClient {
+    /** Identify the transport (for logs + tests). */
+    readonly transport: 'http_rest' | 'stdio' | 'sse';
+    listTools(): Promise<MCPListToolsResult | MCPListToolsError>;
+    invokeTool(toolSlug: string, args: Record<string, unknown>, authHeaders: Record<string, string>): Promise<MCPInvokeResult | MCPInvokeError>;
+    /** Clean up subprocess / SSE connection if any. http_rest is no-op. */
+    close(): Promise<void>;
+}
+export declare function getMCPClient(bridge: MCPBridge): MCPClient;
+export declare function _resetClientCache(): Promise<void>;
+//# sourceMappingURL=protocol_client.d.ts.map

package/dist/mcp/protocol_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol_client.d.ts","sourceRoot":"","sources":["../../src/mcp/protocol_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAMtD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAY,MAAM,CAAC;IACrB,KAAK,CAAC,EAAQ,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;iDAC6C;IAC7C,MAAM,CAAC,EAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAM,IAAI,CAAC;IACb,KAAK,EAAG,OAAO,EAAE,CAAC;IAClB,KAAK,EAAG,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAO,KAAK,CAAC;IACf,KAAK,EAAI,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAS,IAAI,CAAC;IAChB,QAAQ,EAAG,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAS,KAAK,CAAC;IACjB,KAAK,EAAM,MAAM,CAAC;IAClB,MAAM,CAAC,EAAI,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,GAAG,KAAK,CAAC;IAClD,SAAS,IAAI,OAAO,CAAC,kBAAkB,GAAG,iBAAiB,CAAC,CAAC;IAC7D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,eAAe,GAAG,cAAc,CAAC,CAAC;IAC5I,uEAAuE;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAwSD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAYzD;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvD"}

package/dist/mcp/protocol_client.js

@@ -0,0 +1,340 @@
+/**
+ * F101 slice 4 FULL (alpha.59z.39) -- MCP protocol client.
+ *
+ * Three transports behind one interface:
+ *   - http_rest  : default for slice 4 minimal-compatible bridges
+ *                  (GET /tools, POST /tools/<slug>/invoke).
+ *   - stdio      : spawn a local subprocess + speak JSON-RPC over
+ *                  stdin/stdout (the canonical MCP transport).
+ *   - sse        : open EventSource-style HTTP + send JSON-RPC
+ *                  requests over POST; receive streamed responses.
+ *
+ * Each transport implements MCPClient with two methods:
+ *   - listTools(): returns the bridge's tool catalogue.
+ *   - invokeTool(toolSlug, args, authHeaders): forwards the call,
+ *     returns the result object.
+ *
+ * The protocol is auto-selected from the bridge declaration:
+ *   - bridge.protocol === 'stdio'  -> spawn (uses bridge.command)
+ *   - bridge.protocol === 'sse'    -> SSE over endpoint
+ *   - default                       -> http_rest
+ *
+ * ASCII-only.
+ */
+import { spawn } from 'node:child_process';
+/* ====================================================================
+ * http_rest transport (slice 4 minimal preserved)
+ * ================================================================== */
+class HttpRestClient {
+    bridge;
+    transport = 'http_rest';
+    constructor(bridge) {
+        this.bridge = bridge;
+    }
+    async listTools() {
+        try {
+            const ctrl = new AbortController();
+            const timer = setTimeout(() => ctrl.abort(), 5000);
+            const r = await fetch(this.bridge.endpoint.replace(/\/$/, '') + '/tools', { signal: ctrl.signal });
+            clearTimeout(timer);
+            if (!r.ok)
+                return { ok: false, error: 'http_status', detail: 'HTTP ' + r.status };
+            const body = await r.json();
+            const tools = Array.isArray(body.tools) ? body.tools : [];
+            return { ok: true, tools, count: tools.length };
+        }
+        catch (err) {
+            return { ok: false, error: 'bridge_unreachable', detail: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    async invokeTool(toolSlug, args, authHeaders) {
+        try {
+            const ctrl = new AbortController();
+            const timer = setTimeout(() => ctrl.abort(), 30000);
+            const r = await fetch(this.bridge.endpoint.replace(/\/$/, '') + '/tools/' + encodeURIComponent(toolSlug) + '/invoke', {
+                method: 'POST',
+                signal: ctrl.signal,
+                headers: { 'content-type': 'application/json', ...authHeaders },
+                body: JSON.stringify({ args }),
+            });
+            clearTimeout(timer);
+            let parsed = null;
+            try {
+                parsed = await r.json();
+            }
+            catch { /* response without body is OK */ }
+            if (!r.ok) {
+                return { ok: false, error: 'http_status', detail: 'HTTP ' + r.status, partial_response: parsed };
+            }
+            return { ok: true, response: parsed };
+        }
+        catch (err) {
+            return { ok: false, error: 'bridge_invoke_failed', detail: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    async close() { }
+}
+class StdioClient {
+    bridge;
+    transport = 'stdio';
+    proc = null;
+    buffer = '';
+    pending = new Map();
+    nextId = 1;
+    spawnError = null;
+    constructor(bridge) {
+        this.bridge = bridge;
+    }
+    async ensureSpawned() {
+        if (this.proc && !this.proc.killed && this.spawnError === null)
+            return null;
+        if (this.spawnError)
+            return this.spawnError;
+        const cmd = this.bridge.command;
+        if (!cmd) {
+            this.spawnError = 'stdio bridge ' + this.bridge.id + ' has no command declared';
+            return this.spawnError;
+        }
+        try {
+            const parts = cmd.split(/\s+/);
+            const program = parts[0];
+            const args = parts.slice(1);
+            if (!program) {
+                this.spawnError = 'empty command string';
+                return this.spawnError;
+            }
+            this.proc = spawn(program, args, { stdio: ['pipe', 'pipe', 'pipe'], shell: false });
+            this.proc.on('error', (err) => {
+                this.spawnError = 'subprocess error: ' + err.message;
+            });
+            this.proc.on('exit', (code) => {
+                if (code !== 0 && code !== null) {
+                    this.spawnError = 'subprocess exited with code ' + code;
+                }
+            });
+            this.proc.stdout?.setEncoding('utf-8');
+            this.proc.stdout?.on('data', (chunk) => {
+                this.buffer += chunk;
+                this.drainBuffer();
+            });
+            /* MCP servers may emit an initialize hello on connect; ignore
+             * unsolicited frames + just keep the pipe alive. */
+            return null;
+        }
+        catch (err) {
+            this.spawnError = err instanceof Error ? err.message : String(err);
+            return this.spawnError;
+        }
+    }
+    drainBuffer() {
+        let nl = this.buffer.indexOf('\n');
+        while (nl !== -1) {
+            const line = this.buffer.slice(0, nl).trim();
+            this.buffer = this.buffer.slice(nl + 1);
+            if (line)
+                this.handleLine(line);
+            nl = this.buffer.indexOf('\n');
+        }
+    }
+    handleLine(line) {
+        try {
+            const obj = JSON.parse(line);
+            if (obj && typeof obj.id === 'string') {
+                const handler = this.pending.get(obj.id);
+                if (handler) {
+                    handler(obj);
+                    this.pending.delete(obj.id);
+                }
+            }
+        }
+        catch { /* ignore non-JSON lines */ }
+    }
+    async sendRequest(method, params, timeoutMs) {
+        const id = 'req_' + (this.nextId++);
+        const req = { jsonrpc: '2.0', id, method, params };
+        const line = JSON.stringify(req) + '\n';
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error('stdio rpc timeout after ' + timeoutMs + 'ms'));
+            }, timeoutMs);
+            this.pending.set(id, (resp) => {
+                clearTimeout(timer);
+                resolve(resp);
+            });
+            try {
+                if (!this.proc?.stdin?.writable) {
+                    clearTimeout(timer);
+                    this.pending.delete(id);
+                    reject(new Error('stdio bridge stdin not writable'));
+                    return;
+                }
+                this.proc.stdin.write(line);
+            }
+            catch (err) {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                reject(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+    }
+    async listTools() {
+        const spawnErr = await this.ensureSpawned();
+        if (spawnErr)
+            return { ok: false, error: 'bridge_spawn_failed', detail: spawnErr };
+        try {
+            const resp = await this.sendRequest('tools/list', {}, 5000);
+            if (resp.error)
+                return { ok: false, error: 'rpc_error', detail: resp.error.message };
+            const r = (resp.result || {});
+            const tools = Array.isArray(r.tools) ? r.tools : [];
+            return { ok: true, tools, count: tools.length };
+        }
+        catch (err) {
+            return { ok: false, error: 'bridge_unreachable', detail: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    async invokeTool(toolSlug, args, authHeaders) {
+        /* stdio MCP servers do not carry HTTP headers; the auth pattern
+         * for stdio is env vars at spawn time, set by the user via
+         * `yf keys set` + a wrapper command. authHeaders is preserved
+         * in the signature for transport parity but unused here. */
+        void authHeaders;
+        const spawnErr = await this.ensureSpawned();
+        if (spawnErr)
+            return { ok: false, error: 'bridge_spawn_failed', detail: spawnErr };
+        try {
+            const resp = await this.sendRequest('tools/call', { name: toolSlug, arguments: args }, 30000);
+            if (resp.error)
+                return { ok: false, error: 'rpc_error', detail: resp.error.message };
+            return { ok: true, response: resp.result };
+        }
+        catch (err) {
+            return { ok: false, error: 'bridge_invoke_failed', detail: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    async close() {
+        if (this.proc && !this.proc.killed) {
+            try {
+                this.proc.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+        }
+        this.pending.clear();
+    }
+}
+/* ====================================================================
+ * SSE transport -- HTTP POST request + Server-Sent Events response
+ *
+ * Slice 4 FULL minimal: implements a single round-trip pattern
+ * (open EventSource, send POST, read first JSON-RPC frame, close).
+ * Persistent SSE streaming for multi-frame tool responses is
+ * deferred to a later iteration.
+ * ================================================================== */
+class SseClient {
+    bridge;
+    transport = 'sse';
+    constructor(bridge) {
+        this.bridge = bridge;
+    }
+    async listTools() {
+        return this.rpc('tools/list', {}, 5000)
+            .then((r) => {
+            if (r.error)
+                return { ok: false, error: 'rpc_error', detail: r.error.message };
+            const result = (r.result || {});
+            const tools = Array.isArray(result.tools) ? result.tools : [];
+            return { ok: true, tools, count: tools.length };
+        })
+            .catch((err) => ({ ok: false, error: 'bridge_unreachable', detail: err instanceof Error ? err.message : String(err) }));
+    }
+    async invokeTool(toolSlug, args, authHeaders) {
+        return this.rpc('tools/call', { name: toolSlug, arguments: args }, 30000, authHeaders)
+            .then((r) => {
+            if (r.error)
+                return { ok: false, error: 'rpc_error', detail: r.error.message };
+            return { ok: true, response: r.result };
+        })
+            .catch((err) => ({ ok: false, error: 'bridge_invoke_failed', detail: err instanceof Error ? err.message : String(err) }));
+    }
+    async close() { }
+    async rpc(method, params, timeoutMs, authHeaders = {}) {
+        const id = 'req_' + Date.now() + '_' + Math.random().toString(36).slice(2, 7);
+        const body = { jsonrpc: '2.0', id, method, params };
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+        try {
+            const r = await fetch(this.bridge.endpoint.replace(/\/$/, '') + '/sse', {
+                method: 'POST',
+                signal: ctrl.signal,
+                headers: {
+                    'content-type': 'application/json',
+                    'accept': 'text/event-stream',
+                    ...authHeaders,
+                },
+                body: JSON.stringify(body),
+            });
+            clearTimeout(timer);
+            if (!r.ok) {
+                return { jsonrpc: '2.0', id, error: { code: r.status, message: 'HTTP ' + r.status } };
+            }
+            const text = await r.text();
+            /* Read first data: frame containing JSON-RPC response. */
+            const m = text.match(/^data:\s*(.*)$/m);
+            if (!m) {
+                return { jsonrpc: '2.0', id, error: { code: -32700, message: 'no data: frame in SSE response' } };
+            }
+            try {
+                return JSON.parse(m[1] ?? '');
+            }
+            catch (e) {
+                return { jsonrpc: '2.0', id, error: { code: -32700, message: 'SSE data frame is not JSON: ' + (e instanceof Error ? e.message : String(e)) } };
+            }
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+/* ====================================================================
+ * Factory + per-bridge client cache
+ * ================================================================== */
+const _clientCache = new Map();
+function getProtocol(bridge) {
+    const declared = bridge.protocol;
+    if (declared === 'stdio')
+        return 'stdio';
+    if (declared === 'sse')
+        return 'sse';
+    return 'http_rest';
+}
+export function getMCPClient(bridge) {
+    const key = bridge.id + ':' + getProtocol(bridge);
+    let client = _clientCache.get(key);
+    if (client)
+        return client;
+    switch (getProtocol(bridge)) {
+        case 'stdio':
+            client = new StdioClient(bridge);
+            break;
+        case 'sse':
+            client = new SseClient(bridge);
+            break;
+        case 'http_rest':
+        default:
+            client = new HttpRestClient(bridge);
+            break;
+    }
+    _clientCache.set(key, client);
+    return client;
+}
+export async function _resetClientCache() {
+    for (const c of _clientCache.values()) {
+        try {
+            await c.close();
+        }
+        catch { /* ignore */ }
+    }
+    _clientCache.clear();
+}
+//# sourceMappingURL=protocol_client.js.map

package/dist/mcp/protocol_client.js.map

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

package/dist/mcp/state.d.ts

@@ -0,0 +1,38 @@
+/**
+ * F101 slice 5 sub-slice 1 -- persistent enabled-state for MCP bridges.
+ *
+ * Stores `{bridge_id: {enabled, updated_at}}` at
+ * ~/.yujin-forge/mcp-state.json. discoverBridges() merges the
+ * state into each discovered bridge so a bridge disabled here
+ * shows as `enabled: false` and the LLM stub omits its proxied
+ * tools on the next chat turn.
+ *
+ * Atomicity: writes go to mcp-state.json.tmp first then rename
+ * over the final path. Concurrent yf processes will not corrupt
+ * the file (the rename is atomic on POSIX + Windows >= 10).
+ *
+ * Per-process cache (5s) so a chat turn that calls
+ * getActiveBridges() multiple times pays the disk read only
+ * once.
+ *
+ * ASCII-only.
+ */
+export interface BridgeStateEntry {
+    enabled: boolean;
+    updated_at: string;
+}
+export interface BridgeStateFile {
+    version: number;
+    bridges: Record<string, BridgeStateEntry>;
+}
+export declare function readState(opts?: {
+    refresh?: boolean;
+}): Promise<BridgeStateFile>;
+/** Returns whether a bridge is enabled per persisted state.
+ *  Default true when the bridge has no entry yet. */
+export declare function isEnabled(bridge_id: string): Promise<boolean>;
+export declare function setBridgeEnabled(bridge_id: string, enabled: boolean): Promise<void>;
+export declare function removeBridge(bridge_id: string): Promise<void>;
+export declare function _resetStateCache(): void;
+export declare function _statePathForTests(): string;
+//# sourceMappingURL=state.d.ts.map

package/dist/mcp/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/mcp/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAUH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAK,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC3C;AAiBD,wBAAsB,SAAS,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CA4B1F;AAED;qDACqD;AACrD,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnE;AA4CD,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzF;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAInE;AAMD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}