mcacp 0.1.0

package/dist/types/tools.d.ts

@@ -0,0 +1,619 @@
+import { z } from 'zod';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: z.ZodType<any>;
+}
+/**
+ * Configuration for an MCP server that can be forwarded to a sub-agent.
+ *
+ * Two variants:
+ *  - stdio: launch a local process (command + optional args / env)
+ *  - http:  connect to a remote server over HTTP/SSE (url + optional headers)
+ */
+export declare const McpServerConfigSchema: z.ZodUnion<[z.ZodObject<{
+    name: z.ZodString;
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    env: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        name: string;
+    }, {
+        value: string;
+        name: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    name: string;
+    args?: string[] | undefined;
+    env?: {
+        value: string;
+        name: string;
+    }[] | undefined;
+}, {
+    command: string;
+    name: string;
+    args?: string[] | undefined;
+    env?: {
+        value: string;
+        name: string;
+    }[] | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"http">;
+    name: z.ZodString;
+    url: z.ZodString;
+    headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        name: string;
+    }, {
+        value: string;
+        name: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "http";
+    name: string;
+    url: string;
+    headers?: {
+        value: string;
+        name: string;
+    }[] | undefined;
+}, {
+    type: "http";
+    name: string;
+    url: string;
+    headers?: {
+        value: string;
+        name: string;
+    }[] | undefined;
+}>]>;
+export type McpServerConfig = z.infer<typeof McpServerConfigSchema>;
+/**
+ * A single content block inside a structured prompt.
+ *
+ * - text:          plain or markdown text
+ * - resource_link: reference to an external resource by URI
+ */
+export declare const ContentBlockInputSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "text";
+    text: string;
+}, {
+    type: "text";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"resource_link">;
+    uri: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "resource_link";
+    uri: string;
+    mimeType?: string | undefined;
+}, {
+    type: "resource_link";
+    uri: string;
+    mimeType?: string | undefined;
+}>]>;
+export type ContentBlockInput = z.infer<typeof ContentBlockInputSchema>;
+/**
+ * Client capability flags passed during initialize.
+ */
+export declare const ClientCapabilitiesSchema: z.ZodOptional<z.ZodObject<{
+    fs: z.ZodOptional<z.ZodObject<{
+        readTextFile: z.ZodOptional<z.ZodBoolean>;
+        writeTextFile: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        readTextFile?: boolean | undefined;
+        writeTextFile?: boolean | undefined;
+    }, {
+        readTextFile?: boolean | undefined;
+        writeTextFile?: boolean | undefined;
+    }>>;
+    terminal: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    fs?: {
+        readTextFile?: boolean | undefined;
+        writeTextFile?: boolean | undefined;
+    } | undefined;
+    terminal?: boolean | undefined;
+}, {
+    fs?: {
+        readTextFile?: boolean | undefined;
+        writeTextFile?: boolean | undefined;
+    } | undefined;
+    terminal?: boolean | undefined;
+}>>;
+/**
+ * Client identification passed during initialize.
+ */
+export declare const ClientInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version: string;
+    title?: string | undefined;
+}, {
+    name: string;
+    version: string;
+    title?: string | undefined;
+}>;
+export type ClientInfo = z.infer<typeof ClientInfoSchema>;
+export declare const ListInstalledAgentsInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const RegistrySearchInputSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    showIncompatible: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    showIncompatible: boolean;
+    query?: string | undefined;
+}, {
+    query?: string | undefined;
+    showIncompatible?: boolean | undefined;
+}>;
+export declare const AgentInstallInputSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+    version?: string | undefined;
+}, {
+    agentId: string;
+    version?: string | undefined;
+}>;
+export declare const AgentUninstallInputSchema: z.ZodObject<{
+    agentId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+}, {
+    agentId: string;
+}>;
+export declare const AgentCheckUpgradesInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const InitializeInputSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    protocolVersion: z.ZodOptional<z.ZodNumber>;
+    clientInfo: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    }, {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    }>>;
+    clientCapabilities: z.ZodOptional<z.ZodObject<{
+        fs: z.ZodOptional<z.ZodObject<{
+            readTextFile: z.ZodOptional<z.ZodBoolean>;
+            writeTextFile: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            readTextFile?: boolean | undefined;
+            writeTextFile?: boolean | undefined;
+        }, {
+            readTextFile?: boolean | undefined;
+            writeTextFile?: boolean | undefined;
+        }>>;
+        terminal: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        fs?: {
+            readTextFile?: boolean | undefined;
+            writeTextFile?: boolean | undefined;
+        } | undefined;
+        terminal?: boolean | undefined;
+    }, {
+        fs?: {
+            readTextFile?: boolean | undefined;
+            writeTextFile?: boolean | undefined;
+        } | undefined;
+        terminal?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+    clientInfo?: {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    } | undefined;
+    clientCapabilities?: {
+        fs?: {
+            readTextFile?: boolean | undefined;
+            writeTextFile?: boolean | undefined;
+        } | undefined;
+        terminal?: boolean | undefined;
+    } | undefined;
+    protocolVersion?: number | undefined;
+}, {
+    agentId: string;
+    clientInfo?: {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    } | undefined;
+    clientCapabilities?: {
+        fs?: {
+            readTextFile?: boolean | undefined;
+            writeTextFile?: boolean | undefined;
+        } | undefined;
+        terminal?: boolean | undefined;
+    } | undefined;
+    protocolVersion?: number | undefined;
+}>;
+export declare const ShutdownInputSchema: z.ZodObject<{
+    agentId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+}, {
+    agentId: string;
+}>;
+export declare const NewSessionInputSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    cwd: z.ZodString;
+    mcpServers: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            name: string;
+        }, {
+            value: string;
+            name: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        name: string;
+        args?: string[] | undefined;
+        env?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    }, {
+        command: string;
+        name: string;
+        args?: string[] | undefined;
+        env?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"http">;
+        name: z.ZodString;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            name: string;
+        }, {
+            value: string;
+            name: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "http";
+        name: string;
+        url: string;
+        headers?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    }, {
+        type: "http";
+        name: string;
+        url: string;
+        headers?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    }>]>, "many">>;
+    permissionPolicy: z.ZodOptional<z.ZodEnum<["elicit", "allow_all", "deny_all", "operator"]>>;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+    cwd: string;
+    permissionPolicy?: "elicit" | "allow_all" | "deny_all" | "operator" | undefined;
+    mcpServers?: ({
+        command: string;
+        name: string;
+        args?: string[] | undefined;
+        env?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    } | {
+        type: "http";
+        name: string;
+        url: string;
+        headers?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    })[] | undefined;
+}, {
+    agentId: string;
+    cwd: string;
+    permissionPolicy?: "elicit" | "allow_all" | "deny_all" | "operator" | undefined;
+    mcpServers?: ({
+        command: string;
+        name: string;
+        args?: string[] | undefined;
+        env?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    } | {
+        type: "http";
+        name: string;
+        url: string;
+        headers?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    })[] | undefined;
+}>;
+export declare const LoadSessionInputSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    sessionId: z.ZodString;
+    cwd: z.ZodString;
+    mcpServers: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            name: string;
+        }, {
+            value: string;
+            name: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        name: string;
+        args?: string[] | undefined;
+        env?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    }, {
+        command: string;
+        name: string;
+        args?: string[] | undefined;
+        env?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"http">;
+        name: z.ZodString;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            name: string;
+        }, {
+            value: string;
+            name: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "http";
+        name: string;
+        url: string;
+        headers?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    }, {
+        type: "http";
+        name: string;
+        url: string;
+        headers?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    }>]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    agentId: string;
+    cwd: string;
+    mcpServers?: ({
+        command: string;
+        name: string;
+        args?: string[] | undefined;
+        env?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    } | {
+        type: "http";
+        name: string;
+        url: string;
+        headers?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    })[] | undefined;
+}, {
+    sessionId: string;
+    agentId: string;
+    cwd: string;
+    mcpServers?: ({
+        command: string;
+        name: string;
+        args?: string[] | undefined;
+        env?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    } | {
+        type: "http";
+        name: string;
+        url: string;
+        headers?: {
+            value: string;
+            name: string;
+        }[] | undefined;
+    })[] | undefined;
+}>;
+export declare const ListSessionsInputSchema: z.ZodObject<{
+    agentId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+}, {
+    agentId: string;
+}>;
+export declare const CloseSessionInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+}, {
+    sessionId: string;
+}>;
+export declare const PromptInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    prompt: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "text";
+        text: string;
+    }, {
+        type: "text";
+        text: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"resource_link">;
+        uri: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "resource_link";
+        uri: string;
+        mimeType?: string | undefined;
+    }, {
+        type: "resource_link";
+        uri: string;
+        mimeType?: string | undefined;
+    }>]>, "many">]>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    prompt: string | ({
+        type: "text";
+        text: string;
+    } | {
+        type: "resource_link";
+        uri: string;
+        mimeType?: string | undefined;
+    })[];
+}, {
+    sessionId: string;
+    prompt: string | ({
+        type: "text";
+        text: string;
+    } | {
+        type: "resource_link";
+        uri: string;
+        mimeType?: string | undefined;
+    })[];
+}>;
+export declare const GrantPermissionInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    toolCallId: z.ZodString;
+    optionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    toolCallId: string;
+    optionId: string;
+}, {
+    sessionId: string;
+    toolCallId: string;
+    optionId: string;
+}>;
+export declare const CancelInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+}, {
+    sessionId: string;
+}>;
+export declare const SetModeInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    modeId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    modeId: string;
+}, {
+    sessionId: string;
+    modeId: string;
+}>;
+export declare const EventsInputSchema: z.ZodObject<{
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    nagleMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    nagleMs?: number | undefined;
+    timeoutMs?: number | undefined;
+}, {
+    nagleMs?: number | undefined;
+    timeoutMs?: number | undefined;
+}>;
+export declare const ListRunningAgentsInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const GetAgentStatusInputSchema: z.ZodObject<{
+    agentId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+}, {
+    agentId: string;
+}>;
+export declare const SetAgentStatusInputSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    status: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    agentId: string;
+}, {
+    status: string;
+    agentId: string;
+}>;
+export declare const listInstalledAgents: ToolDefinition;
+export declare const registrySearch: ToolDefinition;
+export declare const agentInstall: ToolDefinition;
+export declare const agentUninstall: ToolDefinition;
+export declare const agentCheckUpgrades: ToolDefinition;
+export declare const initialize: ToolDefinition;
+export declare const shutdown: ToolDefinition;
+export declare const newSession: ToolDefinition;
+export declare const loadSession: ToolDefinition;
+export declare const listSessions: ToolDefinition;
+export declare const closeSession: ToolDefinition;
+export declare const prompt: ToolDefinition;
+export declare const grantPermission: ToolDefinition;
+export declare const cancel: ToolDefinition;
+export declare const setMode: ToolDefinition;
+export declare const events: ToolDefinition;
+export declare const listRunningAgents: ToolDefinition;
+export declare const getAgentStatus: ToolDefinition;
+export declare const setAgentStatus: ToolDefinition;
+/**
+ * All MCACP tool definitions in a single array.
+ * Useful for bulk registration with an MCP server.
+ */
+export declare const ALL_TOOLS: ToolDefinition[];
+/**
+ * Record mapping every tool name to its Zod input schema.
+ * Useful for runtime validation of incoming tool-call arguments.
+ */
+export declare const TOOL_SCHEMAS: Record<string, z.ZodType<any>>;