@cloudbase/agent-tools 0.0.2

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

@@ -0,0 +1,112 @@
+/**
+ * MCP Toolkit
+ *
+ * A toolkit that manages MCP tools from external servers
+ */
+import { BaseToolkit } from "../utils";
+import { MCPClientManager } from "./mcp-client-manager";
+import { MCPClientTool } from "./client-tool";
+import { MCPClientConfig, MCPTransportConfig } from "./types";
+/**
+ * MCP Toolkit - manages tools from external MCP servers
+ */
+export declare class MCPToolkit extends BaseToolkit {
+    private clientManager;
+    private serverConfigs;
+    constructor(name?: string);
+    /**
+     * Add an MCP server and load its tools
+     */
+    addServer(serverId: string, config: MCPClientConfig): Promise<void>;
+    /**
+     * Load tools from a specific server
+     */
+    private loadServerTools;
+    /**
+     * Remove a server and its tools
+     */
+    removeServer(serverId: string): Promise<void>;
+    /**
+     * Get all connected servers
+     */
+    getConnectedServers(): string[];
+    /**
+     * Get tools from a specific server
+     */
+    getServerTools(serverId: string): MCPClientTool[];
+    /**
+     * Refresh all server connections
+     */
+    refresh(): Promise<void>;
+    /**
+     * Get toolkit statistics
+     */
+    getStats(): {
+        name: string;
+        description: string;
+        toolCount: number;
+        mcp: {
+            connectedServers: number;
+            totalTools: number;
+            serverStatus: Record<string, boolean>;
+        };
+    };
+    /**
+     * Cleanup - disconnect from all servers
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get the underlying client manager
+     */
+    getClientManager(): MCPClientManager;
+}
+/**
+ * MCP Servers Configuration
+ * Supports both object mapping and array formats
+ *
+ * Object mapping format matches standard MCP client configurations (e.g., Claude Desktop)
+ * where the key is the server ID and the value is the transport configuration
+ */
+export type MCPServersConfig = Record<string, MCPClientConfig | MCPTransportConfig> | Array<{
+    id: string;
+    config: MCPClientConfig;
+}>;
+/**
+ * Create a new MCP toolkit with servers
+ *
+ * @param servers - Server configurations in object mapping or array format
+ * @param name - Optional toolkit name
+ *
+ * @example
+ * // Object mapping format (recommended) - matches standard MCP config
+ * const toolkit = await createMCPToolkit({
+ *   time: {
+ *     command: "uvx",
+ *     args: ["mcp-server-time"]
+ *   },
+ *   weather: {
+ *     url: "http://localhost:3000/mcp"
+ *   }
+ * });
+ *
+ * @example
+ * // Object mapping with full MCPClientConfig
+ * const toolkit = await createMCPToolkit({
+ *   time: {
+ *     name: "time-server",
+ *     version: "1.0.0",
+ *     transport: {
+ *       command: "uvx",
+ *       args: ["mcp-server-time"]
+ *     }
+ *   }
+ * });
+ *
+ * @example
+ * // Array format (backward compatible)
+ * const toolkit = await createMCPToolkit([
+ *   { id: "time", config: { transport: { command: "uvx", args: ["mcp-server-time"] } } }
+ * ]);
+ */
+export declare function createMCPToolkit(servers: MCPServersConfig, name?: string): Promise<MCPToolkit>;
+//# sourceMappingURL=mcp-toolkit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-toolkit.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-toolkit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE9D;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,aAAa,CAAsC;gBAE/C,IAAI,GAAE,MAAsB;IAKxC;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzE;;OAEG;YACW,eAAe;IAK7B;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAOjD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;OAEG;IACH,QAAQ;;;;;;;;;;IAWR;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;OAEG;IACH,gBAAgB,IAAI,gBAAgB;CAGrC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAAC,GACpD,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAAC;AAiBnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,gBAAgB,EACzB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,CAAC,CA6BrB"}

package/dist/mcp/mcp-toolkit.js

