atom-lite 0.1.0 → 0.5.1

package/dist/mcp/client.js

@@ -0,0 +1,363 @@
+export const SUPPORTED_PROTOCOL_VERSIONS = [
+    "2024-11-05",
+    "2025-03-26",
+    "2025-06-18",
+];
+export const PREFERRED_PROTOCOL_VERSION = "2025-06-18";
+export class McpError extends Error {
+    code;
+    data;
+    constructor(message, code, data) {
+        super(message);
+        this.name = "McpError";
+        this.code = code;
+        this.data = data;
+    }
+}
+export class McpNotConnectedError extends McpError {
+    constructor(message = "MCP client is not connected") {
+        super(message);
+        this.name = "McpNotConnectedError";
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function raceTimeout(promise, timeoutMs, label) {
+    if (!timeoutMs || timeoutMs <= 0)
+        return promise;
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new McpError(`${label} timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+/**
+ * Small JSON-RPC 2.0 client for MCP. The transport owns framing and process
+ * lifecycle; this class owns request ids, timeouts, cancellation, and
+ * notifications.
+ */
+export class McpClient {
+    transport;
+    clientName;
+    clientVersion;
+    onClose;
+    nextId = 1;
+    pending = new Map();
+    notificationHandlers = new Map();
+    closed = false;
+    started = false;
+    startPromise;
+    protocolVersion;
+    serverInfo;
+    capabilities;
+    lastTransportError;
+    constructor(transport, options = {}) {
+        this.transport = transport;
+        this.clientName = options.clientName ?? "atom-lite";
+        this.clientVersion = options.clientVersion ?? "0.3.1";
+        this.onClose = options.onClose;
+        transport.setHandlers({
+            onMessage: (message) => this.handleMessage(message),
+            onError: (error) => this.handleTransportError(error),
+            onClose: (info) => this.handleClose(info),
+        });
+    }
+    get protocolVersionValue() {
+        return this.protocolVersion;
+    }
+    get serverInfoValue() {
+        return this.serverInfo;
+    }
+    get capabilitiesValue() {
+        return this.capabilities;
+    }
+    get lastError() {
+        return this.lastTransportError;
+    }
+    isClosed() {
+        return this.closed;
+    }
+    /** Spawn the transport and perform the MCP initialize handshake. */
+    async connect(options = {}) {
+        if (this.closed)
+            throw new McpNotConnectedError();
+        if (!this.started) {
+            this.started = true;
+            this.startPromise = (async () => {
+                await this.transport.start();
+            })();
+            try {
+                await raceTimeout(this.startPromise, options.startupTimeoutMs, "MCP transport start");
+            }
+            catch (error) {
+                await this.close();
+                throw error;
+            }
+        }
+        else if (this.startPromise) {
+            await this.startPromise;
+        }
+        const result = await this.request("initialize", {
+            protocolVersion: PREFERRED_PROTOCOL_VERSION,
+            capabilities: {},
+            clientInfo: {
+                name: this.clientName,
+                version: this.clientVersion,
+            },
+        }, {
+            timeoutMs: options.startupTimeoutMs,
+            signal: options.signal,
+        });
+        if (!isRecord(result)) {
+            throw new McpError("MCP initialize returned an invalid result");
+        }
+        const protocolVersion = typeof result.protocolVersion === "string"
+            ? result.protocolVersion
+            : "";
+        if (!SUPPORTED_PROTOCOL_VERSIONS.includes(protocolVersion)) {
+            throw new McpError(`Unsupported MCP protocol version: ${protocolVersion || "(missing)"}`);
+        }
+        this.protocolVersion = protocolVersion;
+        this.serverInfo = result.serverInfo;
+        this.capabilities = result.capabilities;
+        this.transport.send({
+            jsonrpc: "2.0",
+            method: "notifications/initialized",
+            params: {},
+        });
+        return {
+            protocolVersion,
+            serverInfo: this.serverInfo,
+            capabilities: this.capabilities,
+        };
+    }
+    /** Discover every page of tools/list. */
+    async listTools(options = {}) {
+        const tools = [];
+        let cursor;
+        for (let page = 0; page < 100; page++) {
+            const result = await this.request("tools/list", cursor ? { cursor } : {}, options);
+            if (!isRecord(result)) {
+                throw new McpError("tools/list returned an invalid result");
+            }
+            const list = Array.isArray(result.tools) ? result.tools : [];
+            for (const raw of list) {
+                if (!isRecord(raw) || typeof raw.name !== "string" || !raw.name) {
+                    continue;
+                }
+                tools.push({
+                    name: raw.name,
+                    description: typeof raw.description === "string" ? raw.description : undefined,
+                    inputSchema: isRecord(raw.inputSchema)
+                        ? raw.inputSchema
+                        : undefined,
+                });
+            }
+            if (typeof result.nextCursor === "string" && result.nextCursor) {
+                cursor = result.nextCursor;
+            }
+            else {
+                break;
+            }
+        }
+        return tools;
+    }
+    async callTool(name, args, options = {}) {
+        return this.request("tools/call", { name, arguments: args }, options);
+    }
+    async ping(options = {}) {
+        return this.request("ping", {}, options);
+    }
+    onNotification(method, handler) {
+        let handlers = this.notificationHandlers.get(method);
+        if (!handlers) {
+            handlers = new Set();
+            this.notificationHandlers.set(method, handlers);
+        }
+        handlers.add(handler);
+        return () => {
+            handlers?.delete(handler);
+        };
+    }
+    async request(method, params, options = {}) {
+        if (this.closed)
+            throw new McpNotConnectedError();
+        if (options.signal?.aborted)
+            throw new Error("USER_CANCELLED");
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            const pending = {
+                method,
+                resolve,
+                reject,
+            };
+            const finish = () => {
+                if (pending.timer) {
+                    clearTimeout(pending.timer);
+                    pending.timer = undefined;
+                }
+                pending.cleanupAbort?.();
+                pending.cleanupAbort = undefined;
+                this.pending.delete(id);
+            };
+            const fail = (error) => {
+                finish();
+                reject(error);
+            };
+            const cancel = (reason) => {
+                this.sendNotification("notifications/cancelled", {
+                    requestId: id,
+                    reason,
+                });
+            };
+            if (options.timeoutMs && options.timeoutMs > 0) {
+                pending.timer = setTimeout(() => {
+                    cancel("timeout");
+                    fail(new McpError(`${method} timed out after ${options.timeoutMs}ms`));
+                }, options.timeoutMs);
+            }
+            if (options.signal) {
+                const onAbort = () => {
+                    cancel("cancelled");
+                    fail(new Error("USER_CANCELLED"));
+                };
+                options.signal.addEventListener("abort", onAbort, { once: true });
+                pending.cleanupAbort = () => {
+                    options.signal?.removeEventListener("abort", onAbort);
+                };
+            }
+            this.pending.set(id, pending);
+            try {
+                this.transport.send({
+                    jsonrpc: "2.0",
+                    id,
+                    method,
+                    params,
+                });
+            }
+            catch (error) {
+                fail(new McpError(`Failed to send ${method}: ${errorMessage(error)}`));
+            }
+        });
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const error = new McpNotConnectedError("MCP client closed");
+        for (const [id, pending] of this.pending) {
+            if (pending.timer)
+                clearTimeout(pending.timer);
+            pending.cleanupAbort?.();
+            pending.reject(error);
+            this.pending.delete(id);
+        }
+        try {
+            await this.transport.close();
+        }
+        catch {
+            // Shutdown is best effort.
+        }
+    }
+    sendNotification(method, params) {
+        if (this.closed)
+            return;
+        try {
+            this.transport.send({ jsonrpc: "2.0", method, params });
+        }
+        catch {
+            // A failing cancel notification must not mask the original failure.
+        }
+    }
+    handleMessage(message) {
+        if (!isRecord(message)) {
+            this.handleTransportError(new McpError("Invalid JSON-RPC message"));
+            return;
+        }
+        // Response to one of our requests.
+        if ("id" in message &&
+            !("method" in message) &&
+            ("result" in message || "error" in message)) {
+            const pending = this.pending.get(message.id);
+            if (!pending)
+                return;
+            this.pending.delete(message.id);
+            if (pending.timer)
+                clearTimeout(pending.timer);
+            pending.cleanupAbort?.();
+            if (isRecord(message.error)) {
+                pending.reject(new McpError(typeof message.error.message === "string"
+                    ? message.error.message
+                    : `${pending.method} failed`, typeof message.error.code === "number"
+                    ? message.error.code
+                    : undefined, message.error.data));
+            }
+            else {
+                pending.resolve(message.result);
+            }
+            return;
+        }
+        // Server-initiated request. Atom-lite does not advertise roots, sampling,
+        // or elicitation, so reject unknown requests with JSON-RPC method-not-found.
+        if ("id" in message && typeof message.method === "string") {
+            try {
+                this.transport.send({
+                    jsonrpc: "2.0",
+                    id: message.id,
+                    error: { code: -32601, message: "Method not found" },
+                });
+            }
+            catch {
+                // Ignore.
+            }
+            return;
+        }
+        if (typeof message.method === "string") {
+            const handlers = this.notificationHandlers.get(message.method);
+            if (!handlers)
+                return;
+            for (const handler of [...handlers]) {
+                try {
+                    handler(message.params);
+                }
+                catch {
+                    // A notification handler must not break the transport loop.
+                }
+            }
+        }
+    }
+    handleTransportError(error) {
+        this.lastTransportError = error;
+    }
+    handleClose(info) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const detail = info.code !== undefined && info.code !== null
+            ? ` (code ${info.code})`
+            : info.signal
+                ? ` (signal ${info.signal})`
+                : "";
+        const error = new McpError(`MCP server exited${detail}`);
+        for (const [id, pending] of this.pending) {
+            if (pending.timer)
+                clearTimeout(pending.timer);
+            pending.cleanupAbort?.();
+            pending.reject(error);
+            this.pending.delete(id);
+        }
+        this.onClose?.(info);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/mcp/client.js.map

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

package/dist/mcp/format.d.ts

@@ -0,0 +1,3 @@
+import type { McpServerStatus } from "./types.js";
+export declare function formatMcpStatus(statuses: McpServerStatus[]): string;
+export declare function formatMcpDoctor(statuses: McpServerStatus[]): string[];

package/dist/mcp/format.js

@@ -0,0 +1,37 @@
+export function formatMcpStatus(statuses) {
+    if (statuses.length === 0) {
+        return "MCP servers: none configured";
+    }
+    const lines = ["MCP servers:"];
+    for (const status of statuses) {
+        const state = status.enabled ? status.state : "disabled";
+        let suffix = "";
+        if (status.state === "failed" && status.lastError) {
+            suffix = `: ${status.lastError}`;
+        }
+        else if (status.state === "ready") {
+            suffix = ` (${status.toolCount} tool${status.toolCount === 1 ? "" : "s"})`;
+            if (status.requiresApproval)
+                suffix += " [requires approval]";
+        }
+        else if (status.state === "disabled") {
+            suffix = " (disabled)";
+        }
+        lines.push(`  ${status.name}: ${state}${suffix}`);
+    }
+    return lines.join("\n");
+}
+export function formatMcpDoctor(statuses) {
+    const lines = ["  mcp:"];
+    if (statuses.length === 0) {
+        lines.push("    none configured");
+        return lines;
+    }
+    for (const status of statuses) {
+        const tools = status.state === "ready" ? ` ${status.toolCount} tool${status.toolCount === 1 ? "" : "s"}` : "";
+        const error = status.lastError ? ` lastError=${status.lastError}` : "";
+        lines.push(`    ${status.name}: ${status.state}${tools}${error}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=format.js.map

package/dist/mcp/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/mcp/format.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,QAA2B;IACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,8BAA8B,CAAC;IACxC,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,cAAc,CAAC,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;QACzD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAClD,MAAM,GAAG,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QACnC,CAAC;aAAM,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YACpC,MAAM,GAAG,KAAK,MAAM,CAAC,SAAS,QAAQ,MAAM,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;YAC3E,IAAI,MAAM,CAAC,gBAAgB;gBAAE,MAAM,IAAI,sBAAsB,CAAC;QAChE,CAAC;aAAM,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,GAAG,aAAa,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,KAAK,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAA2B;IACzD,MAAM,KAAK,GAAa,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GACT,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,QAAQ,MAAM,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,KAAK,CAAC,IAAI,CACR,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,EAAE,CACtD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export { McpClient, McpError, McpNotConnectedError, SUPPORTED_PROTOCOL_VERSIONS, PREFERRED_PROTOCOL_VERSION } from "./client.js";
+export { StdioTransport, buildMcpEnv } from "./stdio-transport.js";
+export { McpManager, namespacedToolName, sanitizeNameSegment } from "./manager.js";
+export { McpTool, createMcpTools, summariseMcpResult } from "./tools.js";
+export { formatMcpStatus, formatMcpDoctor } from "./format.js";

package/dist/mcp/index.js

@@ -0,0 +1,7 @@
+export * from "./types.js";
+export { McpClient, McpError, McpNotConnectedError, SUPPORTED_PROTOCOL_VERSIONS, PREFERRED_PROTOCOL_VERSION } from "./client.js";
+export { StdioTransport, buildMcpEnv } from "./stdio-transport.js";
+export { McpManager, namespacedToolName, sanitizeNameSegment } from "./manager.js";
+export { McpTool, createMcpTools, summariseMcpResult } from "./tools.js";
+export { formatMcpStatus, formatMcpDoctor } from "./format.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACjI,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/mcp/manager.d.ts

@@ -0,0 +1,53 @@
+import type { McpCallResult, McpEvent, McpServerConfig, McpServerStatus, McpToolState, McpTransportFactory } from "./types.js";
+/** Sanitise one name segment to the character set tool APIs accept. */
+export declare function sanitizeNameSegment(value: string, fallback?: string): string;
+/**
+ * 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 declare function namespacedToolName(server: string, tool: string): string;
+export interface McpManagerOptions {
+    servers?: Record<string, McpServerConfig>;
+    transportFactory?: McpTransportFactory;
+    onEvent?: (event: McpEvent) => void;
+}
+/**
+ * Owns the lifetime of every configured MCP server. Connections are lazy,
+ * failures are isolated per server, and every state transition is observable.
+ */
+export declare class McpManager {
+    onToolsChanged?: (tools: McpToolState[]) => void;
+    private readonly records;
+    private readonly transportFactory;
+    private readonly onEvent?;
+    private closed;
+    constructor(options?: McpManagerOptions);
+    /** Configured server names, including disabled entries. */
+    serverNames(): string[];
+    /** True when there is at least one enabled server. */
+    hasEnabledServers(): boolean;
+    status(): McpServerStatus[];
+    /** Discovered tools across every ready server. */
+    tools(): McpToolState[];
+    /**
+     * Connect every idle server and return the current tool list. A failing
+     * server is recorded and skipped; it never rejects the overall discovery.
+     */
+    syncTools(): Promise<McpToolState[]>;
+    /** Retry one server, or every server when no name is given. */
+    reconnect(name?: string): Promise<McpServerStatus[]>;
+    callTool(server: string, tool: string, args: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<McpCallResult>;
+    /** Close every server without reporting failures. */
+    close(): Promise<void>;
+    /** Internal: establish one server and cache its tools. */
+    private connect;
+    private refresh;
+    private handleUnexpectedClose;
+    private fail;
+    private reset;
+    private uniqueName;
+    private emitToolsChanged;
+    private emit;
+}