@dexto/core 1.1.4 → 1.1.6

package/dist/llm/registry.d.cts

@@ -0,0 +1,176 @@
+import { LLMConfig } from './schemas.cjs';
+import { SupportedFileType, LLMRouter, LLMProvider } from './types.cjs';
+import 'zod';
+
+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';
+    };
+}
+declare const MIME_TYPE_TO_FILE_TYPE: Record<string, SupportedFileType>;
+declare function getAllowedMimeTypes(): string[];
+interface ProviderInfo {
+    models: ModelInfo[];
+    supportedRouters: LLMRouter[];
+    baseURLSupport: 'none' | 'optional' | 'required';
+    supportedFileTypes: SupportedFileType[];
+}
+/** Fallback when we cannot determine the model's input-token limit */
+declare const DEFAULT_MAX_INPUT_TOKENS = 128000;
+/**
+ * LLM Model Registry - Single Source of Truth for Supported models and their capabilities
+ *
+ * IMPORTANT: supportedFileTypes is the SINGLE SOURCE OF TRUTH for file upload capabilities:
+ * - Empty array [] = Model does NOT support file uploads (UI will hide all attach buttons)
+ * - Specific types ['image', 'pdf'] = Model supports ONLY those file types
+ * - DO NOT use empty arrays as "unknown" - research the model's actual capabilities
+ * - The web UI directly reflects these capabilities without fallback logic
+ */
+declare const LLM_REGISTRY: Record<LLMProvider, ProviderInfo>;
+/**
+ * Gets the default model for a given provider from the registry.
+ * @param provider The name of the provider.
+ * @returns The default model for the provider, or null if no default model is found.
+ */
+declare function getDefaultModelForProvider(provider: LLMProvider): string | null;
+/**
+ * Gets the list of supported providers.
+ * @returns An array of supported provider names.
+ */
+declare function getSupportedProviders(): LLMProvider[];
+/**
+ * Gets the list of supported models for a given provider.
+ * @param provider The name of the provider.
+ * @returns An array of supported model names for the provider.
+ */
+declare function getSupportedModels(provider: LLMProvider): string[];
+/**
+ * Retrieves the maximum input token limit for a given provider and model from the registry.
+ * @param provider The name of the provider (e.g., 'openai', 'anthropic', 'google').
+ * @param model The specific model name.
+ * @returns The maximum input token limit for the model.
+ * @throws {LLMError} If the model is not found in the registry.
+ */
+declare function getMaxInputTokensForModel(provider: LLMProvider, model: string): number;
+/**
+ * Validates if a provider and model combination is supported.
+ * Both parameters are required - structural validation (missing values) is handled by Zod schemas.
+ * @param provider The provider name.
+ * @param model The model name.
+ * @returns True if the combination is valid, false otherwise.
+ */
+declare function isValidProviderModel(provider: LLMProvider, model: string): boolean;
+/**
+ * Infers the LLM provider from the model name by searching the registry.
+ * Matches the model name (case-insensitive) against all registered models.
+ * Returns the provider name if found, or 'unknown' if not found.
+ *
+ * @param model The model name (e.g., 'gpt-4o-mini', 'claude-3-7-sonnet-20250219')
+ * @returns The inferred provider name ('openai', 'anthropic', etc.), or 'unknown' if no match is found.
+ */
+declare function getProviderFromModel(model: string): LLMProvider;
+/**
+ * Returns a flat array of all supported model names from all providers.
+ */
+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
+ */
+declare function getSupportedRoutersForProvider(provider: LLMProvider): LLMRouter[];
+/**
+ * Checks if a provider supports custom baseURL.
+ * @param provider The name of the provider.
+ * @returns True if the provider supports custom baseURL, false otherwise.
+ */
+declare function supportsBaseURL(provider: LLMProvider): boolean;
+/**
+ * Checks if a provider requires a custom baseURL.
+ * @param provider The name of the provider.
+ * @returns True if the provider requires a custom baseURL, false otherwise.
+ */
+declare function requiresBaseURL(provider: LLMProvider): boolean;
+/**
+ * Checks if a provider accepts any model name (i.e., has empty models list).
+ * @param provider The name of the provider.
+ * @returns True if the provider accepts any model name, false otherwise.
+ */
+declare function acceptsAnyModel(provider: LLMProvider): boolean;
+/**
+ * Gets the supported file types for a specific model.
+ * @param provider The name of the provider.
+ * @param model The name of the model.
+ * @returns Array of supported file types for the model.
+ * @throws {Error} If the model is not found in the registry.
+ */
+declare function getSupportedFileTypesForModel(provider: LLMProvider, model: string): SupportedFileType[];
+/**
+ * Checks if a specific model supports a specific file type.
+ * @param provider The name of the provider.
+ * @param model The name of the model.
+ * @param fileType The file type to check support for.
+ * @returns True if the model supports the file type, false otherwise.
+ */
+declare function modelSupportsFileType(provider: LLMProvider, model: string, fileType: SupportedFileType): boolean;
+/**
+ * Validates if file data is supported by a specific model by checking the mimetype
+ * @param provider The LLM provider name.
+ * @param model The model name.
+ * @param mimeType The MIME type of the file to validate.
+ * @returns Object containing validation result and details.
+ */
+declare function validateModelFileSupport(provider: LLMProvider, model: string, mimeType: string): {
+    isSupported: boolean;
+    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.
+ */
+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.
+ */
+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.
+ */
+declare function isRouterSupportedForProvider(provider: LLMProvider, router: LLMRouter): boolean;
+/**
+ * Determines the effective maximum input token limit based on configuration.
+ * Priority:
+ * 1. Explicit `maxInputTokens` in config
+ * 2. Registry lookup for known provider/model.
+ *
+ * @param config The validated LLM configuration.
+ * @returns The effective maximum input token count for the LLM.
+ * @throws {Error}
+ * If `baseURL` is set but `maxInputTokens` is missing (indicating a Zod validation inconsistency).
+ * Or if `baseURL` is not set, but model isn't found in registry.
+ * TODO: make more readable
+ */
+declare function getEffectiveMaxInputTokens(config: LLMConfig): number;
+
+export { DEFAULT_MAX_INPUT_TOKENS, LLM_REGISTRY, MIME_TYPE_TO_FILE_TYPE, type ModelInfo, type ProviderInfo, acceptsAnyModel, getAllSupportedModels, getAllowedMimeTypes, getDefaultModelForProvider, getEffectiveMaxInputTokens, getMaxInputTokensForModel, getProviderFromModel, getSupportedFileTypesForModel, getSupportedModels, getSupportedProviders, getSupportedRoutersForModel, getSupportedRoutersForProvider, isRouterSupportedForModel, isRouterSupportedForProvider, isValidProviderModel, modelSupportsFileType, requiresBaseURL, supportsBaseURL, validateModelFileSupport };

package/dist/llm/registry.d.ts

@@ -0,0 +1,176 @@
+import { LLMConfig } from './schemas.js';
+import { SupportedFileType, LLMRouter, LLMProvider } from './types.js';
+import 'zod';
+
+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';
+    };
+}
+declare const MIME_TYPE_TO_FILE_TYPE: Record<string, SupportedFileType>;
+declare function getAllowedMimeTypes(): string[];
+interface ProviderInfo {
+    models: ModelInfo[];
+    supportedRouters: LLMRouter[];
+    baseURLSupport: 'none' | 'optional' | 'required';
+    supportedFileTypes: SupportedFileType[];
+}
+/** Fallback when we cannot determine the model's input-token limit */
+declare const DEFAULT_MAX_INPUT_TOKENS = 128000;
+/**
+ * LLM Model Registry - Single Source of Truth for Supported models and their capabilities
+ *
+ * IMPORTANT: supportedFileTypes is the SINGLE SOURCE OF TRUTH for file upload capabilities:
+ * - Empty array [] = Model does NOT support file uploads (UI will hide all attach buttons)
+ * - Specific types ['image', 'pdf'] = Model supports ONLY those file types
+ * - DO NOT use empty arrays as "unknown" - research the model's actual capabilities
+ * - The web UI directly reflects these capabilities without fallback logic
+ */
+declare const LLM_REGISTRY: Record<LLMProvider, ProviderInfo>;
+/**
+ * Gets the default model for a given provider from the registry.
+ * @param provider The name of the provider.
+ * @returns The default model for the provider, or null if no default model is found.
+ */
+declare function getDefaultModelForProvider(provider: LLMProvider): string | null;
+/**
+ * Gets the list of supported providers.
+ * @returns An array of supported provider names.
+ */
+declare function getSupportedProviders(): LLMProvider[];
+/**
+ * Gets the list of supported models for a given provider.
+ * @param provider The name of the provider.
+ * @returns An array of supported model names for the provider.
+ */
+declare function getSupportedModels(provider: LLMProvider): string[];
+/**
+ * Retrieves the maximum input token limit for a given provider and model from the registry.
+ * @param provider The name of the provider (e.g., 'openai', 'anthropic', 'google').
+ * @param model The specific model name.
+ * @returns The maximum input token limit for the model.
+ * @throws {LLMError} If the model is not found in the registry.
+ */
+declare function getMaxInputTokensForModel(provider: LLMProvider, model: string): number;
+/**
+ * Validates if a provider and model combination is supported.
+ * Both parameters are required - structural validation (missing values) is handled by Zod schemas.
+ * @param provider The provider name.
+ * @param model The model name.
+ * @returns True if the combination is valid, false otherwise.
+ */
+declare function isValidProviderModel(provider: LLMProvider, model: string): boolean;
+/**
+ * Infers the LLM provider from the model name by searching the registry.
+ * Matches the model name (case-insensitive) against all registered models.
+ * Returns the provider name if found, or 'unknown' if not found.
+ *
+ * @param model The model name (e.g., 'gpt-4o-mini', 'claude-3-7-sonnet-20250219')
+ * @returns The inferred provider name ('openai', 'anthropic', etc.), or 'unknown' if no match is found.
+ */
+declare function getProviderFromModel(model: string): LLMProvider;
+/**
+ * Returns a flat array of all supported model names from all providers.
+ */
+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
+ */
+declare function getSupportedRoutersForProvider(provider: LLMProvider): LLMRouter[];
+/**
+ * Checks if a provider supports custom baseURL.
+ * @param provider The name of the provider.
+ * @returns True if the provider supports custom baseURL, false otherwise.
+ */
+declare function supportsBaseURL(provider: LLMProvider): boolean;
+/**
+ * Checks if a provider requires a custom baseURL.
+ * @param provider The name of the provider.
+ * @returns True if the provider requires a custom baseURL, false otherwise.
+ */
+declare function requiresBaseURL(provider: LLMProvider): boolean;
+/**
+ * Checks if a provider accepts any model name (i.e., has empty models list).
+ * @param provider The name of the provider.
+ * @returns True if the provider accepts any model name, false otherwise.
+ */
+declare function acceptsAnyModel(provider: LLMProvider): boolean;
+/**
+ * Gets the supported file types for a specific model.
+ * @param provider The name of the provider.
+ * @param model The name of the model.
+ * @returns Array of supported file types for the model.
+ * @throws {Error} If the model is not found in the registry.
+ */
+declare function getSupportedFileTypesForModel(provider: LLMProvider, model: string): SupportedFileType[];
+/**
+ * Checks if a specific model supports a specific file type.
+ * @param provider The name of the provider.
+ * @param model The name of the model.
+ * @param fileType The file type to check support for.
+ * @returns True if the model supports the file type, false otherwise.
+ */
+declare function modelSupportsFileType(provider: LLMProvider, model: string, fileType: SupportedFileType): boolean;
+/**
+ * Validates if file data is supported by a specific model by checking the mimetype
+ * @param provider The LLM provider name.
+ * @param model The model name.
+ * @param mimeType The MIME type of the file to validate.
+ * @returns Object containing validation result and details.
+ */
+declare function validateModelFileSupport(provider: LLMProvider, model: string, mimeType: string): {
+    isSupported: boolean;
+    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.
+ */
+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.
+ */
+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.
+ */
+declare function isRouterSupportedForProvider(provider: LLMProvider, router: LLMRouter): boolean;
+/**
+ * Determines the effective maximum input token limit based on configuration.
+ * Priority:
+ * 1. Explicit `maxInputTokens` in config
+ * 2. Registry lookup for known provider/model.
+ *
+ * @param config The validated LLM configuration.
+ * @returns The effective maximum input token count for the LLM.
+ * @throws {Error}
+ * If `baseURL` is set but `maxInputTokens` is missing (indicating a Zod validation inconsistency).
+ * Or if `baseURL` is not set, but model isn't found in registry.
+ * TODO: make more readable
+ */
+declare function getEffectiveMaxInputTokens(config: LLMConfig): number;
+
+export { DEFAULT_MAX_INPUT_TOKENS, LLM_REGISTRY, MIME_TYPE_TO_FILE_TYPE, type ModelInfo, type ProviderInfo, acceptsAnyModel, getAllSupportedModels, getAllowedMimeTypes, getDefaultModelForProvider, getEffectiveMaxInputTokens, getMaxInputTokensForModel, getProviderFromModel, getSupportedFileTypesForModel, getSupportedModels, getSupportedProviders, getSupportedRoutersForModel, getSupportedRoutersForProvider, isRouterSupportedForModel, isRouterSupportedForProvider, isValidProviderModel, modelSupportsFileType, requiresBaseURL, supportsBaseURL, validateModelFileSupport };