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

package/dist/llm/xai_client.d.ts

@@ -0,0 +1,51 @@
+/**
+ * xAI Grok brain client (alpha.59h).
+ *
+ * Same unified shape as ClaudeClient / GeminiClient / OpenAIClient.
+ * xAI exposes an OpenAI-compatible Chat Completions API at
+ * https://api.x.ai/v1/chat/completions -- auth Bearer, body shape
+ * matches OpenAI including function calling.
+ *
+ * Default model: grok-2-latest (general purpose).
+ * Alternative: grok-3-beta, grok-vision-beta.
+ *
+ * ASCII-only.
+ */
+import type { ToolRound, ChatMessage } from '../chat/claude.js';
+import type { ToolSpec } from '../chat/tools.js';
+export interface XaiChatRequest {
+    messages: ChatMessage[];
+    system?: string;
+    maxTokens?: number;
+    model?: string;
+    tools?: ToolSpec[];
+    runTool?: (name: string, input: Record<string, unknown>) => Promise<{
+        result: unknown;
+        is_error?: boolean;
+    }>;
+    maxToolRounds?: number;
+}
+export interface XaiChatResponse {
+    text: string;
+    tokensIn: number;
+    tokensOut: number;
+    model: string;
+    toolRounds: ToolRound[];
+}
+export interface XaiClientOptions {
+    apiKey: string;
+    defaultModel?: string;
+    fetchImpl?: typeof fetch;
+}
+export declare class XaiApiError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+export declare class XaiClient {
+    private apiKey;
+    private fetchImpl;
+    private defaultModel;
+    constructor(opts: XaiClientOptions);
+    chat(req: XaiChatRequest): Promise<XaiChatResponse>;
+}
+//# sourceMappingURL=xai_client.d.ts.map

package/dist/llm/xai_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xai_client.d.ts","sourceRoot":"","sources":["../../src/llm/xai_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAKjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAClE,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AA6BD,qBAAa,WAAY,SAAQ,KAAK;IACpC,MAAM,EAAE,MAAM,CAAC;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,EAAE,gBAAgB;IAS5B,IAAI,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;CAmJ1D"}

package/dist/llm/xai_client.js

