@prestyj/cli 4.2.15

package/dist/core/extensions/types.d.ts

@@ -0,0 +1,19 @@
+import type { AgentTool } from "@prestyj/agent";
+import type { EventBus } from "../event-bus.js";
+import type { SettingsManager } from "../settings-manager.js";
+import type { SlashCommand } from "../slash-commands.js";
+export interface ExtensionContext {
+    eventBus: EventBus;
+    registerTool: (tool: AgentTool) => void;
+    registerSlashCommand: (command: SlashCommand) => void;
+    cwd: string;
+    settingsManager: SettingsManager;
+}
+export interface Extension {
+    name: string;
+    version?: string;
+    activate: (context: ExtensionContext) => void | Promise<void>;
+    deactivate?: () => void | Promise<void>;
+}
+export type ExtensionFactory = () => Extension;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/extensions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACxC,oBAAoB,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,SAAS,CAAC"}

package/dist/core/extensions/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/extensions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/extensions/types.ts"],"names":[],"mappings":""}

package/dist/core/index.d.ts

@@ -0,0 +1,14 @@
+export { EventBus, type BusEventMap } from "./event-bus.js";
+export { MODELS, getModel, getModelsForProvider, getDefaultModel, getContextWindow, type ModelInfo, } from "./model-registry.js";
+export { AuthStorage, NotLoggedInError } from "./auth-storage.js";
+export { SettingsManager, DEFAULT_SETTINGS, type Settings } from "./settings-manager.js";
+export { SessionManager, type SessionEntry, type MessageEntry, type SessionInfo, type SessionHeader, } from "./session-manager.js";
+export { AgentSession, type AgentSessionOptions, type AgentSessionState } from "./agent-session.js";
+export { SlashCommandRegistry, createBuiltinCommands, type SlashCommand, type SlashCommandContext, } from "./slash-commands.js";
+export { discoverSkills, parseSkillFile, formatSkillsForPrompt, type Skill } from "./skills.js";
+export { ExtensionLoader } from "./extensions/loader.js";
+export type { Extension, ExtensionContext, ExtensionFactory } from "./extensions/types.js";
+export { shouldCompact, compact, type CompactionResult } from "./compaction/compactor.js";
+export { initLogger, log, attachToEventBus, closeLogger } from "./logger.js";
+export { estimateTokens, estimateMessageTokens, estimateConversationTokens, } from "./compaction/token-estimator.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,MAAM,EACN,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,qBAAqB,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,13 @@
+export { EventBus } from "./event-bus.js";
+export { MODELS, getModel, getModelsForProvider, getDefaultModel, getContextWindow, } from "./model-registry.js";
+export { AuthStorage, NotLoggedInError } from "./auth-storage.js";
+export { SettingsManager, DEFAULT_SETTINGS } from "./settings-manager.js";
+export { SessionManager, } from "./session-manager.js";
+export { AgentSession } from "./agent-session.js";
+export { SlashCommandRegistry, createBuiltinCommands, } from "./slash-commands.js";
+export { discoverSkills, parseSkillFile, formatSkillsForPrompt } from "./skills.js";
+export { ExtensionLoader } from "./extensions/loader.js";
+export { shouldCompact, compact } from "./compaction/compactor.js";
+export { initLogger, log, attachToEventBus, closeLogger } from "./logger.js";
+export { estimateTokens, estimateMessageTokens, estimateConversationTokens, } from "./compaction/token-estimator.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,MAAM,EACN,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAiB,MAAM,uBAAuB,CAAC;AACzF,OAAO,EACL,cAAc,GAKf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAoD,MAAM,oBAAoB,CAAC;AACpG,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GAGtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,qBAAqB,EAAc,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAyB,MAAM,2BAA2B,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,26 @@
+import type { EventBus } from "./event-bus.js";
+type LogLevel = "INFO" | "ERROR" | "WARN";
+/**
+ * Initialize the debug logger. Opens the log file with truncation ('w' mode)
+ * and writes a startup header. No-op if already initialized.
+ */
+export declare function initLogger(filePath: string, meta?: {
+    version?: string;
+    provider?: string;
+    model?: string;
+    thinking?: string;
+}): void;
+/**
+ * Write a timestamped log line. No-op if logger is not initialized.
+ */
+export declare function log(level: LogLevel, category: string, message: string, data?: Record<string, unknown>): void;
+/**
+ * Subscribe to EventBus events and log them. Used by print/json modes.
+ */
+export declare function attachToEventBus(bus: EventBus): void;
+/**
+ * Write a shutdown line, close the file descriptor, and clean up subscriptions.
+ */
+export declare function closeLogger(): void;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,KAAK,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAK1C;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF,IAAI,CAeN;AAED;;GAEG;AACH,wBAAgB,GAAG,CACjB,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAgBN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CA2FpD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAalC"}

