@akon-labs/nexus-cli 0.1.0

package/dist/extensions/mcp/client.js

@@ -0,0 +1,275 @@
+import { spawn } from "node:child_process";
+/**
+ * Minimal MCP client covering the subset needed to borrow another server's
+ * tools: initialize, notifications/initialized, tools/list, tools/call.
+ *
+ * Two transports, because real servers split roughly evenly between them:
+ * stdio for anything you launch locally (filesystem, github, postgres) and
+ * Streamable HTTP for anything hosted. Both speak the same JSON-RPC, so only
+ * the framing differs.
+ *
+ * The gitnexus client is deliberately left alone: it is pinned to one server,
+ * carries hub-specific auth headers, and its error messages name the hub.
+ */
+export const MCP_PROTOCOL_VERSION = "2025-06-18";
+const REQUEST_TIMEOUT_MS = 60_000;
+export class McpClientError extends Error {
+    kind;
+    constructor(message, kind) {
+        super(message);
+        this.name = "McpClientError";
+        this.kind = kind;
+    }
+}
+// ---------------------------------------------------------------- HTTP
+export class HttpTransport {
+    sessionId;
+    url;
+    headers;
+    constructor(url, headers = {}) {
+        this.url = url;
+        this.headers = headers;
+    }
+    async send(body, signal) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        const onAbort = () => controller.abort();
+        signal?.addEventListener("abort", onAbort, { once: true });
+        try {
+            let response;
+            try {
+                response = await fetch(this.url, {
+                    method: "POST",
+                    headers: {
+                        "content-type": "application/json",
+                        accept: "application/json, text/event-stream",
+                        ...this.headers,
+                        ...(this.sessionId ? { "mcp-session-id": this.sessionId } : {}),
+                    },
+                    body: JSON.stringify(body),
+                    signal: controller.signal,
+                });
+            }
+            catch (error) {
+                throw new McpClientError(`cannot reach MCP server ${this.url}: ${error instanceof Error ? error.message : String(error)}`, "network");
+            }
+            const newSession = response.headers.get("mcp-session-id");
+            if (newSession)
+                this.sessionId = newSession;
+            // An unconsumed body pins its socket, and under a connection-capped
+            // dispatcher that deadlocks every later call to the same server.
+            if (response.status === 202) {
+                await response.body?.cancel().catch(() => { });
+                return undefined;
+            }
+            if (!response.ok) {
+                await response.body?.cancel().catch(() => { });
+                throw new McpClientError(`MCP server ${this.url} returned HTTP ${response.status}`, "protocol");
+            }
+            const text = await response.text();
+            if (!text)
+                return undefined;
+            if ((response.headers.get("content-type") ?? "").includes("text/event-stream")) {
+                return parseSse(text);
+            }
+            return JSON.parse(text);
+        }
+        finally {
+            clearTimeout(timeout);
+            signal?.removeEventListener("abort", onAbort);
+        }
+    }
+    close() {
+        // Nothing to tear down: each call is its own request.
+    }
+}
+/** Pull the last id-bearing JSON-RPC message out of an SSE body. */
+export function parseSse(sse) {
+    let last;
+    for (const rawEvent of sse.split("\n\n")) {
+        const data = rawEvent
+            .split("\n")
+            .filter((line) => line.startsWith("data:"))
+            .map((line) => line.slice(5).trim())
+            .join("\n");
+        if (!data)
+            continue;
+        try {
+            const parsed = JSON.parse(data);
+            // Responses carry an id; server-initiated notifications do not.
+            if (parsed.id !== undefined && parsed.id !== null)
+                last = parsed;
+        }
+        catch {
+            // Ignore non-JSON keepalives.
+        }
+    }
+    return last;
+}
+// ---------------------------------------------------------------- stdio
+export class StdioTransport {
+    child;
+    buffer = "";
+    pending = new Map();
+    startError;
+    command;
+    args;
+    env;
+    cwd;
+    constructor(command, args = [], env = {}, cwd) {
+        this.command = command;
+        this.args = args;
+        this.env = env;
+        this.cwd = cwd;
+    }
+    ensureStarted() {
+        if (this.startError)
+            throw new McpClientError(this.startError, "spawn");
+        if (this.child)
+            return this.child;
+        let child;
+        try {
+            child = spawn(this.command, this.args, {
+                stdio: ["pipe", "pipe", "pipe"],
+                env: { ...process.env, ...this.env },
+                cwd: this.cwd,
+            });
+        }
+        catch (error) {
+            this.startError = `cannot start MCP server "${this.command}": ${error instanceof Error ? error.message : String(error)}`;
+            throw new McpClientError(this.startError, "spawn");
+        }
+        child.on("error", (error) => {
+            // ENOENT surfaces here, not from spawn(), so record it for the next call.
+            this.startError = `cannot start MCP server "${this.command}": ${error.message}`;
+            for (const resolve of this.pending.values())
+                resolve({ error: { message: this.startError } });
+            this.pending.clear();
+        });
+        child.stdout.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => this.consume(chunk));
+        // stderr is the server's log stream, not protocol. Draining it keeps a
+        // chatty server from filling its pipe buffer and hanging.
+        child.stderr.resume();
+        this.child = child;
+        return child;
+    }
+    /** Messages are newline-delimited JSON, so split on newlines and keep the tail. */
+    consume(chunk) {
+        this.buffer += chunk;
+        let newline = this.buffer.indexOf("\n");
+        while (newline >= 0) {
+            const line = this.buffer.slice(0, newline).trim();
+            this.buffer = this.buffer.slice(newline + 1);
+            newline = this.buffer.indexOf("\n");
+            if (!line)
+                continue;
+            try {
+                const message = JSON.parse(line);
+                if (message.id === undefined || message.id === null)
+                    continue;
+                const resolve = this.pending.get(message.id);
+                if (resolve) {
+                    this.pending.delete(message.id);
+                    resolve(message);
+                }
+            }
+            catch {
+                // A server that prints non-JSON to stdout is not fatal; skip the line.
+            }
+        }
+    }
+    async send(body, signal) {
+        const child = this.ensureStarted();
+        const id = body.id;
+        child.stdin.write(`${JSON.stringify(body)}\n`);
+        // Notifications carry no id and get no reply — waiting would always time out.
+        if (id === undefined || id === null)
+            return undefined;
+        return await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new McpClientError(`MCP server "${this.command}" timed out`, "timeout"));
+            }, REQUEST_TIMEOUT_MS);
+            const onAbort = () => {
+                this.pending.delete(id);
+                clearTimeout(timer);
+                reject(new McpClientError(`MCP call to "${this.command}" aborted`, "timeout"));
+            };
+            signal?.addEventListener("abort", onAbort, { once: true });
+            this.pending.set(id, (response) => {
+                clearTimeout(timer);
+                signal?.removeEventListener("abort", onAbort);
+                resolve(response);
+            });
+        });
+    }
+    close() {
+        this.child?.kill();
+        this.child = undefined;
+        this.pending.clear();
+    }
+}
+// ---------------------------------------------------------------- client
+export class McpClient {
+    nextId = 1;
+    initializing;
+    serverName;
+    transport;
+    constructor(serverName, transport) {
+        this.serverName = serverName;
+        this.transport = transport;
+    }
+    ensureInitialized(signal) {
+        this.initializing ??= this.initialize(signal).catch((error) => {
+            // Clear the memo so a later call can retry rather than replaying the failure.
+            this.initializing = undefined;
+            throw error;
+        });
+        return this.initializing;
+    }
+    async initialize(signal) {
+        await this.request("initialize", {
+            protocolVersion: MCP_PROTOCOL_VERSION,
+            capabilities: {},
+            clientInfo: { name: "nexus-cli", version: "0.1.0" },
+        }, signal);
+        await this.transport.send({ jsonrpc: "2.0", method: "notifications/initialized" });
+    }
+    /** Tools this server offers. Paginates until the server stops sending a cursor. */
+    async listTools(signal) {
+        await this.ensureInitialized(signal);
+        const tools = [];
+        let cursor;
+        do {
+            const result = (await this.request("tools/list", cursor ? { cursor } : {}, signal));
+            for (const tool of result?.tools ?? []) {
+                if (tool?.name)
+                    tools.push(tool);
+            }
+            const next = result?.nextCursor;
+            // A server that echoes the same cursor would loop forever.
+            cursor = next && next !== cursor ? next : undefined;
+        } while (cursor);
+        return tools;
+    }
+    async callTool(name, args, signal) {
+        await this.ensureInitialized(signal);
+        const result = await this.request("tools/call", { name, arguments: args }, signal);
+        return (result ?? {});
+    }
+    async request(method, params, signal) {
+        const id = this.nextId++;
+        const response = await this.transport.send({ jsonrpc: "2.0", id, method, params }, signal);
+        if (!response)
+            throw new McpClientError(`empty response for ${method}`, "protocol");
+        if (response.error) {
+            throw new McpClientError(`${this.serverName} ${method} failed: ${response.error.message}`, "protocol");
+        }
+        return response.result;
+    }
+    close() {
+        this.transport.close();
+    }
+}
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/extensions/mcp/client.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChildProcessWithoutNullStreams } from \"node:child_process\";\nimport { spawn } from \"node:child_process\";\n\n/**\n * Minimal MCP client covering the subset needed to borrow another server's\n * tools: initialize, notifications/initialized, tools/list, tools/call.\n *\n * Two transports, because real servers split roughly evenly between them:\n * stdio for anything you launch locally (filesystem, github, postgres) and\n * Streamable HTTP for anything hosted. Both speak the same JSON-RPC, so only\n * the framing differs.\n *\n * The gitnexus client is deliberately left alone: it is pinned to one server,\n * carries hub-specific auth headers, and its error messages name the hub.\n */\n\nexport const MCP_PROTOCOL_VERSION = \"2025-06-18\";\nconst REQUEST_TIMEOUT_MS = 60_000;\n\nexport interface McpToolSchema {\n\tname: string;\n\tdescription?: string;\n\tinputSchema?: Record<string, unknown>;\n}\n\nexport interface McpToolResult {\n\tcontent?: Array<{ type: string; text?: string; data?: string; mimeType?: string }>;\n\tisError?: boolean;\n}\n\ninterface JsonRpcResponse {\n\tid?: number | string | null;\n\tresult?: unknown;\n\terror?: { code?: number; message?: string };\n}\n\nexport class McpClientError extends Error {\n\treadonly kind: \"spawn\" | \"network\" | \"protocol\" | \"timeout\";\n\n\tconstructor(message: string, kind: McpClientError[\"kind\"]) {\n\t\tsuper(message);\n\t\tthis.name = \"McpClientError\";\n\t\tthis.kind = kind;\n\t}\n}\n\n/** A transport carries one JSON-RPC message and returns the matching response. */\nexport interface McpTransport {\n\tsend(body: unknown, signal?: AbortSignal): Promise<JsonRpcResponse | undefined>;\n\tclose(): void;\n}\n\n// ---------------------------------------------------------------- HTTP\n\nexport class HttpTransport implements McpTransport {\n\tprivate sessionId: string | undefined;\n\tprivate readonly url: string;\n\tprivate readonly headers: Record<string, string>;\n\n\tconstructor(url: string, headers: Record<string, string> = {}) {\n\t\tthis.url = url;\n\t\tthis.headers = headers;\n\t}\n\n\tasync send(body: unknown, signal?: AbortSignal): Promise<JsonRpcResponse | undefined> {\n\t\tconst controller = new AbortController();\n\t\tconst timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);\n\t\tconst onAbort = () => controller.abort();\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\ttry {\n\t\t\tlet response: Response;\n\t\t\ttry {\n\t\t\t\tresponse = await fetch(this.url, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\theaders: {\n\t\t\t\t\t\t\"content-type\": \"application/json\",\n\t\t\t\t\t\taccept: \"application/json, text/event-stream\",\n\t\t\t\t\t\t...this.headers,\n\t\t\t\t\t\t...(this.sessionId ? { \"mcp-session-id\": this.sessionId } : {}),\n\t\t\t\t\t},\n\t\t\t\t\tbody: JSON.stringify(body),\n\t\t\t\t\tsignal: controller.signal,\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tthrow new McpClientError(\n\t\t\t\t\t`cannot reach MCP server ${this.url}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t\"network\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst newSession = response.headers.get(\"mcp-session-id\");\n\t\t\tif (newSession) this.sessionId = newSession;\n\n\t\t\t// An unconsumed body pins its socket, and under a connection-capped\n\t\t\t// dispatcher that deadlocks every later call to the same server.\n\t\t\tif (response.status === 202) {\n\t\t\t\tawait response.body?.cancel().catch(() => {});\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\tif (!response.ok) {\n\t\t\t\tawait response.body?.cancel().catch(() => {});\n\t\t\t\tthrow new McpClientError(`MCP server ${this.url} returned HTTP ${response.status}`, \"protocol\");\n\t\t\t}\n\n\t\t\tconst text = await response.text();\n\t\t\tif (!text) return undefined;\n\t\t\tif ((response.headers.get(\"content-type\") ?? \"\").includes(\"text/event-stream\")) {\n\t\t\t\treturn parseSse(text);\n\t\t\t}\n\t\t\treturn JSON.parse(text) as JsonRpcResponse;\n\t\t} finally {\n\t\t\tclearTimeout(timeout);\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t}\n\t}\n\n\tclose(): void {\n\t\t// Nothing to tear down: each call is its own request.\n\t}\n}\n\n/** Pull the last id-bearing JSON-RPC message out of an SSE body. */\nexport function parseSse(sse: string): JsonRpcResponse | undefined {\n\tlet last: JsonRpcResponse | undefined;\n\tfor (const rawEvent of sse.split(\"\\n\\n\")) {\n\t\tconst data = rawEvent\n\t\t\t.split(\"\\n\")\n\t\t\t.filter((line) => line.startsWith(\"data:\"))\n\t\t\t.map((line) => line.slice(5).trim())\n\t\t\t.join(\"\\n\");\n\t\tif (!data) continue;\n\t\ttry {\n\t\t\tconst parsed = JSON.parse(data) as JsonRpcResponse;\n\t\t\t// Responses carry an id; server-initiated notifications do not.\n\t\t\tif (parsed.id !== undefined && parsed.id !== null) last = parsed;\n\t\t} catch {\n\t\t\t// Ignore non-JSON keepalives.\n\t\t}\n\t}\n\treturn last;\n}\n\n// ---------------------------------------------------------------- stdio\n\nexport class StdioTransport implements McpTransport {\n\tprivate child: ChildProcessWithoutNullStreams | undefined;\n\tprivate buffer = \"\";\n\tprivate readonly pending = new Map<number | string, (response: JsonRpcResponse) => void>();\n\tprivate startError: string | undefined;\n\n\tprivate readonly command: string;\n\tprivate readonly args: string[];\n\tprivate readonly env: Record<string, string>;\n\tprivate readonly cwd: string | undefined;\n\n\tconstructor(command: string, args: string[] = [], env: Record<string, string> = {}, cwd?: string) {\n\t\tthis.command = command;\n\t\tthis.args = args;\n\t\tthis.env = env;\n\t\tthis.cwd = cwd;\n\t}\n\n\tprivate ensureStarted(): ChildProcessWithoutNullStreams {\n\t\tif (this.startError) throw new McpClientError(this.startError, \"spawn\");\n\t\tif (this.child) return this.child;\n\t\tlet child: ChildProcessWithoutNullStreams;\n\t\ttry {\n\t\t\tchild = spawn(this.command, this.args, {\n\t\t\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t\t\t\tenv: { ...process.env, ...this.env },\n\t\t\t\tcwd: this.cwd,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tthis.startError = `cannot start MCP server \"${this.command}\": ${\n\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t}`;\n\t\t\tthrow new McpClientError(this.startError, \"spawn\");\n\t\t}\n\t\tchild.on(\"error\", (error) => {\n\t\t\t// ENOENT surfaces here, not from spawn(), so record it for the next call.\n\t\t\tthis.startError = `cannot start MCP server \"${this.command}\": ${error.message}`;\n\t\t\tfor (const resolve of this.pending.values()) resolve({ error: { message: this.startError } });\n\t\t\tthis.pending.clear();\n\t\t});\n\t\tchild.stdout.setEncoding(\"utf8\");\n\t\tchild.stdout.on(\"data\", (chunk: string) => this.consume(chunk));\n\t\t// stderr is the server's log stream, not protocol. Draining it keeps a\n\t\t// chatty server from filling its pipe buffer and hanging.\n\t\tchild.stderr.resume();\n\t\tthis.child = child;\n\t\treturn child;\n\t}\n\n\t/** Messages are newline-delimited JSON, so split on newlines and keep the tail. */\n\tprivate consume(chunk: string): void {\n\t\tthis.buffer += chunk;\n\t\tlet newline = this.buffer.indexOf(\"\\n\");\n\t\twhile (newline >= 0) {\n\t\t\tconst line = this.buffer.slice(0, newline).trim();\n\t\t\tthis.buffer = this.buffer.slice(newline + 1);\n\t\t\tnewline = this.buffer.indexOf(\"\\n\");\n\t\t\tif (!line) continue;\n\t\t\ttry {\n\t\t\t\tconst message = JSON.parse(line) as JsonRpcResponse;\n\t\t\t\tif (message.id === undefined || message.id === null) continue;\n\t\t\t\tconst resolve = this.pending.get(message.id);\n\t\t\t\tif (resolve) {\n\t\t\t\t\tthis.pending.delete(message.id);\n\t\t\t\t\tresolve(message);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// A server that prints non-JSON to stdout is not fatal; skip the line.\n\t\t\t}\n\t\t}\n\t}\n\n\tasync send(body: unknown, signal?: AbortSignal): Promise<JsonRpcResponse | undefined> {\n\t\tconst child = this.ensureStarted();\n\t\tconst id = (body as { id?: number | string }).id;\n\t\tchild.stdin.write(`${JSON.stringify(body)}\\n`);\n\t\t// Notifications carry no id and get no reply — waiting would always time out.\n\t\tif (id === undefined || id === null) return undefined;\n\n\t\treturn await new Promise<JsonRpcResponse>((resolve, reject) => {\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tthis.pending.delete(id);\n\t\t\t\treject(new McpClientError(`MCP server \"${this.command}\" timed out`, \"timeout\"));\n\t\t\t}, REQUEST_TIMEOUT_MS);\n\t\t\tconst onAbort = () => {\n\t\t\t\tthis.pending.delete(id);\n\t\t\t\tclearTimeout(timer);\n\t\t\t\treject(new McpClientError(`MCP call to \"${this.command}\" aborted`, \"timeout\"));\n\t\t\t};\n\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\tthis.pending.set(id, (response) => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tresolve(response);\n\t\t\t});\n\t\t});\n\t}\n\n\tclose(): void {\n\t\tthis.child?.kill();\n\t\tthis.child = undefined;\n\t\tthis.pending.clear();\n\t}\n}\n\n// ---------------------------------------------------------------- client\n\nexport class McpClient {\n\tprivate nextId = 1;\n\tprivate initializing: Promise<void> | undefined;\n\n\treadonly serverName: string;\n\tprivate readonly transport: McpTransport;\n\n\tconstructor(serverName: string, transport: McpTransport) {\n\t\tthis.serverName = serverName;\n\t\tthis.transport = transport;\n\t}\n\n\tprivate ensureInitialized(signal?: AbortSignal): Promise<void> {\n\t\tthis.initializing ??= this.initialize(signal).catch((error) => {\n\t\t\t// Clear the memo so a later call can retry rather than replaying the failure.\n\t\t\tthis.initializing = undefined;\n\t\t\tthrow error;\n\t\t});\n\t\treturn this.initializing;\n\t}\n\n\tprivate async initialize(signal?: AbortSignal): Promise<void> {\n\t\tawait this.request(\n\t\t\t\"initialize\",\n\t\t\t{\n\t\t\t\tprotocolVersion: MCP_PROTOCOL_VERSION,\n\t\t\t\tcapabilities: {},\n\t\t\t\tclientInfo: { name: \"nexus-cli\", version: \"0.1.0\" },\n\t\t\t},\n\t\t\tsignal,\n\t\t);\n\t\tawait this.transport.send({ jsonrpc: \"2.0\", method: \"notifications/initialized\" });\n\t}\n\n\t/** Tools this server offers. Paginates until the server stops sending a cursor. */\n\tasync listTools(signal?: AbortSignal): Promise<McpToolSchema[]> {\n\t\tawait this.ensureInitialized(signal);\n\t\tconst tools: McpToolSchema[] = [];\n\t\tlet cursor: string | undefined;\n\t\tdo {\n\t\t\tconst result = (await this.request(\"tools/list\", cursor ? { cursor } : {}, signal)) as\n\t\t\t\t| { tools?: McpToolSchema[]; nextCursor?: string }\n\t\t\t\t| undefined;\n\t\t\tfor (const tool of result?.tools ?? []) {\n\t\t\t\tif (tool?.name) tools.push(tool);\n\t\t\t}\n\t\t\tconst next = result?.nextCursor;\n\t\t\t// A server that echoes the same cursor would loop forever.\n\t\t\tcursor = next && next !== cursor ? next : undefined;\n\t\t} while (cursor);\n\t\treturn tools;\n\t}\n\n\tasync callTool(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<McpToolResult> {\n\t\tawait this.ensureInitialized(signal);\n\t\tconst result = await this.request(\"tools/call\", { name, arguments: args }, signal);\n\t\treturn (result ?? {}) as McpToolResult;\n\t}\n\n\tprivate async request(method: string, params: unknown, signal?: AbortSignal): Promise<unknown> {\n\t\tconst id = this.nextId++;\n\t\tconst response = await this.transport.send({ jsonrpc: \"2.0\", id, method, params }, signal);\n\t\tif (!response) throw new McpClientError(`empty response for ${method}`, \"protocol\");\n\t\tif (response.error) {\n\t\t\tthrow new McpClientError(`${this.serverName} ${method} failed: ${response.error.message}`, \"protocol\");\n\t\t}\n\t\treturn response.result;\n\t}\n\n\tclose(): void {\n\t\tthis.transport.close();\n\t}\n}\n"]}

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

