@henryqw/pi-task-models 0.5.1 → 0.7.0

package/README.md

@@ -67,7 +67,7 @@ Each configured profile needs one primary model and thinking level. Fallback is
 
 Reads are strict. Malformed or unknown values fail visibly and never rewrite the file. Only explicit `/task-models` actions write config.
 
-Consumers can call `resolveConfiguredTaskRoute(ctx, taskId)` to read strict shared config, choose usable primary or fallback route, and fail with `/task-models` guidance when assignment, profile, or route is unavailable.
+Consumers can call `resolveConfiguredTaskRoute(ctx, taskId)` for the first usable route or `resolveConfiguredTaskRoutes(ctx, taskId)` for primary and fallback routes. Both read strict shared config and fail with `/task-models` guidance when assignment, profile, or route is unavailable.
 
 ## Remove
 

package/dist/index.d.ts

@@ -52,8 +52,14 @@ export declare function rememberedThinkingLevel(model: {
     provider: string;
     id: string;
 } | string, agentDir?: string): ThinkingLevel | undefined;
-export declare function resolveTaskModelRoute(ctx: ExtensionContext, route: TaskModelRoute, agentDir?: string): ResolvedTaskRoute | undefined;
-export declare function resolveConfiguredTaskRoute(ctx: ExtensionContext, task: string, agentDir?: string): ResolvedTaskRoute;
+export declare function resolveTaskModelRoute(ctx: ExtensionContext, route: TaskModelRoute, agentDir?: string, thinking?: ThinkingLevel): ResolvedTaskRoute | undefined;
+export declare function resolveConfiguredTaskRoutes(ctx: ExtensionContext, task: string, agentDir?: string, thinking?: ThinkingLevel): ResolvedTaskRoute[];
+export type TaskRouteErrorCode = "config-read" | "task-unassigned" | "profile-missing" | "no-route";
+export type TaskRouteError = Error & {
+    taskRouteCode: TaskRouteErrorCode;
+    profileName?: ProfileName;
+};
+export declare function resolveConfiguredTaskRoute(ctx: ExtensionContext, task: string, agentDir?: string, thinking?: ThinkingLevel): ResolvedTaskRoute;
 export declare function orderedProfileRoutes(profile: TaskModelProfile): TaskModelRoute[];
 export declare function activeTaskPackages(pi: Pick<ExtensionAPI, "getCommands" | "getAllTools">, tasks?: Readonly<Record<string, ProfileName>>): ActiveTaskPackage[];
 export declare function createTaskModelsExtension(pi: ExtensionAPI, options?: {

package/dist/index.js

@@ -206,11 +206,16 @@ export function rememberedThinkingLevel(model, agentDir = getAgentDir()) {
         return undefined;
     }
 }
-export function resolveTaskModelRoute(ctx, route, agentDir = getAgentDir()) {
+export function resolveTaskModelRoute(ctx, route, agentDir = getAgentDir(), thinking) {
     const model = resolveAvailableModel(availableTaskModels(ctx), route.model, ctx.model?.provider);
     if (!model)
         return undefined;
     const levels = taskThinkingLevels(ctx, model);
+    // An explicit requested level wins over remembered and profile levels; a model
+    // that cannot honor it is skipped so later fallback routes get considered.
+    if (thinking !== undefined) {
+        return levels.includes(thinking) ? { model, thinkingLevel: thinking } : undefined;
+    }
     // Remembered per-model thinking (pi-model-thinking) wins over the profile level when supported.
     const remembered = rememberedThinkingLevel(model, agentDir);
     const thinkingLevel = remembered && levels.includes(remembered) ? remembered : route.thinkingLevel;
@@ -218,26 +223,36 @@ export function resolveTaskModelRoute(ctx, route, agentDir = getAgentDir()) {
         return undefined;
     return { model, thinkingLevel };
 }
-export function resolveConfiguredTaskRoute(ctx, task, agentDir = getAgentDir()) {
+export function resolveConfiguredTaskRoutes(ctx, task, agentDir = getAgentDir(), thinking) {
     let config;
     try {
         config = readTaskModelsConfig(agentDir);
     }
     catch {
-        throw new Error("Couldn't read task model config. Run /task-models.");
+        throw taskRouteError("config-read", "Couldn't read task model config. Run /task-models.");
     }
     const profileName = config.tasks[task];
     if (!profileName)
-        throw new Error(`Task ${task} is not assigned to a profile. Run /task-models.`);
+        throw taskRouteError("task-unassigned", `Task ${task} is not assigned to a profile. Run /task-models.`);
     const profile = config.profiles[profileName];
     if (!profile)
-        throw new Error(`Task ${task} profile ${profileName} is not configured. Run /task-models.`);
+        throw taskRouteError("profile-missing", `Task ${task} profile ${profileName} is not configured. Run /task-models.`, profileName);
+    const routes = [];
     for (const route of orderedProfileRoutes(profile)) {
-        const resolved = resolveTaskModelRoute(ctx, route, agentDir);
+        const resolved = resolveTaskModelRoute(ctx, route, agentDir, thinking);
         if (resolved)
-            return resolved;
+            routes.push(resolved);
+    }
+    if (!routes.length) {
+        throw taskRouteError("no-route", `Task ${task} profile ${profileName} has no available route${thinking ? ` supporting thinking ${thinking}` : ""}. Run /task-models.`, profileName);
     }
-    throw new Error(`Task ${task} profile ${profileName} has no available route. Run /task-models.`);
+    return routes;
+}
+function taskRouteError(taskRouteCode, message, profileName) {
+    return Object.assign(new Error(message), { taskRouteCode, ...(profileName ? { profileName } : {}) });
+}
+export function resolveConfiguredTaskRoute(ctx, task, agentDir = getAgentDir(), thinking) {
+    return resolveConfiguredTaskRoutes(ctx, task, agentDir, thinking)[0];
 }
 export function orderedProfileRoutes(profile) {
     return profile.fallback ? [profile.primary, profile.fallback] : [profile.primary];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henryqw/pi-task-models",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "Shared task model profiles and routing for HenryQW Pi extensions.",
   "keywords": [
     "pi-package",