@jerryan/pi-subagent-tools 0.3.0 → 0.4.0

package/index.ts

@@ -1,19 +1,19 @@
-/**
- * pi-subagent-tools — Specialized subagent delegation for pi
- *
- * Registers four tools for the "agent as project manager" workflow:
- *   review    — Read-only code review in the current project
- *   explore   — Read-only exploration of external projects (requires cwd)
- *   delegate  — General-purpose worker with full tool access
- *   follow_up — Continue an existing subagent's session with full context
- *
- * Subagents run in-process as SDK AgentSessions (see agents.ts). Interactive
- * prompts route to the parent TUI via the UI bridge (see ui-bridge.ts).
- */
-
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { AgentManager, registerAgentTools } from "./agents.ts";
-
-export default function (pi: ExtensionAPI) {
-  registerAgentTools(pi, new AgentManager());
-}
+/**
+ * pi-subagent-tools — Specialized subagent delegation for pi
+ *
+ * Registers four tools for the "agent as project manager" workflow:
+ *   review    — Read-only code review in the current project
+ *   explore   — Read-only exploration of external projects (requires cwd)
+ *   delegate  — General-purpose worker with full tool access
+ *   follow_up — Continue an existing subagent's session with full context
+ *
+ * Subagents run in-process as SDK AgentSessions (see agents.ts). Interactive
+ * prompts route to the parent TUI via the UI bridge (see ui-bridge.ts).
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { AgentManager, registerAgentTools } from "./agents.ts";
+
+export default function (pi: ExtensionAPI) {
+  registerAgentTools(pi, new AgentManager());
+}

package/package.json

@@ -1,63 +1,63 @@
-{
-  "name": "@jerryan/pi-subagent-tools",
-  "version": "0.3.0",
-  "description": "Minimal pi extension: delegate, review, and explore via in-process subagent sessions",
-  "type": "module",
-  "main": "index.ts",
-  "files": [
-    "index.ts",
-    "agents.ts",
-    "render.ts",
-    "sandbox-bash.ts",
-    "ui-bridge.ts",
-    "tui.ts",
-    "prompts/*.md",
-    "CHANGELOG.md",
-    "README.md",
-    "LICENSE"
-  ],
-  "keywords": [
-    "pi",
-    "pi-extension",
-    "pi-package",
-    "subagent",
-    "delegate",
-    "review",
-    "explore"
-  ],
-  "license": "MIT",
-  "author": "Zerui An",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/JerryAZR/pi-subagent-tools"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
-  },
-  "scripts": {
-    "test": "node --experimental-strip-types --import ./test/register-mocks.mjs --test test/*.test.ts",
-    "typecheck": "tsc --noEmit"
-  },
-  "pi": {
-    "extensions": [
-      "./index.ts"
-    ]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-ai": ">=0.84.0",
-    "@earendil-works/pi-coding-agent": ">=0.84.0",
-    "@earendil-works/pi-tui": ">=0.84.0"
-  },
-  "devDependencies": {
-    "@earendil-works/pi-ai": "^0.84.4",
-    "@earendil-works/pi-coding-agent": "^0.84.4",
-    "@earendil-works/pi-tui": "^0.84.4",
-    "@sinclair/typebox": "^0.34.0",
-    "@types/node": "^20.0.0",
-    "typescript": "^5.4.0"
-  },
-  "dependencies": {
-    "just-bash": "^3.4.2",
-    "just-git": "^1.8.0"
-  }
-}
+{
+  "name": "@jerryan/pi-subagent-tools",
+  "version": "0.4.0",
+  "description": "Minimal pi extension: delegate, review, and explore via in-process subagent sessions",
+  "type": "module",
+  "main": "index.ts",
+  "files": [
+    "index.ts",
+    "agents.ts",
+    "render.ts",
+    "sandbox-bash.ts",
+    "sandbox-python.ts",
+    "ui-bridge.ts",
+    "tui.ts",
+    "prompts/*.md",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "pi",
+    "pi-extension",
+    "pi-package",
+    "subagent",
+    "delegate",
+    "review",
+    "explore"
+  ],
+  "license": "MIT",
+  "author": "Zerui An",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JerryAZR/pi-subagent-tools"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "test": "node --experimental-strip-types --import ./test/register-mocks.mjs --test test/*.test.ts"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": ">=0.84.0",
+    "@earendil-works/pi-coding-agent": ">=0.84.0",
+    "@earendil-works/pi-tui": ">=0.84.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "^0.84.4",
+    "@earendil-works/pi-coding-agent": "^0.84.4",
+    "@earendil-works/pi-tui": "^0.84.4",
+    "@sinclair/typebox": "^0.34.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "dependencies": {
+    "@jerryan/just-bash": "^3.10.0",
+    "just-git": "^1.9.0"
+  }
+}

package/prompts/delegate.md

@@ -1,6 +1,6 @@
-You are a task worker. Your job is to execute the assigned task directly — do the work, don't discuss it.
-You have full file and bash access. Make changes, run commands, and complete the task.
-You do not need to present plans for approval. If requirements are clear, implement immediately.
-Minor uncertainties: proceed with a reasonable assumption, state it clearly in your result.
-Major uncertainties or obstacles: cannot be resolved — report back, suggest the caller investigate and re-delegate with clarification.
-Be concise. Deliver results, not deliberation.
+You are a task worker. Your job is to execute the assigned task directly — do the work, don't discuss it.
+You have full file and bash access. Make changes, run commands, and complete the task.
+You do not need to present plans for approval. If requirements are clear, implement immediately.
+Minor uncertainties: proceed with a reasonable assumption, state it clearly in your result.
+Major uncertainties or obstacles: cannot be resolved — report back, suggest the caller investigate and re-delegate with clarification.
+Be concise. Deliver results, not deliberation.

package/prompts/explore.md

@@ -1,4 +1,4 @@
-You are a codebase explorer. Map the structure, identify key files, and report patterns.
-You are in read-only mode — project files cannot be modified (writes to them fail by design). Use bash for searching, file inspection, and git history.
-Focus on entry points, architecture, dependencies, and areas of interest.
-End with a clear summary of the codebase structure and notable findings.
+You are a codebase explorer. Map the structure, identify key files, and report patterns.
+You are in read-only mode — project files cannot be modified (writes to them fail by design). Use bash for searching, file inspection, and git history.
+Focus on entry points, architecture, dependencies, and areas of interest.
+End with a clear summary of the codebase structure and notable findings.

package/prompts/review.md

@@ -1,4 +1,4 @@
-You are a code reviewer. Inspect code, find issues, and report findings clearly.
-You are in read-only mode — project files cannot be modified (writes to them fail by design). Use bash for searching, file inspection, and git history.
-Focus on correctness, edge cases, readability, and adherence to the task requirements.
-End with a clear summary of findings organized by severity.
+You are a code reviewer. Inspect code, find issues, and report findings clearly.
+You are in read-only mode — project files cannot be modified (writes to them fail by design). Use bash for searching, file inspection, and git history.
+Focus on correctness, edge cases, readability, and adherence to the task requirements.
+End with a clear summary of findings organized by severity.

package/render.ts

@@ -1,87 +1,87 @@
-/**
- * TUI rendering for subagent tool calls and results.
- */
-
-import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
-import { Container, Spacer, Text, Markdown } from "@earendil-works/pi-tui";
-import { formatUsage, spinnerFrame, truncate, TOOL_LINE_PREFIX } from "./tui.ts";
-
-// ---------------------------------------------------------------------------
-// Compact preview component — delegates to Text.render(width) for wrapping
-// ---------------------------------------------------------------------------
-
-export class CompactPreview {
-  private textComp: Text;
-  private maxLines: number;
-
-  constructor(text: string, maxLines: number = 5) {
-    this.maxLines = maxLines;
-    this.textComp = new Text(text, 0, 0);
-  }
-
-  render(width: number): string[] {
-    const lines = this.textComp.render(width);
-    if (lines.length === 0) return [];
-
-    if (lines.length <= this.maxLines) return lines;
-
-    return ["...", ...lines.slice(-this.maxLines)];
-  }
-
-  invalidate() {
-    this.textComp.invalidate();
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Call / result renderers shared by all subagent tools
-// ---------------------------------------------------------------------------
-
-export function renderSubagentCall(
-  label: string,
-  args: { task: string; hint?: string },
-  theme: any,
-) {
-  const firstLine = args.task.split("\n")[0];
-  const combined = args.hint ? `${args.hint} | ${firstLine}` : firstLine;
-  const preview = truncate(combined, 80);
-  return new Text(
-    `${theme.fg("toolTitle", theme.bold(label))}${theme.fg("dim", preview)}`,
-    0, 0,
-  );
-}
-
-export function renderSubagentResult(
-  result: { content: Array<{ type: string; text?: string }>; isError?: boolean; details?: any },
-  options: { expanded: boolean },
-  theme: any,
-  _context: { toolCallId: string },
-) {
-  const raw = result.content.filter((c: any) => c.type === "text").map((c: any) => c.text).join("");
-  const output = raw.split("\n").map(l => l.startsWith(TOOL_LINE_PREFIX) ? theme.fg("muted", l) : l).join("\n");
-  const container = new Container();
-
-  if (!options.expanded) {
-    const text = output || theme.fg("dim", "(no output)");
-    const usage = result.details?.usage;
-    const hint = ` · ${theme.fg("dim", "Ctrl+O to expand")}`;
-    const status = usage ? formatUsage(usage, spinnerFrame) + hint : "";
-    container.addChild(new CompactPreview(text));
-    if (status) container.addChild(new Text(theme.fg("dim", status), 0, 0));
-    return container;
-  }
-
-  const isFinal = !!result.details?.final;
-  if (isFinal) {
-    const mdTheme = getMarkdownTheme();
-    container.addChild(new Markdown(raw, 0, 0, mdTheme));
-  } else {
-    container.addChild(new CompactPreview(output, 15));
-  }
-  if (result.details?.usage) {
-    container.addChild(new Spacer(1));
-    container.addChild(new Text(theme.fg("dim", formatUsage(result.details.usage, spinnerFrame)), 0, 0));
-  }
-
-  return container;
-}
+/**
+ * TUI rendering for subagent tool calls and results.
+ */
+
+import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
+import { Container, Spacer, Text, Markdown } from "@earendil-works/pi-tui";
+import { formatUsage, spinnerFrame, truncate, TOOL_LINE_PREFIX } from "./tui.ts";
+
+// ---------------------------------------------------------------------------
+// Compact preview component — delegates to Text.render(width) for wrapping
+// ---------------------------------------------------------------------------
+
+export class CompactPreview {
+  private textComp: Text;
+  private maxLines: number;
+
+  constructor(text: string, maxLines: number = 5) {
+    this.maxLines = maxLines;
+    this.textComp = new Text(text, 0, 0);
+  }
+
+  render(width: number): string[] {
+    const lines = this.textComp.render(width);
+    if (lines.length === 0) return [];
+
+    if (lines.length <= this.maxLines) return lines;
+
+    return ["...", ...lines.slice(-this.maxLines)];
+  }
+
+  invalidate() {
+    this.textComp.invalidate();
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Call / result renderers shared by all subagent tools
+// ---------------------------------------------------------------------------
+
+export function renderSubagentCall(
+  label: string,
+  args: { task: string; hint?: string },
+  theme: any,
+) {
+  const firstLine = args.task.split("\n")[0];
+  const combined = args.hint ? `${args.hint} | ${firstLine}` : firstLine;
+  const preview = truncate(combined, 80);
+  return new Text(
+    `${theme.fg("toolTitle", theme.bold(label))}${theme.fg("dim", preview)}`,
+    0, 0,
+  );
+}
+
+export function renderSubagentResult(
+  result: { content: Array<{ type: string; text?: string }>; isError?: boolean; details?: any },
+  options: { expanded: boolean },
+  theme: any,
+  _context: { toolCallId: string },
+) {
+  const raw = result.content.filter((c: any) => c.type === "text").map((c: any) => c.text).join("");
+  const output = raw.split("\n").map(l => l.startsWith(TOOL_LINE_PREFIX) ? theme.fg("muted", l) : l).join("\n");
+  const container = new Container();
+
+  if (!options.expanded) {
+    const text = output || theme.fg("dim", "(no output)");
+    const usage = result.details?.usage;
+    const hint = ` · ${theme.fg("dim", "Ctrl+O to expand")}`;
+    const status = usage ? formatUsage(usage, spinnerFrame) + hint : "";
+    container.addChild(new CompactPreview(text));
+    if (status) container.addChild(new Text(theme.fg("dim", status), 0, 0));
+    return container;
+  }
+
+  const isFinal = !!result.details?.final;
+  if (isFinal) {
+    const mdTheme = getMarkdownTheme();
+    container.addChild(new Markdown(raw, 0, 0, mdTheme));
+  } else {
+    container.addChild(new CompactPreview(output, 15));
+  }
+  if (result.details?.usage) {
+    container.addChild(new Spacer(1));
+    container.addChild(new Text(theme.fg("dim", formatUsage(result.details.usage, spinnerFrame)), 0, 0));
+  }
+
+  return container;
+}