@@ -0,0 +1,41 @@
+/**
+ * MCP server configuration.
+ *
+ * The file format is Claude Code's `mcpServers` map, deliberately: users
+ * already have these configs, and copying one over should just work. A server
+ * is stdio when it has `command` and HTTP when it has `url`.
+ *
+ * Project config wins over user config for the same server name, so a repo can
+ * pin a server its contributors need without editing anyone's home directory.
+ */
+export interface McpStdioServer {
+    type: "stdio";
+    name: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    cwd?: string;
+    enabled: boolean;
+}
+export interface McpHttpServer {
+    type: "http";
+    name: string;
+    url: string;
+    headers: Record<string, string>;
+    enabled: boolean;
+}
+export type McpServerConfig = McpStdioServer | McpHttpServer;
+export interface McpConfigResult {
+    servers: McpServerConfig[];
+    /** Human-readable problems; surfaced rather than thrown, so one bad entry cannot block startup. */
+    diagnostics: string[];
+}
+/** Parse one `mcpServers` entry. Returns a diagnostic string when unusable. */
+export declare function parseServerEntry(name: string, raw: unknown): McpServerConfig | string;
+/** Parse a whole config document. */
+export declare function parseMcpConfig(text: string, source: string): McpConfigResult;
+/** Config paths, lowest precedence first: user config, then this project's. */
+export declare function mcpConfigPaths(cwd: string, home?: string): string[];
+/** Load and merge user then project config. Later files win on name collisions. */
+export declare function loadMcpConfig(cwd: string, readFile?: (path: string) => string, home?: string): McpConfigResult;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/config.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,aAAa,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,mGAAmG;IACnG,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB;AAWD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,MAAM,CAyBrF;AAED,qCAAqC;AACrC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAkB5E;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,EAAE,CAE9E;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAA6C,EACzE,IAAI,CAAC,EAAE,MAAM,GACX,eAAe,CAejB","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { CONFIG_DIR_NAME } from \"../../config.ts\";\n\n/**\n * MCP server configuration.\n *\n * The file format is Claude Code's `mcpServers` map, deliberately: users\n * already have these configs, and copying one over should just work. A server\n * is stdio when it has `command` and HTTP when it has `url`.\n *\n * Project config wins over user config for the same server name, so a repo can\n * pin a server its contributors need without editing anyone's home directory.\n */\n\nexport interface McpStdioServer {\n\ttype: \"stdio\";\n\tname: string;\n\tcommand: string;\n\targs: string[];\n\tenv: Record<string, string>;\n\tcwd?: string;\n\tenabled: boolean;\n}\n\nexport interface McpHttpServer {\n\ttype: \"http\";\n\tname: string;\n\turl: string;\n\theaders: Record<string, string>;\n\tenabled: boolean;\n}\n\nexport type McpServerConfig = McpStdioServer | McpHttpServer;\n\nexport interface McpConfigResult {\n\tservers: McpServerConfig[];\n\t/** Human-readable problems; surfaced rather than thrown, so one bad entry cannot block startup. */\n\tdiagnostics: string[];\n}\n\nfunction stringRecord(value: unknown): Record<string, string> {\n\tif (!value || typeof value !== \"object\") return {};\n\tconst out: Record<string, string> = {};\n\tfor (const [key, item] of Object.entries(value as Record<string, unknown>)) {\n\t\tif (typeof item === \"string\") out[key] = item;\n\t}\n\treturn out;\n}\n\n/** Parse one `mcpServers` entry. Returns a diagnostic string when unusable. */\nexport function parseServerEntry(name: string, raw: unknown): McpServerConfig | string {\n\tif (!raw || typeof raw !== \"object\") return `MCP server \"${name}\": entry is not an object`;\n\tconst entry = raw as Record<string, unknown>;\n\t// `disabled` is the Claude Code spelling; accept `enabled` too so either reads naturally.\n\tconst enabled = entry.disabled === true ? false : entry.enabled !== false;\n\n\tif (typeof entry.command === \"string\" && entry.command.trim()) {\n\t\treturn {\n\t\t\ttype: \"stdio\",\n\t\t\tname,\n\t\t\tcommand: entry.command.trim(),\n\t\t\targs: Array.isArray(entry.args) ? entry.args.filter((a): a is string => typeof a === \"string\") : [],\n\t\t\tenv: stringRecord(entry.env),\n\t\t\tcwd: typeof entry.cwd === \"string\" ? entry.cwd : undefined,\n\t\t\tenabled,\n\t\t};\n\t}\n\n\tconst url =\n\t\ttypeof entry.url === \"string\" ? entry.url : typeof entry.httpUrl === \"string\" ? entry.httpUrl : undefined;\n\tif (url?.trim()) {\n\t\treturn { type: \"http\", name, url: url.trim(), headers: stringRecord(entry.headers), enabled };\n\t}\n\n\treturn `MCP server \"${name}\": needs either \"command\" (stdio) or \"url\" (http)`;\n}\n\n/** Parse a whole config document. */\nexport function parseMcpConfig(text: string, source: string): McpConfigResult {\n\tconst diagnostics: string[] = [];\n\tlet document: unknown;\n\ttry {\n\t\tdocument = JSON.parse(text);\n\t} catch (error) {\n\t\treturn { servers: [], diagnostics: [`${source}: ${error instanceof Error ? error.message : String(error)}`] };\n\t}\n\tconst map = (document as { mcpServers?: unknown } | null)?.mcpServers;\n\tif (!map || typeof map !== \"object\") return { servers: [], diagnostics };\n\n\tconst servers: McpServerConfig[] = [];\n\tfor (const [name, raw] of Object.entries(map as Record<string, unknown>)) {\n\t\tconst parsed = parseServerEntry(name, raw);\n\t\tif (typeof parsed === \"string\") diagnostics.push(`${source}: ${parsed}`);\n\t\telse servers.push(parsed);\n\t}\n\treturn { servers, diagnostics };\n}\n\n/** Config paths, lowest precedence first: user config, then this project's. */\nexport function mcpConfigPaths(cwd: string, home: string = homedir()): string[] {\n\treturn [join(home, \".config\", \"nexus\", \"mcp.json\"), join(cwd, CONFIG_DIR_NAME, \"mcp.json\")];\n}\n\n/** Load and merge user then project config. Later files win on name collisions. */\nexport function loadMcpConfig(\n\tcwd: string,\n\treadFile: (path: string) => string = (path) => readFileSync(path, \"utf8\"),\n\thome?: string,\n): McpConfigResult {\n\tconst byName = new Map<string, McpServerConfig>();\n\tconst diagnostics: string[] = [];\n\tfor (const path of mcpConfigPaths(cwd, home)) {\n\t\tlet text: string;\n\t\ttry {\n\t\t\ttext = readFile(path);\n\t\t} catch {\n\t\t\tcontinue; // Absent config is the normal case, not an error.\n\t\t}\n\t\tconst parsed = parseMcpConfig(text, path);\n\t\tdiagnostics.push(...parsed.diagnostics);\n\t\tfor (const server of parsed.servers) byName.set(server.name, server);\n\t}\n\treturn { servers: [...byName.values()], diagnostics };\n}\n"]}

