overai 1.4.0

package/dist/ai/devtools.d.ts

@@ -0,0 +1,74 @@
+/**
+ * DevTools - AI SDK v6 DevTools Integration
+ *
+ * Provides optional DevTools integration for debugging AI SDK calls.
+ * This is an optional dependency that provides visibility into LLM calls.
+ */
+export interface DevToolsConfig {
+    /** Enable DevTools (default: auto-detect from NODE_ENV) */
+    enabled?: boolean;
+    /** DevTools server port (default: 3001) */
+    port?: number;
+    /** DevTools server host (default: localhost) */
+    host?: string;
+    /** Project name for DevTools UI */
+    projectName?: string;
+    /** Custom metadata to include */
+    metadata?: Record<string, unknown>;
+}
+export interface DevToolsState {
+    enabled: boolean;
+    initialized: boolean;
+    port?: number;
+    host?: string;
+}
+/**
+ * Enable AI SDK DevTools for debugging.
+ *
+ * @example
+ * ```typescript
+ * // Enable in development
+ * if (process.env.NODE_ENV === 'development') {
+ *   await enableDevTools();
+ * }
+ * ```
+ *
+ * @example With configuration
+ * ```typescript
+ * await enableDevTools({
+ *   port: 3001,
+ *   projectName: 'My AI App'
+ * });
+ * ```
+ */
+export declare function enableDevTools(config?: DevToolsConfig): Promise<void>;
+/**
+ * Disable DevTools.
+ */
+export declare function disableDevTools(): Promise<void>;
+/**
+ * Check if DevTools is enabled.
+ */
+export declare function isDevToolsEnabled(): boolean;
+/**
+ * Get DevTools state.
+ */
+export declare function getDevToolsState(): DevToolsState;
+/**
+ * Get DevTools URL.
+ */
+export declare function getDevToolsUrl(): string | null;
+/**
+ * Create middleware that logs to DevTools.
+ *
+ * @example
+ * ```typescript
+ * const model = wrapModel(openai('gpt-4o'), createDevToolsMiddleware());
+ * ```
+ */
+export declare function createDevToolsMiddleware(): any;
+/**
+ * Auto-enable DevTools if in development mode.
+ * Call this at app startup.
+ */
+export declare function autoEnableDevTools(): Promise<void>;

package/dist/ai/devtools.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * DevTools - AI SDK v6 DevTools Integration
+ *
+ * Provides optional DevTools integration for debugging AI SDK calls.
+ * This is an optional dependency that provides visibility into LLM calls.
+ */
+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.enableDevTools = enableDevTools;
+exports.disableDevTools = disableDevTools;
+exports.isDevToolsEnabled = isDevToolsEnabled;
+exports.getDevToolsState = getDevToolsState;
+exports.getDevToolsUrl = getDevToolsUrl;
+exports.createDevToolsMiddleware = createDevToolsMiddleware;
+exports.autoEnableDevTools = autoEnableDevTools;
+// ============================================================================
+// Global State
+// ============================================================================
+let devToolsState = {
+    enabled: false,
+    initialized: false,
+};
+let devToolsInstance = null;
+// ============================================================================
+// DevTools Functions
+// ============================================================================
+/**
+ * Enable AI SDK DevTools for debugging.
+ *
+ * @example
+ * ```typescript
+ * // Enable in development
+ * if (process.env.NODE_ENV === 'development') {
+ *   await enableDevTools();
+ * }
+ * ```
+ *
+ * @example With configuration
+ * ```typescript
+ * await enableDevTools({
+ *   port: 3001,
+ *   projectName: 'My AI App'
+ * });
+ * ```
+ */
+async function enableDevTools(config) {
+    if (devToolsState.initialized && devToolsState.enabled) {
+        return; // Already enabled
+    }
+    // Check if we should enable
+    const shouldEnable = config?.enabled ??
+        (process.env.NODE_ENV === 'development' || process.env.PRAISONAI_DEVTOOLS === 'true');
+    if (!shouldEnable) {
+        return;
+    }
+    try {
+        // Try to import @ai-sdk/devtools (optional dependency)
+        // @ts-ignore - Optional dependency
+        const devtools = await Promise.resolve().then(() => __importStar(require('@ai-sdk/devtools')));
+        if ('enableDevTools' in devtools) {
+            await devtools.enableDevTools({
+                port: config?.port,
+                host: config?.host,
+                projectName: config?.projectName,
+                metadata: config?.metadata,
+            });
+            devToolsInstance = devtools;
+            devToolsState = {
+                enabled: true,
+                initialized: true,
+                port: config?.port || 3001,
+                host: config?.host || 'localhost',
+            };
+            console.log(`🔧 AI SDK DevTools enabled at http://${devToolsState.host}:${devToolsState.port}`);
+        }
+    }
+    catch (error) {
+        if (error.code === 'ERR_MODULE_NOT_FOUND' || error.code === 'MODULE_NOT_FOUND') {
+            console.warn('⚠️  @ai-sdk/devtools not installed. Install with:\n' +
+                '   npm install @ai-sdk/devtools\n' +
+                '   or: pnpm add @ai-sdk/devtools');
+        }
+        else {
+            console.warn('⚠️  Failed to enable DevTools:', error.message);
+        }
+        devToolsState = {
+            enabled: false,
+            initialized: true,
+        };
+    }
+}
+/**
+ * Disable DevTools.
+ */
+async function disableDevTools() {
+    if (!devToolsState.enabled) {
+        return;
+    }
+    try {
+        if (devToolsInstance && typeof devToolsInstance.disableDevTools === 'function') {
+            await devToolsInstance.disableDevTools();
+        }
+    }
+    catch {
+        // Ignore errors during disable
+    }
+    devToolsState = {
+        enabled: false,
+        initialized: true,
+    };
+    devToolsInstance = null;
+}
+/**
+ * Check if DevTools is enabled.
+ */
+function isDevToolsEnabled() {
+    return devToolsState.enabled;
+}
+/**
+ * Get DevTools state.
+ */
+function getDevToolsState() {
+    return { ...devToolsState };
+}
+/**
+ * Get DevTools URL.
+ */
+function getDevToolsUrl() {
+    if (!devToolsState.enabled) {
+        return null;
+    }
+    return `http://${devToolsState.host || 'localhost'}:${devToolsState.port || 3001}`;
+}
+// ============================================================================
+// Middleware for DevTools
+// ============================================================================
+/**
+ * Create middleware that logs to DevTools.
+ *
+ * @example
+ * ```typescript
+ * const model = wrapModel(openai('gpt-4o'), createDevToolsMiddleware());
+ * ```
+ */
+function createDevToolsMiddleware() {
+    return {
+        transformParams: async ({ params }) => {
+            if (!devToolsState.enabled) {
+                return params;
+            }
+            // Add DevTools metadata
+            return {
+                ...params,
+                experimental_telemetry: {
+                    ...params.experimental_telemetry,
+                    isEnabled: true,
+                    metadata: {
+                        ...params.experimental_telemetry?.metadata,
+                        devtools: true,
+                    },
+                },
+            };
+        },
+    };
+}
+// ============================================================================
+// Auto-enable in Development
+// ============================================================================
+/**
+ * Auto-enable DevTools if in development mode.
+ * Call this at app startup.
+ */
+async function autoEnableDevTools() {
+    const isDev = process.env.NODE_ENV === 'development';
+    const isExplicitlyEnabled = process.env.PRAISONAI_DEVTOOLS === 'true';
+    const isExplicitlyDisabled = process.env.PRAISONAI_DEVTOOLS === 'false';
+    if (isExplicitlyDisabled) {
+        return;
+    }
+    if (isDev || isExplicitlyEnabled) {
+        await enableDevTools();
+    }
+}

