@hoilab/ada-cli 0.84.21 → 0.85.0

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

@@ -0,0 +1,60 @@
+/**
+ * Cliente MCP nativo en TypeScript.
+ *
+ * El competidor no tiene esto: su host solo hace OAuth y el protocolo lo habla
+ * su kernel Python. Nosotros rechazamos el kernel, así que hablamos MCP
+ * directamente — lo que además elimina su dependencia de un venv de ~500MB.
+ *
+ * Implementa el transporte Streamable HTTP (JSON-RPC 2.0 sobre POST), que es el
+ * que usan los servidores MCP alojados. Los servidores stdio quedan fuera a
+ * propósito: lanzar procesos arbitrarios desde una config es una superficie de
+ * ejecución que no queremos abrir por defecto.
+ */
+export interface McpTool {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface McpCallResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    isError: boolean;
+}
+export interface McpClientOptions {
+    url: string;
+    /** Cabeceras estáticas de la config del usuario. */
+    headers?: Record<string, string>;
+    /** Token bearer (del Vault o de una variable de entorno). */
+    bearerToken?: string;
+    timeoutMs?: number;
+    /** Inyectable para tests. */
+    fetchImpl?: typeof fetch;
+}
+export declare class McpError extends Error {
+    code: number;
+    constructor(message: string, code?: number);
+}
+export declare class McpClient {
+    private url;
+    private headers;
+    private bearerToken?;
+    private timeoutMs;
+    private fetchImpl;
+    private nextId;
+    /** Lo devuelve el servidor en `initialize`; hay que reenviarlo después. */
+    private sessionId?;
+    private initialized;
+    constructor(options: McpClientOptions);
+    private buildHeaders;
+    /** Una respuesta SSE envuelve el JSON en líneas `data:`. */
+    private static parseBody;
+    private rpc;
+    /** Handshake. Idempotente: llamarlo dos veces no reinicia la sesión. */
+    initialize(): Promise<void>;
+    listTools(): Promise<McpTool[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACxE,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACzB;AASD,qBAAa,QAAS,SAAQ,KAAK;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,SAAK,EAIrC;CACD;AAED,qBAAa,SAAS;IACrB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,MAAM,CAAK;IACnB,4EAA2E;IAC3E,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAE5B,YAAY,OAAO,EAAE,gBAAgB,EAMpC;IAED,OAAO,CAAC,YAAY;IAYpB,6DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,SAAS;YAgBV,GAAG;IAwCjB,yEAAwE;IAClE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhC;IAEK,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAIpC;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAMlF;CACD","sourcesContent":["/**\n * Cliente MCP nativo en TypeScript.\n *\n * El competidor no tiene esto: su host solo hace OAuth y el protocolo lo habla\n * su kernel Python. Nosotros rechazamos el kernel, así que hablamos MCP\n * directamente — lo que además elimina su dependencia de un venv de ~500MB.\n *\n * Implementa el transporte Streamable HTTP (JSON-RPC 2.0 sobre POST), que es el\n * que usan los servidores MCP alojados. Los servidores stdio quedan fuera a\n * propósito: lanzar procesos arbitrarios desde una config es una superficie de\n * ejecución que no queremos abrir por defecto.\n */\n\nconst PROTOCOL_VERSION = \"2025-06-18\";\nconst DEFAULT_TIMEOUT_MS = 30_000;\n\nexport interface McpTool {\n\tname: string;\n\tdescription?: string;\n\tinputSchema?: Record<string, unknown>;\n}\n\nexport interface McpCallResult {\n\tcontent: Array<{ type: string; text?: string; [key: string]: unknown }>;\n\tisError: boolean;\n}\n\nexport interface McpClientOptions {\n\turl: string;\n\t/** Cabeceras estáticas de la config del usuario. */\n\theaders?: Record<string, string>;\n\t/** Token bearer (del Vault o de una variable de entorno). */\n\tbearerToken?: string;\n\ttimeoutMs?: number;\n\t/** Inyectable para tests. */\n\tfetchImpl?: typeof fetch;\n}\n\ninterface JsonRpcResponse {\n\tjsonrpc: \"2.0\";\n\tid?: number | string;\n\tresult?: unknown;\n\terror?: { code: number; message: string; data?: unknown };\n}\n\nexport class McpError extends Error {\n\tcode: number;\n\tconstructor(message: string, code = -1) {\n\t\tsuper(message);\n\t\tthis.name = \"McpError\";\n\t\tthis.code = code;\n\t}\n}\n\nexport class McpClient {\n\tprivate url: string;\n\tprivate headers: Record<string, string>;\n\tprivate bearerToken?: string;\n\tprivate timeoutMs: number;\n\tprivate fetchImpl: typeof fetch;\n\tprivate nextId = 1;\n\t/** Lo devuelve el servidor en `initialize`; hay que reenviarlo después. */\n\tprivate sessionId?: string;\n\tprivate initialized = false;\n\n\tconstructor(options: McpClientOptions) {\n\t\tthis.url = options.url;\n\t\tthis.headers = options.headers ?? {};\n\t\tthis.bearerToken = options.bearerToken;\n\t\tthis.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\t\tthis.fetchImpl = options.fetchImpl ?? fetch;\n\t}\n\n\tprivate buildHeaders(): Record<string, string> {\n\t\tconst headers: Record<string, string> = {\n\t\t\t\"content-type\": \"application/json\",\n\t\t\t// Los servidores Streamable HTTP pueden responder JSON o SSE.\n\t\t\taccept: \"application/json, text/event-stream\",\n\t\t\t...this.headers,\n\t\t};\n\t\tif (this.bearerToken) headers.authorization = `Bearer ${this.bearerToken}`;\n\t\tif (this.sessionId) headers[\"mcp-session-id\"] = this.sessionId;\n\t\treturn headers;\n\t}\n\n\t/** Una respuesta SSE envuelve el JSON en líneas `data:`. */\n\tprivate static parseBody(contentType: string, body: string): JsonRpcResponse {\n\t\tif (!contentType.includes(\"text/event-stream\")) return JSON.parse(body) as JsonRpcResponse;\n\t\tfor (const line of body.split(\"\\n\")) {\n\t\t\tconst trimmed = line.trim();\n\t\t\tif (!trimmed.startsWith(\"data:\")) continue;\n\t\t\tconst payload = trimmed.slice(5).trim();\n\t\t\tif (!payload || payload === \"[DONE]\") continue;\n\t\t\ttry {\n\t\t\t\treturn JSON.parse(payload) as JsonRpcResponse;\n\t\t\t} catch {\n\t\t\t\t// siguiente evento\n\t\t\t}\n\t\t}\n\t\tthrow new McpError(\"Respuesta SSE sin payload JSON-RPC\");\n\t}\n\n\tprivate async rpc(method: string, params?: Record<string, unknown>): Promise<unknown> {\n\t\tconst id = this.nextId++;\n\t\tconst controller = new AbortController();\n\t\tconst timer = setTimeout(() => controller.abort(), this.timeoutMs);\n\t\ttry {\n\t\t\tconst response = await this.fetchImpl(this.url, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: this.buildHeaders(),\n\t\t\t\tbody: JSON.stringify({ jsonrpc: \"2.0\", id, method, ...(params ? { params } : {}) }),\n\t\t\t\tsignal: controller.signal,\n\t\t\t});\n\n\t\t\tconst sessionHeader = response.headers?.get?.(\"mcp-session-id\");\n\t\t\tif (sessionHeader) this.sessionId = sessionHeader;\n\n\t\t\tif (!response.ok) {\n\t\t\t\t// 401 se distingue a propósito: es \"falta autenticar\", no un fallo del\n\t\t\t\t// servidor, y el mensaje debe llevar al usuario a /mcp login.\n\t\t\t\tif (response.status === 401 || response.status === 403) {\n\t\t\t\t\tthrow new McpError(`No autenticado contra ${this.url} (HTTP ${response.status})`, response.status);\n\t\t\t\t}\n\t\t\t\tthrow new McpError(`El servidor MCP devolvió HTTP ${response.status}`, response.status);\n\t\t\t}\n\n\t\t\tconst body = await response.text();\n\t\t\tif (!body.trim()) return undefined; // notificación aceptada sin cuerpo\n\t\t\tconst parsed = McpClient.parseBody(response.headers?.get?.(\"content-type\") ?? \"\", body);\n\t\t\tif (parsed.error) throw new McpError(parsed.error.message, parsed.error.code);\n\t\t\treturn parsed.result;\n\t\t} catch (error) {\n\t\t\tif (error instanceof McpError) throw error;\n\t\t\tif ((error as { name?: string }).name === \"AbortError\") {\n\t\t\t\tthrow new McpError(`El servidor MCP no respondió en ${this.timeoutMs}ms`);\n\t\t\t}\n\t\t\tthrow new McpError(error instanceof Error ? error.message : String(error));\n\t\t} finally {\n\t\t\tclearTimeout(timer);\n\t\t}\n\t}\n\n\t/** Handshake. Idempotente: llamarlo dos veces no reinicia la sesión. */\n\tasync initialize(): Promise<void> {\n\t\tif (this.initialized) return;\n\t\tawait this.rpc(\"initialize\", {\n\t\t\tprotocolVersion: PROTOCOL_VERSION,\n\t\t\tcapabilities: {},\n\t\t\tclientInfo: { name: \"ada-cli\", version: \"1\" },\n\t\t});\n\t\t// El servidor espera la notificación antes de aceptar peticiones normales.\n\t\tawait this.rpc(\"notifications/initialized\").catch(() => {});\n\t\tthis.initialized = true;\n\t}\n\n\tasync listTools(): Promise<McpTool[]> {\n\t\tawait this.initialize();\n\t\tconst result = (await this.rpc(\"tools/list\")) as { tools?: McpTool[] } | undefined;\n\t\treturn result?.tools ?? [];\n\t}\n\n\tasync callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult> {\n\t\tawait this.initialize();\n\t\tconst result = (await this.rpc(\"tools/call\", { name, arguments: args })) as\n\t\t\t| { content?: McpCallResult[\"content\"]; isError?: boolean }\n\t\t\t| undefined;\n\t\treturn { content: result?.content ?? [], isError: result?.isError === true };\n\t}\n}\n"]}

