@oni.bot/core 0.8.0 → 1.0.1

package/dist/lsp/index.js

@@ -0,0 +1,183 @@
+/**
+ * LSP Module — Language Server Protocol integration.
+ *
+ * High-level facade for managing LSP clients:
+ * - Auto-spawns appropriate language server for each file type
+ * - Caches broken servers to avoid repeated spawn attempts
+ * - Provides touchFile() → diagnostics() flow for edit tools
+ * - Single instance shared across all swarm agents (concurrent-safe)
+ *
+ * Usage:
+ *   const lsp = new LSPManager(rootDir);
+ *   await lsp.touchFile("src/index.ts", true); // true = wait for diagnostics
+ *   const diags = lsp.getDiagnostics("src/index.ts");
+ *
+ * Swarm-aware: Multiple agents can call touchFile() concurrently.
+ * File versions are tracked per-file, not per-agent.
+ */
+import { extname } from "node:path";
+import { LSPClient } from "./client.js";
+import { findServersForExtension } from "./servers.js";
+export { LSPClient } from "./client.js";
+export { BUILTIN_SERVERS, TYPESCRIPT_SERVER, PYRIGHT_SERVER, GOPLS_SERVER, RUST_ANALYZER_SERVER, findServersForExtension, getLanguageId, LANGUAGE_MAP, } from "./servers.js";
+export { DiagnosticSeverity as DiagSeverity } from "./types.js";
+// ── Constants ────────────────────────────────────────────────
+const MAX_DIAGNOSTICS_PER_FILE = 20;
+// ── LSPManager ───────────────────────────────────────────────
+export class LSPManager {
+    rootDir;
+    clients = new Map();
+    broken = new Set();
+    spawning = new Map();
+    customServers = [];
+    disabled = false;
+    constructor(rootDir) {
+        this.rootDir = rootDir;
+    }
+    // ── Configuration ────────────────────────────────────────
+    /**
+     * Add custom server configurations (from config file).
+     */
+    addServers(servers) {
+        this.customServers.push(...servers);
+    }
+    /**
+     * Disable LSP entirely (e.g., from config: `lsp: false`).
+     */
+    disable() {
+        this.disabled = true;
+        this.disposeAll();
+    }
+    // ── Core Operations ──────────────────────────────────────
+    /**
+     * Touch a file — notify appropriate LSP servers and optionally
+     * wait for diagnostics.
+     *
+     * Lazily spawns servers on first call for each file type.
+     * Skips broken servers silently.
+     */
+    async touchFile(filePath, waitForDiagnostics = false) {
+        if (this.disabled)
+            return;
+        const clients = await this.getClientsForFile(filePath);
+        if (clients.length === 0)
+            return;
+        await Promise.all(clients.map((client) => client.touchFile(filePath, waitForDiagnostics).catch(() => {
+            // Swallow individual client errors
+        })));
+    }
+    /**
+     * Get diagnostics for a specific file across all active servers.
+     */
+    getDiagnostics(filePath) {
+        const allDiags = [];
+        for (const client of this.clients.values()) {
+            allDiags.push(...client.getDiagnostics(filePath));
+        }
+        return allDiags;
+    }
+    /**
+     * Get error-level diagnostics for a file, formatted for tool output.
+     *
+     * Returns a string suitable for appending to edit_file results,
+     * or empty string if no errors.
+     */
+    getErrorDiagnosticsText(filePath) {
+        const diags = this.getDiagnostics(filePath);
+        const errors = diags.filter((d) => d.severity === 1); // DiagnosticSeverity.Error
+        if (errors.length === 0)
+            return "";
+        const limited = errors.slice(0, MAX_DIAGNOSTICS_PER_FILE);
+        const lines = limited.map((d) => formatDiagnostic(d));
+        return `\n\nLSP errors detected:\n<diagnostics file="${filePath}">\n${lines.join("\n")}\n</diagnostics>`;
+    }
+    // ── State Queries ────────────────────────────────────────
+    /**
+     * Get info about all active clients.
+     */
+    getClientInfos() {
+        return [...this.clients.values()].map((c) => c.getInfo());
+    }
+    /**
+     * Check if a server is marked as broken.
+     */
+    isBroken(serverId) {
+        return this.broken.has(serverId);
+    }
+    // ── Lifecycle ────────────────────────────────────────────
+    /**
+     * Dispose all clients and clear state.
+     */
+    disposeAll() {
+        for (const client of this.clients.values()) {
+            client.stop();
+        }
+        this.clients.clear();
+        this.spawning.clear();
+        // Don't clear broken — those stay until session restart
+    }
+    // ── Internal: Client Resolution ──────────────────────────
+    async getClientsForFile(filePath) {
+        const ext = extname(filePath);
+        if (!ext)
+            return [];
+        // Find servers from built-in + custom
+        const builtinServers = findServersForExtension(ext);
+        const customServers = this.customServers.filter((s) => s.extensions.includes(ext.toLowerCase()));
+        const allServers = [...builtinServers, ...customServers];
+        const result = [];
+        for (const server of allServers) {
+            const key = `${this.rootDir}:${server.id}`;
+            // Skip broken servers
+            if (this.broken.has(key))
+                continue;
+            // Return existing client
+            const existing = this.clients.get(key);
+            if (existing && existing.getState() === "ready") {
+                result.push(existing);
+                continue;
+            }
+            // Check if already spawning (dedup)
+            const inflight = this.spawning.get(key);
+            if (inflight) {
+                const client = await inflight;
+                if (client)
+                    result.push(client);
+                continue;
+            }
+            // Spawn new client
+            const spawnTask = this.spawnClient(server, key);
+            this.spawning.set(key, spawnTask);
+            const client = await spawnTask;
+            this.spawning.delete(key);
+            if (client)
+                result.push(client);
+        }
+        return result;
+    }
+    async spawnClient(config, key) {
+        const client = new LSPClient(config, this.rootDir);
+        try {
+            await client.start();
+            this.clients.set(key, client);
+            return client;
+        }
+        catch {
+            // Mark as broken — don't retry until session restart
+            this.broken.add(key);
+            return null;
+        }
+    }
+}
+// ── Formatting ───────────────────────────────────────────────
+/**
+ * Format a diagnostic for human-readable output.
+ */
+export function formatDiagnostic(d) {
+    const severity = d.severity === 1 ? "error" : d.severity === 2 ? "warning" : "info";
+    const loc = `${d.range.start.line + 1}:${d.range.start.character + 1}`;
+    const source = d.source ? ` (${d.source})` : "";
+    const code = d.code !== undefined ? ` [${d.code}]` : "";
+    return `  ${loc} ${severity}${code}${source}: ${d.message}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/lsp/index.js.map

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

package/dist/lsp/servers.d.ts

@@ -0,0 +1,48 @@
+/**
+ * LSP Server Configurations — built-in language server definitions.
+ *
+ * Each server maps file extensions to a language server command.
+ * Servers are lazily spawned on first touchFile() for a matching extension.
+ *
+ * Start with TypeScript (most common for this codebase). Add more later:
+ * pyright, gopls, rust-analyzer, etc.
+ */
+import type { LSPServerConfig } from "./types.js";
+export declare const LANGUAGE_MAP: Record<string, string>;
+/**
+ * Get the language ID for a file extension.
+ * Returns undefined if the extension isn't recognized.
+ */
+export declare function getLanguageId(ext: string): string | undefined;
+/**
+ * TypeScript language server via typescript-language-server.
+ *
+ * Requires: `typescript-language-server` in PATH or node_modules/.bin
+ * Falls back to: `npx typescript-language-server --stdio`
+ */
+export declare const TYPESCRIPT_SERVER: LSPServerConfig;
+/**
+ * Pyright language server for Python.
+ *
+ * Requires: `pyright-langserver` in PATH
+ */
+export declare const PYRIGHT_SERVER: LSPServerConfig;
+/**
+ * gopls language server for Go.
+ *
+ * Requires: `gopls` in PATH
+ */
+export declare const GOPLS_SERVER: LSPServerConfig;
+/**
+ * rust-analyzer for Rust.
+ *
+ * Requires: `rust-analyzer` in PATH
+ */
+export declare const RUST_ANALYZER_SERVER: LSPServerConfig;
+export declare const BUILTIN_SERVERS: LSPServerConfig[];
+/**
+ * Find server configs that handle a given file extension.
+ * A file can match multiple servers (e.g., .ts → TypeScript + ESLint).
+ */
+export declare function findServersForExtension(ext: string): LSPServerConfig[];
+//# sourceMappingURL=servers.d.ts.map

package/dist/lsp/servers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"servers.d.ts","sourceRoot":"","sources":["../../src/lsp/servers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyB/C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7D;AAID;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAM/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,eAM5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,eAM1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAMlC,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,eAAe,EAK5C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CAEtE"}

package/dist/lsp/servers.js

@@ -0,0 +1,108 @@
+/**
+ * LSP Server Configurations — built-in language server definitions.
+ *
+ * Each server maps file extensions to a language server command.
+ * Servers are lazily spawned on first touchFile() for a matching extension.
+ *
+ * Start with TypeScript (most common for this codebase). Add more later:
+ * pyright, gopls, rust-analyzer, etc.
+ */
+// ── Extension → Language ID Map ──────────────────────────────
+export const LANGUAGE_MAP = {
+    ".ts": "typescript",
+    ".tsx": "typescriptreact",
+    ".js": "javascript",
+    ".jsx": "javascriptreact",
+    ".mjs": "javascript",
+    ".cjs": "javascript",
+    ".mts": "typescript",
+    ".cts": "typescript",
+    ".py": "python",
+    ".go": "go",
+    ".rs": "rust",
+    ".java": "java",
+    ".rb": "ruby",
+    ".c": "c",
+    ".cpp": "cpp",
+    ".h": "c",
+    ".hpp": "cpp",
+    ".cs": "csharp",
+    ".swift": "swift",
+    ".kt": "kotlin",
+    ".lua": "lua",
+    ".zig": "zig",
+    ".ex": "elixir",
+    ".exs": "elixir",
+};
+/**
+ * Get the language ID for a file extension.
+ * Returns undefined if the extension isn't recognized.
+ */
+export function getLanguageId(ext) {
+    return LANGUAGE_MAP[ext.toLowerCase()];
+}
+// ── Built-in Server Configs ──────────────────────────────────
+/**
+ * TypeScript language server via typescript-language-server.
+ *
+ * Requires: `typescript-language-server` in PATH or node_modules/.bin
+ * Falls back to: `npx typescript-language-server --stdio`
+ */
+export const TYPESCRIPT_SERVER = {
+    id: "typescript",
+    extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".mts", ".cts"],
+    command: "typescript-language-server",
+    args: ["--stdio"],
+    languageId: "typescript",
+};
+/**
+ * Pyright language server for Python.
+ *
+ * Requires: `pyright-langserver` in PATH
+ */
+export const PYRIGHT_SERVER = {
+    id: "pyright",
+    extensions: [".py"],
+    command: "pyright-langserver",
+    args: ["--stdio"],
+    languageId: "python",
+};
+/**
+ * gopls language server for Go.
+ *
+ * Requires: `gopls` in PATH
+ */
+export const GOPLS_SERVER = {
+    id: "gopls",
+    extensions: [".go"],
+    command: "gopls",
+    args: ["serve"],
+    languageId: "go",
+};
+/**
+ * rust-analyzer for Rust.
+ *
+ * Requires: `rust-analyzer` in PATH
+ */
+export const RUST_ANALYZER_SERVER = {
+    id: "rust-analyzer",
+    extensions: [".rs"],
+    command: "rust-analyzer",
+    args: [],
+    languageId: "rust",
+};
+// ── All Built-in Servers ─────────────────────────────────────
+export const BUILTIN_SERVERS = [
+    TYPESCRIPT_SERVER,
+    PYRIGHT_SERVER,
+    GOPLS_SERVER,
+    RUST_ANALYZER_SERVER,
+];
+/**
+ * Find server configs that handle a given file extension.
+ * A file can match multiple servers (e.g., .ts → TypeScript + ESLint).
+ */
+export function findServersForExtension(ext) {
+    return BUILTIN_SERVERS.filter((s) => s.extensions.includes(ext.toLowerCase()));
+}
+//# sourceMappingURL=servers.js.map

package/dist/lsp/servers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"servers.js","sourceRoot":"","sources":["../../src/lsp/servers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,gEAAgE;AAEhE,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,iBAAiB;IACzB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,gEAAgE;AAEhE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,EAAE,EAAE,YAAY;IAChB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC1E,OAAO,EAAE,4BAA4B;IACrC,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,EAAE,EAAE,SAAS;IACb,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,OAAO,EAAE,oBAAoB;IAC7B,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,UAAU,EAAE,QAAQ;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,EAAE,EAAE,OAAO;IACX,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,CAAC,OAAO,CAAC;IACf,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAoB;IACnD,EAAE,EAAE,eAAe;IACnB,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,MAAM;CACnB,CAAC;AAEF,gEAAgE;AAEhE,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,iBAAiB;IACjB,cAAc;IACd,YAAY;IACZ,oBAAoB;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AACjF,CAAC"}

package/dist/lsp/types.d.ts

@@ -0,0 +1,142 @@
+/**
+ * LSP Protocol Types — minimal subset for diagnostics-only client.
+ *
+ * Based on the Language Server Protocol specification.
+ * Only includes types needed for: initialize, didOpen, didChange,
+ * publishDiagnostics. Extended later for symbols, hover, etc.
+ */
+export interface LSPPosition {
+    line: number;
+    character: number;
+}
+export interface LSPRange {
+    start: LSPPosition;
+    end: LSPPosition;
+}
+export declare enum DiagnosticSeverity {
+    Error = 1,
+    Warning = 2,
+    Information = 3,
+    Hint = 4
+}
+export interface LSPDiagnostic {
+    range: LSPRange;
+    severity?: DiagnosticSeverity;
+    code?: number | string;
+    source?: string;
+    message: string;
+}
+export interface PublishDiagnosticsParams {
+    uri: string;
+    version?: number;
+    diagnostics: LSPDiagnostic[];
+}
+export interface InitializeParams {
+    processId: number | null;
+    rootUri: string | null;
+    capabilities: ClientCapabilities;
+    workspaceFolders?: Array<{
+        uri: string;
+        name: string;
+    }> | null;
+    initializationOptions?: unknown;
+}
+export interface ClientCapabilities {
+    textDocument?: {
+        synchronization?: {
+            didOpen?: boolean;
+            didChange?: boolean;
+        };
+        publishDiagnostics?: {
+            versionSupport?: boolean;
+        };
+    };
+    window?: {
+        workDoneProgress?: boolean;
+    };
+    workspace?: {
+        configuration?: boolean;
+        workspaceFolders?: {
+            supported?: boolean;
+        };
+    };
+}
+export interface InitializeResult {
+    capabilities: ServerCapabilities;
+    serverInfo?: {
+        name: string;
+        version?: string;
+    };
+}
+export interface ServerCapabilities {
+    textDocumentSync?: number | {
+        openClose?: boolean;
+        change?: number;
+    };
+    diagnosticProvider?: unknown;
+    [key: string]: unknown;
+}
+export interface TextDocumentItem {
+    uri: string;
+    languageId: string;
+    version: number;
+    text: string;
+}
+export interface DidOpenTextDocumentParams {
+    textDocument: TextDocumentItem;
+}
+export interface DidChangeTextDocumentParams {
+    textDocument: {
+        uri: string;
+        version: number;
+    };
+    contentChanges: Array<{
+        text: string;
+    }>;
+}
+export interface LSPServerConfig {
+    /** Server identifier (e.g., "typescript", "pyright") */
+    id: string;
+    /** File extensions this server handles */
+    extensions: string[];
+    /** Spawn command */
+    command: string;
+    /** Command arguments */
+    args?: string[];
+    /** Language ID for documents */
+    languageId: string;
+    /** Initialization options passed to the server */
+    initializationOptions?: unknown;
+}
+export type LSPClientState = "disconnected" | "connecting" | "ready" | "error" | "broken";
+export interface LSPClientInfo {
+    serverId: string;
+    state: LSPClientState;
+    rootDir: string;
+    serverInfo?: {
+        name: string;
+        version?: string;
+    };
+}
+export interface JsonRpcMessage {
+    jsonrpc: "2.0";
+}
+export interface JsonRpcRequest extends JsonRpcMessage {
+    id: number;
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcResponse extends JsonRpcMessage {
+    id: number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface JsonRpcNotification extends JsonRpcMessage {
+    method: string;
+    params?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lsp/types.d.ts.map

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

package/dist/lsp/types.js

@@ -0,0 +1,16 @@
+/**
+ * LSP Protocol Types — minimal subset for diagnostics-only client.
+ *
+ * Based on the Language Server Protocol specification.
+ * Only includes types needed for: initialize, didOpen, didChange,
+ * publishDiagnostics. Extended later for symbols, hover, etc.
+ */
+// ── Diagnostics ──────────────────────────────────────────────
+export var DiagnosticSeverity;
+(function (DiagnosticSeverity) {
+    DiagnosticSeverity[DiagnosticSeverity["Error"] = 1] = "Error";
+    DiagnosticSeverity[DiagnosticSeverity["Warning"] = 2] = "Warning";
+    DiagnosticSeverity[DiagnosticSeverity["Information"] = 3] = "Information";
+    DiagnosticSeverity[DiagnosticSeverity["Hint"] = 4] = "Hint";
+})(DiagnosticSeverity || (DiagnosticSeverity = {}));
+//# sourceMappingURL=types.js.map

package/dist/lsp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lsp/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,gEAAgE;AAEhE,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,6DAAS,CAAA;IACT,iEAAW,CAAA;IACX,yEAAe,CAAA;IACf,2DAAQ,CAAA;AACV,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}

package/dist/mcp/client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * MCP Client — connects to an MCP server, discovers tools, and forwards calls.
+ *
+ * Lifecycle:
+ *   1. connect() — spawn server, perform initialize handshake, list tools
+ *   2. listTools() — return discovered tools (cached from connect)
+ *   3. callTool(name, args) — forward tool invocation to server
+ *   4. disconnect() — gracefully shut down
+ *
+ * Swarm-aware: A single MCPClient instance can serve multiple swarm agents.
+ * Tool calls are stateless — concurrent callers are safe.
+ */
+import type { MCPServerConfig, MCPToolDefinition, MCPCallToolResult, MCPClientState, MCPClientInfo } from "./types.js";
+export declare class MCPClient {
+    private config;
+    private transport;
+    private state;
+    private serverInfo;
+    private tools;
+    private error;
+    private onToolsChanged;
+    constructor(config: MCPServerConfig, options?: {
+        onToolsChanged?: () => void;
+    });
+    /**
+     * Connect to the MCP server:
+     * 1. Spawn the server process via stdio transport
+     * 2. Perform the initialize handshake
+     * 3. Send initialized notification
+     * 4. Discover available tools
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the MCP server gracefully.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Refresh the tool list from the server.
+     */
+    refreshTools(): Promise<void>;
+    /**
+     * Return the cached list of available tools.
+     */
+    listTools(): MCPToolDefinition[];
+    /**
+     * Call a tool on the MCP server.
+     * Returns the tool result with content array.
+     *
+     * Concurrency-safe: multiple callers can invoke simultaneously.
+     */
+    callTool(name: string, args?: Record<string, unknown>): Promise<MCPCallToolResult>;
+    getState(): MCPClientState;
+    getInfo(): MCPClientInfo;
+    private handleNotification;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,aAAa,EAKd,MAAM,YAAY,CAAC;AAUpB,qBAAa,SAAS;IASlB,OAAO,CAAC,MAAM;IARhB,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,cAAc,CAA2B;gBAGvC,MAAM,EAAE,eAAe,EAC/B,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE;IAO3C;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsD9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAenC;;OAEG;IACH,SAAS,IAAI,iBAAiB,EAAE;IAMhC;;;;;OAKG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IA2B7B,QAAQ,IAAI,cAAc;IAI1B,OAAO,IAAI,aAAa;IAYxB,OAAO,CAAC,kBAAkB;CAU3B"}