integrate-sdk 0.7.22 → 0.7.24

package/dist/ai/utils.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Shared utilities for AI provider integrations
+ *
+ * Common functions used across different AI provider integrations
+ */
+import { z } from "zod";
+import type { MCPClient } from "../client.js";
+/**
+ * Options for AI provider tool conversions
+ */
+export interface AIToolsOptions {
+    /**
+     * Provider tokens for server-side usage
+     * Maps provider names (e.g., 'github', 'gmail') to their access tokens
+     *
+     * **Auto-extraction**: If not provided, tokens will be automatically extracted
+     * from the request headers (`x-integrate-tokens`) or environment variables.
+     * This works in supported frameworks like Next.js and Nuxt.
+     *
+     * **Manual override**: Pass this option to explicitly provide tokens when
+     * auto-extraction is not available or you need custom control.
+     *
+     * @example
+     * ```typescript
+     * // Auto-extraction (tokens extracted automatically from request)
+     * const tools = await getVercelAITools(serverClient);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Manual override
+     * const tools = await getVercelAITools(serverClient, {
+     *   providerTokens: {
+     *     github: 'ghp_...',
+     *     gmail: 'ya29...'
+     *   }
+     * });
+     * ```
+     */
+    providerTokens?: Record<string, string>;
+}
+/**
+ * Get the provider for a tool by checking which integration includes it
+ * @internal
+ */
+export declare function getProviderForTool(client: MCPClient<any>, toolName: string): string | undefined;
+/**
+ * Convert a JSON Schema property to a Zod schema
+ * @internal
+ */
+export declare function jsonSchemaPropertyToZod(propSchema: any): z.ZodType<any>;
+/**
+ * Convert JSON Schema to Zod schema for AI SDKs that use Zod
+ * Handles edge cases like missing schemas, type: "None", or invalid types
+ * Always returns a valid Zod object schema
+ * @internal
+ */
+export declare function jsonSchemaToZod(schema: any): z.ZodObject<any>;
+/**
+ * Execute a tool with provider token injection
+ * For server-side usage, temporarily injects provider tokens into the OAuthManager
+ * @internal
+ */
+export declare function executeToolWithToken(client: MCPClient<any>, toolName: string, args: Record<string, unknown>, options?: AIToolsOptions): Promise<any>;
+/**
+ * Auto-connect client if needed
+ * @internal
+ */
+export declare function ensureClientConnected(client: MCPClient<any>): Promise<void>;
+/**
+ * Re-export token extraction utilities
+ * These help extract provider tokens from request headers automatically
+ */
+export { getProviderTokens, tryGetProviderTokens } from "../utils/request-tokens.js";
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/ai/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAqFvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAoD7D;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,CAAC,CAoCd;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF;AAED;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}