@imdigitalashish/zpi 0.1.1

package/dist/core/model-resolver.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Model resolution, scoping, and initial selection
+ */
+import type { ThinkingLevel } from "@mariozechner/pi-agent-core";
+import { type Api, type KnownProvider, type Model } from "@mariozechner/pi-ai";
+import type { ModelRegistry } from "./model-registry.js";
+/** Default model IDs for each known provider */
+export declare const defaultModelPerProvider: Record<KnownProvider, string>;
+export interface ScopedModel {
+    model: Model<Api>;
+    /** Thinking level if explicitly specified in pattern (e.g., "model:high"), undefined otherwise */
+    thinkingLevel?: ThinkingLevel;
+}
+export interface ParsedModelResult {
+    model: Model<Api> | undefined;
+    /** Thinking level if explicitly specified in pattern, undefined otherwise */
+    thinkingLevel?: ThinkingLevel;
+    warning: string | undefined;
+}
+/**
+ * Parse a pattern to extract model and thinking level.
+ * Handles models with colons in their IDs (e.g., OpenRouter's :exacto suffix).
+ *
+ * Algorithm:
+ * 1. Try to match full pattern as a model
+ * 2. If found, return it with "off" thinking level
+ * 3. If not found and has colons, split on last colon:
+ *    - If suffix is valid thinking level, use it and recurse on prefix
+ *    - If suffix is invalid, warn and recurse on prefix with "off"
+ *
+ * @internal Exported for testing
+ */
+export declare function parseModelPattern(pattern: string, availableModels: Model<Api>[], options?: {
+    allowInvalidThinkingLevelFallback?: boolean;
+}): ParsedModelResult;
+/**
+ * Resolve model patterns to actual Model objects with optional thinking levels
+ * Format: "pattern:level" where :level is optional
+ * For each pattern, finds all matching models and picks the best version:
+ * 1. Prefer alias (e.g., claude-sonnet-4-5) over dated versions (claude-sonnet-4-5-20250929)
+ * 2. If no alias, pick the latest dated version
+ *
+ * Supports models with colons in their IDs (e.g., OpenRouter's model:exacto).
+ * The algorithm tries to match the full pattern first, then progressively
+ * strips colon-suffixes to find a match.
+ */
+export declare function resolveModelScope(patterns: string[], modelRegistry: ModelRegistry): Promise<ScopedModel[]>;
+export interface ResolveCliModelResult {
+    model: Model<Api> | undefined;
+    thinkingLevel?: ThinkingLevel;
+    warning: string | undefined;
+    /**
+     * Error message suitable for CLI display.
+     * When set, model will be undefined.
+     */
+    error: string | undefined;
+}
+/**
+ * Resolve a single model from CLI flags.
+ *
+ * Supports:
+ * - --provider <provider> --model <pattern>
+ * - --model <provider>/<pattern>
+ * - Fuzzy matching (same rules as model scoping: exact id, then partial id/name)
+ *
+ * Note: This does not apply the thinking level by itself, but it may *parse* and
+ * return a thinking level from "<pattern>:<thinking>" so the caller can apply it.
+ */
+export declare function resolveCliModel(options: {
+    cliProvider?: string;
+    cliModel?: string;
+    modelRegistry: ModelRegistry;
+}): ResolveCliModelResult;
+export interface InitialModelResult {
+    model: Model<Api> | undefined;
+    thinkingLevel: ThinkingLevel;
+    fallbackMessage: string | undefined;
+}
+/**
+ * Find the initial model to use based on priority:
+ * 1. CLI args (provider + model)
+ * 2. First model from scoped models (if not continuing/resuming)
+ * 3. Restored from session (if continuing/resuming)
+ * 4. Saved default from settings
+ * 5. First available model with valid API key
+ */
+export declare function findInitialModel(options: {
+    cliProvider?: string;
+    cliModel?: string;
+    scopedModels: ScopedModel[];
+    isContinuing: boolean;
+    defaultProvider?: string;
+    defaultModelId?: string;
+    defaultThinkingLevel?: ThinkingLevel;
+    modelRegistry: ModelRegistry;
+}): Promise<InitialModelResult>;
+/**
+ * Restore model from session, with fallback to available models
+ */
+export declare function restoreModelFromSession(savedProvider: string, savedModelId: string, currentModel: Model<Api> | undefined, shouldPrintMessages: boolean, modelRegistry: ModelRegistry): Promise<{
+    model: Model<Api> | undefined;
+    fallbackMessage: string | undefined;
+}>;
+//# sourceMappingURL=model-resolver.d.ts.map

