@uluops/core 0.5.0

package/dist/ai/AIProvider.js

@@ -0,0 +1,557 @@
+import { generateText, Output, NoObjectGeneratedError, stepCountIs } from 'ai';
+import { createAnthropic } from '@ai-sdk/anthropic';
+import { createOpenAI } from '@ai-sdk/openai';
+import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { formatErrorMessage } from '../utils/formatError.js';
+import { executeShellAsString, executeShellAsOpenAIResult } from './ShellExecutor.js';
+import { SdkApiError, RateLimitError, UnauthorizedError, ForbiddenError, ServiceUnavailableError, TimeoutError, ConfigurationError, } from '../errors/index.js';
+/**
+ * Multi-provider AI SDK wrapper with registry-backed model resolution.
+ *
+ * Wraps Vercel AI SDK v6 to provide:
+ * - Registry-backed model alias resolution (sonnet → anthropic:claude-sonnet-4-5-20250929)
+ * - Multi-provider support (Anthropic + OpenAI + Google bundled, others via dynamic import)
+ * - Capability pre-flight checks (tools, vision, streaming, extendedThinking)
+ * - Unified generation with automatic tool loops
+ * - Automatic prompt caching for Anthropic system messages
+ * - Extended thinking auto-enabled for capable Anthropic models
+ * - Reasoning effort auto-set for capable OpenAI models
+ * - Provider-defined tool support (Anthropic bash, OpenAI shell)
+ * - Error mapping to UluOps error types
+ * - Usage metrics in UluOps format (including OpenAI reasoning + Google thinking tokens)
+ */
+export class AIProvider {
+    config;
+    catalog;
+    logger;
+    /** Factory name overrides for providers that don't follow the `create<Name>` convention */
+    static FACTORY_NAME_OVERRIDES = {
+        google: 'createGoogleGenerativeAI',
+    };
+    /**
+     * Allowlist of valid provider names for dynamic import.
+     * Prevents path traversal via crafted provider strings (CWE-829).
+     */
+    static VALID_DYNAMIC_PROVIDERS = new Set([
+        'anthropic', 'openai', 'google', 'mistral', 'cohere', 'groq', 'xai', 'deepseek',
+    ]);
+    /** Initialized AI SDK provider factories, keyed by provider name */
+    providers = new Map();
+    /** Anthropic provider instance for accessing provider-defined tools */
+    anthropicInstance;
+    /** OpenAI provider instance for accessing provider-defined tools */
+    openaiInstance;
+    /** Google provider instance for future provider-defined tools (googleSearch, codeExecution) */
+    // @ts-expect-error Reserved for future Google tool integration (googleSearch, codeExecution, urlContext)
+    googleInstance;
+    constructor(config, catalog, logger) {
+        this.config = config;
+        this.catalog = catalog;
+        this.logger = logger;
+        this.initializeProviders(config.ai);
+    }
+    /**
+     * Generate text with automatic tool loop handling.
+     *
+     * Resolution flow:
+     * 1. Resolve model alias → provider:modelId via ModelCatalog
+     * 2. Validate required capabilities (if specified)
+     * 3. Get AI SDK LanguageModel from provider factory
+     * 4. Build provider options (cache control, thinking, etc.)
+     * 5. Call generateText with maxSteps for automatic tool loop
+     */
+    async generate(options) {
+        // Apply model override if configured
+        const modelInput = this.config.ai.modelOverride ?? options.model;
+        // Resolve alias → provider:modelId with capability check
+        const resolved = await this.catalog.resolve(modelInput, {
+            requiredCapabilities: options.requiredCapabilities,
+        });
+        // Ensure provider is loaded (for dynamic providers)
+        await this.ensureProvider(resolved.provider);
+        // Get provider factory
+        const factory = this.getProviderFactory(resolved.provider);
+        const languageModel = factory(resolved.providerModelId);
+        // Build provider-specific options (thinking, caching, etc.)
+        const providerOptions = this.buildProviderOptions(resolved, options.providerOptions);
+        // Build system message with cache control for Anthropic
+        const system = this.buildSystemMessage(resolved.provider, options.system);
+        // Log pre-generation context
+        this.logger.info(`Model: ${resolved.provider}:${resolved.modelId} (from "${modelInput}")`);
+        this.logger.debug(`System prompt: ${options.system.length} chars`);
+        this.logger.debug(`User prompt: ${options.prompt.length} chars`);
+        if (options.tools) {
+            this.logger.debug(`Tools: ${Object.keys(options.tools).join(', ')}`);
+        }
+        this.logger.debug(`Config: maxTokens=${options.maxTokens ?? 8192}, maxSteps=${options.maxSteps ?? 50}, temp=${options.temperature ?? 0}`);
+        // Determine if structured output should be used
+        const useStructuredOutput = !!options.output
+            && resolved.capabilities.structuredOutput;
+        if (options.output && !resolved.capabilities.structuredOutput) {
+            this.logger.info(`Model ${resolved.modelId} does not support structured output — falling back to free-form extraction`);
+        }
+        try {
+            let stepCount = 0;
+            const budgetTracker = options.budgetTracker;
+            // Build prepareStep for budget-based wrap-up
+            const prepareStep = options.contextBudget
+                ? this.buildBudgetPrepareStep(options.contextBudget)
+                : undefined;
+            const maxSteps = options.maxSteps ?? 50;
+            const result = await generateText({
+                model: languageModel,
+                system,
+                prompt: options.prompt,
+                tools: options.tools,
+                maxOutputTokens: options.maxTokens ?? 8192,
+                // +2 when structured output: +1 for the output generation step, +1 buffer
+                stopWhen: stepCountIs(maxSteps + (useStructuredOutput ? 2 : 0)),
+                temperature: options.temperature ?? 0,
+                abortSignal: options.timeoutMs
+                    ? AbortSignal.timeout(options.timeoutMs)
+                    : undefined,
+                ...(providerOptions ? { providerOptions } : {}),
+                ...(prepareStep ? { prepareStep } : {}),
+                ...(useStructuredOutput ? { output: Output.object(options.output) } : {}),
+                onStepFinish: (step) => {
+                    stepCount++;
+                    const toolNames = step.toolCalls?.map(tc => tc.toolName) ?? [];
+                    const usage = step.usage;
+                    const textLen = step.text?.length ?? 0;
+                    this.logger.info(`Step ${stepCount}: ${step.finishReason}` +
+                        (toolNames.length > 0 ? ` | tools: [${toolNames.join(', ')}]` : '') +
+                        ` | usage: ${usage.inputTokens ?? 0}in/${usage.outputTokens ?? 0}out` +
+                        (textLen > 0 ? ` | text: ${textLen} chars` : ''));
+                    // Update budget tracker for get_token_budget tool
+                    if (budgetTracker) {
+                        budgetTracker.update(usage.inputTokens ?? 0, usage.outputTokens ?? 0);
+                    }
+                },
+            });
+            // Count tool calls across all steps
+            const toolCallCount = result.steps.reduce((sum, step) => sum + (step.toolCalls?.length ?? 0), 0);
+            const usage = this.mapUsage(result.usage, result.providerMetadata);
+            this.logger.info(`Complete: ${result.steps.length} steps, ${toolCallCount} tool calls, finish=${result.finishReason}`);
+            this.logger.info(`Usage: ${usage.input_tokens}in / ${usage.output_tokens}out` +
+                (usage.cache_creation_input_tokens ? ` / cache_write=${usage.cache_creation_input_tokens}` : '') +
+                (usage.cache_read_input_tokens ? ` / cache_read=${usage.cache_read_input_tokens}` : '') +
+                (usage.thinking_tokens ? ` / thinking=${usage.thinking_tokens}` : ''));
+            return {
+                text: result.text,
+                usage,
+                toolCallCount,
+                model: `${resolved.provider}:${resolved.modelId}`,
+                provider: resolved.provider,
+                steps: result.steps.length,
+                finishReason: result.finishReason,
+                structuredOutput: useStructuredOutput ? result.output : undefined,
+            };
+        }
+        catch (error) {
+            // If structured output fails, extract from the error's preserved text
+            // instead of re-running the entire generation (which would double cost).
+            if (useStructuredOutput && NoObjectGeneratedError.isInstance(error)) {
+                this.logger.warn(`Structured output generation failed — falling back to text extraction: ${error.message}`);
+                return {
+                    text: error.text ?? '',
+                    structuredOutput: undefined,
+                    usage: this.mapUsage(error.usage ?? { inputTokens: 0, outputTokens: 0 }),
+                    toolCallCount: 0,
+                    model: `${resolved.provider}:${resolved.modelId}`,
+                    provider: resolved.provider,
+                    steps: 0,
+                    finishReason: error.finishReason ?? 'error',
+                };
+            }
+            throw this.mapError(error, options.timeoutMs);
+        }
+    }
+    /**
+     * Resolve model alias and ensure provider is loaded.
+     * @internal Used by AgentExecutor for early provider detection.
+     */
+    async resolveModel(input, opts) {
+        const resolved = await this.catalog.resolve(input, opts);
+        await this.ensureProvider(resolved.provider);
+        return resolved;
+    }
+    /**
+     * Create provider-defined shell tool for the resolved model's provider.
+     *
+     * - Anthropic: bash_20250124 (Claude's built-in bash knowledge) — returns string
+     * - OpenAI: openai.tools.shell() with local execution — returns structured output
+     *
+     * Returns undefined if the model's provider has no shell tool support or
+     * the provider instance is not available.
+     */
+    createProviderShellTool(provider, targetDir, timeoutMs = 30_000) {
+        if (provider === 'anthropic' && this.anthropicInstance) {
+            return {
+                bash: this.anthropicInstance.tools.bash_20250124({
+                    execute: async ({ command }) => executeShellAsString(command, targetDir, timeoutMs),
+                }),
+            };
+        }
+        if (provider === 'openai' && this.openaiInstance) {
+            // Type assertion needed: OpenAI provider-defined tool uses a specific
+            // FlexibleSchema<{action: ...}> that doesn't widen to ToolSet's generic
+            // Tool<any, any> due to schema symbol variance. Safe at runtime.
+            return {
+                shell: this.openaiInstance.tools.shell({
+                    execute: async ({ action }) => executeShellAsOpenAIResult(action, targetDir, timeoutMs),
+                }),
+            };
+        }
+        return undefined;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Provider Options
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Build system message with provider-specific cache control.
+     *
+     * For Anthropic: wraps system text in a SystemModelMessage with
+     * ephemeral cache control. The API ignores cache hints if the
+     * prompt is below the minimum cacheable length (1024 tokens for Sonnet).
+     *
+     * For other providers: passes through as plain string.
+     * OpenAI caching is automatic for prompts ≥1024 tokens — no markup needed.
+     */
+    buildSystemMessage(provider, systemText) {
+        if (provider !== 'anthropic') {
+            return systemText;
+        }
+        return {
+            role: 'system',
+            content: systemText,
+            providerOptions: {
+                anthropic: {
+                    cacheControl: { type: 'ephemeral' },
+                },
+            },
+        };
+    }
+    /**
+     * Build top-level providerOptions for generateText().
+     * Dispatches to provider-specific builders.
+     */
+    buildProviderOptions(resolved, userOptions) {
+        if (resolved.provider === 'anthropic') {
+            return this.buildAnthropicOptions(resolved, userOptions);
+        }
+        if (resolved.provider === 'openai') {
+            return this.buildOpenAIOptions(resolved, userOptions);
+        }
+        if (resolved.provider === 'google') {
+            return this.buildGoogleOptions(resolved, userOptions);
+        }
+        return userOptions;
+    }
+    /**
+     * Anthropic-specific provider options.
+     * - Auto-enables extended thinking when model has extendedThinking capability
+     * - Auto-injects context management (clear old tool uses at 100K tokens)
+     */
+    buildAnthropicOptions(resolved, userOptions) {
+        const userAnthropicOpts = (userOptions?.anthropic ?? {});
+        let anthropicOpts = { ...userAnthropicOpts };
+        // Auto-enable extended thinking if model supports it and user hasn't specified
+        if (resolved.capabilities.extendedThinking && !('thinking' in anthropicOpts)) {
+            const budgetTokens = this.config.defaultThinkingBudget;
+            anthropicOpts = {
+                ...anthropicOpts,
+                thinking: { type: 'enabled', budgetTokens },
+            };
+        }
+        // Auto-inject context management to clear old tool uses when context grows large.
+        // Trigger at 100K tokens (~50% of Claude's 200K context) to leave room for the final
+        // response. Keep the 5 most recent tool uses so the model retains working context.
+        if (!('contextManagement' in anthropicOpts)) {
+            anthropicOpts = {
+                ...anthropicOpts,
+                contextManagement: {
+                    edits: [
+                        {
+                            type: 'clear_tool_uses_20250919',
+                            trigger: { type: 'input_tokens', value: 100_000 },
+                            keep: { type: 'tool_uses', value: 5 },
+                            clearToolInputs: true,
+                        },
+                    ],
+                },
+            };
+        }
+        return {
+            ...(userOptions ?? {}),
+            anthropic: anthropicOpts,
+        };
+    }
+    /**
+     * OpenAI-specific provider options.
+     * - Auto-sets reasoningEffort for reasoning-capable models (o1, o3, o4-mini)
+     * - No context management equivalent — budget wrap-up via prepareStep is the only guard
+     * - systemMessageMode auto-handled by @ai-sdk/openai (system → developer for reasoning)
+     */
+    buildOpenAIOptions(resolved, userOptions) {
+        const userOpenAIOpts = (userOptions?.openai ?? {});
+        let openaiOpts = { ...userOpenAIOpts };
+        // Auto-set reasoningEffort for reasoning models if user hasn't specified
+        if (resolved.capabilities.extendedThinking && !('reasoningEffort' in openaiOpts)) {
+            openaiOpts = {
+                ...openaiOpts,
+                reasoningEffort: 'medium',
+            };
+        }
+        // No options to inject — return user options unchanged
+        if (Object.keys(openaiOpts).length === 0) {
+            return userOptions;
+        }
+        return {
+            ...(userOptions ?? {}),
+            openai: openaiOpts,
+        };
+    }
+    /**
+     * Google-specific provider options.
+     * - Auto-enables thinkingConfig with thinkingBudget for thinking-capable models (Gemini 2.5+)
+     * - No context management equivalent — budget wrap-up via prepareStep is the only guard
+     * - No system message wrapping — Gemini caching is implicit for 2.5+ models
+     */
+    buildGoogleOptions(resolved, userOptions) {
+        const userGoogleOpts = (userOptions?.google ?? {});
+        let googleOpts = { ...userGoogleOpts };
+        // Auto-enable thinking for models with extendedThinking capability (Gemini 2.5+)
+        if (resolved.capabilities.extendedThinking && !('thinkingConfig' in googleOpts)) {
+            googleOpts = {
+                ...googleOpts,
+                thinkingConfig: { thinkingBudget: this.config.defaultThinkingBudget },
+            };
+        }
+        if (Object.keys(googleOpts).length === 0) {
+            return userOptions;
+        }
+        return {
+            ...(userOptions ?? {}),
+            google: googleOpts,
+        };
+    }
+    /**
+     * Build a prepareStep callback that forces wrap-up when budget is 80% consumed.
+     *
+     * Each step's `inputTokens` is the TOTAL input for that API call (the full
+     * conversation including cached tokens). The last step's value represents the
+     * current context window size. We check that against the budget.
+     */
+    buildBudgetPrepareStep(budget) {
+        let wrapUpInjected = false;
+        return ({ steps }) => {
+            if (wrapUpInjected) {
+                // Already forced wrap-up, keep forcing no tools
+                return { toolChoice: 'none' };
+            }
+            if (steps.length === 0)
+                return {};
+            // Last step's inputTokens = current context window size
+            const lastStep = steps[steps.length - 1];
+            const contextSize = lastStep.usage.inputTokens ?? 0;
+            if (contextSize >= budget * 0.80) {
+                wrapUpInjected = true;
+                this.logger.warn(`Context budget 80% used (${contextSize}/${budget}). Forcing output — no more tool calls.`);
+                return { toolChoice: 'none' };
+            }
+            return {};
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Shell Command Execution (delegated to ShellExecutor)
+    // ─────────────────────────────────────────────────────────────────────────
+    // ─────────────────────────────────────────────────────────────────────────
+    // Provider Management
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Initialize AI SDK provider factories from config.
+     * @ai-sdk/anthropic, @ai-sdk/openai, and @ai-sdk/google are bundled and eagerly initialized.
+     */
+    initializeProviders(aiConfig) {
+        for (const [providerName, creds] of Object.entries(aiConfig.providers)) {
+            if (providerName === 'anthropic') {
+                const anthropic = createAnthropic({ apiKey: creds.apiKey });
+                this.anthropicInstance = anthropic;
+                this.providers.set('anthropic', (modelId) => anthropic(modelId));
+            }
+            else if (providerName === 'openai') {
+                const openai = createOpenAI({ apiKey: creds.apiKey });
+                this.openaiInstance = openai;
+                this.providers.set('openai', (modelId) => openai(modelId));
+            }
+            else if (providerName === 'google') {
+                const google = createGoogleGenerativeAI({ apiKey: creds.apiKey });
+                this.googleInstance = google;
+                this.providers.set('google', (modelId) => google(modelId));
+            }
+            // Other providers are loaded lazily in ensureProvider()
+        }
+    }
+    /**
+     * Ensure a provider is loaded. Dynamically imports non-bundled providers.
+     */
+    async ensureProvider(providerName) {
+        if (this.providers.has(providerName))
+            return;
+        const creds = this.config.ai.providers[providerName];
+        if (!creds) {
+            throw this.missingProviderError(providerName);
+        }
+        if (!AIProvider.VALID_DYNAMIC_PROVIDERS.has(providerName)) {
+            throw new ConfigurationError(`Unknown AI provider: "${providerName}". ` +
+                `Valid providers: ${[...AIProvider.VALID_DYNAMIC_PROVIDERS].join(', ')}`);
+        }
+        try {
+            // Dynamic import of @ai-sdk/<provider>
+            const mod = await import(`@ai-sdk/${providerName}`);
+            // Check override map first, then try standard naming convention (createMistral, createCohere, etc.)
+            const factoryName = AIProvider.FACTORY_NAME_OVERRIDES[providerName]
+                ?? `create${providerName.charAt(0).toUpperCase() + providerName.slice(1)}`;
+            const createProvider = (mod[factoryName] ?? mod['default']);
+            if (!createProvider || typeof createProvider !== 'function') {
+                throw new ConfigurationError(`@ai-sdk/${providerName} does not export ${factoryName} or default. ` +
+                    `Check the package documentation.`);
+            }
+            const provider = createProvider({ apiKey: creds.apiKey });
+            this.providers.set(providerName, (modelId) => provider(modelId));
+        }
+        catch (error) {
+            if (error instanceof ConfigurationError)
+                throw error;
+            const errCode = error.code;
+            if (errCode === 'ERR_MODULE_NOT_FOUND' || errCode === 'MODULE_NOT_FOUND') {
+                throw new ConfigurationError(`Provider "${providerName}" requires @ai-sdk/${providerName}. ` +
+                    `Install: npm install @ai-sdk/${providerName}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get provider factory, throwing if not configured.
+     */
+    getProviderFactory(providerName) {
+        const factory = this.providers.get(providerName);
+        if (!factory) {
+            throw this.missingProviderError(providerName);
+        }
+        return factory;
+    }
+    missingProviderError(providerName) {
+        const envVar = `${providerName.toUpperCase()}_API_KEY`;
+        return new ConfigurationError(`AI provider "${providerName}" is not configured. ` +
+            `Set the ${envVar} environment variable or add it to config.ai.providers: { ${providerName}: { apiKey: '...' } }`);
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Usage + Error Mapping
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Convert AI SDK usage to UluOps format
+     */
+    mapUsage(usage, providerMetadata) {
+        const base = {
+            input_tokens: usage.inputTokens ?? 0,
+            output_tokens: usage.outputTokens ?? 0,
+        };
+        // 1. AI SDK standard path (works for both providers)
+        if (usage.inputTokenDetails) {
+            base.cache_read_input_tokens = usage.inputTokenDetails.cacheReadTokens ?? undefined;
+            base.cache_creation_input_tokens = usage.inputTokenDetails.cacheWriteTokens ?? undefined;
+        }
+        // 2-4. Extract provider-specific metadata
+        this.extractAnthropicUsage(base, providerMetadata);
+        this.extractOpenAIUsage(base, providerMetadata);
+        this.extractGoogleUsage(base, providerMetadata);
+        // 5. Generic provider metadata scan for non-bundled providers.
+        // Best-effort extraction of cache tokens from unknown provider metadata.
+        // Uses ??= to never override values set by provider-specific tiers above.
+        if (providerMetadata && base.cache_read_input_tokens == null) {
+            this.extractGenericUsage(base, providerMetadata);
+        }
+        return base;
+    }
+    extractAnthropicUsage(base, providerMetadata) {
+        const meta = providerMetadata?.anthropic;
+        if (!meta)
+            return;
+        base.cache_creation_input_tokens ??= meta.cacheCreationInputTokens;
+        base.cache_read_input_tokens ??= meta.cacheReadInputTokens;
+    }
+    extractOpenAIUsage(base, providerMetadata) {
+        const meta = providerMetadata?.openai;
+        if (!meta)
+            return;
+        base.cache_read_input_tokens ??= meta.cachedPromptTokens;
+        if (meta.reasoningTokens)
+            base.reasoning_tokens = meta.reasoningTokens;
+    }
+    extractGoogleUsage(base, providerMetadata) {
+        const gUsage = providerMetadata?.google?.usageMetadata;
+        if (!gUsage)
+            return;
+        base.cache_read_input_tokens ??= gUsage.cachedContentTokenCount;
+        if (gUsage.thoughtsTokenCount)
+            base.thinking_tokens = gUsage.thoughtsTokenCount;
+    }
+    extractGenericUsage(base, providerMetadata) {
+        const KNOWN_PROVIDERS = new Set(['anthropic', 'openai', 'google']);
+        for (const [key, value] of Object.entries(providerMetadata)) {
+            if (KNOWN_PROVIDERS.has(key) || typeof value !== 'object' || !value)
+                continue;
+            const meta = value;
+            const cached = meta['cachedTokens'] ?? meta['cachedContentTokenCount'] ?? meta['cachedPromptTokens'];
+            if (typeof cached === 'number' && cached > 0) {
+                base.cache_read_input_tokens = cached;
+                break;
+            }
+        }
+    }
+    /**
+     * Map AI SDK errors to sdk-core error types.
+     * AI SDK normalizes all provider errors to APICallError with statusCode.
+     */
+    mapError(error, timeoutMs) {
+        this.logger.error(`AI SDK error: ${formatErrorMessage(error)}`);
+        if (isAPICallError(error)) {
+            const status = error.statusCode ?? 0;
+            if (status === 429) {
+                return new RateLimitError(`Rate limit exceeded: ${error.message}`);
+            }
+            if (status === 401) {
+                return new UnauthorizedError(`Authentication failed: ${error.message}`);
+            }
+            if (status === 403) {
+                return new ForbiddenError(`Forbidden: ${error.message}`);
+            }
+            if (status >= 500) {
+                return new ServiceUnavailableError(`Server error: ${error.message}`);
+            }
+            return new SdkApiError(status, error.message);
+        }
+        if (isRetryError(error)) {
+            return new SdkApiError(0, `Retries exhausted: ${error.message}`);
+        }
+        // Timeout (AbortError)
+        if (error instanceof Error && error.name === 'AbortError') {
+            return new TimeoutError(timeoutMs ?? this.config.timeout);
+        }
+        return new SdkApiError(0, formatErrorMessage(error));
+    }
+}
+/**
+ * Type guard for AI SDK's APICallError
+ */
+function isAPICallError(error) {
+    return error instanceof Error && 'statusCode' in error;
+}
+/**
+ * Type guard for AI SDK's RetryError
+ */
+function isRetryError(error) {
+    return error instanceof Error && error.name === 'RetryError';
+}
+//# sourceMappingURL=AIProvider.js.map

package/dist/ai/AIProvider.js.map

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

package/dist/ai/ModelCatalog.d.ts

@@ -0,0 +1,78 @@
+import type { RegistryClient as RegistrySdk, Model, ModelAlias as RegistryModelAlias, ModelCapabilities, ModelTier } from '@uluops/registry-sdk';
+/**
+ * Resolved model with provider routing information
+ */
+export interface ResolvedModel {
+    /** Provider name (e.g., 'anthropic', 'openai') */
+    provider: string;
+    /** Model ID in registry (e.g., 'claude-sonnet-4-5-20250929') */
+    modelId: string;
+    /** Provider-specific model ID for AI SDK */
+    providerModelId: string;
+    /** Model tier for cost estimation */
+    tier: ModelTier;
+    /** Model capabilities */
+    capabilities: ModelCapabilities;
+    /** Original input that resolved to this model */
+    resolvedFrom: string;
+}
+/**
+ * Options for model resolution
+ */
+export interface ResolveOptions {
+    /** Capabilities the model must support */
+    requiredCapabilities?: Array<keyof ModelCapabilities>;
+    /** Preferred provider (used when resolving by tier) */
+    preferredProvider?: string;
+}
+/**
+ * Registry-backed model catalog with in-memory caching.
+ *
+ * Resolution priority:
+ * 1. Explicit provider:modelId (e.g., "anthropic:claude-sonnet-4-5-20250929")
+ * 2. Registry alias (e.g., "sonnet") via models.resolveAlias()
+ * 3. Tier name (e.g., "premium") — resolves to first available model for tier
+ *
+ * Cache is in-memory only. Call refresh() to clear after admin syncs models.
+ * No auto-sync or TTL — model sync is an admin operation.
+ */
+export declare class ModelCatalog {
+    private sdk;
+    private aliasCache;
+    private modelCache;
+    constructor(sdk: RegistrySdk);
+    /**
+     * Resolve a model input to a fully-qualified ResolvedModel.
+     *
+     * @param input - Alias ('sonnet'), tier ('premium'), or 'provider:modelId'
+     * @param opts - Resolution options (capability checks, provider preference)
+     * @throws {ModelNotFoundError} If alias/model cannot be resolved
+     * @throws {CapabilityError} If model lacks required capabilities
+     */
+    resolve(input: string, opts?: ResolveOptions): Promise<ResolvedModel>;
+    /**
+     * List all available aliases
+     */
+    listAliases(): Promise<RegistryModelAlias[]>;
+    /**
+     * List available models, optionally filtered
+     */
+    listModels(filter?: {
+        provider?: string;
+        tier?: ModelTier;
+        capability?: keyof ModelCapabilities;
+    }): Promise<Model[]>;
+    /**
+     * Clear in-memory cache. Call after admin syncs models in the registry.
+     */
+    refresh(): void;
+    private resolveExplicit;
+    private resolveAlias;
+    private resolveByTier;
+    private getModel;
+    /** Check if an error is a 404/not-found from the registry API */
+    private isNotFoundError;
+    private toResolvedModel;
+    private validateCapabilities;
+}
+//# sourceMappingURL=ModelCatalog.d.ts.map