package/dist/extensions/mcp/config.js

@@ -0,0 +1,85 @@
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { CONFIG_DIR_NAME } from "../../config.js";
+function stringRecord(value) {
+    if (!value || typeof value !== "object")
+        return {};
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+        if (typeof item === "string")
+            out[key] = item;
+    }
+    return out;
+}
+/** Parse one `mcpServers` entry. Returns a diagnostic string when unusable. */
+export function parseServerEntry(name, raw) {
+    if (!raw || typeof raw !== "object")
+        return `MCP server "${name}": entry is not an object`;
+    const entry = raw;
+    // `disabled` is the Claude Code spelling; accept `enabled` too so either reads naturally.
+    const enabled = entry.disabled === true ? false : entry.enabled !== false;
+    if (typeof entry.command === "string" && entry.command.trim()) {
+        return {
+            type: "stdio",
+            name,
+            command: entry.command.trim(),
+            args: Array.isArray(entry.args) ? entry.args.filter((a) => typeof a === "string") : [],
+            env: stringRecord(entry.env),
+            cwd: typeof entry.cwd === "string" ? entry.cwd : undefined,
+            enabled,
+        };
+    }
+    const url = typeof entry.url === "string" ? entry.url : typeof entry.httpUrl === "string" ? entry.httpUrl : undefined;
+    if (url?.trim()) {
+        return { type: "http", name, url: url.trim(), headers: stringRecord(entry.headers), enabled };
+    }
+    return `MCP server "${name}": needs either "command" (stdio) or "url" (http)`;
+}
+/** Parse a whole config document. */
+export function parseMcpConfig(text, source) {
+    const diagnostics = [];
+    let document;
+    try {
+        document = JSON.parse(text);
+    }
+    catch (error) {
+        return { servers: [], diagnostics: [`${source}: ${error instanceof Error ? error.message : String(error)}`] };
+    }
+    const map = document?.mcpServers;
+    if (!map || typeof map !== "object")
+        return { servers: [], diagnostics };
+    const servers = [];
+    for (const [name, raw] of Object.entries(map)) {
+        const parsed = parseServerEntry(name, raw);
+        if (typeof parsed === "string")
+            diagnostics.push(`${source}: ${parsed}`);
+        else
+            servers.push(parsed);
+    }
+    return { servers, diagnostics };
+}
+/** Config paths, lowest precedence first: user config, then this project's. */
+export function mcpConfigPaths(cwd, home = homedir()) {
+    return [join(home, ".config", "nexus", "mcp.json"), join(cwd, CONFIG_DIR_NAME, "mcp.json")];
+}
+/** Load and merge user then project config. Later files win on name collisions. */
+export function loadMcpConfig(cwd, readFile = (path) => readFileSync(path, "utf8"), home) {
+    const byName = new Map();
+    const diagnostics = [];
+    for (const path of mcpConfigPaths(cwd, home)) {
+        let text;
+        try {
+            text = readFile(path);
+        }
+        catch {
+            continue; // Absent config is the normal case, not an error.
+        }
+        const parsed = parseMcpConfig(text, path);
+        diagnostics.push(...parsed.diagnostics);
+        for (const server of parsed.servers)
+            byName.set(server.name, server);
+    }
+    return { servers: [...byName.values()], diagnostics };
+}
+//# sourceMappingURL=config.js.map

