integrate-sdk 0.7.36 → 0.7.39

package/README.md

@@ -339,7 +339,7 @@ const result = await generateText({
 });
 ```
 
-[→ View Vercel AI SDK integration guide](https://integrate.dev/docs/ai/vercel-ai)
+[→ View Vercel AI SDK integration guide](https://integrate.dev/docs/artificial-intelligence/vercel-ai-sdk)
 
 ## Documentation
 
@@ -348,7 +348,7 @@ For detailed guides, API reference, and examples, visit the [complete documentat
 - **[Getting Started](https://integrate.dev/docs/getting-started/installation)** - Installation and quick start
 - **[OAuth Flow](https://integrate.dev/docs/guides/oauth-flow)** - OAuth 2.0 authorization guide
 - **[Integrations](https://integrate.dev/docs/integrations)** - Built-in integrations and configuration
-- **[Vercel AI SDK](https://integrate.dev/docs/ai/vercel-ai)** - AI model integration
+- **[Vercel AI SDK](https://integrate.dev/docs/artificial-intelligence/vercel-ai-sdk)** - AI model integration
 - **[Advanced Usage](https://integrate.dev/docs/guides/advanced-usage)** - Error handling, retries, and more
 - **[API Reference](https://integrate.dev/docs/reference/api-reference)** - Complete API documentation
 - **[Architecture](https://integrate.dev/docs/reference/architecture)** - How the SDK works

package/dist/ai/anthropic.d.ts

@@ -6,6 +6,7 @@
 import type { MCPClient } from "../client.js";
 import type { MCPTool } from "../protocol/messages.js";
 import { type AIToolsOptions } from "./utils.js";
+import type Anthropic from "@anthropic-ai/sdk";
 /**
  * Anthropic tool definition
  * Compatible with Anthropic's Claude API
@@ -179,4 +180,70 @@ export declare function handleAnthropicToolCalls(client: MCPClient<any>, message
  * ```
  */
 export declare function getAnthropicTools(client: MCPClient<any>, options?: AnthropicToolsOptions): Promise<AnthropicTool[]>;