package/dist/core/mcp/client.js

@@ -0,0 +1,139 @@
+/**
+ * Cliente MCP nativo en TypeScript.
+ *
+ * El competidor no tiene esto: su host solo hace OAuth y el protocolo lo habla
+ * su kernel Python. Nosotros rechazamos el kernel, así que hablamos MCP
+ * directamente — lo que además elimina su dependencia de un venv de ~500MB.
+ *
+ * Implementa el transporte Streamable HTTP (JSON-RPC 2.0 sobre POST), que es el
+ * que usan los servidores MCP alojados. Los servidores stdio quedan fuera a
+ * propósito: lanzar procesos arbitrarios desde una config es una superficie de
+ * ejecución que no queremos abrir por defecto.
+ */
+const PROTOCOL_VERSION = "2025-06-18";
+const DEFAULT_TIMEOUT_MS = 30_000;
+export class McpError extends Error {
+    code;
+    constructor(message, code = -1) {
+        super(message);
+        this.name = "McpError";
+        this.code = code;
+    }
+}
+export class McpClient {
+    url;
+    headers;
+    bearerToken;
+    timeoutMs;
+    fetchImpl;
+    nextId = 1;
+    /** Lo devuelve el servidor en `initialize`; hay que reenviarlo después. */
+    sessionId;
+    initialized = false;
+    constructor(options) {
+        this.url = options.url;
+        this.headers = options.headers ?? {};
+        this.bearerToken = options.bearerToken;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    buildHeaders() {
+        const headers = {
+            "content-type": "application/json",
+            // Los servidores Streamable HTTP pueden responder JSON o SSE.
+            accept: "application/json, text/event-stream",
+            ...this.headers,
+        };
+        if (this.bearerToken)
+            headers.authorization = `Bearer ${this.bearerToken}`;
+        if (this.sessionId)
+            headers["mcp-session-id"] = this.sessionId;
+        return headers;
+    }
+    /** Una respuesta SSE envuelve el JSON en líneas `data:`. */
+    static parseBody(contentType, body) {
+        if (!contentType.includes("text/event-stream"))
+            return JSON.parse(body);
+        for (const line of body.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed.startsWith("data:"))
+                continue;
+            const payload = trimmed.slice(5).trim();
+            if (!payload || payload === "[DONE]")
+                continue;
+            try {
+                return JSON.parse(payload);
+            }
+            catch {
+                // siguiente evento
+            }
+        }
+        throw new McpError("Respuesta SSE sin payload JSON-RPC");
+    }
+    async rpc(method, params) {
+        const id = this.nextId++;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await this.fetchImpl(this.url, {
+                method: "POST",
+                headers: this.buildHeaders(),
+                body: JSON.stringify({ jsonrpc: "2.0", id, method, ...(params ? { params } : {}) }),
+                signal: controller.signal,
+            });
+            const sessionHeader = response.headers?.get?.("mcp-session-id");
+            if (sessionHeader)
+                this.sessionId = sessionHeader;
+            if (!response.ok) {
+                // 401 se distingue a propósito: es "falta autenticar", no un fallo del
+                // servidor, y el mensaje debe llevar al usuario a /mcp login.
+                if (response.status === 401 || response.status === 403) {
+                    throw new McpError(`No autenticado contra ${this.url} (HTTP ${response.status})`, response.status);
+                }
+                throw new McpError(`El servidor MCP devolvió HTTP ${response.status}`, response.status);
+            }
+            const body = await response.text();
+            if (!body.trim())
+                return undefined; // notificación aceptada sin cuerpo
+            const parsed = McpClient.parseBody(response.headers?.get?.("content-type") ?? "", body);
+            if (parsed.error)
+                throw new McpError(parsed.error.message, parsed.error.code);
+            return parsed.result;
+        }
+        catch (error) {
+            if (error instanceof McpError)
+                throw error;
+            if (error.name === "AbortError") {
+                throw new McpError(`El servidor MCP no respondió en ${this.timeoutMs}ms`);
+            }
+            throw new McpError(error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** Handshake. Idempotente: llamarlo dos veces no reinicia la sesión. */
+    async initialize() {
+        if (this.initialized)
+            return;
+        await this.rpc("initialize", {
+            protocolVersion: PROTOCOL_VERSION,
+            capabilities: {},
+            clientInfo: { name: "ada-cli", version: "1" },
+        });
+        // El servidor espera la notificación antes de aceptar peticiones normales.
+        await this.rpc("notifications/initialized").catch(() => { });
+        this.initialized = true;
+    }
+    async listTools() {
+        await this.initialize();
+        const result = (await this.rpc("tools/list"));
+        return result?.tools ?? [];
+    }
+    async callTool(name, args) {
+        await this.initialize();
+        const result = (await this.rpc("tools/call", { name, arguments: args }));
+        return { content: result?.content ?? [], isError: result?.isError === true };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/core/mcp/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/mcp/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cliente MCP nativo en TypeScript.\n *\n * El competidor no tiene esto: su host solo hace OAuth y el protocolo lo habla\n * su kernel Python. Nosotros rechazamos el kernel, así que hablamos MCP\n * directamente — lo que además elimina su dependencia de un venv de ~500MB.\n *\n * Implementa el transporte Streamable HTTP (JSON-RPC 2.0 sobre POST), que es el\n * que usan los servidores MCP alojados. Los servidores stdio quedan fuera a\n * propósito: lanzar procesos arbitrarios desde una config es una superficie de\n * ejecución que no queremos abrir por defecto.\n */\n\nconst PROTOCOL_VERSION = \"2025-06-18\";\nconst DEFAULT_TIMEOUT_MS = 30_000;\n\nexport interface McpTool {\n\tname: string;\n\tdescription?: string;\n\tinputSchema?: Record<string, unknown>;\n}\n\nexport interface McpCallResult {\n\tcontent: Array<{ type: string; text?: string; [key: string]: unknown }>;\n\tisError: boolean;\n}\n\nexport interface McpClientOptions {\n\turl: string;\n\t/** Cabeceras estáticas de la config del usuario. */\n\theaders?: Record<string, string>;\n\t/** Token bearer (del Vault o de una variable de entorno). */\n\tbearerToken?: string;\n\ttimeoutMs?: number;\n\t/** Inyectable para tests. */\n\tfetchImpl?: typeof fetch;\n}\n\ninterface JsonRpcResponse {\n\tjsonrpc: \"2.0\";\n\tid?: number | string;\n\tresult?: unknown;\n\terror?: { code: number; message: string; data?: unknown };\n}\n\nexport class McpError extends Error {\n\tcode: number;\n\tconstructor(message: string, code = -1) {\n\t\tsuper(message);\n\t\tthis.name = \"McpError\";\n\t\tthis.code = code;\n\t}\n}\n\nexport class McpClient {\n\tprivate url: string;\n\tprivate headers: Record<string, string>;\n\tprivate bearerToken?: string;\n\tprivate timeoutMs: number;\n\tprivate fetchImpl: typeof fetch;\n\tprivate nextId = 1;\n\t/** Lo devuelve el servidor en `initialize`; hay que reenviarlo después. */\n\tprivate sessionId?: string;\n\tprivate initialized = false;\n\n\tconstructor(options: McpClientOptions) {\n\t\tthis.url = options.url;\n\t\tthis.headers = options.headers ?? {};\n\t\tthis.bearerToken = options.bearerToken;\n\t\tthis.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\t\tthis.fetchImpl = options.fetchImpl ?? fetch;\n\t}\n\n\tprivate buildHeaders(): Record<string, string> {\n\t\tconst headers: Record<string, string> = {\n\t\t\t\"content-type\": \"application/json\",\n\t\t\t// Los servidores Streamable HTTP pueden responder JSON o SSE.\n\t\t\taccept: \"application/json, text/event-stream\",\n\t\t\t...this.headers,\n\t\t};\n\t\tif (this.bearerToken) headers.authorization = `Bearer ${this.bearerToken}`;\n\t\tif (this.sessionId) headers[\"mcp-session-id\"] = this.sessionId;\n\t\treturn headers;\n\t}\n\n\t/** Una respuesta SSE envuelve el JSON en líneas `data:`. */\n\tprivate static parseBody(contentType: string, body: string): JsonRpcResponse {\n\t\tif (!contentType.includes(\"text/event-stream\")) return JSON.parse(body) as JsonRpcResponse;\n\t\tfor (const line of body.split(\"\\n\")) {\n\t\t\tconst trimmed = line.trim();\n\t\t\tif (!trimmed.startsWith(\"data:\")) continue;\n\t\t\tconst payload = trimmed.slice(5).trim();\n\t\t\tif (!payload || payload === \"[DONE]\") continue;\n\t\t\ttry {\n\t\t\t\treturn JSON.parse(payload) as JsonRpcResponse;\n\t\t\t} catch {\n\t\t\t\t// siguiente evento\n\t\t\t}\n\t\t}\n\t\tthrow new McpError(\"Respuesta SSE sin payload JSON-RPC\");\n\t}\n\n\tprivate async rpc(method: string, params?: Record<string, unknown>): Promise<unknown> {\n\t\tconst id = this.nextId++;\n\t\tconst controller = new AbortController();\n\t\tconst timer = setTimeout(() => controller.abort(), this.timeoutMs);\n\t\ttry {\n\t\t\tconst response = await this.fetchImpl(this.url, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: this.buildHeaders(),\n\t\t\t\tbody: JSON.stringify({ jsonrpc: \"2.0\", id, method, ...(params ? { params } : {}) }),\n\t\t\t\tsignal: controller.signal,\n\t\t\t});\n\n\t\t\tconst sessionHeader = response.headers?.get?.(\"mcp-session-id\");\n\t\t\tif (sessionHeader) this.sessionId = sessionHeader;\n\n\t\t\tif (!response.ok) {\n\t\t\t\t// 401 se distingue a propósito: es \"falta autenticar\", no un fallo del\n\t\t\t\t// servidor, y el mensaje debe llevar al usuario a /mcp login.\n\t\t\t\tif (response.status === 401 || response.status === 403) {\n\t\t\t\t\tthrow new McpError(`No autenticado contra ${this.url} (HTTP ${response.status})`, response.status);\n\t\t\t\t}\n\t\t\t\tthrow new McpError(`El servidor MCP devolvió HTTP ${response.status}`, response.status);\n\t\t\t}\n\n\t\t\tconst body = await response.text();\n\t\t\tif (!body.trim()) return undefined; // notificación aceptada sin cuerpo\n\t\t\tconst parsed = McpClient.parseBody(response.headers?.get?.(\"content-type\") ?? \"\", body);\n\t\t\tif (parsed.error) throw new McpError(parsed.error.message, parsed.error.code);\n\t\t\treturn parsed.result;\n\t\t} catch (error) {\n\t\t\tif (error instanceof McpError) throw error;\n\t\t\tif ((error as { name?: string }).name === \"AbortError\") {\n\t\t\t\tthrow new McpError(`El servidor MCP no respondió en ${this.timeoutMs}ms`);\n\t\t\t}\n\t\t\tthrow new McpError(error instanceof Error ? error.message : String(error));\n\t\t} finally {\n\t\t\tclearTimeout(timer);\n\t\t}\n\t}\n\n\t/** Handshake. Idempotente: llamarlo dos veces no reinicia la sesión. */\n\tasync initialize(): Promise<void> {\n\t\tif (this.initialized) return;\n\t\tawait this.rpc(\"initialize\", {\n\t\t\tprotocolVersion: PROTOCOL_VERSION,\n\t\t\tcapabilities: {},\n\t\t\tclientInfo: { name: \"ada-cli\", version: \"1\" },\n\t\t});\n\t\t// El servidor espera la notificación antes de aceptar peticiones normales.\n\t\tawait this.rpc(\"notifications/initialized\").catch(() => {});\n\t\tthis.initialized = true;\n\t}\n\n\tasync listTools(): Promise<McpTool[]> {\n\t\tawait this.initialize();\n\t\tconst result = (await this.rpc(\"tools/list\")) as { tools?: McpTool[] } | undefined;\n\t\treturn result?.tools ?? [];\n\t}\n\n\tasync callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult> {\n\t\tawait this.initialize();\n\t\tconst result = (await this.rpc(\"tools/call\", { name, arguments: args })) as\n\t\t\t| { content?: McpCallResult[\"content\"]; isError?: boolean }\n\t\t\t| undefined;\n\t\treturn { content: result?.content ?? [], isError: result?.isError === true };\n\t}\n}\n"]}

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

@@ -0,0 +1,86 @@
+/**
+ * Gestor de integraciones MCP.
+ *
+ * Diferencias deliberadas con el competidor, todas a nuestro favor:
+ *
+ * - El protocolo se habla en TypeScript (`client.ts`), no en un kernel Python.
+ * - Los tokens salen del **Vault cifrado**, no de un `auth.json` en claro.
+ * - Se exponen al modelo EXACTAMENTE DOS tools (`mcp_list_tools`,
+ *   `mcp_call_tool`), no una por cada tool remota: un servidor con 40 tools no
+ *   puede inflar el prompt ni desplazar el prefijo cacheable.
+ * - Solo en la sesión principal (anti-recursión): un subagente no alcanza Jira.
+ *
+ * Y una regla suya que SÍ copiamos porque no es obvia y la acertaron: si el
+ * usuario redefine un servidor del catálogo con su propia URL, esa entrada NO
+ * hereda las credenciales del builtin. Si no, el token emitido para el endpoint
+ * oficial acabaría enviándose a una URL arbitraria.
+ */
+import { type McpCallResult, McpClient, type McpTool } from "./client.ts";
+export interface McpServerConfig {
+    url: string;
+    /** Cabeceras estáticas (p. ej. una API key propia). */
+    headers?: Record<string, string>;
+    /** Variable de entorno con el bearer token. */
+    bearerTokenEnvVar?: string;
+    /** Nombre del secreto en el Vault. Preferido sobre la variable de entorno. */
+    vaultSecret?: string;
+    enabled?: boolean;
+}
+export interface McpCatalogEntry {
+    server: string;
+    label: string;
+    url: string;
+}
+/** Catálogo mínimo. Se mantiene corto a propósito: cada entrada es soporte. */
+export declare const BUILTIN_MCP_CATALOG: readonly McpCatalogEntry[];
+export declare function getCatalogEntry(server: string): McpCatalogEntry | undefined;
+export interface ResolvedIntegration {
+    server: string;
+    label: string;
+    url: string;
+    headers?: Record<string, string>;
+    bearerTokenEnvVar?: string;
+    vaultSecret?: string;
+    enabled: boolean;
+    /** Viene de la config del usuario (puede redefinir un nombre del catálogo). */
+    userDeclared: boolean;
+}
+export interface McpManagerOptions {
+    getServers: () => Record<string, McpServerConfig> | undefined;
+    /** Lee un secreto del Vault. Devuelve undefined si está bloqueado. */
+    getVaultSecret?: (name: string) => Promise<string | undefined>;
+    /** Inyectable para tests. */
+    createClient?: (integration: ResolvedIntegration, token?: string) => McpClient;
+    /**
+     * `fetch` con el que hablar con los servidores MCP.
+     *
+     * Existe para que las salidas queden en el libro de sesión. Sin esto, el
+     * informe para el DPO escribía «No hubo transferencias» sobre una sesión que
+     * había hablado con un MCP remoto — y contactar con un servidor de terceros
+     * ES una transferencia (art. 44 RGPD). Ver `core/web/registro-red.ts`.
+     */
+    fetchImpl?: typeof fetch;
+}
+export declare class McpManager {
+    private options;
+    private integrations;
+    private clients;
+    constructor(options: McpManagerOptions);
+    /** Re-lee la configuración. Llamar tras un reload de sesión. */
+    refresh(): void;
+    list(): ResolvedIntegration[];
+    /**
+     * Token de una integración.
+     *
+     * Regla de seguridad: una entrada del usuario que redefine un nombre del
+     * catálogo NO hereda credenciales del builtin — solo se autentica con lo que
+     * ella misma declara (vault o variable de entorno). Sin esto, el token del
+     * endpoint oficial podría acabar en una URL arbitraria.
+     */
+    tokenFor(integration: ResolvedIntegration): Promise<string | undefined>;
+    isAvailable(integration: ResolvedIntegration): Promise<boolean>;
+    private clientFor;
+    listTools(server: string): Promise<McpTool[]>;
+    callTool(server: string, tool: string, args: Record<string, unknown>): Promise<McpCallResult>;
+}
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,KAAK,aAAa,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,kFAA+E;AAC/E,eAAO,MAAM,mBAAmB,EAAE,SAAS,eAAe,EAGzD,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE3E;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,gFAA+E;IAC/E,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,CAAC;IAC9D,uEAAsE;IACtE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/D,6BAA6B;IAC7B,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,SAAS,CAAC;IAC/E;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACzB;AAED,qBAAa,UAAU;IACtB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,OAAO,CAAgC;IAE/C,YAAY,OAAO,EAAE,iBAAiB,EAGrC;IAED,kEAAgE;IAChE,OAAO,IAAI,IAAI,CAyBd;IAED,IAAI,IAAI,mBAAmB,EAAE,CAE5B;IAED;;;;;;;OAOG;IACG,QAAQ,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU5E;IAEK,WAAW,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAGpE;YAEa,SAAS;IA0BjB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAElD;IAEK,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAElG;CACD","sourcesContent":["/**\n * Gestor de integraciones MCP.\n *\n * Diferencias deliberadas con el competidor, todas a nuestro favor:\n *\n * - El protocolo se habla en TypeScript (`client.ts`), no en un kernel Python.\n * - Los tokens salen del **Vault cifrado**, no de un `auth.json` en claro.\n * - Se exponen al modelo EXACTAMENTE DOS tools (`mcp_list_tools`,\n *   `mcp_call_tool`), no una por cada tool remota: un servidor con 40 tools no\n *   puede inflar el prompt ni desplazar el prefijo cacheable.\n * - Solo en la sesión principal (anti-recursión): un subagente no alcanza Jira.\n *\n * Y una regla suya que SÍ copiamos porque no es obvia y la acertaron: si el\n * usuario redefine un servidor del catálogo con su propia URL, esa entrada NO\n * hereda las credenciales del builtin. Si no, el token emitido para el endpoint\n * oficial acabaría enviándose a una URL arbitraria.\n */\n\nimport { anotarRedDeLaSesion, fetchConRegistro } from \"../web/registro-red.ts\";\nimport { type McpCallResult, McpClient, type McpTool } from \"./client.ts\";\n\nexport interface McpServerConfig {\n\turl: string;\n\t/** Cabeceras estáticas (p. ej. una API key propia). */\n\theaders?: Record<string, string>;\n\t/** Variable de entorno con el bearer token. */\n\tbearerTokenEnvVar?: string;\n\t/** Nombre del secreto en el Vault. Preferido sobre la variable de entorno. */\n\tvaultSecret?: string;\n\tenabled?: boolean;\n}\n\nexport interface McpCatalogEntry {\n\tserver: string;\n\tlabel: string;\n\turl: string;\n}\n\n/** Catálogo mínimo. Se mantiene corto a propósito: cada entrada es soporte. */\nexport const BUILTIN_MCP_CATALOG: readonly McpCatalogEntry[] = [\n\t{ server: \"linear\", label: \"Linear\", url: \"https://mcp.linear.app/mcp\" },\n\t{ server: \"notion\", label: \"Notion\", url: \"https://mcp.notion.com/mcp\" },\n];\n\nexport function getCatalogEntry(server: string): McpCatalogEntry | undefined {\n\treturn BUILTIN_MCP_CATALOG.find((entry) => entry.server === server);\n}\n\nexport interface ResolvedIntegration {\n\tserver: string;\n\tlabel: string;\n\turl: string;\n\theaders?: Record<string, string>;\n\tbearerTokenEnvVar?: string;\n\tvaultSecret?: string;\n\tenabled: boolean;\n\t/** Viene de la config del usuario (puede redefinir un nombre del catálogo). */\n\tuserDeclared: boolean;\n}\n\nexport interface McpManagerOptions {\n\tgetServers: () => Record<string, McpServerConfig> | undefined;\n\t/** Lee un secreto del Vault. Devuelve undefined si está bloqueado. */\n\tgetVaultSecret?: (name: string) => Promise<string | undefined>;\n\t/** Inyectable para tests. */\n\tcreateClient?: (integration: ResolvedIntegration, token?: string) => McpClient;\n\t/**\n\t * `fetch` con el que hablar con los servidores MCP.\n\t *\n\t * Existe para que las salidas queden en el libro de sesión. Sin esto, el\n\t * informe para el DPO escribía «No hubo transferencias» sobre una sesión que\n\t * había hablado con un MCP remoto — y contactar con un servidor de terceros\n\t * ES una transferencia (art. 44 RGPD). Ver `core/web/registro-red.ts`.\n\t */\n\tfetchImpl?: typeof fetch;\n}\n\nexport class McpManager {\n\tprivate options: McpManagerOptions;\n\tprivate integrations = new Map<string, ResolvedIntegration>();\n\tprivate clients = new Map<string, McpClient>();\n\n\tconstructor(options: McpManagerOptions) {\n\t\tthis.options = options;\n\t\tthis.refresh();\n\t}\n\n\t/** Re-lee la configuración. Llamar tras un reload de sesión. */\n\trefresh(): void {\n\t\tconst resolved = new Map<string, ResolvedIntegration>();\n\t\tfor (const entry of BUILTIN_MCP_CATALOG) {\n\t\t\tresolved.set(entry.server, {\n\t\t\t\tserver: entry.server,\n\t\t\t\tlabel: entry.label,\n\t\t\t\turl: entry.url,\n\t\t\t\tenabled: false, // sin credenciales no está disponible\n\t\t\t\tuserDeclared: false,\n\t\t\t});\n\t\t}\n\t\tfor (const [server, config] of Object.entries(this.options.getServers() ?? {})) {\n\t\t\tresolved.set(server, {\n\t\t\t\tserver,\n\t\t\t\tlabel: server,\n\t\t\t\turl: config.url,\n\t\t\t\theaders: config.headers,\n\t\t\t\tbearerTokenEnvVar: config.bearerTokenEnvVar,\n\t\t\t\tvaultSecret: config.vaultSecret,\n\t\t\t\tenabled: config.enabled !== false,\n\t\t\t\tuserDeclared: true,\n\t\t\t});\n\t\t}\n\t\tthis.integrations = resolved;\n\t\tthis.clients.clear();\n\t}\n\n\tlist(): ResolvedIntegration[] {\n\t\treturn [...this.integrations.values()];\n\t}\n\n\t/**\n\t * Token de una integración.\n\t *\n\t * Regla de seguridad: una entrada del usuario que redefine un nombre del\n\t * catálogo NO hereda credenciales del builtin — solo se autentica con lo que\n\t * ella misma declara (vault o variable de entorno). Sin esto, el token del\n\t * endpoint oficial podría acabar en una URL arbitraria.\n\t */\n\tasync tokenFor(integration: ResolvedIntegration): Promise<string | undefined> {\n\t\tif (integration.vaultSecret && this.options.getVaultSecret) {\n\t\t\tconst secret = await this.options.getVaultSecret(integration.vaultSecret);\n\t\t\tif (secret) return secret;\n\t\t}\n\t\tif (integration.bearerTokenEnvVar) {\n\t\t\tconst value = process.env[integration.bearerTokenEnvVar]?.trim();\n\t\t\tif (value) return value;\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tasync isAvailable(integration: ResolvedIntegration): Promise<boolean> {\n\t\tif (!integration.enabled) return false;\n\t\treturn (await this.tokenFor(integration)) !== undefined;\n\t}\n\n\tprivate async clientFor(server: string): Promise<McpClient> {\n\t\tconst integration = this.integrations.get(server);\n\t\tif (!integration) throw new Error(`Servidor MCP desconocido: ${server}. Usa /mcp para ver los configurados.`);\n\t\tif (!integration.enabled) throw new Error(`El servidor MCP '${server}' está desactivado.`);\n\t\tconst cached = this.clients.get(server);\n\t\tif (cached) return cached;\n\t\tconst token = await this.tokenFor(integration);\n\t\tif (!token) {\n\t\t\tthrow new Error(\n\t\t\t\t`Sin credenciales para '${server}'. Guarda el token en el vault (/vault add) y referencia vaultSecret, o define ${integration.bearerTokenEnvVar ?? \"un bearerTokenEnvVar\"}.`,\n\t\t\t);\n\t\t}\n\t\tconst client =\n\t\t\tthis.options.createClient?.(integration, token) ??\n\t\t\tnew McpClient({\n\t\t\t\turl: integration.url,\n\t\t\t\theaders: integration.headers,\n\t\t\t\tbearerToken: token,\n\t\t\t\t// El publicado por la sesión si no nos han pasado uno: `resource-loader`\n\t\t\t\t// construye este manager y no tiene el libro a mano.\n\t\t\t\tfetchImpl: this.options.fetchImpl ?? fetchConRegistro(fetch, anotarRedDeLaSesion()),\n\t\t\t});\n\t\tthis.clients.set(server, client);\n\t\treturn client;\n\t}\n\n\tasync listTools(server: string): Promise<McpTool[]> {\n\t\treturn (await this.clientFor(server)).listTools();\n\t}\n\n\tasync callTool(server: string, tool: string, args: Record<string, unknown>): Promise<McpCallResult> {\n\t\treturn (await this.clientFor(server)).callTool(tool, args);\n\t}\n}\n"]}

