integrate-sdk 0.7.22 → 0.7.24

package/dist/ai/anthropic.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Anthropic Claude Integration
+ *
+ * Helper functions to convert MCP tools to Anthropic Claude API format
+ */
+import type { MCPClient } from "../client.js";
+import type { MCPTool } from "../protocol/messages.js";
+import { type AIToolsOptions } from "./utils.js";
+/**
+ * Anthropic tool definition
+ * Compatible with Anthropic's Claude API
+ */
+export interface AnthropicTool {
+    name: string;
+    description: string;
+    input_schema: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+}
+/**
+ * Options for converting MCP tools to Anthropic format
+ */
+export interface AnthropicToolsOptions extends AIToolsOptions {
+}
+/**
+ * Anthropic tool use block from message content
+ */
+export interface AnthropicToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Anthropic tool result block for responses
+ */
+export interface AnthropicToolResultBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+}
+/**
+ * Convert a single MCP tool to Anthropic Claude 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
+ * @returns Anthropic compatible tool definition
+ *
+ * @example
+ * ```typescript
+ * const anthropicTool = convertMCPToolToAnthropic(mcpTool, client);
+ * ```
+ */
+export declare function convertMCPToolToAnthropic(mcpTool: MCPTool, _client: MCPClient<any>, _options?: AnthropicToolsOptions): AnthropicTool;
+/**
+ * Convert all enabled MCP tools to Anthropic Claude API format
+ *
+ * @param client - The MCP client instance (must be connected)
+ * @param options - Optional configuration including provider tokens
+ * @returns Array of Anthropic compatible tool definitions
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage
+ * const tools = convertMCPToolsToAnthropic(mcpClient);
+ *
+ * // Server-side with provider tokens
+ * const tools = convertMCPToolsToAnthropic(serverClient, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function convertMCPToolsToAnthropic(client: MCPClient<any>, options?: AnthropicToolsOptions): AnthropicTool[];
+/**
+ * Execute a tool call from Anthropic's response
+ *
+ * @param client - The MCP client instance
+ * @param toolUse - The tool use block from Anthropic response
+ * @param options - Optional configuration including provider tokens
+ * @returns Tool execution result as JSON string
+ *
+ * @example
+ * ```typescript
+ * const result = await executeAnthropicToolCall(client, {
+ *   type: 'tool_use',
+ *   id: 'toolu_123',
+ *   name: 'github_create_issue',
+ *   input: { owner: 'user', repo: 'repo', title: 'Bug' }
+ * }, { providerTokens });
+ * ```
+ */
+export declare function executeAnthropicToolCall(client: MCPClient<any>, toolUse: AnthropicToolUseBlock, options?: AnthropicToolsOptions): Promise<string>;
+/**
+ * Handle all tool calls from Anthropic's message response
+ * Executes all tool use blocks and returns tool result blocks
+ *
+ * @param client - The MCP client instance
+ * @param messageContent - Array of content blocks from Anthropic message
+ * @param options - Optional configuration including provider tokens
+ * @returns Array of tool result blocks ready to send back to Claude
+ *
+ * @example
+ * ```typescript
+ * const response = await anthropic.messages.create({
+ *   model: 'claude-3-5-sonnet-20241022',
+ *   max_tokens: 1024,
+ *   tools,
+ *   messages: [{ role: 'user', content: 'Create a GitHub issue' }]
+ * });
+ *
+ * // Handle tool calls
+ * const toolResults = await handleAnthropicToolCalls(
+ *   client,
+ *   response.content,
+ *   { providerTokens }
+ * );
+ *
+ * // Continue conversation with tool results
+ * const finalResponse = await anthropic.messages.create({
+ *   model: 'claude-3-5-sonnet-20241022',
+ *   max_tokens: 1024,
+ *   tools,
+ *   messages: [
+ *     { role: 'user', content: 'Create a GitHub issue' },
+ *     { role: 'assistant', content: response.content },
+ *     { role: 'user', content: toolResults }
+ *   ]
+ * });
+ * ```
+ */
+export declare function handleAnthropicToolCalls(client: MCPClient<any>, messageContent: Array<{
+    type: string;
+    [key: string]: any;
+}>, options?: AnthropicToolsOptions): Promise<AnthropicToolResultBlock[]>;
+/**
+ * Get tools in a format compatible with Anthropic Claude 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 Claude API
+ *
+ * @example
+ * ```typescript
+ * // Auto-extraction (recommended)
+ * import { serverClient } from '@/lib/integrate-server';
+ * import { getAnthropicTools, handleAnthropicToolCalls } from 'integrate-sdk';
+ * import Anthropic from '@anthropic-ai/sdk';
+ *
+ * export async function POST(req: Request) {
+ *   const tools = await getAnthropicTools(serverClient); // Tokens auto-extracted
+ *
+ *   const anthropic = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
+ *   const message = await anthropic.messages.create({
+ *     model: 'claude-3-5-sonnet-20241022',
+ *     max_tokens: 1024,
+ *     tools,
+ *     messages: [{ role: 'user', content: 'Create a GitHub issue' }]
+ *   });
+ *
+ *   return Response.json(message);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Manual override
+ * const tools = await getAnthropicTools(serverClient, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function getAnthropicTools(client: MCPClient<any>, options?: AnthropicToolsOptions): Promise<AnthropicTool[]>;
+//# sourceMappingURL=anthropic.d.ts.map

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

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