@@ -0,0 +1,174 @@
+const XAI_BASE = 'https://api.x.ai/v1/chat/completions';
+const DEFAULT_XAI_MODEL = 'grok-2-latest';
+export class XaiApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = 'XaiApiError';
+        this.status = status;
+    }
+}
+export class XaiClient {
+    apiKey;
+    fetchImpl;
+    defaultModel;
+    constructor(opts) {
+        if (!opts.apiKey || opts.apiKey.trim() === '') {
+            throw new Error('XaiClient: apiKey required');
+        }
+        this.apiKey = opts.apiKey.trim();
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.defaultModel = opts.defaultModel ?? DEFAULT_XAI_MODEL;
+    }
+    async chat(req) {
+        if (req.tools && !req.runTool) {
+            throw new Error('XaiChatRequest.tools requires a runTool callback');
+        }
+        const model = req.model ?? this.defaultModel;
+        const maxTokens = req.maxTokens ?? 1024;
+        const { readLimitsConfig, classifyVerbFamily, getMaxToolRoundsForFamily } = await import('../core/limits_config.js');
+        const limits = await readLimitsConfig();
+        const callerSpecifiedCap = req.maxToolRounds !== undefined;
+        const autonomousMode = limits.danger_zone && limits.danger_zone.auto_approve_all === true;
+        const baseCap = autonomousMode
+            ? limits.max_tool_rounds.autonomous
+            : limits.max_tool_rounds.default;
+        let maxRounds = req.maxToolRounds ?? baseCap;
+        let familyResolved = null;
+        const messages = [];
+        if (req.system && req.system.trim() !== '') {
+            messages.push({ role: 'system', content: req.system });
+        }
+        for (const m of req.messages) {
+            messages.push({ role: m.role, content: m.content });
+        }
+        const tools = (req.tools ?? []).map((t) => ({
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: t.input_schema,
+            },
+        }));
+        let totalIn = 0;
+        let totalOut = 0;
+        let serverModel = model;
+        const toolRounds = [];
+        for (let round = 0; round < maxRounds; round++) {
+            void round;
+            const body = {
+                model,
+                messages,
+                max_tokens: maxTokens,
+                temperature: 0.7,
+            };
+            if (tools.length > 0) {
+                body.tools = tools;
+                body.tool_choice = 'auto';
+            }
+            const res = await this.fetchImpl(XAI_BASE, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    'authorization': 'Bearer ' + this.apiKey,
+                },
+                body: JSON.stringify(body),
+            });
+            const json = await res.json();
+            if (!res.ok || json.error) {
+                const msg = json.error?.message || ('HTTP ' + res.status);
+                throw new XaiApiError('xAI API error: ' + msg, res.status);
+            }
+            if (json.model)
+                serverModel = json.model;
+            totalIn += json.usage?.prompt_tokens ?? 0;
+            totalOut += json.usage?.completion_tokens ?? 0;
+            const choice = json.choices && json.choices[0];
+            if (!choice)
+                throw new XaiApiError('xAI returned no choices', 502);
+            const aMessage = choice.message;
+            const finishReason = choice.finish_reason;
+            if (!aMessage.tool_calls || aMessage.tool_calls.length === 0 || finishReason !== 'tool_calls') {
+                return {
+                    text: aMessage.content || '',
+                    tokensIn: totalIn,
+                    tokensOut: totalOut,
+                    model: serverModel,
+                    toolRounds,
+                };
+            }
+            if (familyResolved === null && aMessage.tool_calls.length > 0) {
+                const firstTc = aMessage.tool_calls[0];
+                if (firstTc) {
+                    let firstArgs = {};
+                    try {
+                        firstArgs = JSON.parse(firstTc.function.arguments || '{}');
+                    }
+                    catch { /* */ }
+                    const firstVerb = firstArgs.verb_id || firstTc.function.name || '';
+                    const fam = classifyVerbFamily(firstVerb);
+                    familyResolved = fam;
+                    if (!callerSpecifiedCap) {
+                        const famCap = getMaxToolRoundsForFamily(limits.max_tool_rounds, fam);
+                        if (famCap > maxRounds)
+                            maxRounds = famCap;
+                    }
+                }
+            }
+            messages.push({
+                role: 'assistant',
+                content: aMessage.content ?? null,
+                tool_calls: aMessage.tool_calls,
+            });
+            for (const tc of aMessage.tool_calls) {
+                let parsedArgs = {};
+                try {
+                    parsedArgs = JSON.parse(tc.function.arguments || '{}');
+                }
+                catch { /* */ }
+                let result;
+                let isError = false;
+                try {
+                    const r = await req.runTool(tc.function.name, parsedArgs);
+                    result = r.result;
+                    isError = r.is_error === true;
+                }
+                catch (err) {
+                    result = { error: err instanceof Error ? err.message : String(err) };
+                    isError = true;
+                }
+                const display = typeof result === 'object' && result !== null && 'display' in result
+                    ? String(result.display)
+                    : undefined;
+                toolRounds.push({
+                    tool: tc.function.name,
+                    tool_use_id: tc.id,
+                    input: parsedArgs,
+                    ...(display ? { display } : {}),
+                    ...(isError ? { is_error: true } : {}),
+                    result,
+                });
+                let resultStr;
+                try {
+                    resultStr = typeof result === 'string' ? result : JSON.stringify(result);
+                }
+                catch {
+                    resultStr = String(result);
+                }
+                if (resultStr.length > 200_000) {
+                    resultStr = JSON.stringify({ _truncated: true, _bytes: resultStr.length });
+                }
+                messages.push({ role: 'tool', tool_call_id: tc.id, content: resultStr });
+            }
+        }
+        return {
+            text: '[Alcance el limite de rondas (' + maxRounds + '/' + maxRounds +
+                ') en esta tarea (familia=' + (familyResolved ?? 'default') + ').]',
+            tokensIn: totalIn,
+            tokensOut: totalOut,
+            model: serverModel,
+            toolRounds,
+        };
+    }
+}
+//# sourceMappingURL=xai_client.js.map