package/dist/core/mcp/manager.js

@@ -0,0 +1,124 @@
+/**
+ * Gestor de integraciones MCP.
+ *
+ * Diferencias deliberadas con el competidor, todas a nuestro favor:
+ *
+ * - El protocolo se habla en TypeScript (`client.ts`), no en un kernel Python.
+ * - Los tokens salen del **Vault cifrado**, no de un `auth.json` en claro.
+ * - Se exponen al modelo EXACTAMENTE DOS tools (`mcp_list_tools`,
+ *   `mcp_call_tool`), no una por cada tool remota: un servidor con 40 tools no
+ *   puede inflar el prompt ni desplazar el prefijo cacheable.
+ * - Solo en la sesión principal (anti-recursión): un subagente no alcanza Jira.
+ *
+ * Y una regla suya que SÍ copiamos porque no es obvia y la acertaron: si el
+ * usuario redefine un servidor del catálogo con su propia URL, esa entrada NO
+ * hereda las credenciales del builtin. Si no, el token emitido para el endpoint
+ * oficial acabaría enviándose a una URL arbitraria.
+ */
+import { anotarRedDeLaSesion, fetchConRegistro } from "../web/registro-red.js";
+import { McpClient } from "./client.js";
+/** Catálogo mínimo. Se mantiene corto a propósito: cada entrada es soporte. */
+export const BUILTIN_MCP_CATALOG = [
+    { server: "linear", label: "Linear", url: "https://mcp.linear.app/mcp" },
+    { server: "notion", label: "Notion", url: "https://mcp.notion.com/mcp" },
+];
+export function getCatalogEntry(server) {
+    return BUILTIN_MCP_CATALOG.find((entry) => entry.server === server);
+}
+export class McpManager {
+    options;
+    integrations = new Map();
+    clients = new Map();
+    constructor(options) {
+        this.options = options;
+        this.refresh();
+    }
+    /** Re-lee la configuración. Llamar tras un reload de sesión. */
+    refresh() {
+        const resolved = new Map();
+        for (const entry of BUILTIN_MCP_CATALOG) {
+            resolved.set(entry.server, {
+                server: entry.server,
+                label: entry.label,
+                url: entry.url,
+                enabled: false, // sin credenciales no está disponible
+                userDeclared: false,
+            });
+        }
+        for (const [server, config] of Object.entries(this.options.getServers() ?? {})) {
+            resolved.set(server, {
+                server,
+                label: server,
+                url: config.url,
+                headers: config.headers,
+                bearerTokenEnvVar: config.bearerTokenEnvVar,
+                vaultSecret: config.vaultSecret,
+                enabled: config.enabled !== false,
+                userDeclared: true,
+            });
+        }
+        this.integrations = resolved;
+        this.clients.clear();
+    }
+    list() {
+        return [...this.integrations.values()];
+    }
+    /**
+     * Token de una integración.
+     *
+     * Regla de seguridad: una entrada del usuario que redefine un nombre del
+     * catálogo NO hereda credenciales del builtin — solo se autentica con lo que
+     * ella misma declara (vault o variable de entorno). Sin esto, el token del
+     * endpoint oficial podría acabar en una URL arbitraria.
+     */
+    async tokenFor(integration) {
+        if (integration.vaultSecret && this.options.getVaultSecret) {
+            const secret = await this.options.getVaultSecret(integration.vaultSecret);
+            if (secret)
+                return secret;
+        }
+        if (integration.bearerTokenEnvVar) {
+            const value = process.env[integration.bearerTokenEnvVar]?.trim();
+            if (value)
+                return value;
+        }
+        return undefined;
+    }
+    async isAvailable(integration) {
+        if (!integration.enabled)
+            return false;
+        return (await this.tokenFor(integration)) !== undefined;
+    }
+    async clientFor(server) {
+        const integration = this.integrations.get(server);
+        if (!integration)
+            throw new Error(`Servidor MCP desconocido: ${server}. Usa /mcp para ver los configurados.`);
+        if (!integration.enabled)
+            throw new Error(`El servidor MCP '${server}' está desactivado.`);
+        const cached = this.clients.get(server);
+        if (cached)
+            return cached;
+        const token = await this.tokenFor(integration);
+        if (!token) {
+            throw new Error(`Sin credenciales para '${server}'. Guarda el token en el vault (/vault add) y referencia vaultSecret, o define ${integration.bearerTokenEnvVar ?? "un bearerTokenEnvVar"}.`);
+        }
+        const client = this.options.createClient?.(integration, token) ??
+            new McpClient({
+                url: integration.url,
+                headers: integration.headers,
+                bearerToken: token,
+                // El publicado por la sesión si no nos han pasado uno: `resource-loader`
+                // construye este manager y no tiene el libro a mano.
+                fetchImpl: this.options.fetchImpl ?? fetchConRegistro(fetch, anotarRedDeLaSesion()),
+            });
+        this.clients.set(server, client);
+        return client;
+    }
+    async listTools(server) {
+        return (await this.clientFor(server)).listTools();
+    }
+    async callTool(server, tool, args) {
+        return (await this.clientFor(server)).callTool(tool, args);
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/core/mcp/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/core/mcp/manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Gestor de integraciones MCP.\n *\n * Diferencias deliberadas con el competidor, todas a nuestro favor:\n *\n * - El protocolo se habla en TypeScript (`client.ts`), no en un kernel Python.\n * - Los tokens salen del **Vault cifrado**, no de un `auth.json` en claro.\n * - Se exponen al modelo EXACTAMENTE DOS tools (`mcp_list_tools`,\n *   `mcp_call_tool`), no una por cada tool remota: un servidor con 40 tools no\n *   puede inflar el prompt ni desplazar el prefijo cacheable.\n * - Solo en la sesión principal (anti-recursión): un subagente no alcanza Jira.\n *\n * Y una regla suya que SÍ copiamos porque no es obvia y la acertaron: si el\n * usuario redefine un servidor del catálogo con su propia URL, esa entrada NO\n * hereda las credenciales del builtin. Si no, el token emitido para el endpoint\n * oficial acabaría enviándose a una URL arbitraria.\n */\n\nimport { anotarRedDeLaSesion, fetchConRegistro } from \"../web/registro-red.ts\";\nimport { type McpCallResult, McpClient, type McpTool } from \"./client.ts\";\n\nexport interface McpServerConfig {\n\turl: string;\n\t/** Cabeceras estáticas (p. ej. una API key propia). */\n\theaders?: Record<string, string>;\n\t/** Variable de entorno con el bearer token. */\n\tbearerTokenEnvVar?: string;\n\t/** Nombre del secreto en el Vault. Preferido sobre la variable de entorno. */\n\tvaultSecret?: string;\n\tenabled?: boolean;\n}\n\nexport interface McpCatalogEntry {\n\tserver: string;\n\tlabel: string;\n\turl: string;\n}\n\n/** Catálogo mínimo. Se mantiene corto a propósito: cada entrada es soporte. */\nexport const BUILTIN_MCP_CATALOG: readonly McpCatalogEntry[] = [\n\t{ server: \"linear\", label: \"Linear\", url: \"https://mcp.linear.app/mcp\" },\n\t{ server: \"notion\", label: \"Notion\", url: \"https://mcp.notion.com/mcp\" },\n];\n\nexport function getCatalogEntry(server: string): McpCatalogEntry | undefined {\n\treturn BUILTIN_MCP_CATALOG.find((entry) => entry.server === server);\n}\n\nexport interface ResolvedIntegration {\n\tserver: string;\n\tlabel: string;\n\turl: string;\n\theaders?: Record<string, string>;\n\tbearerTokenEnvVar?: string;\n\tvaultSecret?: string;\n\tenabled: boolean;\n\t/** Viene de la config del usuario (puede redefinir un nombre del catálogo). */\n\tuserDeclared: boolean;\n}\n\nexport interface McpManagerOptions {\n\tgetServers: () => Record<string, McpServerConfig> | undefined;\n\t/** Lee un secreto del Vault. Devuelve undefined si está bloqueado. */\n\tgetVaultSecret?: (name: string) => Promise<string | undefined>;\n\t/** Inyectable para tests. */\n\tcreateClient?: (integration: ResolvedIntegration, token?: string) => McpClient;\n\t/**\n\t * `fetch` con el que hablar con los servidores MCP.\n\t *\n\t * Existe para que las salidas queden en el libro de sesión. Sin esto, el\n\t * informe para el DPO escribía «No hubo transferencias» sobre una sesión que\n\t * había hablado con un MCP remoto — y contactar con un servidor de terceros\n\t * ES una transferencia (art. 44 RGPD). Ver `core/web/registro-red.ts`.\n\t */\n\tfetchImpl?: typeof fetch;\n}\n\nexport class McpManager {\n\tprivate options: McpManagerOptions;\n\tprivate integrations = new Map<string, ResolvedIntegration>();\n\tprivate clients = new Map<string, McpClient>();\n\n\tconstructor(options: McpManagerOptions) {\n\t\tthis.options = options;\n\t\tthis.refresh();\n\t}\n\n\t/** Re-lee la configuración. Llamar tras un reload de sesión. */\n\trefresh(): void {\n\t\tconst resolved = new Map<string, ResolvedIntegration>();\n\t\tfor (const entry of BUILTIN_MCP_CATALOG) {\n\t\t\tresolved.set(entry.server, {\n\t\t\t\tserver: entry.server,\n\t\t\t\tlabel: entry.label,\n\t\t\t\turl: entry.url,\n\t\t\t\tenabled: false, // sin credenciales no está disponible\n\t\t\t\tuserDeclared: false,\n\t\t\t});\n\t\t}\n\t\tfor (const [server, config] of Object.entries(this.options.getServers() ?? {})) {\n\t\t\tresolved.set(server, {\n\t\t\t\tserver,\n\t\t\t\tlabel: server,\n\t\t\t\turl: config.url,\n\t\t\t\theaders: config.headers,\n\t\t\t\tbearerTokenEnvVar: config.bearerTokenEnvVar,\n\t\t\t\tvaultSecret: config.vaultSecret,\n\t\t\t\tenabled: config.enabled !== false,\n\t\t\t\tuserDeclared: true,\n\t\t\t});\n\t\t}\n\t\tthis.integrations = resolved;\n\t\tthis.clients.clear();\n\t}\n\n\tlist(): ResolvedIntegration[] {\n\t\treturn [...this.integrations.values()];\n\t}\n\n\t/**\n\t * Token de una integración.\n\t *\n\t * Regla de seguridad: una entrada del usuario que redefine un nombre del\n\t * catálogo NO hereda credenciales del builtin — solo se autentica con lo que\n\t * ella misma declara (vault o variable de entorno). Sin esto, el token del\n\t * endpoint oficial podría acabar en una URL arbitraria.\n\t */\n\tasync tokenFor(integration: ResolvedIntegration): Promise<string | undefined> {\n\t\tif (integration.vaultSecret && this.options.getVaultSecret) {\n\t\t\tconst secret = await this.options.getVaultSecret(integration.vaultSecret);\n\t\t\tif (secret) return secret;\n\t\t}\n\t\tif (integration.bearerTokenEnvVar) {\n\t\t\tconst value = process.env[integration.bearerTokenEnvVar]?.trim();\n\t\t\tif (value) return value;\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tasync isAvailable(integration: ResolvedIntegration): Promise<boolean> {\n\t\tif (!integration.enabled) return false;\n\t\treturn (await this.tokenFor(integration)) !== undefined;\n\t}\n\n\tprivate async clientFor(server: string): Promise<McpClient> {\n\t\tconst integration = this.integrations.get(server);\n\t\tif (!integration) throw new Error(`Servidor MCP desconocido: ${server}. Usa /mcp para ver los configurados.`);\n\t\tif (!integration.enabled) throw new Error(`El servidor MCP '${server}' está desactivado.`);\n\t\tconst cached = this.clients.get(server);\n\t\tif (cached) return cached;\n\t\tconst token = await this.tokenFor(integration);\n\t\tif (!token) {\n\t\t\tthrow new Error(\n\t\t\t\t`Sin credenciales para '${server}'. Guarda el token en el vault (/vault add) y referencia vaultSecret, o define ${integration.bearerTokenEnvVar ?? \"un bearerTokenEnvVar\"}.`,\n\t\t\t);\n\t\t}\n\t\tconst client =\n\t\t\tthis.options.createClient?.(integration, token) ??\n\t\t\tnew McpClient({\n\t\t\t\turl: integration.url,\n\t\t\t\theaders: integration.headers,\n\t\t\t\tbearerToken: token,\n\t\t\t\t// El publicado por la sesión si no nos han pasado uno: `resource-loader`\n\t\t\t\t// construye este manager y no tiene el libro a mano.\n\t\t\t\tfetchImpl: this.options.fetchImpl ?? fetchConRegistro(fetch, anotarRedDeLaSesion()),\n\t\t\t});\n\t\tthis.clients.set(server, client);\n\t\treturn client;\n\t}\n\n\tasync listTools(server: string): Promise<McpTool[]> {\n\t\treturn (await this.clientFor(server)).listTools();\n\t}\n\n\tasync callTool(server: string, tool: string, args: Record<string, unknown>): Promise<McpCallResult> {\n\t\treturn (await this.clientFor(server)).callTool(tool, args);\n\t}\n}\n"]}

