agent-nuvira 2.7.3 → 3.0.0

package/dist/tools/modality/generic-caller.js

@@ -1,254 +0,0 @@
-/**
- * GenericCaller — handles API calls to modality providers.
- *
- * Instead of provider-specific code, this module:
- *   1. Uses provider's requestBuilder to construct the request
- *   2. Makes the API call with proper auth, timeouts, retries
- *   3. Uses provider's responseParser to parse the response
- *   4. Handles errors generically
- *
- * This allows adding new providers without writing new API calling code.
- */
-import { logger } from '../../utils/logger.js';
-// ─── Types ──────────────────────────────────────────────────────────────────
-export class ModalityError extends Error {
-    providerId;
-    statusCode;
-    details;
-    constructor(providerId, statusCode, details) {
-        super(`[${providerId}] HTTP ${statusCode}: ${details}`);
-        this.providerId = providerId;
-        this.statusCode = statusCode;
-        this.details = details;
-        this.name = 'ModalityError';
-    }
-}
-// ─── API Key Resolution ─────────────────────────────────────────────────────
-/**
- * Get the API key for a provider.
- * Checks: config > envVar > hardcoded
- */
-function getApiKey(provider, config) {
-    // Check config first
-    if (config) {
-        const modalityConfig = config.modality;
-        if (modalityConfig) {
-            const providerConfig = modalityConfig[provider.modality]?.[provider.id];
-            if (providerConfig?.apiKey) {
-                return providerConfig.apiKey;
-            }
-        }
-    }
-    // Check env var
-    if (provider.envVar) {
-        return process.env[provider.envVar];
-    }
-    return undefined;
-}
-// ─── Generic API Caller ─────────────────────────────────────────────────────
-/**
- * Call a modality provider with generic API handling.
- *
- * Flow:
- *   1. Build request using provider's requestBuilder
- *   2. Resolve auth (API key from config or env)
- *   3. Make HTTP request with timeout
- *   4. Parse response using provider's responseParser
- *   5. Return standardized result
- */
-export async function callModalityProvider(provider, prompt, opts = {}, config) {
-    const startTime = Date.now();
-    const apiKey = getApiKey(provider, config);
-    // Determine endpoint
-    const endpoint = provider.endpoint || getDefaultEndpoint(provider.modality);
-    // Build request
-    const requestBody = provider.requestBuilder(prompt, opts);
-    // Build headers
-    const headers = {
-        'Content-Type': 'application/json',
-        ...provider.headers,
-    };
-    // Add auth
-    if (apiKey) {
-        if (provider.apiType === 'openai') {
-            headers['Authorization'] = `Bearer ${apiKey}`;
-        }
-        else {
-            // Generic API key header
-            headers['Authorization'] = `Bearer ${apiKey}`;
-        }
-    }
-    // Handle file uploads (for transcription)
-    let body;
-    if (provider.modality === 'transcription' && typeof requestBody.file === 'string') {
-        // For transcription, we need to send a file
-        const { readFileSync } = await import('fs');
-        const fileBuffer = readFileSync(requestBody.file);
-        const formData = new FormData();
-        formData.append('file', new Blob([fileBuffer]), 'audio.wav');
-        if (requestBody.model)
-            formData.append('model', requestBody.model);
-        if (requestBody.language)
-            formData.append('language', requestBody.language);
-        body = formData;
-        delete headers['Content-Type']; // Let browser set multipart boundary
-    }
-    else {
-        body = JSON.stringify(requestBody);
-    }
-    // Handle Pollinations (special case: GET request)
-    if (provider.apiType === 'pollinations') {
-        const { writeArtifact, safeArtifactName } = await import('./shared.js');
-        const { fetchImageBytes } = await import('./image-gen.js');
-        const width = opts.width ?? 1024;
-        const height = opts.height ?? 1024;
-        const url = `${provider.baseUrl}/${encodeURIComponent(prompt)}?width=${width}&height=${height}&nologo=true`;
-        const buffer = await fetchImageBytes(url);
-        const file = writeArtifact('images', safeArtifactName(prompt, '.png'), buffer, opts.cwd);
-        return {
-            ok: true,
-            file,
-            durationMs: Date.now() - startTime,
-        };
-    }
-    // Make HTTP request
-    const response = await fetch(provider.baseUrl + endpoint, {
-        method: 'POST',
-        headers,
-        body,
-        signal: AbortSignal.timeout(provider.timeoutMs || 30000),
-    });
-    // Handle errors
-    if (!response.ok) {
-        const errorText = await response.text().catch(() => 'Unknown error');
-        throw new ModalityError(provider.id, response.status, errorText.slice(0, 200));
-    }
-    // Parse response
-    let data;
-    const contentType = response.headers.get('content-type') || '';
-    if (contentType.includes('application/json')) {
-        data = await response.json();
-    }
-    else if (contentType.includes('image/') || contentType.includes('audio/') || contentType.includes('video/')) {
-        // Binary response (image, audio, video)
-        const buffer = Buffer.from(await response.arrayBuffer());
-        data = { buffer, contentType };
-    }
-    else {
-        // Text response
-        const text = await response.text();
-        data = { text };
-    }
-    // Use provider's response parser
-    const result = provider.responseParser(data);
-    // Handle file saving if data is a buffer
-    if (result.ok && result.data instanceof Buffer) {
-        const { writeArtifact, safeArtifactName } = await import('./shared.js');
-        const ext = getExtension(contentType);
-        const file = writeArtifact(getOutputDir(provider.modality), safeArtifactName(prompt, ext), result.data, opts.cwd);
-        result.file = file;
-    }
-    // Handle URL download if data is a string (URL)
-    if (result.ok && typeof result.data === 'string' && result.data.startsWith('http')) {
-        const { writeArtifact, safeArtifactName } = await import('./shared.js');
-        const fetchResponse = await fetch(result.data);
-        if (fetchResponse.ok) {
-            const buffer = Buffer.from(await fetchResponse.arrayBuffer());
-            const ext = getExtension(fetchResponse.headers.get('content-type') || '');
-            const file = writeArtifact(getOutputDir(provider.modality), safeArtifactName(prompt, ext), buffer, opts.cwd);
-            result.file = file;
-        }
-    }
-    result.durationMs = Date.now() - startTime;
-    return result;
-}
-// ─── Helpers ────────────────────────────────────────────────────────────────
-function getDefaultEndpoint(modality) {
-    switch (modality) {
-        case 'image': return '/images/generations';
-        case 'tts': return '/audio/speech';
-        case 'video': return '/generation';
-        case 'transcription': return '/audio/transcriptions';
-        default: return '/';
-    }
-}
-function getExtension(contentType) {
-    if (contentType.includes('jpeg') || contentType.includes('jpg'))
-        return '.jpg';
-    if (contentType.includes('png'))
-        return '.png';
-    if (contentType.includes('webp'))
-        return '.webp';
-    if (contentType.includes('gif'))
-        return '.gif';
-    if (contentType.includes('mp4'))
-        return '.mp4';
-    if (contentType.includes('webm'))
-        return '.webm';
-    if (contentType.includes('mp3'))
-        return '.mp3';
-    if (contentType.includes('wav'))
-        return '.wav';
-    if (contentType.includes('ogg'))
-        return '.ogg';
-    return '.bin';
-}
-function getOutputDir(modality) {
-    switch (modality) {
-        case 'image': return 'images';
-        case 'tts': return 'audio';
-        case 'video': return 'videos';
-        case 'transcription': return 'transcriptions';
-        default: return 'output';
-    }
-}
-// ─── Failover Caller ────────────────────────────────────────────────────────
-/**
- * Call modality with failover across providers.
- *
- * Flow:
- *   1. Get all available providers for the modality
- *   2. Score each provider
- *   3. Try best provider first
- *   4. On failure, try next best
- *   5. Continue until success or all providers exhausted
- */
-export async function callModalityWithFailover(modality, prompt, opts = {}, config) {
-    const { getAvailableModalityProviders, scoreModalityProvider } = await import('./modality-catalog.js');
-    const providers = getAvailableModalityProviders(modality);
-    if (providers.length === 0) {
-        return {
-            ok: false,
-            error: `No ${modality} providers available`,
-            durationMs: 0,
-            provider: 'none',
-        };
-    }
-    // Score and sort providers
-    const scored = providers.map(p => ({
-        provider: p,
-        score: scoreModalityProvider(p),
-    })).sort((a, b) => b.score - a.score);
-    // Try each provider
-    for (const { provider } of scored) {
-        try {
-            logger.debug(`[generic-caller] Trying ${provider.name} for ${modality}`);
-            const result = await callModalityProvider(provider, prompt, opts, config);
-            if (result.ok) {
-                logger.info(`[generic-caller] ${modality} generated via ${provider.name} in ${result.durationMs}ms`);
-                return { ...result, provider: provider.id };
-            }
-        }
-        catch (err) {
-            logger.debug(`[generic-caller] ${provider.name} failed: ${err instanceof Error ? err.message : err}`);
-            // Continue to next provider
-        }
-    }
-    return {
-        ok: false,
-        error: `All ${modality} providers failed`,
-        durationMs: 0,
-        provider: 'none',
-    };
-}
-//# sourceMappingURL=generic-caller.js.map