+/**
+ * Handle an entire Anthropic Message object
+ *
+ * This is a convenience function that extracts tool calls from a Message
+ * object, executes them, and returns the results formatted as MessageParam
+ * ready to be passed directly to the next API call.
+ *
+ * **Auto-extraction**: Provider tokens are automatically extracted from request headers
+ * or environment variables if not provided in options.
+ *
+ * @param client - The MCP client instance
+ * @param message - The complete Message object from Anthropic
+ * @param options - Optional configuration including provider tokens
+ * @returns Array with a single user message containing tool results, or empty array if no tool calls
+ *
+ * @example
+ * ```typescript
+ * import { serverClient } from '@/lib/integrate-server';
+ * import { getAnthropicTools, handleAnthropicMessage } from 'integrate-sdk/server';
+ * import Anthropic from '@anthropic-ai/sdk';
+ *
+ * const anthropic = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
+ *
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json();
+ *
+ *   // Initial request with tools
+ *   const message = await anthropic.messages.create({
+ *     model: 'claude-3-5-sonnet-20241022',
+ *     max_tokens: 1024,
+ *     tools: await getAnthropicTools(serverClient),
+ *     messages,
+ *   });
+ *
+ *   // If there are tool calls, handle them automatically
+ *   if (message.stop_reason === 'tool_use') {
+ *     const toolMessages = await handleAnthropicMessage(serverClient, message);
+ *
+ *     // Continue conversation with tool results
+ *     const finalMessage = await anthropic.messages.create({
+ *       model: 'claude-3-5-sonnet-20241022',
+ *       max_tokens: 1024,
+ *       tools: await getAnthropicTools(serverClient),
+ *       messages: [
+ *         ...messages,
+ *         { role: 'assistant', content: message.content },
+ *         ...toolMessages,
+ *       ],
+ *     });
+ *
+ *     return Response.json(finalMessage);
+ *   }
+ *
+ *   return Response.json(message);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Manual token override
+ * const toolMessages = await handleAnthropicMessage(serverClient, message, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function handleAnthropicMessage(client: MCPClient<any>, message: Anthropic.Messages.Message, options?: AnthropicToolsOptions): Promise<Anthropic.Messages.MessageParam[]>;
 //# sourceMappingURL=anthropic.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/ai/anthropic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAkE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;CAAI;AAEjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EACvB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,aAAa,CAUf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,EAAE,CAGjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,cAAc,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAA,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC,EAC1D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAkCrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,aAAa,EAAE,CAAC,CAe1B"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/ai/anthropic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAkE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACjH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;CAAI;AAEjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EACvB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,aAAa,CAUf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,EAAE,CAGjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,cAAc,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAA,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC,EAC1D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAkCrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,aAAa,EAAE,CAAC,CAe1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,OAAO,EACnC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,CA4B5C"}

package/dist/ai/anthropic.js

@@ -4256,8 +4256,28 @@ async function getAnthropicTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   return convertMCPToolsToAnthropic(client, finalOptions);
 }
+async function handleAnthropicMessage(client, message, options) {
+  let providerTokens = options?.providerTokens;
+  if (!providerTokens) {
+    try {
+      providerTokens = await getProviderTokens();
+    } catch {}
+  }
+  const finalOptions = providerTokens ? { ...options, providerTokens } : options;
+  const toolResults = await handleAnthropicToolCalls(client, message.content, finalOptions);
+  if (toolResults.length === 0) {
+    return [];
+  }
+  return [
+    {
+      role: "user",
+      content: toolResults
+    }
+  ];
+}
 export {
   handleAnthropicToolCalls,
+  handleAnthropicMessage,
   getAnthropicTools,
   executeAnthropicToolCall,
   convertMCPToolsToAnthropic,

package/dist/ai/index.js

@@ -4256,6 +4256,25 @@ async function getAnthropicTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   return convertMCPToolsToAnthropic(client, finalOptions);
 }
+async function handleAnthropicMessage(client, message, options) {
+  let providerTokens = options?.providerTokens;
+  if (!providerTokens) {
+    try {
+      providerTokens = await getProviderTokens();
+    } catch {}
+  }
+  const finalOptions = providerTokens ? { ...options, providerTokens } : options;
+  const toolResults = await handleAnthropicToolCalls(client, message.content, finalOptions);
+  if (toolResults.length === 0) {
+    return [];
+  }
+  return [
+    {
+      role: "user",
+      content: toolResults
+    }
+  ];
+}
 
 // cloudflare.ts
 function convertMCPToolToCloudflare(mcpTool, _client, _options) {
@@ -4366,13 +4385,9 @@ function convertMCPToolToOpenAI(mcpTool, _client, options) {
   return {
     type: "function",
     name: mcpTool.name,
-    description: mcpTool.description || `Execute ${mcpTool.name}`,
-    parameters: inputParams || {
-      type: "object",
-      properties: {},
-      required: []
-    },
-    strict: options?.strict ?? false
+    parameters: inputParams || null,
+    strict: options?.strict ?? null,
+    description: mcpTool.description || null
   };
 }
 function convertMCPToolsToOpenAI(client, options) {
@@ -4395,6 +4410,46 @@ async function getOpenAITools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   return convertMCPToolsToOpenAI(client, finalOptions);
 }
+async function handleOpenAIToolCalls(client, toolCalls, options) {
+  const toolOutputs = [];
+  for (const output of toolCalls) {
+    if (output.type === "function_call") {
+      const toolCall = {
+        id: output.id ?? "",
+        name: output.name,
+        arguments: output.arguments
+      };
+      try {
+        const result = await executeOpenAIToolCall(client, toolCall, options);
+        toolOutputs.push({
+          call_id: output.call_id ?? output.id ?? "",
+          type: "function_call_output",
+          output: result,
+          status: "completed"
+        });
+      } catch (error) {
+        toolOutputs.push({
+          call_id: output.call_id ?? output.id ?? "",
+          type: "function_call_output",
+          output: error instanceof Error ? error.message : "Unknown error",
+          status: "incomplete"
+        });
+      }
+    }
+  }
+  return toolOutputs;
+}
+async function handleOpenAIResponse(client, response, options) {
+  let providerTokens = options?.providerTokens;
+  if (!providerTokens) {
+    try {
+      providerTokens = await getProviderTokens();
+    } catch {}
+  }
+  const finalOptions = providerTokens ? { ...options, providerTokens } : options;
+  const functionCalls = response.output.filter((output) => output.type === "function_call");
+  return handleOpenAIToolCalls(client, functionCalls, finalOptions);
+}
 
 // openai-agents.ts
 function convertMCPToolToOpenAIAgents(mcpTool, client, options) {
@@ -4540,7 +4595,10 @@ export {
   tryGetProviderTokens,
   jsonSchemaToZod,
   jsonSchemaPropertyToZod,
+  handleOpenAIToolCalls,
+  handleOpenAIResponse,
   handleAnthropicToolCalls,
+  handleAnthropicMessage,
   getVercelAITools,
   getProviderTokens,
   getProviderForTool,

package/dist/ai/openai.d.ts

@@ -6,6 +6,7 @@
 import type { MCPClient } from "../client.js";
 import type { MCPTool } from "../protocol/messages.js";
 import { type AIToolsOptions } from "./utils.js";
+import type { OpenAI } from "openai";
 /**
  * OpenAI function tool definition
  * Compatible with OpenAI's Responses API format
@@ -13,14 +14,11 @@ import { type AIToolsOptions } from "./utils.js";
 export interface OpenAITool {
     type: 'function';
     name: string;
-    description?: string;
     parameters: {
-        type: 'object';
-        properties?: Record<string, unknown>;
-        required?: string[];
         [key: string]: unknown;
-    };
-    strict?: boolean;
+    } | null;
+    strict: boolean | null;
+    description?: string | null;
 }
 /**
  * Options for converting MCP tools to OpenAI format
@@ -127,4 +125,100 @@ export declare function executeOpenAIToolCall(client: MCPClient<any>, toolCall:
  * ```
  */
 export declare function getOpenAITools(client: MCPClient<any>, options?: OpenAIToolsOptions): Promise<OpenAITool[]>;