package/dist/extensions/mcp/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/extensions/mcp/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAuClD,SAAS,YAAY,CAAC,KAAc,EAA0B;IAC7D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACnD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC5E,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC;AAAA,CACX;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,GAAY,EAA4B;IACtF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,eAAe,IAAI,2BAA2B,CAAC;IAC3F,MAAM,KAAK,GAAG,GAA8B,CAAC;IAC7C,0FAA0F;IAC1F,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC;IAE1E,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/D,OAAO;YACN,IAAI,EAAE,OAAO;YACb,IAAI;YACJ,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;YAC7B,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YACnG,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC;YAC5B,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YAC1D,OAAO;SACP,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GACR,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,IAAI,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IAC/F,CAAC;IAED,OAAO,eAAe,IAAI,mDAAmD,CAAC;AAAA,CAC9E;AAED,qCAAqC;AACrC,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAc,EAAmB;IAC7E,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACJ,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,GAAG,MAAM,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/G,CAAC;IACD,MAAM,GAAG,GAAI,QAA4C,EAAE,UAAU,CAAC;IACtE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC;IAEzE,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;QAC1E,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;;YACpE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAAA,CAChC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,IAAI,GAAW,OAAO,EAAE,EAAY;IAC/E,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC;AAAA,CAC5F;AAED,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAC5B,GAAW,EACX,QAAQ,GAA6B,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EACzE,IAAa,EACK;IAClB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9C,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACJ,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACR,SAAS,CAAC,kDAAkD;QAC7D,CAAC;QACD,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACxC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC;AAAA,CACtD","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { CONFIG_DIR_NAME } from \"../../config.ts\";\n\n/**\n * MCP server configuration.\n *\n * The file format is Claude Code's `mcpServers` map, deliberately: users\n * already have these configs, and copying one over should just work. A server\n * is stdio when it has `command` and HTTP when it has `url`.\n *\n * Project config wins over user config for the same server name, so a repo can\n * pin a server its contributors need without editing anyone's home directory.\n */\n\nexport interface McpStdioServer {\n\ttype: \"stdio\";\n\tname: string;\n\tcommand: string;\n\targs: string[];\n\tenv: Record<string, string>;\n\tcwd?: string;\n\tenabled: boolean;\n}\n\nexport interface McpHttpServer {\n\ttype: \"http\";\n\tname: string;\n\turl: string;\n\theaders: Record<string, string>;\n\tenabled: boolean;\n}\n\nexport type McpServerConfig = McpStdioServer | McpHttpServer;\n\nexport interface McpConfigResult {\n\tservers: McpServerConfig[];\n\t/** Human-readable problems; surfaced rather than thrown, so one bad entry cannot block startup. */\n\tdiagnostics: string[];\n}\n\nfunction stringRecord(value: unknown): Record<string, string> {\n\tif (!value || typeof value !== \"object\") return {};\n\tconst out: Record<string, string> = {};\n\tfor (const [key, item] of Object.entries(value as Record<string, unknown>)) {\n\t\tif (typeof item === \"string\") out[key] = item;\n\t}\n\treturn out;\n}\n\n/** Parse one `mcpServers` entry. Returns a diagnostic string when unusable. */\nexport function parseServerEntry(name: string, raw: unknown): McpServerConfig | string {\n\tif (!raw || typeof raw !== \"object\") return `MCP server \"${name}\": entry is not an object`;\n\tconst entry = raw as Record<string, unknown>;\n\t// `disabled` is the Claude Code spelling; accept `enabled` too so either reads naturally.\n\tconst enabled = entry.disabled === true ? false : entry.enabled !== false;\n\n\tif (typeof entry.command === \"string\" && entry.command.trim()) {\n\t\treturn {\n\t\t\ttype: \"stdio\",\n\t\t\tname,\n\t\t\tcommand: entry.command.trim(),\n\t\t\targs: Array.isArray(entry.args) ? entry.args.filter((a): a is string => typeof a === \"string\") : [],\n\t\t\tenv: stringRecord(entry.env),\n\t\t\tcwd: typeof entry.cwd === \"string\" ? entry.cwd : undefined,\n\t\t\tenabled,\n\t\t};\n\t}\n\n\tconst url =\n\t\ttypeof entry.url === \"string\" ? entry.url : typeof entry.httpUrl === \"string\" ? entry.httpUrl : undefined;\n\tif (url?.trim()) {\n\t\treturn { type: \"http\", name, url: url.trim(), headers: stringRecord(entry.headers), enabled };\n\t}\n\n\treturn `MCP server \"${name}\": needs either \"command\" (stdio) or \"url\" (http)`;\n}\n\n/** Parse a whole config document. */\nexport function parseMcpConfig(text: string, source: string): McpConfigResult {\n\tconst diagnostics: string[] = [];\n\tlet document: unknown;\n\ttry {\n\t\tdocument = JSON.parse(text);\n\t} catch (error) {\n\t\treturn { servers: [], diagnostics: [`${source}: ${error instanceof Error ? error.message : String(error)}`] };\n\t}\n\tconst map = (document as { mcpServers?: unknown } | null)?.mcpServers;\n\tif (!map || typeof map !== \"object\") return { servers: [], diagnostics };\n\n\tconst servers: McpServerConfig[] = [];\n\tfor (const [name, raw] of Object.entries(map as Record<string, unknown>)) {\n\t\tconst parsed = parseServerEntry(name, raw);\n\t\tif (typeof parsed === \"string\") diagnostics.push(`${source}: ${parsed}`);\n\t\telse servers.push(parsed);\n\t}\n\treturn { servers, diagnostics };\n}\n\n/** Config paths, lowest precedence first: user config, then this project's. */\nexport function mcpConfigPaths(cwd: string, home: string = homedir()): string[] {\n\treturn [join(home, \".config\", \"nexus\", \"mcp.json\"), join(cwd, CONFIG_DIR_NAME, \"mcp.json\")];\n}\n\n/** Load and merge user then project config. Later files win on name collisions. */\nexport function loadMcpConfig(\n\tcwd: string,\n\treadFile: (path: string) => string = (path) => readFileSync(path, \"utf8\"),\n\thome?: string,\n): McpConfigResult {\n\tconst byName = new Map<string, McpServerConfig>();\n\tconst diagnostics: string[] = [];\n\tfor (const path of mcpConfigPaths(cwd, home)) {\n\t\tlet text: string;\n\t\ttry {\n\t\t\ttext = readFile(path);\n\t\t} catch {\n\t\t\tcontinue; // Absent config is the normal case, not an error.\n\t\t}\n\t\tconst parsed = parseMcpConfig(text, path);\n\t\tdiagnostics.push(...parsed.diagnostics);\n\t\tfor (const server of parsed.servers) byName.set(server.name, server);\n\t}\n\treturn { servers: [...byName.values()], diagnostics };\n}\n"]}

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