package/dist/ai/embed.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Embed - AI SDK Wrapper
+ *
+ * Provides embed and embedMany functions for text embeddings.
+ */
+export interface EmbedOptions {
+    /** Model to use (e.g., 'text-embedding-3-small', 'openai/text-embedding-3-large') */
+    model: string;
+    /** Text to embed */
+    value: string;
+    /** Maximum retries */
+    maxRetries?: number;
+    /** Abort signal */
+    abortSignal?: AbortSignal;
+    /** Additional headers */
+    headers?: Record<string, string>;
+}
+export interface EmbedResult {
+    /** Embedding vector */
+    embedding: number[];
+    /** Token usage */
+    usage: {
+        tokens: number;
+    };
+}
+export interface EmbedManyOptions {
+    /** Model to use */
+    model: string;
+    /** Texts to embed */
+    values: string[];
+    /** Maximum retries */
+    maxRetries?: number;
+    /** Abort signal */
+    abortSignal?: AbortSignal;
+    /** Additional headers */
+    headers?: Record<string, string>;
+}
+export interface EmbedManyResult {
+    /** Embedding vectors */
+    embeddings: number[][];
+    /** Token usage */
+    usage: {
+        tokens: number;
+    };
+}
+/**
+ * Embed a single text using an embedding model.
+ *
+ * @example
+ * ```typescript
+ * const result = await embed({
+ *   model: 'text-embedding-3-small',
+ *   value: 'Hello, world!'
+ * });
+ * console.log(result.embedding); // [0.1, 0.2, ...]
+ * ```
+ */
+export declare function embed(options: EmbedOptions): Promise<EmbedResult>;
+/**
+ * Embed multiple texts using an embedding model.
+ *
+ * @example
+ * ```typescript
+ * const result = await embedMany({
+ *   model: 'text-embedding-3-small',
+ *   values: ['Hello', 'World']
+ * });
+ * console.log(result.embeddings); // [[0.1, ...], [0.2, ...]]
+ * ```
+ */
+export declare function embedMany(options: EmbedManyOptions): Promise<EmbedManyResult>;

