pi-squire 0.20.1 → 0.20.2

package/CHANGELOG.md

@@ -6,6 +6,103 @@ follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.20.2] - 2026-11-04
+
+### Removed
+
+- The `/delegates` panel and its alt+shift+d shortcut are removed. Manage open
+  delegates in the compact widget, use `/delegate-open` for switch or peek,
+  `/delegate` for new tasks, and `/delegate-resume` for follow-ups. Panel-only
+  tests are deleted; remaining navigation, close, and resume tests now drive
+  those public entry points. README and older panel descriptions are removed.
+
+### Changed
+
+- Running delegate widget rows now show a fixed `working...` secondary line,
+  independent of live activity telemetry; finished rows show no secondary line.
+  Updated behavior assertions in `test/widget-activity.test.ts`,
+  `test/widget-activity-navigation.test.ts`, `test/widget-activity-runtime.test.ts`,
+  `test/widget-ancestors.test.ts`, and `test/widget-nesting-final.test.ts` to expect
+  the fixed indicator while retaining separate live-reader checks.
+- Trusted Pi sessions in this checkout allow the exact `pnpm lint`,
+  `pnpm typecheck`, `pnpm test`, and `pnpm check` commands without a permission
+  dialog or auto-mode judge call.
+- Idle compact widgets use one server-wide pane listing per refresh instead of
+  inspecting each delegate pane. Sessions publish their pane locator once at
+  startup, and activity reads use `kill(pid, 0)` without spawning `ps`.
+  Breadcrumbs refresh on Results changes or every 30 seconds, and widget tree
+  reads no longer wait for the writer lock. Enter and peek still verify the
+  owner and the current pane at action time, including after window renames,
+  moves, joins, or breaks.
+  Deliberate test changes:
+  - `test/widget-activity-runtime.test.ts` replaces "locator ticks keep observing
+    without unchanged rewrites, publish rename/move/clear and reset per
+    session/generation" with "locator publishes once per session generation and
+    idle ticks spawn no pane probes". Idle ticks leave the startup snapshot alone.
+  - `test/widget-live.test.ts` replaces "pid reuse, unknown probe,
+    malformed/oversized/generation-mismatched files fail closed" with "live pid
+    ignores legacy start token; unknown probe and
+    malformed/oversized/generation-mismatched files fail closed". A live PID's
+    obsolete start token no longer removes its snapshot. "startup probe failure
+    is unavailable; early stop cancels delayed initialization" becomes "stop
+    before flush cancels publication without process initialization" because
+    publishers no longer run a process-start probe.
+  - `test/widget-ancestor-process.test.ts` replaces "actual processes: root
+    without launch/registry publishes, leaf switches directly, current pane
+    names/moves and server mismatches fail closed" with "actual processes:
+    startup pane locator follows names/moves at navigation time and server
+    mismatches fail closed". Navigation resolves current names and windows from
+    the stable pane instead of waiting for another publication.
+  - `test/widget-ancestor-real.test.ts` updates "real private tmux:
+    attached-client root switch, exact pane/server scope, rename and moved-window
+    reattachment" to expect an unchanged startup snapshot after rename or break.
+  - `test/widget.test.ts` updates "shutdown while a window read is pending cannot
+    resurrect a widget" and "cap zero and terminal-only history stop overview
+    tmux reads" to observe pane listings instead of window listings.
+  - `test/widget-current.test.ts` updates "current child lookup does zero
+    locator/inspect work for unavailable/empty windows and no current candidates"
+    and "cap0 and no-candidate Overview refreshes never inspect/locate children
+    independently of the publisher" to use the shared pane listing.
+- Child compact widgets replace ancestor rows and the `Delegates` header with one
+  breadcrumb ending in `(you)`. Enter on it switches to the direct parent; x
+  refuses close, and Left and Right do nothing. Children use the base indent,
+  and the two-column selection gutter stays fixed. Root widgets keep their
+  `Delegates` header. Names omit their own nonempty agent prefix, and transcript
+  ages say `active` instead of `file`. Deliberate frame and navigation expectation
+  changes are in `test/widget-ancestors.test.ts`, `test/widget.test.ts`,
+  `test/widget-data.test.ts`, `test/widget-navigation.test.ts`,
+  `test/widget-activity-navigation.test.ts`, `test/widget-nesting06.test.ts`, and
+  `test/widget-nesting-final.test.ts`.
+- The compact widget keeps its two-column selection gutter while unfocused, so
+  focusing the list no longer shifts the tree right. `test/widget-ancestors.test.ts`
+  and `test/widget.test.ts` now expect the indented unfocused rows; the first and checks that focusing keeps every
+  row in its column.
+- `delegation_close` records the close without posting a cancellation message or
+  waking the model. UI closes still wake the model. The tool close regression in
+  `test/tools.test.ts` now expects silence, and the stopped-root cancellation test
+  in `test/subtree-close.test.ts` uses the UI close path to retain its wake check.
+- Browse open delegate descendants in the compact widget with Right to expand
+  or enter a branch and Left to collapse or return to its parent. Right does
+  nothing on a childless row, Left on any nested row returns to its parent, and
+  ancestors ignore both. A collapsed row shows its open-descendant
+  count as +N instead of a task-count secondary line. Leaving the list collapses
+  all branches. Enter and confirmed x work at every depth. Widget tests now pin
+  collapsed counts, tree keyboard behavior, and mixed-depth overflow wording;
+  obsolete task-summary tests are removed.
+- Press x in the focused compact widget to close the selected subtree. The widget
+  always asks for confirmation, including finished delegates, in plainer words
+  ("Close <name> and its delegates? Worktrees and branches stay."); the close
+  confirmation tests in `test/navigator-current.test.ts`, `test/widget-navigation.test.ts`
+  and `test/widget-nesting-final.test.ts` expect them. Ancestor rows
+  refuse close and omit x from their hint. New keyboard tests cover cancellation,
+  finished and running closes, and ancestor refusal.
+- Enter in the focused compact delegate widget switches straight to the selected
+  delegate's verified tmux window. A dim hint explains how to focus the list;
+  focused hints show the selected row's keys. Widget navigation and rendering
+  tests now expect direct switching instead of the details panel. Ancestor and
+  activity layout tests include the new hint; the nested widget test replaces
+  removed branch-detail browsing with a direct switch assertion.
+
 ## [0.20.1] - 2026-11-02
 
 ### Changed
