@prometheus-ai/agent 0.5.4 → 0.5.8

package/dist/types/config/models-config.d.ts

@@ -0,0 +1,391 @@
+/**
+ * models.json config file handle and provider configuration validation.
+ */
+import type { Api, ModelSpec } from "@prometheus-ai/ai/types";
+import { ConfigFile } from "./config-file";
+import { type ProviderAuthMode, type ProviderDiscovery } from "./models-config-schema";
+export type ProviderValidationMode = "models-config" | "runtime-register";
+export interface ProviderValidationModel {
+    id: string;
+    api?: Api;
+    contextWindow?: number;
+    maxTokens?: number;
+}
+export interface ProviderValidationConfig {
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    apiKey?: string;
+    api?: Api;
+    auth?: ProviderAuthMode;
+    oauthConfigured?: boolean;
+    discovery?: ProviderDiscovery;
+    compat?: ModelSpec<Api>["compat"];
+    disableStrictTools?: boolean;
+    modelOverrides?: Record<string, unknown>;
+    models: ProviderValidationModel[];
+}
+export declare function validateProviderConfiguration(providerName: string, config: ProviderValidationConfig, mode: ProviderValidationMode): void;
+export declare const ModelsConfigFile: ConfigFile<{
+    providers?: Record<string, {
+        baseUrl?: string | undefined;
+        apiKey?: string | undefined;
+        api?: "anthropic-messages" | "azure-openai-responses" | "google-gemini-cli" | "google-generative-ai" | "google-vertex" | "openai-codex-responses" | "openai-completions" | "openai-responses" | undefined;
+        headers?: Record<string, string> | undefined;
+        compat?: {
+            supportsStore?: boolean | undefined;
+            supportsDeveloperRole?: boolean | undefined;
+            supportsMultipleSystemMessages?: boolean | undefined;
+            supportsReasoningEffort?: boolean | undefined;
+            reasoningEffortMap?: {
+                minimal?: string | undefined;
+                low?: string | undefined;
+                medium?: string | undefined;
+                high?: string | undefined;
+                xhigh?: string | undefined;
+            } | undefined;
+            maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+            supportsUsageInStreaming?: boolean | undefined;
+            requiresToolResultName?: boolean | undefined;
+            requiresMistralToolIds?: boolean | undefined;
+            requiresAssistantAfterToolResult?: boolean | undefined;
+            requiresThinkingAsText?: boolean | undefined;
+            reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+            requiresReasoningContentForToolCalls?: boolean | undefined;
+            allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+            requiresAssistantContentForToolCalls?: boolean | undefined;
+            supportsToolChoice?: boolean | undefined;
+            supportsForcedToolChoice?: boolean | undefined;
+            disableReasoningOnForcedToolChoice?: boolean | undefined;
+            disableReasoningOnToolChoice?: boolean | undefined;
+            thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+            openRouterRouting?: {
+                only?: string[] | undefined;
+                order?: string[] | undefined;
+            } | undefined;
+            vercelGatewayRouting?: {
+                only?: string[] | undefined;
+                order?: string[] | undefined;
+            } | undefined;
+            extraBody?: Record<string, unknown> | undefined;
+            cacheControlFormat?: "anthropic" | undefined;
+            supportsStrictMode?: boolean | undefined;
+            toolStrictMode?: "all_strict" | "none" | undefined;
+            streamIdleTimeoutMs?: number | undefined;
+            supportsLongPromptCacheRetention?: boolean | undefined;
+            supportsReasoningParams?: boolean | undefined;
+            alwaysSendMaxTokens?: boolean | undefined;
+            strictResponsesPairing?: boolean | undefined;
+            requiresToolResultId?: boolean | undefined;
+            replayUnsignedThinking?: boolean | undefined;
+            whenThinking?: {
+                supportsStore?: boolean | undefined;
+                supportsDeveloperRole?: boolean | undefined;
+                supportsMultipleSystemMessages?: boolean | undefined;
+                supportsReasoningEffort?: boolean | undefined;
+                reasoningEffortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                } | undefined;
+                maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                supportsUsageInStreaming?: boolean | undefined;
+                requiresToolResultName?: boolean | undefined;
+                requiresMistralToolIds?: boolean | undefined;
+                requiresAssistantAfterToolResult?: boolean | undefined;
+                requiresThinkingAsText?: boolean | undefined;
+                reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+                requiresReasoningContentForToolCalls?: boolean | undefined;
+                allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                requiresAssistantContentForToolCalls?: boolean | undefined;
+                supportsToolChoice?: boolean | undefined;
+                supportsForcedToolChoice?: boolean | undefined;
+                disableReasoningOnForcedToolChoice?: boolean | undefined;
+                disableReasoningOnToolChoice?: boolean | undefined;
+                thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+                openRouterRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                vercelGatewayRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+                cacheControlFormat?: "anthropic" | undefined;
+                supportsStrictMode?: boolean | undefined;
+                toolStrictMode?: "all_strict" | "none" | undefined;
+                streamIdleTimeoutMs?: number | undefined;
+                supportsLongPromptCacheRetention?: boolean | undefined;
+                supportsReasoningParams?: boolean | undefined;
+                alwaysSendMaxTokens?: boolean | undefined;
+                strictResponsesPairing?: boolean | undefined;
+                requiresToolResultId?: boolean | undefined;
+                replayUnsignedThinking?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        authHeader?: boolean | undefined;
+        auth?: "apiKey" | "none" | "oauth" | undefined;
+        discovery?: {
+            type: "llama.cpp" | "lm-studio" | "ollama" | "openai-models-list" | "proxy";
+        } | undefined;
+        models?: {
+            id: string;
+            name?: string | undefined;
+            api?: "anthropic-messages" | "azure-openai-responses" | "google-gemini-cli" | "google-generative-ai" | "google-vertex" | "openai-codex-responses" | "openai-completions" | "openai-responses" | undefined;
+            baseUrl?: string | undefined;
+            reasoning?: boolean | undefined;
+            thinking?: {
+                mode: "anthropic-adaptive" | "anthropic-budget-effort" | "budget" | "effort" | "google-level";
+                efforts: ("high" | "low" | "medium" | "minimal" | "xhigh")[];
+                defaultLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
+                effortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                } | undefined;
+                supportsDisplay?: boolean | undefined;
+            } | undefined;
+            input?: ("image" | "text")[] | undefined;
+            cost?: {
+                input: number;
+                output: number;
+                cacheRead: number;
+                cacheWrite: number;
+            } | undefined;
+            premiumMultiplier?: number | undefined;
+            contextWindow?: number | undefined;
+            maxTokens?: number | undefined;
+            omitMaxOutputTokens?: boolean | undefined;
+            headers?: Record<string, string> | undefined;
+            compat?: {
+                supportsStore?: boolean | undefined;
+                supportsDeveloperRole?: boolean | undefined;
+                supportsMultipleSystemMessages?: boolean | undefined;
+                supportsReasoningEffort?: boolean | undefined;
+                reasoningEffortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                } | undefined;
+                maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                supportsUsageInStreaming?: boolean | undefined;
+                requiresToolResultName?: boolean | undefined;
+                requiresMistralToolIds?: boolean | undefined;
+                requiresAssistantAfterToolResult?: boolean | undefined;
+                requiresThinkingAsText?: boolean | undefined;
+                reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+                requiresReasoningContentForToolCalls?: boolean | undefined;
+                allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                requiresAssistantContentForToolCalls?: boolean | undefined;
+                supportsToolChoice?: boolean | undefined;
+                supportsForcedToolChoice?: boolean | undefined;
+                disableReasoningOnForcedToolChoice?: boolean | undefined;
+                disableReasoningOnToolChoice?: boolean | undefined;
+                thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+                openRouterRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                vercelGatewayRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+                cacheControlFormat?: "anthropic" | undefined;
+                supportsStrictMode?: boolean | undefined;
+                toolStrictMode?: "all_strict" | "none" | undefined;
+                streamIdleTimeoutMs?: number | undefined;
+                supportsLongPromptCacheRetention?: boolean | undefined;
+                supportsReasoningParams?: boolean | undefined;
+                alwaysSendMaxTokens?: boolean | undefined;
+                strictResponsesPairing?: boolean | undefined;
+                requiresToolResultId?: boolean | undefined;
+                replayUnsignedThinking?: boolean | undefined;
+                whenThinking?: {
+                    supportsStore?: boolean | undefined;
+                    supportsDeveloperRole?: boolean | undefined;
+                    supportsMultipleSystemMessages?: boolean | undefined;
+                    supportsReasoningEffort?: boolean | undefined;
+                    reasoningEffortMap?: {
+                        minimal?: string | undefined;
+                        low?: string | undefined;
+                        medium?: string | undefined;
+                        high?: string | undefined;
+                        xhigh?: string | undefined;
+                    } | undefined;
+                    maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                    supportsUsageInStreaming?: boolean | undefined;
+                    requiresToolResultName?: boolean | undefined;
+                    requiresMistralToolIds?: boolean | undefined;
+                    requiresAssistantAfterToolResult?: boolean | undefined;
+                    requiresThinkingAsText?: boolean | undefined;
+                    reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+                    requiresReasoningContentForToolCalls?: boolean | undefined;
+                    allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                    requiresAssistantContentForToolCalls?: boolean | undefined;
+                    supportsToolChoice?: boolean | undefined;
+                    supportsForcedToolChoice?: boolean | undefined;
+                    disableReasoningOnForcedToolChoice?: boolean | undefined;
+                    disableReasoningOnToolChoice?: boolean | undefined;
+                    thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+                    openRouterRouting?: {
+                        only?: string[] | undefined;
+                        order?: string[] | undefined;
+                    } | undefined;
+                    vercelGatewayRouting?: {
+                        only?: string[] | undefined;
+                        order?: string[] | undefined;
+                    } | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    cacheControlFormat?: "anthropic" | undefined;
+                    supportsStrictMode?: boolean | undefined;
+                    toolStrictMode?: "all_strict" | "none" | undefined;
+                    streamIdleTimeoutMs?: number | undefined;
+                    supportsLongPromptCacheRetention?: boolean | undefined;
+                    supportsReasoningParams?: boolean | undefined;
+                    alwaysSendMaxTokens?: boolean | undefined;
+                    strictResponsesPairing?: boolean | undefined;
+                    requiresToolResultId?: boolean | undefined;
+                    replayUnsignedThinking?: boolean | undefined;
+                } | undefined;
+            } | undefined;
+            contextPromotionTarget?: string | undefined;
+        }[] | undefined;
+        modelOverrides?: Record<string, {
+            name?: string | undefined;
+            reasoning?: boolean | undefined;
+            thinking?: {
+                mode: "anthropic-adaptive" | "anthropic-budget-effort" | "budget" | "effort" | "google-level";
+                efforts: ("high" | "low" | "medium" | "minimal" | "xhigh")[];
+                defaultLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
+                effortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                } | undefined;
+                supportsDisplay?: boolean | undefined;
+            } | undefined;
+            input?: ("image" | "text")[] | undefined;
+            cost?: {
+                input?: number | undefined;
+                output?: number | undefined;
+                cacheRead?: number | undefined;
+                cacheWrite?: number | undefined;
+            } | undefined;
+            premiumMultiplier?: number | undefined;
+            contextWindow?: number | undefined;
+            maxTokens?: number | undefined;
+            omitMaxOutputTokens?: boolean | undefined;
+            headers?: Record<string, string> | undefined;
+            compat?: {
+                supportsStore?: boolean | undefined;
+                supportsDeveloperRole?: boolean | undefined;
+                supportsMultipleSystemMessages?: boolean | undefined;
+                supportsReasoningEffort?: boolean | undefined;
+                reasoningEffortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                } | undefined;
+                maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                supportsUsageInStreaming?: boolean | undefined;
+                requiresToolResultName?: boolean | undefined;
+                requiresMistralToolIds?: boolean | undefined;
+                requiresAssistantAfterToolResult?: boolean | undefined;
+                requiresThinkingAsText?: boolean | undefined;
+                reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+                requiresReasoningContentForToolCalls?: boolean | undefined;
+                allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                requiresAssistantContentForToolCalls?: boolean | undefined;
+                supportsToolChoice?: boolean | undefined;
+                supportsForcedToolChoice?: boolean | undefined;
+                disableReasoningOnForcedToolChoice?: boolean | undefined;
+                disableReasoningOnToolChoice?: boolean | undefined;
+                thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+                openRouterRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                vercelGatewayRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+                cacheControlFormat?: "anthropic" | undefined;
+                supportsStrictMode?: boolean | undefined;
+                toolStrictMode?: "all_strict" | "none" | undefined;
+                streamIdleTimeoutMs?: number | undefined;
+                supportsLongPromptCacheRetention?: boolean | undefined;
+                supportsReasoningParams?: boolean | undefined;
+                alwaysSendMaxTokens?: boolean | undefined;
+                strictResponsesPairing?: boolean | undefined;
+                requiresToolResultId?: boolean | undefined;
+                replayUnsignedThinking?: boolean | undefined;
+                whenThinking?: {
+                    supportsStore?: boolean | undefined;
+                    supportsDeveloperRole?: boolean | undefined;
+                    supportsMultipleSystemMessages?: boolean | undefined;
+                    supportsReasoningEffort?: boolean | undefined;
+                    reasoningEffortMap?: {
+                        minimal?: string | undefined;
+                        low?: string | undefined;
+                        medium?: string | undefined;
+                        high?: string | undefined;
+                        xhigh?: string | undefined;
+                    } | undefined;
+                    maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                    supportsUsageInStreaming?: boolean | undefined;
+                    requiresToolResultName?: boolean | undefined;
+                    requiresMistralToolIds?: boolean | undefined;
+                    requiresAssistantAfterToolResult?: boolean | undefined;
+                    requiresThinkingAsText?: boolean | undefined;
+                    reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+                    requiresReasoningContentForToolCalls?: boolean | undefined;
+                    allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                    requiresAssistantContentForToolCalls?: boolean | undefined;
+                    supportsToolChoice?: boolean | undefined;
+                    supportsForcedToolChoice?: boolean | undefined;
+                    disableReasoningOnForcedToolChoice?: boolean | undefined;
+                    disableReasoningOnToolChoice?: boolean | undefined;
+                    thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+                    openRouterRouting?: {
+                        only?: string[] | undefined;
+                        order?: string[] | undefined;
+                    } | undefined;
+                    vercelGatewayRouting?: {
+                        only?: string[] | undefined;
+                        order?: string[] | undefined;
+                    } | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    cacheControlFormat?: "anthropic" | undefined;
+                    supportsStrictMode?: boolean | undefined;
+                    toolStrictMode?: "all_strict" | "none" | undefined;
+                    streamIdleTimeoutMs?: number | undefined;
+                    supportsLongPromptCacheRetention?: boolean | undefined;
+                    supportsReasoningParams?: boolean | undefined;
+                    alwaysSendMaxTokens?: boolean | undefined;
+                    strictResponsesPairing?: boolean | undefined;
+                    requiresToolResultId?: boolean | undefined;
+                    replayUnsignedThinking?: boolean | undefined;
+                } | undefined;
+            } | undefined;
+            contextPromotionTarget?: string | undefined;
+        }> | undefined;
+        disableStrictTools?: boolean | undefined;
+        transport?: "prometheus-native" | undefined;
+    }> | undefined;
+    equivalence?: {
+        overrides?: Record<string, string> | undefined;
+        exclude?: string[] | undefined;
+    } | undefined;
+}>;