kagent-ts 0.1.3 → 0.1.5

package/dist/mcp/mcp-client-manager.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpClientManager = void 0;
+const mcp_types_1 = require("./mcp-types");
+const logger_1 = require("../logging/logger");
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
+const sse_js_1 = require("@modelcontextprotocol/sdk/client/sse.js");
+// ─── Config resolver ────────────────────────────────────────────────────────
+function resolveTransportConfig(config) {
+    if (config.command && config.url) {
+        throw new mcp_types_1.McpConnectionError("MCP server config must specify either 'command' (stdio) or 'url' (SSE), not both.");
+    }
+    if (config.command) {
+        return { type: "stdio", command: config.command, args: config.args, env: config.env };
+    }
+    if (config.url) {
+        return { type: "sse", url: config.url };
+    }
+    throw new mcp_types_1.McpConnectionError("MCP server config must specify either 'command' (stdio) or 'url' (SSE).");
+}
+/**
+ * Manages connections to MCP (Model Context Protocol) servers.
+ *
+ * Lifecycle:
+ * 1. `connectToServer()` / `connectAll()` — connect, discover tools,
+ *    register adapted tools in ToolRegistry
+ * 2. Tools execute via the adapted `Tool` wrapper (delegates to MCP client)
+ * 3. `disconnect()` / `disconnectAll()` — unregister tools, close connections
+ */
+class McpClientManager {
+    /** Active connections keyed by server name. */
+    connections = new Map();
+    /** The ToolRegistry where adapted tools are registered. */
+    toolRegistry;
+    logger;
+    constructor(toolRegistry, logger) {
+        this.toolRegistry = toolRegistry;
+        this.logger = logger ?? new logger_1.ConsoleLogger();
+    }
+    // ─── Connection Management ────────────────────────────────────────────────
+    /**
+     * Connect to a single MCP server, discover its tools, and register them
+     * in the ToolRegistry with a `{serverName}_` prefix.
+     *
+     * Idempotent — if the server is already connected, this is a no-op.
+     *
+     * @throws McpConnectionError if the config is invalid or the
+     *         connection/tool-discovery fails (only for new connections).
+     */
+    async connectToServer(serverName, config) {
+        if (this.connections.has(serverName)) {
+            return; // Already connected — idempotent
+        }
+        const transportConfig = resolveTransportConfig(config);
+        // Build transport
+        let transport;
+        if (transportConfig.type === "stdio") {
+            transport = new stdio_js_1.StdioClientTransport({
+                command: transportConfig.command,
+                args: transportConfig.args,
+                env: transportConfig.env,
+            });
+        }
+        else {
+            transport = new sse_js_1.SSEClientTransport(new URL(transportConfig.url));
+        }
+        // Create client and connect
+        const client = new index_js_1.Client({ name: "kagent-ts", version: "0.1.3" }, { capabilities: {} });
+        try {
+            await client.connect(transport);
+        }
+        catch (err) {
+            throw new mcp_types_1.McpConnectionError(`Failed to connect to MCP server "${serverName}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Discover tools
+        let mcpToolDescriptors;
+        try {
+            const result = await client.listTools();
+            mcpToolDescriptors = result.tools;
+        }
+        catch (err) {
+            await client.close().catch(() => { });
+            throw new mcp_types_1.McpConnectionError(`Failed to list tools from MCP server "${serverName}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Adapt and register tools
+        const adaptedTools = [];
+        for (const mcpTool of mcpToolDescriptors) {
+            const adapted = this.adaptTool(serverName, mcpTool, client);
+            if (this.toolRegistry.has(adapted.name)) {
+                this.logger.warn("MCP", `Tool "${adapted.name}" is already registered. ` +
+                    `Skipping MCP tool "${serverName}/${mcpTool.name}".`);
+                continue;
+            }
+            adaptedTools.push(adapted);
+        }
+        if (adaptedTools.length === 0) {
+            this.logger.warn("MCP", `Server "${serverName}" exposed no usable tools.`);
+        }
+        else {
+            this.toolRegistry.registerMany(adaptedTools);
+            this.logger.info("MCP", `Registered ${adaptedTools.length} tool(s) from server "${serverName}".`);
+        }
+        this.connections.set(serverName, { serverName, client, tools: adaptedTools });
+    }
+    /**
+     * Connect to multiple MCP servers. Failures for individual servers are
+     * collected and logged; other servers still connect.
+     *
+     * @returns An array of connection error reports (empty if all succeeded).
+     */
+    async connectAll(servers) {
+        const errors = [];
+        await Promise.allSettled(Object.entries(servers).map(async ([name, config]) => {
+            try {
+                await this.connectToServer(name, config);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                errors.push({ serverName: name, error: message });
+                this.logger.error("MCP", `Failed to connect to server "${name}": ${message}`);
+            }
+        }));
+        return errors;
+    }
+    /**
+     * Disconnect from a single server and unregister its tools.
+     */
+    async disconnect(serverName) {
+        const conn = this.connections.get(serverName);
+        if (!conn)
+            return;
+        // Unregister tools
+        for (const tool of conn.tools) {
+            this.toolRegistry.remove(tool.name);
+        }
+        // Close the client
+        try {
+            await conn.client.close();
+        }
+        catch (err) {
+            this.logger.warn("MCP", `Error while closing connection to "${serverName}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+        this.connections.delete(serverName);
+        this.logger.info("MCP", `Disconnected from server "${serverName}".`);
+    }
+    /**
+     * Disconnect from all MCP servers and unregister all MCP-provided tools.
+     */
+    async disconnectAll() {
+        const names = Array.from(this.connections.keys());
+        await Promise.allSettled(names.map((name) => this.disconnect(name)));
+    }
+    // ─── Queries ──────────────────────────────────────────────────────────────
+    /**
+     * Check if a specific server is currently connected.
+     */
+    hasServer(serverName) {
+        return this.connections.has(serverName);
+    }
+    /**
+     * Get connection status for all servers.
+     */
+    getStatus() {
+        return Array.from(this.connections.entries()).map(([name, conn]) => ({
+            serverName: name,
+            connected: true,
+            toolCount: conn.tools.length,
+        }));
+    }
+    /**
+     * Whether at least one server is connected.
+     */
+    get isConnected() {
+        return this.connections.size > 0;
+    }
+    /**
+     * Get the number of connected servers.
+     */
+    get connectedCount() {
+        return this.connections.size;
+    }
+    // ─── Tool Adapter ─────────────────────────────────────────────────────────
+    /**
+     * Adapt an MCP SDK tool descriptor into the framework's Tool interface.
+     *
+     * The adapted tool's name is `{serverName}_{mcpToolName}` to avoid
+     * collisions between servers and with locally-registered tools.
+     *
+     * The `execute` function closes over the client instance and handles
+     * result content parsing (extracting text from MCP's Content[] array).
+     */
+    adaptTool(serverName, mcpTool, client) {
+        const prefixedName = `${serverName}_${mcpTool.name}`;
+        return {
+            name: prefixedName,
+            description: mcpTool.description ?? "",
+            parameters: (mcpTool.inputSchema ?? { type: "object", properties: {} }),
+            execute: async (args) => {
+                // Check connection is still alive
+                if (!this.connections.has(serverName)) {
+                    return `Error: MCP server "${serverName}" is no longer connected. Tool "${prefixedName}" is unavailable.`;
+                }
+                try {
+                    const result = await client.callTool({
+                        name: mcpTool.name,
+                        arguments: args,
+                    });
+                    // MCP results carry an array of content items (text, image, etc.)
+                    let output = "(MCP tool returned no content)";
+                    if (result.content && Array.isArray(result.content)) {
+                        const textParts = result.content
+                            .map((c) => (c.text ? c.text : JSON.stringify(c)))
+                            .filter(Boolean);
+                        if (textParts.length > 0) {
+                            output = textParts.join("\n");
+                        }
+                    }
+                    // Prefix with "Error:" so the framework's circuit-breaker /
+                    // retry-guidance path handles it correctly.
+                    if (result.isError) {
+                        return `Error: ${output}`;
+                    }
+                    return output;
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    return `Error executing MCP tool "${serverName}/${mcpTool.name}": ${message}`;
+                }
+            },
+        };
+    }
+}
+exports.McpClientManager = McpClientManager;
+//# sourceMappingURL=mcp-client-manager.js.map

package/dist/mcp/mcp-client-manager.js.map

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

package/dist/mcp/mcp-types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MCP (Model Context Protocol) type definitions.
+ *
+ * Users define MCP servers via `McpServerConfig`. The framework
+ * connects, discovers tools, adapts them, and registers with ToolRegistry.
+ */
+/**
+ * Configuration for connecting to an MCP server.
+ *
+ * Two mutually exclusive modes:
+ * - stdio: set `command` (optionally `args` and `env`)
+ * - SSE:   set `url`
+ *
+ * @example
+ * ```ts
+ * // stdio: local filesystem server
+ * { command: "npx", args: ["-y", "@modelcontextprotocol/server-filesystem", "."] }
+ *
+ * // SSE: remote server
+ * { url: "http://localhost:3001/sse" }
+ * ```
+ */
+export interface McpServerConfig {
+    /** Command for stdio transport (e.g., "npx", "uvx"). Exclusive with `url`. */
+    command?: string;
+    /** Arguments passed to the stdio command. */
+    args?: string[];
+    /** Environment variables injected into the stdio process. */
+    env?: Record<string, string>;
+    /**
+     * URL for SSE transport (e.g., "http://localhost:3000/sse").
+     * Exclusive with `command`.
+     */
+    url?: string;
+}
+/**
+ * Snapshot of a single MCP server's connection state.
+ */
+export interface McpConnectionStatus {
+    serverName: string;
+    connected: boolean;
+    toolCount: number;
+    error?: string;
+}
+/**
+ * Report from a failed connection attempt.
+ */
+export interface McpConnectionErrorReport {
+    serverName: string;
+    error: string;
+}
+/**
+ * Specialized error for MCP connection/issues.
+ */
+export declare class McpConnectionError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=mcp-types.d.ts.map

package/dist/mcp/mcp-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-types.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/mcp/mcp-types.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * MCP (Model Context Protocol) type definitions.
+ *
+ * Users define MCP servers via `McpServerConfig`. The framework
+ * connects, discovers tools, adapts them, and registers with ToolRegistry.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpConnectionError = void 0;
+/**
+ * Specialized error for MCP connection/issues.
+ */
+class McpConnectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "McpConnectionError";
+    }
+}
+exports.McpConnectionError = McpConnectionError;
+//# sourceMappingURL=mcp-types.js.map

package/dist/mcp/mcp-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-types.js","sourceRoot":"","sources":["../../src/mcp/mcp-types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAkDH;;GAEG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC"}

package/dist/memory/index.d.ts

@@ -0,0 +1,3 @@
+export { MemoryManager } from "./memory-manager";
+export type { Memory, MemoryType } from "./memory-manager";
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryManager = void 0;
+var memory_manager_1 = require("./memory-manager");
+Object.defineProperty(exports, "MemoryManager", { enumerable: true, get: function () { return memory_manager_1.MemoryManager; } });
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/dist/memory/memory-manager.d.ts

@@ -0,0 +1,119 @@
+/** Memory type. */
+export type MemoryType = "rule" | "project";
+/**
+ * A single memory entry.
+ *
+ * **Rule**: a constraint the user set — why they required it, and when it
+ * takes effect. Example: "Always use kebab-case for file names."
+ *
+ * **Project**: a fact or decision about the project — what happened, why
+ * (constraint / deadline that drove it), and how the agent should apply it.
+ * Example: "We switched from MySQL to PostgreSQL because of JSONB support."
+ */
+export interface Memory {
+    /** Slug (kebab-case, used as filename). */
+    name: string;
+    /** One-line summary shown in the index. */
+    description: string;
+    /** Memory type. */
+    type: MemoryType;
+    /** Markdown body. For rules: why + when. For projects: fact + why + how to apply. */
+    content: string;
+}
+/**
+ * Long-term memory manager (index + individual files).
+ *
+ * Storage layout:
+ * ```
+ * .memory/
+ *   MEMORY.md          ← index (200 lines + 25 KB dual limit)
+ *   <name>.md          ← individual memory files with frontmatter
+ * ```
+ *
+ * Usage:
+ * ```ts
+ * const mem = new MemoryManager({ storageDir: ".memory" });
+ * mem.add({ name: "use-kebab-case", description: "File naming convention",
+ *           type: "rule", content: "...why and when..." });
+ * // Later: inject into system prompt
+ * const hint = mem.buildPromptHint();
+ * ```
+ */
+export declare class MemoryManager {
+    private index;
+    private storageDir;
+    private indexFile;
+    private lastLoadedMtime;
+    constructor(storageDir?: string);
+    /**
+     * Add or update a memory entry.
+     *
+     * If a memory with the same `name` already exists it is overwritten.
+     * When the index exceeds the 200-line / 25 KB limit, the oldest entries
+     * are silently removed to make room.
+     */
+    add(memory: Memory): void;
+    /**
+     * Remove a memory by name.
+     */
+    remove(name: string): boolean;
+    /**
+     * Check if a memory exists by name.
+     */
+    has(name: string): boolean;
+    /**
+     * Get a single memory by name (loads full content from disk).
+     */
+    get(name: string): Memory | null;
+    /**
+     * Get all memories (loads full content from disk).
+     */
+    getAll(): Memory[];
+    /**
+     * Get memories by type.
+     */
+    getByType(type: MemoryType): Memory[];
+    /**
+     * Total number of memories.
+     */
+    get count(): number;
+    /**
+     * Build a compact system-prompt hint listing memory names + type badges.
+     *
+     * Full content is loaded on demand via the `recall` tool, keeping the
+     * system prompt lean. Each line is ~50 chars so the full index of 200
+     * entries stays under ~2500 tokens.
+     *
+     * The content is LLM-generated (via the `remember` tool), so it is
+     * wrapped with {@link wrapUntrusted} boundary markers and scanned for
+     * prompt-injection signatures before being returned. This prevents
+     * the LLM from accidentally poisoning its own system prompt via
+     * memory names.
+     */
+    buildPromptHint(): string;
+    /**
+     * Re-read the MEMORY.md index from disk if it was modified since the
+     * last load. Returns true when a reload occurred.
+     *
+     * Individual memory files are NOT reloaded — the index is lightweight,
+     * and full memory content is fetched on demand via the `recall` tool.
+     */
+    reloadIfChanged(): boolean;
+    private memoryPath;
+    private ensureDir;
+    private formatFile;
+    private loadFile;
+    private parseFile;
+    private persistIndex;
+    private loadIndex;
+    private parseIndex;
+    private inferType;
+    /**
+     * Silently remove the oldest entries until both the line and byte limits
+     * are satisfied. Index entries are ordered oldest-first, so we shift from
+     * the front until the computed index content fits.
+     */
+    private pruneIfNeeded;
+    private buildIndexContent;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAUA,mBAAmB;AACnB,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,WAAW,MAAM;IACrB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAa;gBAExB,UAAU,CAAC,EAAE,MAAM;IAS/B;;;;;;OAMG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAwBzB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAa7B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMhC;;OAEG;IACH,MAAM,IAAI,MAAM,EAAE;IASlB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE;IAIrC;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAID;;;;;;;;;;;;OAYG;IACH,eAAe,IAAI,MAAM;IAuBzB;;;;;;OAMG;IACH,eAAe,IAAI,OAAO;IAiB1B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,SAAS;IAOjB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,iBAAiB;CAO1B"}