package/dist/core/model-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../src/core/model-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAkB,MAAM,qBAAqB,CAAC;AAK/F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,gDAAgD;AAChD,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAuBjE,CAAC;AAEF,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,kGAAkG;IAClG,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAkED,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9B,6EAA6E;IAC7E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAC7B,OAAO,CAAC,EAAE;IAAE,iCAAiC,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD,iBAAiB,CAiDnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA0DhH;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;CAC7B,GAAG,qBAAqB,CAkFxB;AAED,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9B,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,aAAa,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;CAC7B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiE9B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC5C,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,EACpC,mBAAmB,EAAE,OAAO,EAC5B,aAAa,EAAE,aAAa,GAC1B,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CA+DjF","sourcesContent":["/**\r\n * Model resolution, scoping, and initial selection\r\n */\r\n\r\nimport type { ThinkingLevel } from \"@mariozechner/pi-agent-core\";\r\nimport { type Api, type KnownProvider, type Model, modelsAreEqual } from \"@mariozechner/pi-ai\";\r\nimport chalk from \"chalk\";\r\nimport { minimatch } from \"minimatch\";\r\nimport { isValidThinkingLevel } from \"../cli/args.js\";\r\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.js\";\r\nimport type { ModelRegistry } from \"./model-registry.js\";\r\n\r\n/** Default model IDs for each known provider */\r\nexport const defaultModelPerProvider: Record<KnownProvider, string> = {\r\n\t\"amazon-bedrock\": \"us.anthropic.claude-opus-4-6-v1\",\r\n\tanthropic: \"claude-opus-4-6\",\r\n\topenai: \"gpt-5.1-codex\",\r\n\t\"azure-openai-responses\": \"gpt-5.2\",\r\n\t\"openai-codex\": \"gpt-5.3-codex\",\r\n\tgoogle: \"gemini-2.5-pro\",\r\n\t\"google-gemini-cli\": \"gemini-2.5-pro\",\r\n\t\"google-antigravity\": \"gemini-3-pro-high\",\r\n\t\"google-vertex\": \"gemini-3-pro-preview\",\r\n\t\"github-copilot\": \"gpt-4o\",\r\n\topenrouter: \"openai/gpt-5.1-codex\",\r\n\t\"vercel-ai-gateway\": \"anthropic/claude-opus-4-6\",\r\n\txai: \"grok-4-fast-non-reasoning\",\r\n\tgroq: \"openai/gpt-oss-120b\",\r\n\tcerebras: \"zai-glm-4.6\",\r\n\tzai: \"glm-4.6\",\r\n\tmistral: \"devstral-medium-latest\",\r\n\tminimax: \"MiniMax-M2.1\",\r\n\t\"minimax-cn\": \"MiniMax-M2.1\",\r\n\thuggingface: \"moonshotai/Kimi-K2.5\",\r\n\topencode: \"claude-opus-4-6\",\r\n\t\"kimi-coding\": \"kimi-k2-thinking\",\r\n};\r\n\r\nexport interface ScopedModel {\r\n\tmodel: Model<Api>;\r\n\t/** Thinking level if explicitly specified in pattern (e.g., \"model:high\"), undefined otherwise */\r\n\tthinkingLevel?: ThinkingLevel;\r\n}\r\n\r\n/**\r\n * Helper to check if a model ID looks like an alias (no date suffix)\r\n * Dates are typically in format: -20241022 or -20250929\r\n */\r\nfunction isAlias(id: string): boolean {\r\n\t// Check if ID ends with -latest\r\n\tif (id.endsWith(\"-latest\")) return true;\r\n\r\n\t// Check if ID ends with a date pattern (-YYYYMMDD)\r\n\tconst datePattern = /-\\d{8}$/;\r\n\treturn !datePattern.test(id);\r\n}\r\n\r\n/**\r\n * Try to match a pattern to a model from the available models list.\r\n * Returns the matched model or undefined if no match found.\r\n */\r\nfunction tryMatchModel(modelPattern: string, availableModels: Model<Api>[]): Model<Api> | undefined {\r\n\t// Check for provider/modelId format (provider is everything before the first /)\r\n\tconst slashIndex = modelPattern.indexOf(\"/\");\r\n\tif (slashIndex !== -1) {\r\n\t\tconst provider = modelPattern.substring(0, slashIndex);\r\n\t\tconst modelId = modelPattern.substring(slashIndex + 1);\r\n\t\tconst providerMatch = availableModels.find(\r\n\t\t\t(m) => m.provider.toLowerCase() === provider.toLowerCase() && m.id.toLowerCase() === modelId.toLowerCase(),\r\n\t\t);\r\n\t\tif (providerMatch) {\r\n\t\t\treturn providerMatch;\r\n\t\t}\r\n\t\t// No exact provider/model match - fall through to other matching\r\n\t}\r\n\r\n\t// Check for exact ID match (case-insensitive)\r\n\tconst exactMatch = availableModels.find((m) => m.id.toLowerCase() === modelPattern.toLowerCase());\r\n\tif (exactMatch) {\r\n\t\treturn exactMatch;\r\n\t}\r\n\r\n\t// No exact match - fall back to partial matching\r\n\tconst matches = availableModels.filter(\r\n\t\t(m) =>\r\n\t\t\tm.id.toLowerCase().includes(modelPattern.toLowerCase()) ||\r\n\t\t\tm.name?.toLowerCase().includes(modelPattern.toLowerCase()),\r\n\t);\r\n\r\n\tif (matches.length === 0) {\r\n\t\treturn undefined;\r\n\t}\r\n\r\n\t// Separate into aliases and dated versions\r\n\tconst aliases = matches.filter((m) => isAlias(m.id));\r\n\tconst datedVersions = matches.filter((m) => !isAlias(m.id));\r\n\r\n\tif (aliases.length > 0) {\r\n\t\t// Prefer alias - if multiple aliases, pick the one that sorts highest\r\n\t\taliases.sort((a, b) => b.id.localeCompare(a.id));\r\n\t\treturn aliases[0];\r\n\t} else {\r\n\t\t// No alias found, pick latest dated version\r\n\t\tdatedVersions.sort((a, b) => b.id.localeCompare(a.id));\r\n\t\treturn datedVersions[0];\r\n\t}\r\n}\r\n\r\nexport interface ParsedModelResult {\r\n\tmodel: Model<Api> | undefined;\r\n\t/** Thinking level if explicitly specified in pattern, undefined otherwise */\r\n\tthinkingLevel?: ThinkingLevel;\r\n\twarning: string | undefined;\r\n}\r\n\r\n/**\r\n * Parse a pattern to extract model and thinking level.\r\n * Handles models with colons in their IDs (e.g., OpenRouter's :exacto suffix).\r\n *\r\n * Algorithm:\r\n * 1. Try to match full pattern as a model\r\n * 2. If found, return it with \"off\" thinking level\r\n * 3. If not found and has colons, split on last colon:\r\n *    - If suffix is valid thinking level, use it and recurse on prefix\r\n *    - If suffix is invalid, warn and recurse on prefix with \"off\"\r\n *\r\n * @internal Exported for testing\r\n */\r\nexport function parseModelPattern(\r\n\tpattern: string,\r\n\tavailableModels: Model<Api>[],\r\n\toptions?: { allowInvalidThinkingLevelFallback?: boolean },\r\n): ParsedModelResult {\r\n\t// Try exact match first\r\n\tconst exactMatch = tryMatchModel(pattern, availableModels);\r\n\tif (exactMatch) {\r\n\t\treturn { model: exactMatch, thinkingLevel: undefined, warning: undefined };\r\n\t}\r\n\r\n\t// No match - try splitting on last colon if present\r\n\tconst lastColonIndex = pattern.lastIndexOf(\":\");\r\n\tif (lastColonIndex === -1) {\r\n\t\t// No colons, pattern simply doesn't match any model\r\n\t\treturn { model: undefined, thinkingLevel: undefined, warning: undefined };\r\n\t}\r\n\r\n\tconst prefix = pattern.substring(0, lastColonIndex);\r\n\tconst suffix = pattern.substring(lastColonIndex + 1);\r\n\r\n\tif (isValidThinkingLevel(suffix)) {\r\n\t\t// Valid thinking level - recurse on prefix and use this level\r\n\t\tconst result = parseModelPattern(prefix, availableModels, options);\r\n\t\tif (result.model) {\r\n\t\t\t// Only use this thinking level if no warning from inner recursion\r\n\t\t\treturn {\r\n\t\t\t\tmodel: result.model,\r\n\t\t\t\tthinkingLevel: result.warning ? undefined : suffix,\r\n\t\t\t\twarning: result.warning,\r\n\t\t\t};\r\n\t\t}\r\n\t\treturn result;\r\n\t} else {\r\n\t\t// Invalid suffix\r\n\t\tconst allowFallback = options?.allowInvalidThinkingLevelFallback ?? true;\r\n\t\tif (!allowFallback) {\r\n\t\t\t// In strict mode (CLI --model parsing), treat it as part of the model id and fail.\r\n\t\t\t// This avoids accidentally resolving to a different model.\r\n\t\t\treturn { model: undefined, thinkingLevel: undefined, warning: undefined };\r\n\t\t}\r\n\r\n\t\t// Scope mode: recurse on prefix and warn\r\n\t\tconst result = parseModelPattern(prefix, availableModels, options);\r\n\t\tif (result.model) {\r\n\t\t\treturn {\r\n\t\t\t\tmodel: result.model,\r\n\t\t\t\tthinkingLevel: undefined,\r\n\t\t\t\twarning: `Invalid thinking level \"${suffix}\" in pattern \"${pattern}\". Using default instead.`,\r\n\t\t\t};\r\n\t\t}\r\n\t\treturn result;\r\n\t}\r\n}\r\n\r\n/**\r\n * Resolve model patterns to actual Model objects with optional thinking levels\r\n * Format: \"pattern:level\" where :level is optional\r\n * For each pattern, finds all matching models and picks the best version:\r\n * 1. Prefer alias (e.g., claude-sonnet-4-5) over dated versions (claude-sonnet-4-5-20250929)\r\n * 2. If no alias, pick the latest dated version\r\n *\r\n * Supports models with colons in their IDs (e.g., OpenRouter's model:exacto).\r\n * The algorithm tries to match the full pattern first, then progressively\r\n * strips colon-suffixes to find a match.\r\n */\r\nexport async function resolveModelScope(patterns: string[], modelRegistry: ModelRegistry): Promise<ScopedModel[]> {\r\n\tconst availableModels = await modelRegistry.getAvailable();\r\n\tconst scopedModels: ScopedModel[] = [];\r\n\r\n\tfor (const pattern of patterns) {\r\n\t\t// Check if pattern contains glob characters\r\n\t\tif (pattern.includes(\"*\") || pattern.includes(\"?\") || pattern.includes(\"[\")) {\r\n\t\t\t// Extract optional thinking level suffix (e.g., \"provider/*:high\")\r\n\t\t\tconst colonIdx = pattern.lastIndexOf(\":\");\r\n\t\t\tlet globPattern = pattern;\r\n\t\t\tlet thinkingLevel: ThinkingLevel | undefined;\r\n\r\n\t\t\tif (colonIdx !== -1) {\r\n\t\t\t\tconst suffix = pattern.substring(colonIdx + 1);\r\n\t\t\t\tif (isValidThinkingLevel(suffix)) {\r\n\t\t\t\t\tthinkingLevel = suffix;\r\n\t\t\t\t\tglobPattern = pattern.substring(0, colonIdx);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\t// Match against \"provider/modelId\" format OR just model ID\r\n\t\t\t// This allows \"*sonnet*\" to match without requiring \"anthropic/*sonnet*\"\r\n\t\t\tconst matchingModels = availableModels.filter((m) => {\r\n\t\t\t\tconst fullId = `${m.provider}/${m.id}`;\r\n\t\t\t\treturn minimatch(fullId, globPattern, { nocase: true }) || minimatch(m.id, globPattern, { nocase: true });\r\n\t\t\t});\r\n\r\n\t\t\tif (matchingModels.length === 0) {\r\n\t\t\t\tconsole.warn(chalk.yellow(`Warning: No models match pattern \"${pattern}\"`));\r\n\t\t\t\tcontinue;\r\n\t\t\t}\r\n\r\n\t\t\tfor (const model of matchingModels) {\r\n\t\t\t\tif (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {\r\n\t\t\t\t\tscopedModels.push({ model, thinkingLevel });\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\tcontinue;\r\n\t\t}\r\n\r\n\t\tconst { model, thinkingLevel, warning } = parseModelPattern(pattern, availableModels);\r\n\r\n\t\tif (warning) {\r\n\t\t\tconsole.warn(chalk.yellow(`Warning: ${warning}`));\r\n\t\t}\r\n\r\n\t\tif (!model) {\r\n\t\t\tconsole.warn(chalk.yellow(`Warning: No models match pattern \"${pattern}\"`));\r\n\t\t\tcontinue;\r\n\t\t}\r\n\r\n\t\t// Avoid duplicates\r\n\t\tif (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {\r\n\t\t\tscopedModels.push({ model, thinkingLevel });\r\n\t\t}\r\n\t}\r\n\r\n\treturn scopedModels;\r\n}\r\n\r\nexport interface ResolveCliModelResult {\r\n\tmodel: Model<Api> | undefined;\r\n\tthinkingLevel?: ThinkingLevel;\r\n\twarning: string | undefined;\r\n\t/**\r\n\t * Error message suitable for CLI display.\r\n\t * When set, model will be undefined.\r\n\t */\r\n\terror: string | undefined;\r\n}\r\n\r\n/**\r\n * Resolve a single model from CLI flags.\r\n *\r\n * Supports:\r\n * - --provider <provider> --model <pattern>\r\n * - --model <provider>/<pattern>\r\n * - Fuzzy matching (same rules as model scoping: exact id, then partial id/name)\r\n *\r\n * Note: This does not apply the thinking level by itself, but it may *parse* and\r\n * return a thinking level from \"<pattern>:<thinking>\" so the caller can apply it.\r\n */\r\nexport function resolveCliModel(options: {\r\n\tcliProvider?: string;\r\n\tcliModel?: string;\r\n\tmodelRegistry: ModelRegistry;\r\n}): ResolveCliModelResult {\r\n\tconst { cliProvider, cliModel, modelRegistry } = options;\r\n\r\n\tif (!cliModel) {\r\n\t\treturn { model: undefined, warning: undefined, error: undefined };\r\n\t}\r\n\r\n\t// Important: use *all* models here, not just models with pre-configured auth.\r\n\t// This allows \"--api-key\" to be used for first-time setup.\r\n\tconst availableModels = modelRegistry.getAll();\r\n\tif (availableModels.length === 0) {\r\n\t\treturn {\r\n\t\t\tmodel: undefined,\r\n\t\t\twarning: undefined,\r\n\t\t\terror: \"No models available. Check your installation or add models to models.json.\",\r\n\t\t};\r\n\t}\r\n\r\n\t// Build canonical provider lookup (case-insensitive)\r\n\tconst providerMap = new Map<string, string>();\r\n\tfor (const m of availableModels) {\r\n\t\tproviderMap.set(m.provider.toLowerCase(), m.provider);\r\n\t}\r\n\r\n\tlet provider = cliProvider ? providerMap.get(cliProvider.toLowerCase()) : undefined;\r\n\tif (cliProvider && !provider) {\r\n\t\treturn {\r\n\t\t\tmodel: undefined,\r\n\t\t\twarning: undefined,\r\n\t\t\terror: `Unknown provider \"${cliProvider}\". Use --list-models to see available providers/models.`,\r\n\t\t};\r\n\t}\r\n\r\n\t// If no explicit --provider, first try exact matches without any provider inference.\r\n\t// This avoids misinterpreting model IDs that themselves contain slashes (e.g. OpenRouter-style IDs).\r\n\tif (!provider) {\r\n\t\tconst lower = cliModel.toLowerCase();\r\n\t\tconst exact = availableModels.find(\r\n\t\t\t(m) => m.id.toLowerCase() === lower || `${m.provider}/${m.id}`.toLowerCase() === lower,\r\n\t\t);\r\n\t\tif (exact) {\r\n\t\t\treturn { model: exact, warning: undefined, thinkingLevel: undefined, error: undefined };\r\n\t\t}\r\n\t}\r\n\r\n\tlet pattern = cliModel;\r\n\r\n\t// If no explicit --provider, allow --model provider/<pattern>\r\n\tif (!provider) {\r\n\t\tconst slashIndex = cliModel.indexOf(\"/\");\r\n\t\tif (slashIndex !== -1) {\r\n\t\t\tconst maybeProvider = cliModel.substring(0, slashIndex);\r\n\t\t\tconst canonical = providerMap.get(maybeProvider.toLowerCase());\r\n\t\t\tif (canonical) {\r\n\t\t\t\tprovider = canonical;\r\n\t\t\t\tpattern = cliModel.substring(slashIndex + 1);\r\n\t\t\t}\r\n\t\t}\r\n\t} else {\r\n\t\t// If both were provided, tolerate --model <provider>/<pattern> by stripping the provider prefix\r\n\t\tconst prefix = `${provider}/`;\r\n\t\tif (cliModel.toLowerCase().startsWith(prefix.toLowerCase())) {\r\n\t\t\tpattern = cliModel.substring(prefix.length);\r\n\t\t}\r\n\t}\r\n\r\n\tconst candidates = provider ? availableModels.filter((m) => m.provider === provider) : availableModels;\r\n\tconst { model, thinkingLevel, warning } = parseModelPattern(pattern, candidates, {\r\n\t\tallowInvalidThinkingLevelFallback: false,\r\n\t});\r\n\r\n\tif (!model) {\r\n\t\tconst display = provider ? `${provider}/${pattern}` : cliModel;\r\n\t\treturn {\r\n\t\t\tmodel: undefined,\r\n\t\t\tthinkingLevel: undefined,\r\n\t\t\twarning,\r\n\t\t\terror: `Model \"${display}\" not found. Use --list-models to see available models.`,\r\n\t\t};\r\n\t}\r\n\r\n\treturn { model, thinkingLevel, warning, error: undefined };\r\n}\r\n\r\nexport interface InitialModelResult {\r\n\tmodel: Model<Api> | undefined;\r\n\tthinkingLevel: ThinkingLevel;\r\n\tfallbackMessage: string | undefined;\r\n}\r\n\r\n/**\r\n * Find the initial model to use based on priority:\r\n * 1. CLI args (provider + model)\r\n * 2. First model from scoped models (if not continuing/resuming)\r\n * 3. Restored from session (if continuing/resuming)\r\n * 4. Saved default from settings\r\n * 5. First available model with valid API key\r\n */\r\nexport async function findInitialModel(options: {\r\n\tcliProvider?: string;\r\n\tcliModel?: string;\r\n\tscopedModels: ScopedModel[];\r\n\tisContinuing: boolean;\r\n\tdefaultProvider?: string;\r\n\tdefaultModelId?: string;\r\n\tdefaultThinkingLevel?: ThinkingLevel;\r\n\tmodelRegistry: ModelRegistry;\r\n}): Promise<InitialModelResult> {\r\n\tconst {\r\n\t\tcliProvider,\r\n\t\tcliModel,\r\n\t\tscopedModels,\r\n\t\tisContinuing,\r\n\t\tdefaultProvider,\r\n\t\tdefaultModelId,\r\n\t\tdefaultThinkingLevel,\r\n\t\tmodelRegistry,\r\n\t} = options;\r\n\r\n\tlet model: Model<Api> | undefined;\r\n\tlet thinkingLevel: ThinkingLevel = DEFAULT_THINKING_LEVEL;\r\n\r\n\t// 1. CLI args take priority\r\n\tif (cliProvider && cliModel) {\r\n\t\tconst found = modelRegistry.find(cliProvider, cliModel);\r\n\t\tif (!found) {\r\n\t\t\tconsole.error(chalk.red(`Model ${cliProvider}/${cliModel} not found`));\r\n\t\t\tprocess.exit(1);\r\n\t\t}\r\n\t\treturn { model: found, thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };\r\n\t}\r\n\r\n\t// 2. Use first model from scoped models (skip if continuing/resuming)\r\n\tif (scopedModels.length > 0 && !isContinuing) {\r\n\t\treturn {\r\n\t\t\tmodel: scopedModels[0].model,\r\n\t\t\tthinkingLevel: scopedModels[0].thinkingLevel ?? defaultThinkingLevel ?? DEFAULT_THINKING_LEVEL,\r\n\t\t\tfallbackMessage: undefined,\r\n\t\t};\r\n\t}\r\n\r\n\t// 3. Try saved default from settings\r\n\tif (defaultProvider && defaultModelId) {\r\n\t\tconst found = modelRegistry.find(defaultProvider, defaultModelId);\r\n\t\tif (found) {\r\n\t\t\tmodel = found;\r\n\t\t\tif (defaultThinkingLevel) {\r\n\t\t\t\tthinkingLevel = defaultThinkingLevel;\r\n\t\t\t}\r\n\t\t\treturn { model, thinkingLevel, fallbackMessage: undefined };\r\n\t\t}\r\n\t}\r\n\r\n\t// 4. Try first available model with valid API key\r\n\tconst availableModels = await modelRegistry.getAvailable();\r\n\r\n\tif (availableModels.length > 0) {\r\n\t\t// Try to find a default model from known providers\r\n\t\tfor (const provider of Object.keys(defaultModelPerProvider) as KnownProvider[]) {\r\n\t\t\tconst defaultId = defaultModelPerProvider[provider];\r\n\t\t\tconst match = availableModels.find((m) => m.provider === provider && m.id === defaultId);\r\n\t\t\tif (match) {\r\n\t\t\t\treturn { model: match, thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// If no default found, use first available\r\n\t\treturn { model: availableModels[0], thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };\r\n\t}\r\n\r\n\t// 5. No model found\r\n\treturn { model: undefined, thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };\r\n}\r\n\r\n/**\r\n * Restore model from session, with fallback to available models\r\n */\r\nexport async function restoreModelFromSession(\r\n\tsavedProvider: string,\r\n\tsavedModelId: string,\r\n\tcurrentModel: Model<Api> | undefined,\r\n\tshouldPrintMessages: boolean,\r\n\tmodelRegistry: ModelRegistry,\r\n): Promise<{ model: Model<Api> | undefined; fallbackMessage: string | undefined }> {\r\n\tconst restoredModel = modelRegistry.find(savedProvider, savedModelId);\r\n\r\n\t// Check if restored model exists and has a valid API key\r\n\tconst hasApiKey = restoredModel ? !!(await modelRegistry.getApiKey(restoredModel)) : false;\r\n\r\n\tif (restoredModel && hasApiKey) {\r\n\t\tif (shouldPrintMessages) {\r\n\t\t\tconsole.log(chalk.dim(`Restored model: ${savedProvider}/${savedModelId}`));\r\n\t\t}\r\n\t\treturn { model: restoredModel, fallbackMessage: undefined };\r\n\t}\r\n\r\n\t// Model not found or no API key - fall back\r\n\tconst reason = !restoredModel ? \"model no longer exists\" : \"no API key available\";\r\n\r\n\tif (shouldPrintMessages) {\r\n\t\tconsole.error(chalk.yellow(`Warning: Could not restore model ${savedProvider}/${savedModelId} (${reason}).`));\r\n\t}\r\n\r\n\t// If we already have a model, use it as fallback\r\n\tif (currentModel) {\r\n\t\tif (shouldPrintMessages) {\r\n\t\t\tconsole.log(chalk.dim(`Falling back to: ${currentModel.provider}/${currentModel.id}`));\r\n\t\t}\r\n\t\treturn {\r\n\t\t\tmodel: currentModel,\r\n\t\t\tfallbackMessage: `Could not restore model ${savedProvider}/${savedModelId} (${reason}). Using ${currentModel.provider}/${currentModel.id}.`,\r\n\t\t};\r\n\t}\r\n\r\n\t// Try to find any available model\r\n\tconst availableModels = await modelRegistry.getAvailable();\r\n\r\n\tif (availableModels.length > 0) {\r\n\t\t// Try to find a default model from known providers\r\n\t\tlet fallbackModel: Model<Api> | undefined;\r\n\t\tfor (const provider of Object.keys(defaultModelPerProvider) as KnownProvider[]) {\r\n\t\t\tconst defaultId = defaultModelPerProvider[provider];\r\n\t\t\tconst match = availableModels.find((m) => m.provider === provider && m.id === defaultId);\r\n\t\t\tif (match) {\r\n\t\t\t\tfallbackModel = match;\r\n\t\t\t\tbreak;\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// If no default found, use first available\r\n\t\tif (!fallbackModel) {\r\n\t\t\tfallbackModel = availableModels[0];\r\n\t\t}\r\n\r\n\t\tif (shouldPrintMessages) {\r\n\t\t\tconsole.log(chalk.dim(`Falling back to: ${fallbackModel.provider}/${fallbackModel.id}`));\r\n\t\t}\r\n\r\n\t\treturn {\r\n\t\t\tmodel: fallbackModel,\r\n\t\t\tfallbackMessage: `Could not restore model ${savedProvider}/${savedModelId} (${reason}). Using ${fallbackModel.provider}/${fallbackModel.id}.`,\r\n\t\t};\r\n\t}\r\n\r\n\t// No models available\r\n\treturn { model: undefined, fallbackMessage: undefined };\r\n}\r\n"]}

