@henryqw/pi-task-models 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +17 -16
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -8,13 +8,21 @@ Shared `fast`, `balanced`, and `frontier` model profiles for HenryQW Pi extensio
8
8
  pi install npm:@henryqw/pi-task-models
9
9
  ```
10
10
 
11
- Run `/task-models`. Top menu shows all profiles plus configured task assignments whose `@henryqw` package is active in Pi's effective command/tool registry. Selecting a profile chooses primary model, primary thinking, fallback model or `None`, then fallback thinking when needed; one completed flow writes whole profile once. Selecting a task changes its profile assignment.
11
+ ## Use
12
12
 
13
- Menus and runtime resolution use current session's `ctx.scopedModels`, including pinned thinking levels. Empty scope falls back to Pi's full available model registry. Numbered Codex account aliases are deduplicated, and fallback choices exclude selected primary model. Hidden task assignments remain stored when package is disabled or removed.
13
+ | Surface | Purpose |
14
+ | --- | --- |
15
+ | `/task-models` | Edit a profile or assign a task to a profile. |
16
+
17
+ 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.
18
+
19
+ 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.
20
+
21
+ Used by `pi-herdr-rename` (default `fast`), `pi-auto-compact` (default `balanced`), and `pi-subagent` (caller picks the class). `pi-herdr-subagents` stays independent. Package also exports config and route-resolution helpers for those consumers.
14
22
 
15
23
  ## Config
16
24
 
17
- Config lives at `getAgentDir()/config/pi-task-models.json`, normally `~/.pi/agent/config/pi-task-models.json`:
25
+ `~/.pi/agent/config/pi-task-models.json`
18
26
 
19
27
  ```json
20
28
  {
@@ -37,22 +45,15 @@ Config lives at `getAgentDir()/config/pi-task-models.json`, normally `~/.pi/agen
37
45
  }
38
46
  ```
39
47
 
40
- Each configured profile requires one primary model and thinking level. Fallback is optional. Model references use canonical `provider/model`; numbered `openai-codex-N` account routes are stored as `openai-codex/model` and resolve onto active matching account when available.
41
-
42
- Config reads are strict. Malformed or unknown values fail visibly and never rewrite file. Only explicit `/task-models` actions write config.
48
+ 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`.
43
49
 
44
- ## Consumers
50
+ Reads are strict. Malformed or unknown values fail visibly and never rewrite the file. Only explicit `/task-models` actions write config.
45
51
 
46
- - `pi-herdr-rename`: task assignment defaults to `fast`; retries configured fallback after primary route failure.
47
- - `pi-auto-compact`: task assignment defaults to `balanced`; retries fallback, then uses current session model so compaction still runs.
48
- - `pi-subagent`: caller chooses `fast`, `balanced`, or `frontier`; fallback is selected only before child starts. Started child is never retried because tools may already have side effects.
49
- - `pi-herdr-subagents`: intentionally independent.
52
+ ## Remove
50
53
 
51
- Primary and fallback routes outside current model scope, with unavailable models, or with unsupported or scope-pinned-different thinking levels are skipped. Consumers define final failure behavior above.
52
-
53
- ## Library API
54
-
55
- Package exports config, canonical model reference, model deduplication, supported-thinking, route resolution, and active-task discovery helpers. Pi model registry and extension `sourceInfo` remain runtime authority.
54
+ ```bash
55
+ pi remove npm:@henryqw/pi-task-models
56
+ ```
56
57
 
57
58
  ## Development
58
59
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@henryqw/pi-task-models",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Shared task model profiles and routing for HenryQW Pi extensions.",
5
5
  "keywords": [
6
6
  "pi-package",