@henryqw/pi-task-models 0.2.0 → 0.4.0

package/CONTEXT.md

@@ -5,7 +5,7 @@ Pi Task Models stores shared task profiles and task-to-profile assignments for H
 ## Language
 
 **Task Profile**:
-Named shared route set (`fast`, `balanced`, or `frontier`) with a required primary route and optional fallback route.
+Named shared route set (`fast`, `balanced`, `frontier`, or `fav`) with a required primary route and optional fallback route (`fav` has no fallback).
 _Avoid_: package-owned model picker, per-extension model catalog
 
 **Task Route**:

package/README.md

@@ -1,6 +1,6 @@
 # `@henryqw/pi-task-models`
 
-Shared `fast`, `balanced`, and `frontier` model profiles for HenryQW Pi extensions.
+Shared `fast`, `balanced`, `frontier`, and `fav` model profiles for HenryQW Pi extensions.
 
 ## Install
 
@@ -13,6 +13,8 @@ pi install npm:@henryqw/pi-task-models
 | Package | Why |
 | --- | --- |
 | `@henryqw/pi-auto-compact` | Consumer. Compaction defaults to the `fast` profile. |
+| `@henryqw/pi-auto-dag` | Consumer. Implement uses `balanced`; review uses `frontier`. |
+| `@henryqw/pi-herdr-btw` | Consumer. Side-thread launch uses the `fast` profile. |
 | `@henryqw/pi-herdr-rename` | Consumer. Rename uses the `fast` profile. |
 | `@henryqw/pi-subagent` | Consumer. Delegation defaults to `balanced`; caller may override it. |
 | `@henryqw/pi-multi-codex` | Improves. Numbered Codex slots dedupe to one route. |
@@ -25,7 +27,7 @@ pi install npm:@henryqw/pi-task-models
 
 Selecting a profile sets primary model, primary thinking, optional fallback model, then fallback thinking. One completed flow writes the whole profile. Selecting a task changes its assignment.
 
-Menus and resolution use the current session's `ctx.scopedModels`, including pinned thinking. Empty scope uses Pi's full available model registry. Numbered Codex account aliases are deduplicated. Fallback choices exclude the selected primary. Hidden task assignments stay stored when a package is disabled.
+Menus and resolution use the current session's `ctx.scopedModels`, including pinned thinking. Empty scope uses Pi's full available model registry. Numbered Codex account aliases are deduplicated. Fallback choices exclude the selected primary. Hidden task assignments stay stored when a package is disabled. BTW selects the first authenticated viable route before pane launch.
 
 Package also exports config and route-resolution helpers for consumers.
 
@@ -45,12 +47,18 @@ Package also exports config and route-resolution helpers for consumers.
     },
     "frontier": {
       "primary": { "model": "openai-codex/gpt-frontier", "thinkingLevel": "max" }
+    },
+    "fav": {
+      "primary": { "model": "openai-codex/gpt-favorite", "thinkingLevel": "high" }
     }
   },
   "tasks": {
+    "pi-herdr-btw/btw": "fast",
     "pi-herdr-rename/rename": "fast",
     "pi-auto-compact/autoCompact": "fast",
-    "pi-subagent/delegateTask": "balanced"
+    "pi-subagent/delegateTask": "balanced",
+    "pi-auto-dag/implement": "balanced",
+    "pi-auto-dag/review": "frontier"
   }
 }
 ```
@@ -59,6 +67,8 @@ 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.
+
 ## Remove
 
 ```bash

package/dist/index.d.ts

