pi-herdsman 0.9.0 → 0.10.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.
- package/SKILL.md +15 -5
- package/dist/index.js +97 -83
- package/docs/concepts/agents.md +1 -1
- package/docs/concepts/lifecycle.md +12 -3
- package/docs/guides/handoffs.md +4 -4
- package/docs/reference/agent-states.md +11 -7
- package/docs/reference/agent.md +47 -15
- package/docs/reference/commands.md +6 -1
- package/package.json +1 -1
package/SKILL.md
CHANGED
|
@@ -45,15 +45,25 @@ State describes what is happening; available_actions describes current control
|
|
|
45
45
|
eligibility. Every operation revalidates exact state and identity before
|
|
46
46
|
mutation.
|
|
47
47
|
|
|
48
|
-
The live-agent control actions are `steer`, `reply`, and `close`;
|
|
48
|
+
The live-agent control actions are `steer`, `interrupt`, `reply`, and `close`;
|
|
49
|
+
these mutate
|
|
49
50
|
live agent execution and are available only when listed. Read-only `inspect`
|
|
50
51
|
captures bounded live terminal/process evidence. Read-only `transcript` captures
|
|
51
52
|
bounded persisted Pi conversation and tool evidence when listed. Neither changes
|
|
52
53
|
agent state. A completed agent does not remain available for another assignment.
|
|
53
54
|
|
|
54
|
-
Use steer only to change active work.
|
|
55
|
-
|
|
56
|
-
|
|
55
|
+
Use steer only to change active work non-preemptively. Steering does not cancel
|
|
56
|
+
an in-flight model or tool operation; Pi may queue it until the current
|
|
57
|
+
operation reaches a safe boundary.
|
|
58
|
+
|
|
59
|
+
Use interrupt only when the current in-flight operation itself must be
|
|
60
|
+
abandoned. Interrupt is preemptive: it cancels the current Pi operation and
|
|
61
|
+
continues the same assignment with the required replacement message. Do not
|
|
62
|
+
interrupt merely because an agent is slow or marked stale; inactivity is
|
|
63
|
+
advisory and does not prove a hang.
|
|
64
|
+
|
|
65
|
+
Use reply only to answer a valid outstanding ask_owner question. Use close only
|
|
66
|
+
for intentional teardown or abandonment.
|
|
57
67
|
|
|
58
68
|
A lost agent is a managed assignment whose exact physical execution is proven
|
|
59
69
|
gone before a durable terminal result resolved it. Loss is not completion or
|
|
@@ -97,7 +107,7 @@ If list reports result_error, do not start a new delegation over unresolved
|
|
|
97
107
|
work. Resolve mailbox persistence first, then close the exact agent before
|
|
98
108
|
starting another assignment; follow the stored recovery nextAction.
|
|
99
109
|
|
|
100
|
-
Before delegate, continue, steer, or reply, make the message self-contained.
|
|
110
|
+
Before delegate, continue, steer, interrupt, or reply, make the message self-contained.
|
|
101
111
|
|
|
102
112
|
Do not attach or mention agent instruction files such as AGENTS.md, CLAUDE.md,
|
|
103
113
|
GEMINI.md, or equivalents merely because they exist. Rely on normal project or
|