@oh-my-pi/pi-coding-agent 15.10.10 → 15.10.12

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

@@ -1,12 +1,23 @@
 /**
- * Model resolution, scoping, and initial selection
+ * Model resolution, scoping, and initial selection.
+ *
+ * Layering:
+ * - `matchModel` is the single matching engine. Order: exact `provider/id`
+ *   reference (with OpenRouter routed/date fallbacks) → exact canonical id →
+ *   exact bare id → provider-scoped fuzzy → substring with alias-vs-dated pick.
+ * - `parseModelPatternWithContext`/`parseModelPattern` layer the selector
+ *   grammar on top: trailing `:level` thinking suffixes (`splitThinkingSuffix`)
+ *   and `@upstream` provider routing (`splitUpstreamRouting`).
+ * - Everything else (`resolveModelFromString`, `resolveModelOverride*`,
+ *   `resolveRoleSelection`, `resolveModelScope`, `resolveCliModel`,
+ *   `findSmolModel`/`findSlowModel`) adapts inputs — roles, settings patterns,
+ *   CLI flags, scope globs — onto that pipeline.
  */
 import { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
-import { type Api, type Effort, type KnownProvider, type Model } from "@oh-my-pi/pi-ai";
-import { type ModelRegistry, type ModelRole } from "./model-registry";
+import type { Api, Effort, Model } from "@oh-my-pi/pi-ai";
+import { type ModelRegistry } from "./model-registry";
+import { type ModelRole } from "./model-roles";
 import type { Settings } from "./settings";
-/** Default model IDs for each known provider */
-export declare const defaultModelPerProvider: Record<KnownProvider, string>;
 export interface ScopedModel {
     model: Model<Api>;
     thinkingLevel?: ThinkingLevel;
@@ -41,11 +52,6 @@ type CliModelRegistry = Pick<ModelRegistry, "getAll"> & Partial<CanonicalModelRe
 type InitialModelRegistry = Pick<ModelRegistry, "getAvailable" | "find">;
 type RestorableModelRegistry = Pick<ModelRegistry, "getAvailable" | "find" | "getApiKey">;
 export declare function getModelMatchPreferences(settings?: Partial<Pick<Settings, "get" | "getStorage">>): ModelMatchPreferences;
-/**
- * Find an exact explicit provider/model match.
- * Bare model ids are handled separately so canonical ids can coalesce variants.
- */
-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 */
@@ -168,6 +174,24 @@ export declare function resolveModelScope(patterns: string[], modelRegistry: Pic
  * rather than falling back to the global default (see issue #1022).
  */
 export declare function resolveAllowedModels(modelRegistry: Pick<ModelRegistry, "getAvailable" | "getCanonicalVariants">, settings: Settings | undefined, preferences?: ModelMatchPreferences): Promise<Model<Api>[]>;
+/**
+ * Synchronous subset of {@link resolveAllowedModels} for contexts where async is unavailable
+ * (e.g. `getAvailableModels()` which is called from the ACP model-list advertisement, RPC
+ * `get_available_models`, and the `/model` slash command). Uses the same effective
+ * `enabledModels` scope semantics as startup resolution:
+ *
+ * - Glob selectors match `provider/modelId` and bare model id
+ * - Exact canonical ids expand to all available concrete variants
+ * - Exact `provider/modelId`, bare ids, provider-scoped fuzzy, and substring selectors
+ *   resolve through the shared model-pattern matcher
+ * - Optional `:thinkingLevel` suffixes are stripped only when valid
+ *
+ * When no pattern resolves to any model (misconfiguration / typo) an empty list is returned,
+ * consistent with the empty-list contract of {@link resolveAllowedModels}. Callers that render
+ * a UI picker should treat an empty list as "hide the picker entry", matching how the SDK
+ * surfaces the same misconfiguration during session initialization.
+ */
+export declare function filterAvailableModelsByEnabledPatterns(available: Model<Api>[], patterns: readonly string[], registry: Pick<ModelRegistry, "getCanonicalVariants">): Model<Api>[];
 export interface ResolveCliModelResult {
     model: Model<Api> | undefined;
     selector?: string;

package/dist/types/config/model-roles.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Built-in model roles and role metadata helpers.
+ */
+import { type ThemeColor } from "../modes/theme/theme";
+import type { Settings } from "./settings";
+export type ModelRole = "default" | "smol" | "slow" | "vision" | "plan" | "designer" | "commit" | "task";
+export interface ModelRoleInfo {
+    tag?: string;
+    name: string;
+    color?: ThemeColor;
+}
+export declare const MODEL_ROLES: Record<ModelRole, ModelRoleInfo>;
+export declare const MODEL_ROLE_IDS: ModelRole[];
+/** Alias for ModelRoleInfo - used for both built-in and custom roles */
+export type RoleInfo = ModelRoleInfo;
+/**
+ * Return the canonical set of known roles for selector/carousel UI.
+ *
+ * Built-ins always come first. Configured cycle order, model assignments, and
+ * tag metadata can introduce additional custom roles without requiring duplicate
+ * entries across settings.
+ */
+export declare function getKnownRoleIds(settings: Settings): string[];
+/**
+ * Get role info for a role name (built-in or custom).
+ * Configured metadata overrides built-in defaults when present.
+ */
+export declare function getRoleInfo(role: string, settings: Settings): RoleInfo;