@@ -0,0 +1,18 @@
+import type { ExtensionAPI, ToolDefinition } from "../../core/extensions/types.ts";
+import { McpClient, type McpToolResult, type McpToolSchema } from "./client.ts";
+/**
+ * MCP adapter: connects the servers named in mcp.json and exposes their tools
+ * to the model.
+ *
+ * Every failure here is non-fatal. A server that is missing, misconfigured, or
+ * down costs you its tools and a startup notice — it must never stop the agent
+ * from running, the same contract the gitnexus extension follows.
+ */
+/** Tool names are namespaced by server, so two servers can both export "search". */
+export declare function toolName(serverName: string, tool: string): string;
+/** Flatten an MCP result into the text the agent shows and feeds back to the model. */
+export declare function resultToText(result: McpToolResult): string;
+/** Build a nexus tool that proxies one MCP tool. */
+export declare function defineProxyTool(client: McpClient, serverName: string, schema: McpToolSchema): ToolDefinition;
+export default function mcpExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAiB,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAkB,MAAM,aAAa,CAAC;AAG/G;;;;;;;GAOG;AAEH,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAU1D;AAUD,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,cAAc,CAkB5G;AAED,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAoC3D","sourcesContent":["import { Type } from \"typebox\";\nimport type { ExtensionAPI, ToolDefinition } from \"../../core/extensions/types.ts\";\nimport { HttpTransport, McpClient, type McpToolResult, type McpToolSchema, StdioTransport } from \"./client.ts\";\nimport { loadMcpConfig, type McpServerConfig } from \"./config.ts\";\n\n/**\n * MCP adapter: connects the servers named in mcp.json and exposes their tools\n * to the model.\n *\n * Every failure here is non-fatal. A server that is missing, misconfigured, or\n * down costs you its tools and a startup notice — it must never stop the agent\n * from running, the same contract the gitnexus extension follows.\n */\n\n/** Tool names are namespaced by server, so two servers can both export \"search\". */\nexport function toolName(serverName: string, tool: string): string {\n\tconst safe = `${serverName}_${tool}`.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n\t// Keep well under provider name limits; collisions stay unlikely because the\n\t// server prefix is preserved.\n\treturn safe.length <= 64 ? safe : safe.slice(0, 64);\n}\n\n/** Flatten an MCP result into the text the agent shows and feeds back to the model. */\nexport function resultToText(result: McpToolResult): string {\n\tconst text = (result.content ?? [])\n\t\t.filter((block) => block.type === \"text\" && typeof block.text === \"string\")\n\t\t.map((block) => block.text)\n\t\t.join(\"\\n\");\n\tif (text) return text;\n\t// A server that answers with only non-text blocks should say so rather than\n\t// handing the model a blank string it will read as success-with-no-data.\n\tconst kinds = [...new Set((result.content ?? []).map((block) => block.type))];\n\treturn kinds.length > 0 ? `[no text content: ${kinds.join(\", \")}]` : \"[no content]\";\n}\n\nfunction connect(server: McpServerConfig): McpClient {\n\tconst transport =\n\t\tserver.type === \"stdio\"\n\t\t\t? new StdioTransport(server.command, server.args, server.env, server.cwd)\n\t\t\t: new HttpTransport(server.url, server.headers);\n\treturn new McpClient(server.name, transport);\n}\n\n/** Build a nexus tool that proxies one MCP tool. */\nexport function defineProxyTool(client: McpClient, serverName: string, schema: McpToolSchema): ToolDefinition {\n\treturn {\n\t\tname: toolName(serverName, schema.name),\n\t\tlabel: `${serverName}:${schema.name}`,\n\t\tdescription: schema.description ?? `${schema.name} (via ${serverName} MCP server)`,\n\t\t// Pass the server's own JSON Schema straight through. Type.Unsafe wraps it\n\t\t// without reinterpreting it, so the model sees the parameters the server\n\t\t// documented and we never reject a payload the server would have accepted.\n\t\tparameters: Type.Unsafe(schema.inputSchema ?? { type: \"object\", properties: {} }),\n\t\texecute: async (_id: string, params: unknown, signal?: AbortSignal) => {\n\t\t\tconst result = await client.callTool(schema.name, (params ?? {}) as Record<string, unknown>, signal);\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\" as const, text: resultToText(result) }],\n\t\t\t\tisError: result.isError === true,\n\t\t\t\tdetails: { server: serverName, tool: schema.name },\n\t\t\t};\n\t\t},\n\t} as unknown as ToolDefinition;\n}\n\nexport default function mcpExtension(pi: ExtensionAPI): void {\n\tconst clients: McpClient[] = [];\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tconst { servers, diagnostics } = loadMcpConfig(process.cwd());\n\t\tconst notices: string[] = [...diagnostics];\n\n\t\tconst enabled = servers.filter((server) => server.enabled);\n\t\tfor (const server of enabled) {\n\t\t\tconst client = connect(server);\n\t\t\ttry {\n\t\t\t\tconst tools = await client.listTools();\n\t\t\t\tif (tools.length === 0) {\n\t\t\t\t\tnotices.push(`MCP ${server.name}: connected but exposes no tools`);\n\t\t\t\t\tclient.close();\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tfor (const tool of tools) pi.registerTool(defineProxyTool(client, server.name, tool));\n\t\t\t\tclients.push(client);\n\t\t\t\tnotices.push(`MCP ${server.name}: ${tools.length} tool${tools.length === 1 ? \"\" : \"s\"}`);\n\t\t\t} catch (error) {\n\t\t\t\t// One unreachable server must not cost the others their tools.\n\t\t\t\tclient.close();\n\t\t\t\tnotices.push(`MCP ${server.name}: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t}\n\t\t}\n\n\t\tif (notices.length > 0) ctx.ui.notify(notices.join(\"\\n\"), \"info\");\n\t});\n\n\tpi.on(\"session_shutdown\", async () => {\n\t\t// stdio servers are child processes; leaving them running would leak one\n\t\t// per session.\n\t\tfor (const client of clients) client.close();\n\t\tclients.length = 0;\n\t});\n}\n"]}

