@henryqw/pi-task-models 1.0.0 → 1.0.2

package/README.md

@@ -38,7 +38,7 @@ Package also exports config and route-resolution helpers for consumers.
 
 ## Config
 
-`~/.pi/agent/config/pi-task-models.json`
+Single shared JSON file at the exact package-owned path `~/.pi/agent/config/pi-task-models.json`. Consumers read it but never write it; only explicit `/task-models` actions save it.
 
 ```json
 {
@@ -68,24 +68,19 @@ Package also exports config and route-resolution helpers for consumers.
 }
 ```
 
-Each configured profile needs one primary model and thinking level. Fallback is optional. Model references use canonical `provider/model`; numbered `openai-codex-N` routes store as `openai-codex/model`.
+| Field | Required | Possible values | Default |
+| --- | --- | --- | --- |
+| `profiles` | No | Object keyed by `fast`, `balanced`, `frontier`, `fav`; unknown profile names are rejected | `{}` (no profiles configured) |
+| `profiles.<profile>.primary.model` | Yes within a configured profile's `primary` | Canonical `provider/model` reference without whitespace or NUL; available models come from Pi's model registry (or session-scoped models) at resolution time, not from this file | — |
+| `profiles.<profile>.primary.thinkingLevel` | Yes within a configured profile's `primary` | `off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`; the model must support the level when the route resolves | — |
+| `profiles.<profile>.fallback` | No | When present, requires both `model` and `thinkingLevel` with the corresponding `primary.*` values; not allowed for `fav` | Omitted |
+| `tasks` | No | Object mapping task IDs (`<package>/<task>`) to a profile name | Built-in defaults listed in the example above |
+| `tasks.<taskId>` | Value required if the key is present | `fast`, `balanced`, `frontier`, `fav` | The built-in default for that task, if any |
 
-Profile thinking is authoritative for task routes.
-
-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)` 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.
+Model references use canonical `provider/model`; numbered Codex account aliases (`openai-codex-N`) resolve through Pi's registry and store canonically as `openai-codex/<model>`.
 
-## Remove
+Reads are strict. A missing file yields no profiles and the built-in default task assignments; malformed JSON, unknown keys, invalid task IDs, unknown profiles, or invalid profile or route values fail visibly with `/task-models` guidance and never rewrite the file.
 
-```bash
-pi remove npm:@henryqw/pi-task-models
-```
-
-## Development
+Profile thinking is authoritative for task routes.
 
-```bash
-npm test --workspace @henryqw/pi-task-models
-npm run typecheck --workspace @henryqw/pi-task-models
-npm run pack:check --workspace @henryqw/pi-task-models
-```
+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.

package/dist/index.d.ts

@@ -45,7 +45,6 @@ export declare function modelReference(model: {
 }): string;
 export declare function dedupeAvailableModels(models: readonly AvailableModel[], preferredProvider?: string): AvailableModel[];
 export declare function resolveAvailableModel(models: readonly AvailableModel[], reference: string, preferredProvider?: string): AvailableModel | undefined;
-export declare function supportedThinkingLevels(model: AvailableModel): ThinkingLevel[];
 export declare function availableTaskModels(ctx: ExtensionContext): AvailableModel[];
 export declare function taskThinkingLevels(ctx: ExtensionContext, model: AvailableModel): ThinkingLevel[];
 export declare function resolveTaskModelRoute(ctx: ExtensionContext, route: TaskModelRoute, agentDir?: string, thinking?: ThinkingLevel): ResolvedTaskRoute | undefined;

package/dist/index.js

@@ -14,7 +14,6 @@ export const DEFAULT_TASK_ASSIGNMENTS = {
 };
 const CODEX_ALIAS = /^openai-codex-(?:[2-9]|[1-9]\d+)$/;
 const CONFIG_FILE = "pi-task-models.json";
-const defaultTaskAssignments = () => ({ ...DEFAULT_TASK_ASSIGNMENTS });
 export const configPath = (agentDir = getAgentDir()) => join(agentDir, "config", CONFIG_FILE);
 function isCodexProvider(provider) {
     return provider === "openai-codex" || Boolean(provider && CODEX_ALIAS.test(provider));
@@ -72,7 +71,7 @@ function parseConfig(value) {
     if (!hasOnlyKeys(record, ["profiles", "tasks"]))
         throw new Error("Config contains unknown settings.");
     const profiles = {};
-    const tasks = defaultTaskAssignments();
+    const tasks = { ...DEFAULT_TASK_ASSIGNMENTS };
     if (record.profiles !== undefined) {
         if (!record.profiles || typeof record.profiles !== "object" || Array.isArray(record.profiles)) {
             throw new Error("profiles must be an object.");
@@ -110,7 +109,7 @@ export function readTaskModelsConfig(agentDir = getAgentDir()) {
     }
     catch (error) {
         if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
-            return { profiles: {}, tasks: defaultTaskAssignments() };
+            return { profiles: {}, tasks: { ...DEFAULT_TASK_ASSIGNMENTS } };
         }
         throw error;
     }
@@ -176,16 +175,13 @@ export function resolveAvailableModel(models, reference, preferredProvider) {
         ?? models.find((model) => CODEX_ALIAS.test(model.provider) && model.id === id)
         ?? models.find((model) => model.provider === "openai-codex" && model.id === id);
 }
-export function supportedThinkingLevels(model) {
-    return getSupportedThinkingLevels(model);
-}
 export function availableTaskModels(ctx) {
     const scopedModels = ctx.scopedModels ?? [];
     return dedupeAvailableModels((scopedModels.length ? scopedModels.map(({ model }) => model) : ctx.modelRegistry.getAvailable())
         .filter((model) => model.input.includes("text")), ctx.model?.provider);
 }
 export function taskThinkingLevels(ctx, model) {
-    const supported = supportedThinkingLevels(model);
+    const supported = getSupportedThinkingLevels(model);
     const pinned = (ctx.scopedModels ?? []).find(({ model: scoped }) => scoped.provider === model.provider && scoped.id === model.id)?.thinkingLevel;
     if (!pinned)
         return supported;

package/extensions/task-models.ts

@@ -1,4 +1 @@
-export {
-	createTaskModelsExtension as default,
-	createTaskModelsExtension as registerTaskModelsExtension,
-} from "@henryqw/pi-task-models";
+export { createTaskModelsExtension as default } from "@henryqw/pi-task-models";

package/package.json

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