@@ -0,0 +1,188 @@
+"use strict";
+/**
+ * MCP Toolkit
+ *
+ * A toolkit that manages MCP tools from external servers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPToolkit = void 0;
+exports.createMCPToolkit = createMCPToolkit;
+const utils_1 = require("../utils");
+const mcp_client_manager_1 = require("./mcp-client-manager");
+const client_tool_1 = require("./client-tool");
+/**
+ * MCP Toolkit - manages tools from external MCP servers
+ */
+class MCPToolkit extends utils_1.BaseToolkit {
+    constructor(name = "mcp-toolkit") {
+        super({ name });
+        this.serverConfigs = new Map();
+        this.clientManager = new mcp_client_manager_1.MCPClientManager();
+    }
+    /**
+     * Add an MCP server and load its tools
+     */
+    async addServer(serverId, config) {
+        await this.clientManager.addServer(serverId, config);
+        this.serverConfigs.set(serverId, config);
+        // Load tools from the server
+        await this.loadServerTools(serverId);
+    }
+    /**
+     * Load tools from a specific server
+     */
+    async loadServerTools(serverId) {
+        const clientTools = this.clientManager.createClientTools(serverId);
+        this.addTools(clientTools);
+    }
+    /**
+     * Remove a server and its tools
+     */
+    async removeServer(serverId) {
+        // Remove tools from this server
+        const toolsToRemove = this.getTools().filter((tool) => tool instanceof client_tool_1.MCPClientTool && tool.name.startsWith(`${serverId}:`));
+        for (const tool of toolsToRemove) {
+            this.removeTool(tool.name);
+        }
+        // Disconnect from server
+        await this.clientManager.disconnectServer(serverId);
+        this.serverConfigs.delete(serverId);
+    }
+    /**
+     * Get all connected servers
+     */
+    getConnectedServers() {
+        return Array.from(this.serverConfigs.keys());
+    }
+    /**
+     * Get tools from a specific server
+     */
+    getServerTools(serverId) {
+        return this.getTools().filter((tool) => tool instanceof client_tool_1.MCPClientTool && tool.name.startsWith(`${serverId}:`));
+    }
+    /**
+     * Refresh all server connections
+     */
+    async refresh() {
+        // Clear existing tools
+        const toolNames = this.getTools().map((tool) => tool.name);
+        for (const toolName of toolNames) {
+            this.removeTool(toolName);
+        }
+        // Refresh client manager
+        await this.clientManager.refresh();
+        // Reload all tools
+        for (const serverId of this.serverConfigs.keys()) {
+            await this.loadServerTools(serverId);
+        }
+    }
+    /**
+     * Get toolkit statistics
+     */
+    getStats() {
+        const mcpStats = this.clientManager.getStats();
+        return {
+            name: this.name,
+            description: this.description,
+            toolCount: this.getTools().length,
+            mcp: mcpStats,
+        };
+    }
+    /**
+     * Cleanup - disconnect from all servers
+     */
+    async cleanup() {
+        await this.clientManager.disconnectAll();
+        // Clear all tools
+        const toolNames = this.getTools().map((tool) => tool.name);
+        for (const toolName of toolNames) {
+            this.removeTool(toolName);
+        }
+        this.serverConfigs.clear();
+    }
+    /**
+     * Get the underlying client manager
+     */
+    getClientManager() {
+        return this.clientManager;
+    }
+}
+exports.MCPToolkit = MCPToolkit;
+/**
+ * Helper function to check if a config is a transport config
+ */
+function isTransportConfig(config) {
+    return (config &&
+        typeof config === "object" &&
+        !("transport" in config) &&
+        (("command" in config) ||
+            ("url" in config) ||
+            ("memoryId" in config) ||
+            ("type" in config && config.type !== undefined)));
+}
+/**
+ * Create a new MCP toolkit with servers
+ *
+ * @param servers - Server configurations in object mapping or array format
+ * @param name - Optional toolkit name
+ *
+ * @example
+ * // Object mapping format (recommended) - matches standard MCP config
+ * const toolkit = await createMCPToolkit({
+ *   time: {
+ *     command: "uvx",
+ *     args: ["mcp-server-time"]
+ *   },
+ *   weather: {
+ *     url: "http://localhost:3000/mcp"
+ *   }
+ * });
+ *
+ * @example
+ * // Object mapping with full MCPClientConfig
+ * const toolkit = await createMCPToolkit({
+ *   time: {
+ *     name: "time-server",
+ *     version: "1.0.0",
+ *     transport: {
+ *       command: "uvx",
+ *       args: ["mcp-server-time"]
+ *     }
+ *   }
+ * });
+ *
+ * @example
+ * // Array format (backward compatible)
+ * const toolkit = await createMCPToolkit([
+ *   { id: "time", config: { transport: { command: "uvx", args: ["mcp-server-time"] } } }
+ * ]);
+ */
+async function createMCPToolkit(servers, name) {
+    const toolkit = new MCPToolkit(name);
+    // Normalize servers to array format
+    const serverArray = Array.isArray(servers)
+        ? servers
+        : Object.entries(servers).map(([id, configOrTransport]) => {
+            // Check if it's a direct transport config or a full MCPClientConfig
+            if (isTransportConfig(configOrTransport)) {
+                // It's a transport config, wrap it in MCPClientConfig
+                return {
+                    id,
+                    config: {
+                        name: id,
+                        version: "1.0.0",
+                        transport: configOrTransport,
+                    },
+                };
+            }
+            else {
+                // It's already a full MCPClientConfig
+                return { id, config: configOrTransport };
+            }
+        });
+    for (const { id, config } of serverArray) {
+        await toolkit.addServer(id, config);
+    }
+    return toolkit;
+}
+//# sourceMappingURL=mcp-toolkit.js.map

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

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

