@adhd/agent-mcp 2.0.1 → 2.1.1

package/src/clients/registry.js

@@ -1,164 +0,0 @@
-import { logger } from "../logger.js";
-import { InProcessMcpClient } from "./in-process.js";
-import { HttpMcpClient, SseMcpClient } from "./http-client.js";
-import { StdioMcpClient } from "./stdio-client.js";
-import { TOOL_NAME_SEPARATOR, normalizeToolName } from "./tool-naming.js";
-/**
- * McpClientRegistry — per-task lifetime.
- *
- * Created fresh for each task() call and torn down in the Orchestrator's
- * finally block via closeAll(). Never reused across tasks.
- *
- * Self-referential detection (routes to InProcessMcpClient):
- *   1. Key === "agent-mcp" (always applies)
- *   2. URL matches selfUrl (only when selfUrl is defined — http/sse transport)
- *      When TRANSPORT=stdio, selfUrl is undefined and only condition 1 applies.
- */
-export class McpClientRegistry {
-    mcpServers;
-    selfUrl;
-    inProcessDescriptors;
-    inProcessHandler;
-    context;
-    clients = new Map();
-    connectPromises = new Map();
-    // advertised tool name (and its normalized form) → real { server, tool }.
-    // Populated by listAllTools(); lets resolveToolName() recover the real target
-    // even when a model rewrites '-' → '_' in the name it calls back with.
-    toolTargets = new Map();
-    constructor(mcpServers, selfUrl, inProcessDescriptors, inProcessHandler, context) {
-        this.mcpServers = mcpServers;
-        this.selfUrl = selfUrl;
-        this.inProcessDescriptors = inProcessDescriptors;
-        this.inProcessHandler = inProcessHandler;
-        this.context = context;
-    }
-    isSelfReferential(name, config) {
-        if (name === "agent-mcp")
-            return true;
-        if (this.selfUrl &&
-            (config.transport === "http" || config.transport === "sse") &&
-            config.url === this.selfUrl) {
-            return true;
-        }
-        return false;
-    }
-    /**
-     * Map a (possibly model-normalized) server name back to a configured key.
-     * OpenAI-compatible/local models rewrite '-' → '_', so a tool call to
-     * 'agent_mcp__…' must still resolve to the configured 'agent-mcp' server.
-     */
-    resolveServerName(name) {
-        if (this.mcpServers[name])
-            return name;
-        const norm = normalizeToolName(name);
-        return Object.keys(this.mcpServers).find((k) => normalizeToolName(k) === norm) ?? name;
-    }
-    async getOrCreateClient(rawName) {
-        const name = this.resolveServerName(rawName);
-        const existing = this.clients.get(name);
-        if (existing)
-            return existing;
-        const config = this.mcpServers[name];
-        if (!config) {
-            throw new Error(`No MCP server config found for server: '${rawName}'`);
-        }
-        if (this.isSelfReferential(name, config)) {
-            const client = new InProcessMcpClient(this.inProcessDescriptors, this.inProcessHandler, this.context);
-            this.clients.set(name, client);
-            return client;
-        }
-        // Create and connect the appropriate transport client
-        let connectPromise = this.connectPromises.get(name);
-        if (connectPromise) {
-            await connectPromise;
-            return this.clients.get(name);
-        }
-        let client;
-        if (config.transport === "stdio") {
-            client = new StdioMcpClient(name, config);
-        }
-        else if (config.transport === "http") {
-            client = new HttpMcpClient(name, config);
-        }
-        else if (config.transport === "sse") {
-            client = new SseMcpClient(name, config);
-        }
-        else {
-            const exhaustive = config;
-            throw new Error(`Unknown MCP transport: ${exhaustive.transport}`);
-        }
-        connectPromise = client.connect().then(() => {
-            this.clients.set(name, client);
-            logger.debug({ server: name }, "MCP client connected");
-        });
-        this.connectPromises.set(name, connectPromise);
-        await connectPromise;
-        return this.clients.get(name);
-    }
-    /** Get a client for a specific server, connecting lazily if needed */
-    async getClient(name) {
-        return this.getOrCreateClient(name);
-    }
-    /**
-     * List all tools across all configured servers.
-     * Prefixes each tool name with "<server>__<tool>" for disambiguation.
-     */
-    async listAllTools() {
-        const allTools = [];
-        for (const serverName of Object.keys(this.mcpServers)) {
-            try {
-                const client = await this.getOrCreateClient(serverName);
-                const tools = await client.listTools();
-                for (const tool of tools) {
-                    const advertised = `${serverName}${TOOL_NAME_SEPARATOR}${tool.name}`;
-                    const target = { server: serverName, tool: tool.name };
-                    // Index both the advertised name and its normalized form so a
-                    // model that rewrites '-' → '_' still resolves to the real target.
-                    this.toolTargets.set(advertised, target);
-                    this.toolTargets.set(normalizeToolName(advertised), target);
-                    allTools.push({ ...tool, name: advertised });
-                }
-            }
-            catch (error) {
-                logger.warn({ server: serverName, error }, "Failed to list tools from MCP server");
-            }
-        }
-        return allTools;
-    }
-    /**
-     * Resolve a tool name AS RETURNED BY A MODEL back to its real { server, tool }.
-     * Tries the exact advertised name, then the normalized form (handles models
-     * that rewrite '-' → '_'), then falls back to a literal `__` split for names
-     * the registry never advertised (preserves prior behavior).
-     */
-    resolveToolName(advertised) {
-        const hit = this.toolTargets.get(advertised) ??
-            this.toolTargets.get(normalizeToolName(advertised));
-        if (hit)
-            return hit;
-        const i = advertised.indexOf(TOOL_NAME_SEPARATOR);
-        return i === -1
-            ? { server: advertised, tool: advertised }
-            : {
-                server: advertised.slice(0, i),
-                tool: advertised.slice(i + TOOL_NAME_SEPARATOR.length),
-            };
-    }
-    /** Tear down all clients — called from Orchestrator's finally block */
-    async closeAll() {
-        const closePromises = Array.from(this.clients.entries()).map(async ([name, client]) => {
-            try {
-                await client.close();
-                logger.debug({ server: name }, "MCP client closed");
-            }
-            catch (error) {
-                logger.warn({ server: name, error }, "Error closing MCP client");
-            }
-        });
-        await Promise.allSettled(closePromises);
-        this.clients.clear();
-        this.connectPromises.clear();
-    }
-}
-//# sourceMappingURL=registry.js.map

