@selesai/code 0.13.3 → 0.13.5

package/dist/extensions/pi-intercom/ui/session-list.ts

@@ -1,166 +1,166 @@
-import type { Component } from "@earendil-works/pi-tui";
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import type { KeybindingsManager, Theme } from "@selesai/code";
-import type { SessionInfo } from "../types.ts";
-
-function middleTruncate(text: string, maxWidth: number): string {
-  if (visibleWidth(text) <= maxWidth) {
-    return text;
-  }
-  if (maxWidth <= 3) {
-    return truncateToWidth(text, maxWidth, "");
-  }
-
-  const chars = [...text];
-  const targetSideWidth = Math.max(1, Math.floor((maxWidth - 1) / 2));
-
-  let left = "";
-  for (const char of chars) {
-    if (visibleWidth(left + char) > targetSideWidth) break;
-    left += char;
-  }
-
-  let right = "";
-  for (const char of chars.slice().reverse()) {
-    if (visibleWidth(char + right) > targetSideWidth) break;
-    right = char + right;
-  }
-
-  return truncateToWidth(`${left}…${right}`, maxWidth, "");
-}
-
-function shortSessionId(sessionId: string): string {
-  return sessionId.slice(0, 8);
-}
-
-function sessionTitle(session: SessionInfo, options?: { self?: boolean; sameCwd?: boolean }): string {
-  const name = session.name || "Unnamed session";
-  const tags = [options?.self ? "self" : undefined, options?.sameCwd ? "same cwd" : undefined]
-    .filter((tag): tag is string => Boolean(tag));
-  const suffix = tags.length ? ` [${tags.join(", ")}]` : "";
-  return `${name} (${shortSessionId(session.id)})${suffix}`;
-}
-
-export class SessionListOverlay implements Component {
-  private theme: Theme;
-  private keybindings: KeybindingsManager;
-  private currentSession: SessionInfo;
-  private done: (result: SessionInfo | undefined) => void;
-  private sessions: SessionInfo[];
-  private selectedIndex = 0;
-  private maxVisible = 8;
-
-  constructor(
-    theme: Theme,
-    keybindings: KeybindingsManager,
-    currentSession: SessionInfo,
-    sessions: SessionInfo[],
-    done: (result: SessionInfo | undefined) => void,
-  ) {
-    this.theme = theme;
-    this.keybindings = keybindings;
-    this.currentSession = currentSession;
-    this.sessions = sessions;
-    this.done = done;
-  }
-
-  private onSessionSelect(sessionId: string): void {
-    const session = this.sessions.find(s => s.id === sessionId);
-    if (!session) return;
-    this.done(session);
-  }
-
-  invalidate(): void {}
-
-  handleInput(data: string): void {
-    if (this.keybindings.matches(data, "tui.select.cancel")) {
-      this.done(undefined);
-      return;
-    }
-
-    if (this.sessions.length === 0) {
-      return;
-    }
-
-    if (this.keybindings.matches(data, "tui.select.up")) {
-      this.selectedIndex = this.selectedIndex === 0 ? this.sessions.length - 1 : this.selectedIndex - 1;
-      return;
-    }
-
-    if (this.keybindings.matches(data, "tui.select.down")) {
-      this.selectedIndex = this.selectedIndex === this.sessions.length - 1 ? 0 : this.selectedIndex + 1;
-      return;
-    }
-
-    if (this.keybindings.matches(data, "tui.select.confirm")) {
-      const session = this.sessions[this.selectedIndex];
-      if (session) {
-        this.onSessionSelect(session.id);
-      }
-    }
-  }
-
-  render(width: number): string[] {
-    const innerWidth = Math.max(1, Math.min(width, 88));
-    if (innerWidth === 1) {
-      return [this.theme.fg("accent", "│")];
-    }
-
-    const contentWidth = Math.max(0, innerWidth - 2);
-    const footer = `${this.keybindings.getKeys("tui.select.confirm").join("/")}: Message • ${this.keybindings.getKeys("tui.select.cancel").join("/")}: Close`;
-    const border = (text: string) => this.theme.fg("accent", text);
-    const row = (text = "") => {
-      const clipped = truncateToWidth(text, contentWidth, "", true);
-      return `${border("│")}${clipped}${" ".repeat(Math.max(0, contentWidth - visibleWidth(clipped)))}${border("│")}`;
-    };
-
-    const lines: string[] = [];
-    lines.push(border(`╭${"─".repeat(contentWidth)}╮`));
-    lines.push(row(this.theme.bold(" Current Session")));
-    lines.push(border(`├${"─".repeat(contentWidth)}┤`));
-    lines.push(row());
-    lines.push(row(`  ${this.theme.fg("dim", sessionTitle(this.currentSession, { self: true }))}`));
-    lines.push(row(`  ${this.theme.fg("dim", `${middleTruncate(this.currentSession.cwd, Math.max(8, contentWidth - 4))} • ${this.currentSession.model}`)}`));
-    lines.push(row());
-    lines.push(border(`├${"─".repeat(contentWidth)}┤`));
-    lines.push(row(this.theme.bold(" Other Sessions")));
-    lines.push(row());
-
-    if (this.sessions.length === 0) {
-      lines.push(row(this.theme.fg("dim", " No other intercom-connected sessions")));
-    } else {
-      const startIndex = Math.max(
-        0,
-        Math.min(this.selectedIndex - Math.floor(this.maxVisible / 2), this.sessions.length - this.maxVisible),
-      );
-      const endIndex = Math.min(startIndex + this.maxVisible, this.sessions.length);
-
-      for (let index = startIndex; index < endIndex; index += 1) {
-        const session = this.sessions[index];
-        const isSelected = index === this.selectedIndex;
-        const sameCwd = session.cwd === this.currentSession.cwd;
-        const prefix = isSelected ? this.theme.fg("accent", "→ ") : "  ";
-        const title = sessionTitle(session, { sameCwd });
-        const pathText = `${middleTruncate(session.cwd, Math.max(8, contentWidth - 4))} • ${session.model}`;
-
-        lines.push(row(`${prefix}${isSelected ? this.theme.fg("accent", title) : title}`));
-        lines.push(row(`  ${this.theme.fg("dim", pathText)}`));
-        if (index < endIndex - 1) {
-          lines.push(row());
-        }
-      }
-
-      if (startIndex > 0 || endIndex < this.sessions.length) {
-        lines.push(row());
-        lines.push(row(this.theme.fg("dim", ` ${this.selectedIndex + 1}/${this.sessions.length}`)));
-      }
-    }
-
-    lines.push(row());
-    lines.push(border(`├${"─".repeat(contentWidth)}┤`));
-    lines.push(row(this.theme.fg("dim", ` ${footer}`)));
-    lines.push(border(`╰${"─".repeat(contentWidth)}╯`));
-
-    return lines;
-  }
-}
+import type { Component } from "@earendil-works/pi-tui";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import type { KeybindingsManager, Theme } from "@selesai/code";
+import type { SessionInfo } from "../types.ts";
+
+function middleTruncate(text: string, maxWidth: number): string {
+  if (visibleWidth(text) <= maxWidth) {
+    return text;
+  }
+  if (maxWidth <= 3) {
+    return truncateToWidth(text, maxWidth, "");
+  }
+
+  const chars = [...text];
+  const targetSideWidth = Math.max(1, Math.floor((maxWidth - 1) / 2));
+
+  let left = "";
+  for (const char of chars) {
+    if (visibleWidth(left + char) > targetSideWidth) break;
+    left += char;
+  }
+
+  let right = "";
+  for (const char of chars.slice().reverse()) {
+    if (visibleWidth(char + right) > targetSideWidth) break;
+    right = char + right;
+  }
+
+  return truncateToWidth(`${left}…${right}`, maxWidth, "");
+}
+
+function shortSessionId(sessionId: string): string {
+  return sessionId.slice(0, 8);
+}
+
+function sessionTitle(session: SessionInfo, options?: { self?: boolean; sameCwd?: boolean }): string {
+  const name = session.name || "Unnamed session";
+  const tags = [options?.self ? "self" : undefined, options?.sameCwd ? "same cwd" : undefined]
+    .filter((tag): tag is string => Boolean(tag));
+  const suffix = tags.length ? ` [${tags.join(", ")}]` : "";
+  return `${name} (${shortSessionId(session.id)})${suffix}`;
+}
+
+export class SessionListOverlay implements Component {
+  private theme: Theme;
+  private keybindings: KeybindingsManager;
+  private currentSession: SessionInfo;
+  private done: (result: SessionInfo | undefined) => void;
+  private sessions: SessionInfo[];
+  private selectedIndex = 0;
+  private maxVisible = 8;
+
+  constructor(
+    theme: Theme,
+    keybindings: KeybindingsManager,
+    currentSession: SessionInfo,
+    sessions: SessionInfo[],
+    done: (result: SessionInfo | undefined) => void,
+  ) {
+    this.theme = theme;
+    this.keybindings = keybindings;
+    this.currentSession = currentSession;
+    this.sessions = sessions;
+    this.done = done;
+  }
+
+  private onSessionSelect(sessionId: string): void {
+    const session = this.sessions.find(s => s.id === sessionId);
+    if (!session) return;
+    this.done(session);
+  }
+
+  invalidate(): void {}
+
+  handleInput(data: string): void {
+    if (this.keybindings.matches(data, "tui.select.cancel")) {
+      this.done(undefined);
+      return;
+    }
+
+    if (this.sessions.length === 0) {
+      return;
+    }
+
+    if (this.keybindings.matches(data, "tui.select.up")) {
+      this.selectedIndex = this.selectedIndex === 0 ? this.sessions.length - 1 : this.selectedIndex - 1;
+      return;
+    }
+
+    if (this.keybindings.matches(data, "tui.select.down")) {
+      this.selectedIndex = this.selectedIndex === this.sessions.length - 1 ? 0 : this.selectedIndex + 1;
+      return;
+    }
+
+    if (this.keybindings.matches(data, "tui.select.confirm")) {
+      const session = this.sessions[this.selectedIndex];
+      if (session) {
+        this.onSessionSelect(session.id);
+      }
+    }
+  }
+
+  render(width: number): string[] {
+    const innerWidth = Math.max(1, Math.min(width, 88));
+    if (innerWidth === 1) {
+      return [this.theme.fg("accent", "│")];
+    }
+
+    const contentWidth = Math.max(0, innerWidth - 2);
+    const footer = `${this.keybindings.getKeys("tui.select.confirm").join("/")}: Message • ${this.keybindings.getKeys("tui.select.cancel").join("/")}: Close`;
+    const border = (text: string) => this.theme.fg("accent", text);
+    const row = (text = "") => {
+      const clipped = truncateToWidth(text, contentWidth, "", true);
+      return `${border("│")}${clipped}${" ".repeat(Math.max(0, contentWidth - visibleWidth(clipped)))}${border("│")}`;
+    };
+
+    const lines: string[] = [];
+    lines.push(border(`╭${"─".repeat(contentWidth)}╮`));
+    lines.push(row(this.theme.bold(" Current Session")));
+    lines.push(border(`├${"─".repeat(contentWidth)}┤`));
+    lines.push(row());
+    lines.push(row(`  ${this.theme.fg("dim", sessionTitle(this.currentSession, { self: true }))}`));
+    lines.push(row(`  ${this.theme.fg("dim", `${middleTruncate(this.currentSession.cwd, Math.max(8, contentWidth - 4))} • ${this.currentSession.model}`)}`));
+    lines.push(row());
+    lines.push(border(`├${"─".repeat(contentWidth)}┤`));
+    lines.push(row(this.theme.bold(" Other Sessions")));
+    lines.push(row());
+
+    if (this.sessions.length === 0) {
+      lines.push(row(this.theme.fg("dim", " No other intercom-connected sessions")));
+    } else {
+      const startIndex = Math.max(
+        0,
+        Math.min(this.selectedIndex - Math.floor(this.maxVisible / 2), this.sessions.length - this.maxVisible),
+      );
+      const endIndex = Math.min(startIndex + this.maxVisible, this.sessions.length);
+
+      for (let index = startIndex; index < endIndex; index += 1) {
+        const session = this.sessions[index];
+        const isSelected = index === this.selectedIndex;
+        const sameCwd = session.cwd === this.currentSession.cwd;
+        const prefix = isSelected ? this.theme.fg("accent", "→ ") : "  ";
+        const title = sessionTitle(session, { sameCwd });
+        const pathText = `${middleTruncate(session.cwd, Math.max(8, contentWidth - 4))} • ${session.model}`;
+
+        lines.push(row(`${prefix}${isSelected ? this.theme.fg("accent", title) : title}`));
+        lines.push(row(`  ${this.theme.fg("dim", pathText)}`));
+        if (index < endIndex - 1) {
+          lines.push(row());
+        }
+      }
+
+      if (startIndex > 0 || endIndex < this.sessions.length) {
+        lines.push(row());
+        lines.push(row(this.theme.fg("dim", ` ${this.selectedIndex + 1}/${this.sessions.length}`)));
+      }
+    }
+
+    lines.push(row());
+    lines.push(border(`├${"─".repeat(contentWidth)}┤`));
+    lines.push(row(this.theme.fg("dim", ` ${footer}`)));
+    lines.push(border(`╰${"─".repeat(contentWidth)}╯`));
+
+    return lines;
+  }
+}