package/dist/core/model-resolver.js

@@ -0,0 +1,403 @@
+/**
+ * Model resolution, scoping, and initial selection
+ */
+import { modelsAreEqual } from "@mariozechner/pi-ai";
+import chalk from "chalk";
+import { minimatch } from "minimatch";
+import { isValidThinkingLevel } from "../cli/args.js";
+import { DEFAULT_THINKING_LEVEL } from "./defaults.js";
+/** Default model IDs for each known provider */
+export const defaultModelPerProvider = {
+    "amazon-bedrock": "us.anthropic.claude-opus-4-6-v1",
+    anthropic: "claude-opus-4-6",
+    openai: "gpt-5.1-codex",
+    "azure-openai-responses": "gpt-5.2",
+    "openai-codex": "gpt-5.3-codex",
+    google: "gemini-2.5-pro",
+    "google-gemini-cli": "gemini-2.5-pro",
+    "google-antigravity": "gemini-3-pro-high",
+    "google-vertex": "gemini-3-pro-preview",
+    "github-copilot": "gpt-4o",
+    openrouter: "openai/gpt-5.1-codex",
+    "vercel-ai-gateway": "anthropic/claude-opus-4-6",
+    xai: "grok-4-fast-non-reasoning",
+    groq: "openai/gpt-oss-120b",
+    cerebras: "zai-glm-4.6",
+    zai: "glm-4.6",
+    mistral: "devstral-medium-latest",
+    minimax: "MiniMax-M2.1",
+    "minimax-cn": "MiniMax-M2.1",
+    huggingface: "moonshotai/Kimi-K2.5",
+    opencode: "claude-opus-4-6",
+    "kimi-coding": "kimi-k2-thinking",
+};
+/**
+ * Helper to check if a model ID looks like an alias (no date suffix)
+ * Dates are typically in format: -20241022 or -20250929
+ */
+function isAlias(id) {
+    // Check if ID ends with -latest
+    if (id.endsWith("-latest"))
+        return true;
+    // Check if ID ends with a date pattern (-YYYYMMDD)
+    const datePattern = /-\d{8}$/;
+    return !datePattern.test(id);
+}
+/**
+ * Try to match a pattern to a model from the available models list.
+ * Returns the matched model or undefined if no match found.
+ */
+function tryMatchModel(modelPattern, availableModels) {
+    // Check for provider/modelId format (provider is everything before the first /)
+    const slashIndex = modelPattern.indexOf("/");
+    if (slashIndex !== -1) {
+        const provider = modelPattern.substring(0, slashIndex);
+        const modelId = modelPattern.substring(slashIndex + 1);
+        const providerMatch = availableModels.find((m) => m.provider.toLowerCase() === provider.toLowerCase() && m.id.toLowerCase() === modelId.toLowerCase());
+        if (providerMatch) {
+            return providerMatch;
+        }
+        // No exact provider/model match - fall through to other matching
+    }
+    // Check for exact ID match (case-insensitive)
+    const exactMatch = availableModels.find((m) => m.id.toLowerCase() === modelPattern.toLowerCase());
+    if (exactMatch) {
+        return exactMatch;
+    }
+    // No exact match - fall back to partial matching
+    const matches = availableModels.filter((m) => m.id.toLowerCase().includes(modelPattern.toLowerCase()) ||
+        m.name?.toLowerCase().includes(modelPattern.toLowerCase()));
+    if (matches.length === 0) {
+        return undefined;
+    }
+    // Separate into aliases and dated versions
+    const aliases = matches.filter((m) => isAlias(m.id));
+    const datedVersions = matches.filter((m) => !isAlias(m.id));
+    if (aliases.length > 0) {
+        // Prefer alias - if multiple aliases, pick the one that sorts highest
+        aliases.sort((a, b) => b.id.localeCompare(a.id));
+        return aliases[0];
+    }
+    else {
+        // No alias found, pick latest dated version
+        datedVersions.sort((a, b) => b.id.localeCompare(a.id));
+        return datedVersions[0];
+    }
+}
+/**
+ * Parse a pattern to extract model and thinking level.
+ * Handles models with colons in their IDs (e.g., OpenRouter's :exacto suffix).
+ *
+ * Algorithm:
+ * 1. Try to match full pattern as a model
+ * 2. If found, return it with "off" thinking level
+ * 3. If not found and has colons, split on last colon:
+ *    - If suffix is valid thinking level, use it and recurse on prefix
+ *    - If suffix is invalid, warn and recurse on prefix with "off"
+ *
+ * @internal Exported for testing
+ */
+export function parseModelPattern(pattern, availableModels, options) {
+    // Try exact match first
+    const exactMatch = tryMatchModel(pattern, availableModels);
+    if (exactMatch) {
+        return { model: exactMatch, thinkingLevel: undefined, warning: undefined };
+    }
+    // No match - try splitting on last colon if present
+    const lastColonIndex = pattern.lastIndexOf(":");
+    if (lastColonIndex === -1) {
+        // No colons, pattern simply doesn't match any model
+        return { model: undefined, thinkingLevel: undefined, warning: undefined };
+    }
+    const prefix = pattern.substring(0, lastColonIndex);
+    const suffix = pattern.substring(lastColonIndex + 1);
+    if (isValidThinkingLevel(suffix)) {
+        // Valid thinking level - recurse on prefix and use this level
+        const result = parseModelPattern(prefix, availableModels, options);
+        if (result.model) {
+            // Only use this thinking level if no warning from inner recursion
+            return {
+                model: result.model,
+                thinkingLevel: result.warning ? undefined : suffix,
+                warning: result.warning,
+            };
+        }
+        return result;
+    }
+    else {
+        // Invalid suffix
+        const allowFallback = options?.allowInvalidThinkingLevelFallback ?? true;
+        if (!allowFallback) {
+            // In strict mode (CLI --model parsing), treat it as part of the model id and fail.
+            // This avoids accidentally resolving to a different model.
+            return { model: undefined, thinkingLevel: undefined, warning: undefined };
+        }
+        // Scope mode: recurse on prefix and warn
+        const result = parseModelPattern(prefix, availableModels, options);
+        if (result.model) {
+            return {
+                model: result.model,
+                thinkingLevel: undefined,
+                warning: `Invalid thinking level "${suffix}" in pattern "${pattern}". Using default instead.`,
+            };
+        }
+        return result;
+    }
+}
+/**
+ * Resolve model patterns to actual Model objects with optional thinking levels
+ * Format: "pattern:level" where :level is optional
+ * For each pattern, finds all matching models and picks the best version:
+ * 1. Prefer alias (e.g., claude-sonnet-4-5) over dated versions (claude-sonnet-4-5-20250929)
+ * 2. If no alias, pick the latest dated version
+ *
+ * Supports models with colons in their IDs (e.g., OpenRouter's model:exacto).
+ * The algorithm tries to match the full pattern first, then progressively
+ * strips colon-suffixes to find a match.
+ */
+export async function resolveModelScope(patterns, modelRegistry) {
+    const availableModels = await modelRegistry.getAvailable();
+    const scopedModels = [];
+    for (const pattern of patterns) {
+        // Check if pattern contains glob characters
+        if (pattern.includes("*") || pattern.includes("?") || pattern.includes("[")) {
+            // Extract optional thinking level suffix (e.g., "provider/*:high")
+            const colonIdx = pattern.lastIndexOf(":");
+            let globPattern = pattern;
+            let thinkingLevel;
+            if (colonIdx !== -1) {
+                const suffix = pattern.substring(colonIdx + 1);
+                if (isValidThinkingLevel(suffix)) {
+                    thinkingLevel = suffix;
+                    globPattern = pattern.substring(0, colonIdx);
+                }
+            }
+            // Match against "provider/modelId" format OR just model ID
+            // This allows "*sonnet*" to match without requiring "anthropic/*sonnet*"
+            const matchingModels = availableModels.filter((m) => {
+                const fullId = `${m.provider}/${m.id}`;
+                return minimatch(fullId, globPattern, { nocase: true }) || minimatch(m.id, globPattern, { nocase: true });
+            });
+            if (matchingModels.length === 0) {
+                console.warn(chalk.yellow(`Warning: No models match pattern "${pattern}"`));
+                continue;
+            }
+            for (const model of matchingModels) {
+                if (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {
+                    scopedModels.push({ model, thinkingLevel });
+                }
+            }
+            continue;
+        }
+        const { model, thinkingLevel, warning } = parseModelPattern(pattern, availableModels);
+        if (warning) {
+            console.warn(chalk.yellow(`Warning: ${warning}`));
+        }
+        if (!model) {
+            console.warn(chalk.yellow(`Warning: No models match pattern "${pattern}"`));
+            continue;
+        }
+        // Avoid duplicates
+        if (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {
+            scopedModels.push({ model, thinkingLevel });
+        }
+    }
+    return scopedModels;
+}
+/**
+ * Resolve a single model from CLI flags.
+ *
+ * Supports:
+ * - --provider <provider> --model <pattern>
+ * - --model <provider>/<pattern>
+ * - Fuzzy matching (same rules as model scoping: exact id, then partial id/name)
+ *
+ * Note: This does not apply the thinking level by itself, but it may *parse* and
+ * return a thinking level from "<pattern>:<thinking>" so the caller can apply it.
+ */
+export function resolveCliModel(options) {
+    const { cliProvider, cliModel, modelRegistry } = options;
+    if (!cliModel) {
+        return { model: undefined, warning: undefined, error: undefined };
+    }
+    // Important: use *all* models here, not just models with pre-configured auth.
+    // This allows "--api-key" to be used for first-time setup.
+    const availableModels = modelRegistry.getAll();
+    if (availableModels.length === 0) {
+        return {
+            model: undefined,
+            warning: undefined,
+            error: "No models available. Check your installation or add models to models.json.",
+        };
+    }
+    // Build canonical provider lookup (case-insensitive)
+    const providerMap = new Map();
+    for (const m of availableModels) {
+        providerMap.set(m.provider.toLowerCase(), m.provider);
+    }
+    let provider = cliProvider ? providerMap.get(cliProvider.toLowerCase()) : undefined;
+    if (cliProvider && !provider) {
+        return {
+            model: undefined,
+            warning: undefined,
+            error: `Unknown provider "${cliProvider}". Use --list-models to see available providers/models.`,
+        };
+    }
+    // If no explicit --provider, first try exact matches without any provider inference.
+    // This avoids misinterpreting model IDs that themselves contain slashes (e.g. OpenRouter-style IDs).
+    if (!provider) {
+        const lower = cliModel.toLowerCase();
+        const exact = availableModels.find((m) => m.id.toLowerCase() === lower || `${m.provider}/${m.id}`.toLowerCase() === lower);
+        if (exact) {
+            return { model: exact, warning: undefined, thinkingLevel: undefined, error: undefined };
+        }
+    }
+    let pattern = cliModel;
+    // If no explicit --provider, allow --model provider/<pattern>
+    if (!provider) {
+        const slashIndex = cliModel.indexOf("/");
+        if (slashIndex !== -1) {
+            const maybeProvider = cliModel.substring(0, slashIndex);
+            const canonical = providerMap.get(maybeProvider.toLowerCase());
+            if (canonical) {
+                provider = canonical;
+                pattern = cliModel.substring(slashIndex + 1);
+            }
+        }
+    }
+    else {
+        // If both were provided, tolerate --model <provider>/<pattern> by stripping the provider prefix
+        const prefix = `${provider}/`;
+        if (cliModel.toLowerCase().startsWith(prefix.toLowerCase())) {
+            pattern = cliModel.substring(prefix.length);
+        }
+    }
+    const candidates = provider ? availableModels.filter((m) => m.provider === provider) : availableModels;
+    const { model, thinkingLevel, warning } = parseModelPattern(pattern, candidates, {
+        allowInvalidThinkingLevelFallback: false,
+    });
+    if (!model) {
+        const display = provider ? `${provider}/${pattern}` : cliModel;
+        return {
+            model: undefined,
+            thinkingLevel: undefined,
+            warning,
+            error: `Model "${display}" not found. Use --list-models to see available models.`,
+        };
+    }
+    return { model, thinkingLevel, warning, error: undefined };
+}
+/**
+ * Find the initial model to use based on priority:
+ * 1. CLI args (provider + model)
+ * 2. First model from scoped models (if not continuing/resuming)
+ * 3. Restored from session (if continuing/resuming)
+ * 4. Saved default from settings
+ * 5. First available model with valid API key
+ */
+export async function findInitialModel(options) {
+    const { cliProvider, cliModel, scopedModels, isContinuing, defaultProvider, defaultModelId, defaultThinkingLevel, modelRegistry, } = options;
+    let model;
+    let thinkingLevel = DEFAULT_THINKING_LEVEL;
+    // 1. CLI args take priority
+    if (cliProvider && cliModel) {
+        const found = modelRegistry.find(cliProvider, cliModel);
+        if (!found) {
+            console.error(chalk.red(`Model ${cliProvider}/${cliModel} not found`));
+            process.exit(1);
+        }
+        return { model: found, thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };
+    }
+    // 2. Use first model from scoped models (skip if continuing/resuming)
+    if (scopedModels.length > 0 && !isContinuing) {
+        return {
+            model: scopedModels[0].model,
+            thinkingLevel: scopedModels[0].thinkingLevel ?? defaultThinkingLevel ?? DEFAULT_THINKING_LEVEL,
+            fallbackMessage: undefined,
+        };
+    }
+    // 3. Try saved default from settings
+    if (defaultProvider && defaultModelId) {
+        const found = modelRegistry.find(defaultProvider, defaultModelId);
+        if (found) {
+            model = found;
+            if (defaultThinkingLevel) {
+                thinkingLevel = defaultThinkingLevel;
+            }
+            return { model, thinkingLevel, fallbackMessage: undefined };
+        }
+    }
+    // 4. Try first available model with valid API key
+    const availableModels = await modelRegistry.getAvailable();
+    if (availableModels.length > 0) {
+        // Try to find a default model from known providers
+        for (const provider of Object.keys(defaultModelPerProvider)) {
+            const defaultId = defaultModelPerProvider[provider];
+            const match = availableModels.find((m) => m.provider === provider && m.id === defaultId);
+            if (match) {
+                return { model: match, thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };
+            }
+        }
+        // If no default found, use first available
+        return { model: availableModels[0], thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };
+    }
+    // 5. No model found
+    return { model: undefined, thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };
+}
+/**
+ * Restore model from session, with fallback to available models
+ */
+export async function restoreModelFromSession(savedProvider, savedModelId, currentModel, shouldPrintMessages, modelRegistry) {
+    const restoredModel = modelRegistry.find(savedProvider, savedModelId);
+    // Check if restored model exists and has a valid API key
+    const hasApiKey = restoredModel ? !!(await modelRegistry.getApiKey(restoredModel)) : false;
+    if (restoredModel && hasApiKey) {
+        if (shouldPrintMessages) {
+            console.log(chalk.dim(`Restored model: ${savedProvider}/${savedModelId}`));
+        }
+        return { model: restoredModel, fallbackMessage: undefined };
+    }
+    // Model not found or no API key - fall back
+    const reason = !restoredModel ? "model no longer exists" : "no API key available";
+    if (shouldPrintMessages) {
+        console.error(chalk.yellow(`Warning: Could not restore model ${savedProvider}/${savedModelId} (${reason}).`));
+    }
+    // If we already have a model, use it as fallback
+    if (currentModel) {
+        if (shouldPrintMessages) {
+            console.log(chalk.dim(`Falling back to: ${currentModel.provider}/${currentModel.id}`));
+        }
+        return {
+            model: currentModel,
+            fallbackMessage: `Could not restore model ${savedProvider}/${savedModelId} (${reason}). Using ${currentModel.provider}/${currentModel.id}.`,
+        };
+    }
+    // Try to find any available model
+    const availableModels = await modelRegistry.getAvailable();
+    if (availableModels.length > 0) {
+        // Try to find a default model from known providers
+        let fallbackModel;
+        for (const provider of Object.keys(defaultModelPerProvider)) {
+            const defaultId = defaultModelPerProvider[provider];
+            const match = availableModels.find((m) => m.provider === provider && m.id === defaultId);
+            if (match) {
+                fallbackModel = match;
+                break;
+            }
+        }
+        // If no default found, use first available
+        if (!fallbackModel) {
+            fallbackModel = availableModels[0];
+        }
+        if (shouldPrintMessages) {
+            console.log(chalk.dim(`Falling back to: ${fallbackModel.provider}/${fallbackModel.id}`));
+        }
+        return {
+            model: fallbackModel,
+            fallbackMessage: `Could not restore model ${savedProvider}/${savedModelId} (${reason}). Using ${fallbackModel.provider}/${fallbackModel.id}.`,
+        };
+    }
+    // No models available
+    return { model: undefined, fallbackMessage: undefined };
+}
+//# sourceMappingURL=model-resolver.js.map

package/dist/core/model-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.js","sourceRoot":"","sources":["../../src/core/model-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Model resolution, scoping, and initial selection\r\n */\r\n\r\nimport type { ThinkingLevel } from \"@mariozechner/pi-agent-core\";\r\nimport { type Api, type KnownProvider, type Model, modelsAreEqual } from \"@mariozechner/pi-ai\";\r\nimport chalk from \"chalk\";\r\nimport { minimatch } from \"minimatch\";\r\nimport { isValidThinkingLevel } from \"../cli/args.js\";\r\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.js\";\r\nimport type { ModelRegistry } from \"./model-registry.js\";\r\n\r\n/** Default model IDs for each known provider */\r\nexport const defaultModelPerProvider: Record<KnownProvider, string> = {\r\n\t\"amazon-bedrock\": \"us.anthropic.claude-opus-4-6-v1\",\r\n\tanthropic: \"claude-opus-4-6\",\r\n\topenai: \"gpt-5.1-codex\",\r\n\t\"azure-openai-responses\": \"gpt-5.2\",\r\n\t\"openai-codex\": \"gpt-5.3-codex\",\r\n\tgoogle: \"gemini-2.5-pro\",\r\n\t\"google-gemini-cli\": \"gemini-2.5-pro\",\r\n\t\"google-antigravity\": \"gemini-3-pro-high\",\r\n\t\"google-vertex\": \"gemini-3-pro-preview\",\r\n\t\"github-copilot\": \"gpt-4o\",\r\n\topenrouter: \"openai/gpt-5.1-codex\",\r\n\t\"vercel-ai-gateway\": \"anthropic/claude-opus-4-6\",\r\n\txai: \"grok-4-fast-non-reasoning\",\r\n\tgroq: \"openai/gpt-oss-120b\",\r\n\tcerebras: \"zai-glm-4.6\",\r\n\tzai: \"glm-4.6\",\r\n\tmistral: \"devstral-medium-latest\",\r\n\tminimax: \"MiniMax-M2.1\",\r\n\t\"minimax-cn\": \"MiniMax-M2.1\",\r\n\thuggingface: \"moonshotai/Kimi-K2.5\",\r\n\topencode: \"claude-opus-4-6\",\r\n\t\"kimi-coding\": \"kimi-k2-thinking\",\r\n};\r\n\r\nexport interface ScopedModel {\r\n\tmodel: Model<Api>;\r\n\t/** Thinking level if explicitly specified in pattern (e.g., \"model:high\"), undefined otherwise */\r\n\tthinkingLevel?: ThinkingLevel;\r\n}\r\n\r\n/**\r\n * Helper to check if a model ID looks like an alias (no date suffix)\r\n * Dates are typically in format: -20241022 or -20250929\r\n */\r\nfunction isAlias(id: string): boolean {\r\n\t// Check if ID ends with -latest\r\n\tif (id.endsWith(\"-latest\")) return true;\r\n\r\n\t// Check if ID ends with a date pattern (-YYYYMMDD)\r\n\tconst datePattern = /-\\d{8}$/;\r\n\treturn !datePattern.test(id);\r\n}\r\n\r\n/**\r\n * Try to match a pattern to a model from the available models list.\r\n * Returns the matched model or undefined if no match found.\r\n */\r\nfunction tryMatchModel(modelPattern: string, availableModels: Model<Api>[]): Model<Api> | undefined {\r\n\t// Check for provider/modelId format (provider is everything before the first /)\r\n\tconst slashIndex = modelPattern.indexOf(\"/\");\r\n\tif (slashIndex !== -1) {\r\n\t\tconst provider = modelPattern.substring(0, slashIndex);\r\n\t\tconst modelId = modelPattern.substring(slashIndex + 1);\r\n\t\tconst providerMatch = availableModels.find(\r\n\t\t\t(m) => m.provider.toLowerCase() === provider.toLowerCase() && m.id.toLowerCase() === modelId.toLowerCase(),\r\n\t\t);\r\n\t\tif (providerMatch) {\r\n\t\t\treturn providerMatch;\r\n\t\t}\r\n\t\t// No exact provider/model match - fall through to other matching\r\n\t}\r\n\r\n\t// Check for exact ID match (case-insensitive)\r\n\tconst exactMatch = availableModels.find((m) => m.id.toLowerCase() === modelPattern.toLowerCase());\r\n\tif (exactMatch) {\r\n\t\treturn exactMatch;\r\n\t}\r\n\r\n\t// No exact match - fall back to partial matching\r\n\tconst matches = availableModels.filter(\r\n\t\t(m) =>\r\n\t\t\tm.id.toLowerCase().includes(modelPattern.toLowerCase()) ||\r\n\t\t\tm.name?.toLowerCase().includes(modelPattern.toLowerCase()),\r\n\t);\r\n\r\n\tif (matches.length === 0) {\r\n\t\treturn undefined;\r\n\t}\r\n\r\n\t// Separate into aliases and dated versions\r\n\tconst aliases = matches.filter((m) => isAlias(m.id));\r\n\tconst datedVersions = matches.filter((m) => !isAlias(m.id));\r\n\r\n\tif (aliases.length > 0) {\r\n\t\t// Prefer alias - if multiple aliases, pick the one that sorts highest\r\n\t\taliases.sort((a, b) => b.id.localeCompare(a.id));\r\n\t\treturn aliases[0];\r\n\t} else {\r\n\t\t// No alias found, pick latest dated version\r\n\t\tdatedVersions.sort((a, b) => b.id.localeCompare(a.id));\r\n\t\treturn datedVersions[0];\r\n\t}\r\n}\r\n\r\nexport interface ParsedModelResult {\r\n\tmodel: Model<Api> | undefined;\r\n\t/** Thinking level if explicitly specified in pattern, undefined otherwise */\r\n\tthinkingLevel?: ThinkingLevel;\r\n\twarning: string | undefined;\r\n}\r\n\r\n/**\r\n * Parse a pattern to extract model and thinking level.\r\n * Handles models with colons in their IDs (e.g., OpenRouter's :exacto suffix).\r\n *\r\n * Algorithm:\r\n * 1. Try to match full pattern as a model\r\n * 2. If found, return it with \"off\" thinking level\r\n * 3. If not found and has colons, split on last colon:\r\n *    - If suffix is valid thinking level, use it and recurse on prefix\r\n *    - If suffix is invalid, warn and recurse on prefix with \"off\"\r\n *\r\n * @internal Exported for testing\r\n */\r\nexport function parseModelPattern(\r\n\tpattern: string,\r\n\tavailableModels: Model<Api>[],\r\n\toptions?: { allowInvalidThinkingLevelFallback?: boolean },\r\n): ParsedModelResult {\r\n\t// Try exact match first\r\n\tconst exactMatch = tryMatchModel(pattern, availableModels);\r\n\tif (exactMatch) {\r\n\t\treturn { model: exactMatch, thinkingLevel: undefined, warning: undefined };\r\n\t}\r\n\r\n\t// No match - try splitting on last colon if present\r\n\tconst lastColonIndex = pattern.lastIndexOf(\":\");\r\n\tif (lastColonIndex === -1) {\r\n\t\t// No colons, pattern simply doesn't match any model\r\n\t\treturn { model: undefined, thinkingLevel: undefined, warning: undefined };\r\n\t}\r\n\r\n\tconst prefix = pattern.substring(0, lastColonIndex);\r\n\tconst suffix = pattern.substring(lastColonIndex + 1);\r\n\r\n\tif (isValidThinkingLevel(suffix)) {\r\n\t\t// Valid thinking level - recurse on prefix and use this level\r\n\t\tconst result = parseModelPattern(prefix, availableModels, options);\r\n\t\tif (result.model) {\r\n\t\t\t// Only use this thinking level if no warning from inner recursion\r\n\t\t\treturn {\r\n\t\t\t\tmodel: result.model,\r\n\t\t\t\tthinkingLevel: result.warning ? undefined : suffix,\r\n\t\t\t\twarning: result.warning,\r\n\t\t\t};\r\n\t\t}\r\n\t\treturn result;\r\n\t} else {\r\n\t\t// Invalid suffix\r\n\t\tconst allowFallback = options?.allowInvalidThinkingLevelFallback ?? true;\r\n\t\tif (!allowFallback) {\r\n\t\t\t// In strict mode (CLI --model parsing), treat it as part of the model id and fail.\r\n\t\t\t// This avoids accidentally resolving to a different model.\r\n\t\t\treturn { model: undefined, thinkingLevel: undefined, warning: undefined };\r\n\t\t}\r\n\r\n\t\t// Scope mode: recurse on prefix and warn\r\n\t\tconst result = parseModelPattern(prefix, availableModels, options);\r\n\t\tif (result.model) {\r\n\t\t\treturn {\r\n\t\t\t\tmodel: result.model,\r\n\t\t\t\tthinkingLevel: undefined,\r\n\t\t\t\twarning: `Invalid thinking level \"${suffix}\" in pattern \"${pattern}\". Using default instead.`,\r\n\t\t\t};\r\n\t\t}\r\n\t\treturn result;\r\n\t}\r\n}\r\n\r\n/**\r\n * Resolve model patterns to actual Model objects with optional thinking levels\r\n * Format: \"pattern:level\" where :level is optional\r\n * For each pattern, finds all matching models and picks the best version:\r\n * 1. Prefer alias (e.g., claude-sonnet-4-5) over dated versions (claude-sonnet-4-5-20250929)\r\n * 2. If no alias, pick the latest dated version\r\n *\r\n * Supports models with colons in their IDs (e.g., OpenRouter's model:exacto).\r\n * The algorithm tries to match the full pattern first, then progressively\r\n * strips colon-suffixes to find a match.\r\n */\r\nexport async function resolveModelScope(patterns: string[], modelRegistry: ModelRegistry): Promise<ScopedModel[]> {\r\n\tconst availableModels = await modelRegistry.getAvailable();\r\n\tconst scopedModels: ScopedModel[] = [];\r\n\r\n\tfor (const pattern of patterns) {\r\n\t\t// Check if pattern contains glob characters\r\n\t\tif (pattern.includes(\"*\") || pattern.includes(\"?\") || pattern.includes(\"[\")) {\r\n\t\t\t// Extract optional thinking level suffix (e.g., \"provider/*:high\")\r\n\t\t\tconst colonIdx = pattern.lastIndexOf(\":\");\r\n\t\t\tlet globPattern = pattern;\r\n\t\t\tlet thinkingLevel: ThinkingLevel | undefined;\r\n\r\n\t\t\tif (colonIdx !== -1) {\r\n\t\t\t\tconst suffix = pattern.substring(colonIdx + 1);\r\n\t\t\t\tif (isValidThinkingLevel(suffix)) {\r\n\t\t\t\t\tthinkingLevel = suffix;\r\n\t\t\t\t\tglobPattern = pattern.substring(0, colonIdx);\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\t// Match against \"provider/modelId\" format OR just model ID\r\n\t\t\t// This allows \"*sonnet*\" to match without requiring \"anthropic/*sonnet*\"\r\n\t\t\tconst matchingModels = availableModels.filter((m) => {\r\n\t\t\t\tconst fullId = `${m.provider}/${m.id}`;\r\n\t\t\t\treturn minimatch(fullId, globPattern, { nocase: true }) || minimatch(m.id, globPattern, { nocase: true });\r\n\t\t\t});\r\n\r\n\t\t\tif (matchingModels.length === 0) {\r\n\t\t\t\tconsole.warn(chalk.yellow(`Warning: No models match pattern \"${pattern}\"`));\r\n\t\t\t\tcontinue;\r\n\t\t\t}\r\n\r\n\t\t\tfor (const model of matchingModels) {\r\n\t\t\t\tif (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {\r\n\t\t\t\t\tscopedModels.push({ model, thinkingLevel });\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\tcontinue;\r\n\t\t}\r\n\r\n\t\tconst { model, thinkingLevel, warning } = parseModelPattern(pattern, availableModels);\r\n\r\n\t\tif (warning) {\r\n\t\t\tconsole.warn(chalk.yellow(`Warning: ${warning}`));\r\n\t\t}\r\n\r\n\t\tif (!model) {\r\n\t\t\tconsole.warn(chalk.yellow(`Warning: No models match pattern \"${pattern}\"`));\r\n\t\t\tcontinue;\r\n\t\t}\r\n\r\n\t\t// Avoid duplicates\r\n\t\tif (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {\r\n\t\t\tscopedModels.push({ model, thinkingLevel });\r\n\t\t}\r\n\t}\r\n\r\n\treturn scopedModels;\r\n}\r\n\r\nexport interface ResolveCliModelResult {\r\n\tmodel: Model<Api> | undefined;\r\n\tthinkingLevel?: ThinkingLevel;\r\n\twarning: string | undefined;\r\n\t/**\r\n\t * Error message suitable for CLI display.\r\n\t * When set, model will be undefined.\r\n\t */\r\n\terror: string | undefined;\r\n}\r\n\r\n/**\r\n * Resolve a single model from CLI flags.\r\n *\r\n * Supports:\r\n * - --provider <provider> --model <pattern>\r\n * - --model <provider>/<pattern>\r\n * - Fuzzy matching (same rules as model scoping: exact id, then partial id/name)\r\n *\r\n * Note: This does not apply the thinking level by itself, but it may *parse* and\r\n * return a thinking level from \"<pattern>:<thinking>\" so the caller can apply it.\r\n */\r\nexport function resolveCliModel(options: {\r\n\tcliProvider?: string;\r\n\tcliModel?: string;\r\n\tmodelRegistry: ModelRegistry;\r\n}): ResolveCliModelResult {\r\n\tconst { cliProvider, cliModel, modelRegistry } = options;\r\n\r\n\tif (!cliModel) {\r\n\t\treturn { model: undefined, warning: undefined, error: undefined };\r\n\t}\r\n\r\n\t// Important: use *all* models here, not just models with pre-configured auth.\r\n\t// This allows \"--api-key\" to be used for first-time setup.\r\n\tconst availableModels = modelRegistry.getAll();\r\n\tif (availableModels.length === 0) {\r\n\t\treturn {\r\n\t\t\tmodel: undefined,\r\n\t\t\twarning: undefined,\r\n\t\t\terror: \"No models available. Check your installation or add models to models.json.\",\r\n\t\t};\r\n\t}\r\n\r\n\t// Build canonical provider lookup (case-insensitive)\r\n\tconst providerMap = new Map<string, string>();\r\n\tfor (const m of availableModels) {\r\n\t\tproviderMap.set(m.provider.toLowerCase(), m.provider);\r\n\t}\r\n\r\n\tlet provider = cliProvider ? providerMap.get(cliProvider.toLowerCase()) : undefined;\r\n\tif (cliProvider && !provider) {\r\n\t\treturn {\r\n\t\t\tmodel: undefined,\r\n\t\t\twarning: undefined,\r\n\t\t\terror: `Unknown provider \"${cliProvider}\". Use --list-models to see available providers/models.`,\r\n\t\t};\r\n\t}\r\n\r\n\t// If no explicit --provider, first try exact matches without any provider inference.\r\n\t// This avoids misinterpreting model IDs that themselves contain slashes (e.g. OpenRouter-style IDs).\r\n\tif (!provider) {\r\n\t\tconst lower = cliModel.toLowerCase();\r\n\t\tconst exact = availableModels.find(\r\n\t\t\t(m) => m.id.toLowerCase() === lower || `${m.provider}/${m.id}`.toLowerCase() === lower,\r\n\t\t);\r\n\t\tif (exact) {\r\n\t\t\treturn { model: exact, warning: undefined, thinkingLevel: undefined, error: undefined };\r\n\t\t}\r\n\t}\r\n\r\n\tlet pattern = cliModel;\r\n\r\n\t// If no explicit --provider, allow --model provider/<pattern>\r\n\tif (!provider) {\r\n\t\tconst slashIndex = cliModel.indexOf(\"/\");\r\n\t\tif (slashIndex !== -1) {\r\n\t\t\tconst maybeProvider = cliModel.substring(0, slashIndex);\r\n\t\t\tconst canonical = providerMap.get(maybeProvider.toLowerCase());\r\n\t\t\tif (canonical) {\r\n\t\t\t\tprovider = canonical;\r\n\t\t\t\tpattern = cliModel.substring(slashIndex + 1);\r\n\t\t\t}\r\n\t\t}\r\n\t} else {\r\n\t\t// If both were provided, tolerate --model <provider>/<pattern> by stripping the provider prefix\r\n\t\tconst prefix = `${provider}/`;\r\n\t\tif (cliModel.toLowerCase().startsWith(prefix.toLowerCase())) {\r\n\t\t\tpattern = cliModel.substring(prefix.length);\r\n\t\t}\r\n\t}\r\n\r\n\tconst candidates = provider ? availableModels.filter((m) => m.provider === provider) : availableModels;\r\n\tconst { model, thinkingLevel, warning } = parseModelPattern(pattern, candidates, {\r\n\t\tallowInvalidThinkingLevelFallback: false,\r\n\t});\r\n\r\n\tif (!model) {\r\n\t\tconst display = provider ? `${provider}/${pattern}` : cliModel;\r\n\t\treturn {\r\n\t\t\tmodel: undefined,\r\n\t\t\tthinkingLevel: undefined,\r\n\t\t\twarning,\r\n\t\t\terror: `Model \"${display}\" not found. Use --list-models to see available models.`,\r\n\t\t};\r\n\t}\r\n\r\n\treturn { model, thinkingLevel, warning, error: undefined };\r\n}\r\n\r\nexport interface InitialModelResult {\r\n\tmodel: Model<Api> | undefined;\r\n\tthinkingLevel: ThinkingLevel;\r\n\tfallbackMessage: string | undefined;\r\n}\r\n\r\n/**\r\n * Find the initial model to use based on priority:\r\n * 1. CLI args (provider + model)\r\n * 2. First model from scoped models (if not continuing/resuming)\r\n * 3. Restored from session (if continuing/resuming)\r\n * 4. Saved default from settings\r\n * 5. First available model with valid API key\r\n */\r\nexport async function findInitialModel(options: {\r\n\tcliProvider?: string;\r\n\tcliModel?: string;\r\n\tscopedModels: ScopedModel[];\r\n\tisContinuing: boolean;\r\n\tdefaultProvider?: string;\r\n\tdefaultModelId?: string;\r\n\tdefaultThinkingLevel?: ThinkingLevel;\r\n\tmodelRegistry: ModelRegistry;\r\n}): Promise<InitialModelResult> {\r\n\tconst {\r\n\t\tcliProvider,\r\n\t\tcliModel,\r\n\t\tscopedModels,\r\n\t\tisContinuing,\r\n\t\tdefaultProvider,\r\n\t\tdefaultModelId,\r\n\t\tdefaultThinkingLevel,\r\n\t\tmodelRegistry,\r\n\t} = options;\r\n\r\n\tlet model: Model<Api> | undefined;\r\n\tlet thinkingLevel: ThinkingLevel = DEFAULT_THINKING_LEVEL;\r\n\r\n\t// 1. CLI args take priority\r\n\tif (cliProvider && cliModel) {\r\n\t\tconst found = modelRegistry.find(cliProvider, cliModel);\r\n\t\tif (!found) {\r\n\t\t\tconsole.error(chalk.red(`Model ${cliProvider}/${cliModel} not found`));\r\n\t\t\tprocess.exit(1);\r\n\t\t}\r\n\t\treturn { model: found, thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };\r\n\t}\r\n\r\n\t// 2. Use first model from scoped models (skip if continuing/resuming)\r\n\tif (scopedModels.length > 0 && !isContinuing) {\r\n\t\treturn {\r\n\t\t\tmodel: scopedModels[0].model,\r\n\t\t\tthinkingLevel: scopedModels[0].thinkingLevel ?? defaultThinkingLevel ?? DEFAULT_THINKING_LEVEL,\r\n\t\t\tfallbackMessage: undefined,\r\n\t\t};\r\n\t}\r\n\r\n\t// 3. Try saved default from settings\r\n\tif (defaultProvider && defaultModelId) {\r\n\t\tconst found = modelRegistry.find(defaultProvider, defaultModelId);\r\n\t\tif (found) {\r\n\t\t\tmodel = found;\r\n\t\t\tif (defaultThinkingLevel) {\r\n\t\t\t\tthinkingLevel = defaultThinkingLevel;\r\n\t\t\t}\r\n\t\t\treturn { model, thinkingLevel, fallbackMessage: undefined };\r\n\t\t}\r\n\t}\r\n\r\n\t// 4. Try first available model with valid API key\r\n\tconst availableModels = await modelRegistry.getAvailable();\r\n\r\n\tif (availableModels.length > 0) {\r\n\t\t// Try to find a default model from known providers\r\n\t\tfor (const provider of Object.keys(defaultModelPerProvider) as KnownProvider[]) {\r\n\t\t\tconst defaultId = defaultModelPerProvider[provider];\r\n\t\t\tconst match = availableModels.find((m) => m.provider === provider && m.id === defaultId);\r\n\t\t\tif (match) {\r\n\t\t\t\treturn { model: match, thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// If no default found, use first available\r\n\t\treturn { model: availableModels[0], thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };\r\n\t}\r\n\r\n\t// 5. No model found\r\n\treturn { model: undefined, thinkingLevel: DEFAULT_THINKING_LEVEL, fallbackMessage: undefined };\r\n}\r\n\r\n/**\r\n * Restore model from session, with fallback to available models\r\n */\r\nexport async function restoreModelFromSession(\r\n\tsavedProvider: string,\r\n\tsavedModelId: string,\r\n\tcurrentModel: Model<Api> | undefined,\r\n\tshouldPrintMessages: boolean,\r\n\tmodelRegistry: ModelRegistry,\r\n): Promise<{ model: Model<Api> | undefined; fallbackMessage: string | undefined }> {\r\n\tconst restoredModel = modelRegistry.find(savedProvider, savedModelId);\r\n\r\n\t// Check if restored model exists and has a valid API key\r\n\tconst hasApiKey = restoredModel ? !!(await modelRegistry.getApiKey(restoredModel)) : false;\r\n\r\n\tif (restoredModel && hasApiKey) {\r\n\t\tif (shouldPrintMessages) {\r\n\t\t\tconsole.log(chalk.dim(`Restored model: ${savedProvider}/${savedModelId}`));\r\n\t\t}\r\n\t\treturn { model: restoredModel, fallbackMessage: undefined };\r\n\t}\r\n\r\n\t// Model not found or no API key - fall back\r\n\tconst reason = !restoredModel ? \"model no longer exists\" : \"no API key available\";\r\n\r\n\tif (shouldPrintMessages) {\r\n\t\tconsole.error(chalk.yellow(`Warning: Could not restore model ${savedProvider}/${savedModelId} (${reason}).`));\r\n\t}\r\n\r\n\t// If we already have a model, use it as fallback\r\n\tif (currentModel) {\r\n\t\tif (shouldPrintMessages) {\r\n\t\t\tconsole.log(chalk.dim(`Falling back to: ${currentModel.provider}/${currentModel.id}`));\r\n\t\t}\r\n\t\treturn {\r\n\t\t\tmodel: currentModel,\r\n\t\t\tfallbackMessage: `Could not restore model ${savedProvider}/${savedModelId} (${reason}). Using ${currentModel.provider}/${currentModel.id}.`,\r\n\t\t};\r\n\t}\r\n\r\n\t// Try to find any available model\r\n\tconst availableModels = await modelRegistry.getAvailable();\r\n\r\n\tif (availableModels.length > 0) {\r\n\t\t// Try to find a default model from known providers\r\n\t\tlet fallbackModel: Model<Api> | undefined;\r\n\t\tfor (const provider of Object.keys(defaultModelPerProvider) as KnownProvider[]) {\r\n\t\t\tconst defaultId = defaultModelPerProvider[provider];\r\n\t\t\tconst match = availableModels.find((m) => m.provider === provider && m.id === defaultId);\r\n\t\t\tif (match) {\r\n\t\t\t\tfallbackModel = match;\r\n\t\t\t\tbreak;\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// If no default found, use first available\r\n\t\tif (!fallbackModel) {\r\n\t\t\tfallbackModel = availableModels[0];\r\n\t\t}\r\n\r\n\t\tif (shouldPrintMessages) {\r\n\t\t\tconsole.log(chalk.dim(`Falling back to: ${fallbackModel.provider}/${fallbackModel.id}`));\r\n\t\t}\r\n\r\n\t\treturn {\r\n\t\t\tmodel: fallbackModel,\r\n\t\t\tfallbackMessage: `Could not restore model ${savedProvider}/${savedModelId} (${reason}). Using ${fallbackModel.provider}/${fallbackModel.id}.`,\r\n\t\t};\r\n\t}\r\n\r\n\t// No models available\r\n\treturn { model: undefined, fallbackMessage: undefined };\r\n}\r\n"]}