@esso0428/pi-subagents 0.15.0 → 0.15.2

package/dist/ui/fleet-list.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * fleet-list.ts — Claude Code-style "FleetView" list rendered below the editor.
  *
@@ -10,10 +11,14 @@
  * handling goes through `onTerminalInput` — which fires before the focused editor and
  * can `consume` keys — gated on `getEditorText() === ""` so normal typing is untouched.
  */
-import { Editor, isKeyRelease, Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import { getLifetimeTotal } from "../usage.js";
-import { getDisplayName } from "./agent-widget.js";
-import { ConversationViewer, VIEWPORT_HEIGHT_PCT } from "./conversation-viewer.js";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FleetList = void 0;
+exports.formatFleetElapsed = formatFleetElapsed;
+exports.formatFleetTokens = formatFleetTokens;
+const pi_tui_1 = require("@earendil-works/pi-tui");
+const usage_js_1 = require("../usage.js");
+const agent_widget_js_1 = require("./agent-widget.js");
+const conversation_viewer_js_1 = require("./conversation-viewer.js");
 /** Widget key for the below-editor fleet list. */
 const FLEET_KEY = "fleet";
 /** Max agent rows shown at once; extras collapse into a "↓ N more" indicator. */
@@ -23,11 +28,11 @@ const TICK_MS = 200;
 /** How long a finished agent lingers in the list before it drops out. */
 const FINISHED_LINGER_MS = 4000;
 /** `11s` — integer seconds, no decimal/suffix (matches Claude Code, unlike formatMs). */
-export function formatFleetElapsed(ms) {
+function formatFleetElapsed(ms) {
     return `${Math.max(0, Math.round(ms / 1000))}s`;
 }
 /** `↓ 13.1k tokens` — down-arrow prefix, compact magnitude, plural "tokens". */
-export function formatFleetTokens(count) {
+function formatFleetTokens(count) {
     let compact;
     if (count >= 1_000_000)
         compact = `${(count / 1_000_000).toFixed(1)}M`;
@@ -43,13 +48,13 @@ export function formatFleetTokens(count) {
  * desync pi's line-diff → flicker) even on a terminal too narrow for the stats.
  */
 function rightAlign(left, right, width) {
-    const rightW = visibleWidth(right);
+    const rightW = (0, pi_tui_1.visibleWidth)(right);
     const maxLeft = Math.max(0, width - rightW - 1);
-    const leftClamped = truncateToWidth(left, maxLeft);
-    const gap = Math.max(1, width - visibleWidth(leftClamped) - rightW);
-    return truncateToWidth(leftClamped + " ".repeat(gap) + right, width);
+    const leftClamped = (0, pi_tui_1.truncateToWidth)(left, maxLeft);
+    const gap = Math.max(1, width - (0, pi_tui_1.visibleWidth)(leftClamped) - rightW);
+    return (0, pi_tui_1.truncateToWidth)(leftClamped + " ".repeat(gap) + right, width);
 }
-export class FleetList {
+class FleetList {
     manager;
     agentActivity;
     ui;
@@ -190,7 +195,7 @@ export class FleetList {
         // Input listeners receive BOTH key-press and key-release (the kitty protocol
         // emits both, and matchesKey matches either) — act on press only, or every
         // tap would move/fire twice. Repeats still pass through for held-key nav.
-        if (isKeyRelease(data))
+        if ((0, pi_tui_1.isKeyRelease)(data))
             return undefined;
         // While an overlay is open, let it own all input.
         if (this.viewerClose)
@@ -206,7 +211,7 @@ export class FleetList {
         }
         if (!this.active) {
             // Activate: ↓ or ← at an empty prompt moves focus into the list.
-            const isActivator = matchesKey(data, "down") || matchesKey(data, "left");
+            const isActivator = (0, pi_tui_1.matchesKey)(data, "down") || (0, pi_tui_1.matchesKey)(data, "left");
             if (isActivator && this.agentRecords().length > 0 && this.ui.getEditorText() === "") {
                 this.active = true;
                 this.selectedIndex = 0;
@@ -216,13 +221,13 @@ export class FleetList {
             return undefined;
         }
         // Active — arrows navigate, Enter opens, Esc / Up-past-top exits.
-        if (matchesKey(data, "down")) {
+        if ((0, pi_tui_1.matchesKey)(data, "down")) {
             const max = this.roster().length - 1;
             this.selectedIndex = Math.min(max, this.selectedIndex + 1);
             this.update();
             return { consume: true };
         }
-        if (matchesKey(data, "up")) {
+        if ((0, pi_tui_1.matchesKey)(data, "up")) {
             if (this.selectedIndex === 0) {
                 this.deactivate();
                 return { consume: true };
@@ -231,11 +236,11 @@ export class FleetList {
             this.update();
             return { consume: true };
         }
-        if (matchesKey(data, "escape")) {
+        if ((0, pi_tui_1.matchesKey)(data, "escape")) {
             this.deactivate();
             return { consume: true };
         }
-        if (matchesKey(data, Key.enter)) {
+        if ((0, pi_tui_1.matchesKey)(data, pi_tui_1.Key.enter)) {
             this.openSelected();
             return { consume: true };
         }
@@ -253,7 +258,7 @@ export class FleetList {
      */
     editorHasFocus() {
         const focused = this.tui?.focusedComponent;
-        return focused == null || focused instanceof Editor;
+        return focused == null || focused instanceof pi_tui_1.Editor;
     }
     deactivate() {
         this.active = false;
@@ -279,13 +284,13 @@ export class FleetList {
         this.viewingAgentId = record.id;
         void this.ui.custom((tui, theme, keybindings, done) => {
             this.viewerClose = () => done(undefined);
-            return new ConversationViewer(tui, session, record, activity, theme, done, () => {
+            return new conversation_viewer_js_1.ConversationViewer(tui, session, record, activity, theme, done, () => {
                 if (this.manager.abort(record.id))
                     this.ui?.notify(`Stopped "${record.description}".`, "info");
             }, keybindings, (message) => this.manager.steer(record.id, message));
         }, {
             overlay: true,
-            overlayOptions: { anchor: "center", width: "90%", maxHeight: `${VIEWPORT_HEIGHT_PCT}%` },
+            overlayOptions: { anchor: "center", width: "90%", maxHeight: `${conversation_viewer_js_1.VIEWPORT_HEIGHT_PCT}%` },
         }).then(() => this.clearViewer(), () => this.clearViewer());
     }
     /** Reset overlay state and return to the list (on close, auto-close, or error). */
@@ -315,9 +320,9 @@ export class FleetList {
             ? "↑↓ select · enter view · esc back"
             : "esc to interrupt · ← for agents · ↓ to manage";
         const lines = [];
-        lines.push(truncateToWidth("  " + theme.fg("dim", hint), width));
+        lines.push((0, pi_tui_1.truncateToWidth)("  " + theme.fg("dim", hint), width));
         lines.push("");
-        lines.push(truncateToWidth(`  ${this.bullet(0, sel, theme)} main`, width));
+        lines.push((0, pi_tui_1.truncateToWidth)(`  ${this.bullet(0, sel, theme)} main`, width));
         // Window the agent rows so the selected one stays visible.
         const visible = Math.min(MAX_AGENT_ROWS, agents.length);
         const selAgent = Math.max(0, sel - 1);
@@ -336,10 +341,11 @@ export class FleetList {
         return rosterIndex === sel ? theme.fg("accent", "●") : theme.fg("dim", "○");
     }
     renderAgentRow(rosterIndex, sel, record, width, theme) {
-        const left = `  ${this.bullet(rosterIndex, sel, theme)} ${theme.fg("muted", getDisplayName(record.type))}  ${record.description}`;
-        const tokens = getLifetimeTotal(this.agentActivity.get(record.id)?.lifetimeUsage ?? record.lifetimeUsage);
+        const left = `  ${this.bullet(rosterIndex, sel, theme)} ${theme.fg("muted", (0, agent_widget_js_1.getDisplayName)(record.type))}  ${record.description}`;
+        const tokens = (0, usage_js_1.getLifetimeTotal)(this.agentActivity.get(record.id)?.lifetimeUsage ?? record.lifetimeUsage);
         const elapsedMs = (record.completedAt ?? Date.now()) - record.startedAt; // freezes once finished
         const right = theme.fg("dim", `${formatFleetElapsed(elapsedMs)} · ${formatFleetTokens(tokens)}`);
         return rightAlign(left, right, width);
     }
 }
+exports.FleetList = FleetList;

package/dist/ui/markdown-result.d.ts

@@ -0,0 +1,3 @@
+import { type Component } from "@earendil-works/pi-tui";
+import type { Theme } from "./agent-widget.js";
+export declare function createMarkdownResult(text: string, theme: Theme, maxLines: number): Component;

package/dist/ui/markdown-result.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMarkdownResult = createMarkdownResult;
+const pi_coding_agent_1 = require("@earendil-works/pi-coding-agent");
+const pi_tui_1 = require("@earendil-works/pi-tui");
+const TRUNCATION_MARKER = "… (more output available)";
+/**
+ * Render a child result as Markdown while keeping notification output bounded.
+ *
+ * Markdown is rendered at paint time so the TUI's current width controls wrapping.
+ * If the host's Markdown implementation is unavailable or throws, the original
+ * text is rendered through Text instead of making the result disappear.
+ */
+class CappedMarkdownResult {
+    text;
+    theme;
+    maxLines;
+    markdown;
+    constructor(text, theme, maxLines) {
+        this.text = text;
+        this.theme = theme;
+        this.maxLines = Math.max(0, Math.floor(maxLines));
+        try {
+            this.markdown = new pi_tui_1.Markdown(text, 0, 0, (0, pi_coding_agent_1.getMarkdownTheme)());
+        }
+        catch {
+            // A mismatched host Pi version should still leave the child output visible.
+        }
+    }
+    invalidate() {
+        this.markdown?.invalidate();
+    }
+    render(width) {
+        let lines;
+        try {
+            lines = this.markdown?.render(width) ?? new pi_tui_1.Text(this.text, 0, 0).render(width);
+        }
+        catch {
+            lines = new pi_tui_1.Text(this.text, 0, 0).render(width);
+        }
+        if (lines.length <= this.maxLines)
+            return lines;
+        if (this.maxLines === 0)
+            return [];
+        return [
+            ...lines.slice(0, this.maxLines - 1),
+            this.theme.fg("muted", TRUNCATION_MARKER),
+        ];
+    }
+}
+function createMarkdownResult(text, theme, maxLines) {
+    return new CappedMarkdownResult(text, theme, maxLines);
+}

package/dist/ui/schedule-menu.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * schedule-menu.ts — `/agents → Scheduled jobs` submenu.
  *
@@ -7,6 +8,8 @@
  * "I scheduled something dumb, get rid of it"). Add management surfaces here
  * if real demand emerges.
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showSchedulesMenu = showSchedulesMenu;
 /** Format an ISO timestamp as relative time ("in 4h", "2d ago", "—"). */
 function relTime(iso, now = Date.now()) {
     if (!iso)
@@ -69,7 +72,7 @@ function formatDetails(j, scheduler) {
  * List scheduled jobs; selecting one opens a cancel-confirm with details.
  * Returns when the user backs out or after a cancellation.
  */
-export async function showSchedulesMenu(ctx, scheduler) {
+async function showSchedulesMenu(ctx, scheduler) {
     if (!scheduler.isActive()) {
         ctx.ui.notify("Scheduler is not active in this session.", "warning");
         return;

package/dist/ui/viewer-keys.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * viewer-keys.ts — Scroll key matchers for the conversation viewer.
  *
@@ -5,13 +6,15 @@
  * manager, falling back to the previous hardcoded keys otherwise. The viewer's
  * k/j and shift+arrow aliases always work alongside whatever is bound.
  */
-import { matchesKey } from "@earendil-works/pi-tui";
-export function createViewerKeys(keybindings) {
-    const matches = (data, id, fallback) => keybindings ? keybindings.matches(data, id) : matchesKey(data, fallback);
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createViewerKeys = createViewerKeys;
+const pi_tui_1 = require("@earendil-works/pi-tui");
+function createViewerKeys(keybindings) {
+    const matches = (data, id, fallback) => keybindings ? keybindings.matches(data, id) : (0, pi_tui_1.matchesKey)(data, fallback);
     return {
-        scrollUp: (data) => matches(data, "tui.select.up", "up") || matchesKey(data, "k"),
-        scrollDown: (data) => matches(data, "tui.select.down", "down") || matchesKey(data, "j"),
-        pageUp: (data) => matches(data, "tui.select.pageUp", "pageUp") || matchesKey(data, "shift+up"),
-        pageDown: (data) => matches(data, "tui.select.pageDown", "pageDown") || matchesKey(data, "shift+down"),
+        scrollUp: (data) => matches(data, "tui.select.up", "up") || (0, pi_tui_1.matchesKey)(data, "k"),
+        scrollDown: (data) => matches(data, "tui.select.down", "down") || (0, pi_tui_1.matchesKey)(data, "j"),
+        pageUp: (data) => matches(data, "tui.select.pageUp", "pageUp") || (0, pi_tui_1.matchesKey)(data, "shift+up"),
+        pageDown: (data) => matches(data, "tui.select.pageDown", "pageDown") || (0, pi_tui_1.matchesKey)(data, "shift+down"),
     };
 }

package/dist/usage.js

@@ -1,10 +1,16 @@
+"use strict";
 /** usage.ts — Token usage: shapes, accumulator operators, session-stats readers. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLifetimeTotal = getLifetimeTotal;
+exports.addUsage = addUsage;
+exports.getSessionTokens = getSessionTokens;
+exports.getSessionContextPercent = getSessionContextPercent;
 /** Sum of lifetime usage components, or 0 if undefined. */
-export function getLifetimeTotal(u) {
+function getLifetimeTotal(u) {
     return u ? u.input + u.output + u.cacheWrite : 0;
 }
 /** Add a usage delta into a target accumulator (mutates target). */
-export function addUsage(into, delta) {
+function addUsage(into, delta) {
     into.input += delta.input;
     into.output += delta.output;
     into.cacheWrite += delta.cacheWrite;
@@ -22,7 +28,7 @@ export function addUsage(into, delta) {
  * and so counts the cumulative cached prefix N times across N turns
  * (issue #38).
  */
-export function getSessionTokens(session) {
+function getSessionTokens(session) {
     if (!session)
         return 0;
     try {
@@ -37,7 +43,7 @@ export function getSessionTokens(session) {
  * Context-window utilization (0–100), or null when unavailable
  * (no model contextWindow, or post-compaction before the next response).
  */
-export function getSessionContextPercent(session) {
+function getSessionContextPercent(session) {
     if (!session)
         return null;
     try {

package/dist/worktree.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * worktree.ts — Git worktree isolation for agents.
  *
@@ -5,47 +6,51 @@
  * On completion, if no changes were made, the worktree is cleaned up.
  * If changes exist, a branch is created and returned in the result.
  */
-import { execFileSync } from "node:child_process";
-import { randomUUID } from "node:crypto";
-import { existsSync, realpathSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join, relative } from "node:path";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorktree = createWorktree;
+exports.cleanupWorktree = cleanupWorktree;
+exports.pruneWorktrees = pruneWorktrees;
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
 /**
  * Create a temporary git worktree for an agent.
  * Returns the worktree path, or undefined if not in a git repo.
  */
-export function createWorktree(cwd, agentId) {
+function createWorktree(cwd, agentId) {
     // Verify we're in a git repo with at least one commit (HEAD must exist)
     let baseSha;
     let subdir;
     try {
-        execFileSync("git", ["rev-parse", "--is-inside-work-tree"], { cwd, stdio: "pipe", timeout: 5000 });
-        baseSha = execFileSync("git", ["rev-parse", "HEAD"], { cwd, stdio: "pipe", timeout: 5000 })
+        (0, node_child_process_1.execFileSync)("git", ["rev-parse", "--is-inside-work-tree"], { cwd, stdio: "pipe", timeout: 5000 });
+        baseSha = (0, node_child_process_1.execFileSync)("git", ["rev-parse", "HEAD"], { cwd, stdio: "pipe", timeout: 5000 })
             .toString()
             .trim();
         // Where cwd sits inside the repo ("" at the root): the agent must work at
         // the same subdirectory inside the copy, or a monorepo-package cwd would
         // silently widen to the whole repo. realpath both sides — git emits
         // resolved paths while cwd may arrive through a symlink (macOS /tmp).
-        const topLevel = execFileSync("git", ["rev-parse", "--show-toplevel"], { cwd, stdio: "pipe", timeout: 5000 })
+        const topLevel = (0, node_child_process_1.execFileSync)("git", ["rev-parse", "--show-toplevel"], { cwd, stdio: "pipe", timeout: 5000 })
             .toString()
             .trim();
-        subdir = relative(realpathSync(topLevel), realpathSync(cwd));
+        subdir = (0, node_path_1.relative)((0, node_fs_1.realpathSync)(topLevel), (0, node_fs_1.realpathSync)(cwd));
     }
     catch {
         return undefined;
     }
     const branch = `pi-agent-${agentId}`;
-    const suffix = randomUUID().slice(0, 8);
-    const worktreePath = join(tmpdir(), `pi-agent-${agentId}-${suffix}`);
+    const suffix = (0, node_crypto_1.randomUUID)().slice(0, 8);
+    const worktreePath = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `pi-agent-${agentId}-${suffix}`);
     try {
         // Create detached worktree at HEAD
-        execFileSync("git", ["worktree", "add", "--detach", worktreePath, "HEAD"], {
+        (0, node_child_process_1.execFileSync)("git", ["worktree", "add", "--detach", worktreePath, "HEAD"], {
             cwd,
             stdio: "pipe",
             timeout: 30000,
         });
-        return { path: worktreePath, branch, baseSha, workPath: subdir ? join(worktreePath, subdir) : worktreePath };
+        return { path: worktreePath, branch, baseSha, workPath: subdir ? (0, node_path_1.join)(worktreePath, subdir) : worktreePath };
     }
     catch {
         // If worktree creation fails, return undefined (agent runs in normal cwd)
@@ -57,31 +62,31 @@ export function createWorktree(cwd, agentId) {
  * - If no changes: remove worktree entirely.
  * - If changes exist: create a branch, commit changes, return branch info.
  */
-export function cleanupWorktree(cwd, worktree, agentDescription) {
-    if (!existsSync(worktree.path)) {
+function cleanupWorktree(cwd, worktree, agentDescription) {
+    if (!(0, node_fs_1.existsSync)(worktree.path)) {
         return { hasChanges: false };
     }
     try {
         // Check for uncommitted changes in the worktree
-        const status = execFileSync("git", ["status", "--porcelain"], {
+        const status = (0, node_child_process_1.execFileSync)("git", ["status", "--porcelain"], {
             cwd: worktree.path,
             stdio: "pipe",
             timeout: 10000,
         }).toString().trim();
         if (status) {
             // Changes exist — stage, commit, and create a branch
-            execFileSync("git", ["add", "-A"], { cwd: worktree.path, stdio: "pipe", timeout: 10000 });
+            (0, node_child_process_1.execFileSync)("git", ["add", "-A"], { cwd: worktree.path, stdio: "pipe", timeout: 10000 });
             // Truncate description for commit message (no shell sanitization needed — execFileSync uses argv)
             const safeDesc = agentDescription.slice(0, 200);
             const commitMsg = `pi-agent: ${safeDesc}`;
-            execFileSync("git", ["commit", "--no-verify", "-m", commitMsg], {
+            (0, node_child_process_1.execFileSync)("git", ["commit", "--no-verify", "-m", commitMsg], {
                 cwd: worktree.path,
                 stdio: "pipe",
                 timeout: 10000,
             });
         }
         else {
-            const currentSha = execFileSync("git", ["rev-parse", "HEAD"], {
+            const currentSha = (0, node_child_process_1.execFileSync)("git", ["rev-parse", "HEAD"], {
                 cwd: worktree.path,
                 stdio: "pipe",
                 timeout: 5000,
@@ -96,7 +101,7 @@ export function cleanupWorktree(cwd, worktree, agentDescription) {
         // If the branch already exists, append a suffix to avoid overwriting previous work.
         let branchName = worktree.branch;
         try {
-            execFileSync("git", ["branch", branchName], {
+            (0, node_child_process_1.execFileSync)("git", ["branch", branchName], {
                 cwd: worktree.path,
                 stdio: "pipe",
                 timeout: 5000,
@@ -105,7 +110,7 @@ export function cleanupWorktree(cwd, worktree, agentDescription) {
         catch {
             // Branch already exists — use a unique suffix
             branchName = `${worktree.branch}-${Date.now()}`;
-            execFileSync("git", ["branch", branchName], {
+            (0, node_child_process_1.execFileSync)("git", ["branch", branchName], {
                 cwd: worktree.path,
                 stdio: "pipe",
                 timeout: 5000,
@@ -135,7 +140,7 @@ export function cleanupWorktree(cwd, worktree, agentDescription) {
  */
 function removeWorktree(cwd, worktreePath) {
     try {
-        execFileSync("git", ["worktree", "remove", "--force", worktreePath], {
+        (0, node_child_process_1.execFileSync)("git", ["worktree", "remove", "--force", worktreePath], {
             cwd,
             stdio: "pipe",
             timeout: 10000,
@@ -144,7 +149,7 @@ function removeWorktree(cwd, worktreePath) {
     catch {
         // If git worktree remove fails, try pruning
         try {
-            execFileSync("git", ["worktree", "prune"], { cwd, stdio: "pipe", timeout: 5000 });
+            (0, node_child_process_1.execFileSync)("git", ["worktree", "prune"], { cwd, stdio: "pipe", timeout: 5000 });
         }
         catch { /* ignore */ }
     }
@@ -152,9 +157,9 @@ function removeWorktree(cwd, worktreePath) {
 /**
  * Prune any orphaned worktrees (crash recovery).
  */
-export function pruneWorktrees(cwd) {
+function pruneWorktrees(cwd) {
     try {
-        execFileSync("git", ["worktree", "prune"], { cwd, stdio: "pipe", timeout: 5000 });
+        (0, node_child_process_1.execFileSync)("git", ["worktree", "prune"], { cwd, stdio: "pipe", timeout: 5000 });
     }
     catch { /* ignore */ }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esso0428/pi-subagents",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "description": "A pi extension that brings smart Claude Code-style autonomous sub-agents to pi, with npm:pi-subagents-style JSON agent overrides.",
   "author": "ESSO0428",
   "repository": {

package/src/agent-manager.ts

@@ -23,6 +23,13 @@ export type CompactionInfo = { reason: "manual" | "threshold" | "overflow"; toke
 
 /** Default max concurrent background agents. */
 const DEFAULT_MAX_CONCURRENT = 4;
+const TERMINAL_STATUSES = new Set<AgentRecord["status"]>([
+  "completed",
+  "steered",
+  "aborted",
+  "stopped",
+  "error",
+]);
 
 /**
  * Validate a caller-supplied SpawnOptions.cwd. `undefined`/`null` mean "unset"
@@ -97,6 +104,37 @@ interface SpawnOptions {
   onCompaction?: (info: CompactionInfo) => void;
 }
 
+const RESTORABLE_STATUSES = new Set<AgentRecord["status"]>([
+  "completed",
+  "steered",
+  "aborted",
+  "stopped",
+  "error",
+]);
+
+type PersistedAgentRecord = Pick<
+  AgentRecord,
+  "id" | "type" | "description" | "status" | "result" | "error" | "startedAt" | "completedAt"
+>;
+
+function isRestorableRecord(value: unknown): value is PersistedAgentRecord {
+  if (!value || typeof value !== "object") return false;
+  const record = value as Record<string, unknown>;
+  return (
+    typeof record.id === "string" &&
+    record.id.length > 0 &&
+    typeof record.type === "string" &&
+    typeof record.description === "string" &&
+    RESTORABLE_STATUSES.has(record.status as AgentRecord["status"]) &&
+    typeof record.startedAt === "number" &&
+    Number.isFinite(record.startedAt) &&
+    typeof record.completedAt === "number" &&
+    Number.isFinite(record.completedAt) &&
+    (record.result === undefined || typeof record.result === "string") &&
+    (record.error === undefined || typeof record.error === "string")
+  );
+}
+
 export class AgentManager {
   private agents = new Map<string, AgentRecord>();
   private cleanupInterval: ReturnType<typeof setInterval>;
@@ -510,6 +548,40 @@ export class AgentManager {
     return this.agents.get(id);
   }
 
+  /**
+   * Restore terminal records persisted in a parent session.
+   *
+   * Restored records deliberately have no live session, promise, or abort
+   * controller. Invalid data is ignored because session entries are persisted
+   * extension data and may have been written by an older version.
+   */
+  restoreCompleted(records: readonly unknown[]): void {
+    const restoredIds = new Set<string>();
+    // getBranch() is chronological; newest persisted state wins on duplicate IDs.
+    for (const value of [...records].reverse()) {
+      if (!isRestorableRecord(value)) continue;
+      if (restoredIds.has(value.id) || this.agents.has(value.id)) continue;
+      restoredIds.add(value.id);
+
+      this.agents.set(value.id, {
+        id: value.id,
+        type: value.type,
+        description: value.description,
+        status: value.status,
+        result: value.result,
+        error: value.error,
+        toolUses: 0,
+        startedAt: value.startedAt,
+        completedAt: value.completedAt,
+        lifetimeUsage: { input: 0, output: 0, cacheWrite: 0 },
+        compactionCount: 0,
+        // Historical records have no inline tool surface and should remain
+        // visible in the background widget.
+        isBackground: true,
+      });
+    }
+  }
+
   listAgents(): AgentRecord[] {
     return [...this.agents.values()].sort(
       (a, b) => b.startedAt - a.startedAt,

package/src/agent-runner.ts

@@ -786,16 +786,24 @@ export async function runAgent(
   // modelRuntime, but ExtensionContext still exposes only the registry facade.
   // Pass both so the full supported Pi range retains the parent's providers.
   const parentModelRuntime = (ctx.modelRegistry as unknown as { runtime?: unknown }).runtime;
-  const sessionOpts: Parameters<typeof createAgentSession>[0] & {
+  type CreateAgentSessionOptions = NonNullable<Parameters<typeof createAgentSession>[0]>;
+  // `modelRuntime` was added in Pi 0.80.8. Infer it when available, while
+  // falling back to unknown for older Pi declarations.
+  type CompatibleModelRuntime = CreateAgentSessionOptions extends {
+    modelRuntime?: infer Runtime;
+  } ? Runtime : unknown;
+  const sessionOpts: CreateAgentSessionOptions & {
     modelRegistry: ExtensionContext["modelRegistry"];
-    modelRuntime?: unknown;
+    modelRuntime?: CompatibleModelRuntime;
   } = {
     cwd: effectiveCwd,
     agentDir,
     sessionManager,
     settingsManager,
     modelRegistry: ctx.modelRegistry,
-    ...(parentModelRuntime !== undefined && { modelRuntime: parentModelRuntime }),
+    ...(parentModelRuntime != null && {
+      modelRuntime: parentModelRuntime as CompatibleModelRuntime,
+    }),
     model,
     tools: sessionTools,
     resourceLoader: loader,