integrate-sdk 0.7.23 → 0.7.25

package/dist/ai/vercel-ai.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Vercel AI SDK Integration
+ *
+ * Helper functions to convert MCP tools to Vercel AI SDK v5 format
+ */
+import { z } from "zod";
+import type { MCPClient } from "../client.js";
+import type { MCPTool } from "../protocol/messages.js";
+import { type AIToolsOptions } from "./utils.js";
+/**
+ * Tool definition compatible with Vercel AI SDK v5
+ * This matches the CoreTool interface from 'ai' package v5
+ */
+export interface VercelAITool {
+    description?: string;
+    inputSchema: z.ZodType<any>;
+    execute: (args: any, options?: any) => Promise<any>;
+}
+/**
+ * Options for converting MCP tools to Vercel AI SDK format
+ */
+export interface VercelAIToolsOptions extends AIToolsOptions {
+}
+/**
+ * Convert a single MCP tool to Vercel AI SDK 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 Vercel AI SDK compatible tool definition
+ */
+export declare function convertMCPToolToVercelAI(mcpTool: MCPTool, client: MCPClient<any>, options?: VercelAIToolsOptions): VercelAITool;
+/**
+ * Convert all enabled MCP tools to Vercel AI SDK v5 format
+ *
+ * @param client - The MCP client instance (must be connected)
+ * @param options - Optional configuration including provider tokens for server-side usage
+ * @returns Object mapping tool names to Vercel AI SDK v5 tool definitions (compatible with CoreTool from 'ai' package v5)
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage
+ * import { createMCPClient, githubIntegration } from 'integrate-sdk';
+ * import { convertMCPToolsToVercelAI } from 'integrate-sdk/vercel-ai';
+ * import { generateText } from 'ai';
+ *
+ * const mcpClient = createMCPClient({
+ *   integrations: [githubIntegration({ clientId: '...', clientSecret: '...' })],
+ * });
+ *
+ * await mcpClient.connect();
+ *
+ * const tools = convertMCPToolsToVercelAI(mcpClient);
+ *
+ * const result = await generateText({
+ *   model: openai('gpt-5'),
+ *   prompt: 'Create a GitHub issue in my repo',
+ *   tools,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Server-side usage with token passing
+ * import { createMCPServer, githubIntegration } from 'integrate-sdk/server';
+ * import { convertMCPToolsToVercelAI } from 'integrate-sdk/vercel-ai';
+ *
+ * const { client: serverClient } = createMCPServer({
+ *   integrations: [githubIntegration({ clientId: '...', clientSecret: '...' })],
+ * });
+ *
+ * // In your API route handler
+ * export async function POST(req: Request) {
+ *   const providerTokens = JSON.parse(req.headers.get('x-integrate-tokens') || '{}');
+ *
+ *   const tools = convertMCPToolsToVercelAI(serverClient, { providerTokens });
+ *
+ *   const result = await generateText({
+ *     model: openai('gpt-4'),
+ *     prompt: 'Create a GitHub issue',
+ *     tools,
+ *   });
+ *
+ *   return Response.json(result);
+ * }
+ * ```
+ */
+export declare function convertMCPToolsToVercelAI(client: MCPClient<any>, options?: VercelAIToolsOptions): Record<string, any>;
+/**
+ * Get tools in a format compatible with Vercel AI SDK v5's tools parameter
+ *
+ * This returns the tools in the exact format expected by ai.generateText() and ai.streamText()
+ * Automatically connects the client if not already connected.
+ *
+ * **Auto-extraction**: Provider tokens are automatically extracted from request headers
+ * or environment variables if not provided in options. This works in supported frameworks
+ * like Next.js and Nuxt.
+ *
+ * @param client - The MCP client instance
+ * @param options - Optional configuration including provider tokens for server-side usage
+ * @returns Tools object ready to pass to generateText({ tools: ... }) or streamText({ tools: ... })
+ *
+ * @example
+ * ```typescript
+ * // Auto-extraction (recommended) - tokens extracted automatically
+ * import { serverClient } from '@/lib/integrate-server';
+ * import { getVercelAITools } from 'integrate-sdk';
+ * import { streamText } from 'ai';
+ *
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json();
+ *
+ *   const result = streamText({
+ *     model: "openai/gpt-4",
+ *     messages,
+ *     tools: await getVercelAITools(serverClient), // Tokens auto-extracted
+ *   });
+ *
+ *   return result.toUIMessageStreamResponse();
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Manual override when auto-extraction isn't available
+ * const tools = await getVercelAITools(serverClient, {
+ *   providerTokens: {
+ *     github: 'ghp_...',
+ *     gmail: 'ya29...'
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage (no tokens needed)
+ * const tools = await getVercelAITools(mcpClient);
+ * ```
+ */
+export declare function getVercelAITools(client: MCPClient<any>, options?: VercelAIToolsOptions): Promise<Record<string, any>>;
+//# sourceMappingURL=vercel-ai.d.ts.map

package/dist/ai/vercel-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../../src/ai/vercel-ai.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,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;CAAI;AAEhE;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,YAAY,CAQd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CASrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,oBAAoB,gCAkB/B"}