package/dist/llm/xai_client.js.map

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

package/dist/mcp/bridge_registry.d.ts

@@ -0,0 +1,77 @@
+/**
+ * F101 alpha.60 slice 1 -- MCPBridgeRegistry: discovery of
+ * MCP bridges from 4 sources.
+ *
+ * Per docs/F101_MCP_BRIDGE.md section 1.4 (Q4 autodiscovery),
+ * each `yf chat` startup scans 4 places in parallel:
+ *
+ *   1. Loopback scan -- common ports (3001-3010, 5000, 8000,
+ *      8080) with 200ms timeout each. The MCP server responds
+ *      to GET /.well-known/mcp -> discovered. Loopback only,
+ *      never LAN by default.
+ *   2. Active project manifest -- if the NAC-3 manifest
+ *      declares `mcp_bridges: [...]`, those activate
+ *      automatically.
+ *   3. File convention -- `.yujin-forge/mcp-bridges.json` in
+ *      home + in the project. Read if present.
+ *   4. Env vars -- YUJIN_MCP_BRIDGES="crm:http://localhost:3001,
+ *      slack:http://localhost:3002".
+ *
+ * Hard cap: 10 active bridges. Loopback only (no LAN scanning
+ * in this slice; LAN scan is opt-in via Config in alpha.64).
+ *
+ * Returned shape: a deduplicated list of MCPBridge records.
+ *
+ * ASCII-only.
+ */
+export interface MCPBridge {
+    /** Stable kebab-case identifier. Used as namespace prefix when
+     *  invoking proxied verbs (`crm.list_companies`). */
+    id: string;
+    /** Full base URL of the MCP server. For stdio bridges, set to
+     *  the empty string or a sentinel path; the command field is
+     *  what is invoked. */
+    endpoint: string;
+    /** Where this bridge came from: 'loopback' | 'manifest' | 'file' | 'env'. */
+    source: 'loopback' | 'manifest' | 'file' | 'env';
+    /** Whether this bridge is currently enabled (default true). User
+     *  can flip via `yf mcp disable <id>`. */
+    enabled: boolean;
+    /** Optional pretty name shown in CLI output. */
+    display_name?: string;
+    /** F101 slice 4 FULL -- MCP transport protocol. Defaults to
+     *  'http_rest' when omitted (preserves slice 4 minimal behaviour
+     *  byte-for-byte). 'stdio' spawns the command; 'sse' uses
+     *  Server-Sent Events. */
+    protocol?: 'http_rest' | 'stdio' | 'sse';
+    /** Shell command for protocol === 'stdio'. Ignored otherwise. */
+    command?: string;
+}
+export interface DiscoveryOptions {
+    /** Project root (used by source 2 + 3). Optional. */
+    projectRoot?: string;
+    /** Max ms to wait for a single loopback probe. Default 200. */
+    loopbackTimeoutMs?: number;
+    /** Ports to scan in loopback. Default: 3001-3010 + 5000 + 8000 + 8080. */
+    loopbackPorts?: number[];
+    /** Hard cap on active bridges. Default 10. */
+    maxActive?: number;
+}
+declare function dedupePreservePrecedence(bridges: MCPBridge[]): MCPBridge[];
+/** Run all 4 discovery sources in parallel + dedupe + cap +
+ *  merge the persistent enabled-state from F101 slice 5
+ *  sub-slice 1 (~/.yujin-forge/mcp-state.json). A bridge marked
+ *  disabled in state surfaces with enabled:false; downstream
+ *  consumers (manifest stub, invoke-tool) filter accordingly. */
+export declare function discoverBridges(opts?: DiscoveryOptions): Promise<MCPBridge[]>;
+export declare function getActiveBridges(opts?: DiscoveryOptions & {
+    refresh?: boolean;
+}): Promise<MCPBridge[]>;
+/** Clear the cache (used in tests + by yf mcp scan). */
+export declare function resetBridgeCache(): void;
+export declare const _internal: {
+    dedupePreservePrecedence: typeof dedupePreservePrecedence;
+    SOURCE_RANK: Record<"manifest" | "env" | "loopback" | "file", number>;
+};
+export {};
+//# sourceMappingURL=bridge_registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge_registry.d.ts","sourceRoot":"","sources":["../../src/mcp/bridge_registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAUH,MAAM,WAAW,SAAS;IACxB;yDACqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX;;2BAEuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;IACjD;8CAC0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;8BAG0B;IAC1B,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,KAAK,CAAC;IACzC,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAyJD,iBAAS,wBAAwB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CASnE;AAMD;;;;iEAIiE;AACjE,wBAAsB,eAAe,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA6BvF;AAOD,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,gBAAgB,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAOhH;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,eAAO,MAAM,SAAS;;;CAA4C,CAAC"}