package/dist/ai/embed.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Embed - AI SDK Wrapper
+ *
+ * Provides embed and embedMany functions for text embeddings.
+ */
+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.embed = embed;
+exports.embedMany = embedMany;
+// Lazy load AI SDK
+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 embedding model instance
+ */
+async function resolveEmbeddingModel(modelString) {
+    let provider = 'openai';
+    let modelId = modelString;
+    if (modelString.includes('/')) {
+        const parts = modelString.split('/');
+        provider = parts[0].toLowerCase();
+        modelId = parts.slice(1).join('/');
+    }
+    else {
+        if (modelString.startsWith('text-embedding'))
+            provider = 'openai';
+        else if (modelString.startsWith('voyage'))
+            provider = 'anthropic';
+        else if (modelString.startsWith('embed-'))
+            provider = 'cohere';
+    }
+    let providerModule;
+    try {
+        switch (provider) {
+            case 'openai':
+                providerModule = await Promise.resolve().then(() => __importStar(require('@ai-sdk/openai')));
+                return providerModule.openai.embedding(modelId);
+            case 'google':
+                providerModule = await Promise.resolve().then(() => __importStar(require('@ai-sdk/google')));
+                return providerModule.google.embedding(modelId);
+            default:
+                providerModule = await Promise.resolve().then(() => __importStar(require('@ai-sdk/openai')));
+                return providerModule.openai.embedding(modelId);
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to load embedding provider '${provider}': ${error.message}`);
+    }
+}
+/**
+ * Embed a single text using an embedding model.
+ *
+ * @example
+ * ```typescript
+ * const result = await embed({
+ *   model: 'text-embedding-3-small',
+ *   value: 'Hello, world!'
+ * });
+ * console.log(result.embedding); // [0.1, 0.2, ...]
+ * ```
+ */
+async function embed(options) {
+    const sdk = await loadAISDK();
+    if (!sdk) {
+        throw new Error('AI SDK not available. Install with: npm install ai @ai-sdk/openai');
+    }
+    const model = await resolveEmbeddingModel(options.model);
+    const result = await sdk.embed({
+        model,
+        value: options.value,
+        maxRetries: options.maxRetries,
+        abortSignal: options.abortSignal,
+        headers: options.headers,
+    });
+    return {
+        embedding: result.embedding,
+        usage: result.usage || { tokens: 0 },
+    };
+}
+/**
+ * Embed multiple texts using an embedding model.
+ *
+ * @example
+ * ```typescript
+ * const result = await embedMany({
+ *   model: 'text-embedding-3-small',
+ *   values: ['Hello', 'World']
+ * });
+ * console.log(result.embeddings); // [[0.1, ...], [0.2, ...]]
+ * ```
+ */
+async function embedMany(options) {
+    const sdk = await loadAISDK();
+    if (!sdk) {
+        throw new Error('AI SDK not available. Install with: npm install ai @ai-sdk/openai');
+    }
+    const model = await resolveEmbeddingModel(options.model);
+    const result = await sdk.embedMany({
+        model,
+        values: options.values,
+        maxRetries: options.maxRetries,
+        abortSignal: options.abortSignal,
+        headers: options.headers,
+    });
+    return {
+        embeddings: result.embeddings,
+        usage: result.usage || { tokens: 0 },
+    };
+}

package/dist/ai/generate-image.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Generate Image - AI SDK Wrapper
+ *
+ * Provides generateImage function for image generation.
+ */
+export interface GenerateImageOptions {
+    /** Model to use (e.g., 'dall-e-3', 'google/imagen-3') */
+    model: string;
+    /** Text prompt for image generation */
+    prompt: string;
+    /** Number of images to generate */
+    n?: number;
+    /** Image size (e.g., '1024x1024') */
+    size?: `${number}x${number}`;
+    /** Aspect ratio (e.g., '16:9') */
+    aspectRatio?: `${number}:${number}`;
+    /** Seed for reproducibility */
+    seed?: number;
+    /** Maximum retries */
+    maxRetries?: number;
+    /** Abort signal */
+    abortSignal?: AbortSignal;
+    /** Additional headers */
+    headers?: Record<string, string>;
+    /** Provider-specific options */
+    providerOptions?: Record<string, unknown>;
+}
+export interface GeneratedImage {
+    /** Base64-encoded image data */
+    base64: string;
+    /** Image as Uint8Array */
+    uint8Array: Uint8Array;
+    /** MIME type */
+    mimeType?: string;
+}
+export interface GenerateImageResult {
+    /** Generated images */
+    images: GeneratedImage[];
+    /** Warnings */
+    warnings?: any[];
+}
+/**
+ * Generate images using an image model.
+ *
+ * @example Generate with DALL-E
+ * ```typescript
+ * const result = await generateImage({
+ *   model: 'dall-e-3',
+ *   prompt: 'A futuristic city at sunset',
+ *   size: '1024x1024'
+ * });
+ *
+ * // Save the image
+ * fs.writeFileSync('image.png', result.images[0].uint8Array);
+ * ```
+ *
+ * @example Generate with Google Imagen
+ * ```typescript
+ * const result = await generateImage({
+ *   model: 'google/imagen-3',
+ *   prompt: 'A beautiful landscape',
+ *   aspectRatio: '16:9'
+ * });
+ * ```
+ */
+export declare function generateImage(options: GenerateImageOptions): Promise<GenerateImageResult>;