pi-herdsman 0.6.2 → 0.7.0

package/docs/reference/agent.md

@@ -61,6 +61,12 @@ session fail closed. The controller's own active Pi session cannot be continued
 to itself; use `delegate` with `fork` when a separate derived context is
 required.
 
+When `contextRetirement` is enabled, `continue` is rejected for a retired
+managed-agent session. A `delegate` with `fork` is also rejected when its
+source is a retired managed-agent session; delegate a fresh agent and pass the
+previous handoff/resultRef and relevant files instead. Retired results
+explicitly instruct the controller to delegate a fresh agent.
+
 The saved session's logical label is inherited exactly for the continued
 generation. A caller cannot provide a continuation label; if the inherited
 label is occupied, continuation fails with `agent_label_exists`.

package/docs/reference/commands.md

@@ -19,7 +19,8 @@ plain `/agents` remains available as a setup diagnostic.
 ```
 
 The plain command opens a native Pi selection menu with `Running`,
-`Definitions`, `Layout`, `Message limits`, and `Stop all…` destinations. The
+`Definitions`, `Layout`, `Context retirement  on|off`, `Message limits`, and
+`Stop all…` destinations. The
 Message limits view edits the user-wide inline attachment and mailbox payload
 limits. It is available only to a lead Pi session with UI. Current
 values and presets show a rough token equivalent using four UTF-8 bytes per

package/docs/reference/configuration.md

@@ -26,6 +26,7 @@ schema is:
 ```json
 {
   "spawnPlacement": "subtree",
+  "contextRetirement": true,
   "inlineAttachmentLimitBytes": 131072,
   "mailboxPayloadLimitBytes": 131072
 }
@@ -36,6 +37,7 @@ An absent file means these defaults:
 | Field                        |            Default | Allowed values                                    |
 | ---------------------------- | -----------------: | ------------------------------------------------- |
 | `spawnPlacement`             |          `subtree` | `tab`, `subtree`, `split`                         |
+| `contextRetirement`          |               true | boolean                                           |
 | `inlineAttachmentLimitBytes` | `131072` (128 KiB) | integer from 1024 (1 KiB) through 1048576 (1 MiB) |
 | `mailboxPayloadLimitBytes`   | `131072` (128 KiB) | integer from 1024 (1 KiB) through 1048576 (1 MiB) |
 
@@ -49,6 +51,14 @@ files remain canonical references. `mailboxPayloadLimitBytes` limits the exact
 serialized request, ask, or chief message record. Chief messages also retain
 their fixed 8 KiB protocol ceiling.
 
+When `contextRetirement` is enabled, automatic context pressure retires a
+managed-agent session. Herdsman suppresses preventive threshold compaction
+while the assignment finalizes and leaves Pi's overflow recovery available.
+The session receives a finalization instruction, and its result requires a
+fresh agent for follow-up. Disabling it bypasses retirement completely,
+including existing retirement markers, and leaves Pi's native compaction and
+session reuse behavior untouched.
+
 Placement affects future starts, not existing agents. `tab` uses one lead-owned
 agents tab, `subtree` gives each lead-direct agent its own tab, and `split`
 splits from the caller's pane. Nested delegation always splits in its owner's

package/package.json

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