@@ -29,8 +126,8 @@ follows [Semantic Versioning](https://semver.org/).
   test increases from 10,000 to 12,000 characters to cover the fifth tool.
   Managed forks report their cwd, branch, base and uncopied changes, and their
   prompt directs them away from the original checkout; non-isolated forks warn
-  about sharing a folder with a running source. Dashboard details show the
-  source id, foreign callers get an explicit direct-parent refusal, and the
+  about sharing a folder with a running source. Foreign callers get an explicit
+  direct-parent refusal, and the
   fork tool declares its destructive-operation hint.
 
 ## [0.19.1] - 2026-11-02
@@ -49,10 +146,10 @@ follows [Semantic Versioning](https://semver.org/).
 ### Changed
 
 - **Breaking:** Pi 1.5.0 or later is now required. Delegate result expand hints use Pi's
-  configured keybinding, and the inline delegate dashboard and new-delegate
-  settings form report that Pi is waiting for a choice. The render tests now
+  configured keybinding, and the new-delegate settings form reports that Pi is
+  waiting for a choice. The render tests now
   require the configured key in the hint instead of accepting a missing key;
-  dashboard and form tests pin their blocked-input status. The active-tools
+  form tests pin its blocked-input status. The active-tools
   test fake now preserves retained tools' order, matching Pi 1.5.
 
 ## [0.18.4] - 2026-11-02
@@ -157,7 +254,7 @@ follows [Semantic Versioning](https://semver.org/).
   partial failures return `isError:true` with details rather than discarding
   successful members in a thrown tmux error. Close requires a readable shared
   fence before kills. Old single-window wording/schema, direct-close-on-corrupt-
-  registry, panel/poll/placement text assertions deliberately change; local
+  registry, poll and placement text assertions deliberately change; local
   genuine result publication remains warning-only. Unknown/foreign/obsolete
   target ids refuse before effects. Canceling unfinished children now requires
   direct-parent processing rather than silently releasing the task barrier.
@@ -185,44 +282,17 @@ follows [Semantic Versioning](https://semver.org/).
 
 ### Changed
 
-- Complete branch-focused widget entry in the same dashboard: initial details
-  retain their Escape-to-compact-list behavior, while `b` opens only the selected
-  branch's descendant/resume history and worker details return to that list.
-  Overall `/delegates` stays scoped to the invoking session's whole subtree.
-  Root close-all remains explicitly all root subtrees, not only displayed rows.
-- Dashboard switch/peek and `/delegate-open` now reuse positively verified
+- `/delegate-open` now reuses positively verified
   current pane/server/owner locators for reattached latest sessions, without
   rewriting historical launch/result facts or changing close authority.
   A lost or replaced current locator never falls back to an old still-open
-  window; peek captures the exact verified Pi pane. Details distinguish launch
-  and current windows and reflect native session titles and actual outcomes.
+  window; peek captures the exact verified Pi pane.
   Verified live latest rows remain navigable even before historical disappearance
   is polled. Closing live navigation rows confirms the separate durable control
   scope; telemetry never retargets a kill, and reattached windows may remain open.
   Post-switch ownership loss reports the completed switch honestly.
-  Add `test/navigator-current.test.ts`, extend `test/dashboard.test.ts` and
-  `test/widget-nesting-final.test.ts` for deliberate branch-list behavior,
-  current-window races, title composition and direct-parent resume refusal.
-- Compose the shared widget/dashboard actions with context-aware subtree close:
-  selected close reports aggregate partial errors, and the root retains confirmed
-  `a` close-all from the same dashboard, including empty/history views. Keep
-  direct-widget activity/focus and direct-parent resume checks unchanged; no
-  second panel or row-by-row close authority. Add combined coverage in
-  `test/widget-nesting-final.test.ts` and root action intent coverage in
-  `test/dashboard.test.ts`; extend `test/dashboard-actions.test.ts` control stubs.
-- Make the direct-delegate widget keyboard-navigable and reuse one dashboard for
-  widget Enter, `/delegates` and its shortcut. Down at an empty built-in prompt
-  selects children; stable selection scrolls through the cap. Enter opens details,
-  and Escape returns to list then prompt. Dashboard list Enter now opens details
-  before a second Enter switches (a deliberate navigation change); peek, close,
-  new and authorized resume remain behind existing action/ownership checks.
-  Custom editors, autocomplete, dialogs and unknown focus pass through unchanged.
-  The isolated Pi-internals adapter was tested with installed Pi 1.4.0 in both
-  regular and fullscreen modes; no Pi change or editor/footer replacement.
-  Protect the empty prompt while a widget-opened dashboard is loading or
-  re-listing between actions, without intercepting real dashboard/dialog input.
-  Update `test/navigator.test.ts` for the deliberate two-Enter details/switch
-  flow and `test/tree-restore.test.ts` to inspect metadata in details.
+  Add `test/navigator-current.test.ts` for current-window races and extend
+  `test/widget-nesting-final.test.ts` for direct-parent resume refusal.
 - The interactive direct-delegate overview deliberately replaces only Squire’s
   running-count entry when its cap is positive, preserving custom footers/editors
   and the own-delegate badge. Cap zero and non-TUI hosts retain the running count.
@@ -277,7 +347,7 @@ follows [Semantic Versioning](https://semver.org/).
   Consumers can observe ordinary reopen and runtime replacement without
   treating launch environment variables as identity authority.
 
-- Explicit ancestor-scoped subtree close and root-only confirmed panel close-all.
+- Explicit ancestor-scoped subtree close.
   Shared admission/own-entry dispatch fences precede effects, including root
   reservations. Already-dispatched unknown creates remain charged/fenced and
   partial; bounded explicit retries never guess no-start. Current verified
@@ -408,12 +478,6 @@ follows [Semantic Versioning](https://semver.org/).
   retaining root/depth, live-session/obsolete-chain protections and current
   grants, caps, tool ceiling and trust resolver. Fork/clone copies are history,
   not authority; inherited launch environment no longer assigns identity.
-- Deliberately change the delegates panel to retain hierarchical history and
-  details rather than only open windows; only verified windows support
-  navigation. Descendant close stays with the separate explicit-close slice.
-  Reattachment tests now reopen the same id after shutdown rather than copying
-  starts into a fresh/live duplicate session. Root outcomes retain processing
-  durability with a non-displaying recovery wake instead of a repeated final.
 
 - Keep durable local result/gone delivery, coordinator wakes and close tracking
   working when shared fact publication fails; warn and reconcile those saved
@@ -523,7 +587,7 @@ follows [Semantic Versioning](https://semver.org/).
   each resolving to one model; a `*` pattern makes the file invalid, so the
   agent is disabled. A body may be empty.
 - New agent fields: `display_name` (shown on the delegate card, in
-  `/delegates` and in the window title; it may hold only ASCII letters,
+  the compact widget and in the window title; it may hold only ASCII letters,
   digits, `-` and `_`, and any other value, a space, `#`, `.`, a non-ASCII
   letter or an empty value among them, makes the file invalid, so the agent is
   disabled), `enabled: false` (leaves the agent
@@ -575,21 +639,18 @@ follows [Semantic Versioning](https://semver.org/).
 
 ### Removed
 
-- The delegate popup: `enter` in `/delegates` and `/delegate-open --popup` no
-  longer open a tmux popup, and the popup title from 0.13.1 (the close key in
+- `/delegate-open --popup` no longer opens a tmux popup, and the popup title from 0.13.1 (the close key in
   its title) goes with it. `--popup` is now an unknown-flag usage error. The
   poll runs again only while a delegation is running. The close hint was hard to
   see in some themes, and a switch covers the need.
 
 ### Changed
 
-- `enter` in the `/delegates` panel, and in its peek, now switches your tmux
-  client to the delegate's window (the notice says your tmux last-session key returns you); `/delegate-open
-  <id>` with no flag switches too. The `s` key is gone. With no client attached,
+- `/delegate-open <id>` with no flag switches your tmux client to the delegate's
+  window. The switch notice says your tmux last-session key returns you. The `s` key is gone. With no client attached,
   switch still refuses; peek and close still work. tmux 3.2 stays the minimum,
   for `new-session -e`.
-- Tests changed with it: in `test/navigator.test.ts` the panel hint, `enter`,
-  peek, no-client, failure, `/delegate-open` parsing, default and completion
+- Tests changed with it: in `test/navigator.test.ts` peek, no-client, failure, `/delegate-open` parsing, default and completion
   tests now expect a switch, and the popup lifecycle tests are replaced by one
   test that the poll runs only while a delegation does; `test/tmux.test.ts` no
   longer tests `popup` and `closePopup`, and `test/popup-parent.ts` and the
@@ -618,14 +679,6 @@ follows [Semantic Versioning](https://semver.org/).
 
 ### Added
 
-- `/delegates`, also on `alt+shift+d`, opens a panel of the delegations whose
-  window is open (newest first): `enter` opens one in a tmux popup, or switches
-  to it when it is in your own session; `p` peeks at its pane in an overlay (`r` refreshes,
-  `enter` opens); `s` switches your client to it; `x` closes it, asking only
-  while it runs; `n` opens the new-delegate form. `/delegate-open <id> [--popup|--switch|--peek]` does one of
-  these directly. Popup and switch act on the most recently active client of the
-  parent's session; the parent closes a popup once its delegate's window is gone.
-  Commands and a shortcut only: the model gets no new tool.
 - `/delegate` with no arguments opens a new-delegate form: pick an agent, write
   the task, name it, then a settings screen for model, thinking level (only the
   levels the model supports, clamped, visibly, when the agent's default or a new model does not support it), auto-exit,
@@ -1121,7 +1174,8 @@ author's dotfiles; the changes below are against that copy.
 
 - The published file list includes `child.ts`, which `index.ts` imports.
 
-[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.20.1...HEAD
+[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.20.2...HEAD
+[0.20.2]: https://github.com/gvanderclay/pi-squire/compare/v0.20.1...v0.20.2
 [0.20.1]: https://github.com/gvanderclay/pi-squire/compare/v0.20.0...v0.20.1
 [0.20.0]: https://github.com/gvanderclay/pi-squire/compare/v0.19.1...v0.20.0
 [0.19.1]: https://github.com/gvanderclay/pi-squire/compare/v0.19.0...v0.19.1

package/README.md

@@ -327,7 +327,7 @@ Fresh sessions neither adopt nor report earlier trees. Each session sees only
 its own tree; to collect the delegates of a session you closed, reopen that
 exact session, which restores its full tree.
 
-Both `delegation_status` and `/delegates` show descendants: a root sees its tree;
+Both `delegation_status` and the compact widget show descendants: a root sees its tree;
 a coordinator sees only its own subtree, not siblings or unrelated roots.
 Hierarchy uses stable Pi session ids, not the new delegation id of a resume.
 Parent/root/depth, launch/result/session paths, workspaces, current verified
@@ -460,20 +460,15 @@ transcript-file age appear when space permits: model is
 dropped first, then file age, before identity/state are compressed. At very
 narrow widths the state glyph remains beside the truncated identity.
 `file … ago` is only a last-active hint from transcript mtime, not live tool
-activity. When available, a second line shows factual live activity (below).
-Each coordinator row summarizes **all descendant tasks**, at every depth,
-including tasks whose windows have exited. Counts are per delegation/launch id,
-not per stable session: a failed task and its resumed successor both count, so
-a retry cannot erase a known failure. Actual replies supply done/failed/stopped;
-saved gone/closed-without-result tasks count as missing. Shared registry
-finished/closed/closing flags are not successful replies or proof another
-parent processed an outcome. Missing parent facts or tree coverage are labeled
-unknown/partial/unavailable, never all done. Summary and activity share one
-secondary line; when both do not fit, the task summary wins.
+activity. Each running row has a second line showing `working...`, regardless
+of live telemetry; finished rows have no second line.
+A collapsed delegate with open descendants shows **+N** at the end of its row.
+This counts open stable sessions, not historical attempts or results.
 
 Delegates also see their ancestors vertically, root to direct parent, with the
 direct parent marked `(parent)` (including `root (parent)`). A connected
-**Delegates** branch contains only the current session's direct children.
+**Delegates** branch starts with the current session's direct children and
+expands to show their open descendants.
 There is no current-session row or empty child heading; leaves show ancestors
 only. Ancestor rows and secondary lines do not consume child-entry slots.
 
@@ -489,8 +484,8 @@ Configure it in the existing `<agent dir>/squire/settings.json`, alongside
 
 - `delegateWidgetPlacement`: `above` (default) or `below` the editor.
 - `delegateWidgetMaxEntries`: nonnegative safe integer, default **3**. Each
-  direct child consumes one slot. `+N more direct delegates` counts hidden
-  eligible direct children, not descendants. **0** hides child rows and restores
+  visible delegate consumes one slot, at any expanded depth. `+N more delegates`
+  counts eligible rows beyond the viewport. **0** hides child rows and restores
   Squire's running-count footer while preserving ancestor rows/navigation;
   zero children never produce an empty heading.
 - These preferences apply equally to roots and coordinators. Interactive views
@@ -498,8 +493,8 @@ Configure it in the existing `<agent dir>/squire/settings.json`, alongside
   distinct error and use the defaults without changing task state.
 
 Launch/result/close changes refresh promptly; an independent one-second observer
-keeps finished-open rows, window eligibility and later native title changes
-fresh even when the result poll has stopped. Only visible rows resolve titles and
+keeps finished-open rows, descendant membership, window eligibility, and later
+native title changes fresh even when the result poll has stopped. Only visible rows resolve titles and
 file metadata and live activity; overflow counts still include every eligible child. Closed/gone-only
 history without a live reattached session does not keep the observer listing
 windows. A positively reopened gone coordinator may appear at its current window
@@ -517,9 +512,9 @@ over that mirror: an external picker rename may differ temporarily from the
 child's own in-memory name. Files are read incrementally, with bounded work per
 refresh; very large existing transcripts may take several refreshes to catch up.
 
-### Factual live activity
+### Live activity telemetry
 
-The secondary line follows actual Pi tool-execution events: `reading…`,
+The internal feed follows actual Pi tool-execution events: `reading…`,
 `editing…`, `writing…`, `command call…`, or `using <tool name>…`. Parallel
 and nested calls are tracked by their actual call ids, not by tool name.
 Active nested calls take precedence over their orchestrator. A tool start is
@@ -528,9 +523,9 @@ call, not proof that a subprocess started or permission was granted. Squire
 does not inspect commands to guess intent, or display arguments, paths, tool
 results, thinking or provider payloads.
 
-Otherwise, while an assistant response streams, `response: …` shows a literal
-single-line excerpt bounded to 512 UTF-8 bytes. It clears when that message
-ends; a quick response may finish between refreshes and never appear. Calls
+Otherwise, while an assistant response streams, the feed holds a literal
+single-line excerpt bounded to 512 UTF-8 bytes. These details are not shown in
+the widget. The excerpt clears when that message ends. Calls
 clear on matching end, run end/settlement, stop, reload and shutdown. Known
 task results/close suppress activity even if a delegate's last snapshot remains.
 A settled or silent coordinator can still own unfinished child tasks: activity
@@ -549,34 +544,36 @@ calls. Publication requires positive Squire ownership at startup; later factual
 end/settlement observation continues even if task-owner processing fails or its
 record becomes unreadable, without re-enabling actions. Event publishing works
 in non-TUI delegates and with the list hidden.
-One child-entry slot may occupy two physical lines; there is no empty secondary
-line or tool-use counter.
+One running child-entry slot occupies two physical lines; there is no empty
+secondary line or tool-use counter.
 
 ### Navigation
 
 At an **empty built-in prompt**, press **Down** to select the direct parent in a
 delegate session, or the first child at root. Up/Down traverse ancestors and
-eligible children in display order; only children scroll within the configured cap;
-hidden-above/below counts refer to direct children. Selection follows stable
-session identity through renames, reordering and resumes. Enter opens that
-child's details in the **same dashboard** as /delegates, scoped to that child's
-branch (including descendant and resume history, not its siblings). Press **b**
-for the branch list to select and inspect its workers. Initial details Escape
-returns directly to the compact list; details opened from the branch list return
-to that branch list first. Branch-list Escape returns to the compact list, then
-Escape again returns to the prompt; Up past the first compact row also leaves
-the list. A short hint appears only while the list owns these keys.
-Typing or any unrelated key leaves list navigation and passes that key through.
-While a widget-opened dashboard is loading or re-listing between actions, keys
-are absorbed only if the exact empty built-in prompt still owns focus: Escape
-cannot abort a run and action letters cannot leak into that prompt. Once a
-real dashboard, dialog, completion menu or unknown component owns input, its
-keys pass through normally.
-Cap zero never creates invisible selectable children; ancestors remain selectable
-and /delegates still works.
+open delegates in display order. Only delegate rows scroll within the configured
+cap. Selection follows stable session identity through renames, reordering and
+resumes. Enter switches directly to the selected delegate's verified tmux window.
+Press **x** to close its recorded subtree. Every close asks for confirmation,
+including finished delegates. Ancestors cannot be closed.
+
+Right expands a delegate with children. Right again selects its first child.
+Left collapses an expanded delegate; on a collapsed child with children, Left
+selects its parent. Ancestors and childless rows ignore Left and Right.
+Collapsed delegates show **+N** open descendants at the end of their row.
+Esc, typing, or Up past the first row returns focus to the prompt and collapses
+every branch. Typing passes the key through to the prompt.
+
+A dim **↓ to manage delegates** hint appears when the widget is not focused.
+Focused hints show the selected row's valid actions, including expand or
+collapse when applicable. Cap zero never creates invisible selectable
+delegates; ancestors remain selectable.
+
+Pending actions absorb keys only while the exact empty built-in prompt still
+owns focus. Dialogs, completion menus, and unknown components keep their keys.
 
 Enter on an ancestor switches directly to its verified **current live tmux
-window**, not to the dashboard or a historical launch window. Root and leaf
+window**, not to a historical launch window. Root and leaf
 processes publish their own positive pane/window observation in the same
 disposable generation snapshot used for activity. The reader checks the elected
 exact-session owner, process incarnation, tmux server socket/PID/start identity,
@@ -602,54 +599,25 @@ It relies on **Pi TUI internals**, isolated in a small compatibility adapter:
 the concrete focus getter and exact built-in editor identity. Compatibility was
 tested with the installed **Pi 1.4.0 bundled CLI**, including regular/fullscreen
 mode changes. Unknown focus/editor/completion capabilities disable key capture
-rather than guessing; /delegates remains available. This is not a generic
+rather than guessing; `/delegate-open` remains available. This is not a generic
 custom-editor integration or a supported Pi focus hook. JSON/RPC hosts retain
 the running-count status rather than receiving a terminal widget.
 
 ## Reaching delegates
 
-Delegate windows sit out of your way, so reach them from the parent. `/delegates`
-(or `alt+shift+d`) opens the same dashboard used by widget Enter, at the overall
-view of its descendant hierarchy, including
-closed/history rows. Parents precede their children; resume history stays
-visible. Each row shows stable launch identity, the available current native Pi
-title, agent display label, semantic state/outcome and verified window availability.
-Enter opens selected details with identities, paths, result envelope, workspace
-and resume information. Historical launch windows are labeled separately from
-current verified windows. Lists and details scroll within the available screen.
-Widget entry uses the same screen for only its selected branch; `b` exposes that
-branch's list without widening its scope. A title change never changes routing.
-Metadata is refreshed when opening/reopening the screen after an action; the
-compact overview remains the live activity/summary view.
-Only a verified live window supports switch/peek; the model has no
-tool that moves the terminal. Any ancestor can explicitly close a selected
-subtree. The root also has a confirmed close-all action; shared companion names
-never grant control over another root.
-
-| Key | Does |
-|---|---|
-| `↑` / `↓` | select a delegation in the list; scroll in details |
-| `enter` | open selected details; from details, switch your tmux client to its verified window |
-| `esc` | details → overall list → prompt; initial widget details → compact list; branch-list details → branch list → compact list |
-| `b` | widget entry only: show the selected branch list, preserving its target and history |
-| `p` | peek: a snapshot of the window's pane (`capture-pane`) in an overlay; `r` refreshes, `enter` switches, `esc` returns to the list |
-| `x` | explicitly close the selected subtree as `delegation_close` does; confirms running work and verified live navigation rows |
-| `a` | root only: confirm closing **all root** descendant subtrees, including absent coordinators, even when viewing one branch |
-| `r` | resume the selected eligible direct child, collecting a follow-up through the existing resume flow; descendants without authority are refused |
-| `n` | new child of the invoking session, not of the selected remote row: the same form `/delegate` opens with no arguments (see [First use](#first-use)) |
+Use the compact widget to switch to a delegate or close its subtree.
+Use `/delegate-open <id> [--switch|--peek]` to reach one delegate by id.
+With no flag or with `--switch`, it switches your tmux client to that delegate's
+verified window. `--peek` opens a pane snapshot in an overlay, where `r`
+refreshes, Enter switches, and Esc returns to the prompt. Ids complete from the
+open delegations. The model has no tool that moves your terminal.
 
 Switch acts on the most recently active tmux client attached to the parent's
 session. With none attached it refuses with a notice; peek and close still
-work. No tmux key bindings or options are added.
+work. No tmux key bindings or options are added. To return, use your own tmux
+last-session key, which defaults to `prefix L`. The switch notice reminds you.
 
-To come back, use your own tmux last-session key (tmux's default is `prefix L`,
-often rebound); the notice after a switch says so.
-
-`/delegate-open <id> [--switch|--peek]` does one of these on one delegation
-without the panel: with no flag or with `--switch`, it switches; `--peek` opens
-the peek overlay. Ids complete from the open delegations.
-
-Dashboard switch/peek and `/delegate-open` share current-locator verification.
+The compact widget and `/delegate-open` share current-locator verification.
 For the latest known launch of a stable session, a positively observed current
 runtime supersedes its old launch window; a later lost/changed locator refuses
 rather than falling back to an old still-open window. Exact Pi pane liveness
@@ -933,7 +901,7 @@ optional, and the [first-use example](#first-use) is a complete agent file:
 | Field | Meaning |
 | --- | --- |
 | `description` | Shown in the roster and the `delegate` tool's description. Defaults to the name. |
-| `display_name` | Shown instead of the name on the delegate card, in `/delegates` and in the window title (`<display_name>-<label>`). The agent is still called by its name. It may hold only ASCII letters, digits, `-` and `_`; any other value (a space, `#`, `.`, a non-ASCII letter, or an empty value) makes the file invalid, so the agent is disabled. |
+| `display_name` | Shown instead of the name on the delegate card, in the compact widget and in the window title (`<display_name>-<label>`). The agent is still called by its name. It may hold only ASCII letters, digits, `-` and `_`; any other value (a space, `#`, `.`, a non-ASCII letter, or an empty value) makes the file invalid, so the agent is disabled. |
 | `model` | One model: `provider/id` or an alias such as `sonnet`, passed to the child's `--model` unchanged, so Pi resolves it to one model. A `*` pattern makes the file invalid. Absent means the parent session's current model. |
 | `thinking` | `off`, `minimal`, `low`, `medium`, `high`, `xhigh` or `max`. Absent means the parent session's level; an unknown value is dropped with a warning and the parent's level applies. Pi clamps the level to the model. |
 | `tools` | The delegate's tools (see below): tool names and `$bundle` entries for exactly those, or only `-name` entries for the parent session's current tools less those. Absent means the parent session's current tools; empty (`tools:` or `tools: []`) means no tools except the `delegateTools` setting. MCP tools follow the selection like any other. |
@@ -1250,12 +1218,11 @@ even when no delegation is recorded. The details gain a `marks` array of
 
 ## Explicit subtree close
 
-`delegation_close` and the `/delegates` close actions enumerate persistent
+`delegation_close` and the compact widget close action enumerate persistent
 records and close the selected session and all its descendants, including work
 whose coordinator is offline. Any ancestor may close; unrelated trees, siblings
-outside the selected subtree and user windows remain untouched. Only the root
-has the panel's `a` close-all action. Close-all fences new root admissions too;
-neither action kills a companion tmux session wholesale.
+outside the selected subtree and user windows remain untouched. Neither action
+kills a companion tmux session wholesale.
 
 Admission is fenced under the shared tree lock **before** window effects.
 Already-reserved pre-dispatch launches cannot dispatch; an already-dispatched
@@ -1969,7 +1936,7 @@ contract.
 
 The automated tests drive the extension through fake Pi lifecycles. The
 reusable `test/mail-harness.ts` runs multiple independent extension instances
-with the real, exactly pinned pi-session-mail 0.6.0 over an isolated shared
+with the real, exactly pinned pi-session-mail 0.7.1 over an isolated shared
 mail root. Protocol tests cover correlation, asks, stops, fallback, pending
 answers, retries and duplicate delivery after the write/completion crash
 window. These are not real model runs or real process-crash tests. They check
@@ -2009,8 +1976,7 @@ Other extensions may rely on:
 - the `/delegate` and `/delegate-resume` syntax and flags, and their
   no-argument forms: `/delegate` opens the new-delegate form and
   `/delegate-resume` the resume picker;
-- the `/delegates` command and its `alt+shift+d` shortcut, and `/delegate-open <id>` with its
-  `--switch` and `--peek` flags;
+- `/delegate-open <id>` with its `--switch` and `--peek` flags;
 - the `[delegate]` result text and the closed-without-a-result text;
 - the agent file's frontmatter keys and its locations,
   `<agent dir>/agents/<name>.md` and, in a trusted project,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-squire",
-	"version": "0.20.1",
+	"version": "0.20.2",
 	"description": "Starts a delegate Pi session in a background tmux window, sends it the task over message:*, and shows the parent its result",
 	"keywords": [
 		"pi-package",
@@ -55,7 +55,7 @@
 		"@earendil-works/pi-coding-agent": "1.5.0",
 		"@earendil-works/pi-tui": "1.5.0",
 		"@types/node": "26.6.5",
-		"pi-session-mail": "0.6.0",
+		"pi-session-mail": "0.7.1",
 		"typebox": "1.4.3",
 		"typescript": "7.0.2"
 	}

package/src/agents.ts

@@ -50,7 +50,7 @@ const DISPLAY_NAME = /^[A-Za-z0-9_-]+$/;
 
 export type Agent = {
 	name: string;
-	/** Shown instead of the name on the delegate card, `/delegates` and the window title; from `display_name`, `[A-Za-z0-9_-]+`. */
+	/** Shown instead of the name on the delegate card, compact widget and window title; from `display_name`, `[A-Za-z0-9_-]+`. */
 	displayName?: string;
 	description: string;
 	/** Passed to the child's `--model` unchanged; undefined means the parent's model. */

package/src/index.ts

@@ -758,10 +758,11 @@ export default function delegate(
 		pi,
 		results,
 		tmux,
-		async (ctx, sessionId) => {
+		async (ctx, id) => {
 			owner.assert();
-			await navigator.panel(ctx, sessionId);
+			await navigator.openDelegate(ctx, id, "switch");
 		},
+		(ctx, id) => navigator.closeDelegate(ctx, id),
 		() => owner.assert(),
 	);
 
@@ -1449,7 +1450,7 @@ export default function delegate(
 		}
 	}
 
-	/** What the new-delegate form needs, shared by `/delegate` and the panel's `n`. */
+	/** What the no-argument `/delegate` form needs. */
 	const newDelegateDeps: NewDelegateDeps = {
 		unavailable: () => (tmux.insideTmux() ? undefined : NOT_IN_TMUX),
 		roster: rosterFor,
@@ -1703,26 +1704,9 @@ export default function delegate(
 		handler: resumeCommand,
 	});
 
-	const navigator = createNavigator(
-		viewResults,
-		tmux,
-		tracking,
-		(ctx: ExtensionContext) => startNewDelegate(ctx, newDelegateDeps),
-		{
-			assertActive: () => owner.assert(),
-			close: (id, ctx) => tracking.close(id, ctx),
-			resume: (id, ctx) => resumePicker(ctx, id),
-		},
-	);
-
-	pi.registerCommand("delegates", {
-		description: "Open the shared delegate dashboard: details, switch, peek, close, resume",
-		handler: async (_args: string, ctx: ExtensionContext) => navigator.panel(ctx),
-	});
-
-	pi.registerShortcut("alt+shift+d", {
-		description: "Open the delegates panel",
-		handler: (ctx: ExtensionContext) => navigator.panel(ctx),
+	const navigator = createNavigator(viewResults, tmux, tracking, {
+		assertActive: () => owner.assert(),
+		close: (id, ctx) => tracking.close(id, ctx),
 	});
 
 	pi.registerCommand("delegate-open", {