@narumitw/pi-subagents 3.4.2 → 3.4.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @narumitw/pi-subagents
 
+## 3.4.3
+
+### Patch Changes
+
+- cf7b63d: Put editor widget names and short current count/state summaries in their divider lines. Remove duplicate body titles while retaining safety text, detail rows, privacy modes, and standalone RPC/tool output. In fullscreen Pi, click anywhere in a widget to collapse it to one named line, then click that line to restore the latest content. Preserve independent, session-local disclosure through updates without taking editor focus, changing domain data, or stopping background work. Existing owner controls provide keyboard restoration; regular-mode mouse input remains terminal-owned.
+  
+  The Kit minor release supplies the named widget state and publisher disclosure APIs. Changesets raises all adopting consumers' Kit dependency floors in the same Version PR. Publish and verify the exact Kit artifact before its consumers.
+- Updated dependencies [cf7b63d]
+  - @narumitw/pi-tui-kit@0.70.0
+
 ## 3.4.2
 
 ### Patch Changes

package/README.md

@@ -22,18 +22,19 @@ Pi Subagents runs Pi jobs in separate child processes and supports authenticated
 
 ## 📦 Install
 
-The version 3 runtime documented here is not yet published to npm.
-The npm package still contains the legacy 2.x runtime and does not provide the tools below.
-
-Install the repository source as one Pi package:
+Install from npm:
 
 ```bash
-pi install git:github.com/narumiruna/pi-extensions
+pi install npm:@narumitw/pi-subagents
 ```
 
-This Git installation enables every extension listed in the repository root manifest, including Pi Subagents.
+Try it for one invocation:
 
-To install only Pi Subagents, clone the repository, install dependencies, build its generated runtime, and install its package directory:
+```bash
+pi -e npm:@narumitw/pi-subagents
+```
+
+To install from a local checkout, clone the repository, install dependencies, build its generated runtime, and install its package directory:
 
 ```bash
 git clone https://github.com/narumiruna/pi-extensions.git
@@ -94,7 +95,7 @@ The widget is TUI-only and contains only queued or running jobs. Each row starts
 For example, with a main-agent thinking level of `high` at spawn:
 
 ```text