package/dist/core/logger.js

@@ -0,0 +1,132 @@
+import fs from "node:fs";
+let fd = null;
+let unsubscribers = [];
+/**
+ * Initialize the debug logger. Opens the log file with truncation ('w' mode)
+ * and writes a startup header. No-op if already initialized.
+ */
+export function initLogger(filePath, meta) {
+    if (fd !== null)
+        return;
+    try {
+        fd = fs.openSync(filePath, "w");
+    }
+    catch {
+        // Can't open log file — silently disable logging
+        return;
+    }
+    const parts = ["ezcoder"];
+    if (meta?.version)
+        parts[0] += ` v${meta.version}`;
+    parts.push("started");
+    if (meta?.provider)
+        parts.push(`provider=${meta.provider}`);
+    if (meta?.model)
+        parts.push(`model=${meta.model}`);
+    if (meta?.thinking)
+        parts.push(`thinking=${meta.thinking}`);
+    log("INFO", "startup", parts.join(" "));
+}
+/**
+ * Write a timestamped log line. No-op if logger is not initialized.
+ */
+export function log(level, category, message, data) {
+    if (fd === null)
+        return;
+    const ts = new Date().toISOString();
+    let line = `[${ts}] [${level}] [${category}] ${message}`;
+    if (data) {
+        const pairs = Object.entries(data)
+            .map(([k, v]) => `${k}=${typeof v === "string" ? v : JSON.stringify(v)}`)
+            .join(" ");
+        line += ` ${pairs}`;
+    }
+    line += "\n";
+    try {
+        fs.writeSync(fd, line);
+    }
+    catch {
+        // Write failed — don't crash
+    }
+}
+/**
+ * Subscribe to EventBus events and log them. Used by print/json modes.
+ */
+export function attachToEventBus(bus) {
+    const unsubs = [];
+    unsubs.push(bus.on("tool_call_start", ({ toolCallId, name }) => {
+        log("INFO", "tool", `Tool call started: ${name}`, { id: toolCallId });
+    }));
+    unsubs.push(bus.on("tool_call_end", ({ toolCallId, result: _result, isError, durationMs }) => {
+        const level = isError ? "ERROR" : "INFO";
+        log(level, "tool", `Tool call ended`, {
+            id: toolCallId,
+            duration: `${durationMs}ms`,
+            isError: String(isError),
+        });
+    }));
+    unsubs.push(bus.on("turn_end", ({ turn, stopReason, usage }) => {
+        log("INFO", "turn", `Turn ${turn} ended`, {
+            stopReason,
+            inputTokens: String(usage.inputTokens),
+            outputTokens: String(usage.outputTokens),
+            ...(usage.cacheRead != null && { cacheRead: String(usage.cacheRead) }),
+            ...(usage.cacheWrite != null && { cacheWrite: String(usage.cacheWrite) }),
+        });
+    }));
+    unsubs.push(bus.on("agent_done", ({ totalTurns, totalUsage }) => {
+        log("INFO", "agent", `Agent done`, {
+            totalTurns: String(totalTurns),
+            inputTokens: String(totalUsage.inputTokens),
+            outputTokens: String(totalUsage.outputTokens),
+            ...(totalUsage.cacheRead != null && { cacheRead: String(totalUsage.cacheRead) }),
+            ...(totalUsage.cacheWrite != null && { cacheWrite: String(totalUsage.cacheWrite) }),
+        });
+    }));
+    unsubs.push(bus.on("error", ({ error }) => {
+        log("ERROR", "error", error.message);
+    }));
+    unsubs.push(bus.on("session_start", ({ sessionId }) => {
+        log("INFO", "session", `Session started`, { sessionId });
+    }));
+    unsubs.push(bus.on("model_change", ({ provider, model }) => {
+        log("INFO", "model", `Model changed`, { provider, model });
+    }));
+    unsubs.push(bus.on("compaction_start", ({ messageCount }) => {
+        log("INFO", "compaction", `Compaction started`, { messageCount: String(messageCount) });
+    }));
+    unsubs.push(bus.on("compaction_end", ({ originalCount, newCount }) => {
+        log("INFO", "compaction", `Compaction ended`, {
+            originalCount: String(originalCount),
+            newCount: String(newCount),
+        });
+    }));
+    unsubs.push(bus.on("user_input", ({ content }) => {
+        const truncated = content.length > 100 ? content.slice(0, 100) + "..." : content;
+        log("INFO", "input", `User input: ${truncated}`);
+    }));
+    unsubs.push(bus.on("slash_command", ({ name, args }) => {
+        log("INFO", "command", `Slash command: /${name}${args ? ` ${args}` : ""}`);
+    }));
+    unsubscribers.push(...unsubs);
+}
+/**
+ * Write a shutdown line, close the file descriptor, and clean up subscriptions.
+ */
+export function closeLogger() {
+    if (fd === null)
+        return;
+    log("INFO", "shutdown", "ezcoder shutting down");
+    try {
+        fs.closeSync(fd);
+    }
+    catch {
+        // Ignore close errors
+    }
+    fd = null;
+    for (const unsub of unsubscribers) {
+        unsub();
+    }
+    unsubscribers = [];
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

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

@@ -0,0 +1,35 @@
+import type { AgentTool } from "@prestyj/agent";
+import type { MCPServerConfig } from "./types.js";
+export declare class MCPClientManager {
+    private servers;
+    private pending;
+    /**
+     * Connect servers that can be connected eagerly (non-lazy),
+     * and register lazy placeholder tools for the rest.
+     *
+     * Servers with `lazy: true` in their config (or all servers by default
+     * when using `registerLazy`) won't connect until a tool is actually invoked.
+     */
+    connectAll(configs: MCPServerConfig[]): Promise<AgentTool[]>;
+    /**
+     * Register servers lazily — no connections are made until a tool is invoked.
+     * Returns placeholder tools that trigger connection on first execute().
+     */
+    registerLazy(configs: MCPServerConfig[]): AgentTool[];
+    /**
+     * Create a placeholder tool for a lazy server.
+     * The tool name uses the server name, and on first call it connects,
+     * discovers the real tools, and delegates to the right one.
+     */
+    private createLazyTool;
+    /**
+     * Ensure a pending server is connected. Uses a shared promise to avoid
+     * duplicate connections if multiple calls arrive concurrently.
+     */
+    private ensureConnected;
+    private connectPending;
+    private connectServer;
+    private createConnection;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAsBlD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAuB;IAEtC;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAsBlE;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,SAAS,EAAE;IAmBrD;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAyDtB;;;OAGG;YACW,eAAe;YASf,cAAc;YAqBd,aAAa;YA6Cb,gBAAgB;IA4CxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAW/B"}

package/dist/core/mcp/client.js

@@ -0,0 +1,233 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { z } from "zod";
+import { log } from "../logger.js";
+export class MCPClientManager {
+    servers = [];
+    pending = [];
+    /**
+     * Connect servers that can be connected eagerly (non-lazy),
+     * and register lazy placeholder tools for the rest.
+     *
+     * Servers with `lazy: true` in their config (or all servers by default
+     * when using `registerLazy`) won't connect until a tool is actually invoked.
+     */
+    async connectAll(configs) {
+        const enabled = configs.filter((c) => c.enabled !== false);
+        if (enabled.length === 0)
+            return [];
+        const results = await Promise.allSettled(enabled.map((c) => this.connectServer(c)));
+        const tools = [];
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            if (result.status === "fulfilled") {
+                tools.push(...result.value);
+            }
+            else {
+                log("WARN", "mcp", `Failed to connect to MCP server "${enabled[i].name}"`, {
+                    error: String(result.reason),
+                });
+            }
+        }
+        log("INFO", "mcp", `Connected ${this.servers.length} MCP server(s), ${tools.length} tool(s)`);
+        return tools;
+    }
+    /**
+     * Register servers lazily — no connections are made until a tool is invoked.
+     * Returns placeholder tools that trigger connection on first execute().
+     */
+    registerLazy(configs) {
+        const enabled = configs.filter((c) => c.enabled !== false);
+        if (enabled.length === 0)
+            return [];
+        const tools = [];
+        for (const config of enabled) {
+            const pending = { config };
+            this.pending.push(pending);
+            tools.push(this.createLazyTool(config, pending));
+        }
+        log("INFO", "mcp", `Registered ${enabled.length} lazy MCP server(s) (will connect on first use)`);
+        return tools;
+    }
+    /**
+     * Create a placeholder tool for a lazy server.
+     * The tool name uses the server name, and on first call it connects,
+     * discovers the real tools, and delegates to the right one.
+     */
+    createLazyTool(config, pending) {
+        const toolName = `mcp__${config.name}`;
+        return {
+            name: toolName,
+            description: `MCP server "${config.name}" (connects on first use). Call with {"tool": "<tool_name>", ...args} to invoke a tool on this server.`,
+            parameters: z.record(z.string(), z.unknown()),
+            rawInputSchema: {
+                type: "object",
+                properties: {
+                    tool: { type: "string", description: "The tool name to call on this MCP server" },
+                },
+                additionalProperties: true,
+            },
+            execute: async (args) => {
+                try {
+                    await this.ensureConnected(pending);
+                    const callArgs = args;
+                    const targetTool = callArgs.tool ?? "";
+                    if (!targetTool) {
+                        // List available tools
+                        const toolList = pending.tools ? [...pending.tools.keys()].join(", ") : "none";
+                        return `Available tools on "${config.name}": ${toolList}`;
+                    }
+                    // Find the original tool name
+                    const originalName = pending.tools?.get(targetTool) ?? targetTool;
+                    const { tool: _, ...toolArgs } = callArgs;
+                    const result = await pending.client.callTool({ name: originalName, arguments: toolArgs }, undefined, { timeout: config.timeout ?? 60_000 });
+                    if (!("content" in result) || !Array.isArray(result.content)) {
+                        return "(empty response)";
+                    }
+                    const texts = [];
+                    for (const item of result.content) {
+                        if (item != null &&
+                            typeof item === "object" &&
+                            "text" in item &&
+                            typeof item.text === "string") {
+                            texts.push(item.text);
+                        }
+                    }
+                    return texts.join("\n") || "(empty response)";
+                }
+                catch (err) {
+                    return `MCP tool error: ${err instanceof Error ? err.message : String(err)}`;
+                }
+            },
+        };
+    }
+    /**
+     * Ensure a pending server is connected. Uses a shared promise to avoid
+     * duplicate connections if multiple calls arrive concurrently.
+     */
+    async ensureConnected(pending) {
+        if (pending.client)
+            return; // Already connected
+        if (!pending.connectPromise) {
+            pending.connectPromise = this.connectPending(pending);
+        }
+        await pending.connectPromise;
+    }
+    async connectPending(pending) {
+        const config = pending.config;
+        const timeout = config.timeout ?? 30_000;
+        log("INFO", "mcp", `Lazy-connecting MCP server "${config.name}"...`);
+        const { client, transport } = await this.createConnection(config, timeout);
+        pending.client = client;
+        pending.transport = transport;
+        this.servers.push({ name: config.name, client, transport });
+        const { tools } = await client.listTools(undefined, { timeout });
+        pending.tools = new Map();
+        for (const tool of tools) {
+            pending.tools.set(tool.name, tool.name);
+        }
+        log("INFO", "mcp", `Lazy-connected MCP server "${config.name}" with ${tools.length} tool(s)`);
+    }
+    async connectServer(config) {
+        const timeout = config.timeout ?? 30_000;
+        const { client, transport } = await this.createConnection(config, timeout);
+        this.servers.push({ name: config.name, client, transport });
+        const { tools } = await client.listTools(undefined, { timeout });
+        return tools.map((tool) => {
+            const toolName = `mcp__${config.name}__${tool.name}`;
+            return {
+                name: toolName,
+                description: tool.description ?? "",
+                parameters: z.record(z.string(), z.unknown()),
+                rawInputSchema: tool.inputSchema,
+                execute: async (args) => {
+                    try {
+                        const result = await client.callTool({ name: tool.name, arguments: args }, undefined, { timeout: config.timeout ?? 60_000 });
+                        if (!("content" in result) || !Array.isArray(result.content)) {
+                            return "(empty response)";
+                        }
+                        const texts = [];
+                        for (const item of result.content) {
+                            if (item != null &&
+                                typeof item === "object" &&
+                                "text" in item &&
+                                typeof item.text === "string") {
+                                texts.push(item.text);
+                            }
+                        }
+                        return texts.join("\n") || "(empty response)";
+                    }
+                    catch (err) {
+                        return `MCP tool error: ${err instanceof Error ? err.message : String(err)}`;
+                    }
+                },
+            };
+        });
+    }
+    async createConnection(config, timeout) {
+        let client;
+        let transport;
+        if (config.command) {
+            transport = new StdioClientTransport({
+                command: config.command,
+                args: config.args,
+                env: { ...process.env, ...config.env },
+                stderr: "pipe",
+            });
+            client = new Client({ name: "ezcoder", version: "1.0.0" });
+            await client.connect(transport, { timeout });
+        }
+        else {
+            const url = new URL(config.url);
+            const reqInit = config.headers ? { headers: config.headers } : undefined;
+            try {
+                transport = new StreamableHTTPClientTransport(url, {
+                    requestInit: reqInit,
+                });
+                client = new Client({ name: "ezcoder", version: "1.0.0" });
+                await client.connect(transport, { timeout });
+            }
+            catch (streamableErr) {
+                log("INFO", "mcp", `StreamableHTTP failed for "${config.name}", trying SSE fallback`, {
+                    error: String(streamableErr),
+                });
+                transport = new SSEClientTransport(url, {
+                    eventSourceInit: config.headers
+                        ? { fetch: createHeaderFetch(config.headers) }
+                        : undefined,
+                    requestInit: reqInit,
+                });
+                client = new Client({ name: "ezcoder", version: "1.0.0" });
+                await client.connect(transport, { timeout });
+            }
+        }
+        return { client, transport };
+    }
+    async dispose() {
+        for (const server of this.servers) {
+            try {
+                await server.client.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+        }
+        this.servers = [];
+        this.pending = [];
+    }
+}
+/**
+ * Create a custom fetch wrapper that injects extra headers into every request.
+ * Used for SSEClientTransport's eventSourceInit to pass auth headers
+ * on the initial SSE GET connection (which doesn't use requestInit).
+ */
+function createHeaderFetch(extraHeaders) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return (url, init) => {
+        const existing = (init?.headers ?? {});
+        return fetch(url, { ...init, headers: { ...existing, ...extraHeaders } });
+    };
+}
+//# sourceMappingURL=client.js.map

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

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

package/dist/core/mcp/defaults.d.ts

@@ -0,0 +1,9 @@
+import type { Provider } from "@prestyj/ai";
+import type { MCPServerConfig } from "./types.js";
+export declare const DEFAULT_MCP_SERVERS: MCPServerConfig[];
+/**
+ * Get MCP servers for a specific provider.
+ * GLM models get Z.AI MCP servers for vision, web search, web reading, and GitHub exploration.
+ */
+export declare function getMCPServers(provider: Provider, apiKey?: string): MCPServerConfig[];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/core/mcp/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,mBAAmB,EAAE,eAAe,EAEhD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAgDpF"}

package/dist/core/mcp/defaults.js

@@ -0,0 +1,51 @@
+export const DEFAULT_MCP_SERVERS = [
+    { name: "grep", url: "https://mcp.grep.app" },
+];
+/**
+ * Get MCP servers for a specific provider.
+ * GLM models get Z.AI MCP servers for vision, web search, web reading, and GitHub exploration.
+ */
+export function getMCPServers(provider, apiKey) {
+    const servers = [...DEFAULT_MCP_SERVERS];
+    if (provider === "glm" && apiKey) {
+        const zaiAuth = { Authorization: `Bearer ${apiKey}` };
+        // Vision (image support via stdio MCP server) — lazy to avoid rate limits
+        servers.push({
+            name: "zai_vision",
+            command: "npx",
+            args: ["-y", "@z_ai/mcp-server"],
+            env: {
+                Z_AI_API_KEY: apiKey,
+                Z_AI_MODE: "ZAI",
+            },
+            timeout: 60_000,
+            lazy: true,
+        });
+        // Web search — lazy to avoid rate limits
+        servers.push({
+            name: "zai_web_search",
+            url: "https://api.z.ai/api/mcp/web_search_prime/mcp",
+            headers: zaiAuth,
+            timeout: 60_000,
+            lazy: true,
+        });
+        // Web reader (full-page content extraction) — lazy to avoid rate limits
+        servers.push({
+            name: "zai_web_reader",
+            url: "https://api.z.ai/api/mcp/web_reader/mcp",
+            headers: zaiAuth,
+            timeout: 60_000,
+            lazy: true,
+        });
+        // GitHub repository exploration — lazy to avoid rate limits
+        servers.push({
+            name: "zai_zread",
+            url: "https://api.z.ai/api/mcp/zread/mcp",
+            headers: zaiAuth,
+            timeout: 60_000,
+            lazy: true,
+        });
+    }
+    return servers;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/core/mcp/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/core/mcp/defaults.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,EAAE;CAC9C,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB,EAAE,MAAe;IAC/D,MAAM,OAAO,GAAG,CAAC,GAAG,mBAAmB,CAAC,CAAC;IAEzC,IAAI,QAAQ,KAAK,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,CAAC;QAEtD,0EAA0E;QAC1E,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC;YAChC,GAAG,EAAE;gBACH,YAAY,EAAE,MAAM;gBACpB,SAAS,EAAE,KAAK;aACjB;YACD,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,yCAAyC;QACzC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,gBAAgB;YACtB,GAAG,EAAE,+CAA+C;YACpD,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,wEAAwE;QACxE,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,gBAAgB;YACtB,GAAG,EAAE,yCAAyC;YAC9C,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QAEH,4DAA4D;QAC5D,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,WAAW;YACjB,GAAG,EAAE,oCAAoC;YACzC,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,4 @@
+export { MCPClientManager } from "./client.js";
+export { DEFAULT_MCP_SERVERS, getMCPServers } from "./defaults.js";
+export type { MCPServerConfig } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/mcp/index.js

@@ -0,0 +1,3 @@
+export { MCPClientManager } from "./client.js";
+export { DEFAULT_MCP_SERVERS, getMCPServers } from "./defaults.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,17 @@
+export interface MCPServerConfig {
+    name: string;
+    /** Streamable HTTP endpoint URL */
+    url?: string;
+    headers?: Record<string, string>;
+    /** Stdio server: command to spawn */
+    command?: string;
+    /** Stdio server: command arguments */
+    args?: string[];
+    /** Stdio server: environment variables */
+    env?: Record<string, string>;
+    timeout?: number;
+    enabled?: boolean;
+    /** If true, server connects lazily on first tool invocation instead of at startup */
+    lazy?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map