@narumitw/pi-subagents 3.1.1 → 3.2.1

package/README.md

@@ -62,6 +62,12 @@ Call `subagent_spawn` with a self-contained task and only the work tools that ta
 The call returns a `jobId` immediately, and the job continues in the background.
 Continue useful main-agent work until the result is required or a completion arrives.
 
+In TUI mode, each active-job row shows a preview of its existing `task` after the job ID; no new parameter is required.
+The preview removes terminal controls, collapses whitespace, and uses at most 40 terminal columns, including an ellipsis when shortened.
+It describes the assigned task, not live child activity; the full task sent to the child is unchanged.
+Task text is visible in this local widget, but `subagent_inspect` continues to omit it.
+Rows are clipped to the available terminal width, so trailing state, timing, or tools can be hidden on narrow terminals.
+
 Use messaging only when needed:
 
 - Call `subagent_send` with `recipient: jobId` to ask an active child a question.
@@ -125,7 +131,7 @@ The package intentionally registers and publishes no skill; the repository-only
 ```ts
 {
   task: string;
-  tools?: Array<"read" | "bash" | "powershell" | "edit" | "write" | "grep" | "find" | "ls">;
+  tools?: Array<"read" | "bash" | "powershell" | "edit" | "write" | "grep" | "find" | "ls" | "codemode">;
   skills?: string[];
   extensions?: Array<{ path: string; tools: string[] }>;
   thinkingLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
@@ -133,11 +139,17 @@ The package intentionally registers and publishes no skill; the repository-only
 }
 ```
 
-The optional `tools` list selects Pi core work tools.
+The optional `tools` list selects Pi core work tools and the built-in `codemode` tool.
 Omitting it selects `read`, `grep`, `find`, and `ls`, while an empty list gives the child no core work tools.
 The runtime always adds `subagent_send` and child `subagent_wait` and removes duplicate names.
 Adding `edit` or `write` lets the child modify files, while `bash` or `powershell` grants unrestricted command execution.
 
+Add `"codemode"` explicitly to let the child run JavaScript that calls its selected tools and communication tools, including parallel calls and output filtering.
+For example, `tools: ["read", "grep", "codemode"]` enables scripted read and search operations without shell or file-mutation tools.
+The runtime loads Pi's built-in codemode extension and verifies tool readiness before sending the task; it does not enable automatic extension or MCP discovery.
+Codemode follows Pi's effective `codemode` settings and also provides Pi's `models` API for classifier and image calls using child-visible credentials.
+Those model calls can send data to providers and incur costs.
+
 The optional `skills` list attaches local Pi skills through progressive disclosure without injecting their full bodies or adding tools.
 Every attached skill path must contain at least one loadable skill, every non-ignored declared skill must load successfully, and skill names must be unique across attachments.
 

package/dist/index.ts

@@ -156,6 +156,7 @@ function buildPiArgs(request) {
     "-e",
     childCommunicationBridgePath()
   ];
+  if (request.tools.includes("codemode")) args.push("-e", "builtin:codemode");
   for (const extension of request.extensions) args.push("-e", extension.path);
   if (requiresReadinessAttestation(request)) args.push("-e", childReadinessProbePath());
   for (const skill of request.skills) args.push("--skill", skill);