package/dist/core/mcp/tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tools MCP expuestas al modelo: EXACTAMENTE DOS.
+ *
+ * No una por cada tool remota, a propósito. Un servidor con 40 herramientas
+ * inflaría el system prompt con 40 esquemas, desplazaría el prefijo cacheable
+ * (a 31x el token de miss en DeepSeek, eso se paga) y ahogaría a las tools
+ * propias del agente. Con dos, el descubrimiento es explícito y bajo demanda.
+ *
+ * Se registran SOLO en la sesión principal: un subagente no debe poder alcanzar
+ * el Jira de la empresa.
+ */
+import type { ToolDefinition } from "../extensions/types.ts";
+import type { McpManager } from "./manager.ts";
+export declare function createMcpTools(manager: McpManager): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/core/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAyB/C,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA2DlF","sourcesContent":["/**\n * Tools MCP expuestas al modelo: EXACTAMENTE DOS.\n *\n * No una por cada tool remota, a propósito. Un servidor con 40 herramientas\n * inflaría el system prompt con 40 esquemas, desplazaría el prefijo cacheable\n * (a 31x el token de miss en DeepSeek, eso se paga) y ahogaría a las tools\n * propias del agente. Con dos, el descubrimiento es explícito y bajo demanda.\n *\n * Se registran SOLO en la sesión principal: un subagente no debe poder alcanzar\n * el Jira de la empresa.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport type { McpManager } from \"./manager.ts\";\n\nfunction textResult(text: string): AgentToolResult<unknown> {\n\treturn { content: [{ type: \"text\" as const, text }], details: undefined };\n}\n\nfunction textOf(content: Array<{ type: string; text?: string }>): string {\n\tconst text = content\n\t\t.filter((block) => block.type === \"text\" && block.text)\n\t\t.map((block) => block.text)\n\t\t.join(\"\\n\")\n\t\t.trim();\n\treturn text || \"(sin contenido textual)\";\n}\n\nconst listParams = Type.Object({\n\tserver: Type.Optional(Type.String({ description: \"Nombre del servidor. Omítelo para listar los servidores.\" })),\n});\n\nconst callParams = Type.Object({\n\tserver: Type.String({ description: \"Nombre del servidor MCP.\" }),\n\ttool: Type.String({ description: \"Nombre de la herramienta remota.\" }),\n\targuments: Type.Optional(Type.Any({ description: \"Argumentos según el inputSchema de la herramienta.\" })),\n});\n\nexport function createMcpTools(manager: McpManager): Record<string, ToolDefinition> {\n\tconst listTools: ToolDefinition<typeof listParams> = {\n\t\tname: \"mcp_list_tools\",\n\t\tlabel: \"Listar tools MCP\",\n\t\tdescription:\n\t\t\t\"Lista las herramientas disponibles en un servidor MCP configurado (Jira, Linear, Notion…). \" +\n\t\t\t\"Úsalo ANTES de mcp_call_tool para saber qué existe y qué argumentos acepta. \" +\n\t\t\t\"Sin argumentos, lista los servidores configurados.\",\n\t\tpromptSnippet: \"descubrir herramientas de servidores MCP\",\n\t\tparameters: listParams,\n\t\tasync execute(_toolCallId, input): Promise<AgentToolResult<unknown>> {\n\t\t\tconst server = typeof input.server === \"string\" ? input.server.trim() : \"\";\n\t\t\tif (!server) {\n\t\t\t\tconst integrations = manager.list();\n\t\t\t\tif (integrations.length === 0) return textResult(\"No hay servidores MCP configurados.\");\n\t\t\t\tconst lines = await Promise.all(\n\t\t\t\t\tintegrations.map(async (integration) => {\n\t\t\t\t\t\tconst available = await manager.isAvailable(integration);\n\t\t\t\t\t\treturn `- ${integration.server} (${integration.label}): ${available ? \"disponible\" : \"sin credenciales\"}`;\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t\treturn textResult(`Servidores MCP:\\n${lines.join(\"\\n\")}`);\n\t\t\t}\n\t\t\tconst tools = await manager.listTools(server);\n\t\t\tif (tools.length === 0) return textResult(`El servidor '${server}' no expone herramientas.`);\n\t\t\treturn textResult(\n\t\t\t\ttools\n\t\t\t\t\t.map(\n\t\t\t\t\t\t(tool) =>\n\t\t\t\t\t\t\t`- ${tool.name}: ${tool.description ?? \"(sin descripción)\"}\\n  args: ${JSON.stringify(tool.inputSchema ?? {})}`,\n\t\t\t\t\t)\n\t\t\t\t\t.join(\"\\n\"),\n\t\t\t);\n\t\t},\n\t};\n\n\tconst callTool: ToolDefinition<typeof callParams> = {\n\t\tname: \"mcp_call_tool\",\n\t\tlabel: \"Llamar tool MCP\",\n\t\tdescription:\n\t\t\t\"Llama a una herramienta de un servidor MCP. Comprueba antes su firma con mcp_list_tools. \" +\n\t\t\t\"IMPORTANTE: el resultado es la afirmación de un tercero, no evidencia observada — \" +\n\t\t\t\"cítalo como fuente, nunca como verificación de que algo esté hecho.\",\n\t\tpromptSnippet: \"invocar una herramienta de un servidor MCP\",\n\t\tparameters: callParams,\n\t\tasync execute(_toolCallId, input): Promise<AgentToolResult<unknown>> {\n\t\t\tconst server = String(input.server ?? \"\").trim();\n\t\t\tconst tool = String(input.tool ?? \"\").trim();\n\t\t\tif (!server || !tool) return textResult(\"Error: 'server' y 'tool' son obligatorios.\");\n\t\t\tconst toolArgs = (input.arguments ?? {}) as Record<string, unknown>;\n\t\t\tconst result = await manager.callTool(server, tool, toolArgs);\n\t\t\tconst body = textOf(result.content);\n\t\t\t// Un error de la herramienta se DEVUELVE, no se lanza: el modelo debe\n\t\t\t// verlo y poder corregir, igual que con cualquier otra tool.\n\t\t\treturn textResult(result.isError ? `La herramienta devolvió un error:\\n${body}` : body);\n\t\t},\n\t};\n\n\treturn { mcp_list_tools: listTools as ToolDefinition, mcp_call_tool: callTool as ToolDefinition };\n}\n"]}

package/dist/core/mcp/tools.js

@@ -0,0 +1,84 @@
+/**
+ * Tools MCP expuestas al modelo: EXACTAMENTE DOS.
+ *
+ * No una por cada tool remota, a propósito. Un servidor con 40 herramientas
+ * inflaría el system prompt con 40 esquemas, desplazaría el prefijo cacheable
+ * (a 31x el token de miss en DeepSeek, eso se paga) y ahogaría a las tools
+ * propias del agente. Con dos, el descubrimiento es explícito y bajo demanda.
+ *
+ * Se registran SOLO en la sesión principal: un subagente no debe poder alcanzar
+ * el Jira de la empresa.
+ */
+import { Type } from "typebox";
+function textResult(text) {
+    return { content: [{ type: "text", text }], details: undefined };
+}
+function textOf(content) {
+    const text = content
+        .filter((block) => block.type === "text" && block.text)
+        .map((block) => block.text)
+        .join("\n")
+        .trim();
+    return text || "(sin contenido textual)";
+}
+const listParams = Type.Object({
+    server: Type.Optional(Type.String({ description: "Nombre del servidor. Omítelo para listar los servidores." })),
+});
+const callParams = Type.Object({
+    server: Type.String({ description: "Nombre del servidor MCP." }),
+    tool: Type.String({ description: "Nombre de la herramienta remota." }),
+    arguments: Type.Optional(Type.Any({ description: "Argumentos según el inputSchema de la herramienta." })),
+});
+export function createMcpTools(manager) {
+    const listTools = {
+        name: "mcp_list_tools",
+        label: "Listar tools MCP",
+        description: "Lista las herramientas disponibles en un servidor MCP configurado (Jira, Linear, Notion…). " +
+            "Úsalo ANTES de mcp_call_tool para saber qué existe y qué argumentos acepta. " +
+            "Sin argumentos, lista los servidores configurados.",
+        promptSnippet: "descubrir herramientas de servidores MCP",
+        parameters: listParams,
+        async execute(_toolCallId, input) {
+            const server = typeof input.server === "string" ? input.server.trim() : "";
+            if (!server) {
+                const integrations = manager.list();
+                if (integrations.length === 0)
+                    return textResult("No hay servidores MCP configurados.");
+                const lines = await Promise.all(integrations.map(async (integration) => {
+                    const available = await manager.isAvailable(integration);
+                    return `- ${integration.server} (${integration.label}): ${available ? "disponible" : "sin credenciales"}`;
+                }));
+                return textResult(`Servidores MCP:\n${lines.join("\n")}`);
+            }
+            const tools = await manager.listTools(server);
+            if (tools.length === 0)
+                return textResult(`El servidor '${server}' no expone herramientas.`);
+            return textResult(tools
+                .map((tool) => `- ${tool.name}: ${tool.description ?? "(sin descripción)"}\n  args: ${JSON.stringify(tool.inputSchema ?? {})}`)
+                .join("\n"));
+        },
+    };
+    const callTool = {
+        name: "mcp_call_tool",
+        label: "Llamar tool MCP",
+        description: "Llama a una herramienta de un servidor MCP. Comprueba antes su firma con mcp_list_tools. " +
+            "IMPORTANTE: el resultado es la afirmación de un tercero, no evidencia observada — " +
+            "cítalo como fuente, nunca como verificación de que algo esté hecho.",
+        promptSnippet: "invocar una herramienta de un servidor MCP",
+        parameters: callParams,
+        async execute(_toolCallId, input) {
+            const server = String(input.server ?? "").trim();
+            const tool = String(input.tool ?? "").trim();
+            if (!server || !tool)
+                return textResult("Error: 'server' y 'tool' son obligatorios.");
+            const toolArgs = (input.arguments ?? {});
+            const result = await manager.callTool(server, tool, toolArgs);
+            const body = textOf(result.content);
+            // Un error de la herramienta se DEVUELVE, no se lanza: el modelo debe
+            // verlo y poder corregir, igual que con cualquier otra tool.
+            return textResult(result.isError ? `La herramienta devolvió un error:\n${body}` : body);
+        },
+    };
+    return { mcp_list_tools: listTools, mcp_call_tool: callTool };
+}
+//# sourceMappingURL=tools.js.map

