@bastani/atomic 0.8.31-alpha.4 → 0.9.0-alpha.1

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

@@ -0,0 +1,116 @@
+import chalk from "chalk";
+import { DEFAULT_THINKING_LEVEL } from "./defaults.js";
+import { findPreferredAvailableModel } from "./model-resolver-defaults.js";
+import { buildFallbackModel } from "./model-resolver-patterns.js";
+import { resolveCliModel } from "./model-resolver-cli.js";
+async function buildConfiguredProviderFallbackModel(provider, modelId, modelRegistry) {
+    return buildFallbackModel(provider, modelId, await modelRegistry.getAvailable());
+}
+export async function resolveSavedModelReference(provider, modelId, modelRegistry) {
+    const found = modelRegistry.find(provider, modelId);
+    if (found)
+        return found;
+    return buildConfiguredProviderFallbackModel(provider, modelId, modelRegistry);
+}
+/**
+ * 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;
+    if (cliProvider && cliModel) {
+        const resolved = resolveCliModel({
+            cliProvider,
+            cliModel,
+            modelRegistry,
+        });
+        if (resolved.error) {
+            console.error(chalk.red(resolved.error));
+            process.exit(1);
+        }
+        if (resolved.model) {
+            return {
+                model: resolved.model,
+                thinkingLevel: DEFAULT_THINKING_LEVEL,
+                fallbackMessage: undefined,
+            };
+        }
+    }
+    if (scopedModels.length > 0 && !isContinuing) {
+        return {
+            model: scopedModels[0].model,
+            thinkingLevel: scopedModels[0].thinkingLevel ?? defaultThinkingLevel ?? DEFAULT_THINKING_LEVEL,
+            fallbackMessage: undefined,
+        };
+    }
+    if (defaultProvider && defaultModelId) {
+        const found = await resolveSavedModelReference(defaultProvider, defaultModelId, modelRegistry);
+        if (found) {
+            model = found;
+            if (defaultThinkingLevel) {
+                thinkingLevel = defaultThinkingLevel;
+            }
+            return { model, thinkingLevel, fallbackMessage: undefined };
+        }
+    }
+    const availableModels = await modelRegistry.getAvailable();
+    if (availableModels.length > 0) {
+        return {
+            model: findPreferredAvailableModel(availableModels),
+            thinkingLevel: DEFAULT_THINKING_LEVEL,
+            fallbackMessage: undefined,
+        };
+    }
+    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 exactRestoredModel = modelRegistry.find(savedProvider, savedModelId);
+    const restoredModel = exactRestoredModel && modelRegistry.hasConfiguredAuth(exactRestoredModel)
+        ? exactRestoredModel
+        : await buildConfiguredProviderFallbackModel(savedProvider, savedModelId, modelRegistry);
+    if (restoredModel) {
+        if (shouldPrintMessages) {
+            console.log(chalk.dim(`Restored model: ${savedProvider}/${savedModelId}`));
+        }
+        return { model: restoredModel, fallbackMessage: undefined };
+    }
+    const reason = !exactRestoredModel ? "model no longer exists" : "no auth configured";
+    if (shouldPrintMessages) {
+        console.error(chalk.yellow(`Warning: Could not restore model ${savedProvider}/${savedModelId} (${reason}).`));
+    }
+    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}.`,
+        };
+    }
+    const availableModels = await modelRegistry.getAvailable();
+    const fallbackModel = findPreferredAvailableModel(availableModels);
+    if (fallbackModel) {
+        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}.`,
+        };
+    }
+    return { model: undefined, fallbackMessage: undefined };
+}
+//# sourceMappingURL=model-resolver-initial.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver-initial.js","sourceRoot":"","sources":["../../src/core/model-resolver-initial.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport chalk from \"chalk\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type { ModelRegistry } from \"./model-registry.ts\";\nimport { findPreferredAvailableModel } from \"./model-resolver-defaults.ts\";\nimport { buildFallbackModel } from \"./model-resolver-patterns.ts\";\nimport { resolveCliModel } from \"./model-resolver-cli.ts\";\nimport type { InitialModelResult, ScopedModel } from \"./model-resolver-types.ts\";\n\nasync function buildConfiguredProviderFallbackModel(\n  provider: string,\n  modelId: string,\n  modelRegistry: ModelRegistry,\n): Promise<Model<Api> | undefined> {\n  return buildFallbackModel(provider, modelId, await modelRegistry.getAvailable());\n}\n\nexport async function resolveSavedModelReference(\n  provider: string,\n  modelId: string,\n  modelRegistry: ModelRegistry,\n): Promise<Model<Api> | undefined> {\n  const found = modelRegistry.find(provider, modelId);\n  if (found) return found;\n  return buildConfiguredProviderFallbackModel(provider, modelId, modelRegistry);\n}\n\n/**\n * Find the initial model to use based on priority:\n * 1. CLI args (provider + model)\n * 2. First model from scoped models (if not continuing/resuming)\n * 3. Restored from session (if continuing/resuming)\n * 4. Saved default from settings\n * 5. First available model with valid API key\n */\nexport async function findInitialModel(options: {\n  cliProvider?: string;\n  cliModel?: string;\n  scopedModels: ScopedModel[];\n  isContinuing: boolean;\n  defaultProvider?: string;\n  defaultModelId?: string;\n  defaultThinkingLevel?: ThinkingLevel;\n  modelRegistry: ModelRegistry;\n}): Promise<InitialModelResult> {\n  const {\n    cliProvider,\n    cliModel,\n    scopedModels,\n    isContinuing,\n    defaultProvider,\n    defaultModelId,\n    defaultThinkingLevel,\n    modelRegistry,\n  } = options;\n\n  let model: Model<Api> | undefined;\n  let thinkingLevel: ThinkingLevel = DEFAULT_THINKING_LEVEL;\n\n  if (cliProvider && cliModel) {\n    const resolved = resolveCliModel({\n      cliProvider,\n      cliModel,\n      modelRegistry,\n    });\n    if (resolved.error) {\n      console.error(chalk.red(resolved.error));\n      process.exit(1);\n    }\n    if (resolved.model) {\n      return {\n        model: resolved.model,\n        thinkingLevel: DEFAULT_THINKING_LEVEL,\n        fallbackMessage: undefined,\n      };\n    }\n  }\n\n  if (scopedModels.length > 0 && !isContinuing) {\n    return {\n      model: scopedModels[0].model,\n      thinkingLevel: scopedModels[0].thinkingLevel ?? defaultThinkingLevel ?? DEFAULT_THINKING_LEVEL,\n      fallbackMessage: undefined,\n    };\n  }\n\n  if (defaultProvider && defaultModelId) {\n    const found = await resolveSavedModelReference(defaultProvider, defaultModelId, modelRegistry);\n    if (found) {\n      model = found;\n      if (defaultThinkingLevel) {\n        thinkingLevel = defaultThinkingLevel;\n      }\n      return { model, thinkingLevel, fallbackMessage: undefined };\n    }\n  }\n\n  const availableModels = await modelRegistry.getAvailable();\n  if (availableModels.length > 0) {\n    return {\n      model: findPreferredAvailableModel(availableModels),\n      thinkingLevel: DEFAULT_THINKING_LEVEL,\n      fallbackMessage: undefined,\n    };\n  }\n\n  return {\n    model: undefined,\n    thinkingLevel: DEFAULT_THINKING_LEVEL,\n    fallbackMessage: undefined,\n  };\n}\n\n/**\n * Restore model from session, with fallback to available models\n */\nexport async function restoreModelFromSession(\n  savedProvider: string,\n  savedModelId: string,\n  currentModel: Model<Api> | undefined,\n  shouldPrintMessages: boolean,\n  modelRegistry: ModelRegistry,\n): Promise<{\n  model: Model<Api> | undefined;\n  fallbackMessage: string | undefined;\n}> {\n  const exactRestoredModel = modelRegistry.find(savedProvider, savedModelId);\n  const restoredModel = exactRestoredModel && modelRegistry.hasConfiguredAuth(exactRestoredModel)\n    ? exactRestoredModel\n    : await buildConfiguredProviderFallbackModel(savedProvider, savedModelId, modelRegistry);\n\n  if (restoredModel) {\n    if (shouldPrintMessages) {\n      console.log(chalk.dim(`Restored model: ${savedProvider}/${savedModelId}`));\n    }\n    return { model: restoredModel, fallbackMessage: undefined };\n  }\n\n  const reason = !exactRestoredModel ? \"model no longer exists\" : \"no auth configured\";\n\n  if (shouldPrintMessages) {\n    console.error(chalk.yellow(`Warning: Could not restore model ${savedProvider}/${savedModelId} (${reason}).`));\n  }\n\n  if (currentModel) {\n    if (shouldPrintMessages) {\n      console.log(chalk.dim(`Falling back to: ${currentModel.provider}/${currentModel.id}`));\n    }\n    return {\n      model: currentModel,\n      fallbackMessage: `Could not restore model ${savedProvider}/${savedModelId} (${reason}). Using ${currentModel.provider}/${currentModel.id}.`,\n    };\n  }\n\n  const availableModels = await modelRegistry.getAvailable();\n  const fallbackModel = findPreferredAvailableModel(availableModels);\n  if (fallbackModel) {\n    if (shouldPrintMessages) {\n      console.log(chalk.dim(`Falling back to: ${fallbackModel.provider}/${fallbackModel.id}`));\n    }\n\n    return {\n      model: fallbackModel,\n      fallbackMessage: `Could not restore model ${savedProvider}/${savedModelId} (${reason}). Using ${fallbackModel.provider}/${fallbackModel.id}.`,\n    };\n  }\n\n  return { model: undefined, fallbackMessage: undefined };\n}\n"]}

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

