overai 1.4.0

package/dist/ai/generate-text.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * Generate Text - AI SDK Wrapper
+ *
+ * Provides generateText and streamText functions that wrap the AI SDK.
+ * These are the primary text generation primitives.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateText = generateText;
+exports.streamText = streamText;
+// Lazy load AI SDK to avoid import errors when not installed
+let aiSdk = null;
+let aiSdkLoaded = false;
+async function loadAISDK() {
+    if (aiSdkLoaded)
+        return aiSdk;
+    try {
+        aiSdk = await Promise.resolve().then(() => __importStar(require('ai')));
+        aiSdkLoaded = true;
+        return aiSdk;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve model string to AI SDK model instance
+ */
+async function resolveModel(modelString) {
+    const sdk = await loadAISDK();
+    if (!sdk) {
+        throw new Error('AI SDK not available. Install with: npm install ai @ai-sdk/openai');
+    }
+    // Parse provider/model format
+    let provider = 'openai';
+    let modelId = modelString;
+    if (modelString.includes('/')) {
+        const parts = modelString.split('/');
+        provider = parts[0].toLowerCase();
+        modelId = parts.slice(1).join('/');
+    }
+    else {
+        // Infer provider from model name
+        if (modelString.startsWith('claude')) {
+            provider = 'anthropic';
+        }
+        else if (modelString.startsWith('gemini')) {
+            provider = 'google';
+        }
+        else if (modelString.startsWith('gpt') || modelString.startsWith('o1') || modelString.startsWith('o3')) {
+            provider = 'openai';
+        }
+    }
+    // Load provider
+    let providerModule;
+    try {
+        switch (provider) {
+            case 'openai':
+                providerModule = await Promise.resolve().then(() => __importStar(require('@ai-sdk/openai')));
+                return providerModule.openai(modelId);
+            case 'anthropic':
+                providerModule = await Promise.resolve().then(() => __importStar(require('@ai-sdk/anthropic')));
+                return providerModule.anthropic(modelId);
+            case 'google':
+                providerModule = await Promise.resolve().then(() => __importStar(require('@ai-sdk/google')));
+                return providerModule.google(modelId);
+            default:
+                // Try OpenAI-compatible
+                providerModule = await Promise.resolve().then(() => __importStar(require('@ai-sdk/openai')));
+                return providerModule.openai(modelId);
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to load provider '${provider}': ${error.message}. Install with: npm install @ai-sdk/${provider}`);
+    }
+}
+/**
+ * Generate text using a language model.
+ *
+ * @example Simple prompt
+ * ```typescript
+ * const result = await generateText({
+ *   model: 'gpt-4o',
+ *   prompt: 'What is the capital of France?'
+ * });
+ * console.log(result.text);
+ * ```
+ *
+ * @example Chat messages
+ * ```typescript
+ * const result = await generateText({
+ *   model: 'claude-3-sonnet',
+ *   messages: [
+ *     { role: 'user', content: 'Hello!' }
+ *   ]
+ * });
+ * ```
+ *
+ * @example With tools
+ * ```typescript
+ * const result = await generateText({
+ *   model: 'gpt-4o',
+ *   prompt: 'What is the weather in Paris?',
+ *   tools: {
+ *     getWeather: {
+ *       description: 'Get weather for a city',
+ *       parameters: z.object({ city: z.string() }),
+ *       execute: async ({ city }) => `Weather in ${city}: 20°C`
+ *     }
+ *   },
+ *   maxSteps: 5
+ * });
+ * ```
+ */
+async function generateText(options) {
+    const sdk = await loadAISDK();
+    if (!sdk) {
+        throw new Error('AI SDK not available. Install with: npm install ai @ai-sdk/openai');
+    }
+    // Handle both string model names and pre-resolved model objects
+    const model = typeof options.model === 'string'
+        ? await resolveModel(options.model)
+        : options.model;
+    const result = await sdk.generateText({
+        model,
+        prompt: options.prompt,
+        messages: options.messages,
+        system: options.system,
+        tools: options.tools,
+        toolChoice: options.toolChoice,
+        maxTokens: options.maxTokens,
+        temperature: options.temperature,
+        topP: options.topP,
+        topK: options.topK,
+        presencePenalty: options.presencePenalty,
+        frequencyPenalty: options.frequencyPenalty,
+        stopSequences: options.stopSequences,
+        seed: options.seed,
+        maxRetries: options.maxRetries,
+        abortSignal: options.abortSignal,
+        headers: options.headers,
+        maxSteps: options.maxSteps,
+        onStepFinish: options.onStepFinish,
+        onFinish: options.onFinish,
+    });
+    return {
+        text: result.text,
+        toolCalls: result.toolCalls || [],
+        toolResults: result.toolResults || [],
+        usage: result.usage || { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+        finishReason: result.finishReason || 'stop',
+        steps: result.steps || [],
+        responseMessages: result.responseMessages || [],
+        warnings: result.warnings,
+    };
+}
+/**
+ * Stream text using a language model.
+ *
+ * @example Simple streaming
+ * ```typescript
+ * const result = await streamText({
+ *   model: 'gpt-4o',
+ *   prompt: 'Write a poem about AI'
+ * });
+ *
+ * for await (const chunk of result.textStream) {
+ *   process.stdout.write(chunk);
+ * }
+ * ```
+ *
+ * @example With tools and multi-step
+ * ```typescript
+ * const result = await streamText({
+ *   model: 'gpt-4o',
+ *   prompt: 'Search for AI news and summarize',
+ *   tools: { webSearch },
+ *   maxSteps: 5,
+ *   onChunk: (chunk) => console.log(chunk)
+ * });
+ *
+ * const text = await result.text;
+ * ```
+ */
+async function streamText(options) {
+    const sdk = await loadAISDK();
+    if (!sdk) {
+        throw new Error('AI SDK not available. Install with: npm install ai @ai-sdk/openai');
+    }
+    // Handle both string model names and pre-resolved model objects
+    const model = typeof options.model === 'string'
+        ? await resolveModel(options.model)
+        : options.model;
+    const result = sdk.streamText({
+        model,
+        prompt: options.prompt,
+        messages: options.messages,
+        system: options.system,
+        tools: options.tools,
+        toolChoice: options.toolChoice,
+        maxTokens: options.maxTokens,
+        temperature: options.temperature,
+        topP: options.topP,
+        topK: options.topK,
+        presencePenalty: options.presencePenalty,
+        frequencyPenalty: options.frequencyPenalty,
+        stopSequences: options.stopSequences,
+        seed: options.seed,
+        maxRetries: options.maxRetries,
+        abortSignal: options.abortSignal,
+        headers: options.headers,
+        maxSteps: options.maxSteps,
+        onStepFinish: options.onStepFinish,
+        onFinish: options.onFinish,
+        onChunk: options.onChunk ? async (chunk) => {
+            await options.onChunk(chunk);
+        } : undefined,
+    });
+    return result;
+}

package/dist/ai/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AI SDK Wrapper Module
+ *
+ * This module provides a stable wrapper over the AI SDK (aisdk) primitives.
+ * It isolates aisdk imports and provides typed wrappers to ensure future
+ * aisdk upgrades don't break praisonai-ts users.
+ *
+ * @module ai
+ */
+export { generateText, streamText, type GenerateTextOptions, type GenerateTextResult, type StreamTextOptions, type StreamTextResult, type TextStreamPart, } from './generate-text';
+export { generateObject, streamObject, type GenerateObjectOptions, type GenerateObjectResult, type StreamObjectOptions, type StreamObjectResult, } from './generate-object';
+export { generateImage, type GenerateImageOptions, type GenerateImageResult, } from './generate-image';
+export { embed, embedMany, type EmbedOptions, type EmbedResult, type EmbedManyResult, } from './embed';
+export { defineTool, createToolSet, functionToTool, type ToolDefinition, type ToolExecuteFunction, type ToolInput, type ToolOutput, } from './tools';
+export { createModel, getModel, parseModel, MODEL_ALIASES, listModelAliases, hasModelAlias, resolveModelAlias, type ModelConfig, type ModelId, } from './models';
+export { createCachingMiddleware, createLoggingMiddleware, wrapModel, applyMiddleware, clearCache, getCacheStats, type Middleware, type MiddlewareConfig, type MiddlewareRequest, type MiddlewareResponse, } from './middleware';
+export { createImagePart, createFilePart, createPdfPart, createTextPart, createMultimodalMessage, toMessageContent, base64ToUint8Array, uint8ArrayToBase64, isUrl, isDataUrl, type InputPart, type ImagePart, type FilePart, type PdfPart, type TextPart, } from './multimodal';
+export { createMCP, getMCPClient, closeMCPClient, closeAllMCPClients, mcpToolsToAITools, type MCPConfig, type MCPClient, type MCPTool, type MCPResource, type MCPPrompt, } from './mcp';
+export { createHttpHandler, createExpressHandler, createHonoHandler, createFastifyHandler, createNestHandler, type ServerHandler, type ServerHandlerConfig, } from './server';
+export { createRouteHandler, createPagesHandler, type RouteHandlerConfig, type UseChatConfig, } from './nextjs';
+export { createAgentLoop, AgentLoop, stopAfterSteps, stopWhenNoToolCalls, stopWhen, type AgentLoopConfig, type AgentStep, type AgentLoopResult, type StopCondition, } from './agent-loop';
+export { convertToModelMessages, convertToUIMessages, validateUIMessages, safeValidateUIMessages, createTextMessage, createSystemMessage, hasPendingApprovals, getToolsNeedingApproval, createApprovalResponse, toUIMessageStreamResponse, pipeUIMessageStreamToResponse, type UIMessage, type UIMessagePart, type TextUIPart, type ReasoningUIPart, type ToolUIPart, type FileUIPart, type DataUIPart, type ModelMessage, type UIMessageStreamOptions, } from './ui-message';
+export { ApprovalManager, getApprovalManager, setApprovalManager, withApproval, createCLIApprovalPrompt, ToolApprovalDeniedError, ToolApprovalTimeoutError, DANGEROUS_PATTERNS, isDangerous, createDangerousPatternChecker, type ToolApprovalConfig, type ToolApprovalRequest, type ToolApprovalResponse, type ApprovalState, type ApprovalHandler, } from './tool-approval';
+export { generateSpeech, transcribe, SPEECH_MODELS, TRANSCRIPTION_MODELS, type GenerateSpeechOptions, type GenerateSpeechResult, type TranscribeOptions, type TranscribeResult, type TranscriptionSegment, } from './speech';
+export { enableDevTools, disableDevTools, isDevToolsEnabled, getDevToolsState, getDevToolsUrl, createDevToolsMiddleware, autoEnableDevTools, type DevToolsConfig, type DevToolsState, } from './devtools';
+export type { OAuthClientProvider } from './mcp';
+export { configureTelemetry, getTelemetrySettings, enableTelemetry as enableAITelemetry, disableTelemetry as disableAITelemetry, isTelemetryEnabled, initOpenTelemetry, getTracer, createAISpan, withSpan, createTelemetryMiddleware, recordEvent, getEvents, clearEvents, createTelemetrySettings, type TelemetrySettings, type Tracer, type Span, type SpanOptions, type SpanKind, type SpanStatus, type TelemetryEvent, } from './telemetry';

package/dist/ai/index.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * AI SDK Wrapper Module
+ *
+ * This module provides a stable wrapper over the AI SDK (aisdk) primitives.
+ * It isolates aisdk imports and provides typed wrappers to ensure future
+ * aisdk upgrades don't break praisonai-ts users.
+ *
+ * @module ai
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stopWhen = exports.stopWhenNoToolCalls = exports.stopAfterSteps = exports.AgentLoop = exports.createAgentLoop = exports.createPagesHandler = exports.createRouteHandler = exports.createNestHandler = exports.createFastifyHandler = exports.createHonoHandler = exports.createExpressHandler = exports.createHttpHandler = exports.mcpToolsToAITools = exports.closeAllMCPClients = exports.closeMCPClient = exports.getMCPClient = exports.createMCP = exports.isDataUrl = exports.isUrl = exports.uint8ArrayToBase64 = exports.base64ToUint8Array = exports.toMessageContent = exports.createMultimodalMessage = exports.createTextPart = exports.createPdfPart = exports.createFilePart = exports.createImagePart = exports.getCacheStats = exports.clearCache = exports.applyMiddleware = exports.wrapModel = exports.createLoggingMiddleware = exports.createCachingMiddleware = exports.resolveModelAlias = exports.hasModelAlias = exports.listModelAliases = exports.MODEL_ALIASES = exports.parseModel = exports.getModel = exports.createModel = exports.functionToTool = exports.createToolSet = exports.defineTool = exports.embedMany = exports.embed = exports.generateImage = exports.streamObject = exports.generateObject = exports.streamText = exports.generateText = void 0;
+exports.createTelemetrySettings = exports.clearEvents = exports.getEvents = exports.recordEvent = exports.createTelemetryMiddleware = exports.withSpan = exports.createAISpan = exports.getTracer = exports.initOpenTelemetry = exports.isTelemetryEnabled = exports.disableAITelemetry = exports.enableAITelemetry = exports.getTelemetrySettings = exports.configureTelemetry = exports.autoEnableDevTools = exports.createDevToolsMiddleware = exports.getDevToolsUrl = exports.getDevToolsState = exports.isDevToolsEnabled = exports.disableDevTools = exports.enableDevTools = exports.TRANSCRIPTION_MODELS = exports.SPEECH_MODELS = exports.transcribe = exports.generateSpeech = exports.createDangerousPatternChecker = exports.isDangerous = exports.DANGEROUS_PATTERNS = exports.ToolApprovalTimeoutError = exports.ToolApprovalDeniedError = exports.createCLIApprovalPrompt = exports.withApproval = exports.setApprovalManager = exports.getApprovalManager = exports.ApprovalManager = exports.pipeUIMessageStreamToResponse = exports.toUIMessageStreamResponse = exports.createApprovalResponse = exports.getToolsNeedingApproval = exports.hasPendingApprovals = exports.createSystemMessage = exports.createTextMessage = exports.safeValidateUIMessages = exports.validateUIMessages = exports.convertToUIMessages = exports.convertToModelMessages = void 0;
+// Re-export core execution functions
+var generate_text_1 = require("./generate-text");
+Object.defineProperty(exports, "generateText", { enumerable: true, get: function () { return generate_text_1.generateText; } });
+Object.defineProperty(exports, "streamText", { enumerable: true, get: function () { return generate_text_1.streamText; } });
+var generate_object_1 = require("./generate-object");
+Object.defineProperty(exports, "generateObject", { enumerable: true, get: function () { return generate_object_1.generateObject; } });
+Object.defineProperty(exports, "streamObject", { enumerable: true, get: function () { return generate_object_1.streamObject; } });
+var generate_image_1 = require("./generate-image");
+Object.defineProperty(exports, "generateImage", { enumerable: true, get: function () { return generate_image_1.generateImage; } });
+var embed_1 = require("./embed");
+Object.defineProperty(exports, "embed", { enumerable: true, get: function () { return embed_1.embed; } });
+Object.defineProperty(exports, "embedMany", { enumerable: true, get: function () { return embed_1.embedMany; } });
+// Re-export tool utilities
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return tools_1.defineTool; } });
+Object.defineProperty(exports, "createToolSet", { enumerable: true, get: function () { return tools_1.createToolSet; } });
+Object.defineProperty(exports, "functionToTool", { enumerable: true, get: function () { return tools_1.functionToTool; } });
+// Re-export model utilities
+var models_1 = require("./models");
+Object.defineProperty(exports, "createModel", { enumerable: true, get: function () { return models_1.createModel; } });
+Object.defineProperty(exports, "getModel", { enumerable: true, get: function () { return models_1.getModel; } });
+Object.defineProperty(exports, "parseModel", { enumerable: true, get: function () { return models_1.parseModel; } });
+Object.defineProperty(exports, "MODEL_ALIASES", { enumerable: true, get: function () { return models_1.MODEL_ALIASES; } });
+Object.defineProperty(exports, "listModelAliases", { enumerable: true, get: function () { return models_1.listModelAliases; } });
+Object.defineProperty(exports, "hasModelAlias", { enumerable: true, get: function () { return models_1.hasModelAlias; } });
+Object.defineProperty(exports, "resolveModelAlias", { enumerable: true, get: function () { return models_1.resolveModelAlias; } });
+// Re-export middleware
+var middleware_1 = require("./middleware");
+Object.defineProperty(exports, "createCachingMiddleware", { enumerable: true, get: function () { return middleware_1.createCachingMiddleware; } });
+Object.defineProperty(exports, "createLoggingMiddleware", { enumerable: true, get: function () { return middleware_1.createLoggingMiddleware; } });
+Object.defineProperty(exports, "wrapModel", { enumerable: true, get: function () { return middleware_1.wrapModel; } });
+Object.defineProperty(exports, "applyMiddleware", { enumerable: true, get: function () { return middleware_1.applyMiddleware; } });
+Object.defineProperty(exports, "clearCache", { enumerable: true, get: function () { return middleware_1.clearCache; } });
+Object.defineProperty(exports, "getCacheStats", { enumerable: true, get: function () { return middleware_1.getCacheStats; } });
+// Re-export multimodal utilities
+var multimodal_1 = require("./multimodal");
+Object.defineProperty(exports, "createImagePart", { enumerable: true, get: function () { return multimodal_1.createImagePart; } });
+Object.defineProperty(exports, "createFilePart", { enumerable: true, get: function () { return multimodal_1.createFilePart; } });
+Object.defineProperty(exports, "createPdfPart", { enumerable: true, get: function () { return multimodal_1.createPdfPart; } });
+Object.defineProperty(exports, "createTextPart", { enumerable: true, get: function () { return multimodal_1.createTextPart; } });
+Object.defineProperty(exports, "createMultimodalMessage", { enumerable: true, get: function () { return multimodal_1.createMultimodalMessage; } });
+Object.defineProperty(exports, "toMessageContent", { enumerable: true, get: function () { return multimodal_1.toMessageContent; } });
+Object.defineProperty(exports, "base64ToUint8Array", { enumerable: true, get: function () { return multimodal_1.base64ToUint8Array; } });
+Object.defineProperty(exports, "uint8ArrayToBase64", { enumerable: true, get: function () { return multimodal_1.uint8ArrayToBase64; } });
+Object.defineProperty(exports, "isUrl", { enumerable: true, get: function () { return multimodal_1.isUrl; } });
+Object.defineProperty(exports, "isDataUrl", { enumerable: true, get: function () { return multimodal_1.isDataUrl; } });
+// Re-export MCP client
+var mcp_1 = require("./mcp");
+Object.defineProperty(exports, "createMCP", { enumerable: true, get: function () { return mcp_1.createMCP; } });
+Object.defineProperty(exports, "getMCPClient", { enumerable: true, get: function () { return mcp_1.getMCPClient; } });
+Object.defineProperty(exports, "closeMCPClient", { enumerable: true, get: function () { return mcp_1.closeMCPClient; } });
+Object.defineProperty(exports, "closeAllMCPClients", { enumerable: true, get: function () { return mcp_1.closeAllMCPClients; } });
+Object.defineProperty(exports, "mcpToolsToAITools", { enumerable: true, get: function () { return mcp_1.mcpToolsToAITools; } });
+// Re-export server adapters
+var server_1 = require("./server");
+Object.defineProperty(exports, "createHttpHandler", { enumerable: true, get: function () { return server_1.createHttpHandler; } });
+Object.defineProperty(exports, "createExpressHandler", { enumerable: true, get: function () { return server_1.createExpressHandler; } });
+Object.defineProperty(exports, "createHonoHandler", { enumerable: true, get: function () { return server_1.createHonoHandler; } });
+Object.defineProperty(exports, "createFastifyHandler", { enumerable: true, get: function () { return server_1.createFastifyHandler; } });
+Object.defineProperty(exports, "createNestHandler", { enumerable: true, get: function () { return server_1.createNestHandler; } });
+// Re-export React/Next.js utilities (lazy loaded)
+var nextjs_1 = require("./nextjs");
+Object.defineProperty(exports, "createRouteHandler", { enumerable: true, get: function () { return nextjs_1.createRouteHandler; } });
+Object.defineProperty(exports, "createPagesHandler", { enumerable: true, get: function () { return nextjs_1.createPagesHandler; } });
+// Re-export agent loop utilities
+var agent_loop_1 = require("./agent-loop");
+Object.defineProperty(exports, "createAgentLoop", { enumerable: true, get: function () { return agent_loop_1.createAgentLoop; } });
+Object.defineProperty(exports, "AgentLoop", { enumerable: true, get: function () { return agent_loop_1.AgentLoop; } });
+Object.defineProperty(exports, "stopAfterSteps", { enumerable: true, get: function () { return agent_loop_1.stopAfterSteps; } });
+Object.defineProperty(exports, "stopWhenNoToolCalls", { enumerable: true, get: function () { return agent_loop_1.stopWhenNoToolCalls; } });
+Object.defineProperty(exports, "stopWhen", { enumerable: true, get: function () { return agent_loop_1.stopWhen; } });
+// Re-export UI message utilities
+var ui_message_1 = require("./ui-message");
+Object.defineProperty(exports, "convertToModelMessages", { enumerable: true, get: function () { return ui_message_1.convertToModelMessages; } });
+Object.defineProperty(exports, "convertToUIMessages", { enumerable: true, get: function () { return ui_message_1.convertToUIMessages; } });
+Object.defineProperty(exports, "validateUIMessages", { enumerable: true, get: function () { return ui_message_1.validateUIMessages; } });
+Object.defineProperty(exports, "safeValidateUIMessages", { enumerable: true, get: function () { return ui_message_1.safeValidateUIMessages; } });
+Object.defineProperty(exports, "createTextMessage", { enumerable: true, get: function () { return ui_message_1.createTextMessage; } });
+Object.defineProperty(exports, "createSystemMessage", { enumerable: true, get: function () { return ui_message_1.createSystemMessage; } });
+Object.defineProperty(exports, "hasPendingApprovals", { enumerable: true, get: function () { return ui_message_1.hasPendingApprovals; } });
+Object.defineProperty(exports, "getToolsNeedingApproval", { enumerable: true, get: function () { return ui_message_1.getToolsNeedingApproval; } });
+Object.defineProperty(exports, "createApprovalResponse", { enumerable: true, get: function () { return ui_message_1.createApprovalResponse; } });
+Object.defineProperty(exports, "toUIMessageStreamResponse", { enumerable: true, get: function () { return ui_message_1.toUIMessageStreamResponse; } });
+Object.defineProperty(exports, "pipeUIMessageStreamToResponse", { enumerable: true, get: function () { return ui_message_1.pipeUIMessageStreamToResponse; } });
+// Re-export tool approval utilities
+var tool_approval_1 = require("./tool-approval");
+Object.defineProperty(exports, "ApprovalManager", { enumerable: true, get: function () { return tool_approval_1.ApprovalManager; } });
+Object.defineProperty(exports, "getApprovalManager", { enumerable: true, get: function () { return tool_approval_1.getApprovalManager; } });
+Object.defineProperty(exports, "setApprovalManager", { enumerable: true, get: function () { return tool_approval_1.setApprovalManager; } });
+Object.defineProperty(exports, "withApproval", { enumerable: true, get: function () { return tool_approval_1.withApproval; } });
+Object.defineProperty(exports, "createCLIApprovalPrompt", { enumerable: true, get: function () { return tool_approval_1.createCLIApprovalPrompt; } });
+Object.defineProperty(exports, "ToolApprovalDeniedError", { enumerable: true, get: function () { return tool_approval_1.ToolApprovalDeniedError; } });
+Object.defineProperty(exports, "ToolApprovalTimeoutError", { enumerable: true, get: function () { return tool_approval_1.ToolApprovalTimeoutError; } });
+Object.defineProperty(exports, "DANGEROUS_PATTERNS", { enumerable: true, get: function () { return tool_approval_1.DANGEROUS_PATTERNS; } });
+Object.defineProperty(exports, "isDangerous", { enumerable: true, get: function () { return tool_approval_1.isDangerous; } });
+Object.defineProperty(exports, "createDangerousPatternChecker", { enumerable: true, get: function () { return tool_approval_1.createDangerousPatternChecker; } });
+// Re-export speech and transcription
+var speech_1 = require("./speech");
+Object.defineProperty(exports, "generateSpeech", { enumerable: true, get: function () { return speech_1.generateSpeech; } });
+Object.defineProperty(exports, "transcribe", { enumerable: true, get: function () { return speech_1.transcribe; } });
+Object.defineProperty(exports, "SPEECH_MODELS", { enumerable: true, get: function () { return speech_1.SPEECH_MODELS; } });
+Object.defineProperty(exports, "TRANSCRIPTION_MODELS", { enumerable: true, get: function () { return speech_1.TRANSCRIPTION_MODELS; } });
+// Re-export DevTools
+var devtools_1 = require("./devtools");
+Object.defineProperty(exports, "enableDevTools", { enumerable: true, get: function () { return devtools_1.enableDevTools; } });
+Object.defineProperty(exports, "disableDevTools", { enumerable: true, get: function () { return devtools_1.disableDevTools; } });
+Object.defineProperty(exports, "isDevToolsEnabled", { enumerable: true, get: function () { return devtools_1.isDevToolsEnabled; } });
+Object.defineProperty(exports, "getDevToolsState", { enumerable: true, get: function () { return devtools_1.getDevToolsState; } });
+Object.defineProperty(exports, "getDevToolsUrl", { enumerable: true, get: function () { return devtools_1.getDevToolsUrl; } });
+Object.defineProperty(exports, "createDevToolsMiddleware", { enumerable: true, get: function () { return devtools_1.createDevToolsMiddleware; } });
+Object.defineProperty(exports, "autoEnableDevTools", { enumerable: true, get: function () { return devtools_1.autoEnableDevTools; } });
+// Re-export telemetry utilities
+var telemetry_1 = require("./telemetry");
+Object.defineProperty(exports, "configureTelemetry", { enumerable: true, get: function () { return telemetry_1.configureTelemetry; } });
+Object.defineProperty(exports, "getTelemetrySettings", { enumerable: true, get: function () { return telemetry_1.getTelemetrySettings; } });
+Object.defineProperty(exports, "enableAITelemetry", { enumerable: true, get: function () { return telemetry_1.enableTelemetry; } });
+Object.defineProperty(exports, "disableAITelemetry", { enumerable: true, get: function () { return telemetry_1.disableTelemetry; } });
+Object.defineProperty(exports, "isTelemetryEnabled", { enumerable: true, get: function () { return telemetry_1.isTelemetryEnabled; } });
+Object.defineProperty(exports, "initOpenTelemetry", { enumerable: true, get: function () { return telemetry_1.initOpenTelemetry; } });
+Object.defineProperty(exports, "getTracer", { enumerable: true, get: function () { return telemetry_1.getTracer; } });
+Object.defineProperty(exports, "createAISpan", { enumerable: true, get: function () { return telemetry_1.createAISpan; } });
+Object.defineProperty(exports, "withSpan", { enumerable: true, get: function () { return telemetry_1.withSpan; } });
+Object.defineProperty(exports, "createTelemetryMiddleware", { enumerable: true, get: function () { return telemetry_1.createTelemetryMiddleware; } });
+Object.defineProperty(exports, "recordEvent", { enumerable: true, get: function () { return telemetry_1.recordEvent; } });
+Object.defineProperty(exports, "getEvents", { enumerable: true, get: function () { return telemetry_1.getEvents; } });
+Object.defineProperty(exports, "clearEvents", { enumerable: true, get: function () { return telemetry_1.clearEvents; } });
+Object.defineProperty(exports, "createTelemetrySettings", { enumerable: true, get: function () { return telemetry_1.createTelemetrySettings; } });

package/dist/ai/mcp.d.ts

@@ -0,0 +1,181 @@
+/**
+ * MCP (Model Context Protocol) - AI SDK Wrapper
+ *
+ * Provides MCP client utilities for connecting to MCP servers and using their tools.
+ */
+export interface MCPConfig {
+    /** Transport configuration */
+    transport: MCPTransportConfig;
+    /** Client name */
+    name?: string;
+    /** Client version */
+    version?: string;
+    /** Callback for uncaught errors */
+    onUncaughtError?: (error: unknown) => void;
+}
+export type MCPTransportConfig = {
+    type: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+} | {
+    type: 'sse';
+    url: string;
+    headers?: Record<string, string>;
+    authProvider?: OAuthClientProvider;
+} | {
+    type: 'http';
+    url: string;
+    headers?: Record<string, string>;
+    authProvider?: OAuthClientProvider;
+} | {
+    type: 'websocket';
+    url: string;
+    headers?: Record<string, string>;
+};
+/**
+ * OAuth client provider for MCP authentication.
+ */
+export interface OAuthClientProvider {
+    /** Get the current access token */
+    getAccessToken(): Promise<string | null>;
+    /** Refresh the access token */
+    refreshToken?(): Promise<string | null>;
+    /** Handle OAuth redirect */
+    handleRedirect?(url: string): Promise<void>;
+}
+export interface MCPClient {
+    /** Get tools from the MCP server */
+    tools(): Promise<Record<string, MCPTool>>;
+    /** List available resources */
+    listResources(): Promise<MCPResource[]>;
+    /** Read a resource */
+    readResource(uri: string): Promise<MCPResourceContent>;
+    /** List available prompts */
+    listPrompts(): Promise<MCPPrompt[]>;
+    /** Get a prompt */
+    getPrompt(name: string, args?: Record<string, string>): Promise<MCPPromptResult>;
+    /** Close the connection */
+    close(): Promise<void>;
+}
+export interface MCPTool {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description?: string;
+    /** Input schema */
+    inputSchema: any;
+    /** Execute the tool */
+    execute: (args: any) => Promise<any>;
+}
+export interface MCPResource {
+    /** Resource URI */
+    uri: string;
+    /** Resource name */
+    name: string;
+    /** Resource description */
+    description?: string;
+    /** MIME type */
+    mimeType?: string;
+}
+export interface MCPResourceContent {
+    /** Content URI */
+    uri: string;
+    /** Content MIME type */
+    mimeType?: string;
+    /** Text content */
+    text?: string;
+    /** Binary content (base64) */
+    blob?: string;
+}
+export interface MCPPrompt {
+    /** Prompt name */
+    name: string;
+    /** Prompt description */
+    description?: string;
+    /** Arguments */
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+export interface MCPPromptResult {
+    /** Prompt description */
+    description?: string;
+    /** Messages */
+    messages: Array<{
+        role: 'user' | 'assistant';
+        content: {
+            type: 'text';
+            text: string;
+        } | {
+            type: 'image';
+            data: string;
+            mimeType: string;
+        };
+    }>;
+}
+/**
+ * Create an MCP client.
+ *
+ * @example Stdio transport (local server)
+ * ```typescript
+ * const client = await createMCP({
+ *   transport: {
+ *     type: 'stdio',
+ *     command: 'npx',
+ *     args: ['-y', '@modelcontextprotocol/server-filesystem', '/path/to/dir']
+ *   }
+ * });
+ *
+ * const tools = await client.tools();
+ * ```
+ *
+ * @example SSE transport (remote server)
+ * ```typescript
+ * const client = await createMCP({
+ *   transport: {
+ *     type: 'sse',
+ *     url: 'https://mcp-server.example.com/sse'
+ *   }
+ * });
+ * ```
+ */
+export declare function createMCP(config: MCPConfig): Promise<MCPClient>;
+/**
+ * Get or create a pooled MCP client.
+ *
+ * @example
+ * ```typescript
+ * const client = await getMCPClient('filesystem', {
+ *   transport: { type: 'stdio', command: 'npx', args: ['-y', '@mcp/server-fs'] }
+ * });
+ * ```
+ */
+export declare function getMCPClient(key: string, config: MCPConfig): Promise<MCPClient>;
+/**
+ * Close and remove a pooled MCP client.
+ */
+export declare function closeMCPClient(key: string): Promise<void>;
+/**
+ * Close all pooled MCP clients.
+ */
+export declare function closeAllMCPClients(): Promise<void>;
+/**
+ * Convert MCP tools to AI SDK tool format.
+ *
+ * @example
+ * ```typescript
+ * const client = await createMCP({ ... });
+ * const mcpTools = await client.tools();
+ * const aiTools = mcpToolsToAITools(mcpTools);
+ *
+ * const result = await generateText({
+ *   model: 'gpt-4o',
+ *   prompt: 'List files in the current directory',
+ *   tools: aiTools
+ * });
+ * ```
+ */
+export declare function mcpToolsToAITools(mcpTools: Record<string, MCPTool>): Record<string, any>;