@esso0428/pi-subagents 0.15.3 → 0.15.5

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.15.5] - 2026-09-11
+
+### Fixed
+- **The Running agents menu no longer advertises dead-end metadata.** Its summary count now uses the same live-session or existing-transcript filter as the detail list, so Enter does not open an empty list for stale restored records.
+
+## [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

package/dist/agent-history.d.ts

@@ -14,6 +14,8 @@ export declare function createAgentHistoryPath(cwd: string, agentId: string, age
 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

package/dist/agent-history.js

@@ -5,6 +5,7 @@ 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");
@@ -58,6 +59,13 @@ function resolveAgentHistoryPath(cwd, locator) {
         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

package/dist/index.js

@@ -581,7 +581,7 @@ 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, () => currentCtx?.cwd);
@@ -1503,8 +1503,10 @@ Terse command-style prompts produce shallow, generic work.
         const allNames = (0, agent_types_js_1.getAllTypes)();
         // Build select options
         const options = [];
-        // Running agents entry (only if there are active agents)
-        const agents = manager.listAgents();
+        // Only advertise agents that can actually be opened. Reload-restored
+        // metadata without a live session or durable transcript is intentionally
+        // invisible here, matching FleetView and showRunningAgents below.
+        const agents = manager.listAgents().filter((record) => record.session !== undefined || (0, agent_history_js_1.hasAgentHistory)(ctx.cwd, record.transcriptPath));
         if (agents.length > 0) {
             const running = agents.filter(a => a.status === "running" || a.status === "queued").length;
             const done = agents.filter(a => a.status === "completed" || a.status === "steered").length;
@@ -1617,7 +1619,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;

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/fleet-list.d.ts

@@ -74,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.)
      */

package/dist/ui/fleet-list.js

@@ -15,7 +15,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FleetList = void 0;
 exports.formatFleetElapsed = formatFleetElapsed;
 exports.formatFleetTokens = formatFleetTokens;
-const node_fs_1 = require("node:fs");
 const pi_tui_1 = require("@earendil-works/pi-tui");
 const agent_history_js_1 = require("../agent-history.js");
 const usage_js_1 = require("../usage.js");
@@ -167,9 +166,11 @@ class FleetList {
     // ---- Roster ----
     /**
      * 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.)
      */
@@ -181,10 +182,7 @@ class FleetList {
                 || a.id === this.viewingAgentId
                 || (a.completedAt != null && now - a.completedAt < FINISHED_LINGER_MS));
             const cwd = this.getCwd();
-            const historyPath = cwd && a.transcriptPath
-                ? (0, agent_history_js_1.resolveAgentHistoryPath)(cwd, a.transcriptPath)
-                : undefined;
-            const history = !!historyPath && (0, node_fs_1.existsSync)(historyPath);
+            const history = cwd !== undefined && (0, agent_history_js_1.hasAgentHistory)(cwd, a.transcriptPath);
             return !!live || history;
         })
             .sort((a, b) => a.startedAt - b.startedAt);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esso0428/pi-subagents",
-  "version": "0.15.3",
+  "version": "0.15.5",
   "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-history.ts

@@ -1,6 +1,6 @@
 /** Durable, project-local transcript storage for subagents. */
 
-import { appendFileSync, mkdirSync, readFileSync } from "node:fs";
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 import { isAbsolute, join, relative, resolve, sep } from "node:path";
 import type { AgentSession } from "@earendil-works/pi-coding-agent";
 
@@ -62,6 +62,13 @@ export function resolveAgentHistoryPath(cwd: string, locator: string): string |
   return candidate;
 }
 