@@ -1,12 +1,15 @@
 import { type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
-export declare const PROFILE_NAMES: readonly ["fast", "balanced", "frontier"];
+export declare const PROFILE_NAMES: readonly ["fast", "balanced", "frontier", "fav"];
 export type ProfileName = (typeof PROFILE_NAMES)[number];
 export declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
 export type ThinkingLevel = (typeof THINKING_LEVELS)[number];
 export declare const DEFAULT_TASK_ASSIGNMENTS: {
+    readonly "pi-herdr-btw/btw": "fast";
     readonly "pi-herdr-rename/rename": "fast";
     readonly "pi-auto-compact/autoCompact": "fast";
     readonly "pi-subagent/delegateTask": "balanced";
+    readonly "pi-auto-dag/implement": "balanced";
+    readonly "pi-auto-dag/review": "frontier";
 };
 export type TaskModelRoute = {
     model: string;
@@ -46,6 +49,7 @@ export declare function supportedThinkingLevels(model: AvailableModel): Thinking
 export declare function availableTaskModels(ctx: ExtensionContext): AvailableModel[];
 export declare function taskThinkingLevels(ctx: ExtensionContext, model: AvailableModel): ThinkingLevel[];
 export declare function resolveTaskModelRoute(ctx: ExtensionContext, route: TaskModelRoute): ResolvedTaskRoute | undefined;
+export declare function resolveConfiguredTaskRoute(ctx: ExtensionContext, task: string, agentDir?: string): 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

@@ -2,12 +2,15 @@ import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { getSupportedThinkingLevels } from "@earendil-works/pi-ai";
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
-export const PROFILE_NAMES = ["fast", "balanced", "frontier"];
+export const PROFILE_NAMES = ["fast", "balanced", "frontier", "fav"];
 export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
 export const DEFAULT_TASK_ASSIGNMENTS = {
+    "pi-herdr-btw/btw": "fast",
     "pi-herdr-rename/rename": "fast",
     "pi-auto-compact/autoCompact": "fast",
     "pi-subagent/delegateTask": "balanced",
+    "pi-auto-dag/implement": "balanced",
+    "pi-auto-dag/review": "frontier",
 };
 const CODEX_ALIAS = /^openai-codex-(?:[2-9]|[1-9]\d+)$/;
 const CONFIG_FILE = "pi-task-models.json";
@@ -80,6 +83,8 @@ function parseConfig(value) {
             if (!isTaskProfile(profile))
                 throw new Error(`${name} profile is invalid.`);
             const profileName = name;
+            if (profileName === "fav" && profile.fallback)
+                throw new Error("fav profile has no fallback.");
             profiles[profileName] = {
                 primary: normalizeRoute(profile.primary),
                 ...(profile.fallback ? { fallback: normalizeRoute(profile.fallback) } : {}),
@@ -111,6 +116,8 @@ export function readTaskModelsConfig(agentDir = getAgentDir()) {
     }
 }
 export function writeTaskModelsConfig(config, agentDir = getAgentDir()) {
+    if (config.profiles.fav?.fallback)
+        throw new Error("fav profile has no fallback.");
     const file = configPath(agentDir);
     mkdirSync(dirname(file), { recursive: true });
     writeFileSync(file, `${JSON.stringify(normalizeConfig(config), null, 2)}\n`);
@@ -190,6 +197,27 @@ export function resolveTaskModelRoute(ctx, route) {
         ? { model, thinkingLevel: route.thinkingLevel }
         : undefined;
 }
+export function resolveConfiguredTaskRoute(ctx, task, agentDir = getAgentDir()) {
+    let config;
+    try {
+        config = readTaskModelsConfig(agentDir);
+    }
+    catch {
+        throw new Error("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.`);
+    const profile = config.profiles[profileName];
+    if (!profile)
+        throw new Error(`Task ${task} profile ${profileName} is not configured. Run /task-models.`);
+    for (const route of orderedProfileRoutes(profile)) {
+        const resolved = resolveTaskModelRoute(ctx, route);
+        if (resolved)
+            return resolved;
+    }
+    throw new Error(`Task ${task} profile ${profileName} has no available route. Run /task-models.`);
+}
 export function orderedProfileRoutes(profile) {
     return profile.fallback ? [profile.primary, profile.fallback] : [profile.primary];
 }
@@ -280,19 +308,24 @@ export function createTaskModelsExtension(pi, options) {
             const primary = await selectRoute(ctx, `Profile ${profile} primary`, models);
             if (!primary)
                 return;
-            const fallbackModels = models.filter((model) => canonicalModelReference(model) !== primary.model);
-            const fallbackModel = await ctx.ui.select(`Profile ${profile} fallback`, [
-                "None",
-                ...fallbackModels.map((model) => modelReference(model)),
-            ]);
-            if (!fallbackModel)
-                return;
-            const fallback = fallbackModel === "None"
-                ? undefined
-                : await selectThinkingLevel(ctx, `Profile ${profile} fallback`, fallbackModels, fallbackModel);
-            if (fallbackModel !== "None" && !fallback)
-                return;
-            config.profiles[profile] = { primary, ...(fallback ? { fallback } : {}) };
+            if (profile === "fav") {
+                config.profiles[profile] = { primary };
+            }
+            else {
+                const fallbackModels = models.filter((model) => canonicalModelReference(model) !== primary.model);
+                const fallbackModel = await ctx.ui.select(`Profile ${profile} fallback`, [
+                    "None",
+                    ...fallbackModels.map((model) => modelReference(model)),
+                ]);
+                if (!fallbackModel)
+                    return;
+                const fallback = fallbackModel === "None"
+                    ? undefined
+                    : await selectThinkingLevel(ctx, `Profile ${profile} fallback`, fallbackModels, fallbackModel);
+                if (fallbackModel !== "None" && !fallback)
+                    return;
+                config.profiles[profile] = { primary, ...(fallback ? { fallback } : {}) };
+            }
             if (!save())
                 return;
             ctx.ui.notify(`${profile} profile saved.`, "info");

package/package.json

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