integrate-sdk 0.7.23 → 0.7.25

package/dist/ai/openai.d.ts

@@ -0,0 +1,130 @@
+/**
+ * OpenAI Responses API Integration
+ *
+ * Helper functions to convert MCP tools to OpenAI Responses API format
+ */
+import type { MCPClient } from "../client.js";
+import type { MCPTool } from "../protocol/messages.js";
+import { type AIToolsOptions } from "./utils.js";
+/**
+ * OpenAI function tool definition
+ * Compatible with OpenAI's Responses API format
+ */
+export interface OpenAITool {
+    type: 'function';
+    name: string;
+    description?: string;
+    parameters: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+    strict?: boolean;
+}
+/**
+ * Options for converting MCP tools to OpenAI format
+ */
+export interface OpenAIToolsOptions extends AIToolsOptions {
+    /**
+     * Whether to use strict mode for function calls
+     * @default false
+     */
+    strict?: boolean;
+}
+/**
+ * Convert a single MCP tool to OpenAI Responses API 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 and strict mode
+ * @returns OpenAI compatible tool definition
+ *
+ * @example
+ * ```typescript
+ * const openaiTool = convertMCPToolToOpenAI(mcpTool, client, { strict: true });
+ * ```
+ */
+export declare function convertMCPToolToOpenAI(mcpTool: MCPTool, _client: MCPClient<any>, options?: OpenAIToolsOptions): OpenAITool;
+/**
+ * Convert all enabled MCP tools to OpenAI Responses API format
+ *
+ * @param client - The MCP client instance (must be connected)
+ * @param options - Optional configuration including provider tokens and strict mode
+ * @returns Array of OpenAI compatible tool definitions
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage
+ * const tools = convertMCPToolsToOpenAI(mcpClient);
+ *
+ * // Server-side with provider tokens
+ * const tools = convertMCPToolsToOpenAI(serverClient, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function convertMCPToolsToOpenAI(client: MCPClient<any>, options?: OpenAIToolsOptions): OpenAITool[];
+/**
+ * Execute a tool call from OpenAI's response
+ *
+ * @param client - The MCP client instance
+ * @param toolCall - The tool call from OpenAI response
+ * @param options - Optional configuration including provider tokens
+ * @returns Tool execution result as JSON string
+ *
+ * @example
+ * ```typescript
+ * const result = await executeOpenAIToolCall(client, {
+ *   id: 'call_123',
+ *   name: 'github_create_issue',
+ *   arguments: '{"owner":"user","repo":"repo","title":"Bug"}'
+ * }, { providerTokens });
+ * ```
+ */
+export declare function executeOpenAIToolCall(client: MCPClient<any>, toolCall: {
+    id: string;
+    name: string;
+    arguments: string;
+}, options?: OpenAIToolsOptions): Promise<string>;
+/**
+ * Get tools in a format compatible with OpenAI Responses API
+ *
+ * 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.
+ *
+ * @param client - The MCP client instance
+ * @param options - Optional configuration including provider tokens for server-side usage
+ * @returns Array of tools ready to pass to OpenAI's Responses API
+ *
+ * @example
+ * ```typescript
+ * // Auto-extraction (recommended)
+ * import { serverClient } from '@/lib/integrate-server';
+ * import { getOpenAITools, executeOpenAIToolCall } from 'integrate-sdk';
+ *
+ * export async function POST(req: Request) {
+ *   const tools = await getOpenAITools(serverClient); // Tokens auto-extracted
+ *
+ *   const response = await openai.responses.create({
+ *     model: 'gpt-4o-2024-11-20',
+ *     input: 'Create a GitHub issue',
+ *     tools,
+ *   });
+ *
+ *   return Response.json(response);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Manual override
+ * const tools = await getOpenAITools(serverClient, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function getOpenAITools(client: MCPClient<any>, options?: OpenAIToolsOptions): Promise<OpenAITool[]>;
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +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"}