integrate-sdk 0.8.36 → 0.8.39

package/dist/ai/llamaindex.d.ts

@@ -0,0 +1,125 @@
+/**
+ * LlamaIndex Integration
+ *
+ * Helper functions to convert MCP tools to LlamaIndex tool format
+ */
+import { z } from "zod";
+import type { MCPClient } from "../client.js";
+import type { MCPTool } from "../protocol/messages.js";
+import { type AIToolsOptions } from "./utils.js";
+/**
+ * LlamaIndex tool definition
+ * Compatible with llamaindex package
+ */
+export interface LlamaIndexTool {
+    name: string;
+    description: string;
+    parameters: z.ZodType<any>;
+    execute: (input: Record<string, unknown>) => Promise<string>;
+}
+/**
+ * Options for converting MCP tools to LlamaIndex format
+ */
+export interface LlamaIndexToolsOptions extends AIToolsOptions {
+}
+/**
+ * Convert a single MCP tool to LlamaIndex 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 LlamaIndex compatible tool definition
+ *
+ * @example
+ * ```typescript
+ * const llamaIndexTool = convertMCPToolToLlamaIndex(mcpTool, client);
+ * ```
+ */
+export declare function convertMCPToolToLlamaIndex(mcpTool: MCPTool, client: MCPClient<any>, options?: LlamaIndexToolsOptions): LlamaIndexTool;
+/**
+ * Convert all enabled MCP tools to LlamaIndex format
+ *
+ * @param client - The MCP client instance (must be connected)
+ * @param options - Optional configuration including provider tokens
+ * @returns Array of LlamaIndex compatible tool definitions
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage
+ * const tools = convertMCPToolsToLlamaIndex(mcpClient);
+ *
+ * // Server-side with provider tokens
+ * const tools = convertMCPToolsToLlamaIndex(serverClient, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function convertMCPToolsToLlamaIndex(client: MCPClient<any>, options?: LlamaIndexToolsOptions): LlamaIndexTool[];
+/**
+ * Get tools in a format compatible with LlamaIndex
+ *
+ * Automatically connects the client if not already connected.
+ * Returns tool configurations that can be used with LlamaIndex's tool system.
+ *
+ * @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 LlamaIndex
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage
+ * import { createMCPClient, githubIntegration } from 'integrate-sdk';
+ * import { getLlamaIndexTools } from 'integrate-sdk/ai/llamaindex';
+ * import { OpenAIAgent, tool } from 'llamaindex';
+ *
+ * const client = createMCPClient({
+ *   integrations: [githubIntegration({ clientId: '...' })],
+ * });
+ *
+ * const toolConfigs = await getLlamaIndexTools(client);
+ *
+ * // Create LlamaIndex tools
+ * const tools = toolConfigs.map(config =>
+ *   tool(config)
+ * );
+ *
+ * const agent = new OpenAIAgent({ tools });
+ * const response = await agent.chat({
+ *   message: "Create a GitHub issue"
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Server-side usage with tokens from client
+ * import { createMCPServer, githubIntegration } from 'integrate-sdk/server';
+ * import { getLlamaIndexTools } from 'integrate-sdk/ai/llamaindex';
+ *
+ * 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 getLlamaIndexTools(serverClient, { providerTokens });
+ *
+ *   // Create LlamaIndex tools
+ *   const tools = toolConfigs.map(config =>
+ *     tool(config)
+ *   );
+ *
+ *   const agent = new OpenAIAgent({ tools });
+ *   const response = await agent.chat({
+ *     message: "Create a GitHub issue"
+ *   });
+ *
+ *   return Response.json(response);
+ * }
+ * ```
+ */
+export declare function getLlamaIndexTools(client: MCPClient<any>, options?: LlamaIndexToolsOptions): Promise<LlamaIndexTool[]>;
+//# sourceMappingURL=llamaindex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llamaindex.d.ts","sourceRoot":"","sources":["../../../src/ai/llamaindex.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,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;CAAI;AAElE;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAUhB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,EAAE,CAGlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,cAAc,EAAE,CAAC,CAe3B"}