pi-herdsman 0.5.0 → 0.5.2

package/docs/concepts/agents.md

@@ -61,6 +61,8 @@ They are not public alternatives to the `agent` identity.
 
 ## Ownership
 
+A lead and its recursively owned agent hierarchy form a **herd**, Herdsman's term for an agent fleet.
+
 Each agent has one exact direct owner Pi session.
 
 A lead Pi session owns its direct agents.

package/docs/concepts/lifecycle.md

@@ -64,9 +64,10 @@ control until convergence is complete.
 
 Delegation does not suspend the owning controller until an agent finishes.
 
-`delegate` returns after the task has been durably accepted. The agent then runs
-independently in its managed Pi session while the owner remains available for
-other useful work and, for a lead Pi session, continued user interaction.
+`delegate` returns after the task has been atomically recorded for controller
+restart recovery. The agent then runs independently in its managed Pi session
+while the owner remains available for other useful work and, for a lead Pi
+session, continued user interaction.
 
 The owner must not poll for completion. It may continue with work that does not
 depend on the result or end its turn normally. Agent completion or an
@@ -118,8 +119,8 @@ assignment ownership.
 result.
 
 Steering is at-least-once at the agent boundary: an agent can apply a steer
-before its acknowledgement write becomes durable. If that acknowledgement
-write fails, retrying the same request may apply the steer again.
+before its acknowledgement write is recorded. If that acknowledgement write
+fails, retrying the same request may apply the steer again.
 
 Use `steer` only when `agent list` reports `steer` in `available_actions`.
 
@@ -137,9 +138,9 @@ The delegating agent's own state projection remains authoritative.
 
 ## Restart and recovery
 
-Durable mailbox state allows exact managed agents to be reconstructed after a
+Atomic mailbox state allows exact managed agents to be reconstructed after a
 controller restart. Live metadata can be rebuilt only when exact herdr and Pi
-identity still match.
+identity still match; this does not claim explicit power-loss durability.
 
 Unknown evidence remains `unknown`; recovery never rebinds stale metadata to a
 different agent generation.

package/docs/development/validation.md

@@ -41,7 +41,6 @@ The test runner uses:
 ```text
 --experimental-test-module-mocks
 --test
---test-timeout=10000
 ```
 
 ## Process containment

package/docs/getting-started.md

@@ -11,7 +11,7 @@ path.
 You need:
 
 - [herdr](https://github.com/herdrdev/herdr) `>=0.9.0`;
-- Pi `>=0.84.2 <0.86.0` (the version range tested for this release);
+- Pi `>=0.84.2 <0.86.0` (supported);
 - Node `>=22.19.0`.
 
 Install or refresh the herdr Pi integration:

package/docs/reference/agent.md

@@ -66,8 +66,9 @@ label is occupied, continuation fails with `agent_label_exists`.
 
 Successful `delegate` results use `action: "delegate"`; successful `continue`
 results use `action: "continue"`. Both include `agent`, `definition`, request,
-session, and startup evidence where available. Both return after durable
-acceptance, not completion. A terminal result makes the exact session identity
+session, and startup evidence where available. Both return after atomic
+recording for controller restart recovery, not completion. A terminal result
+makes the exact session identity
 prominent for a later `continue` call.
 
 ## `list`

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "pi-herdsman",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "type": "module",
-  "description": "Asynchronous Pi agent orchestration with nested delegation, parallel execution, and supervision in herdr.",
+  "description": "Asynchronous Pi subagents and agent fleet orchestration with nested delegation, parallel execution, and supervision in herdr.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -24,6 +24,10 @@
     "coding-agents",
     "multi-agent",
     "multi-agent-coding",
+    "agent-fleet",
+    "parallel-agents",
+    "background-agents",
+    "nested-agents",
     "agent-orchestration",
     "orchestration",
     "delegation",