@@ -0,0 +1,26 @@
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { ParsedModelResult } from "./model-resolver-types.ts";
+/**
+ * Find an exact model reference match.
+ * Supports either a bare model id or a canonical provider/modelId reference.
+ * When matching by bare id, ambiguous matches across providers are rejected.
+ */
+export declare function findExactModelReferenceMatch(modelReference: string, availableModels: Model<Api>[]): Model<Api> | undefined;
+export declare function buildFallbackModel(provider: string, modelId: string, availableModels: Model<Api>[]): Model<Api> | 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;
+//# sourceMappingURL=model-resolver-patterns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver-patterns.d.ts","sourceRoot":"","sources":["../../src/core/model-resolver-patterns.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAanE;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,GAC5B,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAsCxB;AAkCD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,GAC5B,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAkBxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAC7B,OAAO,CAAC,EAAE;IAAE,iCAAiC,CAAC,EAAE,OAAO,CAAA;CAAE,GACxD,iBAAiB,CAwCnB","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { isValidThinkingLevel } from \"../cli/args.ts\";\nimport { defaultModelPerProvider } from \"./model-resolver-defaults.ts\";\nimport type { ParsedModelResult } from \"./model-resolver-types.ts\";\n\n/**\n * Helper to check if a model ID looks like an alias (no date suffix)\n * Dates are typically in format: -20241022 or -20250929\n */\nfunction isAlias(id: string): boolean {\n  if (id.endsWith(\"-latest\")) return true;\n\n  const datePattern = /-\\d{8}$/;\n  return !datePattern.test(id);\n}\n\n/**\n * Find an exact model reference match.\n * Supports either a bare model id or a canonical provider/modelId reference.\n * When matching by bare id, ambiguous matches across providers are rejected.\n */\nexport function findExactModelReferenceMatch(\n  modelReference: string,\n  availableModels: Model<Api>[],\n): Model<Api> | undefined {\n  const trimmedReference = modelReference.trim();\n  if (!trimmedReference) {\n    return undefined;\n  }\n\n  const normalizedReference = trimmedReference.toLowerCase();\n  const canonicalMatches = availableModels.filter(\n    (model) => `${model.provider}/${model.id}`.toLowerCase() === normalizedReference,\n  );\n  if (canonicalMatches.length === 1) {\n    return canonicalMatches[0];\n  }\n  if (canonicalMatches.length > 1) {\n    return undefined;\n  }\n\n  const slashIndex = trimmedReference.indexOf(\"/\");\n  if (slashIndex !== -1) {\n    const provider = trimmedReference.substring(0, slashIndex).trim();\n    const modelId = trimmedReference.substring(slashIndex + 1).trim();\n    if (provider && modelId) {\n      const providerMatches = availableModels.filter(\n        (model) =>\n          model.provider.toLowerCase() === provider.toLowerCase() &&\n          model.id.toLowerCase() === modelId.toLowerCase(),\n      );\n      if (providerMatches.length === 1) {\n        return providerMatches[0];\n      }\n      if (providerMatches.length > 1) {\n        return undefined;\n      }\n    }\n  }\n\n  const idMatches = availableModels.filter((model) => model.id.toLowerCase() === normalizedReference);\n  return idMatches.length === 1 ? idMatches[0] : undefined;\n}\n\n/**\n * Try to match a pattern to a model from the available models list.\n * Returns the matched model or undefined if no match found.\n */\nfunction tryMatchModel(modelPattern: string, availableModels: Model<Api>[]): Model<Api> | undefined {\n  const exactMatch = findExactModelReferenceMatch(modelPattern, availableModels);\n  if (exactMatch) {\n    return exactMatch;\n  }\n\n  const matches = availableModels.filter(\n    (m) =>\n      m.id.toLowerCase().includes(modelPattern.toLowerCase()) ||\n      m.name?.toLowerCase().includes(modelPattern.toLowerCase()),\n  );\n\n  if (matches.length === 0) {\n    return undefined;\n  }\n\n  const aliases = matches.filter((m) => isAlias(m.id));\n  const datedVersions = matches.filter((m) => !isAlias(m.id));\n\n  if (aliases.length > 0) {\n    aliases.sort((a, b) => b.id.localeCompare(a.id));\n    return aliases[0];\n  }\n\n  datedVersions.sort((a, b) => b.id.localeCompare(a.id));\n  return datedVersions[0];\n}\n\nexport function buildFallbackModel(\n  provider: string,\n  modelId: string,\n  availableModels: Model<Api>[],\n): Model<Api> | undefined {\n  const providerModels = availableModels.filter((m) => m.provider === provider);\n  if (providerModels.length === 0) return undefined;\n\n  const defaultId = defaultModelPerProvider[provider];\n  const baseModel = defaultId\n    ? (providerModels.find((m) => m.id === defaultId) ?? providerModels[0])\n    : providerModels[0];\n  const fallbackContextWindow = baseModel.contextWindow;\n\n  return {\n    ...baseModel,\n    id: modelId,\n    name: modelId,\n    contextWindow: fallbackContextWindow,\n    defaultContextWindow: fallbackContextWindow,\n    contextWindowOptions: undefined,\n  };\n}\n\n/**\n * Parse a pattern to extract model and thinking level.\n * Handles models with colons in their IDs (e.g., OpenRouter's :exacto suffix).\n *\n * Algorithm:\n * 1. Try to match full pattern as a model\n * 2. If found, return it with \"off\" thinking level\n * 3. If not found and has colons, split on last colon:\n *    - If suffix is valid thinking level, use it and recurse on prefix\n *    - If suffix is invalid, warn and recurse on prefix with \"off\"\n *\n * @internal Exported for testing\n */\nexport function parseModelPattern(\n  pattern: string,\n  availableModels: Model<Api>[],\n  options?: { allowInvalidThinkingLevelFallback?: boolean },\n): ParsedModelResult {\n  const exactMatch = tryMatchModel(pattern, availableModels);\n  if (exactMatch) {\n    return { model: exactMatch, thinkingLevel: undefined, warning: undefined };\n  }\n\n  const lastColonIndex = pattern.lastIndexOf(\":\");\n  if (lastColonIndex === -1) {\n    return { model: undefined, thinkingLevel: undefined, warning: undefined };\n  }\n\n  const prefix = pattern.substring(0, lastColonIndex);\n  const suffix = pattern.substring(lastColonIndex + 1);\n\n  if (isValidThinkingLevel(suffix)) {\n    const result = parseModelPattern(prefix, availableModels, options);\n    if (result.model) {\n      return {\n        model: result.model,\n        thinkingLevel: result.warning ? undefined : (suffix as ThinkingLevel),\n        warning: result.warning,\n      };\n    }\n    return result;\n  }\n\n  const allowFallback = options?.allowInvalidThinkingLevelFallback ?? true;\n  if (!allowFallback) {\n    return { model: undefined, thinkingLevel: undefined, warning: undefined };\n  }\n\n  const result = parseModelPattern(prefix, availableModels, options);\n  if (result.model) {\n    return {\n      model: result.model,\n      thinkingLevel: undefined,\n      warning: `Invalid thinking level \"${suffix}\" in pattern \"${pattern}\". Using default instead.`,\n    };\n  }\n  return result;\n}\n"]}

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

