@narumitw/pi-subagents 3.4.1 → 3.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@narumitw/pi-subagents",
-  "version": "3.4.1",
+  "version": "3.4.3",
   "description": "Subagent jobs with asynchronous main-agent messaging for Pi.",
   "type": "module",
   "license": "MIT",
@@ -18,6 +18,7 @@
     "dist",
     "docs",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "pi": {
@@ -39,12 +40,12 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "1.4.0",
-    "@earendil-works/pi-coding-agent": "1.4.0",
-    "@earendil-works/pi-tui": "1.4.0",
-    "@types/node": "26.6.5",
+    "@earendil-works/pi-ai": "1.5.0",
+    "@earendil-works/pi-coding-agent": "1.5.0",
+    "@earendil-works/pi-tui": "1.5.0",
+    "@types/node": "26.6.6",
     "esbuild": "0.28.2",
-    "typebox": "1.4.3",
+    "typebox": "1.4.4",
     "typescript": "7.0.2"
   },
   "repository": {
@@ -53,7 +54,7 @@
     "directory": "packages/pi-subagents"
   },
   "dependencies": {
-    "@narumitw/pi-tui-kit": "^0.68.0",
+    "@narumitw/pi-tui-kit": "^0.70.0",
     "ignore": "^7.0.14"
   }
 }

package/src/message-renderers.ts

@@ -1,4 +1,4 @@
-import { type ExtensionAPI, getMarkdownTheme, keyText } from "@earendil-works/pi-coding-agent";
+import { type ExtensionAPI, getMarkdownTheme } from "@earendil-works/pi-coding-agent";
 import { Box, type Component, Markdown, Spacer, Text } from "@earendil-works/pi-tui";
 import { sanitizeTerminalText } from "./message-broker.js";
 
@@ -31,15 +31,9 @@ export function registerMessageRenderers(pi: ExtensionAPI): void {
         new Spacer(1),
       ];
       if (!options.expanded) {
-        children.push(
-          new Text(
-            theme.fg("customMessageText", `${summary} (`) +
-              theme.fg("dim", keyText("app.tools.expand")) +
-              theme.fg("customMessageText", " to expand)"),
-            0,
-            0,
-          ),
-        );
+        const expansionKey = options.keyText?.("app.tools.expand");
+        const hint = expansionKey ? theme.fg("muted", ` (${expansionKey} to expand)`) : "";
+        children.push(new Text(theme.fg("customMessageText", summary) + hint, 0, 0));
       } else {
         const content =
           typeof message.content === "string"

package/src/settings-ui.ts

@@ -127,6 +127,9 @@ export async function showSubagentSettings(
         () => complete("back"),
       );
       return {
+        get capturesViewportInput() {
+          return list.capturesViewportInput;
+        },
         render(width: number) {
           if (!current()) complete("stale");
           renderedWidth = Number.isFinite(width) ? Math.max(0, Math.floor(width)) : 0;

package/src/tools.ts

@@ -60,9 +60,11 @@ const SpawnParameters = Type.Object(
     ),
     tools: Type.Optional(
       Type.Array(
-        StringEnum(CHILD_CORE_TOOL_NAMES, {
-          description: "Available Pi core child work tool name.",
-        }),
+        Type.Unsafe<(typeof CHILD_CORE_TOOL_NAMES)[number]>(
+          StringEnum(CHILD_CORE_TOOL_NAMES, {
+            description: "Available Pi core child work tool name.",
+          }),
+        ),
         {
           description: "Child work tools. Defaults to read, grep, find, and ls. Communication tools are always added.",
           maxItems: MAX_TOOLS,
@@ -114,9 +116,11 @@ const SpawnParameters = Type.Object(
       ),
     ),
     thinkingLevel: Type.Optional(
-      StringEnum(SUBAGENT_THINKING_LEVELS, {
-        description: "Child thinking level. Defaults to the main agent's effective level.",
-      }),
+      Type.Unsafe<SubagentThinkingLevel>(
+        StringEnum(SUBAGENT_THINKING_LEVELS, {
+          description: "Child thinking level. Defaults to the main agent's effective level.",
+        }),
+      ),
     ),
     timeout: Type.Optional(Type.Number({ description: "Timeout in seconds (optional, no default timeout)" })),
   },

package/src/widget-renderer.ts

@@ -25,15 +25,46 @@ export function subagentWidgetRowBudget(rows: number): number {
     : 0;
 }
 
+export function subagentWidgetSummary(snapshot: SubagentWidgetSnapshot, maxRows: number): string {
+  const { jobs, items, mode } = snapshot;
+  const budget = normalizeRowBudget(maxRows);
+  if (!isVisible(snapshot) || budget === 0) return "";
+  // Compact mode intentionally has no job rows; only removed jobs are omitted.
+  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 · ${jobs.length - running} queued`;
+  return `${counts}${omitted > 0 ? ` · ${omitted} not shown${removed > 0 ? ` (${removed} removed)` : ""}` : ""}`;
+}
+
+function normalizeRowBudget(maxRows: number): number {
+  return Number.isFinite(maxRows) ? Math.max(0, Math.floor(maxRows)) : 0;
+}
+
+function isVisible({ jobs, items, settings, mode }: SubagentWidgetSnapshot): boolean {
+  return settings.showWidget && mode !== "hidden" && jobs.length > 0 && items.length > 0;
+}
+
 export function renderSubagentWidgetSnapshot(
   snapshot: SubagentWidgetSnapshot,
   theme: Theme,
   width: number,
   maxRows: number,
+  includeHeader = true,
 ): string[] {
   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 [];
+  // Named TUI publishers put the counts in the divider, not in a body heading.
+  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 · ${jobs.length} active · ${running} running · ${jobs.length - running} queued`;
   const removed = jobs.length - items.length;

package/src/widget.ts

@@ -17,6 +17,7 @@ import {
   renderSubagentWidgetSnapshot,
   type SubagentWidgetSnapshot,
   subagentWidgetRowBudget,
+  subagentWidgetSummary,
 } from "./widget-renderer.js";
 
 export { renderSubagentWidget } from "./widget-renderer.js";
@@ -175,10 +176,12 @@ export function createSubagentWidgetController(runtime: SubagentRuntime): Subage
         view = createEditorStatusView({ onChange: publish, canCompact: () => settings.showWidget && jobs.length > 0 });
         publisher = createEditorStatusPublisher({
           key: SUBAGENT_WIDGET_KEY,
+          name: "Subagents",
           context: ctx,
           isCurrent,
+          summary: (snapshot, _width, rows) => subagentWidgetSummary(snapshot, subagentWidgetRowBudget(rows)),
           render: (snapshot, theme, width, rows) =>
-            renderSubagentWidgetSnapshot(snapshot, theme, width, subagentWidgetRowBudget(rows)),
+            renderSubagentWidgetSnapshot(snapshot, theme, width, subagentWidgetRowBudget(rows), false),
         });
         // The owner records public preparation/run hooks while settings load.
         // General busy state also includes navigation and manual compaction.
@@ -189,7 +192,9 @@ export function createSubagentWidgetController(runtime: SubagentRuntime): Subage
         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);