atom-lite 0.1.0 → 0.5.1

package/dist/mcp/manager.js

@@ -0,0 +1,349 @@
+import { createHash } from "node:crypto";
+import { McpClient } from "./client.js";
+import { StdioTransport } from "./stdio-transport.js";
+const MAX_TOOL_NAME_LENGTH = 64;
+/** Sanitise one name segment to the character set tool APIs accept. */
+export function sanitizeNameSegment(value, fallback = "tool") {
+    const cleaned = value
+        .replace(/[^A-Za-z0-9_-]+/g, "_")
+        .replace(/^_+|_+$/g, "");
+    return cleaned || fallback;
+}
+function shortHash(value) {
+    return createHash("sha1").update(value).digest("hex").slice(0, 8);
+}
+function bounded(name) {
+    if (name.length <= MAX_TOOL_NAME_LENGTH)
+        return name;
+    const hash = shortHash(name);
+    return `${name.slice(0, MAX_TOOL_NAME_LENGTH - hash.length - 1).replace(/_+$/, "")}_${hash}`;
+}
+/**
+ * Resolve a remote tool to its model-facing name. The server and tool segments
+ * are sanitised and the whole name is capped so it stays valid everywhere.
+ */
+export function namespacedToolName(server, tool) {
+    return bounded(`mcp__${sanitizeNameSegment(server, "server")}__${sanitizeNameSegment(tool)}`);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function defaultTransportFactory(_serverName, config) {
+    return new StdioTransport(config);
+}
+/**
+ * Owns the lifetime of every configured MCP server. Connections are lazy,
+ * failures are isolated per server, and every state transition is observable.
+ */
+export class McpManager {
+    onToolsChanged;
+    records;
+    transportFactory;
+    onEvent;
+    closed = false;
+    constructor(options = {}) {
+        this.records = new Map();
+        this.transportFactory = options.transportFactory ?? defaultTransportFactory;
+        this.onEvent = options.onEvent;
+        for (const [name, config] of Object.entries(options.servers ?? {})) {
+            this.records.set(name, {
+                name,
+                config,
+                state: config.enabled ? "idle" : "disabled",
+                remoteTools: [],
+                failedReported: false,
+            });
+        }
+    }
+    /** Configured server names, including disabled entries. */
+    serverNames() {
+        return [...this.records.keys()];
+    }
+    /** True when there is at least one enabled server. */
+    hasEnabledServers() {
+        return [...this.records.values()].some((record) => record.config.enabled);
+    }
+    status() {
+        const namesByRemote = new Map(this.tools().map((tool) => [
+            `${tool.server}\u0000${tool.remoteName}`,
+            tool.name,
+        ]));
+        return [...this.records.values()].map((record) => ({
+            name: record.name,
+            state: record.state,
+            enabled: record.config.enabled,
+            requiresApproval: record.config.requiresApproval,
+            toolCount: record.state === "ready" ? record.remoteTools.length : 0,
+            tools: record.state === "ready"
+                ? record.remoteTools.map((tool) => namesByRemote.get(`${record.name}\u0000${tool.name}`) ??
+                    namespacedToolName(record.name, tool.name))
+                : [],
+            lastError: record.lastError,
+        }));
+    }
+    /** Discovered tools across every ready server. */
+    tools() {
+        const tools = [];
+        const used = new Set();
+        for (const record of this.records.values()) {
+            if (record.state !== "ready")
+                continue;
+            for (const remote of record.remoteTools) {
+                const name = this.uniqueName(record.name, remote.name, used);
+                tools.push({
+                    server: record.name,
+                    remoteName: remote.name,
+                    name,
+                    description: remote.description ??
+                        `MCP tool ${remote.name} from ${record.name}`,
+                    inputSchema: remote.inputSchema ?? {
+                        type: "object",
+                        properties: {},
+                    },
+                    requiresApproval: record.config.requiresApproval,
+                    callTimeoutMs: record.config.callTimeoutMs,
+                });
+            }
+        }
+        return tools;
+    }
+    /**
+     * Connect every idle server and return the current tool list. A failing
+     * server is recorded and skipped; it never rejects the overall discovery.
+     */
+    async syncTools() {
+        if (this.closed)
+            return [];
+        const pending = [];
+        for (const record of this.records.values()) {
+            if (!record.config.enabled)
+                continue;
+            if (record.state === "idle")
+                pending.push(this.connect(record.name));
+        }
+        await Promise.all(pending);
+        return this.tools();
+    }
+    /** Retry one server, or every server when no name is given. */
+    async reconnect(name) {
+        if (this.closed)
+            throw new Error("MCP manager is closed");
+        if (name !== undefined) {
+            if (!this.records.has(name)) {
+                throw new Error(`Unknown MCP server: ${name}`);
+            }
+            await this.reset(this.records.get(name));
+            if (this.records.get(name).config.enabled) {
+                await this.connect(name);
+            }
+            return this.status();
+        }
+        for (const record of this.records.values()) {
+            await this.reset(record);
+        }
+        await Promise.all([...this.records.values()]
+            .filter((record) => record.config.enabled)
+            .map((record) => this.connect(record.name)));
+        return this.status();
+    }
+    async callTool(server, tool, args, options = {}) {
+        const record = this.records.get(server);
+        if (!record)
+            throw new Error(`Unknown MCP server: ${server}`);
+        if (record.state !== "ready" || !record.client) {
+            throw new Error(`MCP_SERVER_UNAVAILABLE: ${server} is ${record.state}${record.lastError ? ` (${record.lastError})` : ""}`);
+        }
+        if (options.signal?.aborted)
+            throw new Error("USER_CANCELLED");
+        const result = await record.client.callTool(tool, args, {
+            timeoutMs: record.config.callTimeoutMs,
+            signal: options.signal,
+        });
+        if (typeof result === "object" && result !== null) {
+            return result;
+        }
+        return { content: result };
+    }
+    /** Close every server without reporting failures. */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const records = [...this.records.values()];
+        for (const record of records) {
+            record.state = "closed";
+        }
+        await Promise.all(records.map(async (record) => {
+            const client = record.client;
+            record.client = undefined;
+            record.transport = undefined;
+            await client?.close().catch(() => { });
+        }));
+    }
+    /** Internal: establish one server and cache its tools. */
+    async connect(name) {
+        const record = this.records.get(name);
+        if (!record || this.closed || !record.config.enabled)
+            return;
+        if (record.state === "ready")
+            return;
+        if (record.connectPromise)
+            return record.connectPromise;
+        record.connectPromise = (async () => {
+            record.state = "connecting";
+            record.lastError = undefined;
+            const transport = this.transportFactory(name, record.config);
+            const client = new McpClient(transport, {
+                onClose: (info) => this.handleUnexpectedClose(record, info),
+            });
+            record.transport = transport;
+            record.client = client;
+            client.onNotification("notifications/tools/list_changed", () => {
+                void this.refresh(name);
+            });
+            try {
+                await client.connect({
+                    startupTimeoutMs: record.config.startupTimeoutMs,
+                });
+                const remoteTools = await client.listTools({
+                    timeoutMs: record.config.callTimeoutMs,
+                });
+                if (record.client !== client)
+                    return;
+                record.remoteTools = remoteTools;
+                record.state = "ready";
+                record.failedReported = false;
+                record.lastError = undefined;
+                this.emit({
+                    type: "mcp_server_connected",
+                    server: name,
+                    toolCount: remoteTools.length,
+                });
+                this.emitToolsChanged();
+            }
+            catch (error) {
+                if (record.client !== client)
+                    return;
+                this.fail(record, error, transport);
+                await client.close().catch(() => { });
+                if (record.client === client) {
+                    record.client = undefined;
+                    record.transport = undefined;
+                }
+            }
+            finally {
+                record.connectPromise = undefined;
+            }
+        })();
+        return record.connectPromise;
+    }
+    async refresh(name) {
+        const record = this.records.get(name);
+        if (!record || this.closed || record.state !== "ready")
+            return;
+        if (record.refreshPromise)
+            return record.refreshPromise;
+        const client = record.client;
+        if (!client)
+            return;
+        record.refreshPromise = (async () => {
+            try {
+                const remoteTools = await client.listTools({
+                    timeoutMs: record.config.callTimeoutMs,
+                });
+                if (record.client !== client)
+                    return;
+                record.remoteTools = remoteTools;
+                record.lastError = undefined;
+                this.emit({
+                    type: "mcp_tools_changed",
+                    server: name,
+                    toolCount: remoteTools.length,
+                });
+                this.emitToolsChanged();
+            }
+            catch (error) {
+                if (record.client !== client)
+                    return;
+                record.lastError = errorMessage(error);
+                if (client.isClosed()) {
+                    this.fail(record, error, record.transport);
+                }
+            }
+            finally {
+                record.refreshPromise = undefined;
+            }
+        })();
+        return record.refreshPromise;
+    }
+    handleUnexpectedClose(record, info) {
+        if (record.client && record.state !== "closed") {
+            const detail = info.code !== undefined && info.code !== null
+                ? `MCP server exited (code ${info.code})`
+                : info.signal
+                    ? `MCP server exited (signal ${info.signal})`
+                    : "MCP server exited";
+            record.lastError = detail;
+            this.fail(record, new Error(detail), record.transport);
+        }
+    }
+    fail(record, error, transport) {
+        record.state = "failed";
+        record.remoteTools = [];
+        const stderr = transport?.stderrText?.();
+        const message = errorMessage(error);
+        record.lastError =
+            stderr && !message.includes(stderr)
+                ? `${message}: ${stderr.slice(-2000)}`
+                : message;
+        if (!record.failedReported) {
+            record.failedReported = true;
+            this.emit({
+                type: "mcp_server_failed",
+                server: record.name,
+                error: record.lastError,
+            });
+        }
+        this.emitToolsChanged();
+    }
+    async reset(record) {
+        const client = record.client;
+        record.client = undefined;
+        record.transport = undefined;
+        record.connectPromise = undefined;
+        record.refreshPromise = undefined;
+        await client?.close().catch(() => { });
+        record.remoteTools = [];
+        record.lastError = undefined;
+        record.failedReported = false;
+        record.state = record.config.enabled ? "idle" : "disabled";
+        this.emitToolsChanged();
+    }
+    uniqueName(server, tool, used) {
+        const base = namespacedToolName(server, tool);
+        let name = base;
+        if (used.has(name)) {
+            const hash = shortHash(`${server}\0${tool}`);
+            name = `${base.slice(0, MAX_TOOL_NAME_LENGTH - hash.length - 1).replace(/_+$/, "")}_${hash}`;
+        }
+        used.add(name);
+        return name;
+    }
+    emitToolsChanged() {
+        try {
+            this.onToolsChanged?.(this.tools());
+        }
+        catch {
+            // Consumers must not break server lifecycle.
+        }
+    }
+    emit(event) {
+        try {
+            this.onEvent?.(event);
+        }
+        catch {
+            // Observability must never break tool execution.
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/mcp/manager.js.map

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

package/dist/mcp/stdio-transport.d.ts

@@ -0,0 +1,26 @@
+import type { McpServerConfig, McpTransport, McpTransportHandlers } from "./types.js";
+/**
+ * Build the deliberately small environment inherited by an MCP server. The
+ * provider API keys in the parent process are not part of the allowlist, so a
+ * server only receives secrets the user explicitly declared.
+ */
+export declare function buildMcpEnv(declared?: Record<string, string>, base?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/**
+ * MCP stdio framing: one JSON-RPC message per newline. stderr is captured for
+ * diagnostics but never mixed into the protocol stream.
+ */
+export declare class StdioTransport implements McpTransport {
+    private readonly config;
+    private handlers?;
+    private child?;
+    private lines?;
+    private startPromise?;
+    private closing;
+    private stderrBuffer;
+    constructor(config: McpServerConfig);
+    setHandlers(handlers: McpTransportHandlers): void;
+    stderrText(): string;
+    start(): Promise<void>;
+    send(message: unknown): void;
+    close(): Promise<void>;
+}

package/dist/mcp/stdio-transport.js

@@ -0,0 +1,174 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { terminateProcessTree } from "../security/process.js";
+const ENV_ALLOWLIST = new Set([
+    "PATH",
+    "HOME",
+    "USER",
+    "LOGNAME",
+    "SHELL",
+    "LANG",
+    "LANGUAGE",
+    "TERM",
+    "TMPDIR",
+    "TMP",
+    "TEMP",
+    // Windows process bootstrap.
+    "SystemRoot",
+    "SystemDrive",
+    "WINDIR",
+    "ComSpec",
+    "PATHEXT",
+    "USERPROFILE",
+    "APPDATA",
+    "LOCALAPPDATA",
+    "PROGRAMDATA",
+    "PROGRAMFILES",
+    "PROGRAMFILES(X86)",
+    "CommonProgramFiles",
+    "CommonProgramW6432",
+]);
+const ENV_PREFIX_ALLOWLIST = ["LC_", "XDG_"];
+/**
+ * Build the deliberately small environment inherited by an MCP server. The
+ * provider API keys in the parent process are not part of the allowlist, so a
+ * server only receives secrets the user explicitly declared.
+ */
+export function buildMcpEnv(declared = {}, base = process.env) {
+    const env = {};
+    for (const [key, value] of Object.entries(base)) {
+        if (value === undefined)
+            continue;
+        if (ENV_ALLOWLIST.has(key) ||
+            ENV_PREFIX_ALLOWLIST.some((prefix) => key.startsWith(prefix))) {
+            env[key] = value;
+        }
+    }
+    for (const [key, value] of Object.entries(declared)) {
+        env[key] = value;
+    }
+    return env;
+}
+const MAX_STDERR_BYTES = 8192;
+/**
+ * MCP stdio framing: one JSON-RPC message per newline. stderr is captured for
+ * diagnostics but never mixed into the protocol stream.
+ */
+export class StdioTransport {
+    config;
+    handlers;
+    child;
+    lines;
+    startPromise;
+    closing = false;
+    stderrBuffer = "";
+    constructor(config) {
+        this.config = config;
+    }
+    setHandlers(handlers) {
+        this.handlers = handlers;
+    }
+    stderrText() {
+        return this.stderrBuffer.trim();
+    }
+    start() {
+        if (this.startPromise)
+            return this.startPromise;
+        this.startPromise = new Promise((resolve, reject) => {
+            let settled = false;
+            let child;
+            try {
+                child = spawn(this.config.command, this.config.args ?? [], {
+                    cwd: this.config.cwd,
+                    env: buildMcpEnv(this.config.env ?? {}),
+                    stdio: ["pipe", "pipe", "pipe"],
+                    windowsHide: true,
+                    detached: process.platform !== "win32",
+                });
+            }
+            catch (error) {
+                reject(error instanceof Error ? error : new Error(String(error)));
+                return;
+            }
+            this.child = child;
+            child.once("spawn", () => {
+                settled = true;
+                resolve();
+            });
+            child.once("error", (error) => {
+                if (!settled) {
+                    settled = true;
+                    reject(error);
+                }
+                else {
+                    this.handlers?.onError(error);
+                }
+            });
+            child.once("close", (code, signal) => {
+                this.lines?.close();
+                this.lines = undefined;
+                this.child = undefined;
+                if (!this.closing) {
+                    this.handlers?.onClose({ code, signal });
+                }
+            });
+            child.stderr?.on("data", (chunk) => {
+                this.stderrBuffer += chunk.toString();
+                if (this.stderrBuffer.length > MAX_STDERR_BYTES) {
+                    this.stderrBuffer = this.stderrBuffer.slice(-MAX_STDERR_BYTES);
+                }
+            });
+            this.lines = createInterface({ input: child.stdout, crlfDelay: Infinity });
+            this.lines.on("line", (line) => {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    return;
+                try {
+                    this.handlers?.onMessage(JSON.parse(trimmed));
+                }
+                catch {
+                    this.handlers?.onError(new Error(`MCP server sent invalid JSON: ${trimmed.slice(0, 200)}`));
+                }
+            });
+        });
+        return this.startPromise;
+    }
+    send(message) {
+        const stdin = this.child?.stdin;
+        if (!stdin || stdin.destroyed) {
+            throw new Error("MCP server stdin is not available");
+        }
+        stdin.write(JSON.stringify(message) + "\n");
+    }
+    async close() {
+        if (this.closing)
+            return;
+        this.closing = true;
+        this.lines?.close();
+        this.lines = undefined;
+        const child = this.child;
+        this.child = undefined;
+        if (!child)
+            return;
+        try {
+            child.stdin.end();
+        }
+        catch {
+            // Ignore.
+        }
+        if (child.exitCode !== null || child.signalCode !== null)
+            return;
+        terminateProcessTree(child, "SIGTERM");
+        await new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                terminateProcessTree(child, "SIGKILL");
+                resolve();
+            }, 750);
+            child.once("close", () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=stdio-transport.js.map

package/dist/mcp/stdio-transport.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,22 @@
+import type { Tool, ToolContext, ToolResult } from "../tools/types.js";
+import type { ToolCall } from "../types.js";
+import type { McpManager } from "./manager.js";
+import type { McpToolState } from "./types.js";
+export declare const MCP_APPROVAL_REQUIRED = "MCP_APPROVAL_REQUIRED";
+export declare const MCP_CALL_FAILED = "MCP_CALL_FAILED";
+export declare const MCP_APPROVAL_PREFIX = "mcp";
+/**
+ * Wrap one discovered MCP tool as an Atom-lite `Tool`. The execution path is
+ * the same as built-ins: it receives the normal context, honours approval
+ * policy, and returns the normal result shape.
+ */
+export declare class McpTool implements Tool {
+    private readonly manager;
+    private readonly tool;
+    readonly definition: Tool["definition"];
+    constructor(manager: McpManager, tool: McpToolState);
+    execute(call: ToolCall, ctx: ToolContext): Promise<ToolResult>;
+}
+export declare function createMcpTools(manager: McpManager): Tool[];
+/** Map an MCP tool result into the single string Atom-lite tools use. */
+export declare function summariseMcpResult(result: unknown): string;