package/dist/mcp/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Type definitions for MCP integration with AG-Kit
+ */
+import { z } from "zod/v4";
+import { ToolResult } from "../utils";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+/**
+ * MCP Client Configuration
+ */
+export interface MCPClientConfig {
+    name?: string;
+    version?: string;
+    transport?: MCPTransportConfig;
+    client?: Client;
+    onReconnectNeeded?: (serverId: string, config: MCPClientConfig) => Promise<Client>;
+}
+interface IBaseMCPClientTransportConfig {
+    type?: string;
+    timeout?: number;
+}
+/**
+ * MCP Transport Configuration
+ */
+export type MCPTransportConfig = MCPStdioTransportConfig | MCPSSETransportConfig | MCPStreamableHTTPTransportConfig | MCPInMemoryTransportConfig | MCPCustomTransportConfig;
+/**
+ * Stdio Transport Configuration
+ */
+export interface MCPStdioTransportConfig extends IBaseMCPClientTransportConfig {
+    type?: "stdio";
+    command: string;
+    args?: string[];
+}
+/**
+ * SSE Transport Configuration
+ */
+export interface MCPSSETransportConfig extends IBaseMCPClientTransportConfig {
+    type?: "sse";
+    url: string;
+}
+/**
+ * StreamableHTTP Transport Configuration
+ */
+export interface MCPStreamableHTTPTransportConfig extends IBaseMCPClientTransportConfig {
+    type?: "streamableHttp";
+    url: string;
+}
+/**
+ * InMemory Transport Configuration
+ */
+export interface MCPInMemoryTransportConfig extends IBaseMCPClientTransportConfig {
+    type?: "memory";
+    memoryId: string;
+}
+/**
+ * Custom Transport Configuration
+ */
+export interface MCPCustomTransportConfig extends IBaseMCPClientTransportConfig {
+    type?: "custom";
+    transport: any;
+}
+/**
+ * Detect transport type from configuration
+ * Priority: memory > stdio > streamableHttp > sse
+ */
+export declare function detectTransportType(config: MCPTransportConfig): "memory" | "stdio" | "streamableHttp" | "sse" | "custom";
+/**
+ * MCP Tool Configuration
+ */
+export interface MCPToolConfig {
+    name?: string;
+    description?: string;
+    inputSchema?: z.ZodSchema<any>;
+    outputSchema?: z.ZodSchema<any>;
+    timeout?: number;
+    retries?: number;
+}
+/**
+ * MCP Adapter Configuration
+ */
+export interface MCPAdapterConfig {
+    includeMetadata?: boolean;
+    transformInput?: (input: any) => any;
+    transformOutput?: (output: any) => any;
+    errorHandler?: (error: Error) => ToolResult;
+}
+/**
+ * MCP Connection Options
+ */
+export interface MCPConnectionOptions {
+    autoReconnect?: boolean;
+    reconnectDelay?: number;
+    maxReconnectAttempts?: number;
+    heartbeatInterval?: number;
+}
+/**
+ * MCP Tool Metadata (from MCP server)
+ */
+export interface MCPToolMetadata {
+    name: string;
+    description?: string;
+    inputSchema?: any;
+}
+/**
+ * MCP Event Types
+ */
+export type MCPEvent = {
+    type: "connected";
+    clientName: string;
+} | {
+    type: "disconnected";
+    clientName: string;
+    reason?: string;
+} | {
+    type: "tool_discovered";
+    tool: MCPToolMetadata;
+} | {
+    type: "tool_called";
+    toolName: string;
+    arguments: any;
+} | {
+    type: "tool_result";
+    toolName: string;
+    result: CallToolResult;
+} | {
+    type: "error";
+    error: Error;
+    context?: string;
+};
+/**
+ * MCP Event Listener
+ */
+export type MCPEventListener = (event: MCPEvent) => void;
+/**
+ * MCP Client Status
+ */
+export interface MCPClientStatus {
+    connected: boolean;
+    sessionId?: string;
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+    capabilities?: Record<string, any>;
+    toolCount: number;
+    resourceCount: number;
+    promptCount: number;
+    lastActivity?: Date;
+    reconnectAttempts?: number;
+    errors: Array<{
+        timestamp: Date;
+        error: Error;
+        context?: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/mcp/types.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Type definitions for MCP integration with AG-Kit
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectTransportType = detectTransportType;
+/**
+ * Detect transport type from configuration
+ * Priority: memory > stdio > streamableHttp > sse
+ */
+function detectTransportType(config) {
+    // If type is explicitly specified, use it
+    if (config.type) {
+        return config.type;
+    }
+    // Auto-detect based on config properties
+    // Priority: memory > stdio > streamableHttp > sse
+    if ("memoryId" in config) {
+        return "memory";
+    }
+    if ("command" in config) {
+        return "stdio";
+    }
+    if ("url" in config) {
+        // For URL-based configs, default to streamableHttp
+        // Users must explicitly specify type: 'sse' if they want SSE transport
+        return "streamableHttp";
+    }
+    if ("transport" in config) {
+        return "custom";
+    }
+    throw new Error("Unable to detect transport type from config. Please specify 'type' explicitly or provide valid transport configuration.");
+}
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAsFH,kDA4BC;AAhCD;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,MAA0B;IAE1B,0CAA0C;IAC1C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC,IAAW,CAAC;IAC5B,CAAC;IAED,yCAAyC;IACzC,kDAAkD;IAClD,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,mDAAmD;QACnD,uEAAuE;QACvE,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,yHAAyH,CAC1H,CAAC;AACJ,CAAC"}

package/dist/mcp/utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Utility Functions
+ */
+import { MCPClientConfig } from "./types";
+/**
+ * Create an MCP client with the specified configuration
+ */
+export declare function createMCPClient(config: MCPClientConfig): Promise<any>;
+/**
+ * Helper to format MCP errors for AG-Kit
+ */
+export declare function formatMCPError(error: any): string;
+/**
+ * Helper to check if an error is an MCP protocol error
+ */
+export declare function isMCPError(error: any): boolean;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/mcp/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG1C;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAa3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAWjD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAO9C"}

package/dist/mcp/utils.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * MCP Utility Functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMCPClient = createMCPClient;
+exports.formatMCPError = formatMCPError;
+exports.isMCPError = isMCPError;
+const client_1 = require("@modelcontextprotocol/sdk/client");
+/**
+ * Create an MCP client with the specified configuration
+ */
+async function createMCPClient(config) {
+    try {
+        const client = new client_1.Client({
+            name: config.name,
+            version: config.version,
+        });
+        return client;
+    }
+    catch (error) {
+        throw new Error(`Failed to create MCP client: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Helper to format MCP errors for AG-Kit
+ */
+function formatMCPError(error) {
+    if (error && typeof error === "object") {
+        if (error.code && error.message) {
+            return `MCP Error ${error.code}: ${error.message}`;
+        }
+        if (error.message) {
+            return `MCP Error: ${error.message}`;
+        }
+    }
+    return `MCP Error: ${String(error)}`;
+}
+/**
+ * Helper to check if an error is an MCP protocol error
+ */
+function isMCPError(error) {
+    return (error &&
+        typeof error === "object" &&
+        typeof error.code === "number" &&
+        typeof error.message === "string");
+}
+//# sourceMappingURL=utils.js.map

package/dist/mcp/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/mcp/utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAQH,0CAaC;AAKD,wCAWC;AAKD,gCAOC;AA9CD,6DAAyD;AAEzD;;GAEG;AACI,KAAK,UAAU,eAAe,CAAC,MAAuB;IAC3D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC;YACxB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAU;IACvC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChC,OAAO,aAAa,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,cAAc,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,KAAU;IACnC,OAAO,CACL,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAClC,CAAC;AACJ,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod/v4";
+export interface ToolExecutionContext<TState = unknown> extends Record<string, any> {
+    conversationId?: string;
+    runId?: string;
+    userId?: string;
+    timestamp?: Date;
+    state?: TState;
+}
+export interface IBaseToolOptions<TSchema = z.ZodTypeAny> {
+    name: string;
+    description?: string;
+    schema?: TSchema;
+    requiresApproval?: boolean;
+}
+export interface IToolkitOptions<TState = Record<string, unknown>> {
+    name: string;
+    description?: string;
+    context?: ToolExecutionContext<TState>;
+}
+/**
+ * Configuration options for FilesystemToolkit
+ */
+export interface IFilesystemToolkitConfig {
+    /**
+     * Mode for file editing operations
+     * - 'integrated': Use str-replace-editor tool (single tool for read/write/edit operations)
+     * - 'atomic': Use separate read, write, and edit tools
+     */
+    mode: "integrated" | "atomic";
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,WAAW,oBAAoB,CAAC,MAAM,GAAG,OAAO,CACpD,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,CAAC,CAAC,UAAU;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAGD,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;CAC/B"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/types/zod.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+type InteropZodType<Output = any, Input = Output> = z.ZodType<Output, Input>;
+type ToolInputSchemaInputType<T> = T extends InteropZodType ? InferInteropZodInput<T> : never;
+type InferInteropZodOutput<T> = T extends z.ZodType<infer Output, unknown> ? Output : T extends {
+    _zod: {
+        output: infer Output;
+    };
+} ? Output : never;
+type InferInteropZodInput<T> = T extends z.ZodType<unknown, infer Input> ? Input : T extends {
+    _zod: {
+        input: infer Input;
+    };
+} ? Input : never;
+type ToolInputSchemaOutputType<T> = T extends InteropZodType ? InferInteropZodOutput<T> : never;
+type OriginBaseToolInvokeInput<SchemaT = z.ZodTypeAny, SchemaInputT = ToolInputSchemaInputType<SchemaT>> = (ToolInputSchemaOutputType<SchemaT> extends string ? string : never) | SchemaInputT;
+export type TBaseToolInvokeInput<SchemaT = z.ZodTypeAny, SchemaInputT = ToolInputSchemaInputType<SchemaT>> = unknown extends OriginBaseToolInvokeInput<SchemaT, SchemaInputT> ? any : OriginBaseToolInvokeInput<SchemaT, SchemaInputT>;
+export {};
+//# sourceMappingURL=zod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/types/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,KAAK,cAAc,CAAC,MAAM,GAAG,GAAG,EAAE,KAAK,GAAG,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE7E,KAAK,wBAAwB,CAAC,CAAC,IAAI,CAAC,SAAS,cAAc,GACvD,oBAAoB,CAAC,CAAC,CAAC,GACvB,KAAK,CAAC;AAEV,KAAK,qBAAqB,CAAC,CAAC,IAC1B,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,MAAM,EAAE,OAAO,CAAC,GACtC,MAAM,GACN,CAAC,SAAS;IAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1C,MAAM,GACN,KAAK,CAAC;AAEd,KAAK,oBAAoB,CAAC,CAAC,IACzB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,GACrC,KAAK,GACL,CAAC,SAAS;IAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,KAAK,CAAA;KAAE,CAAA;CAAE,GACxC,KAAK,GACL,KAAK,CAAC;AAEd,KAAK,yBAAyB,CAAC,CAAC,IAAI,CAAC,SAAS,cAAc,GACxD,qBAAqB,CAAC,CAAC,CAAC,GACxB,KAAK,CAAC;AAEV,KAAK,yBAAyB,CAC5B,OAAO,GAAG,CAAC,CAAC,UAAU,EACtB,YAAY,GAAG,wBAAwB,CAAC,OAAO,CAAC,IAE9C,CAAC,yBAAyB,CAAC,OAAO,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,GACpE,YAAY,CAAC;AAEjB,MAAM,MAAM,oBAAoB,CAC9B,OAAO,GAAG,CAAC,CAAC,UAAU,EACtB,YAAY,GAAG,wBAAwB,CAAC,OAAO,CAAC,IAEhD,OAAO,SAAS,yBAAyB,CAAC,OAAO,EAAE,YAAY,CAAC,GAC5D,GAAG,GACH,yBAAyB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC"}

package/dist/types/zod.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=zod.js.map

package/dist/types/zod.js.map

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