package/dist/mcp/bridge_registry.js

@@ -0,0 +1,220 @@
+/**
+ * F101 alpha.60 slice 1 -- MCPBridgeRegistry: discovery of
+ * MCP bridges from 4 sources.
+ *
+ * Per docs/F101_MCP_BRIDGE.md section 1.4 (Q4 autodiscovery),
+ * each `yf chat` startup scans 4 places in parallel:
+ *
+ *   1. Loopback scan -- common ports (3001-3010, 5000, 8000,
+ *      8080) with 200ms timeout each. The MCP server responds
+ *      to GET /.well-known/mcp -> discovered. Loopback only,
+ *      never LAN by default.
+ *   2. Active project manifest -- if the NAC-3 manifest
+ *      declares `mcp_bridges: [...]`, those activate
+ *      automatically.
+ *   3. File convention -- `.yujin-forge/mcp-bridges.json` in
+ *      home + in the project. Read if present.
+ *   4. Env vars -- YUJIN_MCP_BRIDGES="crm:http://localhost:3001,
+ *      slack:http://localhost:3002".
+ *
+ * Hard cap: 10 active bridges. Loopback only (no LAN scanning
+ * in this slice; LAN scan is opt-in via Config in alpha.64).
+ *
+ * Returned shape: a deduplicated list of MCPBridge records.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { homedir } from 'node:os';
+const DEFAULT_PORTS = [3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010, 5000, 8000, 8080];
+const HOME_FILE_DIR = '.yujin-forge';
+const HOME_FILE_NAME = 'mcp-bridges.json';
+const PROJECT_FILE_PATH = '.yujin-forge/mcp-bridges.json';
+/* ===================================================================
+ * Source 1 -- loopback scan
+ * ================================================================ */
+async function probeLoopbackPort(port, timeoutMs) {
+    const url = 'http://127.0.0.1:' + port + '/.well-known/mcp';
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const r = await fetch(url, { signal: controller.signal });
+        clearTimeout(timer);
+        if (!r.ok)
+            return null;
+        const body = await r.json().catch(() => null);
+        /* The MCP server is expected to identify itself via the
+         * well-known endpoint. Fall back to a port-derived id. */
+        const id = (body && typeof body.id === 'string' && body.id) || ('local-' + port);
+        return {
+            id,
+            endpoint: 'http://127.0.0.1:' + port,
+            source: 'loopback',
+            enabled: true,
+            display_name: body?.name,
+        };
+    }
+    catch {
+        clearTimeout(timer);
+        return null;
+    }
+}
+async function discoverFromLoopback(ports, timeoutMs) {
+    const probes = ports.map((p) => probeLoopbackPort(p, timeoutMs));
+    const results = await Promise.all(probes);
+    return results.filter((b) => b !== null);
+}
+async function discoverFromManifest(projectRoot) {
+    const manifestPath = path.join(projectRoot, 'yujin.forge.json');
+    try {
+        const raw = await fs.readFile(manifestPath, 'utf-8');
+        const json = JSON.parse(raw);
+        if (!Array.isArray(json.mcp_bridges))
+            return [];
+        return json.mcp_bridges
+            .filter((b) => typeof b.id === 'string' && typeof b.endpoint === 'string')
+            .map((b) => ({
+            id: b.id,
+            endpoint: b.endpoint,
+            source: 'manifest',
+            enabled: true,
+            display_name: b.display_name,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+async function readBridgesFile(file, source) {
+    try {
+        const raw = await fs.readFile(file, 'utf-8');
+        const json = JSON.parse(raw);
+        if (!Array.isArray(json.bridges))
+            return [];
+        return json.bridges
+            .filter((b) => typeof b.id === 'string' && typeof b.endpoint === 'string')
+            .map((b) => ({
+            id: b.id,
+            endpoint: b.endpoint,
+            source,
+            enabled: b.enabled !== false,
+            display_name: b.display_name,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+async function discoverFromFiles(projectRoot) {
+    const homeFile = path.join(homedir(), HOME_FILE_DIR, HOME_FILE_NAME);
+    const result = [];
+    result.push(...await readBridgesFile(homeFile, 'file'));
+    if (projectRoot) {
+        const projectFile = path.join(projectRoot, PROJECT_FILE_PATH);
+        result.push(...await readBridgesFile(projectFile, 'file'));
+    }
+    return result;
+}
+/* ===================================================================
+ * Source 4 -- env vars
+ * ================================================================ */
+function discoverFromEnv() {
+    const raw = process.env.YUJIN_MCP_BRIDGES;
+    if (!raw)
+        return [];
+    /* Format: "id1:url1,id2:url2,id3:url3" */
+    const parts = raw.split(',').map((s) => s.trim()).filter(Boolean);
+    const out = [];
+    for (const part of parts) {
+        const colon = part.indexOf(':');
+        if (colon <= 0)
+            continue;
+        const id = part.slice(0, colon).trim();
+        const endpoint = part.slice(colon + 1).trim();
+        if (!id || !endpoint)
+            continue;
+        out.push({
+            id,
+            endpoint,
+            source: 'env',
+            enabled: true,
+        });
+    }
+    return out;
+}
+/* ===================================================================
+ * Dedup + cap
+ * ================================================================ */
+/** Precedence when an id appears in multiple sources:
+ *  env > manifest > file > loopback. Higher-precedence wins. */
+const SOURCE_RANK = {
+    env: 4, manifest: 3, file: 2, loopback: 1,
+};
+function dedupePreservePrecedence(bridges) {
+    const byId = new Map();
+    for (const b of bridges) {
+        const existing = byId.get(b.id);
+        if (!existing || SOURCE_RANK[b.source] > SOURCE_RANK[existing.source]) {
+            byId.set(b.id, b);
+        }
+    }
+    return Array.from(byId.values());
+}
+/* ===================================================================
+ * Public API
+ * ================================================================ */
+/** Run all 4 discovery sources in parallel + dedupe + cap +
+ *  merge the persistent enabled-state from F101 slice 5
+ *  sub-slice 1 (~/.yujin-forge/mcp-state.json). A bridge marked
+ *  disabled in state surfaces with enabled:false; downstream
+ *  consumers (manifest stub, invoke-tool) filter accordingly. */
+export async function discoverBridges(opts = {}) {
+    const ports = opts.loopbackPorts ?? DEFAULT_PORTS;
+    const timeoutMs = opts.loopbackTimeoutMs ?? 200;
+    const maxActive = opts.maxActive ?? 10;
+    const [loopback, manifest, files, env, state] = await Promise.all([
+        discoverFromLoopback(ports, timeoutMs),
+        opts.projectRoot ? discoverFromManifest(opts.projectRoot) : Promise.resolve([]),
+        discoverFromFiles(opts.projectRoot),
+        Promise.resolve(discoverFromEnv()),
+        import('./state.js').then((m) => m.readState()).catch(() => ({ version: 1, bridges: {} })),
+    ]);
+    const all = [...loopback, ...manifest, ...files, ...env];
+    const dedup = dedupePreservePrecedence(all);
+    /* Apply persisted enabled-state. Default true when the bridge
+     * has no entry yet. */
+    for (const b of dedup) {
+        const entry = state.bridges[b.id];
+        if (entry && entry.enabled === false)
+            b.enabled = false;
+    }
+    /* Sort: enabled first, then by source rank (env first), then by id. */
+    dedup.sort((a, b) => {
+        if (a.enabled !== b.enabled)
+            return a.enabled ? -1 : 1;
+        if (a.source !== b.source)
+            return SOURCE_RANK[b.source] - SOURCE_RANK[a.source];
+        return a.id.localeCompare(b.id);
+    });
+    /* Cap. */
+    return dedup.slice(0, maxActive);
+}
+/** Singleton accessor with simple per-process cache (60s).
+ *  Recomputed when `refresh: true` passed. */
+let _cache = null;
+const CACHE_TTL_MS = 60 * 1000;
+export async function getActiveBridges(opts = {}) {
+    if (!opts.refresh && _cache && Date.now() - _cache.at < CACHE_TTL_MS) {
+        return _cache.bridges;
+    }
+    const bridges = await discoverBridges(opts);
+    _cache = { bridges, at: Date.now() };
+    return bridges;
+}
+/** Clear the cache (used in tests + by yf mcp scan). */
+export function resetBridgeCache() {
+    _cache = null;
+}
+export const _internal = { dedupePreservePrecedence, SOURCE_RANK };
+//# sourceMappingURL=bridge_registry.js.map

package/dist/mcp/bridge_registry.js.map

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

package/dist/mcp/config.d.ts

@@ -0,0 +1,25 @@
+export interface McpConfig {
+    enabled: boolean;
+    bridges_path: string;
+    discover_default_limit: number;
+    transient_tools_ttl_turns: number;
+    max_concurrent_servers: number;
+}
+declare function configPath(): string;
+declare function defaultBridgesPath(): string;
+/** Read the MCP section + apply defaults. */
+export declare function readMcpConfig(): Promise<McpConfig>;
+/** Patch the mcp section. Other top-level keys preserved. */
+export declare function patchMcpConfig(patch: Partial<McpConfig>): Promise<McpConfig>;
+/** 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 declare function mcpEnabled(): Promise<boolean>;
+export declare function mcpEnabledSync(): boolean;
+export declare function primeSyncCache(): Promise<void>;
+export declare const _internal: {
+    configPath: typeof configPath;
+    defaultBridgesPath: typeof defaultBridgesPath;
+};
+export {};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAoB,OAAO,CAAC;IACnC,YAAY,EAAe,MAAM,CAAC;IAClC,sBAAsB,EAAK,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,sBAAsB,EAAK,MAAM,CAAC;CACnC;AAeD,iBAAS,UAAU,IAAI,MAAM,CAE5B;AAED,iBAAS,kBAAkB,IAAI,MAAM,CAEpC;AAqBD,6CAA6C;AAC7C,wBAAsB,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,CAkBxD;AAED,6DAA6D;AAC7D,wBAAsB,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAOlF;AAED;;wDAEwD;AACxD,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAKnD;AAMD,wBAAgB,cAAc,IAAI,OAAO,CAIxC;AACD,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAGD,eAAO,MAAM,SAAS;;;CAAqC,CAAC"}