package/dist/tools/modality/generic-caller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"generic-caller.js","sourceRoot":"","sources":["../../../src/tools/modality/generic-caller.ts"],"names":[],"mappings":"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"}

package/dist/tools/modality/modality-catalog.d.ts

@@ -1,134 +0,0 @@
-/**
- * ModalityCatalog — data-driven provider definitions for modality tools.
- *
- * This is the modality equivalent of `provider-catalog.ts` for LLMs.
- * Instead of hardcoding providers in tool-router.ts, we define them as data
- * objects that can be extended via config without code changes.
- *
- * Design principles:
- *   1. Data over code — providers are data objects, not if/else blocks
- *   2. User-configurable — add providers via config, no code changes
- *   3. Generic API caller — uses requestBuilder + responseParser
- *   4. Consistent scoring — same pattern as LLM routing
- *
- * Usage:
- *   const providers = getModalityProviders('image');
- *   const best = selectBestModalityProvider(providers, context);
- *   const result = await callModalityProvider(best, prompt, opts);
- */
-export type ModalityType = 'image' | 'tts' | 'video' | 'transcription';
-export type ApiType = 'openai' | 'rest' | 'grpc' | 'local' | 'pollinations';
-export interface ModalityProvider {
-    /** Unique provider identifier (e.g., 'dalle', 'pollinations'). */
-    id: string;
-    /** Human-readable name (e.g., 'DALL-E 3'). */
-    name: string;
-    /** Which modality this provider serves. */
-    modality: ModalityType;
-    /** API type determines how to call the provider. */
-    apiType: ApiType;
-    /** Base URL for API calls. */
-    baseUrl: string;
-    /** Environment variable for API key (undefined for keyless). */
-    envVar?: string;
-    /** Custom headers to include in API calls. */
-    headers?: Record<string, string>;
-    /** Endpoint path (appended to baseUrl). Default depends on modality. */
-    endpoint?: string;
-    /** Cost per unit (image=per image, tts=per 1K chars, video=per second). */
-    costPerUnit: number;
-    /** Quality score 0-1 (higher = better). */
-    quality: number;
-    /** Speed score 0-1 (higher = faster). */
-    speed: number;
-    /** Available models for this provider. */
-    models: string[];
-    /** Default model to use if none specified. */
-    defaultModel?: string;
-    /** Timeout in milliseconds. */
-    timeoutMs?: number;
-    /** Whether this provider is currently available (has API key). */
-    available: boolean;
-    /** Build the API request body from prompt and options. */
-    requestBuilder: (prompt: string, opts: ModalityOptions) => Record<string, unknown>;
-    /** Parse the API response into a standardized result. */
-    responseParser: (data: unknown) => ModalityResponse;
-}
-export interface ModalityOptions {
-    width?: number;
-    height?: number;
-    duration?: number;
-    resolution?: string;
-    voice?: string;
-    language?: string;
-    model?: string;
-    cwd?: string;
-}
-export interface ModalityResponse {
-    /** Whether the operation succeeded. */
-    ok: boolean;
-    /** Output data (buffer for image/audio, URL for video). */
-    data?: Buffer | string;
-    /** Output file path (if saved to disk). */
-    file?: string;
-    /** Text output (for transcription). */
-    text?: string;
-    /** Error message if failed. */
-    error?: string;
-    /** Duration in milliseconds. */
-    durationMs: number;
-}
-/**
- * Get all providers for a modality (built-in + user-configured).
- */
-export declare function getModalityProviders(modality: ModalityType): ModalityProvider[];
-/**
- * Get all available providers for a modality (has API key or is keyless).
- */
-export declare function getAvailableModalityProviders(modality: ModalityType): ModalityProvider[];
-/**
- * Get a specific provider by ID.
- */
-export declare function getModalityProvider(id: string): ModalityProvider | undefined;
-/**
- * Add a user-configured provider.
- * Called when user sets config like:
- *   nuvira config set modality.image.replicate.apiKey=xxxxx
- */
-export declare function addModalityProvider(provider: ModalityProvider): void;
-/**
- * Remove a user-configured provider.
- */
-export declare function removeModalityProvider(id: string): boolean;
-/**
- * Load user-configured providers from config.
- */
-export declare function loadUserConfiguredProviders(config: Record<string, unknown>): void;
-/**
- * Score a modality provider for routing.
- */
-export declare function scoreModalityProvider(provider: ModalityProvider, context?: {
-    maxCost?: number;
-    priorityQuality?: boolean;
-    prioritySpeed?: boolean;
-}): number;
-/**
- * Select the best modality provider for a task.
- */
-export declare function selectBestModalityProvider(modality: ModalityType, context?: {
-    maxCost?: number;
-    priorityQuality?: boolean;
-    prioritySpeed?: boolean;
-}): ModalityProvider | null;
-/**
- * Get status of all modality providers (for dashboard display).
- */
-export declare function getModalityProviderStatus(): Record<ModalityType, Array<{
-    id: string;
-    name: string;
-    available: boolean;
-    costPerUnit: number;
-    quality: number;
-    speed: number;
-}>>;
-//# sourceMappingURL=modality-catalog.d.ts.map

package/dist/tools/modality/modality-catalog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"modality-catalog.d.ts","sourceRoot":"","sources":["../../../src/tools/modality/modality-catalog.ts"],"names":[],"mappings":"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"}