package/src/clients/registry.js.map

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

package/src/clients/stdio-client.d.ts

@@ -1,16 +0,0 @@
-import type { ToolDefinition } from "../providers/types.js";
-import type { McpStdioConfig } from "../validation/index.js";
-import type { IMcpClient } from "./types.js";
-export declare class StdioMcpClient implements IMcpClient {
-    private readonly serverName;
-    private readonly config;
-    private client;
-    private transport;
-    private childProcess;
-    constructor(serverName: string, config: McpStdioConfig);
-    connect(): Promise<void>;
-    listTools(): Promise<ToolDefinition[]>;
-    callTool(toolName: string, args: unknown, callerSignal?: AbortSignal): Promise<unknown>;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=stdio-client.d.ts.map

package/src/clients/stdio-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stdio-client.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/stdio-client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAAa,cAAe,YAAW,UAAU;IAMzC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAN3B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,YAAY,CAA6B;gBAG5B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc;IAGrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCxB,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAgBtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAgCvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB/B"}

package/src/clients/stdio-client.js

@@ -1,97 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { logger } from "../logger.js";
-import { config } from "../config.js";
-import { ToolError } from "../validation/errors.js";
-export class StdioMcpClient {
-    serverName;
-    config;
-    client = null;
-    transport = null;
-    childProcess = null;
-    constructor(serverName, config) {
-        this.serverName = serverName;
-        this.config = config;
-    }
-    async connect() {
-        const transport = new StdioClientTransport({
-            command: this.config.command,
-            args: this.config.args ?? [],
-            env: {
-                ...config.subprocessEnv(),
-                ...this.config.env,
-            },
-        });
-        this.transport = transport;
-        // Capture child process reference for lifecycle management.
-        // The StdioClientTransport exposes it after start().
-        const client = new Client({ name: "agent-mcp-client", version: "1.0.0" }, { capabilities: {} });
-        this.client = client;
-        await client.connect(transport);
-        // Attach exit handler to the underlying child process.
-        // StdioClientTransport exposes `process` after connect().
-        const childProc = transport.process;
-        if (childProc) {
-            this.childProcess = childProc;
-            childProc.on("exit", (code, signal) => {
-                logger.warn({
-                    server: this.serverName,
-                    exitCode: code,
-                    signal,
-                }, "MCP child process exited unexpectedly");
-            });
-        }
-    }
-    async listTools() {
-        if (!this.client) {
-            throw new ToolError("MCP_CLIENT_ERROR", `Client '${this.serverName}' not connected`);
-        }
-        const response = await this.client.listTools();
-        return response.tools.map(tool => ({
-            name: tool.name,
-            description: tool.description ?? "",
-            inputSchema: tool.inputSchema ?? {
-                type: "object",
-                properties: {},
-            },
-        }));
-    }
-    async callTool(toolName, args, callerSignal) {
-        if (!this.client) {
-            throw new ToolError("MCP_CLIENT_ERROR", `Client '${this.serverName}' not connected`);
-        }
-        // Compose the caller's cancellation/timeout signal (DEBT-003 — lets a
-        // task cancel interrupt this in-flight call) with the client-level
-        // per-call timeout. Either may fire first.
-        const timeoutSignal = this.config.timeoutMs
-            ? AbortSignal.timeout(this.config.timeoutMs)
-            : undefined;
-        const signal = callerSignal && timeoutSignal
-            ? AbortSignal.any([callerSignal, timeoutSignal])
-            : (callerSignal ?? timeoutSignal);
-        const result = await this.client.callTool({ name: toolName, arguments: args }, undefined, signal ? { signal } : undefined);
-        if (result.isError) {
-            throw new ToolError("MCP_CLIENT_ERROR", `Tool '${toolName}' on server '${this.serverName}' returned an error: ${JSON.stringify(result.content)}`);
-        }
-        return result.content;
-    }
-    async close() {
-        try {
-            await this.client?.close();
-        }
-        catch {
-            // ignore close errors
-        }
-        if (this.childProcess && !this.childProcess.killed) {
-            this.childProcess.kill("SIGTERM");
-            // Force-kill after 5 seconds if still alive
-            const killTimer = setTimeout(() => {
-                if (this.childProcess && !this.childProcess.killed) {
-                    this.childProcess.kill("SIGKILL");
-                }
-            }, 5_000);
-            killTimer.unref();
-        }
-    }
-}
-//# sourceMappingURL=stdio-client.js.map

package/src/clients/stdio-client.js.map

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

package/src/clients/tool-naming.d.ts

@@ -1,44 +0,0 @@
-/**
- * Tool-name encoding shared across the registry and the orchestrator.
- *
- * Tools are advertised to the model as `<server>__<tool>`. Many OpenAI-compatible
- * and local models (e.g. LM Studio / qwen) restrict function names to
- * `[A-Za-z0-9_]` and silently rewrite other characters — notably `-` → `_` — so
- * an advertised `agent-mcp__agent` comes back from the model as
- * `agent_mcp__agent`. A literal lookup then fails ("No MCP server config found
- * for server: 'agent_mcp'"), which breaks recursion (the `agent-mcp` key) and any
- * MCP server whose name contains a hyphen. Anthropic preserves the name, so this
- * only bites the OpenAI-compatible providers — but the round-trip must be robust
- * for ALL of them.
- *
- * The fix: index both the advertised name and its normalized form, and normalize
- * the model's returned name the same way before resolving.
- */
-export declare const TOOL_NAME_SEPARATOR = "__";
-/** Normalize a tool name to the charset models restrict function names to. */
-export declare function normalizeToolName(name: string): string;
-export interface ResolvedToolName {
-    server: string;
-    tool: string;
-}
-/**
- * Resolve a tool name AS RETURNED BY A MODEL into { server, tool }.
- *
- * - A qualified `<server>__<tool>` name splits on the separator (prior behavior).
- * - A **bare** `<tool>` name (no separator) is resolved against the tool names the
- *   model was actually advertised: if exactly one advertised tool has that
- *   tool-part it is used; if several do, an actionable error lists the qualified
- *   candidates; if none do, it falls back to a literal split so downstream
- *   "unknown tool / no server config" handling still applies.
- *
- * Background (BACKLOG DEBT-004): capable models frequently emit the bare tool
- * name (`agent` / `task`) instead of the advertised `agent-mcp__agent`, which used
- * to hard-fail the whole task with "Invalid tool name (missing server prefix)".
- * Since the separator is unambiguous in advertised names, a bare name that maps to
- * exactly one advertised tool can be resolved deterministically.
- *
- * @param rawName    the tool name the model returned
- * @param advertised the advertised tool names the model was given (`<server>__<tool>`)
- */
-export declare function resolveToolCallName(rawName: string, advertised?: readonly string[]): ResolvedToolName;
-//# sourceMappingURL=tool-naming.d.ts.map

package/src/clients/tool-naming.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-naming.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/tool-naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB;AAUD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,SAAS,MAAM,EAAO,GAAG,gBAAgB,CAkBzG"}

package/src/clients/tool-naming.js

@@ -1,65 +0,0 @@
-/**
- * Tool-name encoding shared across the registry and the orchestrator.
- *
- * Tools are advertised to the model as `<server>__<tool>`. Many OpenAI-compatible
- * and local models (e.g. LM Studio / qwen) restrict function names to
- * `[A-Za-z0-9_]` and silently rewrite other characters — notably `-` → `_` — so
- * an advertised `agent-mcp__agent` comes back from the model as
- * `agent_mcp__agent`. A literal lookup then fails ("No MCP server config found
- * for server: 'agent_mcp'"), which breaks recursion (the `agent-mcp` key) and any
- * MCP server whose name contains a hyphen. Anthropic preserves the name, so this
- * only bites the OpenAI-compatible providers — but the round-trip must be robust
- * for ALL of them.
- *
- * The fix: index both the advertised name and its normalized form, and normalize
- * the model's returned name the same way before resolving.
- */
-export const TOOL_NAME_SEPARATOR = "__";
-/** Normalize a tool name to the charset models restrict function names to. */
-export function normalizeToolName(name) {
-    return name.replace(/[^A-Za-z0-9_]/g, "_");
-}
-/** Split a name on the first separator into { server, tool } (no resolution). */
-function splitToolName(name) {
-    const i = name.indexOf(TOOL_NAME_SEPARATOR);
-    return i === -1
-        ? { server: name, tool: name }
-        : { server: name.slice(0, i), tool: name.slice(i + TOOL_NAME_SEPARATOR.length) };
-}
-/**
- * Resolve a tool name AS RETURNED BY A MODEL into { server, tool }.
- *
- * - A qualified `<server>__<tool>` name splits on the separator (prior behavior).
- * - A **bare** `<tool>` name (no separator) is resolved against the tool names the
- *   model was actually advertised: if exactly one advertised tool has that
- *   tool-part it is used; if several do, an actionable error lists the qualified
- *   candidates; if none do, it falls back to a literal split so downstream
- *   "unknown tool / no server config" handling still applies.
- *
- * Background (BACKLOG DEBT-004): capable models frequently emit the bare tool
- * name (`agent` / `task`) instead of the advertised `agent-mcp__agent`, which used
- * to hard-fail the whole task with "Invalid tool name (missing server prefix)".
- * Since the separator is unambiguous in advertised names, a bare name that maps to
- * exactly one advertised tool can be resolved deterministically.
- *
- * @param rawName    the tool name the model returned
- * @param advertised the advertised tool names the model was given (`<server>__<tool>`)
- */
-export function resolveToolCallName(rawName, advertised = []) {
-    if (rawName.includes(TOOL_NAME_SEPARATOR))
-        return splitToolName(rawName);
-    const norm = normalizeToolName(rawName);
-    const candidates = Array.from(new Set(advertised)).filter((a) => {
-        const { tool } = splitToolName(a);
-        return tool === rawName || normalizeToolName(tool) === norm;
-    });
-    if (candidates.length === 1)
-        return splitToolName(candidates[0]);
-    if (candidates.length > 1) {
-        throw new Error(`Ambiguous tool name '${rawName}': multiple servers expose it — qualify with a server prefix, one of: ${candidates.join(", ")}`);
-    }
-    // No advertised match — preserve prior split (server = tool = rawName); the
-    // registry then surfaces a normal "no server config" / unknown-tool error.
-    return splitToolName(rawName);
-}
-//# sourceMappingURL=tool-naming.js.map

package/src/clients/tool-naming.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-naming.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/tool-naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAOD,iFAAiF;AACjF,SAAS,aAAa,CAAC,IAAY;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,CAAC;QACX,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QAC9B,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;AACzF,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,aAAgC,EAAE;IACnF,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;IAEzE,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5D,MAAM,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,IAAI,KAAK,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACX,wBAAwB,OAAO,yEAAyE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClI,CAAC;IACN,CAAC;IACD,4EAA4E;IAC5E,2EAA2E;IAC3E,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/src/clients/types.d.ts

@@ -1,18 +0,0 @@
-import type { ToolDefinition } from "../providers/types.js";
-export interface IMcpClient {
-    /** Returns all tools advertised by this MCP server */
-    listTools(): Promise<ToolDefinition[]>;
-    /**
-     * Call a single tool on this server.
-     * @param toolName  the tool name (without server prefix)
-     * @param args      the arguments to pass
-     * @param signal    optional abort signal — when the task is cancelled (or
-     *                  times out) this fires, so an in-flight tool call is
-     *                  interrupted instead of running to completion. Composed
-     *                  with any client-level timeout.
-     */
-    callTool(toolName: string, args: unknown, signal?: AbortSignal): Promise<unknown>;
-    /** Tear down the client (kill child processes, close connections) */
-    close(): Promise<void>;
-}
-//# sourceMappingURL=types.d.ts.map

package/src/clients/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,UAAU;IACvB,sDAAsD;IACtD,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElF,qEAAqE;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/src/clients/types.js

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

package/src/clients/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/clients/types.ts"],"names":[],"mappings":""}

package/src/engine/dag-engine.d.ts

@@ -1,62 +0,0 @@
-import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
-import type { TaskStore } from "../store/task-store.js";
-import type { BackgroundQueue } from "./queue.js";
-/**
- * DagEngine manages task dependency resolution.
- *
- * Two public methods:
- * - `validateNoCycle()` — synchronous BFS cycle check; called BEFORE row insert.
- * - `dispatchReady()` — post-terminal fan-in dispatch; called in the queue runFn
- *   `finally` block so it fires on every terminal event (completed/failed/cancelled).
- *
- * The `dispatchFn` is injected at server startup (built in src/index.ts) to avoid
- * circular imports: DagEngine must NOT import from tools/task.ts.
- */
-export declare class DagEngine {
-    private readonly db;
-    private readonly queue;
-    private readonly taskStore;
-    /**
-     * Injected at server startup to avoid circular imports with tools/task.ts.
-     * Signature: (taskId: string) => Promise<void>
-     * Built in index.ts by closing over the TaskDeps.
-     */
-    private readonly dispatchFn;
-    constructor(db: BetterSQLite3Database<Record<string, never>>, queue: BackgroundQueue, taskStore: TaskStore, 
-    /**
-     * Injected at server startup to avoid circular imports with tools/task.ts.
-     * Signature: (taskId: string) => Promise<void>
-     * Built in index.ts by closing over the TaskDeps.
-     */
-    dispatchFn: (taskId: string) => Promise<void>);
-    /**
-     * BFS cycle detection. Call BEFORE inserting the new task row.
-     *
-     * Walks the existing dependency graph upward from each member of `dependsOn`.
-     * If `newTaskId` appears as an ancestor, adding it would create a cycle.
-     *
-     * Throws ToolError("VALIDATION_ERROR") if a cycle is detected.
-     * Does NOT write any rows — purely a read operation.
-     *
-     * Invariant: [inv:cycle-check-synchronous]
-     */
-    validateNoCycle(newTaskId: string, dependsOn: string[]): void;
-    /**
-     * Called after a task reaches a terminal state (completed/failed/cancelled).
-     *
-     * Scans all `waiting` tasks for those that include `completedTaskId` in their
-     * `depends_on`. For each:
-     *   - If all deps are in a terminal state, evaluate `on_upstream_failure`:
-     *     - "fail" (default): mark the downstream as failed immediately.
-     *     - "skip": dispatch anyway; only include completed upstreams in `inputs`.
-     *
-     * Uses optimistic locking (`AND status='waiting'` on the UPDATE) to prevent
-     * double-enqueue when two concurrent terminal events race for the same fan-in
-     * task.
-     *
-     * Invariants: [inv:waiting-no-queue], [inv:dispatch-on-completion],
-     *             [inv:inputs-populated-at-dispatch]
-     */
-    dispatchReady(completedTaskId: string): Promise<void>;
-}
-//# sourceMappingURL=dag-engine.d.ts.map

package/src/engine/dag-engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dag-engine.d.ts","sourceRoot":"","sources":["../../../../../../packages/ai/agent-mcp/src/engine/dag-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAIxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD;;;;;;;;;;GAUG;AACH,qBAAa,SAAS;IAEd,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU;gBARV,EAAE,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAChD,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,SAAS;IACrC;;;;OAIG;IACc,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;IAGlE;;;;;;;;;;OAUG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAgC7D;;;;;;;;;;;;;;;OAeG;IACG,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAkG9D"}