integrate-sdk 0.6.5 → 0.6.7

package/dist/src/adapters/tanstack-start.d.ts

@@ -2,168 +2,52 @@
  * TanStack Start OAuth Route Adapter
  * Provides OAuth route handlers for TanStack Start
  */
-import { type OAuthHandlerConfig } from './base-handler.js';
 /**
  * Create TanStack Start OAuth route handlers
  *
  * Use this to create secure OAuth API routes in your TanStack Start application
  * that handle authorization with server-side secrets.
  *
- * @param config - OAuth handler configuration with MCP server URL and provider credentials
- * @returns Object with authorize, callback, and status route handlers
+ * @param handler - Handler function from createMCPServer
+ * @returns Object with GET and POST handlers for catch-all routes
  *
  * @example
  * ```typescript
- * // app/routes/api/integrate/oauth/authorize.ts
- * import { createTanStackOAuthHandler } from 'integrate-sdk';
- * import { json } from '@tanstack/start';
+ * // lib/integrate-server.ts
+ * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
  *
- * const handler = createTanStackOAuthHandler({
- *   providers: {
- *     github: {
+ * export const { client: serverClient, handler } = createMCPServer({
+ *   plugins: [
+ *     githubPlugin({
  *       clientId: process.env.GITHUB_CLIENT_ID!,
  *       clientSecret: process.env.GITHUB_CLIENT_SECRET!,
- *     },
- *     gmail: {
- *       clientId: process.env.GMAIL_CLIENT_ID!,
- *       clientSecret: process.env.GMAIL_CLIENT_SECRET!,
+ *     }),
+ *   ],
+ * });
+ *
+ * // app/routes/api/auth/$.ts
+ * import { toTanStackStartHandler } from 'integrate-sdk/adapters/tanstack-start';
+ * import { handler } from '@/lib/integrate-server';
+ *
+ * const handlers = toTanStackStartHandler(handler);
+ *
+ * export const Route = createFileRoute('/api/auth/$')({
+ *   server: {
+ *     handlers: {
+ *       GET: handlers.GET,
+ *       POST: handlers.POST,
  *     },
  *   },
  * });
- *
- * export const POST = handler.authorize;
  * ```
  */
