pi-neo-subagents 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.
- package/CHANGELOG.md +77 -59
- package/README.md +11 -1
- package/package.json +10 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,59 +1,77 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
All notable changes to this project are documented here. The format follows
|
|
4
|
-
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses
|
|
5
|
-
[semantic versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
|
-
|
|
7
|
-
## [0.1.
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
### Added
|
|
12
|
-
|
|
13
|
-
-
|
|
14
|
-
and
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
-
|
|
37
|
-
|
|
38
|
-
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
-
|
|
42
|
-
|
|
43
|
-
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
-
|
|
57
|
-
|
|
58
|
-
-
|
|
59
|
-
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project are documented here. The format follows
|
|
4
|
+
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses
|
|
5
|
+
[semantic versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
|
+
|
|
7
|
+
## [0.1.1] — 2026-10-25
|
|
8
|
+
|
|
9
|
+
Packaging metadata only; no behaviour changes.
|
|
10
|
+
|
|
11
|
+
### Added
|
|
12
|
+
|
|
13
|
+
- `repository`, `homepage`, and `bugs` pointing at the source repository, so the
|
|
14
|
+
npm page links to the code and to the issue tracker.
|
|
15
|
+
|
|
16
|
+
### Changed
|
|
17
|
+
|
|
18
|
+
- Development dependency `vitest` pinned to `^4`. Under `vitest` 5, a fresh
|
|
19
|
+
clone could not install rolldown's optional native binding through
|
|
20
|
+
`npm ci` ([npm/cli#4828]), which broke `npm test` on a clean checkout.
|
|
21
|
+
- `package-lock.json` regenerated at the same resolved versions.
|
|
22
|
+
|
|
23
|
+
[npm/cli#4828]: https://github.com/npm/cli/issues/4828
|
|
24
|
+
|
|
25
|
+
## [0.1.0] — 2026-10-24
|
|
26
|
+
|
|
27
|
+
First public release. Covers the v1 delegation core and the v2 governance work.
|
|
28
|
+
|
|
29
|
+
### Added — delegation core
|
|
30
|
+
|
|
31
|
+
- Named agent definitions as Markdown + frontmatter in `.pi/agents/` (project)
|
|
32
|
+
and `~/.pi/agent/agents/` (user), with project-over-user precedence.
|
|
33
|
+
- `task` tool for the main agent: isolated nested sessions, self-contained task
|
|
34
|
+
text only, final reply returned as the tool result.
|
|
35
|
+
- `/subagents` listing and detail views, and `/subagents run <name> [--to-context] <task>`
|
|
36
|
+
for user-invoked delegation whose result stays out of the model's context by
|
|
37
|
+
default.
|
|
38
|
+
- Definition enforcement: tool whitelists, model overrides, `systemPrompt: replace`.
|
|
39
|
+
- Result contract: 30,000-character truncation with the full result written to a
|
|
40
|
+
temp file, structured details, merged usage, coarse progress updates.
|
|
41
|
+
- Non-interactive output routing: stdout in print mode, stderr in JSON mode,
|
|
42
|
+
notifications in TUI and RPC.
|
|
43
|
+
- `create_subagent` tool and project-first placement, so a session with no
|
|
44
|
+
definitions is never a dead end.
|
|
45
|
+
|
|
46
|
+
### Added — governance and scale (v2)
|
|
47
|
+
|
|
48
|
+
- Execution controls: `maxTurns`, `timeoutMs`, `maxTokens`, and `thinking` in a
|
|
49
|
+
definition or per call; cut-short work is reported as a budget stop, never as
|
|
50
|
+
a failure.
|
|
51
|
+
- Run ledger with `/subagents stats` and `stats reset`.
|
|
52
|
+
- Fan-out dispatch (`tasks`) with a configurable concurrency cap, submission
|
|
53
|
+
order results, per-task status, and cancellation of everything in flight.
|
|
54
|
+
- Chained dispatch (`chain`) with `{previous}` substitution and stop-at-first-
|
|
55
|
+
unfinished-step semantics.
|
|
56
|
+
- Ad-hoc delegation with inline `instructions`, no definition file, accounted as
|
|
57
|
+
`ad-hoc`.
|
|
58
|
+
- Live TUI widget listing in-flight delegations with turn and current tool.
|
|
59
|
+
- Strict definition validation: non-`replace` `systemPrompt`, unknown tools,
|
|
60
|
+
unresolvable models, and invalid budgets are errors.
|
|
61
|
+
- Discovery from nested working directories; listings show source file and
|
|
62
|
+
modification time.
|
|
63
|
+
- Managed definitions: `/subagents new`, `edit`, `rm`.
|
|
64
|
+
- Authorization: project-level agents require first-use consent, plus settings
|
|
65
|
+
`confirmProjectAgents`, `allowModelCreatedDefinitions`,
|
|
66
|
+
`allowUserScopeCreation`, and `maxDepth`.
|
|
67
|
+
- Controlled recursion: opt-in `allowSubagents`, depth-bounded, with depth
|
|
68
|
+
reported in results and the ledger.
|
|
69
|
+
- Hermetic test suite (112 tests) over a single session seam, plus an
|
|
70
|
+
environment-gated live-model smoke suite (`npm run test:live`).
|
|
71
|
+
|
|
72
|
+
### Notes
|
|
73
|
+
|
|
74
|
+
- Delegation is serial per call unless `tasks` is used; nesting requires an
|
|
75
|
+
explicit opt-in.
|
|
76
|
+
- `@earendil-works/pi-ai` and `@earendil-works/pi-coding-agent` are host-provided
|
|
77
|
+
and declared as `peerDependencies` with a `*` range.
|
package/README.md
CHANGED
|
@@ -308,7 +308,7 @@ dialog UI, `"ask"` proceeds (automation never hangs) while `"deny"` refuses.
|
|
|
308
308
|
## Development
|
|
309
309
|
|
|
310
310
|
```bash
|
|
311
|
-
npm
|
|
311
|
+
npm ci # installs from the committed lockfile
|
|
312
312
|
npm test # vitest, hermetic: scripted fake model, no network
|
|
313
313
|
npm run typecheck
|
|
314
314
|
npm run test:live # live-model smoke suite (real provider, real cost)
|
|
@@ -330,3 +330,13 @@ from it and runs only through `npm run test:live`, which enables it with
|
|
|
330
330
|
Tests drive full in-memory agent sessions through the Pi SDK with pi-ai's
|
|
331
331
|
`fauxProvider` as the scripted model; behaviour is asserted only at the
|
|
332
332
|
session boundary (tool results, visible messages, recorded UI output).
|
|
333
|
+
|
|
334
|
+
Repository layout:
|
|
335
|
+
|
|
336
|
+
| Path | Contents |
|
|
337
|
+
|---|---|
|
|
338
|
+
| `index.ts`, `src/` | the extension itself — everything that ships to npm |
|
|
339
|
+
| `test/` | hermetic suite; `test/live/` is the opt-in live suite |
|
|
340
|
+
| `docs/specs/` | behaviour specifications, current and superseded |
|
|
341
|
+
| `docs/history/` | design records: the tickets each version came from, and the real-model test report |
|
|
342
|
+
| `scripts/manual-test/` | RPC driver and fixtures for scripted end-to-end runs against a real `pi` process |
|
package/package.json
CHANGED
|
@@ -1,10 +1,18 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-neo-subagents",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Subagents for Pi: define Markdown agent definitions and delegate tasks to isolated nested agent sessions",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"author": "灰木同学 <hmtx1024@outlook.com>",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/hmtx1024/pi-neo-subagents.git"
|
|
11
|
+
},
|
|
12
|
+
"homepage": "https://github.com/hmtx1024/pi-neo-subagents#readme",
|
|
13
|
+
"bugs": {
|
|
14
|
+
"url": "https://github.com/hmtx1024/pi-neo-subagents/issues"
|
|
15
|
+
},
|
|
8
16
|
"engines": {
|
|
9
17
|
"node": ">=20"
|
|
10
18
|
},
|
|
@@ -35,7 +43,7 @@
|
|
|
35
43
|
"@earendil-works/pi-coding-agent": "^1.4.0",
|
|
36
44
|
"@types/node": "^24.0.0",
|
|
37
45
|
"typescript": "^5.9.0",
|
|
38
|
-
"vitest": "^
|
|
46
|
+
"vitest": "^4.0.0"
|
|
39
47
|
},
|
|
40
48
|
"peerDependencies": {
|
|
41
49
|
"@earendil-works/pi-ai": "*",
|