@narumitw/pi-subagents 3.4.0 → 3.4.2

package/docs/messaging.md

@@ -4,6 +4,8 @@ Main and child processes have separate `subagent_send` definitions. The main age
 
 ## Delivery and waiting
 
+Child requests, responses, and terminal completions use Pi steering while the main agent is running. If it is idle, they start a new model turn. A completion does not require a pending `subagent_wait` call.
+
 A main-originated request to a queued job waits for the child RPC prompt to be accepted, then uses Pi steering to reach the running child. After RPC accepts steering, the runtime interrupts active child response waits without consuming their original requests. The child may retry `subagent_wait` for a response it still needs.
 
 Caller cancellation before RPC delivery starts rolls the request back. Once delivery starts, cancellation stops only the caller's wait: the request may still arrive and remains answerable until delivery fails or the job terminates. A wait timeout likewise stops only that wait, not the job or the underlying message request.
@@ -16,7 +18,7 @@ Each job may have up to four unresolved or answered-but-not-consumed requests ac
 
 A job starts `queued`, becomes `running`, and reaches exactly one terminal state: `completed`, `partial`, `failed`, `timed_out`, or `cancelled`. Job execution timeouts start after Pi accepts the RPC prompt. The runtime retains up to 32 recent terminal records for up to 24 hours in the current extension session; inspection reports removed records through `omitted.jobs`.
 
-Cancelling or terminalizing a job revokes its communication token and rejects pending child waits before stale output can replace the terminal state. Session replacement and shutdown cancel active work, suppress stale completion delivery, revoke credentials, close sockets, and stop the broker. An asynchronous job completion does not wake an otherwise idle main-agent model turn.
+Cancelling or terminalizing a job revokes its communication token and rejects pending child waits before stale output can replace the terminal state. Session replacement and shutdown cancel active work, suppress stale completion delivery, revoke credentials, close sockets, and stop the broker.
 
 The session starts one loopback TCP broker on `127.0.0.1` with an ephemeral port. Each job receives a random token bound to its job identity and session generation. The parent passes credentials through a private inherited pipe rather than the child's initial environment or command line. Child broker calls use request-scoped connections; response waits use abortable long polling.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@narumitw/pi-subagents",
-  "version": "3.4.0",
+  "version": "3.4.2",
   "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,9 +40,9 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "1.4.0",
-    "@earendil-works/pi-coding-agent": "1.4.0",
-    "@earendil-works/pi-tui": "1.4.0",
+    "@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.5",
     "esbuild": "0.28.2",
     "typebox": "1.4.3",
@@ -53,7 +54,7 @@
     "directory": "packages/pi-subagents"
   },
   "dependencies": {
-    "@narumitw/pi-tui-kit": "^0.68.0",
-    "ignore": "^7.0.13"
+    "@narumitw/pi-tui-kit": "^0.69.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/runtime.ts

@@ -437,7 +437,7 @@ export class SubagentRuntime {
           display: true,
           details: payload,
         },
-        { deliverAs: "steer" },
+        { deliverAs: "steer", triggerTurn: true },
       );
     } catch {
       // Completion remains available through wait; inspect continues to report status.

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)" })),
   },