-Subagents · 2 active
+─ ▾ Subagents · 1 running · 1 queued ───────
 ▶ Review widget tests · 12s
 ○ Audit settings · thinking: medium · queued
 ```
@@ -107,9 +108,13 @@ The task preview removes terminal controls, collapses whitespace, and uses at mo
 Task text is visible in this local widget, but `subagent_inspect` continues to omit it. Optional tool names include selected core and extension tools, not fixed communication tools.
 The widget omits attachment paths and resource totals, disappears when no jobs remain active, and clears when the session ends.
 
+The separator shows **Subagents** and current running and queued counts, including while collapsed. In fullscreen TUI mode, click anywhere in the widget, including blank columns, to collapse it to that separator. Click the separator to restore the latest jobs without moving keyboard focus.
+Disclosure survives job updates, temporary absence, and host remounts. Select a visible view in `/subagents` to restore disclosure with the keyboard. Session start and tree navigation reset it.
+Collapse does not change jobs, settings, item views, pins, or automatic rules.
+
 Ordinary updates refresh the mounted widget without changing its position among other widgets. Hiding and showing it again can change that position.
 The widget uses at most ten rows, including one separator, and reserves eight terminal rows for the editor and footer. This is a local height limit, not a calculation of space left by other widgets.
-With fewer than two available rows it renders nothing. Short layouts use a summary with active, running, queued, and omitted-row counts. Narrow layouts clip each line to the terminal width.
+With no available rows it renders nothing. One available row shows only the separator with current counts and omitted-row information. Summary view also uses only the separator, but does not count its intentionally absent job rows as omitted. Narrow layouts clip each line to the terminal width.
 
 In `/subagents`, **Widget view** provides details, summary, hide/show, pin/unpin, automatic compaction, and item-view reset controls.
 These controls are session-local and do not write settings. Manual hide remains in effect across job changes until you show the widget again.

package/dist/index.ts

@@ -2663,10 +2663,34 @@ var SUBAGENT_WIDGET_MAX_ROWS = 10;
 function subagentWidgetRowBudget(rows) {
   return Number.isFinite(rows) ? Math.min(SUBAGENT_WIDGET_MAX_ROWS, Math.max(0, Math.floor(rows) - SUBAGENT_WIDGET_RESERVED_ROWS)) : 0;
 }
-function renderSubagentWidgetSnapshot(snapshot, theme, width, maxRows) {
+function subagentWidgetSummary(snapshot, maxRows) {
+  const { jobs, items, mode } = snapshot;
+  const budget = normalizeRowBudget(maxRows);
+  if (!isVisible(snapshot) || budget === 0) return "";
+  const shown = mode === "compact" ? items.length : Math.min(items.length, budget - 1);
+  const omitted = jobs.length - shown;
+  const removed = jobs.length - items.length;
+  const running = jobs.filter((job) => job.state === "running").length;
+  const counts = `${running} running \xB7 ${jobs.length - running} queued`;
+  return `${counts}${omitted > 0 ? ` \xB7 ${omitted} not shown${removed > 0 ? ` (${removed} removed)` : ""}` : ""}`;
+}
+function normalizeRowBudget(maxRows) {
+  return Number.isFinite(maxRows) ? Math.max(0, Math.floor(maxRows)) : 0;
+}
+function isVisible({ jobs, items, settings, mode }) {
+  return settings.showWidget && mode !== "hidden" && jobs.length > 0 && items.length > 0;
+}
+function renderSubagentWidgetSnapshot(snapshot, theme, width, maxRows, includeHeader = true) {
   const { jobs, items, settings, mode } = snapshot;
-  const budget = Number.isFinite(maxRows) ? Math.max(0, Math.floor(maxRows)) : 0;
-  if (!settings.showWidget || mode === "hidden" || jobs.length === 0 || items.length === 0 || budget < 2) return [];
+  const budget = normalizeRowBudget(maxRows);
+  if (!isVisible(snapshot) || budget < (includeHeader ? 2 : 1)) return [];
+  if (!includeHeader) {
+    const shown = mode === "compact" ? [] : items.slice(0, budget - 1);
+    return new EditorStatusWidget({
+      theme,
+      renderBody: () => shown.map(({ value, mode: itemMode }) => renderJob(value, theme, settings, itemMode === "compact"))
+    }).render(width);
+  }
   const running = jobs.filter((job) => job.state === "running").length;
   const counts = `Subagents \xB7 ${jobs.length} active \xB7 ${running} running \xB7 ${jobs.length - running} queued`;
   const removed = jobs.length - items.length;
@@ -2842,9 +2866,11 @@ function createSubagentWidgetController(runtime) {
         view = createEditorStatusView({ onChange: publish, canCompact: () => settings.showWidget && jobs.length > 0 });
         publisher = createEditorStatusPublisher({
           key: SUBAGENT_WIDGET_KEY,
+          name: "Subagents",
           context: ctx,
           isCurrent,
-          render: (snapshot, theme, width, rows) => renderSubagentWidgetSnapshot(snapshot, theme, width, subagentWidgetRowBudget(rows))
+          summary: (snapshot, _width, rows) => subagentWidgetSummary(snapshot, subagentWidgetRowBudget(rows)),
+          render: (snapshot, theme, width, rows) => renderSubagentWidgetSnapshot(snapshot, theme, width, subagentWidgetRowBudget(rows), false)
         });
         if (phase === "maintenance") cyclePhase = phase;
         else if (phase !== "idle") startCycle(phase);
@@ -2853,7 +2879,9 @@ function createSubagentWidgetController(runtime) {
         controls = {
           state: () => ({ mode: ownedView.mode, pinned: ownedView.pinned, trigger: ownedView.trigger }),
           setMode: (mode) => {
-            if (isCurrent()) ownedView.setMode(mode);
+            if (!isCurrent()) return;
+            if (mode !== "hidden") publisher?.setCollapsed(false);
+            ownedView.setMode(mode);
           },
           setPinned: (pinned) => {
             if (isCurrent()) ownedView.setPinned(pinned);