+/**
+ * Handle multiple tool calls from OpenAI's response output
+ *
+ * This function processes all function_call items from the response output,
+ * executes each tool call, and returns formatted results for the next request.
+ *
+ * @param client - The MCP client instance
+ * @param toolCalls - Array of output items from OpenAI response (filters for function_call type)
+ * @param options - Optional configuration including provider tokens
+ * @returns Array of function call outputs to send back to OpenAI
+ *
+ * @example
+ * ```typescript
+ * // Handle tool calls from a response
+ * const response = await openai.responses.create({
+ *   model: 'gpt-4o-2024-11-20',
+ *   input: 'Create a GitHub issue',
+ *   tools: await getOpenAITools(serverClient),
+ * });
+ *
+ * // Execute the tool calls and get outputs
+ * const toolOutputs = await handleOpenAIToolCalls(
+ *   serverClient,
+ *   response.output,
+ *   { providerTokens }
+ * );
+ *
+ * // Continue the conversation with tool results
+ * const nextResponse = await openai.responses.create({
+ *   model: 'gpt-4o-2024-11-20',
+ *   input: toolOutputs,
+ *   tools: await getOpenAITools(serverClient),
+ * });
+ * ```
+ */
+export declare function handleOpenAIToolCalls(client: MCPClient<any>, toolCalls: OpenAI.Responses.ResponseOutputItem[], options?: OpenAIToolsOptions): Promise<OpenAI.Responses.ResponseInputItem.FunctionCallOutput[]>;
+/**
+ * Handle an entire OpenAI Response object
+ *
+ * This is a convenience function that extracts tool calls from a Response
+ * object and executes them. Use this when you want to process all tool
+ * calls from a response in one go.
+ *
+ * **Auto-extraction**: Provider tokens are automatically extracted from request headers
+ * or environment variables if not provided in options.
+ *
+ * @param client - The MCP client instance
+ * @param response - The complete Response object from OpenAI
+ * @param options - Optional configuration including provider tokens
+ * @returns Array of function call outputs to send back to OpenAI
+ *
+ * @example
+ * ```typescript
+ * import { serverClient } from '@/lib/integrate-server';
+ * import { getOpenAITools, handleOpenAIResponse } from 'integrate-sdk/server';
+ * import OpenAI from 'openai';
+ *
+ * const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+ *
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json();
+ *
+ *   // Initial request with tools
+ *   const response = await openai.responses.create({
+ *     model: 'gpt-4o-2024-11-20',
+ *     input: messages,
+ *     tools: await getOpenAITools(serverClient),
+ *   });
+ *
+ *   // If there are tool calls, handle them automatically
+ *   if (response.output.some(item => item.type === 'function_call')) {
+ *     const toolOutputs = await handleOpenAIResponse(serverClient, response);
+ *
+ *     // Continue conversation with tool results
+ *     const finalResponse = await openai.responses.create({
+ *       model: 'gpt-4o-2024-11-20',
+ *       input: toolOutputs,
+ *       tools: await getOpenAITools(serverClient),
+ *     });
+ *
+ *     return Response.json(finalResponse);
+ *   }
+ *
+ *   return Response.json(response);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Manual token override
+ * const toolOutputs = await handleOpenAIResponse(serverClient, response, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function handleOpenAIResponse(client: MCPClient<any>, response: OpenAI.Responses.Response, options?: OpenAIToolsOptions): Promise<OpenAI.Responses.ResponseInputItem.FunctionCallOutput[]>;
 //# sourceMappingURL=openai.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/ai/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAkE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EACvB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,CAcZ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAGd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE;IACR,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,EACD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAevB"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/ai/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAkE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACjH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EACvB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,CAUZ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAGd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE;IACR,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,EACD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAevB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,kBAAkB,EAAE,EAChD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,CAAC,CA+BlE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,CAAC,CAoBlE"}

package/dist/ai/openai.js

@@ -4208,13 +4208,9 @@ function convertMCPToolToOpenAI(mcpTool, _client, options) {
   return {
     type: "function",
     name: mcpTool.name,
-    description: mcpTool.description || `Execute ${mcpTool.name}`,
-    parameters: inputParams || {
-      type: "object",
-      properties: {},
-      required: []
-    },
-    strict: options?.strict ?? false
+    parameters: inputParams || null,
+    strict: options?.strict ?? null,
+    description: mcpTool.description || null
   };
 }
 function convertMCPToolsToOpenAI(client, options) {
@@ -4237,7 +4233,49 @@ async function getOpenAITools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   return convertMCPToolsToOpenAI(client, finalOptions);
 }
+async function handleOpenAIToolCalls(client, toolCalls, options) {
+  const toolOutputs = [];
+  for (const output of toolCalls) {
+    if (output.type === "function_call") {
+      const toolCall = {
+        id: output.id ?? "",
+        name: output.name,
+        arguments: output.arguments
+      };
+      try {
+        const result = await executeOpenAIToolCall(client, toolCall, options);
+        toolOutputs.push({
+          call_id: output.call_id ?? output.id ?? "",
+          type: "function_call_output",
+          output: result,
+          status: "completed"
+        });
+      } catch (error) {
+        toolOutputs.push({
+          call_id: output.call_id ?? output.id ?? "",
+          type: "function_call_output",
+          output: error instanceof Error ? error.message : "Unknown error",
+          status: "incomplete"
+        });
+      }
+    }
+  }
+  return toolOutputs;
+}
+async function handleOpenAIResponse(client, response, options) {
+  let providerTokens = options?.providerTokens;
+  if (!providerTokens) {
+    try {
+      providerTokens = await getProviderTokens();
+    } catch {}
+  }
+  const finalOptions = providerTokens ? { ...options, providerTokens } : options;
+  const functionCalls = response.output.filter((output) => output.type === "function_call");
+  return handleOpenAIToolCalls(client, functionCalls, finalOptions);
+}
 export {
+  handleOpenAIToolCalls,
+  handleOpenAIResponse,
   getOpenAITools,
   executeOpenAIToolCall,
   convertMCPToolsToOpenAI,

package/dist/server.js

@@ -6507,13 +6507,9 @@ function convertMCPToolToOpenAI(mcpTool, _client, options) {
   return {
     type: "function",
     name: mcpTool.name,
-    description: mcpTool.description || `Execute ${mcpTool.name}`,
-    parameters: inputParams || {
-      type: "object",
-      properties: {},
-      required: []
-    },
-    strict: options?.strict ?? false
+    parameters: inputParams || null,
+    strict: options?.strict ?? null,
+    description: mcpTool.description || null
   };
 }
 function convertMCPToolsToOpenAI(client, options) {
@@ -6536,6 +6532,46 @@ async function getOpenAITools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   return convertMCPToolsToOpenAI(client, finalOptions);
 }
+async function handleOpenAIToolCalls(client, toolCalls, options) {
+  const toolOutputs = [];
+  for (const output of toolCalls) {
+    if (output.type === "function_call") {
+      const toolCall = {
+        id: output.id ?? "",
+        name: output.name,
+        arguments: output.arguments
+      };
+      try {
+        const result = await executeOpenAIToolCall(client, toolCall, options);
+        toolOutputs.push({
+          call_id: output.call_id ?? output.id ?? "",
+          type: "function_call_output",
+          output: result,
+          status: "completed"
+        });
+      } catch (error) {
+        toolOutputs.push({
+          call_id: output.call_id ?? output.id ?? "",
+          type: "function_call_output",
+          output: error instanceof Error ? error.message : "Unknown error",
+          status: "incomplete"
+        });
+      }
+    }
+  }
+  return toolOutputs;
+}
+async function handleOpenAIResponse(client, response, options) {
+  let providerTokens = options?.providerTokens;
+  if (!providerTokens) {
+    try {
+      providerTokens = await getProviderTokens();
+    } catch {}
+  }
+  const finalOptions = providerTokens ? { ...options, providerTokens } : options;
+  const functionCalls = response.output.filter((output) => output.type === "function_call");
+  return handleOpenAIToolCalls(client, functionCalls, finalOptions);
+}
 // src/ai/openai-agents.ts
 function convertMCPToolToOpenAIAgents(mcpTool, client, options) {
   return {
@@ -6616,6 +6652,25 @@ async function getAnthropicTools(client, options) {
   const finalOptions = providerTokens ? { ...options, providerTokens } : options;
   return convertMCPToolsToAnthropic(client, finalOptions);
 }
+async function handleAnthropicMessage(client, message, options) {
+  let providerTokens = options?.providerTokens;
+  if (!providerTokens) {
+    try {
+      providerTokens = await getProviderTokens();
+    } catch {}
+  }
+  const finalOptions = providerTokens ? { ...options, providerTokens } : options;
+  const toolResults = await handleAnthropicToolCalls(client, message.content, finalOptions);
+  if (toolResults.length === 0) {
+    return [];
+  }
+  return [
+    {
+      role: "user",
+      content: toolResults
+    }
+  ];
+}
 // src/ai/google.ts
 function convertMCPToolToGoogle(mcpTool, _client, _options) {
   return {
@@ -6967,7 +7022,10 @@ export {
   svelteKitHandler,
   jsonSchemaToZod,
   jsonSchemaPropertyToZod,
+  handleOpenAIToolCalls,
+  handleOpenAIResponse,
   handleAnthropicToolCalls,
+  handleAnthropicMessage,
   gmailIntegration,
   githubIntegration,
   getVercelAITools,

package/dist/src/ai/anthropic.d.ts

@@ -6,6 +6,7 @@
 import type { MCPClient } from "../client.js";
 import type { MCPTool } from "../protocol/messages.js";
 import { type AIToolsOptions } from "./utils.js";
+import type Anthropic from "@anthropic-ai/sdk";
 /**
  * Anthropic tool definition
  * Compatible with Anthropic's Claude API
@@ -179,4 +180,70 @@ export declare function handleAnthropicToolCalls(client: MCPClient<any>, message
  * ```
  */
 export declare function getAnthropicTools(client: MCPClient<any>, options?: AnthropicToolsOptions): Promise<AnthropicTool[]>;
