pi-herdsman 0.8.0 → 0.9.0

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 (10) hide show
  1. package/SKILL.md +8 -6
  2. package/dist/index.js +89 -75
  3. package/docs/concepts/agents.md +2 -1
  4. package/docs/concepts/delegation.md +1 -1
  5. package/docs/concepts/lifecycle.md +1 -1
  6. package/docs/development/smoke-testing.md +1 -1
  7. package/docs/reference/agent-states.md +9 -7
  8. package/docs/reference/agent.md +46 -16
  9. package/docs/reference/errors.md +5 -3
  10. package/package.json +1 -1
package/SKILL.md CHANGED
@@ -47,8 +47,9 @@ mutation.
47
47
 
48
48
  The live-agent control actions are `steer`, `reply`, and `close`; these mutate
49
49
  live agent execution and are available only when listed. Read-only `inspect`
50
- captures bounded current evidence without changing agent state. A completed
51
- agent does not remain available for another assignment.
50
+ captures bounded live terminal/process evidence. Read-only `transcript` captures
51
+ bounded persisted Pi conversation and tool evidence when listed. Neither changes
52
+ agent state. A completed agent does not remain available for another assignment.
52
53
 
53
54
  Use steer only to change active work. Use reply only to answer a valid
54
55
  outstanding ask_owner question. Use close only for intentional teardown or
@@ -56,9 +57,10 @@ abandonment.
56
57
 
57
58
  A lost agent is a managed assignment whose exact physical execution is proven
58
59
  gone before a durable terminal result resolved it. Loss is not completion or
59
- task failure. Treat the assignment as unresolved. Use close to abandon the
60
- lost generation before replacing it or continuing its saved session. Unknown
61
- evidence remains fail-closed and is not proof of loss.
60
+ task failure. Treat the assignment as unresolved. When transcript is listed,
61
+ use it only when the last persisted work materially affects recovery. Use close
62
+ to abandon the lost generation before replacing it or continuing its saved
63
+ session. Unknown evidence remains fail-closed and is not proof of loss.
62
64
 
63
65
  Never guess identities, paths, sessions, or control state. Treat unknown or
64
66
  conflicting evidence as unresolved. Keep one writer per worktree or file-
@@ -88,7 +90,7 @@ necessary independent work remains, end your turn without concluding the task.
88
90
  Agent results or attention will resume this session automatically. Do not
89
91
  conclude or produce the final synthesis while unresolved agent work remains.
90
92
  Do not invent side work, broaden scope, perform speculative or precautionary
91
- exploration, list or inspect merely for progress, steer merely for status, sleep,
93
+ exploration, list, inspect, or transcript merely for progress, steer merely for status, sleep,
92
94
  poll, or otherwise keep the turn alive while agent results are pending.
93
95
 
94
96
  If list reports result_error, do not start a new delegation over unresolved