@esso0428/pi-subagents 0.15.2 → 0.15.4

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.15.4] - 2026-09-11
+
+### Fixed
+- **Unavailable history records no longer load the subagent panels.** Reload-restored metadata is shown in AgentWidget, FleetView, and `/agents` only when its project-local transcript still exists; stale records remain available through the normal session result/history data without creating a dead-end Enter target.
+
+## [0.15.3] - 2026-09-11
+
+### Added
+- **Reload-safe transcript history.** Agents now keep a project-local copy under `.pi-subagents/agent-transcripts/`; terminal records persist a relative locator and `/agents`/FleetView can open a read-only history viewer after reload. The shared `.pi-subagents/.gitignore` is created with `*` to keep private transcripts out of git.
+
 ## [0.15.2] - 2026-09-10
 
 ### Added

package/README.md

@@ -140,7 +140,7 @@ Individual agent results render Claude Code-style in the conversation:
 
 Completed results can be expanded (ctrl+o in pi) to show the agent output inline with Markdown formatting. Expanded output is capped at 50 rendered lines (background notification results at 30 lines) and ends with a marker when more output is available; use `get_subagent_result` for the complete result.
 
-By default, foreground and background agents each stream their full conversation to a per-subagent transcript — a JSON-lines file at `<os-tmpdir>/pi-subagents-<uid>/<cwd>/<session>/tasks/<agent-id>.output` (owner-only `0700`, cleared on reboot). Set `output_transcript: false` on a custom agent to write no transcript path or file for it, or set `outputTranscript: false` in `subagents.json` to make transcripts opt-in for the whole project (frontmatter overrides the project default). This governs **only** the transcript: it is independent of `persist_session` (the pi session on disk), and it does not affect `isolation: worktree` (which commits the agent's work to a git branch) or `memory:` (durable files) — set those accordingly if the goal is to keep a run off disk entirely. Background agent completion notifications render as styled boxes:
+By default, foreground and background agents stream their full conversation to two per-subagent transcripts: the existing temporary JSON-lines file at `<os-tmpdir>/pi-subagents-<uid>/<cwd>/<session>/tasks/<agent-id>.output` (owner-only `0700`, cleared on reboot), plus a durable copy at `<cwd>/.pi-subagents/agent-transcripts/<agent-id>_<agent-type>_transcript.jsonl`. The project-local `.pi-subagents/.gitignore` contains `*` so these private transcripts are not accidentally uploaded to git. After `/reload`, terminal records use the durable locator to open a read-only history viewer. Set `output_transcript: false` on a custom agent, or `outputTranscript: false` in `subagents.json`, to suppress both transcript files. This governs **only** the transcript: it is independent of `persist_session` (the pi session on disk), and it does not affect `isolation: worktree` or `memory:`. Background agent completion notifications render as styled boxes:
 
 ```
 ✓ Find auth files completed
@@ -222,7 +222,7 @@ All fields are optional — sensible defaults for everything.
 | `thinking` | inherit | off, minimal, low, medium, high, xhigh, max — actual availability depends on your pi version and model; pi clamps unsupported levels down |
 | `max_turns` | unlimited | Max agentic turns before graceful shutdown. `0` or omit for unlimited |
 | `persist_session` | `false` | Persist this subagent as a normal pi session instead of keeping the session in memory only. The subagent's `.output` transcript is still written either way unless `output_transcript: false` |
-| `output_transcript` | `true` (or `subagents.json` `outputTranscript`) | Write this subagent's `.output` transcript; when set, overrides the `subagents.json` `outputTranscript` default. Set `false` to write no transcript file or path. Governs only the transcript — independent of `persist_session`, `isolation: worktree`, and `memory:` |
+| `output_transcript` | `true` (or `subagents.json` `outputTranscript`) | Write the temporary `.output` transcript and durable `.pi-subagents/agent-transcripts/` copy; when set, overrides the `subagents.json` `outputTranscript` default. Set `false` to write neither. Governs only the transcript — independent of `persist_session`, `isolation: worktree`, and `memory:` |
 | `session_dir` | pi default | Optional session directory when `persist_session: true`; omitted uses pi's normal session location, and relative paths resolve from the agent cwd |
 | `prompt_mode` | `replace` | `replace`: body is the full system prompt (no AGENTS.md / CLAUDE.md inheritance). `append`: body appended to parent's prompt (agent acts as a "parent twin" — inherits parent's AGENTS.md / CLAUDE.md) |
 | `inherit_context` | `false` | Fork parent conversation into agent |
@@ -508,7 +508,7 @@ Runtime tuning values set via `/agents` → Settings (max concurrency, default m
 
 **Disable defaults** (`disableDefaultAgents`, default `false`): when on, the three built-in agents (general-purpose, Explore, Plan) are not registered — only your project/global custom agents are advertised and spawnable. User-defined agents are unaffected, including ones that override a default by name. The Agent tool's type list updates on the next pi session (the tool schema is registered at startup).
 
-**Output transcript** (`outputTranscript`, default `true`): the project/global default for writing each subagent's `.output` transcript. Toggle via `/agents → Settings → Output transcript`, or set `false` in `subagents.json` to make transcripts opt-in project-wide — useful when run transcripts shouldn't sit on disk for backup or DLP tooling to pick up. A custom agent's `output_transcript` frontmatter overrides this per agent. Applied live at spawn time. Governs only the transcript, not `persist_session`, worktree commits, or memory files.
+**Output transcript** (`outputTranscript`, default `true`): the project/global default for writing each subagent's temporary `.output` transcript and durable project-local history copy under `.pi-subagents/agent-transcripts/`. Toggle via `/agents → Settings → Output transcript`, or set `false` in `subagents.json` to make both transcripts opt-in project-wide. A custom agent's `output_transcript` frontmatter overrides this per agent. Applied live at spawn time. Governs only the transcript, not `persist_session`, worktree commits, or memory files.
 
 **Tool description** (`toolDescriptionMode`, default `"full"`): which Agent tool description the LLM sees. `"full"` is the rich Claude Code-style prompt (~1,400 tokens with the default agents); `"compact"` is ~75% smaller — one-line agent type list, terse usage notes — for small/local models where tool-spec tokens are expensive. Per-option details stay in the parameter descriptions in every mode (the parameter schema is never customizable). Applies on the next pi session.
 

package/dist/agent-history.d.ts

@@ -0,0 +1,24 @@
+/** Durable, project-local transcript storage for subagents. */
+import type { AgentSession } from "@earendil-works/pi-coding-agent";
+/**
+ * Ensure project-local subagent artifacts are ignored by git.
+ *
+ * The rule is appended instead of rewriting the file. This preserves any
+ * existing user-owned rules and makes concurrent callers harmless (duplicate
+ * `*` rules are semantically equivalent).
+ */
+export declare function ensureSubagentsGitignore(cwd: string): string;
+/** Return the durable transcript path for an agent. */
+export declare function createAgentHistoryPath(cwd: string, agentId: string, agentType?: string): string;
+/** Return the project-relative path stored in the parent session record. */
+export declare function agentHistoryLocator(cwd: string, historyPath: string): string;
+/** Resolve only paths in this package's project-local transcript namespace. */
+export declare function resolveAgentHistoryPath(cwd: string, locator: string): string | undefined;
+/** Return true only when a valid project-local transcript file exists. */
+export declare function hasAgentHistory(cwd: string, locator: string | undefined): boolean;
+/**
+ * Read persisted transcript entries into the message shape used by the live
+ * conversation viewer. Malformed lines and unknown records are skipped so one
+ * damaged entry cannot hide the rest of a history.
+ */
+export declare function readAgentHistory(cwd: string, locator: string): AgentSession["messages"] | undefined;

package/dist/agent-history.js

@@ -0,0 +1,106 @@
+"use strict";
+/** Durable, project-local transcript storage for subagents. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureSubagentsGitignore = ensureSubagentsGitignore;
+exports.createAgentHistoryPath = createAgentHistoryPath;
+exports.agentHistoryLocator = agentHistoryLocator;
+exports.resolveAgentHistoryPath = resolveAgentHistoryPath;
+exports.hasAgentHistory = hasAgentHistory;
+exports.readAgentHistory = readAgentHistory;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const SUBAGENTS_DIR = ".pi-subagents";
+const TRANSCRIPTS_DIR = "agent-transcripts";
+const MAX_HISTORY_BYTES = 20 * 1024 * 1024;
+/**
+ * Ensure project-local subagent artifacts are ignored by git.
+ *
+ * The rule is appended instead of rewriting the file. This preserves any
+ * existing user-owned rules and makes concurrent callers harmless (duplicate
+ * `*` rules are semantically equivalent).
+ */
+function ensureSubagentsGitignore(cwd) {
+    const directory = (0, node_path_1.join)(cwd, SUBAGENTS_DIR);
+    (0, node_fs_1.mkdirSync)(directory, { recursive: true });
+    const path = (0, node_path_1.join)(directory, ".gitignore");
+    let content = "";
+    try {
+        content = (0, node_fs_1.readFileSync)(path, "utf8");
+    }
+    catch {
+        // The append below also creates a missing file.
+    }
+    if (!content.split(/\r?\n/).some((line) => line.trim() === "*")) {
+        const separator = content.length > 0 && !/[\r\n]$/.test(content) ? "\n" : "";
+        (0, node_fs_1.appendFileSync)(path, `${separator}*\n`, "utf8");
+    }
+    return path;
+}
+/** Return the durable transcript path for an agent. */
+function createAgentHistoryPath(cwd, agentId, agentType = "agent") {
+    ensureSubagentsGitignore(cwd);
+    const directory = (0, node_path_1.join)(cwd, SUBAGENTS_DIR, TRANSCRIPTS_DIR);
+    (0, node_fs_1.mkdirSync)(directory, { recursive: true });
+    const safeId = agentId.replace(/[^A-Za-z0-9._-]+/g, "-") || "agent";
+    const safeType = agentType.replace(/[^A-Za-z0-9._-]+/g, "-") || "agent";
+    return (0, node_path_1.join)(directory, `${safeId}_${safeType}_transcript.jsonl`);
+}
+/** Return the project-relative path stored in the parent session record. */
+function agentHistoryLocator(cwd, historyPath) {
+    return (0, node_path_1.relative)(cwd, historyPath).split(node_path_1.sep).join("/");
+}
+/** Resolve only paths in this package's project-local transcript namespace. */
+function resolveAgentHistoryPath(cwd, locator) {
+    if (!locator || (0, node_path_1.isAbsolute)(locator))
+        return undefined;
+    const root = (0, node_path_1.resolve)(cwd, SUBAGENTS_DIR, TRANSCRIPTS_DIR);
+    const candidate = (0, node_path_1.resolve)(cwd, locator);
+    if (candidate !== root && !candidate.startsWith(`${root}${node_path_1.sep}`))
+        return undefined;
+    return candidate;
+}
+/** Return true only when a valid project-local transcript file exists. */
+function hasAgentHistory(cwd, locator) {
+    if (!locator)
+        return false;
+    const path = resolveAgentHistoryPath(cwd, locator);
+    return path !== undefined && (0, node_fs_1.existsSync)(path);
+}
+/**
+ * Read persisted transcript entries into the message shape used by the live
+ * conversation viewer. Malformed lines and unknown records are skipped so one
+ * damaged entry cannot hide the rest of a history.
+ */
+function readAgentHistory(cwd, locator) {
+    const path = resolveAgentHistoryPath(cwd, locator);
+    if (!path)
+        return undefined;
+    let raw;
+    try {
+        raw = (0, node_fs_1.readFileSync)(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    if (raw.length > MAX_HISTORY_BYTES)
+        raw = raw.slice(0, MAX_HISTORY_BYTES);
+    const messages = [];
+    for (const line of raw.split(/\r?\n/)) {
+        if (!line.trim())
+            continue;
+        try {
+            const entry = JSON.parse(line);
+            const message = entry.message;
+            if (!message || typeof message !== "object")
+                continue;
+            const role = message.role;
+            if (typeof role !== "string")
+                continue;
+            messages.push(message);
+        }
+        catch {
+            // Ignore malformed/truncated JSONL records.
+        }
+    }
+    return messages.length > 0 ? messages : undefined;
+}

package/dist/agent-manager.js

@@ -57,6 +57,12 @@ function isRestorableRecord(value) {
     if (!value || typeof value !== "object")
         return false;
     const record = value;
+    const transcriptPath = record.transcriptPath;
+    const validTranscriptPath = transcriptPath === undefined ||
+        (typeof transcriptPath === "string" &&
+            transcriptPath.startsWith(".pi-subagents/agent-transcripts/") &&
+            !transcriptPath.includes("..") &&
+            !transcriptPath.includes("\\"));
     return (typeof record.id === "string" &&
         record.id.length > 0 &&
         typeof record.type === "string" &&
@@ -67,7 +73,8 @@ function isRestorableRecord(value) {
         typeof record.completedAt === "number" &&
         Number.isFinite(record.completedAt) &&
         (record.result === undefined || typeof record.result === "string") &&
-        (record.error === undefined || typeof record.error === "string"));
+        (record.error === undefined || typeof record.error === "string") &&
+        validTranscriptPath);
 }
 class AgentManager {
     agents = new Map();
@@ -478,6 +485,7 @@ class AgentManager {
                 status: value.status,
                 result: value.result,
                 error: value.error,
+                transcriptPath: value.transcriptPath,
                 toolUses: 0,
                 startedAt: value.startedAt,
                 completedAt: value.completedAt,

package/dist/index.js

@@ -10,39 +10,6 @@
  * Commands:
  *   /agents                 — Interactive agent management menu
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderRunningAgentStatus = renderRunningAgentStatus;
 exports.default = default_1;
@@ -60,6 +27,7 @@ const enabled_models_js_1 = require("./enabled-models.js");
 const group_join_js_1 = require("./group-join.js");
 const invocation_config_js_1 = require("./invocation-config.js");
 const model_resolver_js_1 = require("./model-resolver.js");
+const agent_history_js_1 = require("./agent-history.js");
 const output_file_js_1 = require("./output-file.js");
 const schedule_js_1 = require("./schedule.js");
 const schedule_store_js_1 = require("./schedule-store.js");
@@ -443,11 +411,14 @@ function default_1(pi) {
         else {
             pi.events.emit("subagents:completed", eventData);
         }
-        // Persist final record for cross-extension history reconstruction
+        // Persist final record for cross-extension history reconstruction. Keep
+        // the transcript body in a project-local file rather than inflating the
+        // parent session JSONL; only its project-relative locator is persisted.
         pi.appendEntry("subagents:record", {
             id: record.id, type: record.type, description: record.description,
             status: record.status, result: record.result, error: record.error,
             startedAt: record.startedAt, completedAt: record.completedAt,
+            transcriptPath: record.transcriptPath,
         });
         // Skip notification if result was already consumed via get_subagent_result
         if (record.resultConsumed) {
@@ -544,12 +515,23 @@ function default_1(pi) {
     // bound session_start, so a filtered-out activation never advertises (#142).
     pi.on("session_start", async (_event, ctx) => {
         currentCtx = ctx;
+        try {
+            (0, agent_history_js_1.ensureSubagentsGitignore)(ctx.cwd);
+        }
+        catch (err) {
+            console.warn("[pi-subagents] Failed to protect project-local history:", err);
+        }
         manager.clearCompleted(true);
         const historicalRecords = ctx.sessionManager
             .getBranch()
             .filter((entry) => entry?.type === "custom" && entry.customType === "subagents:record")
             .map((entry) => entry.data);
         manager.restoreCompleted(historicalRecords);
+        // Bind the UI here as well as on tool execution so rehydrated terminal
+        // records are immediately visible and openable from FleetView after reload.
+        widget.setUICtx(ctx.ui);
+        fleet.setUICtx(ctx.ui);
+        fleet.update();
         // Guard mirrors the `!scheduler.isActive()` pattern below: session_start
         // fires once per activation, but a double-bind must not leak listeners.
         if (!rpcHandle) {
@@ -599,10 +581,10 @@ function default_1(pi) {
     // everything else; "off" = hide the widget entirely. Read live at render time.
     let widgetMode = "background";
     function getWidgetMode() { return widgetMode; }
-    const widget = new agent_widget_js_1.AgentWidget(manager, agentActivity, getWidgetMode);
+    const widget = new agent_widget_js_1.AgentWidget(manager, agentActivity, getWidgetMode, () => currentCtx?.cwd);
     function setWidgetMode(m) { widgetMode = m; widget.update(); }
     // Claude Code-style FleetView: navigable list of main + subagents below the editor.
-    const fleet = new fleet_list_js_1.FleetList(manager, agentActivity);
+    const fleet = new fleet_list_js_1.FleetList(manager, agentActivity, () => currentCtx?.cwd);
     let fleetViewEnabled = true;
     function isFleetViewEnabled() { return fleetViewEnabled; }
     function setFleetViewEnabled(b) { fleetViewEnabled = b; fleet.setEnabled(b); }
@@ -1072,6 +1054,19 @@ Terse command-style prompts produce shallow, generic work.
                     return;
                 rec.outputFile = (0, output_file_js_1.createOutputFilePath)(ctx.cwd, agentId, ctx.sessionManager.getSessionId());
                 (0, output_file_js_1.writeInitialEntry)(rec.outputFile, agentId, params.prompt, ctx.cwd);
+                // Keep the existing /tmp output for compatibility, while also writing a
+                // durable project-local copy for reload-safe, read-only history viewing.
+                try {
+                    rec.historyFile = (0, agent_history_js_1.createAgentHistoryPath)(ctx.cwd, agentId, subagentType);
+                    rec.transcriptPath = (0, agent_history_js_1.agentHistoryLocator)(ctx.cwd, rec.historyFile);
+                    (0, output_file_js_1.writeInitialEntry)(rec.historyFile, agentId, params.prompt, ctx.cwd);
+                }
+                catch (err) {
+                    // History is best effort; never disable the existing output transcript.
+                    rec.historyFile = undefined;
+                    rec.transcriptPath = undefined;
+                    console.warn("[pi-subagents] Failed to create durable transcript:", err);
+                }
             };
             const parentModelId = ctx.model?.id;
             const effectiveModelId = model?.id;
@@ -1172,7 +1167,7 @@ Terse command-style prompts produce shallow, generic work.
                     origBgOnSession(session);
                     const rec = manager.getRecord(id);
                     if (rec?.outputFile) {
-                        rec.outputCleanup = (0, output_file_js_1.streamToOutputFile)(session, rec.outputFile, id, ctx.cwd);
+                        rec.outputCleanup = (0, output_file_js_1.streamToOutputFile)(session, rec.outputFile, id, ctx.cwd, rec.historyFile);
                     }
                 };
                 try {
@@ -1278,7 +1273,7 @@ Terse command-style prompts produce shallow, generic work.
                 if (fgId) {
                     const rec = manager.getRecord(fgId);
                     if (rec?.outputFile) {
-                        rec.outputCleanup = (0, output_file_js_1.streamToOutputFile)(session, rec.outputFile, fgId, ctx.cwd);
+                        rec.outputCleanup = (0, output_file_js_1.streamToOutputFile)(session, rec.outputFile, fgId, ctx.cwd, rec.historyFile);
                     }
                 }
             };
@@ -1622,7 +1617,7 @@ Terse command-style prompts produce shallow, generic work.
         }
     }
     async function showRunningAgents(ctx) {
-        const agents = manager.listAgents();
+        const agents = manager.listAgents().filter((record) => record.session !== undefined || (0, agent_history_js_1.hasAgentHistory)(ctx.cwd, record.transcriptPath));
         if (agents.length === 0) {
             ctx.ui.notify("No agents.", "info");
             return;
@@ -1649,15 +1644,25 @@ Terse command-style prompts produce shallow, generic work.
             ctx.ui.notify(`Agent is ${record.status === "queued" ? "queued" : "expired"} — no session available.`, "info");
             return;
         }
-        const { ConversationViewer, VIEWPORT_HEIGHT_PCT } = await Promise.resolve().then(() => __importStar(require("./ui/conversation-viewer.js")));
-        const session = record.session;
+        const { ConversationViewer, VIEWPORT_HEIGHT_PCT, createStaticConversationSource } = await import("./ui/conversation-viewer.js");
+        const session = record.session ?? (record.transcriptPath
+            ? (() => {
+                const messages = (0, agent_history_js_1.readAgentHistory)(ctx.cwd, record.transcriptPath);
+                return messages ? createStaticConversationSource(messages) : undefined;
+            })()
+            : undefined);
+        if (!session) {
+            ctx.ui.notify(`Agent is ${record.status === "queued" ? "queued" : "expired"} — no history available.`, "info");
+            return;
+        }
         const activity = agentActivity.get(record.id);
+        const isLive = record.session !== undefined;
         await ctx.ui.custom((tui, theme, keybindings, done) => {
-            return new ConversationViewer(tui, session, record, activity, theme, done, () => {
+            return new ConversationViewer(tui, session, record, activity, theme, done, isLive ? () => {
                 if (manager.abort(record.id)) {
                     ctx.ui.notify(`Stopped "${record.description}".`, "info");
                 }
-            }, keybindings, (message) => manager.steer(record.id, message));
+            } : undefined, keybindings, isLive ? (message) => manager.steer(record.id, message) : undefined);
         }, {
             overlay: true,
             overlayOptions: { anchor: "center", width: "90%", maxHeight: `${VIEWPORT_HEIGHT_PCT}%` },
@@ -1698,7 +1703,7 @@ Terse command-style prompts produce shallow, generic work.
             const content = (0, node_fs_1.readFileSync)(file.path, "utf-8");
             const edited = await ctx.ui.editor(`Edit ${name}`, content);
             if (edited !== undefined && edited !== content) {
-                const { writeFileSync } = await Promise.resolve().then(() => __importStar(require("node:fs")));
+                const { writeFileSync } = await import("node:fs");
                 writeFileSync(file.path, edited, "utf-8");
                 reloadCustomAgents();
                 ctx.ui.notify(`Updated ${file.path}`, "info");
@@ -1786,7 +1791,7 @@ Terse command-style prompts produce shallow, generic work.
         if (cfg.isolation)
             fmFields.push(`isolation: ${cfg.isolation}`);
         const content = `---\n${fmFields.join("\n")}\n---\n\n${cfg.systemPrompt}\n`;
-        const { writeFileSync } = await Promise.resolve().then(() => __importStar(require("node:fs")));
+        const { writeFileSync } = await import("node:fs");
         writeFileSync(targetPath, content, "utf-8");
         reloadCustomAgents();
         ctx.ui.notify(`Ejected ${name} to ${targetPath}`, "info");
@@ -1802,7 +1807,7 @@ Terse command-style prompts produce shallow, generic work.
                 return;
             }
             const updated = content.replace(/^---\n/, "---\nenabled: false\n");
-            const { writeFileSync } = await Promise.resolve().then(() => __importStar(require("node:fs")));
+            const { writeFileSync } = await import("node:fs");
             writeFileSync(file.path, updated, "utf-8");
             reloadCustomAgents();
             ctx.ui.notify(`Disabled ${name} (${file.path})`, "info");
@@ -1818,7 +1823,7 @@ Terse command-style prompts produce shallow, generic work.
         const targetDir = location.startsWith("Project") ? projectAgentsDir() : personalAgentsDir();
         (0, node_fs_1.mkdirSync)(targetDir, { recursive: true });
         const targetPath = (0, node_path_1.join)(targetDir, `${name}.md`);
-        const { writeFileSync } = await Promise.resolve().then(() => __importStar(require("node:fs")));
+        const { writeFileSync } = await import("node:fs");
         writeFileSync(targetPath, "---\nenabled: false\n---\n", "utf-8");
         reloadCustomAgents();
         ctx.ui.notify(`Disabled ${name} (${targetPath})`, "info");
@@ -1830,7 +1835,7 @@ Terse command-style prompts produce shallow, generic work.
             return;
         const content = (0, node_fs_1.readFileSync)(file.path, "utf-8");
         const updated = content.replace(/^(---\n)enabled: false\n/, "$1");
-        const { writeFileSync } = await Promise.resolve().then(() => __importStar(require("node:fs")));
+        const { writeFileSync } = await import("node:fs");
         // If the file was just a stub ("---\n---\n"), delete it to restore the built-in default
         if (updated.trim() === "---\n---" || updated.trim() === "---\n---\n") {
             (0, node_fs_1.unlinkSync)(file.path);
@@ -2013,7 +2018,7 @@ ${systemPrompt}
             if (!overwrite)
                 return;
         }
-        const { writeFileSync } = await Promise.resolve().then(() => __importStar(require("node:fs")));
+        const { writeFileSync } = await import("node:fs");
         writeFileSync(targetPath, content, "utf-8");
         reloadCustomAgents();
         ctx.ui.notify(`Created ${targetPath}`, "info");

package/dist/output-file.d.ts

@@ -21,4 +21,4 @@ export declare function writeInitialEntry(path: string, agentId: string, prompt:
  * Subscribe to session events and flush new messages to the output file on each turn_end.
  * Returns a cleanup function that does a final flush and unsubscribes.
  */
-export declare function streamToOutputFile(session: AgentSession, path: string, agentId: string, cwd: string): () => void;
+export declare function streamToOutputFile(session: AgentSession, path: string, agentId: string, cwd: string, historyPath?: string): () => void;

package/dist/output-file.js

@@ -60,7 +60,8 @@ function writeInitialEntry(path, agentId, prompt, cwd) {
  * Subscribe to session events and flush new messages to the output file on each turn_end.
  * Returns a cleanup function that does a final flush and unsubscribes.
  */
-function streamToOutputFile(session, path, agentId, cwd) {
+function streamToOutputFile(session, path, agentId, cwd, historyPath) {
+    const outputPaths = historyPath && historyPath !== path ? [path, historyPath] : [path];
     let writtenCount = 1; // initial user prompt already written
     const flush = () => {
         const messages = session.messages;
@@ -74,10 +75,12 @@ function streamToOutputFile(session, path, agentId, cwd) {
                 timestamp: new Date().toISOString(),
                 cwd,
             };
-            try {
-                (0, node_fs_1.appendFileSync)(path, JSON.stringify(entry) + "\n", "utf-8");
+            for (const outputPath of outputPaths) {
+                try {
+                    (0, node_fs_1.appendFileSync)(outputPath, JSON.stringify(entry) + "\n", "utf-8");
+                }
+                catch { /* ignore write errors */ }
             }
-            catch { /* ignore write errors */ }
             writtenCount++;
         }
     };

package/dist/types.d.ts

@@ -103,6 +103,10 @@ export interface AgentRecord {
     toolCallId?: string;
     /** Path to the streaming output transcript file. */
     outputFile?: string;
+    /** Absolute path to the durable project-local transcript while live. */
+    historyFile?: string;
+    /** Project-relative durable transcript path persisted in the parent session. */
+    transcriptPath?: string;
     /** Cleanup function for the output file stream subscription. */
     outputCleanup?: () => void;
     /**

package/dist/ui/agent-widget.d.ts

@@ -102,6 +102,8 @@ export declare class AgentWidget {
      * extension supplies one defaulting to `"background"`.
      */
     private mode;
+    /** Current project cwd used to validate reload-restored transcripts. */
+    private getCwd;
     private uiCtx;
     private widgetFrame;
     private widgetInterval;
@@ -121,7 +123,9 @@ export declare class AgentWidget {
      * `WidgetMode`. Defaults to `"all"` when a caller supplies no policy; the
      * extension supplies one defaulting to `"background"`.
      */
-    mode?: () => WidgetMode);
+    mode?: () => WidgetMode, 
+    /** Current project cwd used to validate reload-restored transcripts. */
+    getCwd?: () => string | undefined);
     /**
      * Agents eligible for the widget, per the current `WidgetMode`:
      *   - `off`: none (the widget's existing empty-state path hides it entirely).

package/dist/ui/agent-widget.js

@@ -18,6 +18,7 @@ exports.getPromptModeLabel = getPromptModeLabel;
 exports.buildInvocationTags = buildInvocationTags;
 exports.describeActivity = describeActivity;
 const pi_tui_1 = require("@earendil-works/pi-tui");
+const agent_history_js_1 = require("../agent-history.js");
 const agent_types_js_1 = require("../agent-types.js");
 const usage_js_1 = require("../usage.js");
 // ---- Constants ----
@@ -155,6 +156,7 @@ class AgentWidget {
     manager;
     agentActivity;
     mode;
+    getCwd;
     uiCtx;
     widgetFrame = 0;
     widgetInterval;
@@ -174,10 +176,13 @@ class AgentWidget {
      * `WidgetMode`. Defaults to `"all"` when a caller supplies no policy; the
      * extension supplies one defaulting to `"background"`.
      */
-    mode = () => "all") {
+    mode = () => "all", 
+    /** Current project cwd used to validate reload-restored transcripts. */
+    getCwd = () => undefined) {
         this.manager = manager;
         this.agentActivity = agentActivity;
         this.mode = mode;
+        this.getCwd = getCwd;
     }
     /**
      * Agents eligible for the widget, per the current `WidgetMode`:
@@ -191,7 +196,12 @@ class AgentWidget {
      *   - `all`: every agent.
      */
     widgetAgents() {
-        const all = this.manager.listAgents();
+        const all = this.manager.listAgents().filter((record) => {
+            if (record.status === "running" || record.status === "queued")
+                return true;
+            const cwd = this.getCwd();
+            return cwd !== undefined && (0, agent_history_js_1.hasAgentHistory)(cwd, record.transcriptPath);
+        });
         switch (this.mode()) {
             case "off": return [];
             case "background": return all.filter(a => a.isBackground !== false);

package/dist/ui/conversation-viewer.d.ts

@@ -12,6 +12,9 @@ import { type AgentActivity } from "./agent-widget.js";
 import { type ViewerKeybindings } from "./viewer-keys.js";
 /** Height ceiling shared by the overlay's `maxHeight` and the viewer's internal viewport cap. */
 export declare const VIEWPORT_HEIGHT_PCT = 70;
+/** The live fields needed by the viewer; historical viewers use a static source. */
+export type ConversationSource = Pick<AgentSession, "messages" | "subscribe">;
+export declare function createStaticConversationSource(messages: AgentSession["messages"]): ConversationSource;
 export declare class ConversationViewer implements Component {
     private tui;
     private session;
@@ -33,7 +36,7 @@ export declare class ConversationViewer implements Component {
     private keys;
     /** Steering composer — present while the user is typing a message to the agent. */
     private composer;
-    constructor(tui: TUI, session: AgentSession, record: AgentRecord, activity: AgentActivity | undefined, theme: Theme, done: (result: undefined) => void, 
+    constructor(tui: TUI, session: ConversationSource, record: AgentRecord, activity: AgentActivity | undefined, theme: Theme, done: (result: undefined) => void, 
     /** Abort the agent shown here. Omitted → no stop affordance (e.g. read-only history). */
     onStop?: (() => void) | undefined, 
     /** User keybindings from `ctx.ui.custom()`. Omitted → hardcoded defaults. */

package/dist/ui/conversation-viewer.js

@@ -7,6 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConversationViewer = exports.VIEWPORT_HEIGHT_PCT = void 0;
+exports.createStaticConversationSource = createStaticConversationSource;
 const pi_tui_1 = require("@earendil-works/pi-tui");
 const context_js_1 = require("../context.js");
 const usage_js_1 = require("../usage.js");
@@ -17,6 +18,9 @@ const CHROME_LINES_BASE = 6;
 const MIN_VIEWPORT = 3;
 /** Height ceiling shared by the overlay's `maxHeight` and the viewer's internal viewport cap. */
 exports.VIEWPORT_HEIGHT_PCT = 70;
+function createStaticConversationSource(messages) {
+    return { messages, subscribe: () => () => { } };
+}
 class ConversationViewer {
     tui;
     session;

package/dist/ui/fleet-list.d.ts

@@ -44,6 +44,7 @@ export declare function formatFleetTokens(count: number): string;
 export declare class FleetList {
     private manager;
     private agentActivity;
+    private getCwd;
     private ui;
     private tui;
     private inputUnsub;
@@ -57,7 +58,7 @@ export declare class FleetList {
     /** Set while a conversation overlay is open; calling it closes the overlay. */
     private viewerClose;
     private viewingAgentId;
-    constructor(manager: AgentManager, agentActivity: Map<string, AgentActivity>);
+    constructor(manager: AgentManager, agentActivity: Map<string, AgentActivity>, getCwd?: () => string | undefined);
     setEnabled(enabled: boolean): void;
     /** Capture the UI context and (re)register the global input handler. */
     setUICtx(ui: FleetUICtx): void;
@@ -73,9 +74,11 @@ export declare class FleetList {
     update(): void;
     /**
      * Agents shown in the list, ordered earliest-launched first so the ones you
-     * started sooner sit at the top. Every row is openable (has a session), so Enter
-     * never dead-ends. Included: running/queued, plus the agent currently being
-     * viewed, plus recently-finished ones (they linger briefly before dropping out).
+     * started sooner sit at the top. Live rows are openable through their session;
+     * terminal rows are included only when their durable transcript exists. This
+     * prevents Enter from dead-ending on stale rehydrated metadata.
+     * Included: running/queued, plus the agent currently being viewed, plus
+     * recently-finished ones (they linger briefly before dropping out).
      * Pending agents with no session yet are hidden until they start.
      * (`listAgents()` is newest-first, so we re-sort.)
      */