+/** Return true only when a valid project-local transcript file exists. */
+export function hasAgentHistory(cwd: string, locator: string | undefined): boolean {
+  if (!locator) return false;
+  const path = resolveAgentHistoryPath(cwd, locator);
+  return path !== undefined && 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

package/src/index.ts

@@ -24,7 +24,7 @@ import { isModelInScope, readEnabledModels, resolveEnabledModels } from "./enabl
 import { GroupJoinManager } from "./group-join.js";
 import { resolveAgentInvocationConfig, resolveJoinMode } from "./invocation-config.js";
 import { type ModelRegistry, resolveModel } from "./model-resolver.js";
-import { agentHistoryLocator, createAgentHistoryPath, readAgentHistory, ensureSubagentsGitignore } from "./agent-history.js";
+import { agentHistoryLocator, createAgentHistoryPath, ensureSubagentsGitignore, hasAgentHistory, readAgentHistory } from "./agent-history.js";
 import { createOutputFilePath, streamToOutputFile, writeInitialEntry } from "./output-file.js";
 import { SubagentScheduler } from "./schedule.js";
 import { resolveStorePath, ScheduleStore } from "./schedule-store.js";
@@ -640,7 +640,7 @@ export default function (pi: ExtensionAPI) {
   // everything else; "off" = hide the widget entirely. Read live at render time.
   let widgetMode: WidgetMode = "background";
   function getWidgetMode(): WidgetMode { return widgetMode; }
-  const widget = new AgentWidget(manager, agentActivity, getWidgetMode);
+  const widget = new AgentWidget(manager, agentActivity, getWidgetMode, () => currentCtx?.cwd);
   function setWidgetMode(m: WidgetMode): void { widgetMode = m; widget.update(); }
 
   // Claude Code-style FleetView: navigable list of main + subagents below the editor.
@@ -1667,8 +1667,12 @@ Terse command-style prompts produce shallow, generic work.
     // Build select options
     const options: string[] = [];
 
-    // Running agents entry (only if there are active agents)
-    const agents = manager.listAgents();
+    // Only advertise agents that can actually be opened. Reload-restored
+    // metadata without a live session or durable transcript is intentionally
+    // invisible here, matching FleetView and showRunningAgents below.
+    const agents = manager.listAgents().filter((record) =>
+      record.session !== undefined || hasAgentHistory(ctx.cwd, record.transcriptPath),
+    );
     if (agents.length > 0) {
       const running = agents.filter(a => a.status === "running" || a.status === "queued").length;
       const done = agents.filter(a => a.status === "completed" || a.status === "steered").length;
@@ -1789,7 +1793,9 @@ Terse command-style prompts produce shallow, generic work.
   }
 
   async function showRunningAgents(ctx: ExtensionCommandContext) {
-    const agents = manager.listAgents();
+    const agents = manager.listAgents().filter((record) =>
+      record.session !== undefined || hasAgentHistory(ctx.cwd, record.transcriptPath),
+    );
     if (agents.length === 0) {
       ctx.ui.notify("No agents.", "info");
       return;

package/src/ui/agent-widget.ts

@@ -6,6 +6,7 @@
  */
 
 import { truncateToWidth } from "@earendil-works/pi-tui";
+import { hasAgentHistory } from "../agent-history.js";
 import type { AgentManager } from "../agent-manager.js";
 import { getConfig } from "../agent-types.js";
 import type { AgentInvocation, SubagentType, WidgetMode } from "../types.js";
@@ -237,6 +238,8 @@ export class AgentWidget {
      * extension supplies one defaulting to `"background"`.
      */
     private mode: () => WidgetMode = () => "all",
+    /** Current project cwd used to validate reload-restored transcripts. */
+    private getCwd: () => string | undefined = () => undefined,
   ) {}
 
   /**
@@ -251,7 +254,11 @@ export class AgentWidget {
    *   - `all`: every agent.
    */
   private 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 && hasAgentHistory(cwd, record.transcriptPath);
+    });
     switch (this.mode()) {
       case "off": return [];
       case "background": return all.filter(a => a.isBackground !== false);

package/src/ui/fleet-list.ts

@@ -11,10 +11,9 @@
  * can `consume` keys — gated on `getEditorText() === ""` so normal typing is untouched.
  */
 
-import { existsSync } from "node:fs";
 import { Editor, isKeyRelease, Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import type { AgentManager } from "../agent-manager.js";
-import { readAgentHistory, resolveAgentHistoryPath } from "../agent-history.js";
+import { hasAgentHistory, readAgentHistory } from "../agent-history.js";
 import type { AgentRecord } from "../types.js";
 import { getLifetimeTotal } from "../usage.js";
 import { type AgentActivity, getDisplayName, type Theme } from "./agent-widget.js";
@@ -182,9 +181,11 @@ export class FleetList {
 
   /**
    * 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.)
    */
@@ -198,10 +199,7 @@ export class FleetList {
           || (a.completedAt != null && now - a.completedAt < FINISHED_LINGER_MS)
         );
         const cwd = this.getCwd();
-        const historyPath = cwd && a.transcriptPath
-          ? resolveAgentHistoryPath(cwd, a.transcriptPath)
-          : undefined;
-        const history = !!historyPath && existsSync(historyPath);
+        const history = cwd !== undefined && hasAgentHistory(cwd, a.transcriptPath);
         return !!live || history;
       })
       .sort((a, b) => a.startedAt - b.startedAt);

package/test/agent-history.test.ts

@@ -6,6 +6,7 @@ import {
   agentHistoryLocator,
   createAgentHistoryPath,
   ensureSubagentsGitignore,
+  hasAgentHistory,
   readAgentHistory,
   resolveAgentHistoryPath,
 } from "../src/agent-history.js";
@@ -48,10 +49,13 @@ describe("project-local subagent history", () => {
 
     expect(locator).toBe(".pi-subagents/agent-transcripts/agent-1_Explore_transcript.jsonl");
     expect(resolveAgentHistoryPath(cwd, locator)).toBe(historyPath);
+    expect(hasAgentHistory(cwd, locator)).toBe(false);
+    expect(hasAgentHistory(cwd, ".pi-subagents/other.jsonl")).toBe(false);
     expect(resolveAgentHistoryPath(cwd, ".pi-subagents/other.jsonl")).toBeUndefined();
     expect(resolveAgentHistoryPath(cwd, ".pi-subagents/agent-transcripts/../other.jsonl")).toBeUndefined();
 
     writeInitialEntry(historyPath, "agent-1", "hello", cwd);
+    expect(hasAgentHistory(cwd, locator)).toBe(true);
     const messages = readAgentHistory(cwd, locator);
     expect(messages).toHaveLength(1);
     expect(messages?.[0]).toMatchObject({ role: "user", content: "hello" });