package/dist/extensions/pi-subagents/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 ## [Unreleased]
 
+## [0.60.0] - 2026-08-31
+
+### Highlights
+- Ask for the runtime delegation catalog as clean rows: `subagent({ action: "list", capabilities: true })` returns compact, prompt-free capability rows and machine metadata.
+- Timeout recovery is explainable: async status and `subagent_wait` completions report the missing/written report and changed tracked files for timed-out children with dirty worktrees.
+- Forked children reuse prompt caches: fork-context launches stamp an OpenAI-compatible `prompt_cache_key` on provider requests.
+- `runs.lanes` plans show up as workflow-graph stages in status and TUI views.
+- Watchdog and single-output evidence are cheaper and kinder: home-root/entry-less repos skip untracked scans, and stat errors propagate instead of being swallowed.
+
+### Added
+- Add `capabilities` option to management `list`: returns executable/restricted status, restriction sources, aliases, runner (pi / external-cli / external-job with capabilities), tools (ambient, mcp-direct, mutation), model (value/fallbacks/thinking), execution (defaultAsync, timeoutMs), output, and extensions snapshot per agent, plus total restricted count and capability-ceiling sources, as versioned `details.agentCapabilities` (`details.catalog`).
+- Emit `lanePlan` metadata from `runs.lanes` (stages, phase, label, agent, output name, structured flag) and render workflow-graph stage nodes in async status and TUI views.
+- Stamp `prompt_cache_key` (`pi-fork:<sha256>`) on supported provider requests for fork-context children via `before_provider_request`.
+- Project timeout-recovery evidence (termination, changed files, report status, dirty-worktree reason) into async status steps and `subagent_wait` completion output.
+
+### Changed
+- `runs.host` rejects per-step `cwd` with an actionable hint (use outer request cwd or a trusted `cd` in the command).
+- Watchdog repo-change signatures skip `--untracked-files=all` for home-repo roots and repositories with no tracked entries, keeping status probes cheap and bounded.
+- Single-output snapshots propagate non-ENOENT stat errors instead of treating every failure as "file missing".
+- Background spawns use `windowsHide` consistently and `detached` only on non-Windows.
+- `workflowScript` guidance documents the portability rules (no nested async helpers) and `runs.host` cwd semantics.
+
+### Fixed
+- "Running" spinners in the TUI advance on wall-clock time instead of only on model activity.
+- Noisy repeated single-step status rows are suppressed in workflow status rendering.
+- Timeout recovery summaries no longer claim a written report when the required output is missing.
+
 ## [0.59.0] - 2026-08-28
 
 ### Highlights

