integrate-sdk 0.8.42-dev.0 → 0.8.42

package/dist/ai/langchain.d.ts

@@ -0,0 +1,139 @@
+/**
+ * LangChain Integration
+ *
+ * Helper functions to convert MCP tools to LangChain DynamicStructuredTool format
+ */
+import { z } from "zod";
+import type { MCPClient } from "../client.js";
+import type { MCPTool } from "../protocol/messages.js";
+import { type AIToolsOptions } from "./utils.js";
+/**
+ * LangChain DynamicStructuredTool definition
+ * Compatible with @langchain/core/tools
+ */
+export interface LangChainTool {
+    name: string;
+    description: string;
+    schema: z.ZodType<any>;
+    func: (...args: any[]) => Promise<string>;
+}
+/**
+ * Options for converting MCP tools to LangChain format
+ */
+export interface LangChainToolsOptions extends AIToolsOptions {
+}
+/**
+ * Convert a single MCP tool to LangChain DynamicStructuredTool format
+ *
+ * @param mcpTool - The MCP tool definition
+ * @param client - The MCP client instance (used for executing the tool)
+ * @param options - Optional configuration including provider tokens
+ * @returns LangChain compatible tool definition
+ *
+ * @example
+ * ```typescript
+ * const langchainTool = convertMCPToolToLangChain(mcpTool, client);
+ * ```
+ */
+export declare function convertMCPToolToLangChain(mcpTool: MCPTool, client: MCPClient<any>, options?: LangChainToolsOptions): LangChainTool;
+/**
+ * Convert all enabled MCP tools to LangChain DynamicStructuredTool format
+ *
+ * @param client - The MCP client instance (must be connected)
+ * @param options - Optional configuration including provider tokens
+ * @returns Array of LangChain compatible tool definitions
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage
+ * const tools = convertMCPToolsToLangChain(mcpClient);
+ *
+ * // Server-side with provider tokens
+ * const tools = convertMCPToolsToLangChain(serverClient, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function convertMCPToolsToLangChain(client: MCPClient<any>, options?: LangChainToolsOptions): LangChainTool[];
+/**
+ * Get tools in a format compatible with LangChain
+ *
+ * Automatically connects the client if not already connected.
+ * Returns tool definitions that can be used with DynamicStructuredTool.
+ *
+ * @param client - The MCP client instance
+ * @param options - Optional configuration including provider tokens for server-side usage
+ * @returns Array of tools ready to use with LangChain
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage
+ * import { createMCPClient, githubIntegration } from 'integrate-sdk';
+ * import { getLangChainTools } from 'integrate-sdk/ai/langchain';
+ * import { DynamicStructuredTool } from '@langchain/core/tools';
+ * import { ChatOpenAI } from '@langchain/openai';
+ * import { AgentExecutor, createOpenAIFunctionsAgent } from 'langchain/agents';
+ *
+ * const client = createMCPClient({
+ *   integrations: [githubIntegration({ clientId: '...' })],
+ * });
+ *
+ * const toolConfigs = await getLangChainTools(client);
+ *
+ * // Create DynamicStructuredTools from configs
+ * const tools = toolConfigs.map(config =>
+ *   new DynamicStructuredTool(config)
+ * );
+ *
+ * const model = new ChatOpenAI({ temperature: 0 });
+ * const agent = await createOpenAIFunctionsAgent({
+ *   llm: model,
+ *   tools
+ * });
+ *
+ * const executor = new AgentExecutor({ agent, tools });
+ * const result = await executor.invoke({
+ *   input: "Create a GitHub issue"
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Server-side usage with tokens from client
+ * import { createMCPServer, githubIntegration } from 'integrate-sdk/server';
+ * import { getLangChainTools } from 'integrate-sdk/ai/langchain';
+ *
+ * const { client: serverClient } = createMCPServer({
+ *   integrations: [githubIntegration({
+ *     clientId: '...',
+ *     clientSecret: '...'
+ *   })],
+ * });
+ *
+ * // In your API route
+ * export async function POST(req: Request) {
+ *   const providerTokens = JSON.parse(req.headers.get('x-integrate-tokens') || '{}');
+ *   const toolConfigs = await getLangChainTools(serverClient, { providerTokens });
+ *
+ *   // Create DynamicStructuredTools
+ *   const tools = toolConfigs.map(config =>
+ *     new DynamicStructuredTool(config)
+ *   );
+ *
+ *   const model = new ChatOpenAI({ temperature: 0 });
+ *   const agent = await createOpenAIFunctionsAgent({
+ *     llm: model,
+ *     tools
+ *   });
+ *
+ *   const executor = new AgentExecutor({ agent, tools });
+ *   const result = await executor.invoke({
+ *     input: "Create a GitHub issue"
+ *   });
+ *
+ *   return Response.json(result);
+ * }
+ * ```
+ */
+export declare function getLangChainTools(client: MCPClient<any>, options?: LangChainToolsOptions): Promise<LangChainTool[]>;
+//# sourceMappingURL=langchain.d.ts.map

package/dist/ai/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../../src/ai/langchain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;CAAI;AAEjE;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAYf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,EAAE,CAGjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,aAAa,EAAE,CAAC,CAe1B"}