bigtool-ts 0.1.0

package/dist/sources/mcp.js

@@ -0,0 +1,438 @@
+/**
+ * MCPSource module.
+ *
+ * Provides a ToolSource implementation that connects to an MCP
+ * (Model Context Protocol) server and exposes its tools.
+ *
+ * Supports two patterns:
+ * 1. Pre-connected client: Pass an already-connected MCPClient
+ * 2. Config-based: Pass server config and MCPSource manages the connection
+ *
+ * @module sources/mcp
+ */
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import { createEventEmitter } from "../types.js";
+/**
+ * MCPSource connects to an MCP server and provides its tools.
+ *
+ * Tools are fetched from the MCP server on first access and cached.
+ * Wrapper tools are created lazily that delegate execution back to
+ * the server.
+ *
+ * The source can optionally refresh its tool list periodically to
+ * pick up new tools or changes from the server.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { MCPSource } from '@repo/bigtool-ts';
+ * import { Client } from '@modelcontextprotocol/sdk/client';
+ *
+ * const client = new Client({ name: 'github' });
+ * await client.connect(transport);
+ *
+ * const source = new MCPSource(client);
+ * await catalog.register(source);
+ * ```
+ *
+ * @example With auto-refresh
+ * ```typescript
+ * const source = new MCPSource(client, {
+ *   namespace: 'github',
+ *   refreshInterval: 60000, // Check for new tools every minute
+ * });
+ *
+ * // Listen for refresh events
+ * source.onRefresh.subscribe((metadata) => {
+ *   console.log(`Refreshed: ${metadata.length} tools`);
+ * });
+ * ```
+ */
+export class MCPSource {
+    /**
+     * Unique identifier for this source.
+     *
+     * Format: 'mcp:{namespace}' (e.g., 'mcp:github').
+     */
+    id;
+    /** @internal The MCP client */
+    client;
+    /** @internal Cached tool metadata */
+    metadata = [];
+    /** @internal Cache of wrapped tools */
+    toolCache = new Map();
+    /** @internal Timer for periodic refresh */
+    refreshTimer;
+    /** @internal Whether initial fetch has completed */
+    initialized = false;
+    /**
+     * Event emitter for refresh notifications.
+     *
+     * Subscribe to be notified when the tool list is refreshed
+     * from the MCP server.
+     */
+    onRefresh = createEventEmitter();
+    /**
+     * Creates a new MCPSource.
+     *
+     * @param client - MCP client instance (must be connected)
+     * @param options - Configuration options
+     *
+     * @example
+     * ```typescript
+     * const source = new MCPSource(client, {
+     *   namespace: 'github',
+     *   refreshInterval: 60000,
+     * });
+     * ```
+     */
+    constructor(client, options = {}) {
+        this.client = client;
+        this.id = `mcp:${options.namespace ?? client.name ?? "default"}`;
+        if (options.refreshInterval && options.refreshInterval > 0) {
+            this.refreshTimer = setInterval(() => {
+                this.refresh().catch((err) => {
+                    console.error(`[MCPSource:${this.id}] Refresh failed:`, err);
+                });
+            }, options.refreshInterval);
+        }
+    }
+    /**
+     * Get metadata for all tools from this MCP server.
+     *
+     * Fetches from the server on first call, then returns cached metadata.
+     * Call refresh() to update the metadata from the server.
+     *
+     * @returns Promise resolving to array of tool metadata
+     *
+     * @example
+     * ```typescript
+     * const metadata = await source.getMetadata();
+     * console.log(`MCP server has ${metadata.length} tools`);
+     * ```
+     */
+    async getMetadata() {
+        if (!this.initialized) {
+            await this.refresh();
+        }
+        return this.metadata;
+    }
+    /**
+     * Get a tool by its ID.
+     *
+     * Creates a wrapper tool on first request that delegates execution
+     * to the MCP server. Wrappers are cached for subsequent calls.
+     *
+     * @param id - Tool ID (e.g., 'mcp:github:create_pr' or just 'create_pr')
+     * @returns Promise resolving to the tool wrapper, or null if not found
+     *
+     * @example
+     * ```typescript
+     * const tool = await source.getTool('mcp:github:create_pr');
+     * if (tool) {
+     *   const result = await tool.invoke({ title: 'My PR' });
+     * }
+     * ```
+     */
+    async getTool(id) {
+        // Ensure we have metadata
+        if (!this.initialized) {
+            await this.refresh();
+        }
+        // Extract tool name from ID
+        // Format: "mcp:namespace:toolName" or just "toolName"
+        const parts = id.split(":");
+        const toolName = parts[parts.length - 1];
+        // Check if tool exists in metadata
+        const meta = this.metadata.find((m) => m.name === toolName);
+        if (!meta) {
+            return null;
+        }
+        // Return cached wrapper or create new one
+        if (!this.toolCache.has(toolName)) {
+            const wrapper = this.createToolWrapper(toolName, meta);
+            this.toolCache.set(toolName, wrapper);
+        }
+        return this.toolCache.get(toolName) ?? null;
+    }
+    /**
+     * Refresh the tool list from the MCP server.
+     *
+     * Fetches the current tool list, updates metadata, clears the
+     * tool wrapper cache, and emits an onRefresh event.
+     *
+     * @throws MCPSourceError if the server request fails
+     *
+     * @example
+     * ```typescript
+     * // Manually refresh tools
+     * await source.refresh();
+     *
+     * // Or listen for auto-refresh events
+     * source.onRefresh.subscribe((metadata) => {
+     *   console.log('Tools refreshed:', metadata.length);
+     * });
+     * ```
+     */
+    async refresh() {
+        try {
+            const { tools } = await this.client.listTools();
+            this.metadata = tools.map((t) => ({
+                id: `${this.id}:${t.name}`,
+                name: t.name,
+                description: t.description ?? "",
+                parameters: t.inputSchema,
+                source: "mcp",
+                sourceId: this.id,
+            }));
+            this.initialized = true;
+            // Clear tool cache on refresh since schemas may have changed
+            this.toolCache.clear();
+            this.onRefresh.emit(this.metadata);
+        }
+        catch (error) {
+            // Wrap error with more context
+            const message = error instanceof Error ? error.message : String(error);
+            throw new MCPSourceError(`Failed to fetch tools from MCP server: ${message}`, { cause: error });
+        }
+    }
+    /**
+     * Create a wrapper tool that delegates execution to the MCP server.
+     */
+    createToolWrapper(toolName, meta) {
+        const client = this.client;
+        const sourceId = this.id;
+        return new DynamicStructuredTool({
+            name: toolName,
+            description: meta.description,
+            schema: this.createSchemaFromParameters(meta.parameters),
+            func: async (input) => {
+                try {
+                    const result = await client.callTool({
+                        name: toolName,
+                        arguments: input,
+                    });
+                    if (result.isError) {
+                        const errorText = result.content
+                            ?.filter((c) => c.type === "text")
+                            .map((c) => c.text)
+                            .join("\n");
+                        throw new MCPToolError(`MCP tool "${toolName}" returned error: ${errorText ?? "Unknown error"}`);
+                    }
+                    // Extract text content from result
+                    const textContent = result.content
+                        ?.filter((c) => c.type === "text")
+                        .map((c) => c.text)
+                        .join("\n");
+                    return textContent ?? JSON.stringify(result);
+                }
+                catch (error) {
+                    if (error instanceof MCPToolError) {
+                        throw error;
+                    }
+                    const message = error instanceof Error ? error.message : String(error);
+                    throw new MCPToolError(`Failed to execute MCP tool "${toolName}" on ${sourceId}: ${message}`, { cause: error });
+                }
+            },
+        });
+    }
+    /**
+     * Create a Zod-like schema from MCP input schema.
+     * For simplicity, we create a pass-through schema.
+     */
+    createSchemaFromParameters(parameters) {
+        // Return the raw JSON schema - LangChain will handle it
+        return parameters ?? {};
+    }
+    /**
+     * Clean up resources.
+     *
+     * Stops the refresh timer and clears all event subscriptions.
+     * Call this when you're done with the source to prevent memory leaks.
+     *
+     * @example
+     * ```typescript
+     * // When shutting down
+     * source.dispose();
+     * catalog.unregister(source.id);
+     * ```
+     */
+    dispose() {
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = undefined;
+        }
+        this.onRefresh.clear();
+    }
+}
+/**
+ * Error thrown when MCP source operations fail.
+ *
+ * This error indicates a problem with the MCP server connection
+ * or protocol, such as failing to list tools.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await source.refresh();
+ * } catch (error) {
+ *   if (error instanceof MCPSourceError) {
+ *     console.error('MCP server error:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export class MCPSourceError extends Error {
+    /**
+     * Creates a new MCPSourceError.
+     *
+     * @param message - Error message
+     * @param options - Error options (e.g., cause)
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "MCPSourceError";
+    }
+}
+/**
+ * Error thrown when MCP tool execution fails.
+ *
+ * This error indicates a problem executing a specific tool on
+ * the MCP server, such as invalid arguments or server-side errors.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await tool.invoke({ title: '' });
+ * } catch (error) {
+ *   if (error instanceof MCPToolError) {
+ *     console.error('Tool execution failed:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export class MCPToolError extends Error {
+    /**
+     * Creates a new MCPToolError.
+     *
+     * @param message - Error message
+     * @param options - Error options (e.g., cause)
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "MCPToolError";
+    }
+}
+/**
+ * Creates an MCPSource from a server configuration.
+ *
+ * This is the preferred way to create an MCPSource when you don't have
+ * a pre-connected MCP client. The function handles:
+ * - Starting the MCP server process (for stdio transport)
+ * - Connecting to remote servers (for SSE/WebSocket transport)
+ * - Managing the client lifecycle
+ *
+ * @param config - Server configuration
+ * @returns Promise resolving to a configured MCPSource
+ *
+ * @example stdio transport (local server)
+ * ```typescript
+ * import { createMCPSource } from '@repo/bigtool-ts';
+ *
+ * const source = await createMCPSource({
+ *   name: 'github',
+ *   transport: 'stdio',
+ *   command: 'npx',
+ *   args: ['-y', '@modelcontextprotocol/server-github'],
+ *   env: { GITHUB_TOKEN: process.env.GITHUB_TOKEN },
+ * });
+ *
+ * // Use like any ToolSource
+ * await catalog.register(source);
+ * ```
+ *
+ * @example SSE transport (remote server)
+ * ```typescript
+ * const source = await createMCPSource({
+ *   name: 'remote-tools',
+ *   transport: 'sse',
+ *   url: 'https://mcp.example.com/sse',
+ *   headers: { Authorization: `Bearer ${apiKey}` },
+ * });
+ * ```
+ *
+ * @example Multiple servers
+ * ```typescript
+ * const sources = await Promise.all([
+ *   createMCPSource({ name: 'github', transport: 'stdio', command: 'npx', args: ['-y', '@mcp/server-github'] }),
+ *   createMCPSource({ name: 'slack', transport: 'stdio', command: 'npx', args: ['-y', '@mcp/server-slack'] }),
+ *   createMCPSource({ name: 'notion', transport: 'stdio', command: 'npx', args: ['-y', '@mcp/server-notion'] }),
+ * ]);
+ *
+ * for (const source of sources) {
+ *   await catalog.register(source);
+ * }
+ * ```
+ */
+export async function createMCPSource(config) {
+    // Dynamic import of MCP SDK to avoid hard dependency
+    let Client;
+    let StdioClientTransport;
+    let SSEClientTransport;
+    try {
+        const sdk = await import("@modelcontextprotocol/sdk/client/index.js");
+        Client = sdk.Client;
+    }
+    catch {
+        throw new MCPSourceError("Failed to import @modelcontextprotocol/sdk. Please install it: pnpm add @modelcontextprotocol/sdk");
+    }
+    const client = new Client({ name: config.name, version: "1.0.0" }, { capabilities: {} });
+    try {
+        if (config.transport === "stdio") {
+            try {
+                const stdioModule = await import("@modelcontextprotocol/sdk/client/stdio.js");
+                StdioClientTransport = stdioModule.StdioClientTransport;
+            }
+            catch {
+                throw new MCPSourceError("Failed to import stdio transport. Ensure @modelcontextprotocol/sdk is installed.");
+            }
+            const transport = new StdioClientTransport({
+                command: config.command,
+                args: config.args,
+                env: config.env,
+                cwd: config.cwd,
+            });
+            await client.connect(transport);
+        }
+        else if (config.transport === "sse") {
+            try {
+                const sseModule = await import("@modelcontextprotocol/sdk/client/sse.js");
+                SSEClientTransport = sseModule.SSEClientTransport;
+            }
+            catch {
+                throw new MCPSourceError("Failed to import SSE transport. Ensure @modelcontextprotocol/sdk is installed.");
+            }
+            const transport = new SSEClientTransport(new URL(config.url));
+            await client.connect(transport);
+        }
+        else if (config.transport === "websocket") {
+            // WebSocket transport - not yet available in MCP SDK
+            throw new MCPSourceError(`WebSocket transport is not yet supported by the MCP SDK`);
+        }
+        else {
+            throw new MCPSourceError(`Unknown transport type: ${config.transport}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof MCPSourceError) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new MCPSourceError(`Failed to connect to MCP server "${config.name}": ${message}`, { cause: error });
+    }
+    // Create MCPSource with the connected client
+    return new MCPSource(client, {
+        namespace: config.name,
+        refreshInterval: config.refreshInterval,
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/sources/mcp.js.map

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

package/dist/sources/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Source Types
+ *
+ * Re-exports types used by source implementations.
+ */
+export type { ToolSource, ToolMetadata, ToolEnhancement, EnhancedTool, } from "../types.js";
+export { withMetadata } from "../types.js";
+/**
+ * Additional search metadata that can be attached to tools.
+ * @deprecated Use ToolEnhancement instead
+ */
+export interface ToolSearchMetadata {
+    categories?: string[];
+    keywords?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sources/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,UAAU,EACV,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/sources/types.js

@@ -0,0 +1,7 @@
+/**
+ * Source Types
+ *
+ * Re-exports types used by source implementations.
+ */
+export { withMetadata } from "../types.js";
+//# sourceMappingURL=types.js.map

package/dist/sources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sources/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/sources/with-metadata.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility for enhancing tools with search metadata.
+ *
+ * Re-exports withMetadata from the main types module.
+ */
+export { withMetadata } from "../types";
+//# sourceMappingURL=with-metadata.d.ts.map

package/dist/sources/with-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-metadata.d.ts","sourceRoot":"","sources":["../../src/sources/with-metadata.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/sources/with-metadata.js

@@ -0,0 +1,7 @@
+/**
+ * Utility for enhancing tools with search metadata.
+ *
+ * Re-exports withMetadata from the main types module.
+ */
+export { withMetadata } from "../types";
+//# sourceMappingURL=with-metadata.js.map

package/dist/sources/with-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-metadata.js","sourceRoot":"","sources":["../../src/sources/with-metadata.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * bigtool-ts Type Definitions
+ *
+ * Re-exports all types from the main types.ts file.
+ */
+export { type EventHandler, type Unsubscribe, type EventEmitter, createEventEmitter, type ToolMetadata, type ToolSource, type ToolsChangedEvent, type ToolCatalog, type ToolLoader, type SearchOptions, type SearchResult, type SearchIndex, type ToolEnhancement, type EnhancedTool, withMetadata, } from "../types.js";
+//# 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;;;;GAIG;AAGH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,kBAAkB,EAGlB,KAAK,YAAY,EAGjB,KAAK,UAAU,EAGf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAGhB,KAAK,UAAU,EAGf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAGhB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * bigtool-ts Type Definitions
+ *
+ * Re-exports all types from the main types.ts file.
+ */
+// Re-export everything from the root types module
+export { createEventEmitter, withMetadata, } from "../types.js";
+//# 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":"AAAA;;;;GAIG;AAEH,kDAAkD;AAClD,OAAO,EAKL,kBAAkB,EAuBlB,YAAY,GACb,MAAM,aAAa,CAAC"}