pi-herdsman 0.6.1 → 0.6.2

package/docs/guides/recovery.md

@@ -50,7 +50,9 @@ recovery error is present, inspect its exact details.
 ## Inactivity advisory
 
 A `working` agent with an exact active assignment can become advisory `stale`
-after ten minutes without observed Pi turn, message, or tool activity.
+after ten minutes without qualifying execution progress. Model streaming,
+turn/message boundaries, and tool execution start/end boundaries count;
+streaming tool updates alone do not reset progress.
 
 Possible list fields:
 

package/docs/reference/agent-states.md

@@ -48,7 +48,11 @@ model metadata, missing activity, a guessed session, or an old agent identity.
 ## Inactivity fields
 
 A qualifying `working` agent may also report `stale`, `inactive_ms`, and
-`last_activity_at`. This advisory does not change the state or prove a hang.
+`last_activity_at`. Qualifying progress includes model streaming and tool
+execution boundaries (`tool_execution_start` and `tool_execution_end`), along
+with the surrounding turn and message boundaries. Streaming tool updates alone
+do not advance `last_activity_at`. This advisory does not change the state or
+prove a hang.
 
 ## See also
 

package/docs/reference/agent.md

@@ -150,8 +150,11 @@ when the exact message limit permits. Otherwise they remain canonical references
 
 `timeoutMs` is valid on `delegate` and `continue` and must be an integer
 from `5001` through `300000`. The startup budget reserves one bounded diagnostic
-window. Current message limits are governed by the Herdsman config file and its
-defaults, plus the fixed mailbox protocol ceiling. Managed mailbox records use
+window; it is unrelated to managed-agent Pi shell execution. Direct calls from
+a managed agent to the Pi built-in `bash` or `powershell` tool receive a default
+600-second timeout when the call omits `timeout`; an explicit timeout is kept
+unchanged. Current message limits are governed by the Herdsman config file and
+its defaults, plus the fixed mailbox protocol ceiling. Managed mailbox records use
 protocol V4 in the `mailboxes-v4` namespace, and control requests use the marker prefix
 `__PI_HERDSMAN_AGENT_V4__:`.
 

package/docs/reference/status-widget.md

@@ -75,9 +75,9 @@ Example:
 
 The header reports exact non-zero lifecycle states in the order `working`,
 `blocked`, `settling`, `starting`, and `unknown`. `starting` is a
-presentation-only count for assignments whose final label and mailbox claim
-are known but whose authoritative agent startup has not completed. It is not
-mailbox state, control authority, or Running inventory.
+presentation-only count for controller-local assignments that have begun
+startup but have not yet become active or terminal. It is not mailbox state,
+control authority, or Running inventory.
 
 Before the first successful refresh, the header says `unavailable`.
 
@@ -103,10 +103,13 @@ useful room before it is truncated.
 
 Working rows use `● working`, blocked rows use `◐ blocked`, settling rows use
 `◌ settling`, starting rows use `◌ starting`, and unknown rows use `? unknown`.
-Working, settling, and starting animate; blocked and unknown rows are static. A
-starting row is reconciled away
-when authoritative agent evidence replaces it, and is removed on startup
-failure, rollback, repeated session start, or shutdown.
+Working, settling, and starting animate; blocked and unknown rows are static.
+While a controller-local start remains pending, an authoritative `settling`
+row is presented as `starting` so launch and request handoff remain visually
+continuous. `working`, `blocked`, and `unknown` authoritative states are never
+overridden. A starting row is removed when its exact request becomes active or
+terminal, its local runtime is removed, startup fails or rolls back, the
+controller session restarts, or shutdown clears transient state.
 
 `Running` inspection shows every authoritative agent row and excludes
 presentation-only starting rows. A terminal result is followed by cleanup; the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-herdsman",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "type": "module",
   "description": "Asynchronous Pi subagents and agent fleet orchestration with nested delegation, parallel execution, and supervision in herdr.",
   "license": "Apache-2.0",