@comput/pi-intercom 0.3.0 → 0.4.2

package/README.md

@@ -1,41 +1,96 @@
-# PiIntercom (V1 supported core)
+# Pi Intercom
 
-One Windows/Linux interactive Pi extension for coordinator and workers. **Intercom communicates; Pi orchestrates.** No automatic assignment, retry, removal, replacement, launcher fallback, commit, or rollback.
+**A coordinator-led workspace for Pi.**
 
-**`intercom_stop_worker` and `intercom_close_worker` are disabled.** They throw an unsupported-host error before sending control or calling cancellation/shutdown. Incoming stop/close controls also fail. Pi 0.84.4 leaves retry continuation alive after extension abort. See [blocker](references/implementation-blocker.md). Newer versions are not automatically assumed safe; a verified supported lifecycle API and tests are required before enabling these capabilities.
+Delegate into separate worker contexts, evaluate their reports, and keep the main conversation focused—with the team visible alongside it.
 
-## Use
+Pi Intercom lets your main Pi session orchestrate work across a team of worker sessions. You describe the goal; the coordinator breaks it into focused assignments and delegates them to workers, each with its own conversation and model context. Workers report back, and the coordinator evaluates their results, decides what to do next, and brings the outcome back to you.
 
-Requires Windows or Linux, Node 22+, interactive Pi with project trust, and this package's peer dependencies supplied by Pi (`@earendil-works/pi-coding-agent`, `typebox`). Launch the coordinator explicitly from the intended root:
+A core objective is to **keep the coordinator's context clean and concise, and the main conversation responsive**. Delegate implementation details, lengthy investigations, and tool-heavy work to worker contexts; bring back focused findings for the coordinator to evaluate. That helps the main session stay available for your questions and decisions instead of getting bogged down in implementation. It is a workflow goal, not a guarantee of latency or context size—the quality of delegation and reports still matters.
 
