@dexto/core 1.3.0 → 1.5.0

package/dist/llm/registry.d.ts

@@ -1,29 +1,47 @@
+/**
+ * LLM Model Registry
+ *
+ * TODO: maxOutputTokens - Currently we rely on @ai-sdk/anthropic (and other provider SDKs)
+ * to set appropriate maxOutputTokens defaults per model. As of v2.0.56, @ai-sdk/anthropic
+ * has getModelCapabilities() which sets correct limits (e.g., 64000 for claude-haiku-4-5).
+ *
+ * If we need finer control or want to support models before the SDK does, we could:
+ * 1. Add maxOutputTokens to ModelInfo interface
+ * 2. Create getMaxOutputTokensForModel() / getEffectiveMaxOutputTokens() helpers
+ * 3. Pass explicit maxOutputTokens in TurnExecutor when config doesn't specify one
+ *
+ * For now, keeping SDK dependency is simpler and auto-updates with SDK releases.
+ */
 import { LLMConfig } from './schemas.js';
-import { type LLMProvider, type LLMRouter, type SupportedFileType } from './types.js';
+import { type LLMProvider, type SupportedFileType, type TokenUsage } from './types.js';
 import type { IDextoLogger } from '../logger/v2/types.js';
+/**
+ * Pricing metadata for a model (USD per 1M tokens).
+ * Optional; when omitted, pricing is unknown.
+ */
+export interface ModelPricing {
+    inputPerM: number;
+    outputPerM: number;
+    cacheReadPerM?: number;
+    cacheWritePerM?: number;
+    currency?: 'USD';
+    unit?: 'per_million_tokens';
+}
 export interface ModelInfo {
     name: string;
     maxInputTokens: number;
     default?: boolean;
     supportedFileTypes: SupportedFileType[];
-    supportedRouters?: LLMRouter[];
     displayName?: string;
-    pricing?: {
-        inputPerM: number;
-        outputPerM: number;
-        cacheReadPerM?: number;
-        cacheWritePerM?: number;
-        currency?: 'USD';
-        unit?: 'per_million_tokens';
-    };
+    pricing?: ModelPricing;
 }
 export declare const MIME_TYPE_TO_FILE_TYPE: Record<string, SupportedFileType>;
 export declare function getAllowedMimeTypes(): string[];
 export interface ProviderInfo {
     models: ModelInfo[];
-    supportedRouters: LLMRouter[];
     baseURLSupport: 'none' | 'optional' | 'required';
     supportedFileTypes: SupportedFileType[];
+    supportsCustomModels?: boolean;
 }
 /** Fallback when we cannot determine the model's input-token limit */
 export declare const DEFAULT_MAX_INPUT_TOKENS = 128000;
@@ -37,6 +55,13 @@ export declare const DEFAULT_MAX_INPUT_TOKENS = 128000;
  * - The web UI directly reflects these capabilities without fallback logic
  */
 export declare const LLM_REGISTRY: Record<LLMProvider, ProviderInfo>;
+/**
+ * Strips Bedrock cross-region inference profile prefix (eu., us., global.) from model ID.
+ * This allows registry lookups to work regardless of whether the user specified a prefix.
+ * @param model The model ID, potentially with a region prefix
+ * @returns The model ID without the region prefix
+ */
+export declare function stripBedrockRegionPrefix(model: string): string;
 /**
  * Gets the default model for a given provider from the registry.
  * @param provider The name of the provider.
@@ -84,12 +109,6 @@ export declare function getProviderFromModel(model: string): LLMProvider;
  * Returns a flat array of all supported model names from all providers.
  */
 export declare function getAllSupportedModels(): string[];
-/**
- * Gets the supported routers for a given provider.
- * @param provider The name of the provider.
- * @returns An array of supported router names for the provider
- */
-export declare function getSupportedRoutersForProvider(provider: LLMProvider): LLMRouter[];
 /**
  * Checks if a provider supports custom baseURL.
  * @param provider The name of the provider.
@@ -108,6 +127,24 @@ export declare function requiresBaseURL(provider: LLMProvider): boolean;
  * @returns True if the provider accepts any model name, false otherwise.
  */
 export declare function acceptsAnyModel(provider: LLMProvider): boolean;
+/**
+ * Checks if a provider supports custom model IDs beyond its fixed model list.
+ * This is set explicitly on providers that allow users to add arbitrary model IDs.
+ * @param provider The name of the provider.
+ * @returns True if the provider supports custom models, false otherwise.
+ */
+export declare function supportsCustomModels(provider: LLMProvider): boolean;
+/**
+ * Checks if a provider requires an API key.
+ * Returns false for:
+ * - Local providers (openai-compatible for Ollama, vLLM, LocalAI)
+ * - Self-hosted proxies (litellm)
+ * - Cloud auth providers (vertex, bedrock)
+ *
+ * @param provider The name of the provider.
+ * @returns True if the provider requires an API key, false otherwise.
+ */
+export declare function requiresApiKey(provider: LLMProvider): boolean;
 /**
  * Gets the supported file types for a specific model.
  * @param provider The name of the provider.
@@ -136,28 +173,6 @@ export declare function validateModelFileSupport(provider: LLMProvider, model: s
     fileType?: SupportedFileType;
     error?: string;
 };
-/**
- * Checks if a specific model supports a specific router.
- * @param provider The name of the provider.
- * @param model The name of the model.
- * @param router The router name to check.
- * @returns True if the model supports the router, false otherwise.
- */
-export declare function isRouterSupportedForModel(provider: LLMProvider, model: string, router: LLMRouter): boolean;
-/**
- * Gets the supported routers for a specific model.
- * @param provider The name of the provider.
- * @param model The name of the model.
- * @returns An array of supported router names for the model.
- */
-export declare function getSupportedRoutersForModel(provider: LLMProvider, model: string): LLMRouter[];
-/**
- * Checks if a provider supports a specific router.
- * @param provider The name of the provider.
- * @param router The router name to check.
- * @returns True if the provider supports the router, false otherwise.
- */
-export declare function isRouterSupportedForProvider(provider: LLMProvider, router: LLMRouter): boolean;
 /**
  * Determines the effective maximum input token limit based on configuration.
  * Priority:
@@ -173,4 +188,29 @@ export declare function isRouterSupportedForProvider(provider: LLMProvider, rout
  * TODO: make more readable
  */
 export declare function getEffectiveMaxInputTokens(config: LLMConfig, logger: IDextoLogger): number;
+/**
+ * Gets the pricing information for a specific model.
+ *
+ * TODO: When adding gateway providers (openrouter, vercel-ai, dexto, etc.),
+ * each gateway will be its own provider with its own pricing in the registry.
+ * The gateway's pricing includes any markup, so no separate "gateway multiplier" logic is needed.
+ * Example: provider: 'dexto' would have models with Dexto's pricing (base + markup baked in).
+ *
+ * @param provider The name of the provider.
+ * @param model The name of the model.
+ * @returns The pricing information for the model, or undefined if not available.
+ */
+export declare function getModelPricing(provider: LLMProvider, model: string): ModelPricing | undefined;
+/**
+ * Gets the display name for a model, falling back to the model ID if not found.
+ */
+export declare function getModelDisplayName(model: string, provider?: LLMProvider): string;
+/**
+ * Calculates the cost for a given token usage based on model pricing.
+ *
+ * @param usage Token usage counts.
+ * @param pricing Model pricing (per million tokens).
+ * @returns Cost in USD.
+ */
+export declare function calculateCost(usage: TokenUsage, pricing: ModelPricing): number;
 //# sourceMappingURL=registry.d.ts.map

package/dist/llm/registry.d.ts.map

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