+/**
+ * Handle an entire Anthropic Message object
+ *
+ * This is a convenience function that extracts tool calls from a Message
+ * object, executes them, and returns the results formatted as MessageParam
+ * ready to be passed directly to the next API call.
+ *
+ * **Auto-extraction**: Provider tokens are automatically extracted from request headers
+ * or environment variables if not provided in options.
+ *
+ * @param client - The MCP client instance
+ * @param message - The complete Message object from Anthropic
+ * @param options - Optional configuration including provider tokens
+ * @returns Array with a single user message containing tool results, or empty array if no tool calls
+ *
+ * @example
+ * ```typescript
+ * import { serverClient } from '@/lib/integrate-server';
+ * import { getAnthropicTools, handleAnthropicMessage } from 'integrate-sdk/server';
+ * import Anthropic from '@anthropic-ai/sdk';
+ *
+ * const anthropic = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
+ *
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json();
+ *
+ *   // Initial request with tools
+ *   const message = await anthropic.messages.create({
+ *     model: 'claude-3-5-sonnet-20241022',
+ *     max_tokens: 1024,
+ *     tools: await getAnthropicTools(serverClient),
+ *     messages,
+ *   });
+ *
+ *   // If there are tool calls, handle them automatically
+ *   if (message.stop_reason === 'tool_use') {
+ *     const toolMessages = await handleAnthropicMessage(serverClient, message);
+ *
+ *     // Continue conversation with tool results
+ *     const finalMessage = await anthropic.messages.create({
+ *       model: 'claude-3-5-sonnet-20241022',
+ *       max_tokens: 1024,
+ *       tools: await getAnthropicTools(serverClient),
+ *       messages: [
+ *         ...messages,
+ *         { role: 'assistant', content: message.content },
+ *         ...toolMessages,
+ *       ],
+ *     });
+ *
+ *     return Response.json(finalMessage);
+ *   }
+ *
+ *   return Response.json(message);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Manual token override
+ * const toolMessages = await handleAnthropicMessage(serverClient, message, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function handleAnthropicMessage(client: MCPClient<any>, message: Anthropic.Messages.Message, options?: AnthropicToolsOptions): Promise<Anthropic.Messages.MessageParam[]>;
 //# sourceMappingURL=anthropic.d.ts.map

package/dist/src/ai/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/ai/anthropic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAkE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;CAAI;AAEjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EACvB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,aAAa,CAUf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,EAAE,CAGjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,cAAc,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAA,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC,EAC1D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAkCrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,aAAa,EAAE,CAAC,CAe1B"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/ai/anthropic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAkE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACjH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;CAAI;AAEjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EACvB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,aAAa,CAUf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,EAAE,CAGjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,cAAc,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAA,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC,EAC1D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAkCrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,aAAa,EAAE,CAAC,CAe1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,OAAO,EACnC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,CA4B5C"}

package/dist/src/ai/openai.d.ts

@@ -6,6 +6,7 @@
 import type { MCPClient } from "../client.js";
 import type { MCPTool } from "../protocol/messages.js";
 import { type AIToolsOptions } from "./utils.js";
+import type { OpenAI } from "openai";
 /**
  * OpenAI function tool definition
  * Compatible with OpenAI's Responses API format
@@ -13,14 +14,11 @@ import { type AIToolsOptions } from "./utils.js";
 export interface OpenAITool {
     type: 'function';
     name: string;
-    description?: string;
     parameters: {
-        type: 'object';
-        properties?: Record<string, unknown>;
-        required?: string[];
         [key: string]: unknown;
-    };
-    strict?: boolean;
+    } | null;
+    strict: boolean | null;
+    description?: string | null;
 }
 /**
  * Options for converting MCP tools to OpenAI format
@@ -127,4 +125,100 @@ export declare function executeOpenAIToolCall(client: MCPClient<any>, toolCall:
  * ```
  */
 export declare function getOpenAITools(client: MCPClient<any>, options?: OpenAIToolsOptions): Promise<OpenAITool[]>;