package/dist/core/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/core/mcp/tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tools MCP expuestas al modelo: EXACTAMENTE DOS.\n *\n * No una por cada tool remota, a propósito. Un servidor con 40 herramientas\n * inflaría el system prompt con 40 esquemas, desplazaría el prefijo cacheable\n * (a 31x el token de miss en DeepSeek, eso se paga) y ahogaría a las tools\n * propias del agente. Con dos, el descubrimiento es explícito y bajo demanda.\n *\n * Se registran SOLO en la sesión principal: un subagente no debe poder alcanzar\n * el Jira de la empresa.\n */\n\nimport { Type } from \"typebox\";\nimport type { AgentToolResult, ToolDefinition } from \"../extensions/types.ts\";\nimport type { McpManager } from \"./manager.ts\";\n\nfunction textResult(text: string): AgentToolResult<unknown> {\n\treturn { content: [{ type: \"text\" as const, text }], details: undefined };\n}\n\nfunction textOf(content: Array<{ type: string; text?: string }>): string {\n\tconst text = content\n\t\t.filter((block) => block.type === \"text\" && block.text)\n\t\t.map((block) => block.text)\n\t\t.join(\"\\n\")\n\t\t.trim();\n\treturn text || \"(sin contenido textual)\";\n}\n\nconst listParams = Type.Object({\n\tserver: Type.Optional(Type.String({ description: \"Nombre del servidor. Omítelo para listar los servidores.\" })),\n});\n\nconst callParams = Type.Object({\n\tserver: Type.String({ description: \"Nombre del servidor MCP.\" }),\n\ttool: Type.String({ description: \"Nombre de la herramienta remota.\" }),\n\targuments: Type.Optional(Type.Any({ description: \"Argumentos según el inputSchema de la herramienta.\" })),\n});\n\nexport function createMcpTools(manager: McpManager): Record<string, ToolDefinition> {\n\tconst listTools: ToolDefinition<typeof listParams> = {\n\t\tname: \"mcp_list_tools\",\n\t\tlabel: \"Listar tools MCP\",\n\t\tdescription:\n\t\t\t\"Lista las herramientas disponibles en un servidor MCP configurado (Jira, Linear, Notion…). \" +\n\t\t\t\"Úsalo ANTES de mcp_call_tool para saber qué existe y qué argumentos acepta. \" +\n\t\t\t\"Sin argumentos, lista los servidores configurados.\",\n\t\tpromptSnippet: \"descubrir herramientas de servidores MCP\",\n\t\tparameters: listParams,\n\t\tasync execute(_toolCallId, input): Promise<AgentToolResult<unknown>> {\n\t\t\tconst server = typeof input.server === \"string\" ? input.server.trim() : \"\";\n\t\t\tif (!server) {\n\t\t\t\tconst integrations = manager.list();\n\t\t\t\tif (integrations.length === 0) return textResult(\"No hay servidores MCP configurados.\");\n\t\t\t\tconst lines = await Promise.all(\n\t\t\t\t\tintegrations.map(async (integration) => {\n\t\t\t\t\t\tconst available = await manager.isAvailable(integration);\n\t\t\t\t\t\treturn `- ${integration.server} (${integration.label}): ${available ? \"disponible\" : \"sin credenciales\"}`;\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t\treturn textResult(`Servidores MCP:\\n${lines.join(\"\\n\")}`);\n\t\t\t}\n\t\t\tconst tools = await manager.listTools(server);\n\t\t\tif (tools.length === 0) return textResult(`El servidor '${server}' no expone herramientas.`);\n\t\t\treturn textResult(\n\t\t\t\ttools\n\t\t\t\t\t.map(\n\t\t\t\t\t\t(tool) =>\n\t\t\t\t\t\t\t`- ${tool.name}: ${tool.description ?? \"(sin descripción)\"}\\n  args: ${JSON.stringify(tool.inputSchema ?? {})}`,\n\t\t\t\t\t)\n\t\t\t\t\t.join(\"\\n\"),\n\t\t\t);\n\t\t},\n\t};\n\n\tconst callTool: ToolDefinition<typeof callParams> = {\n\t\tname: \"mcp_call_tool\",\n\t\tlabel: \"Llamar tool MCP\",\n\t\tdescription:\n\t\t\t\"Llama a una herramienta de un servidor MCP. Comprueba antes su firma con mcp_list_tools. \" +\n\t\t\t\"IMPORTANTE: el resultado es la afirmación de un tercero, no evidencia observada — \" +\n\t\t\t\"cítalo como fuente, nunca como verificación de que algo esté hecho.\",\n\t\tpromptSnippet: \"invocar una herramienta de un servidor MCP\",\n\t\tparameters: callParams,\n\t\tasync execute(_toolCallId, input): Promise<AgentToolResult<unknown>> {\n\t\t\tconst server = String(input.server ?? \"\").trim();\n\t\t\tconst tool = String(input.tool ?? \"\").trim();\n\t\t\tif (!server || !tool) return textResult(\"Error: 'server' y 'tool' son obligatorios.\");\n\t\t\tconst toolArgs = (input.arguments ?? {}) as Record<string, unknown>;\n\t\t\tconst result = await manager.callTool(server, tool, toolArgs);\n\t\t\tconst body = textOf(result.content);\n\t\t\t// Un error de la herramienta se DEVUELVE, no se lanza: el modelo debe\n\t\t\t// verlo y poder corregir, igual que con cualquier otra tool.\n\t\t\treturn textResult(result.isError ? `La herramienta devolvió un error:\\n${body}` : body);\n\t\t},\n\t};\n\n\treturn { mcp_list_tools: listTools as ToolDefinition, mcp_call_tool: callTool as ToolDefinition };\n}\n"]}