-export declare function createTanStackOAuthHandler(config: OAuthHandlerConfig): {
-    /**
-     * POST /api/integrate/oauth/authorize
-     *
-     * Request authorization URL from MCP server with server-side OAuth credentials
-     *
-     * Request body:
-     * ```json
-     * {
-     *   "provider": "github",
-     *   "scopes": ["repo", "user"],
-     *   "state": "random-state-string",
-     *   "codeChallenge": "pkce-code-challenge",
-     *   "codeChallengeMethod": "S256",
-     *   "redirectUri": "https://yourapp.com/oauth/callback"
-     * }
-     * ```
-     *
-     * Response:
-     * ```json
-     * {
-     *   "authorizationUrl": "https://github.com/login/oauth/authorize?..."
-     * }
-     * ```
-     *
-     * @example
-     * ```typescript
-     * // app/routes/api/integrate/oauth/authorize.ts
-     * import { createTanStackOAuthHandler } from 'integrate-sdk';
-     *
-     * const handler = createTanStackOAuthHandler({
-     *        *   providers: {
-     *     github: {
-     *       clientId: process.env.GITHUB_CLIENT_ID!,
-     *       clientSecret: process.env.GITHUB_CLIENT_SECRET!,
-     *     },
-     *   },
-     * });
-     *
-     * export const POST = handler.authorize;
-     * ```
-     */
-    authorize({ request }: {
-        request: Request;
-    }): Promise<Response>;
-    /**
-     * POST /api/integrate/oauth/callback
-     *
-     * Exchange authorization code for session token
-     *
-     * Request body:
-     * ```json
-     * {
-     *   "provider": "github",
-     *   "code": "authorization-code",
-     *   "codeVerifier": "pkce-code-verifier",
-     *   "state": "state-from-authorize"
-     * }
-     * ```
-     *
-     * Response:
-     * ```json
-     * {
-     *   "sessionToken": "session-token-123",
-     *   "provider": "github",
-     *   "scopes": ["repo", "user"],
-     *   "expiresAt": 1234567890
-     * }
-     * ```
-     *
-     * @example
-     * ```typescript
-     * // app/routes/api/integrate/oauth/callback.ts
-     * import { createTanStackOAuthHandler } from 'integrate-sdk';
-     *
-     * const handler = createTanStackOAuthHandler({
-     *        *   providers: {
-     *     github: {
-     *       clientId: process.env.GITHUB_CLIENT_ID!,
-     *       clientSecret: process.env.GITHUB_CLIENT_SECRET!,
-     *     },
-     *   },
-     * });
-     *
-     * export const POST = handler.callback;
-     * ```
-     */
-    callback({ request }: {
+export declare function toTanStackStartHandler(handler: (request: Request) => Promise<Response>): {
+    GET: ({ request }: {
         request: Request;
-    }): Promise<Response>;
-    /**
-     * GET /api/integrate/oauth/status?provider=github
-     *
-     * Check if a provider is currently authorized
-     *
-     * Query parameters:
-     * - provider: Provider to check (e.g., "github")
-     *
-     * Headers:
-     * - X-Session-Token: Session token from previous authorization
-     *
-     * Response:
-     * ```json
-     * {
-     *   "authorized": true,
-     *   "provider": "github",
-     *   "scopes": ["repo", "user"],
-     *   "expiresAt": 1234567890
-     * }
-     * ```
-     *
-     * @example
-     * ```typescript
-     * // app/routes/api/integrate/oauth/status.ts
-     * import { createTanStackOAuthHandler } from 'integrate-sdk';
-     *
-     * const handler = createTanStackOAuthHandler({
-     *        *   providers: {
-     *     github: {
-     *       clientId: process.env.GITHUB_CLIENT_ID!,
-     *       clientSecret: process.env.GITHUB_CLIENT_SECRET!,
-     *     },
-     *   },
-     * });
-     *
-     * export const GET = handler.status;
-     * ```
-     */
-    status({ request }: {
+    }) => Promise<Response>;
+    POST: ({ request }: {
         request: Request;
-    }): Promise<Response>;
+    }) => Promise<Response>;
 };
+export declare const createTanStackOAuthHandler: typeof toTanStackStartHandler;
 //# sourceMappingURL=tanstack-start.d.ts.map

package/dist/src/adapters/tanstack-start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tanstack-start.d.ts","sourceRoot":"","sources":["../../../src/adapters/tanstack-start.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB;IAIjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;2BAC0B;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwBrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;0BACyB;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwBpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;wBACuB;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;EAmDrE"}
+{"version":3,"file":"tanstack-start.d.ts","sourceRoot":"","sources":["../../../src/adapters/tanstack-start.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC;uBAC7C;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAG,OAAO,CAAC,QAAQ,CAAC;wBAAxC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAG,OAAO,CAAC,QAAQ,CAAC;EAQjF;AAGD,eAAO,MAAM,0BAA0B,+BAAyB,CAAC"}

package/dist/src/index.d.ts

@@ -13,7 +13,10 @@ export type { OAuthHandlerConfig, AuthorizeRequest, AuthorizeResponse, CallbackR
 export { createNextOAuthHandler } from "./adapters/nextjs.js";
 export { createOAuthRedirectHandler } from "./adapters/nextjs-oauth-redirect.js";
 export type { OAuthRedirectConfig } from "./adapters/nextjs-oauth-redirect.js";
-export { createTanStackOAuthHandler } from "./adapters/tanstack-start.js";
+export { toNodeHandler, fromNodeHeaders } from "./adapters/node.js";
+export { toSolidStartHandler } from "./adapters/solid-start.js";
+export { toSvelteKitHandler, svelteKitHandler } from "./adapters/svelte-kit.js";
+export { toTanStackStartHandler, createTanStackOAuthHandler } from "./adapters/tanstack-start.js";
 export type { MCPClientConfig, ReauthContext, ReauthHandler } from "./config/types.js";
 export { IntegrateSDKError, AuthenticationError, AuthorizationError, TokenExpiredError, ConnectionError, ToolCallError, isAuthError, isTokenExpiredError, isAuthorizationError, parseServerError, } from "./errors.js";
 export type { MCPPlugin, OAuthConfig, ExtractPluginIds, ExtractPluginTools, } from "./plugins/types.js";

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrI,YAAY,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,WAAW,EACX,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAG1E,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG3F,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,YAAY,EACV,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,OAAO,EACP,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EACV,cAAc,EACd,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrI,YAAY,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,WAAW,EACX,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAGlG,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG3F,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,YAAY,EACV,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,OAAO,EACP,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EACV,cAAc,EACd,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,208 @@
+/**
+ * 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.
+ *
+ * @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
+ * // Client-side usage
+ * import { createMCPClient, githubPlugin } from 'integrate-sdk';
+ * import { getAnthropicTools } from 'integrate-sdk/integrations/anthropic';
+ * import Anthropic from '@anthropic-ai/sdk';
+ *
+ * const client = createMCPClient({
+ *   plugins: [githubPlugin({ clientId: '...' })],
+ * });
+ *
+ * const tools = await getAnthropicTools(client);
+ * const anthropic = new Anthropic({ apiKey: '...' });
+ *
+ * const message = await anthropic.messages.create({
+ *   model: 'claude-3-5-sonnet-20241022',
+ *   max_tokens: 1024,
+ *   tools,
+ *   messages: [{ role: 'user', content: 'Create a GitHub issue' }]
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Server-side usage with tokens from client
+ * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
+ * import { getAnthropicTools, handleAnthropicToolCalls } from 'integrate-sdk/integrations/anthropic';
+ *
+ * const { client: serverClient } = createMCPServer({
+ *   plugins: [githubPlugin({
+ *     clientId: '...',
+ *     clientSecret: '...'
+ *   })],
+ * });
+ *
+ * // In your API route
+ * export async function POST(req: Request) {
+ *   const providerTokens = JSON.parse(req.headers.get('x-integrate-tokens') || '{}');
+ *   const tools = await getAnthropicTools(serverClient, { providerTokens });
+ *
+ *   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' }]
+ *   });
+ *
+ *   // Handle any tool calls
+ *   const toolResults = await handleAnthropicToolCalls(
+ *     serverClient,
+ *     message.content,
+ *     { providerTokens }
+ *   );
+ *
+ *   return Response.json({ message, toolResults });
+ * }
+ * ```
+ */
+export declare function getAnthropicTools(client: MCPClient<any>, options?: AnthropicToolsOptions): Promise<AnthropicTool[]>;
+//# sourceMappingURL=anthropic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/integrations/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,EAA+C,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9F;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,aAAa,EAAE,CAAC,CAG1B"}

package/dist/src/integrations/cloudflare.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Cloudflare Workers AI Integration
+ *
+ * Helper functions to convert MCP tools to Cloudflare Workers AI format
+ */
+import type { MCPClient } from "../client.js";
+import type { MCPTool } from "../protocol/messages.js";
+import { type AIToolsOptions } from "./utils.js";
+/**
+ * Cloudflare AI tool definition
+ * Compatible with Cloudflare Workers AI
+ */
+export interface CloudflareTool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: Record<string, {
+                type: string;
+                description?: string;
+            }>;
+            required: string[];
+        };
+    };
+}
+/**
+ * Options for converting MCP tools to Cloudflare format
+ */
+export interface CloudflareToolsOptions extends AIToolsOptions {
+}
+/**
+ * Convert a single MCP tool to Cloudflare Workers AI 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 Cloudflare compatible tool definition
+ *
+ * @example
+ * ```typescript
+ * const cloudflareTool = convertMCPToolToCloudflare(mcpTool, client);
+ * ```
+ */
+export declare function convertMCPToolToCloudflare(mcpTool: MCPTool, _client: MCPClient<any>, _options?: CloudflareToolsOptions): CloudflareTool;
+/**
+ * Convert all enabled MCP tools to Cloudflare Workers AI format
+ * Returns a dictionary keyed by tool name
+ *
+ * @param client - The MCP client instance (must be connected)
+ * @param options - Optional configuration including provider tokens
+ * @returns Dictionary of Cloudflare compatible tool definitions
+ *
+ * @example
+ * ```typescript
+ * // Client-side usage
+ * const tools = convertMCPToolsToCloudflare(mcpClient);
+ *
+ * // Server-side with provider tokens
+ * const tools = convertMCPToolsToCloudflare(serverClient, {
+ *   providerTokens: { github: 'ghp_...', gmail: 'ya29...' }
+ * });
+ * ```
+ */
+export declare function convertMCPToolsToCloudflare(client: MCPClient<any>, options?: CloudflareToolsOptions): Record<string, CloudflareTool>;
+/**
+ * Execute a tool call from Cloudflare Workers AI
+ *
+ * @param client - The MCP client instance
+ * @param toolCall - The tool call with name and arguments
+ * @param options - Optional configuration including provider tokens
+ * @returns Tool execution result as JSON string
+ *
+ * @example
+ * ```typescript
+ * const result = await executeCloudflareToolCall(client, {
+ *   name: 'github_create_issue',
+ *   arguments: { owner: 'user', repo: 'repo', title: 'Bug' }
+ * }, { providerTokens });
+ * ```
+ */
+export declare function executeCloudflareToolCall(client: MCPClient<any>, toolCall: {
+    name: string;
+    arguments: Record<string, unknown> | string;
+}, options?: CloudflareToolsOptions): Promise<string>;
+/**
+ * Get tools in a format compatible with Cloudflare Workers AI
+ *
+ * Automatically connects the client if not already connected.
+ *
+ * @param client - The MCP client instance
+ * @param options - Optional configuration including provider tokens for server-side usage
+ * @returns Dictionary of tools ready to use with Cloudflare Workers AI
+ *
+ * @example
+ * ```typescript
+ * // Cloudflare Worker usage
+ * import { createMCPClient, githubPlugin } from 'integrate-sdk';
+ * import { getCloudflareTools, executeCloudflareToolCall } from 'integrate-sdk/integrations/cloudflare';
+ *
+ * export default {
+ *   async fetch(request: Request, env: Env): Promise<Response> {
+ *     const client = createMCPClient({
+ *       plugins: [githubPlugin({ clientId: env.GITHUB_CLIENT_ID })],
+ *     });
+ *
+ *     const tools = await getCloudflareTools(client);
+ *     const ai = new Ai(env.AI);
+ *
+ *     const response = await ai.run('@cf/meta/llama-3-8b-instruct', {
+ *       messages: [{ role: 'user', content: 'Create a GitHub issue' }],
+ *       tools: Object.values(tools)
+ *     });
+ *
+ *     return Response.json(response);
+ *   }
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Server-side usage with tokens from client
+ * import { createMCPServer, githubPlugin } from 'integrate-sdk/server';
+ * import { getCloudflareTools, executeCloudflareToolCall } from 'integrate-sdk/integrations/cloudflare';
+ *
+ * const { client: serverClient } = createMCPServer({
+ *   plugins: [githubPlugin({
+ *     clientId: '...',
+ *     clientSecret: '...'
+ *   })],
+ * });
+ *
+ * // In your API route
+ * export async function POST(req: Request) {
+ *   const providerTokens = JSON.parse(req.headers.get('x-integrate-tokens') || '{}');
+ *   const tools = await getCloudflareTools(serverClient, { providerTokens });
+ *
+ *   // Use with Cloudflare AI
+ *   const ai = new Ai(env.AI);
+ *   const response = await ai.run('@cf/meta/llama-3-8b-instruct', {
+ *     messages: [{ role: 'user', content: 'Create a GitHub issue' }],
+ *     tools: Object.values(tools)
+ *   });
+ *
+ *   // Handle tool calls
+ *   if (response.tool_calls) {
+ *     for (const toolCall of response.tool_calls) {
+ *       await executeCloudflareToolCall(serverClient, toolCall, { providerTokens });
+ *     }
+ *   }
+ *
+ *   return Response.json(response);
+ * }
+ * ```
+ */
+export declare function getCloudflareTools(client: MCPClient<any>, options?: CloudflareToolsOptions): Promise<Record<string, CloudflareTool>>;
+//# sourceMappingURL=cloudflare.d.ts.map

package/dist/src/integrations/cloudflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../../src/integrations/cloudflare.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,EAA+C,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9F;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ,CAAC;YACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;gBACzB,IAAI,EAAE,MAAM,CAAC;gBACb,WAAW,CAAC,EAAE,MAAM,CAAC;aACtB,CAAC,CAAC;YACH,QAAQ,EAAE,MAAM,EAAE,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;CAAI;AAElE;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EACvB,QAAQ,CAAC,EAAE,sBAAsB,GAChC,cAAc,CAahB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAShC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE;IACR,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CAC7C,EACD,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAGzC"}