package/dist/extensions/pi-subagents/docs/tool-reference.md

@@ -4,7 +4,7 @@ Parameters and actions for the `subagent` tool. These are what the LLM passes wh
 
 ## Execution examples
 
-Chaining is code-driven through `workflowScript`. Use `await runs.run(...)` for sequential steps and `await runs.all([{ key, agent, task }, ...])` for ordinary parallel fanout. `runs.all` resolves to an ordered array, not a key map, so use indexes, destructuring, or `.map(...)`, not `results.<key>`. Do not read `.output` from an unawaited `runs.run` launch. Stored `runs.run` promises are only for the advanced rolling fanout pattern under [Workflow steering](#workflow-steering), where every promise is later observed with direct `await`, `Promise.race`, or `Promise.all`. Legacy top-level `chain`, `tasks`, and `parallel` inputs are not supported. Helper functions must be plain functions or explicit Promise chains. Nested `async function` helpers, async arrows, and async methods are rejected so child-launch tracking stays portable across Node and Bun.
+Chaining is code-driven through `workflowScript`. Use `await runs.run(...)` for sequential steps and `await runs.all([{ key, agent, task }, ...])` for ordinary parallel fanout. `runs.all` resolves to an ordered array, not a key map, so use indexes, destructuring, or `.map(...)`, not `results.<key>`. Do not read `.output` from an unawaited `runs.run` launch. Stored `runs.run` promises are only for the advanced rolling fanout pattern under [Workflow steering](#workflow-steering), where every promise is later observed with direct `await`, `Promise.race`, or `Promise.all`. Legacy top-level `chain`, `tasks`, and `parallel` inputs are not supported. Helper functions must be plain functions or explicit Promise chains. Nested `async function` helpers, async arrows, and async methods are rejected so child-launch tracking stays portable across Node and Bun. Host steps are similarly narrow: use `runs.host(key, { kind: "command", command, timeoutMs, output?, role?, provider? })`; there is no per-step `cwd`, and commands and relative output paths use the workflow `cwd`. Set `cwd` on the outer `subagent({...})` request instead, or put a trusted directory change in the command (for example, `cd /path/to/worktree && npm test`).
 
 Use `{ action: "validate", workflowScript }` to check statically decidable syntax and structure without launching children. It returns `{ ok, errors }` and fails the tool call when `ok` is false. Dynamic keys and values remain valid because runtime-only cases are not guessed.
 
@@ -95,6 +95,7 @@ The complete plain-JSON inventory is validated before the first launch (maximum
 | `view` | `fleet \| transcript` | - | Optional `status` view for the active fleet surface or transcript tail inspection. |
 | `lines` | number | `80` | Maximum transcript lines for `action: "status", view: "transcript"`; capped at 500. |
 | `agentScope` | `user \| project \| both` | `both` | Agent discovery scope. Project wins on collisions. |
+| `capabilities` | boolean | `false` | With `action: "list"`, return compact prompt-free rows and `details.agentCapabilities` machine-readable records for each agent's declared/default routing capabilities. |
 | `async` | boolean | default-on | Background execution. Workflows default to background. `async:false` blocks the parent until completion. |
 | `chatProgress` | `auto \| off \| live-card` | `auto` | WorkflowScript chat projection. `auto` renders a live in-chat card only for watched foreground workflows in the same Git repository, including managed worktrees; it is off otherwise. Explicit `live-card` requires `async:false` and the same Git repository. Async workflows have no inline live card, so omit `chatProgress` or use `auto`/`off`; use `async:false` only when the parent must block. |
 | `isolation` | `none \| worktree` | - | Workflow child isolation. `none` runs in the shared cwd and does not need Git. `worktree` requires a managed Git worktree. Do not combine it with a contradictory `worktree` value. |
@@ -192,6 +193,7 @@ Agent definitions are not loaded into context by default. Management actions let
 ```ts
 { action: "list" }
 { action: "list", agentScope: "project" }
+{ action: "list", capabilities: true }
 { action: "get", agent: "scout" }
 { action: "models" }
 { action: "models", agent: "reviewer" }
@@ -235,6 +237,7 @@ Agent definitions are not loaded into context by default. Management actions let
 
 Rules:
 
+- `capabilities: true` changes `action: "list"` to compact one-line rows and adds `details.agentCapabilities: { agents, restrictedCount, capabilityCeilingSources? }`. Each agent row includes source, aliases, runner type/capabilities, tools, MCP direct tools, mutation tools, model/thinking/fallbacks, default async/timeout, output path/mode, skills/extensions, and whether the current capability ceiling allows execution. It never includes an agent's system prompt. Rows show declared/default capabilities, not task-specific launch resolution; use preflight when exact launch validation is needed.
 - `create` uses `config.scope`, not `agentScope`.
 - `config.name` is the local frontmatter name; optional `config.package` registers the runtime name as `{package}.{name}` and is saved as separate `name` and `package` frontmatter.
 - `config.aliases` accepts a comma-separated string, string array, or `false` to clear aliases. Aliases resolve to the canonical agent name for execution and are shown by `list`/`get`.

package/dist/extensions/pi-subagents/docs/workflows.md

@@ -35,7 +35,7 @@ Add `autofix` to `/parallel-review` or `/parallel-cleanup` to apply only the syn
 
 ## Scripted workflows (workflowScript)
 
-All model-facing subagent execution is expressed through `workflowScript` in the `subagent` tool. Use stable keys and ordinary JavaScript for one child, sequence, and parallelism. For ordinary parallel fanout, use `await runs.all([{ key, agent, task }, ...])`. It resolves to an ordered array, not a key map, so use indexes, destructuring, or `.map(...)`, not `results.<key>`. Do not read `.output` from unawaited `runs.run` launches. Store a `runs.run` promise only when the script later observes it with `await`, `Promise.race`, or `Promise.all`, such as steering a live child before awaiting its result. Scripts are ordinary JavaScript statement bodies. Use an explicit `return` for a useful result:
+Use direct `{ agent, task }` for one bounded child. Use `workflowScript` when the parent needs a stable keyed child, sequence, fanout, steering, retry, or aggregation. For ordinary parallel fanout, use `await runs.all([{ key, agent, task }, ...])`. It resolves to an ordered array, not a key map, so use indexes, destructuring, or `.map(...)`, not `results.<key>`. Do not read `.output` from unawaited `runs.run` launches. Store a `runs.run` promise only when the script later observes it with `await`, `Promise.race`, or `Promise.all`, such as steering a live child before awaiting its result. Scripts are ordinary JavaScript statement bodies. Use an explicit `return` for a useful result:
 
 Child results cross into the script as plain JSON data. Non-JSON host metadata is omitted, so use returned fields such as `runId`, `ok`, `output`, and `structuredOutput` for workflow control.
 
@@ -178,7 +178,7 @@ subagent({ workflowScript: `
 ` });
 ```
 
-The first version supports only `kind: "command"`. `command` and `timeoutMs` are required; `output` must be a relative path without traversal. `role` may be `ci` or `gate`, and `provider` is display metadata only. The command has no stdin, receives the workflow cwd, and must be awaited or returned. Stdout, stderr, and the saved log are bounded. A nonzero exit, timeout, abort, or output-write failure fails the workflow. Async status and terminal receipts store the bounded host-step state; renderers do not run commands or read command output.
+The first version supports only `kind: "command"`. `command` and `timeoutMs` are required; `output` must be a relative path without traversal. `role` may be `ci` or `gate`, and `provider` is display metadata only. **There is no per-step `cwd` field:** the command and relative output path use the workflow cwd. Set `cwd` on the outer `subagent({...})` request when the workflow should run in another directory, or put a trusted directory change in the command (for example, `cd /path/to/worktree && npm test`) when only that step differs. The command has no stdin, receives the workflow cwd, and must be awaited or returned. Stdout, stderr, and the saved log are bounded. A nonzero exit, timeout, abort, or output-write failure fails the workflow. Async status and terminal receipts store the bounded host-step state; renderers do not run commands or read command output.
 
 ### Steering a workflow child
 

package/dist/extensions/pi-subagents/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-subagents",
-  "version": "0.59.0",
+  "version": "0.60.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-subagents",
-      "version": "0.59.0",
+      "version": "0.60.0",
       "license": "MIT",
       "dependencies": {
         "acorn": "8.18.0",

package/dist/extensions/pi-subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-subagents",
-  "version": "0.59.0",
+  "version": "0.60.0",
   "description": "Selesai extension for single-agent delegation and scripted multi-agent workflows",
   "author": "Nico Bailon",
   "license": "MIT",