@@ -0,0 +1,139 @@
+import { isValidThinkingLevel } from "../cli/args.js";
+import { defaultModelPerProvider } from "./model-resolver-defaults.js";
+/**
+ * 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) {
+    if (id.endsWith("-latest"))
+        return true;
+    const datePattern = /-\d{8}$/;
+    return !datePattern.test(id);
+}
+/**
+ * Find an exact model reference match.
+ * Supports either a bare model id or a canonical provider/modelId reference.
+ * When matching by bare id, ambiguous matches across providers are rejected.
+ */
+export function findExactModelReferenceMatch(modelReference, availableModels) {
+    const trimmedReference = modelReference.trim();
+    if (!trimmedReference) {
+        return undefined;
+    }
+    const normalizedReference = trimmedReference.toLowerCase();
+    const canonicalMatches = availableModels.filter((model) => `${model.provider}/${model.id}`.toLowerCase() === normalizedReference);
+    if (canonicalMatches.length === 1) {
+        return canonicalMatches[0];
+    }
+    if (canonicalMatches.length > 1) {
+        return undefined;
+    }
+    const slashIndex = trimmedReference.indexOf("/");
+    if (slashIndex !== -1) {
+        const provider = trimmedReference.substring(0, slashIndex).trim();
+        const modelId = trimmedReference.substring(slashIndex + 1).trim();
+        if (provider && modelId) {
+            const providerMatches = availableModels.filter((model) => model.provider.toLowerCase() === provider.toLowerCase() &&
+                model.id.toLowerCase() === modelId.toLowerCase());
+            if (providerMatches.length === 1) {
+                return providerMatches[0];
+            }
+            if (providerMatches.length > 1) {
+                return undefined;
+            }
+        }
+    }
+    const idMatches = availableModels.filter((model) => model.id.toLowerCase() === normalizedReference);
+    return idMatches.length === 1 ? idMatches[0] : undefined;
+}
+/**
+ * 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) {
+    const exactMatch = findExactModelReferenceMatch(modelPattern, availableModels);
+    if (exactMatch) {
+        return exactMatch;
+    }
+    const matches = availableModels.filter((m) => m.id.toLowerCase().includes(modelPattern.toLowerCase()) ||
+        m.name?.toLowerCase().includes(modelPattern.toLowerCase()));
+    if (matches.length === 0) {
+        return undefined;
+    }
+    const aliases = matches.filter((m) => isAlias(m.id));
+    const datedVersions = matches.filter((m) => !isAlias(m.id));
+    if (aliases.length > 0) {
+        aliases.sort((a, b) => b.id.localeCompare(a.id));
+        return aliases[0];
+    }
+    datedVersions.sort((a, b) => b.id.localeCompare(a.id));
+    return datedVersions[0];
+}
+export function buildFallbackModel(provider, modelId, availableModels) {
+    const providerModels = availableModels.filter((m) => m.provider === provider);
+    if (providerModels.length === 0)
+        return undefined;
+    const defaultId = defaultModelPerProvider[provider];
+    const baseModel = defaultId
+        ? (providerModels.find((m) => m.id === defaultId) ?? providerModels[0])
+        : providerModels[0];
+    const fallbackContextWindow = baseModel.contextWindow;
+    return {
+        ...baseModel,
+        id: modelId,
+        name: modelId,
+        contextWindow: fallbackContextWindow,
+        defaultContextWindow: fallbackContextWindow,
+        contextWindowOptions: 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 function parseModelPattern(pattern, availableModels, options) {
+    const exactMatch = tryMatchModel(pattern, availableModels);
+    if (exactMatch) {
+        return { model: exactMatch, thinkingLevel: undefined, warning: undefined };
+    }
+    const lastColonIndex = pattern.lastIndexOf(":");
+    if (lastColonIndex === -1) {
+        return { model: undefined, thinkingLevel: undefined, warning: undefined };
+    }
+    const prefix = pattern.substring(0, lastColonIndex);
+    const suffix = pattern.substring(lastColonIndex + 1);
+    if (isValidThinkingLevel(suffix)) {
+        const result = parseModelPattern(prefix, availableModels, options);
+        if (result.model) {
+            return {
+                model: result.model,
+                thinkingLevel: result.warning ? undefined : suffix,
+                warning: result.warning,
+            };
+        }
+        return result;
+    }
+    const allowFallback = options?.allowInvalidThinkingLevelFallback ?? true;
+    if (!allowFallback) {
+        return { model: undefined, thinkingLevel: undefined, warning: undefined };
+    }
+    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;
+}
+//# sourceMappingURL=model-resolver-patterns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver-patterns.js","sourceRoot":"","sources":["../../src/core/model-resolver-patterns.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\nimport { isValidThinkingLevel } from \"../cli/args.ts\";\nimport { defaultModelPerProvider } from \"./model-resolver-defaults.ts\";\nimport type { ParsedModelResult } from \"./model-resolver-types.ts\";\n\n/**\n * Helper to check if a model ID looks like an alias (no date suffix)\n * Dates are typically in format: -20241022 or -20250929\n */\nfunction isAlias(id: string): boolean {\n  if (id.endsWith(\"-latest\")) return true;\n\n  const datePattern = /-\\d{8}$/;\n  return !datePattern.test(id);\n}\n\n/**\n * Find an exact model reference match.\n * Supports either a bare model id or a canonical provider/modelId reference.\n * When matching by bare id, ambiguous matches across providers are rejected.\n */\nexport function findExactModelReferenceMatch(\n  modelReference: string,\n  availableModels: Model<Api>[],\n): Model<Api> | undefined {\n  const trimmedReference = modelReference.trim();\n  if (!trimmedReference) {\n    return undefined;\n  }\n\n  const normalizedReference = trimmedReference.toLowerCase();\n  const canonicalMatches = availableModels.filter(\n    (model) => `${model.provider}/${model.id}`.toLowerCase() === normalizedReference,\n  );\n  if (canonicalMatches.length === 1) {\n    return canonicalMatches[0];\n  }\n  if (canonicalMatches.length > 1) {\n    return undefined;\n  }\n\n  const slashIndex = trimmedReference.indexOf(\"/\");\n  if (slashIndex !== -1) {\n    const provider = trimmedReference.substring(0, slashIndex).trim();\n    const modelId = trimmedReference.substring(slashIndex + 1).trim();\n    if (provider && modelId) {\n      const providerMatches = availableModels.filter(\n        (model) =>\n          model.provider.toLowerCase() === provider.toLowerCase() &&\n          model.id.toLowerCase() === modelId.toLowerCase(),\n      );\n      if (providerMatches.length === 1) {\n        return providerMatches[0];\n      }\n      if (providerMatches.length > 1) {\n        return undefined;\n      }\n    }\n  }\n\n  const idMatches = availableModels.filter((model) => model.id.toLowerCase() === normalizedReference);\n  return idMatches.length === 1 ? idMatches[0] : undefined;\n}\n\n/**\n * Try to match a pattern to a model from the available models list.\n * Returns the matched model or undefined if no match found.\n */\nfunction tryMatchModel(modelPattern: string, availableModels: Model<Api>[]): Model<Api> | undefined {\n  const exactMatch = findExactModelReferenceMatch(modelPattern, availableModels);\n  if (exactMatch) {\n    return exactMatch;\n  }\n\n  const matches = availableModels.filter(\n    (m) =>\n      m.id.toLowerCase().includes(modelPattern.toLowerCase()) ||\n      m.name?.toLowerCase().includes(modelPattern.toLowerCase()),\n  );\n\n  if (matches.length === 0) {\n    return undefined;\n  }\n\n  const aliases = matches.filter((m) => isAlias(m.id));\n  const datedVersions = matches.filter((m) => !isAlias(m.id));\n\n  if (aliases.length > 0) {\n    aliases.sort((a, b) => b.id.localeCompare(a.id));\n    return aliases[0];\n  }\n\n  datedVersions.sort((a, b) => b.id.localeCompare(a.id));\n  return datedVersions[0];\n}\n\nexport function buildFallbackModel(\n  provider: string,\n  modelId: string,\n  availableModels: Model<Api>[],\n): Model<Api> | undefined {\n  const providerModels = availableModels.filter((m) => m.provider === provider);\n  if (providerModels.length === 0) return undefined;\n\n  const defaultId = defaultModelPerProvider[provider];\n  const baseModel = defaultId\n    ? (providerModels.find((m) => m.id === defaultId) ?? providerModels[0])\n    : providerModels[0];\n  const fallbackContextWindow = baseModel.contextWindow;\n\n  return {\n    ...baseModel,\n    id: modelId,\n    name: modelId,\n    contextWindow: fallbackContextWindow,\n    defaultContextWindow: fallbackContextWindow,\n    contextWindowOptions: undefined,\n  };\n}\n\n/**\n * Parse a pattern to extract model and thinking level.\n * Handles models with colons in their IDs (e.g., OpenRouter's :exacto suffix).\n *\n * Algorithm:\n * 1. Try to match full pattern as a model\n * 2. If found, return it with \"off\" thinking level\n * 3. If not found and has colons, split on last colon:\n *    - If suffix is valid thinking level, use it and recurse on prefix\n *    - If suffix is invalid, warn and recurse on prefix with \"off\"\n *\n * @internal Exported for testing\n */\nexport function parseModelPattern(\n  pattern: string,\n  availableModels: Model<Api>[],\n  options?: { allowInvalidThinkingLevelFallback?: boolean },\n): ParsedModelResult {\n  const exactMatch = tryMatchModel(pattern, availableModels);\n  if (exactMatch) {\n    return { model: exactMatch, thinkingLevel: undefined, warning: undefined };\n  }\n\n  const lastColonIndex = pattern.lastIndexOf(\":\");\n  if (lastColonIndex === -1) {\n    return { model: undefined, thinkingLevel: undefined, warning: undefined };\n  }\n\n  const prefix = pattern.substring(0, lastColonIndex);\n  const suffix = pattern.substring(lastColonIndex + 1);\n\n  if (isValidThinkingLevel(suffix)) {\n    const result = parseModelPattern(prefix, availableModels, options);\n    if (result.model) {\n      return {\n        model: result.model,\n        thinkingLevel: result.warning ? undefined : (suffix as ThinkingLevel),\n        warning: result.warning,\n      };\n    }\n    return result;\n  }\n\n  const allowFallback = options?.allowInvalidThinkingLevelFallback ?? true;\n  if (!allowFallback) {\n    return { model: undefined, thinkingLevel: undefined, warning: undefined };\n  }\n\n  const result = parseModelPattern(prefix, availableModels, options);\n  if (result.model) {\n    return {\n      model: result.model,\n      thinkingLevel: undefined,\n      warning: `Invalid thinking level \"${suffix}\" in pattern \"${pattern}\". Using default instead.`,\n    };\n  }\n  return result;\n}\n"]}

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

@@ -0,0 +1,15 @@
+import type { ModelRegistry } from "./model-registry.ts";
+import type { ScopedModel } from "./model-resolver-types.ts";
+/**
+ * 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[]>;
+//# sourceMappingURL=model-resolver-scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver-scope.d.ts","sourceRoot":"","sources":["../../src/core/model-resolver-scope.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAoB7D;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA0ChH","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport { modelsAreEqual } from \"@earendil-works/pi-ai\";\nimport chalk from \"chalk\";\nimport { minimatch } from \"minimatch\";\nimport { isValidThinkingLevel } from \"../cli/args.ts\";\nimport type { ModelRegistry } from \"./model-registry.ts\";\nimport { parseModelPattern } from \"./model-resolver-patterns.ts\";\nimport type { ScopedModel } from \"./model-resolver-types.ts\";\n\nfunction hasGlobCharacters(pattern: string): boolean {\n  return pattern.includes(\"*\") || pattern.includes(\"?\") || pattern.includes(\"[\");\n}\n\nfunction parseGlobThinkingLevel(pattern: string): { globPattern: string; thinkingLevel?: ThinkingLevel } {\n  const colonIdx = pattern.lastIndexOf(\":\");\n  if (colonIdx === -1) {\n    return { globPattern: pattern };\n  }\n\n  const suffix = pattern.substring(colonIdx + 1);\n  if (!isValidThinkingLevel(suffix)) {\n    return { globPattern: pattern };\n  }\n\n  return { globPattern: pattern.substring(0, colonIdx), thinkingLevel: suffix };\n}\n\n/**\n * Resolve model patterns to actual Model objects with optional thinking levels\n * Format: \"pattern:level\" where :level is optional\n * For each pattern, finds all matching models and picks the best version:\n * 1. Prefer alias (e.g., claude-sonnet-4-5) over dated versions (claude-sonnet-4-5-20250929)\n * 2. If no alias, pick the latest dated version\n *\n * Supports models with colons in their IDs (e.g., OpenRouter's model:exacto).\n * The algorithm tries to match the full pattern first, then progressively\n * strips colon-suffixes to find a match.\n */\nexport async function resolveModelScope(patterns: string[], modelRegistry: ModelRegistry): Promise<ScopedModel[]> {\n  const availableModels = await modelRegistry.getAvailable();\n  const scopedModels: ScopedModel[] = [];\n\n  for (const pattern of patterns) {\n    if (hasGlobCharacters(pattern)) {\n      const { globPattern, thinkingLevel } = parseGlobThinkingLevel(pattern);\n      const matchingModels = availableModels.filter((m) => {\n        const fullId = `${m.provider}/${m.id}`;\n        return minimatch(fullId, globPattern, { nocase: true }) || minimatch(m.id, globPattern, { nocase: true });\n      });\n\n      if (matchingModels.length === 0) {\n        console.warn(chalk.yellow(`Warning: No models match pattern \"${pattern}\"`));\n        continue;\n      }\n\n      for (const model of matchingModels) {\n        if (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {\n          scopedModels.push({ model, thinkingLevel });\n        }\n      }\n      continue;\n    }\n\n    const { model, thinkingLevel, warning } = parseModelPattern(pattern, availableModels);\n\n    if (warning) {\n      console.warn(chalk.yellow(`Warning: ${warning}`));\n    }\n\n    if (!model) {\n      console.warn(chalk.yellow(`Warning: No models match pattern \"${pattern}\"`));\n      continue;\n    }\n\n    if (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {\n      scopedModels.push({ model, thinkingLevel });\n    }\n  }\n\n  return scopedModels;\n}\n"]}

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

@@ -0,0 +1,66 @@
+import { modelsAreEqual } from "@earendil-works/pi-ai";
+import chalk from "chalk";
+import { minimatch } from "minimatch";
+import { isValidThinkingLevel } from "../cli/args.js";
+import { parseModelPattern } from "./model-resolver-patterns.js";
+function hasGlobCharacters(pattern) {
+    return pattern.includes("*") || pattern.includes("?") || pattern.includes("[");
+}
+function parseGlobThinkingLevel(pattern) {
+    const colonIdx = pattern.lastIndexOf(":");
+    if (colonIdx === -1) {
+        return { globPattern: pattern };
+    }
+    const suffix = pattern.substring(colonIdx + 1);
+    if (!isValidThinkingLevel(suffix)) {
+        return { globPattern: pattern };
+    }
+    return { globPattern: pattern.substring(0, colonIdx), thinkingLevel: suffix };
+}
+/**
+ * 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) {
+        if (hasGlobCharacters(pattern)) {
+            const { globPattern, thinkingLevel } = parseGlobThinkingLevel(pattern);
+            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;
+        }
+        if (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {
+            scopedModels.push({ model, thinkingLevel });
+        }
+    }
+    return scopedModels;
+}
+//# sourceMappingURL=model-resolver-scope.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver-scope.js","sourceRoot":"","sources":["../../src/core/model-resolver-scope.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport { modelsAreEqual } from \"@earendil-works/pi-ai\";\nimport chalk from \"chalk\";\nimport { minimatch } from \"minimatch\";\nimport { isValidThinkingLevel } from \"../cli/args.ts\";\nimport type { ModelRegistry } from \"./model-registry.ts\";\nimport { parseModelPattern } from \"./model-resolver-patterns.ts\";\nimport type { ScopedModel } from \"./model-resolver-types.ts\";\n\nfunction hasGlobCharacters(pattern: string): boolean {\n  return pattern.includes(\"*\") || pattern.includes(\"?\") || pattern.includes(\"[\");\n}\n\nfunction parseGlobThinkingLevel(pattern: string): { globPattern: string; thinkingLevel?: ThinkingLevel } {\n  const colonIdx = pattern.lastIndexOf(\":\");\n  if (colonIdx === -1) {\n    return { globPattern: pattern };\n  }\n\n  const suffix = pattern.substring(colonIdx + 1);\n  if (!isValidThinkingLevel(suffix)) {\n    return { globPattern: pattern };\n  }\n\n  return { globPattern: pattern.substring(0, colonIdx), thinkingLevel: suffix };\n}\n\n/**\n * Resolve model patterns to actual Model objects with optional thinking levels\n * Format: \"pattern:level\" where :level is optional\n * For each pattern, finds all matching models and picks the best version:\n * 1. Prefer alias (e.g., claude-sonnet-4-5) over dated versions (claude-sonnet-4-5-20250929)\n * 2. If no alias, pick the latest dated version\n *\n * Supports models with colons in their IDs (e.g., OpenRouter's model:exacto).\n * The algorithm tries to match the full pattern first, then progressively\n * strips colon-suffixes to find a match.\n */\nexport async function resolveModelScope(patterns: string[], modelRegistry: ModelRegistry): Promise<ScopedModel[]> {\n  const availableModels = await modelRegistry.getAvailable();\n  const scopedModels: ScopedModel[] = [];\n\n  for (const pattern of patterns) {\n    if (hasGlobCharacters(pattern)) {\n      const { globPattern, thinkingLevel } = parseGlobThinkingLevel(pattern);\n      const matchingModels = availableModels.filter((m) => {\n        const fullId = `${m.provider}/${m.id}`;\n        return minimatch(fullId, globPattern, { nocase: true }) || minimatch(m.id, globPattern, { nocase: true });\n      });\n\n      if (matchingModels.length === 0) {\n        console.warn(chalk.yellow(`Warning: No models match pattern \"${pattern}\"`));\n        continue;\n      }\n\n      for (const model of matchingModels) {\n        if (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {\n          scopedModels.push({ model, thinkingLevel });\n        }\n      }\n      continue;\n    }\n\n    const { model, thinkingLevel, warning } = parseModelPattern(pattern, availableModels);\n\n    if (warning) {\n      console.warn(chalk.yellow(`Warning: ${warning}`));\n    }\n\n    if (!model) {\n      console.warn(chalk.yellow(`Warning: No models match pattern \"${pattern}\"`));\n      continue;\n    }\n\n    if (!scopedModels.find((sm) => modelsAreEqual(sm.model, model))) {\n      scopedModels.push({ model, thinkingLevel });\n    }\n  }\n\n  return scopedModels;\n}\n"]}

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

@@ -0,0 +1,29 @@
+import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
+import type { Api, Model } from "@earendil-works/pi-ai";
+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;
+}
+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;
+}
+export interface InitialModelResult {
+    model: Model<Api> | undefined;
+    thinkingLevel: ThinkingLevel;
+    fallbackMessage: string | undefined;
+}
+//# sourceMappingURL=model-resolver-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver-types.d.ts","sourceRoot":"","sources":["../../src/core/model-resolver-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,kGAAkG;IAClG,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9B,6EAA6E;IAC7E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,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;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9B,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\n\nexport interface ScopedModel {\n  model: Model<Api>;\n  /** Thinking level if explicitly specified in pattern (e.g., \"model:high\"), undefined otherwise */\n  thinkingLevel?: ThinkingLevel;\n}\n\nexport interface ParsedModelResult {\n  model: Model<Api> | undefined;\n  /** Thinking level if explicitly specified in pattern, undefined otherwise */\n  thinkingLevel?: ThinkingLevel;\n  warning: string | undefined;\n}\n\nexport interface ResolveCliModelResult {\n  model: Model<Api> | undefined;\n  thinkingLevel?: ThinkingLevel;\n  warning: string | undefined;\n  /**\n   * Error message suitable for CLI display.\n   * When set, model will be undefined.\n   */\n  error: string | undefined;\n}\n\nexport interface InitialModelResult {\n  model: Model<Api> | undefined;\n  thinkingLevel: ThinkingLevel;\n  fallbackMessage: string | undefined;\n}\n"]}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model-resolver-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver-types.js","sourceRoot":"","sources":["../../src/core/model-resolver-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, Model } from \"@earendil-works/pi-ai\";\n\nexport interface ScopedModel {\n  model: Model<Api>;\n  /** Thinking level if explicitly specified in pattern (e.g., \"model:high\"), undefined otherwise */\n  thinkingLevel?: ThinkingLevel;\n}\n\nexport interface ParsedModelResult {\n  model: Model<Api> | undefined;\n  /** Thinking level if explicitly specified in pattern, undefined otherwise */\n  thinkingLevel?: ThinkingLevel;\n  warning: string | undefined;\n}\n\nexport interface ResolveCliModelResult {\n  model: Model<Api> | undefined;\n  thinkingLevel?: ThinkingLevel;\n  warning: string | undefined;\n  /**\n   * Error message suitable for CLI display.\n   * When set, model will be undefined.\n   */\n  error: string | undefined;\n}\n\nexport interface InitialModelResult {\n  model: Model<Api> | undefined;\n  thinkingLevel: ThinkingLevel;\n  fallbackMessage: string | undefined;\n}\n"]}

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

@@ -1,111 +1,10 @@
 /**
  * Model resolution, scoping, and initial selection
  */
-import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
-import { type Api, type Model } from "@earendil-works/pi-ai";
-import type { ModelRegistry } from "./model-registry.ts";
-/** Default model IDs for each known provider */
-export declare const defaultModelPerProvider: Record<string, string>;
-export interface ScopedModel {
-    model: Model<Api>;
-    /** Thinking level if explicitly specified in pattern (e.g., "model:high"), undefined otherwise */
-    thinkingLevel?: ThinkingLevel;
-}
-/**
- * Find an exact model reference match.
- * Supports either a bare model id or a canonical provider/modelId reference.
- * When matching by bare id, ambiguous matches across providers are rejected.
- */
-export declare function findExactModelReferenceMatch(modelReference: string, availableModels: Model<Api>[]): Model<Api> | undefined;
-export interface ParsedModelResult {
-    model: Model<Api> | undefined;
-    /** Thinking level if explicitly specified in pattern, undefined otherwise */
-    thinkingLevel?: ThinkingLevel;
-    warning: string | undefined;
-}
-export declare function resolveSavedModelReference(provider: string, modelId: string, modelRegistry: ModelRegistry): Promise<Model<Api> | 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;
-}>;
+export { defaultModelPerProvider } from "./model-resolver-defaults.ts";
+export { resolveCliModel } from "./model-resolver-cli.ts";
+export { findInitialModel, resolveSavedModelReference, restoreModelFromSession } from "./model-resolver-initial.ts";
+export { findExactModelReferenceMatch, parseModelPattern } from "./model-resolver-patterns.ts";
+export { resolveModelScope } from "./model-resolver-scope.ts";
+export type { InitialModelResult, ParsedModelResult, ResolveCliModelResult, ScopedModel, } from "./model-resolver-types.ts";
 //# sourceMappingURL=model-resolver.d.ts.map