-```powershell
-cd D:\Source\YourProject
-pi -e D:\Source\PiIntercom\src\index.ts
+The value is the loop: **delegate → report back → evaluate → decide the next step**. The coordinator can ask for clarification, request a review, assign follow-up work, or summarize the result—within the scope of your request. You stay in one conversation while the detailed work happens in separate worker contexts.
+
+## At a glance
+
+- **Keep the main conversation focused.** Workers handle implementation detail in their own contexts and return concise reports, helping the coordinator stay responsive and focused on decisions.
+- **Your main session leads.** The coordinator keeps track of your request, delegates focused work, and evaluates what comes back before deciding the next step.
+- **Each worker has its own context.** Implementation, investigation, and review can happen in separate Pi conversations. The coordinator supplies the brief; workers return findings rather than automatically merging their full conversation histories.
+- **Delegation is a conversation.** Ask for progress, clarify a finding, or send a follow-up assignment. Configured workers can also communicate directly when useful.
+- **Visible terminals.** With [Herdr](https://herdr.dev), workers open in their own tabs without taking your focus. Windows also supports separate terminal windows.
+- **A status pane above your conversation.** A lightweight terminal monitor shows each worker's last-observed status and activity. It is a display process, not another agent or model call.
+- **Explicit control.** Intercom supplies the communication tools; Pi decides how to use them in response to your instructions. Creating a worker does not silently assign it work.
+
+**Intercom communicates; Pi orchestrates.** It is a local coordination layer, not an autonomous scheduler or a task-completion guarantee.
+
+> **0.4.1:** The terminal monitor replaces the browser dashboard. Public worker reports and the read-only JSON worker-status tool keep coordinator decisions separate from observed activity.
+
+For potential next steps, see [Improvement topics](references/roadmap.md). These are proposals for discussion, not implemented features or release commitments.
+
+## What a session can look like
+
+Ask your coordinator:
+
+> Review the launcher and its tests for reliability issues. Delegate focused reviews to workers, evaluate their findings, and bring me a proposed fix plan before changing code.
+
+The coordinator can give one worker the launcher review and another the test review. Each investigates in its own context and reports back. The coordinator then checks the findings, resolves overlaps or disagreements, and decides whether to ask for more evidence or present the plan to you. Because you asked for a plan first, it stops before making changes.
+
+You direct the goal and boundaries—not every message between workers. Separate worker terminals remain available whenever you want to inspect their conversations.
+
+The monitor provides a compact view alongside that workflow. Example observations:
+
+```text
+Worker       Seen           Status       Last activity
+Reviewer     3s ago         working      Reading files
+Tester       12s ago        idle         Running command
 ```
 
-Alternatively install from npm:
+Status is **last reported**, not proof of a live connection. An idle worker's last activity can remain visible after it finishes a turn; neither idle nor a delivered message proves an assignment is complete. Old observations are marked explicitly.
 
-```powershell
+## Quick start
+
+**Requirements:** Windows or Linux, Node 22.19+, interactive [Pi](https://github.com/earendil-works/pi), and project trust. Use Herdr for worker tabs on either platform; Linux worker launching requires it. Pi supplies the extension's host peers (`@earendil-works/pi-coding-agent`, `typebox`). The separate Node monitor uses its own pinned runtime dependency, `pi-intercom-tui` (an npm alias of `@earendil-works/pi-tui`), installed even when Pi disables peer installation. It does not depend on Pi's extension loader or a machine-specific host installation path.
+
+### Install the published extension
+
+```sh
 pi install npm:@comput/pi-intercom
 ```
 
-Then start a new Pi session or run Pi `/reload`. `pi install` records the package in user settings by default; add `-l` for project settings. The Intercom extension itself does not change Pi settings. Load only one copy: do not enable the installed package alongside an explicit source checkout, or load both source and built output.
+Open Pi inside a Herdr workspace at the project root you want to coordinate, or run `/reload` in an existing session there. Then ask it to create workers and give them a bounded task.
+
+`pi install` uses your personal settings by default; add `-l` for project settings. Load only one copy: do not enable the npm package alongside a source checkout, or both source and built output. Use `pi list` to check your configured packages.
+
+### Know the boundaries
+
+- **Stop/close tools are disabled.** Close workers explicitly in their terminals. Pi 0.84.4's cancellation behavior leaves retry continuations alive; newer versions are not assumed safe without verification. See the [cancellation blocker](references/implementation-blocker.md).
+- **No silent recovery.** Intercom does not automatically retry messages, replace workers, switch launchers, commit changes, or roll them back.
+- **Local, not remote.** Messaging binds to loopback. Local processes are trusted; this is not an authenticated service for untrusted clients.
+
+For the exact steps and tool contracts, see [Explicit workflow](#explicit-workflow), [Tools and permissions](#tools-and-permissions), and [Config and wire contracts](#config-and-wire-contracts).
 
 ### Updating the loaded copy
 
 - **npm installation:** update the installed package, not this checkout: `pi update npm:@comput/pi-intercom`. A pinned version must be explicitly changed (for example, `pi install npm:@comput/pi-intercom@0.1.2`, using the same settings scope as the original installation). `pi list` shows configured package sources; inspect that installation's `package.json` to confirm its version.
-- **Source loading (`pi -e .../src/index.ts`):** update that checkout. `npm run build` produces test output; it does not update a separate npm installation.
+- **Source loading:** update that checkout and run `npm ci && npm run build` to rebuild the standalone monitor. This does not update a separate npm installation.
 - After obtaining the intended code, start a new session or use Pi `/reload` in each affected running host. **`intercom_reload_worker` only reads shared configuration; it cannot load extension-code fixes.** Workers launched by a coordinator receive the coordinator extension's actual file path. Updating a different copy does not change that path, and existing workers do not automatically reload.
 
 The 0.1.2 update/reload and subsequent worker creation were observed live; comprehensive reload/session-replacement lifecycle coverage remains pending.
 
-### Linux source installation
+### Install from source
+
+To develop or run a source checkout, build and register it:
 
 ```sh
+git clone https://github.com/comput-sh/pi-intercom.git
+cd pi-intercom
+npm ci
+npm run build
 pi install /absolute/path/to/pi-intercom
 ```
 
-Run Pi `/reload` (or start a new interactive session) after installing or changing source. Linux supports messaging, configuration, the dashboard, and Herdr worker launch/resume. Launch the coordinator inside a Herdr workspace; `herdr`, `sh`, and `pi` must be on PATH in worker panes. Workers run a quoted POSIX shell command in the returned pane, with the coordinator's actual extension path. Project trust remains required.
+Replace the final path with your checkout's absolute path (use a Windows path on Windows). Remove or disable a separately installed npm copy before loading source. Then open Pi in the project you want to coordinate—not necessarily the extension's checkout.
+
+Run Pi `/reload` (or start a new interactive session) after installing or changing source; reload workers too when changing their extension code. A standalone monitor already running in its pane needs an explicit restart to load rebuilt display code. Linux supports messaging, configuration, the terminal monitor, and Herdr worker launch/resume. Launch the coordinator inside a Herdr workspace; `herdr`, `sh`, and `pi` must be on PATH in worker panes. Workers run a quoted POSIX shell command in the returned pane, with the coordinator's actual extension path. Project trust remains required.
 
 Linux `multiplexer: none` is explicitly unsupported: no terminal guessing, headless fallback, or automatic cleanup. Stop/close remain disabled on both platforms. Automated Linux tests cover shell argument preservation and adapter/HTTP behavior. A live source-loaded Linux Herdr smoke test launched two workers: both registered, loaded their configured names/responsibilities, and acknowledged coordinator messages through Intercom. This verifies launch and round-trip messaging, not resume or cancellation.
 
@@ -66,9 +121,11 @@ Every tool rereads current config and checks the live Pi session ID. Names are c
 | `intercom_configure_worker` | `sessionId`, `port`, `projectDirectory`, `name`, `description` | Coordinator; all five explicit fields, writes only |
 | `intercom_reload_worker` | `to` (worker name) | Coordinator; passive config/name reload |
 | `intercom_send` | `to` (name), `message` | Configured, responsibility-loaded sessions; asynchronous message |
-| `intercom_list` | None | Configured coordinator/workers; saved roster and derived `dashboardUrl`, never live health |
+| `intercom_list` | None | Configured coordinator/workers; saved roster, never live health |
+| `intercom_worker_status` | `name?`, `offset?`, `limit?` | Configured sessions; bounded JSON observations/public reports, no live probing |
 | `intercom_request_status` | `to` (worker name) | Coordinator; independent extension report |
 | `intercom_report_status` | None | Workers including anonymous; shared report function, never registration |
+| `intercom_report_work` | `status`, `summary?` | Configured, responsibility-loaded workers; save a public report and notify coordinator, never approve/complete work |
 | `intercom_stop_worker`, `intercom_close_worker` | `to` (worker name) | Coordinator role checked, then **unsupported-host error**, no side effects |
 | `intercom_resume_worker` | `to` (worker name) | Coordinator; saved session, configured launcher/directory |
 | `intercom_remove_worker` | `to` (worker name) | Coordinator; config entry only, no shutdown/session deletion |
@@ -97,7 +154,7 @@ Shared, source-controlled file: `<root>/.pi-intercom/config.json`. Do not ignore
 }
 ```
 
-Version 0.2.0 dashboard support adds optional `dashboardPort` (integer 1–65535) on the **coordinator entry only**. Older config without it remains valid; workers cannot have it. This is separate from each agent's messaging `port`. `intercom_list` keeps `version`, `multiplexer` and `agents`, and adds top-level `dashboardUrl`: `http://127.0.0.1:<saved dashboardPort>/`, or `null` when no dashboard port is saved. It reads saved config without probing or starting a dashboard; the URL is last-known, not a liveness claim.
+Legacy coordinator-only `dashboardPort` values are accepted for migration, but the browser dashboard has been retired in 0.4.1. Coordinator startup removes this field through the guarded config-write path. `intercom_list` returns the saved roster without `dashboardPort` or `dashboardUrl`; it does not probe live availability. The agent messaging `port` is unchanged.
 
 Workers have `coordinator:false` and an existing project directory equal to root or below it. Writes canonicalize directories and check real paths (including symlink escapes). Only coordinator extension operations write config; ordinary Pi file/shell tools are not restricted.
 
@@ -109,23 +166,60 @@ HTTP binds **127.0.0.1 only**, `POST /intercom`, UTF-8 JSON, at most 64 KiB. Env
 {"version":1,"kind":"message","from":"sender-session-id","to":"expected-recipient-session-id","payload":{"message":"explicit message"}}
 ```
 
-Kinds: `message`, `registration` (`port`, `projectDirectory`), `status` (`port`, `busy`), `request_status`, `reload`, `stop`, `close` (empty control payload). Sender session identity is the envelope `from`; registration/status agent notifications include an explicit `sessionId` field. Agent messages require configured sender and recipient; controls require the current coordinator's sender ID and a worker recipient. Registration/unknown status are intentional exceptions to configured-sender checks, accepted only by coordinator. All receivers verify expected recipient ID, protecting against stale ports reaching another session. Local processes are trusted: this is role validation, **not authentication**. No remote networking/proxies/redirects or credentials.
+Kinds: `message`, `report` (`status`, `summary`; configured worker → coordinator only), `registration` (`port`, `projectDirectory`), `status` (`port`, `busy`), `request_status`, `reload`, `stop`, `close` (empty control payload). Sender session identity is the envelope `from`; registration/status agent notifications include an explicit `sessionId` field. Agent messages require configured sender and recipient; controls require the current coordinator's sender ID and a worker recipient. Registration/unknown status are intentional exceptions to configured-sender checks, accepted only by coordinator. All receivers verify expected recipient ID, protecting against stale ports reaching another session. Local processes are trusted: this is role validation, **not authentication**. No remote networking/proxies/redirects or credentials.
 
 `202 {"accepted":true}` means Intercom extension receipt/dispatch, **not guaranteed Pi input acceptance, queueing, or model completion**. In Pi 0.84.4, `sendUserMessage` can reject during manual compaction after Intercom has acknowledged receipt: its void extension API reports the asynchronous rejection only as a local host error. Intercom has no delivery queue or retry to repair this gap; inspect the recipient's local error and arrange an explicit resend after compaction if needed. Replacing it with `sendMessage` is not a safe workaround because that path can start a concurrent run. Invalid/unsupported requests return an error; excessive bodies return 413. Request-status sends its report separately after accepting control. Starting in 0.2.1, Intercom always supplies `deliverAs: 'steer'`: Pi starts normally when idle and steers when busy. This avoids the idle-snapshot-to-busy race that caused “Agent is already processing” errors; it does not fix manual-compaction rejection. It does not hard-interrupt an executing tool. Each send resolves the recipient again from config; 5-second receipt deadline, **no retries**. Timeout means unknown outcome, not proof of nondelivery. No durable inbox, deduplication or replay log in V1.
 
 Version 0.2.0 telemetry adds an optional envelope `correlationId` for one transport attempt; legacy envelopes without it remain accepted. It is not agent identity, deduplication, a task ID, or a reply/completion guarantee.
 
-Tool text output is bounded to 50 KiB/2000 lines. The full saved roster remains in the shared config file; `dashboardUrl` is derived for list output. Name sync errors are surfaced; startup retains the useful endpoint, and explicit reload reports failure (Pi name/responsibility may already have changed before a Herdr tab rename fails).
+Tool text output is bounded to 50 KiB/2000 lines. The full saved roster remains in the shared config file. Name sync errors are surfaced; startup retains the useful endpoint, and explicit reload reports failure (Pi name/responsibility may already have changed before a Herdr tab rename fails).
 
-## Local observation dashboard (0.2.0)
+## Standalone terminal status monitor
 
-Current source adds metadata-only event logs and a coordinator-only, read-only localhost dashboard. Startup binds an OS-assigned port, then saves the actual port as the coordinator's `dashboardPort` and prints the local URL. Configured coordinator and worker sessions can retrieve the saved URL using `intercom_list`—no new dashboard tool or control. Open that URL in a local browser. The saved address can remain stale after shutdown or failure; it is not proof of reachability. Workers log metadata but do not start a dashboard. No browser opens automatically, and no agent controls, assignments or automatic recovery are added.
+The coordinator automatically checks for its monitor pane on startup inside Herdr. If missing, it creates a small pane **above the coordinator**, preserving coordinator focus. This is a standalone Node/pi-tui program, **not another Pi instance**. The old inline widget implementation has been removed. Source installations must run `npm run build` before reloading Pi; published packages include the compiled `dist/monitor.js` entry.
 
-The roster shows saved names/responsibilities/endpoints plus **last-observed** busy/idle, timestamp and age. Evidence older than 60 seconds is marked stale, never offline; missing evidence is unknown. The timeline refreshes approximately every three seconds and can be filtered by agent, event type and errors. Expand events for safe metadata/correlation, not prompt bodies. A disconnected dashboard retains old data with an explicit warning.
+The table uses aligned **Worker | Seen | Status | Report | Last activity** columns (activity detail gives way first on narrow panes). Report is explicitly worker-authored and separate from host activity. Status is the last reported `working`, `thinking`, `idle`, `closed`, or `unknown` state. Seen marks evidence older than 60 seconds with `(old)`; this is not a live connection indicator. Last activity uses fixed public labels such as Reading files, Running command or Writing response and can persist after the worker settles. Recent working/thinking/idle observations use restrained colors; old evidence remains neutral and explicitly marked. `NO_COLOR` disables styling. No read-only banner or busy/idle count summary is shown. It passively reads the same bounded config/log snapshot as the web dashboard about every three seconds, without worker prompts, probing or model calls. Only observed activity is shown, not inferred assignments/completion. Evidence over 60 seconds old is stale; missing evidence is unknown. The number of worker rows adapts to the pane height, with an omitted count when needed. The display is clipped to pane dimensions. In the monitor pane, use **↑/↓** to select a worker and **Enter** to toggle its details (configured responsibility and observed status). Selection follows the worker across roster reorder and scrolls the visible window. **Escape** closes details first, then quits; **q** or **Ctrl+C** always quits only the display process, never agents or their panes.
 
-Logs under `.pi-intercom/logs/` exclude message bodies and raw errors; roster responsibility text still comes from shared config, so do not put secrets there. `writerId` identifies an ephemeral log writer, not an agent; Pi session ID remains agent identity. Transport `correlationId` identifies one send attempt, not a task or completion. Logging is bounded/best effort and does not change HTTP receipt semantics or repair manual-compaction rejection. Never interpret a quiet timeline as completed work.
+Detailed phase reports require reloading participating Pi sessions. `thinking` is emitted only when the provider supplies thinking events; missing thinking events do not imply that no reasoning occurred. Streaming content, reasoning text, command arguments and tool outputs are never read or logged for status. Repeated streaming events are deduplicated; concurrent tools are tracked without recording their arguments. Legacy busy observations display as working without invented detail. No task completion is inferred from settlement.
 
-See [observability reference](references/observability.md) for privacy, rotation/retention limits, partial-error semantics and the HTTP boundary. This feature requires **version 0.2.0 or later**; update the package and reload each participating Pi session to activate it. The dashboard is not a durable inbox, replay log or task journal.
+The pane's display name is simply `Intercom monitor`. Ownership uses saved pane/workspace/coordinator identities in machine-local `.pi-intercom/monitor-*.json` records; the generic display name alone is never proof of ownership. Older session-bearing labels are migrated when their pane is identified. Reload reuses an existing pane without injecting commands into it; pane existence is not proof the monitor is running. If the owner closes the pane, a subsequent coordinator startup can create its replacement. If the monitor program exits but its pane remains, restart it explicitly in that shell: `node /absolute/package/path/dist/monitor.js --root /absolute/project/path`. Moved/ambiguous panes and partial launches require inspection, not blind duplicate creation. A crash can leave a launch lock/pending record: inspect Herdr's panes and these records before manually recovering them. No automatic pane cleanup, focus stealing, or retry is performed.
+
+Outside Herdr, messaging continues without a status pane. The browser dashboard is retired; no dashboard listener or browser assets are started/shipped in 0.4.1. A monitor or legacy-metadata cleanup failure does not disable messaging. Reload an older running coordinator to close its former dashboard listener. These features replace the browser dashboard from 0.3.0.
+
+### JSON worker status for agents and chat integrations
+
+`intercom_worker_status({})` returns a bounded JSON page of configured workers, or use `{ name: "Builder" }` for one worker. Each entry includes `observedStatus`, `lastActivity`, `observedAt`, `observationAgeSeconds`, `stale`, `evidence`, and an optional public `report` with its independent timestamp/age. Unknown ages/staleness are `null`; conflicting/future observations remain unknown, not healthy. A null report means no readable active report, not proof there are no blockers.
+
+The tool uses the **same observation interpretation as the terminal monitor**, reads local files only, and never prompts/probes workers. It has no Telegram dependency: an agent can read the JSON and use its existing chat tools to present a summary. `intercom_list` remains saved configuration; `intercom_request_status` remains an explicit asynchronous live status request.
+
+Results include `errors`, `truncated`, `totalInSnapshot`, and `nextOffset`. Use `{ offset: nextOffset }` until it is null. Default page size is 10; `limit` accepts 1–20, with an additional byte budget to keep JSON complete. The snapshot retains at most 256 configured agents; truncation and unavailable observations are explicit. No result is proof of current liveness, coordinator approval, or task completion.
+
+### Worker reports and decisions
+
+A configured worker that has loaded its responsibility can call `intercom_report_work`:
+
+```typescript
+intercom_report_work({ status: "blocked", summary: "The test database is unavailable; please provide a test environment or approve using a fixture." })
+intercom_report_work({ status: "needs_decision", summary: "Should the endpoint keep backward compatibility or adopt the new response format?" })
+intercom_report_work({ status: "ready_for_review", summary: "Updated the parser and added three edge-case tests; all pass. Please review before accepting the change." })
+intercom_report_work({ status: "clear" })
+```
+
+There is one latest report per worker. A new report replaces it; clear saves an empty tombstone and removes the report indicator. Summaries are explicitly public, non-secret text (up to 2000 characters). They are sent to the coordinator, may enter its conversation history, and are saved in machine-local `.pi-intercom/reports/`—not in the metadata logs. Do not include private reasoning, credentials or raw tool payloads.
+
+The coordinator validates the configured worker identity, saves the report, then submits a notification through the normal message path. Receipt does not prove the coordinator evaluated it. Reports do not automatically approve changes, assign follow-up work, resume a worker, or declare a task complete. Ready for review means **the worker is asking for review**, not that validation has been independently accepted.
+
+The monitor shows Report alongside observed Status. Enter opens the worker's current report, age and summary. Reports persist until replaced/cleared and may outlive a process restart; their timestamps are separate from activity age. Missing/unreadable reports show no report indicator, not proof there are no blockers. Removed workers' report files are not shown or automatically deleted. No automatic resend or recovery is added; if saving succeeds but notification fails, inspect the saved report before deciding whether to resend.
+
+Reload the coordinator and participating worker Pi sessions to register the tool and new wire handler. Older versions reject the new report kind rather than silently treating it as an ordinary message.
+
+## Local observation data
+
+The terminal monitor reads bounded metadata logs from `.pi-intercom/logs/` and names/responsibilities from shared configuration. It does not expose a web server. Logs exclude message bodies, reasoning text, tool payloads and raw errors. Keep sensitive information out of responsibility text.
+
+Observations remain best effort: an old record is not a current heartbeat, a quiet log is not task completion, and transport receipt is not proof that Pi accepted or acted on a message. See the [observability reference](references/observability.md) for privacy, retention, snapshot bounds and legacy-dashboard migration.
+
+The browser dashboard was part of published 0.2.x/0.3.0. Historical validation notes below refer to those releases, not the current terminal-only monitor.
 
 ## Development and validation
 
@@ -140,16 +234,34 @@ npm run check:package
 PI_INTERCOM_PI_ROOT='C:/path/to/pi-coding-agent' npm run test:host
 ```
 
-Production source runs through Pi's TypeScript loader; `npm run build` generates `dist` for tests. Pi core/typebox are peer dependencies, not bundled; pinned development copies are included in the lockfile for reproducible CI without local junctions.
+The extension source runs through Pi's TypeScript loader; `npm run build` generates `dist` for tests and the standalone terminal monitor. Build output is included in releases; the publish job builds it explicitly before publishing with scripts disabled. `npm run check:package` also installs the tarball in an isolated directory with peer installation disabled (matching Pi's managed npm installs), verifies the standalone monitor imports without host packages, and checks its non-TTY error path. This network-dependent regression runs on both CI platforms; it does not claim a live terminal/Herdr smoke test. Pi core/typebox are peer dependencies, not bundled; pinned development copies are included in the lockfile for reproducible CI without local junctions.
 
 ## Publishing
 
 [`.github/workflows/publish.yml`](https://github.com/comput-sh/pi-intercom/blob/main/.github/workflows/publish.yml) publishes through npm Trusted Publishing (GitHub OIDC), without an npm token secret. Configure the npm trusted publisher as owner `comput-sh`, repository `pi-intercom`, workflow `publish.yml`, with no environment.
 
-The workflow validates on Windows, then publishes with provenance from a GitHub-hosted Ubuntu runner. It runs when a GitHub release is published or when manually dispatched. Release tags must be `v<package.json version>`.
+The workflow validates on Windows and Linux, then publishes with provenance from a GitHub-hosted Ubuntu runner. It runs when a GitHub release is published or when manually dispatched. Release tags must be `v<package.json version>`.
 
 Published versions are immutable. For a new release, bump package and lockfile versions, commit/push, then publish a matching GitHub release. Manual dispatch publishes the selected ref and is **not a dry run**; the release-tag check only applies when a release tag is present. Do not dispatch publishing for an already published version. CI validates pushes to `main` and pull requests separately without publishing.
 
+### 0.4.2 Standalone monitor dependency fix
+
+- Install a pinned TUI runtime dependency for the standalone monitor, independent of Pi's host-provided extension peers. Fixes `ERR_MODULE_NOT_FOUND` after managed Pi installs that disable peer installation.
+- Add isolated tarball-install validation with peers disabled, module-import checks and the non-TTY CLI check to Windows/Linux package CI.
+- Require Node 22.19+ to match the monitor dependency. Config-root discovery is unchanged by this patch.
+- Upgrade the npm package, reload Pi sessions, and restart an existing monitor process to load the fix.
+
+### 0.4.1 Coordinator workspace
+
+The 0.4.0 GitHub release did not reach npm because a Windows-specific test expectation failed. 0.4.1 corrects that assertion without changing parser behavior; the 0.4.0 tag remains unchanged.
+
+- Standalone Herdr terminal monitor replaces the browser dashboard; automatic pane ownership/reuse, keyboard selection and worker details.
+- Explicit public worker reports: blocked, needs decision, ready for review and clear; no automatic approvals or assignments.
+- Read-only, paginated `intercom_worker_status` JSON shares observation interpretation with the monitor. No chat integration dependency.
+- Detailed public activity phases, bounded local snapshots and report storage, packaged monitor build output.
+- Typecheck and 112 tests passed locally. Stop/close remain disabled; no new cancellation guarantee.
+- Upgrade: update the package and reload coordinator/workers. Restart an existing standalone monitor to load new display code. Legacy dashboard metadata is migrated on coordinator startup.
+
 ### 0.3.0 Linux support
 
 - Interactive startup, messaging and dashboard support on Linux.

package/dist/activity.d.ts

@@ -0,0 +1,12 @@
+/** Public event categories only: never accept content, arguments, or results. */
+export type ActivityPhase = 'working' | 'thinking' | 'responding' | 'tool' | 'idle';
+export type ActivityDetail = 'processing' | 'thinking' | 'responding' | 'reading_files' | 'editing_files' | 'running_command' | 'using_tool' | 'multiple_tools' | 'settled';
+/** Stores only opaque active tool IDs, public categories, and the last emitted state. */
+export declare function createActivityTracker(record: (phase: ActivityPhase, detail: ActivityDetail) => void): {
+    start(): void;
+    settled(): void;
+    message(type: string): void;
+    toolStart(id: string, name: string): void;
+    toolEnd(id: string): void;
+    reset(): void;
+};

package/dist/activity.js

@@ -0,0 +1,73 @@
+function toolDetail(name) {
+    switch (name) {
+        case 'read': return 'reading_files';
+        case 'edit':
+        case 'write': return 'editing_files';
+        case 'bash':
+        case 'powershell': return 'running_command';
+        default: return 'using_tool';
+    }
+}
+/** Stores only opaque active tool IDs, public categories, and the last emitted state. */
+export function createActivityTracker(record) {
+    const tools = new Map();
+    let lastPhase;
+    let lastDetail;
+    function emit(phase, detail) {
+        if (lastPhase === phase && lastDetail === detail)
+            return;
+        lastPhase = phase;
+        lastDetail = detail;
+        record(phase, detail);
+    }
+    function emitTools() {
+        const detail = tools.size > 1 ? 'multiple_tools' : tools.values().next().value;
+        if (detail)
+            emit('tool', detail);
+    }
+    return {
+        start() {
+            tools.clear();
+            emit('working', 'processing');
+        },
+        settled() {
+            tools.clear();
+            emit('idle', 'settled');
+        },
+        message(type) {
+            if (tools.size)
+                return;
+            switch (type) {
+                case 'thinking_start':
+                case 'thinking_delta':
+                    emit('thinking', 'thinking');
+                    break;
+                case 'thinking_end':
+                    emit('working', 'processing');
+                    break;
+                case 'text_start':
+                case 'text_delta':
+                    emit('responding', 'responding');
+                    break;
+            }
+        },
+        toolStart(id, name) {
+            tools.set(id, toolDetail(name));
+            emitTools();
+        },
+        toolEnd(id) {
+            if (!tools.delete(id))
+                return;
+            if (tools.size)
+                emitTools();
+            else
+                emit('working', 'processing');
+        },
+        reset() {
+            tools.clear();
+            lastPhase = undefined;
+            lastDetail = undefined;
+        },
+    };
+}
+//# sourceMappingURL=activity.js.map

package/dist/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAKA,SAAS,UAAU,CAAC,IAAY;IAC9B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,OAAO,eAAe,CAAC;QACpC,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC,CAAC,OAAO,eAAe,CAAC;QACrC,KAAK,MAAM,CAAC;QACZ,KAAK,YAAY,CAAC,CAAC,OAAO,iBAAiB,CAAC;QAC5C,OAAO,CAAC,CAAC,OAAO,YAAY,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,qBAAqB,CAAC,MAA8D;IAClG,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAChD,IAAI,SAAoC,CAAC;IACzC,IAAI,UAAsC,CAAC;IAC3C,SAAS,IAAI,CAAC,KAAoB,EAAE,MAAsB;QACxD,IAAI,SAAS,KAAK,KAAK,IAAI,UAAU,KAAK,MAAM;YAAE,OAAO;QACzD,SAAS,GAAG,KAAK,CAAC;QAClB,UAAU,GAAG,MAAM,CAAC;QACpB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxB,CAAC;IACD,SAAS,SAAS;QAChB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC/E,IAAI,MAAM;YAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,OAAO;QACL,KAAK;YACH,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAChC,CAAC;QACD,OAAO;YACL,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,CAAC,IAAY;YAClB,IAAI,KAAK,CAAC,IAAI;gBAAE,OAAO;YACvB,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,gBAAgB,CAAC;gBACtB,KAAK,gBAAgB;oBAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;oBAAC,MAAM;gBAC3D,KAAK,cAAc;oBAAE,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;oBAAC,MAAM;gBAC1D,KAAK,YAAY,CAAC;gBAClB,KAAK,YAAY;oBAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;oBAAC,MAAM;YAC7D,CAAC;QACH,CAAC;QACD,SAAS,CAAC,EAAU,EAAE,IAAY;YAChC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;YAChC,SAAS,EAAE,CAAC;QACd,CAAC;QACD,OAAO,CAAC,EAAU;YAChB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBAAE,OAAO;YAC9B,IAAI,KAAK,CAAC,IAAI;gBAAE,SAAS,EAAE,CAAC;;gBACvB,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACrC,CAAC;QACD,KAAK;YACH,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,SAAS,GAAG,SAAS,CAAC;YACtB,UAAU,GAAG,SAAS,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,39 @@
+export interface Agent {
+    sessionId: string;
+    name: string;
+    coordinator: boolean;
+    description: string;
+    port: number;
+    /** Legacy browser dashboard field, accepted for migration only; removed at coordinator startup. */
+    dashboardPort?: number;
+    projectDirectory: string;
+}
+export interface Config {
+    version: 1;
+    multiplexer: 'herdr' | 'none';
+    agents: Agent[];
+}
+export declare const DEFAULT_DESCRIPTION = "Coordinate workers, delegate work, and manage shared configuration.";
+export declare const key: (name: string) => string;
+export declare function fail(message: string): never;
+export declare function text(value: unknown, field: string, max?: number): asserts value is string;
+export declare function port(value: unknown): asserts value is number;
+export declare function relativeDirectory(value: unknown): asserts value is string;
+export declare function validateConfig(value: unknown): Config;
+export declare const coordinator: (c: Config) => Agent;
+export declare function named(c: Config, name: string): Agent;
+export declare function requireCoordinator(c: Config, id: string): Agent;
+export declare function directory(root: string, requested: string): Promise<string>;
+export declare class ConfigStore {
+    readonly root: string;
+    readonly file: string;
+    private tail;
+    constructor(root: string);
+    read(): Promise<Config>;
+    static discover(cwd: string): Promise<ConfigStore | undefined>;
+    protected openTemporary(file: string): Promise<import("fs/promises").FileHandle>;
+    private temporary;
+    initialize(id: string, boundPort: number, assertValid?: () => void): Promise<boolean>;
+    update(id: string, mutate: (config: Config) => void | Promise<void>, assertValid?: () => void): Promise<Config>;
+    configure(id: string, values: Omit<Agent, 'coordinator'>, assertValid?: () => void): Promise<Config>;
+}

package/dist/config.js

@@ -0,0 +1,182 @@
+import { mkdir, readFile, realpath, rename, unlink, open, link, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+export const DEFAULT_DESCRIPTION = 'Coordinate workers, delegate work, and manage shared configuration.';
+export const key = (name) => name.toLowerCase();
+export function fail(message) { throw new Error(`PiIntercom: ${message}`); }
+export function text(value, field, max = 4096) {
+    if (typeof value !== 'string' || !value.trim() || value.length > max || value.includes('\0'))
+        fail(`invalid ${field}`);
+}
+export function port(value) {
+    if (!Number.isInteger(value) || Number(value) < 1 || Number(value) > 65535)
+        fail('invalid port');
+}
+export function relativeDirectory(value) {
+    text(value, 'projectDirectory');
+    if (path.isAbsolute(value) || path.win32.isAbsolute(value) || value.split(/[\\/]/).includes('..'))
+        fail('projectDirectory must be root-relative, without ..');
+}
+export function validateConfig(value) {
+    const c = value;
+    if (!c || c.version !== 1 || !['herdr', 'none'].includes(c.multiplexer) || !Array.isArray(c.agents))
+        fail('invalid config schema/version');
+    const names = new Set(), ids = new Set();
+    for (const a of c.agents) {
+        if (!a || typeof a.coordinator !== 'boolean')
+            fail('invalid agent');
+        text(a.sessionId, 'sessionId', 256);
+        text(a.name, 'name', 128);
+        text(a.description, 'description');
+        if (a.name !== a.name.trim() || /[\r\n\x00-\x1f]/.test(a.name))
+            fail('invalid name');
+        port(a.port);
+        relativeDirectory(a.projectDirectory);
+        if (a.dashboardPort !== undefined) {
+            if (!a.coordinator)
+                fail('dashboardPort is coordinator-only');
+            port(a.dashboardPort);
+        }
+        if (names.has(key(a.name)) || ids.has(a.sessionId))
+            fail('duplicate name or session ID');
+        names.add(key(a.name));
+        ids.add(a.sessionId);
+        if (a.coordinator ? (a.name !== 'Coordinator' || a.projectDirectory !== '.') : key(a.name) === 'coordinator')
+            fail('reserved Coordinator identity');
+    }
+    if (c.agents.filter(a => a.coordinator).length !== 1)
+        fail('config requires exactly one coordinator');
+    return c;
+}
+export const coordinator = (c) => c.agents.find(a => a.coordinator);
+export function named(c, name) {
+    text(name, 'to', 128);
+    return c.agents.find(a => key(a.name) === key(name)) ?? fail(`unknown recipient ${name}`);
+}
+export function requireCoordinator(c, id) {
+    const a = c.agents.find(a => a.sessionId === id);
+    return a?.coordinator ? a : fail('coordinator permission required');
+}
+export async function directory(root, requested) {
+    text(requested, 'projectDirectory');
+    const base = await realpath(root), target = await realpath(path.resolve(root, requested));
+    const rel = path.relative(base, target);
+    if (rel === '..' || rel.startsWith(`..${path.sep}`) || path.isAbsolute(rel))
+        fail('project directory must be coordinator root or descendant (including symlinks)');
+    if (!(await stat(target)).isDirectory())
+        fail('projectDirectory is not a directory');
+    return rel.split(path.sep).join('/') || '.';
+}
+export class ConfigStore {
+    root;
+    file;
+    tail = Promise.resolve();
+    constructor(root) {
+        this.root = root;
+        this.file = path.join(root, '.pi-intercom', 'config.json');
+    }
+    async read() {
+        // Missing, malformed and unreadable files propagate; never overwrite them.
+        return validateConfig(JSON.parse(await readFile(this.file, 'utf8')));
+    }
+    static async discover(cwd) {
+        let at = path.resolve(cwd);
+        for (;;) {
+            const store = new ConfigStore(at);
+            try {
+                await store.read();
+                return store;
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+            const parent = path.dirname(at);
+            if (parent === at)
+                return undefined;
+            at = parent;
+        }
+    }
+    openTemporary(file) { return open(file, 'wx'); }
+    async temporary(config) {
+        validateConfig(config);
+        await mkdir(path.dirname(this.file), { recursive: true });
+        const temp = `${this.file}.${randomUUID()}.tmp`;
+        const handle = await this.openTemporary(temp);
+        try {
+            await handle.writeFile(JSON.stringify(config, null, 2) + '\n');
+            await handle.sync();
+            await handle.close();
+            return temp;
+        }
+        catch (error) {
+            // Cleanup failures must not replace the original write/sync/close error.
+            await handle.close().catch(() => { });
+            await unlink(temp).catch(() => { });
+            throw error;
+        }
+    }
+    async initialize(id, boundPort, assertValid = () => { }) {
+        // Publish an already complete file using an atomic, no-replace hard link.
+        // Losers only ever see complete JSON; unsupported filesystems fail explicitly.
+        assertValid();
+        const temp = await this.temporary({ version: 1, multiplexer: 'herdr', agents: [{ sessionId: id, name: 'Coordinator', coordinator: true, description: DEFAULT_DESCRIPTION, port: boundPort, projectDirectory: '.' }] });
+        try {
+            assertValid();
+            try {
+                await link(temp, this.file);
+            }
+            catch (e) {
+                if (e.code !== 'EEXIST')
+                    throw e;
+                await this.read();
+                await unlink(temp);
+                return false;
+            }
+            await unlink(temp);
+            return true;
+        }
+        catch (error) {
+            await unlink(temp).catch(() => { });
+            throw error;
+        }
+    }
+    async update(id, mutate, assertValid = () => { }) {
+        const operation = this.tail.then(async () => {
+            assertValid();
+            const c = await this.read();
+            assertValid();
+            requireCoordinator(c, id);
+            await mutate(c);
+            assertValid();
+            validateConfig(c);
+            const temp = await this.temporary(c);
+            try {
+                // Last check before publication; an already submitted OS rename cannot be undone.
+                assertValid();
+                await rename(temp, this.file);
+            }
+            catch (error) {
+                await unlink(temp).catch(() => { });
+                throw error;
+            }
+            return c;
+        });
+        this.tail = operation.catch(() => { });
+        return operation;
+    }
+    async configure(id, values, assertValid = () => { }) {
+        return this.update(id, async (c) => {
+            if (values.sessionId === coordinator(c).sessionId)
+                fail('cannot configure coordinator as worker');
+            const projectDirectory = await directory(this.root, values.projectDirectory);
+            const a = { sessionId: values.sessionId, name: values.name, description: values.description, port: values.port, projectDirectory, coordinator: false };
+            const index = c.agents.findIndex(old => old.sessionId === a.sessionId);
+            if (index < 0)
+                c.agents.push(a);
+            else
+                c.agents[index] = a;
+        }, assertValid);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { type ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export declare function resumeSessionDirectory(cwd: string, envSessionDir?: string | undefined, agentDir?: string): string | undefined;
+export default function intercomExtension(pi: ExtensionAPI): void;