package/dist/extensions/mcp/index.js

@@ -0,0 +1,95 @@
+import { Type } from "typebox";
+import { HttpTransport, McpClient, StdioTransport } from "./client.js";
+import { loadMcpConfig } from "./config.js";
+/**
+ * MCP adapter: connects the servers named in mcp.json and exposes their tools
+ * to the model.
+ *
+ * Every failure here is non-fatal. A server that is missing, misconfigured, or
+ * down costs you its tools and a startup notice — it must never stop the agent
+ * from running, the same contract the gitnexus extension follows.
+ */
+/** Tool names are namespaced by server, so two servers can both export "search". */
+export function toolName(serverName, tool) {
+    const safe = `${serverName}_${tool}`.replace(/[^a-zA-Z0-9_-]/g, "_");
+    // Keep well under provider name limits; collisions stay unlikely because the
+    // server prefix is preserved.
+    return safe.length <= 64 ? safe : safe.slice(0, 64);
+}
+/** Flatten an MCP result into the text the agent shows and feeds back to the model. */
+export function resultToText(result) {
+    const text = (result.content ?? [])
+        .filter((block) => block.type === "text" && typeof block.text === "string")
+        .map((block) => block.text)
+        .join("\n");
+    if (text)
+        return text;
+    // A server that answers with only non-text blocks should say so rather than
+    // handing the model a blank string it will read as success-with-no-data.
+    const kinds = [...new Set((result.content ?? []).map((block) => block.type))];
+    return kinds.length > 0 ? `[no text content: ${kinds.join(", ")}]` : "[no content]";
+}
+function connect(server) {
+    const transport = server.type === "stdio"
+        ? new StdioTransport(server.command, server.args, server.env, server.cwd)
+        : new HttpTransport(server.url, server.headers);
+    return new McpClient(server.name, transport);
+}
+/** Build a nexus tool that proxies one MCP tool. */
+export function defineProxyTool(client, serverName, schema) {
+    return {
+        name: toolName(serverName, schema.name),
+        label: `${serverName}:${schema.name}`,
+        description: schema.description ?? `${schema.name} (via ${serverName} MCP server)`,
+        // Pass the server's own JSON Schema straight through. Type.Unsafe wraps it
+        // without reinterpreting it, so the model sees the parameters the server
+        // documented and we never reject a payload the server would have accepted.
+        parameters: Type.Unsafe(schema.inputSchema ?? { type: "object", properties: {} }),
+        execute: async (_id, params, signal) => {
+            const result = await client.callTool(schema.name, (params ?? {}), signal);
+            return {
+                content: [{ type: "text", text: resultToText(result) }],
+                isError: result.isError === true,
+                details: { server: serverName, tool: schema.name },
+            };
+        },
+    };
+}
+export default function mcpExtension(pi) {
+    const clients = [];
+    pi.on("session_start", async (_event, ctx) => {
+        const { servers, diagnostics } = loadMcpConfig(process.cwd());
+        const notices = [...diagnostics];
+        const enabled = servers.filter((server) => server.enabled);
+        for (const server of enabled) {
+            const client = connect(server);
+            try {
+                const tools = await client.listTools();
+                if (tools.length === 0) {
+                    notices.push(`MCP ${server.name}: connected but exposes no tools`);
+                    client.close();
+                    continue;
+                }
+                for (const tool of tools)
+                    pi.registerTool(defineProxyTool(client, server.name, tool));
+                clients.push(client);
+                notices.push(`MCP ${server.name}: ${tools.length} tool${tools.length === 1 ? "" : "s"}`);
+            }
+            catch (error) {
+                // One unreachable server must not cost the others their tools.
+                client.close();
+                notices.push(`MCP ${server.name}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        if (notices.length > 0)
+            ctx.ui.notify(notices.join("\n"), "info");
+    });
+    pi.on("session_shutdown", async () => {
+        // stdio servers are child processes; leaving them running would leak one
+        // per session.
+        for (const client of clients)
+            client.close();
+        clients.length = 0;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/mcp/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { Type } from \"typebox\";\nimport type { ExtensionAPI, ToolDefinition } from \"../../core/extensions/types.ts\";\nimport { HttpTransport, McpClient, type McpToolResult, type McpToolSchema, StdioTransport } from \"./client.ts\";\nimport { loadMcpConfig, type McpServerConfig } from \"./config.ts\";\n\n/**\n * MCP adapter: connects the servers named in mcp.json and exposes their tools\n * to the model.\n *\n * Every failure here is non-fatal. A server that is missing, misconfigured, or\n * down costs you its tools and a startup notice — it must never stop the agent\n * from running, the same contract the gitnexus extension follows.\n */\n\n/** Tool names are namespaced by server, so two servers can both export \"search\". */\nexport function toolName(serverName: string, tool: string): string {\n\tconst safe = `${serverName}_${tool}`.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n\t// Keep well under provider name limits; collisions stay unlikely because the\n\t// server prefix is preserved.\n\treturn safe.length <= 64 ? safe : safe.slice(0, 64);\n}\n\n/** Flatten an MCP result into the text the agent shows and feeds back to the model. */\nexport function resultToText(result: McpToolResult): string {\n\tconst text = (result.content ?? [])\n\t\t.filter((block) => block.type === \"text\" && typeof block.text === \"string\")\n\t\t.map((block) => block.text)\n\t\t.join(\"\\n\");\n\tif (text) return text;\n\t// A server that answers with only non-text blocks should say so rather than\n\t// handing the model a blank string it will read as success-with-no-data.\n\tconst kinds = [...new Set((result.content ?? []).map((block) => block.type))];\n\treturn kinds.length > 0 ? `[no text content: ${kinds.join(\", \")}]` : \"[no content]\";\n}\n\nfunction connect(server: McpServerConfig): McpClient {\n\tconst transport =\n\t\tserver.type === \"stdio\"\n\t\t\t? new StdioTransport(server.command, server.args, server.env, server.cwd)\n\t\t\t: new HttpTransport(server.url, server.headers);\n\treturn new McpClient(server.name, transport);\n}\n\n/** Build a nexus tool that proxies one MCP tool. */\nexport function defineProxyTool(client: McpClient, serverName: string, schema: McpToolSchema): ToolDefinition {\n\treturn {\n\t\tname: toolName(serverName, schema.name),\n\t\tlabel: `${serverName}:${schema.name}`,\n\t\tdescription: schema.description ?? `${schema.name} (via ${serverName} MCP server)`,\n\t\t// Pass the server's own JSON Schema straight through. Type.Unsafe wraps it\n\t\t// without reinterpreting it, so the model sees the parameters the server\n\t\t// documented and we never reject a payload the server would have accepted.\n\t\tparameters: Type.Unsafe(schema.inputSchema ?? { type: \"object\", properties: {} }),\n\t\texecute: async (_id: string, params: unknown, signal?: AbortSignal) => {\n\t\t\tconst result = await client.callTool(schema.name, (params ?? {}) as Record<string, unknown>, signal);\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\" as const, text: resultToText(result) }],\n\t\t\t\tisError: result.isError === true,\n\t\t\t\tdetails: { server: serverName, tool: schema.name },\n\t\t\t};\n\t\t},\n\t} as unknown as ToolDefinition;\n}\n\nexport default function mcpExtension(pi: ExtensionAPI): void {\n\tconst clients: McpClient[] = [];\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tconst { servers, diagnostics } = loadMcpConfig(process.cwd());\n\t\tconst notices: string[] = [...diagnostics];\n\n\t\tconst enabled = servers.filter((server) => server.enabled);\n\t\tfor (const server of enabled) {\n\t\t\tconst client = connect(server);\n\t\t\ttry {\n\t\t\t\tconst tools = await client.listTools();\n\t\t\t\tif (tools.length === 0) {\n\t\t\t\t\tnotices.push(`MCP ${server.name}: connected but exposes no tools`);\n\t\t\t\t\tclient.close();\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tfor (const tool of tools) pi.registerTool(defineProxyTool(client, server.name, tool));\n\t\t\t\tclients.push(client);\n\t\t\t\tnotices.push(`MCP ${server.name}: ${tools.length} tool${tools.length === 1 ? \"\" : \"s\"}`);\n\t\t\t} catch (error) {\n\t\t\t\t// One unreachable server must not cost the others their tools.\n\t\t\t\tclient.close();\n\t\t\t\tnotices.push(`MCP ${server.name}: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t}\n\t\t}\n\n\t\tif (notices.length > 0) ctx.ui.notify(notices.join(\"\\n\"), \"info\");\n\t});\n\n\tpi.on(\"session_shutdown\", async () => {\n\t\t// stdio servers are child processes; leaving them running would leak one\n\t\t// per session.\n\t\tfor (const client of clients) client.close();\n\t\tclients.length = 0;\n\t});\n}\n"]}