+/**
+ * Handle multiple tool calls from OpenAI's response output
+ *
+ * This function processes all function_call items from the response output,
+ * executes each tool call, and returns formatted results for the next request.
+ *
+ * @param client - The MCP client instance
+ * @param toolCalls - Array of output items from OpenAI response (filters for function_call type)
+ * @param options - Optional configuration including provider tokens
+ * @returns Array of function call outputs to send back to OpenAI
+ *
+ * @example
+ * ```typescript
+ * // Handle tool calls from a response
+ * const response = await openai.responses.create({
+ *   model: 'gpt-4o-2024-11-20',
+ *   input: 'Create a GitHub issue',
+ *   tools: await getOpenAITools(serverClient),
+ * });
+ *
+ * // Execute the tool calls and get outputs
+ * const toolOutputs = await handleOpenAIToolCalls(
+ *   serverClient,
+ *   response.output,
+ *   { providerTokens }
+ * );
+ *
+ * // Continue the conversation with tool results
+ * const nextResponse = await openai.responses.create({
+ *   model: 'gpt-4o-2024-11-20',
+ *   input: toolOutputs,
+ *   tools: await getOpenAITools(serverClient),
+ * });
+ * ```
+ */
+export declare function handleOpenAIToolCalls(client: MCPClient<any>, toolCalls: OpenAI.Responses.ResponseOutputItem[], options?: OpenAIToolsOptions): Promise<OpenAI.Responses.ResponseInputItem.FunctionCallOutput[]>;
+/**
+ * Handle an entire OpenAI Response object
+ *
+ * This is a convenience function that extracts tool calls from a Response
+ * object and executes them. Use this when you want to process all tool
+ * calls from a response in one go.
+ *
+ * **Auto-extraction**: Provider tokens are automatically extracted from request headers
+ * or environment variables if not provided in options.
+ *
+ * @param client - The MCP client instance
+ * @param response - The complete Response object from OpenAI
+ * @param options - Optional configuration including provider tokens
+ * @returns Array of function call outputs to send back to OpenAI
+ *
+ * @example
+ * ```typescript
+ * import { serverClient } from '@/lib/integrate-server';
+ * import { getOpenAITools, handleOpenAIResponse } from 'integrate-sdk/server';
+ * import OpenAI from 'openai';
+ *
+ * const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+ *
+ * export async function POST(req: Request) {
+ *   const { messages } = await req.json();
+ *
+ *   // Initial request with tools
+ *   const response = await openai.responses.create({
+ *     model: 'gpt-4o-2024-11-20',
+ *     input: messages,
+ *     tools: await getOpenAITools(serverClient),
+ *   });
+ *
+ *   // If there are tool calls, handle them automatically
+ *   if (response.output.some(item => item.type === 'function_call')) {
+ *     const toolOutputs = await handleOpenAIResponse(serverClient, response);
+ *
+ *     // Continue conversation with tool results
+ *     const finalResponse = await openai.responses.create({
+ *       model: 'gpt-4o-2024-11-20',
+ *       input: toolOutputs,
+ *       tools: await getOpenAITools(serverClient),
+ *     });
+ *
+ *     return Response.json(finalResponse);
+ *   }
+ *
+ *   return Response.json(response);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Manual token override
+ * const toolOutputs = await handleOpenAIResponse(serverClient, response, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function handleOpenAIResponse(client: MCPClient<any>, response: OpenAI.Responses.Response, options?: OpenAIToolsOptions): Promise<OpenAI.Responses.ResponseInputItem.FunctionCallOutput[]>;
 //# sourceMappingURL=openai.d.ts.map

package/dist/src/ai/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/ai/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAkE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EACvB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,CAcZ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAGd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE;IACR,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,EACD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAevB"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/ai/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAkE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACjH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EACvB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,CAUZ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAGd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE;IACR,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,EACD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAevB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,kBAAkB,EAAE,EAChD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,CAAC,CA+BlE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,CAAC,CAoBlE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "integrate-sdk",
-  "version": "0.7.36",
+  "version": "0.7.39",
   "description": "Type-safe 3rd party integration SDK for the Integrate MCP server",
   "type": "module",
   "main": "./dist/index.js",
@@ -71,8 +71,10 @@
     "zod": "^3.23.8"
   },
   "devDependencies": {
+    "@anthropic-ai/sdk": "^0.32.1",
     "@types/bun": "latest",
     "@types/react": "^18.3.0",
+    "openai": "^4.77.3",
     "react": "^19.2.0",
     "simple-git-hooks": "^2.13.1",
     "typescript": "^5.3.3"