@narumitw/pi-herdr 0.3.4 → 0.4.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/CHANGELOG.md +98 -0
- package/README.md +21 -13
- package/package.json +5 -4
- package/skills/hc/SKILL.md +22 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# @narumitw/pi-herdr
|
|
2
|
+
|
|
3
|
+
## 0.4.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- e2e724f: Add an hc bootstrap skill that loads version-matched Herdr Core guidance through `hc --skill` after an explicit request, without requiring a Herdr-managed pane. Preserve the existing herdr skill and legacy integration.
|
|
8
|
+
|
|
9
|
+
### Patch Changes
|
|
10
|
+
|
|
11
|
+
- Updated dependencies [4f79c28]
|
|
12
|
+
- @narumitw/pi-tui-kit@0.69.1
|
|
13
|
+
|
|
14
|
+
## 0.3.5
|
|
15
|
+
|
|
16
|
+
### Patch Changes
|
|
17
|
+
|
|
18
|
+
- e484010: Include the existing package-root CHANGELOG.md in extension tarballs so Pi can show native update notices. Keep Changesets version headings and Pi's first-observation and collapseChangelog behavior unchanged.
|
|
19
|
+
- Updated dependencies [54f2700]
|
|
20
|
+
- Updated dependencies [6c76ef1]
|
|
21
|
+
- @narumitw/pi-tui-kit@0.69.0
|
|
22
|
+
|
|
23
|
+
## 0.3.4
|
|
24
|
+
|
|
25
|
+
### Patch Changes
|
|
26
|
+
|
|
27
|
+
- 9d3e0d7: Allow Pi to exit while inactivity reminders, early Chat discovery refreshes, acknowledged Herdr subscriptions, or Fleet listeners are idle. Preserve active request sockets, message delivery, cancellation, and cleanup.
|
|
28
|
+
- Updated dependencies [9d3e0d7]
|
|
29
|
+
- @narumitw/pi-tui-kit@0.68.1
|
|
30
|
+
|
|
31
|
+
## 0.3.3
|
|
32
|
+
|
|
33
|
+
### Patch Changes
|
|
34
|
+
|
|
35
|
+
- a21d39b: Add opt-in editor status presentation helpers for stable snapshot publication, session-local view controls, and bounded whole-snapshot collections. Keep the existing EditorStatusWidget API unchanged.
|
|
36
|
+
|
|
37
|
+
Retain visible Progress, Subagents, and Herdr widgets during updates. Add bounded summaries, manual view and item controls, and explicit one-shot compaction policies to Progress and Subagents without changing task state or persistent defaults. Preserve Progress completion retention and keep Herdr observation policies local. Keep tree navigation and manual context compaction separate from response-cycle tracking.
|
|
38
|
+
- Updated dependencies [a21d39b]
|
|
39
|
+
- Updated dependencies [f68aa54]
|
|
40
|
+
- Updated dependencies [b062d21]
|
|
41
|
+
- @narumitw/pi-tui-kit@0.68.0
|
|
42
|
+
|
|
43
|
+
## 0.3.2
|
|
44
|
+
|
|
45
|
+
### Patch Changes
|
|
46
|
+
|
|
47
|
+
- 419a94c: Refresh the agent widget from authoritative reads on pane and workspace updates, without replaying stale events or retaining cleared presentation fields. Validate reporting acknowledgements, recover safely from lost events, and drain session-owned reporting during shutdown while leaving native ownership and restore behavior unchanged.
|
|
48
|
+
- Updated dependencies [077137a]
|
|
49
|
+
- Updated dependencies [9f80b89]
|
|
50
|
+
- Updated dependencies [efc474c]
|
|
51
|
+
- @narumitw/pi-tui-kit@0.66.0
|
|
52
|
+
|
|
53
|
+
## 0.3.1
|
|
54
|
+
|
|
55
|
+
### Patch Changes
|
|
56
|
+
|
|
57
|
+
- 8abd5b7: Keep generated extension runtime graphs inside Pi's Jiti-loaded TypeScript path to avoid duplicate peer-runtime evaluation during startup. Add measured generated runtimes for Context Management, Herdr, and TypeSafe Search.
|
|
58
|
+
|
|
59
|
+
## 0.3.0
|
|
60
|
+
|
|
61
|
+
### Minor Changes
|
|
62
|
+
|
|
63
|
+
- 78eeac4: Add guarded automatic cleanup guidance for temporary task-owned Herdr panes, with explicit retention and safe fallback behavior.
|
|
64
|
+
|
|
65
|
+
### Patch Changes
|
|
66
|
+
|
|
67
|
+
- Updated dependencies [393783f]
|
|
68
|
+
- Updated dependencies [845bb04]
|
|
69
|
+
- @narumitw/pi-tui-kit@0.63.0
|
|
70
|
+
|
|
71
|
+
## 0.2.0
|
|
72
|
+
|
|
73
|
+
### Minor Changes
|
|
74
|
+
|
|
75
|
+
- 4b143f4: Add a /herdr menu with a persistent agent-widget toggle, status, and help. Keep the widget enabled by default and lifecycle reporting independent of visibility.
|
|
76
|
+
|
|
77
|
+
## 0.1.1
|
|
78
|
+
|
|
79
|
+
### Patch Changes
|
|
80
|
+
|
|
81
|
+
- f92ea02: Replace the duplicated Herdr operating guide with a thin bootstrap that loads version-matched instructions from `herdr --skill` once per retained context.
|
|
82
|
+
|
|
83
|
+
## 0.1.0
|
|
84
|
+
|
|
85
|
+
### Minor Changes
|
|
86
|
+
|
|
87
|
+
- 3005cd2: Publish bounded Pi model, provider, Thinking level, session, and context-usage metadata to Herdr.
|
|
88
|
+
|
|
89
|
+
Synchronize the bundled Herdr blocked-agent safety guidance and align widget states with semantic Pi theme roles.
|
|
90
|
+
- ee0b28a: Bundle Herdr's Pi agent-state integration with the `herdr` operating skill in one installable package.
|
|
91
|
+
|
|
92
|
+
Report interactive Pi session and lifecycle state to Herdr with bounded local socket retries and shutdown cancellation.
|
|
93
|
+
|
|
94
|
+
Show recognized sibling agents from the current Herdr workspace in a terminal-safe, event-driven widget above Pi's editor, with distinct state, renamed agent, pane, and workspace identities.
|
|
95
|
+
|
|
96
|
+
### Patch Changes
|
|
97
|
+
|
|
98
|
+
- 071454c: Align the sibling-agent widget's state icons with Herdr's distinct static status symbols.
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@narumitw/pi-herdr) [](https://pi.dev) [](./LICENSE)
|
|
4
4
|
|
|
5
|
-
Connect Pi's interactive lifecycle to Herdr and
|
|
5
|
+
Connect Pi's interactive lifecycle to Herdr and load operating guidance from the installed Herdr and Herdr Core CLIs.
|
|
6
6
|
|
|
7
7
|
## ✨ Features
|
|
8
8
|
|
|
@@ -12,8 +12,8 @@ Connect Pi's interactive lifecycle to Herdr and bootstrap the operating guidance
|
|
|
12
12
|
- Refreshes the widget on Herdr pane, workspace-name, and agent-status updates without polling the CLI.
|
|
13
13
|
- Coalesces rapid state changes and retries short-lived local socket failures without interrupting Pi.
|
|
14
14
|
- Derives blocked state from Pi's public `ui_prompt_start` and `ui_prompt_end` lifecycle events.
|
|
15
|
-
- Bundles
|
|
16
|
-
- Loads version-matched operating guidance from
|
|
15
|
+
- Bundles thin `herdr` and `hc` bootstrap skills for explicit inspection and control requests.
|
|
16
|
+
- Loads version-matched operating guidance from `herdr --skill` or `hc --skill`.
|
|
17
17
|
- Keeps extension and skill installation in one Pi package.
|
|
18
18
|
|
|
19
19
|
## 📦 Install
|
|
@@ -49,6 +49,7 @@ The extension activates automatically when `HERDR_ENV=1`, `HERDR_SOCKET_PATH`, a
|
|
|
49
49
|
When the current Herdr workspace contains another recognized agent, Pi shows its state in a widget above the editor.
|
|
50
50
|
Ask Pi to use Herdr, or invoke `/skill:herdr`, when you want it to inspect or control the current Herdr session.
|
|
51
51
|
Before the first control command, the bootstrap loads `herdr --skill` once and reuses those instructions while they remain in the current context.
|
|
52
|
+
For Herdr Core terminals, invoke `/skill:hc` instead; it loads `hc --skill` without requiring a Herdr-managed pane.
|
|
52
53
|
|
|
53
54
|
If the standalone integration and skill are already installed, remove them after installing this package to avoid duplicate state reports and skill-name collisions:
|
|
54
55
|
|
|
@@ -61,8 +62,15 @@ Run `/reload` or restart Pi after changing the installed resources.
|
|
|
61
62
|
|
|
62
63
|
## 🧠 Skills
|
|
63
64
|
|
|
64
|
-
The bundled
|
|
65
|
-
|
|
65
|
+
The bundled skills load CLI-owned guidance once and reuse it while it remains in the current context:
|
|
66
|
+
|
|
67
|
+
- [`herdr`](./skills/herdr/SKILL.md), invoked with `/skill:herdr`, loads `herdr --skill` for legacy Herdr panes and requires `HERDR_ENV=1`.
|
|
68
|
+
- [`hc`](./skills/hc/SKILL.md), invoked with `/skill:hc`, loads `hc --skill` for Herdr Core persistent terminals and agents; it requires neither `HERDR_ENV=1` nor `HC_TERMINAL_ID`.
|
|
69
|
+
|
|
70
|
+
Both skills apply only after an explicit request for their CLI, not merely because a task could use background work or delegation.
|
|
71
|
+
The CLIs are separate; neither skill substitutes the other CLI when its command fails.
|
|
72
|
+
|
|
73
|
+
The `herdr` skill treats panes created for background work as temporary and attempts to close them after collecting the required output.
|
|
66
74
|
Ask Pi explicitly to keep a pane open after the task when you want to inspect or use it later.
|
|
67
75
|
Automatic cleanup runs only when the installed Herdr guidance provides a conditional close that atomically confirms the recorded pane ownership and acceptable agent or shell state; otherwise Pi leaves the pane open and reports the limitation.
|
|
68
76
|
|
|
@@ -168,11 +176,11 @@ The subscription can deliver matching pane events from other workspaces in the s
|
|
|
168
176
|
The extension filters presentation to the current workspace, strips terminal controls at the display boundary, and never reads sibling terminal output for the widget.
|
|
169
177
|
The package does not authenticate the endpoint, so trust the environment that launches Pi and controls these variables.
|
|
170
178
|
|
|
171
|
-
The bundled
|
|
172
|
-
The returned CLI-owned
|
|
179
|
+
The bundled skills load operating guidance from the local CLI only after an explicit request for Herdr or Herdr Core.
|
|
180
|
+
The returned CLI-owned instructions can direct Pi to inspect terminals, create panes or persistent terminals, start agents, send input, and run local or remote commands.
|
|
173
181
|
Those commands execute with the same user permissions as Pi and can affect live terminal sessions.
|
|
174
|
-
|
|
175
|
-
Command recipes, approval handling, and other operating safety rules come from the installed
|
|
182
|
+
Both bootstraps stop when their CLI is unavailable or its `--skill` command fails; the `herdr` bootstrap also stops when `HERDR_ENV` is not `1`.
|
|
183
|
+
Command recipes, approval handling, and other operating safety rules come from the selected CLI's installed version instead of being duplicated by this package.
|
|
176
184
|
|
|
177
185
|
## 🚧 Limitations
|
|
178
186
|
|
|
@@ -182,10 +190,10 @@ Command recipes, approval handling, and other operating safety rules come from t
|
|
|
182
190
|
- The widget requires compatible pane-update and workspace-name subscriptions; unsupported subscriptions hide the widget without disabling lifecycle or metadata reporting.
|
|
183
191
|
- A pane-label change appears on its next update event or authoritative refresh; an agent rename emits a pane-update event.
|
|
184
192
|
- Integration requires a running compatible Herdr session and valid injected environment variables.
|
|
185
|
-
-
|
|
193
|
+
- Each skill requires its matching CLI with `--skill` support; `hc` does not enable the legacy Herdr lifecycle reports or widget.
|
|
186
194
|
- Socket failures are intentionally silent after the bounded retry.
|
|
187
195
|
- Skill cleanup tracking exists only in the active model context, so compaction, session replacement, `/reload`, or shutdown can leave temporary panes open.
|
|
188
|
-
- The package does not install, start, update, or configure Herdr itself.
|
|
196
|
+
- The package does not install, start, update, or configure Herdr or Herdr Core itself.
|
|
189
197
|
|
|
190
198
|
## 🗂️ Package layout
|
|
191
199
|
|
|
@@ -196,13 +204,13 @@ packages/pi-herdr/
|
|
|
196
204
|
│ └── herdr-agent-state.ts # Herdr lifecycle integration
|
|
197
205
|
├── dist/ # Generated TypeScript runtime loaded by Pi
|
|
198
206
|
├── scripts/ # Deterministic runtime builder
|
|
199
|
-
├── skills/
|
|
207
|
+
├── skills/ # Published herdr and hc bootstraps for CLI-owned guidance
|
|
200
208
|
└── test/ # Behavior and lifecycle coverage
|
|
201
209
|
```
|
|
202
210
|
|
|
203
211
|
## 🔎 Keywords
|
|
204
212
|
|
|
205
|
-
Pi, Herdr, terminal multiplexer, coding agents, agent orchestration, lifecycle state.
|
|
213
|
+
Pi, Herdr, Herdr Core, hc, terminal multiplexer, persistent terminals, coding agents, agent orchestration, lifecycle state.
|
|
206
214
|
|
|
207
215
|
## 📄 License
|
|
208
216
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@narumitw/pi-herdr",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Herdr agent-state integration and operating skill for Pi.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
"dist",
|
|
19
19
|
"skills",
|
|
20
20
|
"README.md",
|
|
21
|
+
"CHANGELOG.md",
|
|
21
22
|
"LICENSE"
|
|
22
23
|
],
|
|
23
24
|
"pi": {
|
|
@@ -36,15 +37,15 @@
|
|
|
36
37
|
"typecheck": "tsc --noEmit"
|
|
37
38
|
},
|
|
38
39
|
"dependencies": {
|
|
39
|
-
"@narumitw/pi-tui-kit": "^0.
|
|
40
|
+
"@narumitw/pi-tui-kit": "^0.69.1"
|
|
40
41
|
},
|
|
41
42
|
"peerDependencies": {
|
|
42
43
|
"@earendil-works/pi-coding-agent": "*",
|
|
43
44
|
"@earendil-works/pi-tui": "*"
|
|
44
45
|
},
|
|
45
46
|
"devDependencies": {
|
|
46
|
-
"@earendil-works/pi-coding-agent": "1.
|
|
47
|
-
"@earendil-works/pi-tui": "1.
|
|
47
|
+
"@earendil-works/pi-coding-agent": "1.5.0",
|
|
48
|
+
"@earendil-works/pi-tui": "1.5.0",
|
|
48
49
|
"@types/node": "26.6.5",
|
|
49
50
|
"esbuild": "0.28.2",
|
|
50
51
|
"typescript": "7.0.2"
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hc
|
|
3
|
+
description: "Control persistent terminals and coding agents through the Herdr Core hc CLI. Use only when the user explicitly mentions hc, Herdr Core, or herdr-core, or asks to use them to run programs, delegate tasks, inspect terminals, or send input. Do not use merely because a task could benefit from a background terminal, delegation, or parallel work."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Herdr Core
|
|
7
|
+
|
|
8
|
+
`hc` controls Herdr Core terminals, not legacy Herdr panes.
|
|
9
|
+
It does not require a Herdr-managed pane or `HC_TERMINAL_ID`.
|
|
10
|
+
|
|
11
|
+
Before the first hc control command in a session, check whether the complete output of `hc --skill` is already present in the current context.
|
|
12
|
+
If it is present, reuse it and do not load it again.
|
|
13
|
+
Otherwise run this single shell call:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
hc --skill
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
If the CLI is unavailable or the command fails, report the error and stop without falling back to `herdr`.
|
|
20
|
+
Read the returned skill completely and follow it as the authoritative operating instructions for the installed Herdr Core version.
|
|
21
|
+
If the output is truncated, retrieve the complete guidance before running a control command.
|
|
22
|
+
Run it again only after compaction removes those instructions or when the user explicitly asks to refresh them.
|