@@ -202,7 +203,7 @@ function childReadinessProbePath() {
   return fileURLToPath(new URL("./child-readiness-probe.ts", import.meta.url));
 }
 function requiresReadinessAttestation(request) {
-  return request.extensions.length > 0;
+  return request.tools.includes("codemode") || request.extensions.length > 0;
 }
 function selectedChildTools(request) {
   return [
@@ -1200,7 +1201,17 @@ var TERMINAL_JOB_STATES = /* @__PURE__ */ new Set([
   "timed_out",
   "cancelled"
 ]);
-var CHILD_CORE_TOOL_NAMES = ["read", "bash", "powershell", "edit", "write", "grep", "find", "ls"];
+var CHILD_CORE_TOOL_NAMES = [
+  "read",
+  "bash",
+  "powershell",
+  "edit",
+  "write",
+  "grep",
+  "find",
+  "ls",
+  "codemode"
+];
 var DEFAULT_SUBAGENT_TOOLS = ["read", "grep", "find", "ls"];
 var SUBAGENT_THINKING_LEVELS = [
   "off",
@@ -1762,6 +1773,7 @@ var SubagentRuntime = class {
     const now = this.now();
     return [...this.jobs.values()].filter((job) => !isTerminal(job.state)).sort((left, right) => left.createdAt - right.createdAt).map((job) => ({
       jobId: job.jobId,
+      task: job.taskText,
       state: job.state,
       elapsedMs: Math.max(0, now - (job.startedAt ?? job.createdAt)),
       ...job.timeout !== void 0 ? { timeout: job.timeout } : {},
@@ -1803,6 +1815,7 @@ var SubagentRuntime = class {
       ...input.timeout !== void 0 ? { timeout: input.timeout } : {},
       controller,
       tools: effectiveTools,
+      taskText: input.task,
       terminal,
       resolveTerminal,
       controlReady,
@@ -2282,7 +2295,7 @@ function registerSubagentTools(pi, dependencies = {}) {
       if (ctx.cwd !== cwd || ctx.isProjectTrusted() !== projectTrusted) {
         throw new Error("Subagent spawn context changed during attachment validation; retry the request.");
       }
-      if (attachments.extensions.length > 0) {
+      if (tools.includes("codemode") || attachments.extensions.length > 0) {
         assertChildBootstrapCapacity([.../* @__PURE__ */ new Set([...attachments.effectiveTools, ...CHILD_COMMUNICATION_TOOL_NAMES])]);
       }
       const model = resolveChildModel(ctx, attachments.extensions.length > 0);
@@ -2518,10 +2531,11 @@ function toolResult(value) {
 }
 
 // src/widget.ts
-import { truncateToWidth } from "@earendil-works/pi-tui";
+import { stripTerminalSequences, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 var SUBAGENT_WIDGET_KEY = "subagents";
 var SUBAGENT_WIDGET_REFRESH_INTERVAL_MS = 1e3;
 var WIDGET_OPTIONS = { placement: "aboveEditor" };
+var TASK_PREVIEW_WIDTH = 40;
 function createSubagentWidgetController(runtime) {
   let activeSession;
   let refreshTimer;
@@ -2590,19 +2604,30 @@ function renderJob(job, theme) {
   const symbol = theme.fg(running ? "accent" : "dim", running ? "\u25B6 " : "\u25CB ");
   const state = theme.fg(running ? "accent" : "muted", job.state);
   const jobId = sanitizeLabel(job.jobId);
+  const taskText = sanitizeTask(job.task);
+  const task = stripTerminalSequences(truncateToWidth(taskText, TASK_PREVIEW_WIDTH, "\u2026"));
+  const preview = visibleWidth(task) > 0 ? ` \xB7 ${theme.fg("text", task)}` : "";
   const tools = job.tools.length > 0 ? job.tools.map(sanitizeLabel).join(", ") : "none";
   const timeout = job.timeout === void 0 ? "no timeout" : formatSeconds(job.timeout);
   const detail = ` \xB7 ${formatSeconds(Math.floor(job.elapsedMs / 1e3))} / ${timeout} \xB7 tools: ${tools}`;
-  return `${symbol}${theme.fg("text", jobId)} \xB7 ${state}${theme.fg("muted", detail)}`;
+  return `${symbol}${theme.fg("text", jobId)}${preview} \xB7 ${state}${theme.fg("muted", detail)}`;
 }
 function widgetValue(jobs) {
   return jobs.map(
-    (job) => `${job.jobId}\0${job.state}\0${Math.floor(job.elapsedMs / 1e3)}\0${job.timeout ?? ""}\0${job.tools.join(",")}`
+    (job) => `${job.jobId}\0${job.task}\0${job.state}\0${Math.floor(job.elapsedMs / 1e3)}\0${job.timeout ?? ""}\0${job.tools.join(",")}`
   ).join("\n");
 }
 function cloneDisplayJob(job) {
   return { ...job, tools: [...job.tools] };
 }
+function sanitizeTask(value) {
+  const text = value.replace(
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: Remove untrusted terminal escape sequences before display.
+    /(?:\u001b\[|\u009b)[0-?]*[ -/]*[@-~]|(?:\u001b[\]PX^_]|[\u0090\u0098\u009d-\u009f])[^\u0007\u001b\u0080-\u009f]*(?:\u0007|\u001b\\|\u009c)|\u001b[ -/]*[0-~]/gu,
+    ""
+  );
+  return sanitizeLabel(text.replace(/\p{Bidi_Control}/gu, ""));
+}
 function sanitizeLabel(value) {
   return sanitizeTerminalText(value).replace(/\s+/gu, " ").trim();
 }