summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authort <t@tjp.lol>2026-09-01 12:00:53 -0600
committert <t@tjp.lol>2026-09-02 08:29:54 -0600
commit04791c3273ab7076cc53f146d7751670d86c5c9b (patch)
treee8eba4e49fa5ea1de7f75b70f064c864158ce5d0 /README.md
parent11aa2e9d8a8016eee008a8a043501aae96c873d4 (diff)
Keep Herdr reports current across Panto sessions
Use wall-clock-based report sequences so restarted processes supersede stale state, adopt the current message flag, restore idle state after replay, and release the agent report when a session ends.
Diffstat (limited to 'README.md')
-rw-r--r--README.md21
1 files changed, 13 insertions, 8 deletions
diff --git a/README.md b/README.md
index 18e221e..e5017be 100644
--- a/README.md
+++ b/README.md
@@ -2,8 +2,8 @@
`panto-herdr` reports panto lifecycle state to [Herdr](https://herdr.dev/) when
panto is running in a Herdr pane. It reports `panto` as the agent label and
-uses `thinking`, `responding`, `compacting`, and `tool:<name>` as short status
-labels.
+uses `thinking`, `responding`, `compacting`, and `tool:<name>` as short report
+messages.
Install it through panto's rock loader:
@@ -26,15 +26,20 @@ its JSON output, so reporting does not affect the panto terminal UI.
| panto event | Herdr state |
| --- | --- |
-| `session_start` | `idle` |
+| `session_start`, `session_ready` | `idle` |
| `user_message`, `thinking`, `compaction`, `tool_details`, `assistant_text` | `working` |
| `assistant_text_complete` | `idle` |
+| `session_end` | agent released |
-Current panto extensions do not receive a turn-complete or interrupt event.
-`assistant_text_complete` is therefore the best available idle boundary; an
-assistant text block followed by a tool call can show `idle` briefly before
-the next lifecycle event restores `working`. Native session restore is also
-out of scope until panto exposes a stable session reference to extensions.
+`session_ready` restores `idle` after panto replays historical lifecycle events
+while loading a resumed session. `session_end` removes panto's agent report when
+the process shuts down, so Herdr also clears the pane/space activity indicator
+once no reported agents remain.
+
+`assistant_text_complete` is the block-level idle boundary; an assistant text
+block followed by a tool call can show `idle` briefly before the next lifecycle
+event restores `working`. Native session restore is out of scope until panto
+exposes a stable session reference to extensions.
## Check