pi-herdsman 0.41.0 → 0.42.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 +31 -0
- package/SKILL.md +11 -9
- package/dist/index.js +611 -136
- package/dist/index.js.map +3 -3
- package/dist/peer-bridge.js.map +2 -2
- package/docs/concepts/delegation.md +22 -8
- package/docs/development/smoke-testing.md +18 -1
- package/docs/guides/agent-definitions.md +14 -1
- package/docs/guides/customizing-agents.md +5 -3
- package/docs/guides/handoffs.md +10 -5
- package/docs/reference/agent-definition-schema.md +32 -10
- package/docs/reference/agent.md +11 -7
- package/docs/reference/ask-owner.md +7 -4
- package/docs/reference/configuration.md +27 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -18,6 +18,37 @@
|
|
|
18
18
|
Move existing role overrides from `agents/` to `pi-herdsman/roles/` in the
|
|
19
19
|
same scope. Reserved role names in `agents/` are rejected.
|
|
20
20
|
|
|
21
|
+
## [0.42.1](https://github.com/boadij/pi-herdsman/compare/v0.42.0...v0.42.1) (2026-11-08)
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
### Fixes
|
|
25
|
+
|
|
26
|
+
* **agent:** retain ask_owner attachment errors in empty results ([#874](https://github.com/boadij/pi-herdsman/issues/874)) ([97ba8fc](https://github.com/boadij/pi-herdsman/commit/97ba8fc87fc30b3ccf9964e59526d6d3167ae9c3)), closes [#870](https://github.com/boadij/pi-herdsman/issues/870) [#871](https://github.com/boadij/pi-herdsman/issues/871)
|
|
27
|
+
* **agent:** show nested descendants in the root status tree promptly ([#877](https://github.com/boadij/pi-herdsman/issues/877)) ([0f32d7e](https://github.com/boadij/pi-herdsman/commit/0f32d7e6a77d519e089f836159b4d0ccbedcc06c))
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
### Documentation
|
|
31
|
+
|
|
32
|
+
* guide agents to file evidence-grounded issues ([#875](https://github.com/boadij/pi-herdsman/issues/875)) ([2d9a90d](https://github.com/boadij/pi-herdsman/commit/2d9a90d982cb759a6ea0d806a20eb070a7d0a9c4))
|
|
33
|
+
|
|
34
|
+
## [0.42.0](https://github.com/boadij/pi-herdsman/compare/v0.41.0...v0.42.0) (2026-11-07)
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
### Features
|
|
38
|
+
|
|
39
|
+
* **agents:** add a configurable maximum agent nesting depth ([#866](https://github.com/boadij/pi-herdsman/issues/866)) ([787601a](https://github.com/boadij/pi-herdsman/commit/787601a0faf35940f247d5e8c2ce031268491923))
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
### Fixes
|
|
43
|
+
|
|
44
|
+
* **agent:** preserve extension-backed models on continuation ([#864](https://github.com/boadij/pi-herdsman/issues/864)) ([8909d29](https://github.com/boadij/pi-herdsman/commit/8909d29e25aae6da8f8282310be1202864e98b86))
|
|
45
|
+
* **manager:** enforce tool policy across late registration ([#868](https://github.com/boadij/pi-herdsman/issues/868)) ([2e189b2](https://github.com/boadij/pi-herdsman/commit/2e189b2e73844687cf46afcdcbe06ec43a5e6e82)), closes [#832](https://github.com/boadij/pi-herdsman/issues/832)
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
### Other Changes
|
|
49
|
+
|
|
50
|
+
* **deps:** update ghcr.io/jdx/mise docker tag to v2026.11.4 ([#873](https://github.com/boadij/pi-herdsman/issues/873)) ([c1fd32b](https://github.com/boadij/pi-herdsman/commit/c1fd32bc71646d1989222a9d626d1de5453ead7f))
|
|
51
|
+
|
|
21
52
|
## [0.41.0](https://github.com/boadij/pi-herdsman/compare/v0.40.0...v0.41.0) (2026-11-07)
|
|
22
53
|
|
|
23
54
|
|
package/SKILL.md
CHANGED
|
@@ -210,7 +210,8 @@ execution ownership to that agent until the assignment resolves; do not execute
|
|
|
210
210
|
or assign overlapping work while it is delegated.
|
|
211
211
|
Integrate direct agent results after resolution.
|
|
212
212
|
Own only the assigned objective and your direct permitted agents. Agent-started
|
|
213
|
-
agents
|
|
213
|
+
agents delegate further only within the configured maximum nesting depth and
|
|
214
|
+
are leaves beyond it. Delegate bounded execution work when an Agent can
|
|
214
215
|
reasonably own it and delegation is useful. Reuse adequate supplied evidence
|
|
215
216
|
rather than rediscovering it. Integrate direct agent results before completing. The lead
|
|
216
217
|
retains architecture, approved scope, acceptance of Agent outputs, and
|
|
@@ -247,12 +248,13 @@ Do not silently broaden scope or make an unapproved scope, architecture,
|
|
|
247
248
|
security, protocol, repository-boundary, product, or operational decision.
|
|
248
249
|
|
|
249
250
|
Use ask_owner only when a decision from your exact direct owner is genuinely
|
|
250
|
-
required to continue correctly.
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
251
|
+
required to continue correctly. Explicit attachments must be supported UTF-8
|
|
252
|
+
text fully embedded within the applicable per-file and complete-message
|
|
253
|
+
budgets. Call ask_owner alone as the final tool call of the turn. Wait for the
|
|
254
|
+
direct owner's reply only after the tool confirms the question was sent; if
|
|
255
|
+
rejected, address the error or report a non-empty blocker. Keep at most one
|
|
256
|
+
question outstanding. Do not guess the answer. The reply resumes the same
|
|
257
|
+
assignment.
|
|
256
258
|
|
|
257
259
|
Treat inactivity as advisory, not proof of a hang. Preserve exact identity and
|
|
258
260
|
cleanup evidence on failure. Do not blindly retry destructive cleanup or
|
|
@@ -294,8 +296,8 @@ A Lead may delegate to available definitions permitted by its effective
|
|
|
294
296
|
`agents` field; omission permits all, while an empty list permits none.
|
|
295
297
|
|
|
296
298
|
A delegating agent may delegate only to definitions listed in its effective
|
|
297
|
-
`agents` field and owns only its direct agents. Agent
|
|
298
|
-
|
|
299
|
+
`agents` field and owns only its direct agents. An Agent at the configured
|
|
300
|
+
`maxAgentDepth` is a leaf even when its definition is delegation-capable.
|
|
299
301
|
|
|
300
302
|
A delegating agent integrates agent results before its own completion. Direct
|
|
301
303
|
agent work and undelivered agent results gate completion.
|