@ian-pascoe/pi-minimal-subagents 0.6.6 → 0.7.0

package/README.md

@@ -29,7 +29,7 @@ filter in `~/.pi/agent/settings.json` using the repository-relative path:
 ```
 
 From this package checkout, load the source directly with
-`pi -e ./src/index.ts`. Requires Node `>=22.19.0` and Pi `>=0.84.1`.
+`pi -e ./src/index.ts`. Requires Node `>=22.19.0` and Pi `>=0.85.1`.
 
 ## Configuration
 
@@ -251,14 +251,38 @@ source file; it never substitutes the source session's newer head.
 
 ## Status and TUI
 
-In TUI mode, `/subagents status` opens a live read-only hierarchy. Rows begin
-collapsed; use Up/Down to select, Enter to expand Recent Activity, the configured
-tool-expansion key to reveal tool output, page keys to scroll, and Escape to
-close. Expanded activity uses Pi's transcript components, updates once per
-second, remains bounded, and omits images. The header reports the effective
-access source, authored settings, direct running/idle counts, and actual
-Coordinator Tool activation. Partial external activation is reported as
-`N/6 active`; status does not repair it.
+In TUI mode, `/subagents` or `/subagents status` opens a large, centered,
+framed overlay. Up/Down selects a Child Agent; Enter opens its Child Session
+Transcript. Escape returns to the tree, then Escape closes the overlay. The
+viewer is read-only: Root Agent input and ongoing agent work remain intact.
+
+Two consecutive Left Arrow presses within 500 ms open the same viewer when
+the main editor is focused and completely empty. Drafts (including whitespace),
+dialogs, and other overlays retain normal navigation. Explicit key-repeat
+reports are ignored; legacy terminals cannot distinguish holding Left from
+two presses.
+
+The viewer and compact widget prioritize sibling subtrees containing running
+Child Agents. Idle ancestors move with active descendants, parents stay above
+their children, and equally active siblings retain their original order. Viewer
+selection follows the Child Agent's identity through live reordering.
+
+The transcript includes inherited context, earlier turns, pre-compaction
+messages, and live output on the selected saved branch. Abandoned branches and
+internal bookkeeping are excluded. Saved history can be inspected without
+restoring a runtime; missing or unverified sessions report an explanation rather
+than substituting another branch. Model-facing Recent Activity remains bounded.
+
+Transcripts open at the latest output and refresh once per second. Up/Down
+scrolls by line, Page Up/Page Down by page. Scrolling up pauses following; End
+returns to live output. Reading position is retained through resize and tool
+expansion. Reasoning is visible, tool output starts collapsed, and Pi's configured
+tool-expansion key (normally Ctrl+O) reveals it. Images appear as explicit text
+placeholders rather than inline images.
+
+The tree header reports the effective access source, authored settings, direct
+running/idle counts, and actual Coordinator Tool activation. Partial external
+activation is reported as `N/6 active`; status does not repair it.
 
 RPC mode receives a concise status notification. JSON and print modes produce
 no observer-only output.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ian-pascoe/pi-minimal-subagents",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "private": false,
   "description": "Persistent nested subagents with bounded delegation for Pi",
   "keywords": [

package/src/minimal-subagents-context.ts

@@ -8,8 +8,6 @@ import type {
 } from "./minimal-subagents-types.js";
 
 const RECENT_AGENT_ACTIVITY_LIMIT = 12;
-const CHILD_AGENT_TRANSCRIPT_MESSAGE_LIMIT = 24;
-const CHILD_AGENT_TRANSCRIPT_PAIR_WINDOW = CHILD_AGENT_TRANSCRIPT_MESSAGE_LIMIT * 2;
 const RECENT_AGENT_ACTIVITY_MAX_LINES = 20;
 const RECENT_AGENT_ACTIVITY_MAX_BYTES = 2 * 1024;
 
@@ -47,110 +45,45 @@ function visibleMessageContent(content: string | readonly (TextContent | ImageCo
   return contentText(content, "\n\n") || "(no text content)";
 }
 
-function omitAgentMessageImages(message: AgentMessage): AgentMessage {
+function replaceAgentMessageImages(message: AgentMessage): AgentMessage {
   if (message.role === "user" || message.role === "custom") {
     return {
       ...structuredClone(message),
       content: Array.isArray(message.content)
-        ? message.content
-            .filter((content) => content.type !== "image")
-            .map((content) => structuredClone(content))
+        ? message.content.map((content) =>
+            content.type === "image"
+              ? { type: "text" as const, text: `[Image: ${content.mimeType}]` }
+              : structuredClone(content),
+          )
         : message.content,
     };
   }
   if (message.role === "toolResult") {
     return {
       ...structuredClone(message),
-      content: message.content
-        .filter((content) => content.type !== "image")
-        .map((content) => structuredClone(content)),
+      content: message.content.map((content) =>
+        content.type === "image"
+          ? { type: "text" as const, text: `[Image: ${content.mimeType}]` }
+          : structuredClone(content),
+      ),
     };
   }
   return structuredClone(message);
 }
 
-interface IndexedTranscriptMessage {
-  message: AgentMessage;
-  originalIndex: number;
-  streaming: boolean;
-}
-
-/** Select at most 48 recent raw messages, retaining cross-cutoff tool pairs and omitting images. */
+/** Clone the complete visible UI transcript, replacing images without bounding conversation history. */
 export function selectChildAgentTranscript(
   messages: readonly AgentMessage[],
   streamingAssistantMessage?: AgentMessage,
 ): ChildAgentTranscriptSnapshot {
-  const pairWindow = messages.slice(-CHILD_AGENT_TRANSCRIPT_PAIR_WINDOW);
-  const firstWindowIndex = messages.length - pairWindow.length;
-  const indexed: IndexedTranscriptMessage[] = [
-    ...pairWindow.map((message, windowIndex) => ({
-      message,
-      originalIndex: firstWindowIndex + windowIndex,
-      streaming: false,
-    })),
-    ...(streamingAssistantMessage
-      ? [
-          {
-            message: streamingAssistantMessage,
-            originalIndex: messages.length,
-            streaming: true,
-          },
-        ]
-      : []),
-  ];
-  const tail = indexed.slice(-CHILD_AGENT_TRANSCRIPT_MESSAGE_LIMIT).map((item) => ({
-    ...item,
-    message: omitAgentMessageImages(item.message),
-  }));
-  const selectedIndexes = new Set(tail.map(({ originalIndex }) => originalIndex));
-  const calls = new Map<
-    string,
-    { originalIndex: number; assistant: Extract<AgentMessage, { role: "assistant" }> }
-  >();
-  for (const item of indexed) {
-    if (item.message.role !== "assistant") continue;
-    for (const content of item.message.content) {
-      if (content.type === "toolCall") {
-        calls.set(content.id, { originalIndex: item.originalIndex, assistant: item.message });
-      }
-    }
-  }
-
-  const retained = tail.filter(
-    (item) => item.message.role !== "toolResult" || calls.has(item.message.toolCallId),
-  );
-  const missingCalls = new Map<
-    number,
-    { assistant: Extract<AgentMessage, { role: "assistant" }>; callIds: Set<string> }
-  >();
-  for (const item of retained) {
-    if (item.message.role !== "toolResult") continue;
-    const call = calls.get(item.message.toolCallId);
-    if (!call || selectedIndexes.has(call.originalIndex)) continue;
-    const missing = missingCalls.get(call.originalIndex) ?? {
-      assistant: call.assistant,
-      callIds: new Set<string>(),
-    };
-    missing.callIds.add(item.message.toolCallId);
-    missingCalls.set(call.originalIndex, missing);
-  }
-  const prefixes: IndexedTranscriptMessage[] = [...missingCalls.entries()]
-    .sort(([left], [right]) => left - right)
-    .map(([originalIndex, missing]) => ({
-      message: {
-        ...structuredClone(missing.assistant),
-        content: missing.assistant.content
-          .filter((content) => content.type === "toolCall" && missing.callIds.has(content.id))
-          .map((content) => structuredClone(content)),
-      },
-      originalIndex,
-      streaming: false,
-    }));
-  const selected = [...prefixes, ...retained];
-  const streamingAssistantIndex = selected.findIndex(({ streaming }) => streaming);
+  const visible = messages.filter((message) => message.role !== "custom" || message.display);
+  const streaming = streamingAssistantMessage && !messages.includes(streamingAssistantMessage);
   return {
-    messages: selected.map(({ message }) => message),
-    streamingAssistantIndex: streamingAssistantIndex >= 0 ? streamingAssistantIndex : undefined,
+    messages: [
+      ...visible.map(replaceAgentMessageImages),
+      ...(streaming ? [replaceAgentMessageImages(streamingAssistantMessage)] : []),
+    ],
+    streamingAssistantIndex: streaming ? visible.length : undefined,
     toolDefinitions: [],
   };
 }

package/src/minimal-subagents-coordinator.ts

@@ -452,14 +452,22 @@ export class MinimalSubagentsCoordinator {
     };
   }
 
-  /** Lazily inspect one Child Agent's bounded process-local transcript for trusted UI. */
+  /** Lazily inspect one Child Session Transcript without restoring a missing runtime. */
   inspectTranscript(agentId: string): ChildAgentTranscriptSnapshot {
     const agent = this.requireAgent(agentId);
     const runtime = this.runtimes.get(agentId);
     const liveSnapshot = runtime?.snapshotActivityTranscript?.();
     if (liveSnapshot) return liveSnapshot;
     if (runtime) return selectChildAgentTranscript(runtime.snapshotActivityMessages());
+    let historyError: string | undefined;
+    try {
+      const saved = this.dependencies.sessions.readTranscript?.(agent);
+      if (saved) return saved;
+    } catch (error) {
+      historyError = error instanceof Error ? error.message : String(error);
+    }
     const fallback =
+      historyError ||
       agent.unavailable_reason ||
       agent.latest_result?.error ||
       agent.latest_result?.output ||

package/src/minimal-subagents-extension.ts

@@ -2,6 +2,7 @@ import { fileURLToPath } from "node:url";
 import type { AgentMessage } from "@earendil-works/pi-agent-core";
 import {
   buildSessionContext,
+  CustomEditor,
   getAgentDir,
   SessionManager,
   SettingsManager,
@@ -9,6 +10,7 @@ import {
   type ExtensionCommandContext,
   type ExtensionContext,
   type ExtensionFactory,
+  type ExtensionUIContext,
   type MessageEndEvent,
   type SessionBeforeForkEvent,
   type SessionEntry,
@@ -16,6 +18,7 @@ import {
   type SessionStartEvent,
   type SessionTreeEvent,
 } from "@earendil-works/pi-coding-agent";
+import { isKeyRelease, isKeyRepeat, matchesKey } from "@earendil-works/pi-tui";
 import {
   createSubagentAccessBranchRecord,
   reconcileCoordinatorToolAccess,
@@ -393,6 +396,80 @@ const productionLifecycleEffects: MinimalSubagentsLifecycleEffects = {
   createSessionFactory: (options) => new PiAgentSessionFactory(options),
 };
 
+/** Compose a focus-local key sequence without taking over the editor's other behavior. */
+function installViewerShortcut(ui: ExtensionUIContext, open: () => void) {
+  const previous = ui.getEditorComponent();
+  let active = true;
+  let previousLeftAt: number | undefined;
+  const reset = () => {
+    previousLeftAt = undefined;
+  };
+  const factory: NonNullable<ReturnType<ExtensionUIContext["getEditorComponent"]>> = (
+    tui,
+    theme,
+    keybindings,
+  ) => {
+    reset();
+    const editor =
+      previous?.(tui, theme, keybindings) ??
+      new CustomEditor(tui, theme, keybindings, { embedWorkingStatus: true });
+    let focused = false;
+    const handleInput = (data: string) => {
+      if (isKeyRelease(data)) {
+        editor.handleInput(data);
+        return;
+      }
+      if (
+        active &&
+        focused &&
+        editor.getText() === "" &&
+        matchesKey(data, "left") &&
+        !isKeyRepeat(data)
+      ) {
+        const now = performance.now();
+        if (previousLeftAt !== undefined && now - previousLeftAt <= 500) {
+          reset();
+          open();
+          return;
+        }
+        previousLeftAt = now;
+      } else {
+        reset();
+      }
+      editor.handleInput(data);
+    };
+    // Forward the editor's complete interface, including app handlers and custom methods.
+    // Binding to the original instance also preserves private fields in custom editors.
+    return new Proxy(editor, {
+      has: (target, property) => property === "focused" || Reflect.has(target, property),
+      get(target, property) {
+        if (property === "focused") return focused;
+        if (property === "handleInput") return handleInput;
+        // oxlint-disable-next-line anti-slop/no-reflect-get -- SAFETY: Forward the SDK editor's open interface, including other extensions' methods, without replacing their receiver.
+        const value = Reflect.get(target, property, target);
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- SAFETY: Proxy forwarding binds callable members; this is not parsing external input.
+        return typeof value === "function" ? value.bind(target) : value;
+      },
+      set(target, property, value) {
+        if (property === "focused") {
+          focused = value;
+          if (!focused) reset();
+        }
+        return Reflect.set(target, property, value, target);
+      },
+    });
+  };
+  ui.setEditorComponent(factory);
+  return {
+    reset,
+    dispose() {
+      active = false;
+      reset();
+      if (ui.getEditorComponent() === factory) ui.setEditorComponent(previous);
+    },
+  };
+}
+
 /** Own coordinator, UI, and prepared-fork state for one root Pi session lifecycle. */
 export class MinimalSubagentsLifecycleController {
   private coordinator: MinimalSubagentsCoordinator | undefined;
@@ -407,6 +484,7 @@ export class MinimalSubagentsLifecycleController {
   };
   private uiController: MinimalSubagentsUiController | undefined;
   private statusPanelController: MinimalSubagentsStatusPanelController | undefined;
+  private viewerShortcut: ReturnType<typeof installViewerShortcut> | undefined;
   private accessSession: ActiveSubagentAccessSession | undefined;
   private preparedFork:
     | { sourceSessionFile: string; selectedBranchSnapshot: RegistrySnapshot }
@@ -619,6 +697,14 @@ export class MinimalSubagentsLifecycleController {
       () => this.currentSubagentStatusAccess(),
     );
 
+    this.viewerShortcut?.dispose();
+    this.viewerShortcut =
+      context.mode === "tui"
+        ? installViewerShortcut(context.ui, () => {
+            void this.statusPanelController?.open();
+          })
+        : undefined;
+
     if (hasHistoricalChildIdentity(context.sessionManager.getBranch())) {
       context.ui.notify(
         "Opened a former subagent session directly. It is now an independent root; former descendants and parent messaging were not restored. Concurrent ownership by its original root is unsupported.",
@@ -666,6 +752,7 @@ export class MinimalSubagentsLifecycleController {
     _event: SessionTreeEvent,
     context: ExtensionContext,
   ): Promise<void> {
+    this.viewerShortcut?.reset();
     if (!this.coordinator) return;
     const snapshot = replayRegistryEntries(
       context.sessionManager.getBranch(),
@@ -805,6 +892,8 @@ export class MinimalSubagentsLifecycleController {
     event: SessionShutdownEvent,
     context: ExtensionContext,
   ): Promise<void> {
+    this.viewerShortcut?.dispose();
+    this.viewerShortcut = undefined;
     this.statusPanelController?.dispose();
     this.statusPanelController = undefined;
     if (this.coordinator) {

package/src/minimal-subagents-rendering.ts

@@ -39,6 +39,7 @@ import {
   type WaitRenderDetails,
 } from "./minimal-subagents-render-contract.js";
 import { stripCoordinatorMessageEnvelope } from "./minimal-subagents-message-envelope.js";
+import type { AgentSummary } from "./minimal-subagents-types.js";
 
 export type { CoordinatorToolName } from "./minimal-subagents-render-contract.js";
 
@@ -98,6 +99,23 @@ function toolResultText(result: AgentToolResult<unknown>): string {
   return text?.type === "text" ? text.text : "";
 }
 
+/** Copy the hierarchy with active subtrees first, preserving sibling ties and ancestry. */
+export function orderActiveAgentSubtrees(agents: readonly AgentSummary[]): AgentSummary[] {
+  const orderSiblings = (
+    siblings: readonly AgentSummary[],
+  ): { agent: AgentSummary; active: boolean }[] =>
+    siblings
+      .map((agent) => {
+        const children = orderSiblings(agent.children);
+        return {
+          agent: { ...agent, children: children.map((child) => child.agent) },
+          active: agent.state === "running" || children.some((child) => child.active),
+        };
+      })
+      .sort((left, right) => Number(right.active) - Number(left.active));
+  return orderSiblings(agents).map(({ agent }) => agent);
+}
+
 /** Shared unavailable → running → latest-turn → idle status ladder for one subagent. */
 export function subagentStatusLadder(agent: {
   readonly availability?: string;

package/src/minimal-subagents-sessions.ts

@@ -1,5 +1,5 @@
 import { execFile } from "node:child_process";
-import { existsSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { unlink } from "node:fs/promises";
 import { resolve } from "node:path";
 import type { AgentMessage, ThinkingLevel } from "@earendil-works/pi-agent-core";
@@ -12,6 +12,7 @@ import {
   findCutPoint,
   generateSummaryWithUsage,
   ModelRuntime,
+  parseSessionEntries,
   SessionManager,
   SettingsManager,
   sessionEntryToContextMessages,
@@ -362,6 +363,9 @@ export function verifyChildSessionIdentity(
       `Minimal subagents session identity mismatch: session ID for ${agent.agent_id}`,
     );
   }
+  if (agent.session_leaf_id && !sessionManager.getEntry(agent.session_leaf_id)) {
+    throw new Error(`Minimal subagents session identity mismatch: leaf for ${agent.agent_id}`);
+  }
   const identityBranch = sessionManager.getBranch(agent.session_leaf_id);
   const generation = findLatestForkGeneration(identityBranch);
   const identity =
@@ -401,9 +405,6 @@ export function verifyChildSessionIdentity(
       );
     }
   }
-  if (agent.session_leaf_id && !sessionManager.getEntry(agent.session_leaf_id)) {
-    throw new Error(`Minimal subagents session identity mismatch: leaf for ${agent.agent_id}`);
-  }
 }
 
 /** Find durable keyed evidence for exactly-once wait or custom-result delivery. */
@@ -532,6 +533,10 @@ export async function captureChildTurnOutcome(
 class PiChildAgentRuntime implements ChildAgentRuntime {
   private aborted = false;
   private readonly unsubscribe: () => void;
+  private transcriptLeafId: string | null | undefined;
+  private readonly transcriptEntries = new WeakMap<SessionEntry, AgentMessage[]>();
+  private transcriptMessages: AgentMessage[] = [];
+  private transcriptSources = new Set<AgentMessage>();
 
   constructor(
     private readonly session: AgentSession,
@@ -629,10 +634,46 @@ class PiChildAgentRuntime implements ChildAgentRuntime {
   }
 
   snapshotActivityTranscript(): ChildAgentTranscriptSnapshot {
-    const snapshot = selectChildAgentTranscript(
-      this.session.messages,
-      this.session.state.streamingMessage,
+    const manager = this.session.sessionManager;
+    const leafId = manager.getLeafId();
+    if (this.transcriptLeafId !== leafId) {
+      this.transcriptSources = new Set();
+      this.transcriptMessages = manager.getBranch().flatMap((entry) => {
+        const source = sessionEntryToContextMessages(entry);
+        for (const message of source) this.transcriptSources.add(message);
+        let messages = this.transcriptEntries.get(entry);
+        if (!messages) {
+          messages = selectChildAgentTranscript(source).messages;
+          this.transcriptEntries.set(entry, messages);
+        }
+        return messages;
+      });
+      this.transcriptLeafId = leafId;
+    }
+    const state = this.session.state;
+    // Native message_end finalizes agent state before async extension handlers persist it.
+    const pending = state.messages.filter(
+      (message) =>
+        (message.role === "user" ||
+          message.role === "assistant" ||
+          message.role === "toolResult") &&
+        !this.transcriptSources.has(message),
+    );
+    const streaming = state.streamingMessage;
+    const tail = selectChildAgentTranscript(
+      pending,
+      streaming && !this.transcriptSources.has(streaming) ? streaming : undefined,
     );
+    const snapshot: ChildAgentTranscriptSnapshot = {
+      messages: tail.messages.length
+        ? [...this.transcriptMessages, ...tail.messages]
+        : this.transcriptMessages,
+      streamingAssistantIndex:
+        tail.streamingAssistantIndex === undefined
+          ? undefined
+          : this.transcriptMessages.length + tail.streamingAssistantIndex,
+      toolDefinitions: [],
+    };
     const toolNames = new Set<string>();
     for (const message of snapshot.messages) {
       if (message.role !== "assistant") continue;
@@ -740,6 +781,7 @@ export class PiAgentSessionFactory implements AgentSessionFactory {
   private readonly availableToolNames: Set<string>;
   private readonly discoveredToolNames = new Map<string, Promise<Set<string>>>();
   private readonly sessionFileTrash: SessionFileTrashCapability;
+  private savedTranscript?: { key: string; snapshot: ChildAgentTranscriptSnapshot };
 
   constructor(private readonly options: PiAgentSessionFactoryOptions) {
     this.modelById = new Map(
@@ -763,6 +805,40 @@ export class PiAgentSessionFactory implements AgentSessionFactory {
     });
   }
 
+  /** Read one verified saved Child Session Position without opening a writable runtime. */
+  readTranscript(agent: PersistedAgent): ChildAgentTranscriptSnapshot {
+    if (!agent.session_file || !agent.session_id || !agent.session_leaf_id) {
+      throw new Error(`Child Session Position is unavailable for ${agent.agent_id}.`);
+    }
+    const sessionFile = canonicalPath(agent.session_file);
+    const stat = statSync(sessionFile);
+    const key = JSON.stringify([
+      sessionFile,
+      agent.agent_id,
+      agent.parent_id,
+      agent.created_at,
+      agent.session_id,
+      agent.session_leaf_id,
+      stat.dev,
+      stat.ino,
+      stat.size,
+      stat.mtimeMs,
+      stat.ctimeMs,
+    ]);
+    if (this.savedTranscript?.key === key) return this.savedTranscript.snapshot;
+    const entries = parseSessionEntries(readFileSync(sessionFile, "utf8"));
+    if (entries[0]?.type !== "session")
+      throw new Error(`Invalid child session file: ${sessionFile}`);
+    // SessionManager.open can migrate/rewrite files; an in-memory reader cannot write them.
+    const manager = SessionManager.inMemory(this.options.cwd, undefined, entries);
+    verifyChildSessionIdentity(manager, agent, this.options.rootSessionId);
+    const snapshot = selectChildAgentTranscript(
+      manager.getBranch(agent.session_leaf_id).flatMap(sessionEntryToContextMessages),
+    );
+    this.savedTranscript = { key, snapshot };
+    return snapshot;
+  }
+
   resolveLaunchMissingDependencies(agent: PersistedAgent): Promise<string[]> {
     return this.findMissingDependencies(agent, false);
   }

package/src/minimal-subagents-status-panel.ts

@@ -1,3 +1,5 @@
+import { stripVTControlCharacters } from "node:util";
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
 import { contentText } from "@earendil-works/pi-ai";
 import {
   AssistantMessageComponent,
@@ -12,10 +14,20 @@ import {
   type Theme,
   type TruncationResult,
 } from "@earendil-works/pi-coding-agent";
-import { Container, Text, truncateToWidth, type Component, type TUI } from "@earendil-works/pi-tui";
+import {
+  Container,
+  Text,
+  matchesKey,
+  truncateToWidth,
+  visibleWidth,
+  type Component,
+  type OverlayHandle,
+  type TUI,
+} from "@earendil-works/pi-tui";
 import type { MinimalSubagentsCoordinator } from "./minimal-subagents-coordinator.js";
 import {
   formatSubagentDuration,
+  orderActiveAgentSubtrees,
   renderMinimalSubagentsMessage,
   renderMinimalSubagentsResult,
   subagentStatusLadder,
@@ -29,8 +41,7 @@ import type {
 } from "./minimal-subagents-types.js";
 
 const STATUS_PANEL_REFRESH_MS = 1_000;
-const STATUS_PANEL_FIXED_LINE_COUNT = 7;
-const STATUS_PANEL_MIN_VIEWPORT_LINES = 4;
+const STATUS_PANEL_MARGIN = 1;
 const COORDINATOR_TOOL_COUNT = COORDINATOR_TOOL_NAMES.length;
 
 type StartStatusPanelRefresh = (refresh: () => void) => () => void;
@@ -58,7 +69,7 @@ function flattenStatusAgents(status: HierarchyStatusResult): FlattenedStatusAgen
     for (const child of agent.children) visit(child, depth + 1);
   };
   const roots = "agents" in status ? status.agents : [status.agent];
-  for (const agent of roots) visit(agent, 0);
+  for (const agent of orderActiveAgentSubtrees(roots)) visit(agent, 0);
   return flattened;
 }
 
@@ -79,25 +90,107 @@ function statusAccessSourceLabel(source: SubagentAccessSnapshot["source"]): stri
   }
 }
 
+interface CachedTranscriptMessage {
+  container: Container;
+  tools: Map<string, ToolExecutionComponent>;
+  expanded: boolean;
+  streaming: boolean;
+}
+
+interface TranscriptLayout {
+  lines: string[];
+  messageStarts: number[];
+}
+
+function transcriptText(line: string): string {
+  return stripVTControlCharacters(line).replace(/\s/g, "");
+}
+
+function anchoredTranscriptOffset(
+  previous: TranscriptLayout,
+  next: TranscriptLayout,
+  offset: number,
+): number {
+  const index = previous.messageStarts.findLastIndex((start) => start <= offset);
+  const previousStart = previous.messageStarts[index] ?? 0;
+  const nextStart = next.messageStarts[index] ?? 0;
+  const oldLines = previous.lines
+    .slice(previousStart, previous.messageStarts[index + 1])
+    .map(transcriptText);
+  const newLines = next.lines.slice(nextStart, next.messageStarts[index + 1]).map(transcriptText);
+  const row = offset - previousStart;
+  if (oldLines.slice(0, row + 1).every((line, lineIndex) => line === newLines[lineIndex])) {
+    return nextStart + row;
+  }
+  const text = oldLines[row];
+  if (text) {
+    const occurrence = oldLines.slice(0, row).filter((line) => line === text).length;
+    let seen = 0;
+    const match = newLines.findIndex((line) => line === text && seen++ === occurrence);
+    if (match >= 0) return nextStart + match;
+  }
+  let characters = oldLines.slice(0, row).reduce((total, line) => total + line.length, 0);
+  for (const [lineIndex, line] of newLines.entries()) {
+    if (characters < line.length) return nextStart + lineIndex;
+    characters -= line.length;
+  }
+  return nextStart + Math.max(0, newLines.length - 1);
+}
+
+interface TranscriptRenderCache {
+  messages: WeakMap<AgentMessage, CachedTranscriptMessage>;
+  results: WeakMap<ToolExecutionComponent, AgentMessage>;
+}
+
 function renderTranscriptSnapshot(
   snapshot: ChildAgentTranscriptSnapshot,
   tui: TUI,
   cwd: string,
   expanded: boolean,
   width: number,
-): string[] {
+  cache: TranscriptRenderCache,
+): TranscriptLayout {
   if (snapshot.messages.length === 0) {
-    return snapshot.fallback
-      ? new Text(snapshot.fallback, 3, 0).render(width)
-      : new Text("No Recent Activity", 3, 0).render(width);
+    return {
+      lines: new Text(snapshot.fallback || "No conversation messages yet.", 3, 0).render(width),
+      messageStarts: [0],
+    };
   }
-  const container = new Container();
+  const blocks: Container[] = [];
   const tools = new Map(
     snapshot.toolDefinitions.map((definition) => [definition.name, definition]),
   );
   const pendingTools = new Map<string, ToolExecutionComponent>();
+  const currentMessages = new Set(snapshot.messages);
 
   for (const [messageIndex, message] of snapshot.messages.entries()) {
+    if (message.role === "toolResult") {
+      const paired = pendingTools.get(message.toolCallId);
+      if (paired) {
+        if (cache.results.get(paired) !== message) {
+          paired.updateResult(message);
+          cache.results.set(paired, message);
+        }
+        pendingTools.delete(message.toolCallId);
+        blocks.push(new Container());
+        continue;
+      }
+    }
+    const streaming = messageIndex === snapshot.streamingAssistantIndex;
+    const cached = cache.messages.get(message);
+    const staleResult =
+      cached &&
+      [...cached.tools.values()].some((tool) => {
+        const result = cache.results.get(tool);
+        return result !== undefined && !currentMessages.has(result);
+      });
+    if (cached && !staleResult && cached.expanded === expanded && cached.streaming === streaming) {
+      blocks.push(cached.container);
+      for (const [id, tool] of cached.tools) pendingTools.set(id, tool);
+      continue;
+    }
+    const container = new Container();
+    const messageTools = new Map<string, ToolExecutionComponent>();
     switch (message.role) {
       case "user": {
         const text = contentText(message.content, "\n\n");
@@ -115,7 +208,7 @@ function renderTranscriptSnapshot(
             content.id,
             content.arguments,
             { showImages: false },
-            tools.get(content.name),
+            tools.get(content.name) ?? {},
             tui,
             cwd,
           );
@@ -136,16 +229,24 @@ function renderTranscriptSnapshot(
             });
           } else {
             pendingTools.set(content.id, tool);
+            messageTools.set(content.id, tool);
           }
         }
         break;
       }
       case "toolResult": {
-        const tool = pendingTools.get(message.toolCallId);
-        if (tool) {
-          tool.updateResult(message);
-          pendingTools.delete(message.toolCallId);
-        }
+        const inherited = new ToolExecutionComponent(
+          message.toolName,
+          message.toolCallId,
+          {},
+          { showImages: false },
+          {},
+          tui,
+          cwd,
+        );
+        inherited.setExpanded(expanded);
+        inherited.updateResult(message);
+        container.addChild(inherited);
         break;
       }
       case "custom": {
@@ -188,8 +289,26 @@ function renderTranscriptSnapshot(
         break;
       }
     }
+    cache.messages.set(message, { container, tools: messageTools, expanded, streaming });
+    blocks.push(container);
   }
-  return container.render(width);
+  let length = 0;
+  const messageStarts: number[] = [];
+  const lines = blocks.flatMap((block) => {
+    messageStarts.push(length);
+    // Native user-message prompt zones belong to the main terminal, not an embedded overlay.
+    const rendered = block
+      .render(width)
+      .map((line) =>
+        line
+          .replaceAll("\x1b]133;A\x07", "")
+          .replaceAll("\x1b]133;B\x07", "")
+          .replaceAll("\x1b]133;C\x07", ""),
+      );
+    length += rendered.length;
+    return rendered;
+  });
+  return { lines, messageStarts };
 }
 
 /** Interactive, read-only Child Agent hierarchy and transcript status component. */
@@ -198,9 +317,18 @@ export class MinimalSubagentsStatusPanelComponent implements Component {
   private access!: MinimalSubagentsStatusAccess;
   private flattened: FlattenedStatusAgent[] = [];
   private selectedAgentId?: string;
-  private readonly expandedAgentIds = new Set<string>();
-  private readonly transcripts = new Map<string, ChildAgentTranscriptSnapshot>();
+  private view: "tree" | "transcript" = "tree";
+  private transcript?: ChildAgentTranscriptSnapshot;
+  private notice = "";
   private scrollOffset = 0;
+  private following = true;
+  private transcriptLineCount = 0;
+  private transcriptLayout?: TranscriptLayout;
+  private readonly transcriptCache: TranscriptRenderCache = {
+    messages: new WeakMap(),
+    results: new WeakMap(),
+  };
+  private bodyHeight = 1;
   private ensureSelectionVisible = true;
   private toolOutputExpanded = false;
   private disposed = false;
@@ -231,7 +359,14 @@ export class MinimalSubagentsStatusPanelComponent implements Component {
   /** Handle read-only hierarchy navigation and close keys. */
   handleInput(data: string): void {
     if (this.keybindings.matches(data, "tui.select.cancel")) {
-      this.close();
+      if (this.view === "tree") this.close();
+      else {
+        this.view = "tree";
+        this.transcript = undefined;
+        this.scrollOffset = 0;
+        this.ensureSelectionVisible = true;
+        this.tui.requestRender();
+      }
       return;
     }
     if (this.keybindings.matches(data, "tui.select.up")) {
@@ -239,68 +374,108 @@ export class MinimalSubagentsStatusPanelComponent implements Component {
     } else if (this.keybindings.matches(data, "tui.select.down")) {
       this.moveSelection(1);
     } else if (this.keybindings.matches(data, "tui.select.confirm")) {
-      this.toggleSelectedAgent();
+      this.openSelectedTranscript();
     } else if (this.keybindings.matches(data, "app.tools.expand")) {
       this.toolOutputExpanded = !this.toolOutputExpanded;
+    } else if (this.view === "transcript" && matchesKey(data, "end")) {
+      this.following = true;
     } else if (this.keybindings.matches(data, "tui.select.pageUp")) {
-      this.scrollOffset = Math.max(0, this.scrollOffset - this.viewportHeight());
-      this.ensureSelectionVisible = false;
+      this.scroll(-this.viewportHeight());
     } else if (this.keybindings.matches(data, "tui.select.pageDown")) {
-      this.scrollOffset += this.viewportHeight();
-      this.ensureSelectionVisible = false;
+      this.scroll(this.viewportHeight());
     } else {
       return;
     }
     this.tui.requestRender();
   }
 
-  /** Render the fixed access header and scrollable Child Agent hierarchy. */
+  /** Render one framed, terminal-bounded tree or Child Session Transcript. */
   render(width: number): string[] {
     if (width <= 0) return [];
-    const header = this.renderHeader(width);
-    const rowStarts = new Map<string, number>();
-    const body: string[] = [];
-    for (const { agent, depth } of this.flattened) {
-      rowStarts.set(agent.agent_id, body.length);
-      body.push(this.renderAgentRow(agent, depth, width));
-      if (!this.expandedAgentIds.has(agent.agent_id)) continue;
-      const transcript = this.transcripts.get(agent.agent_id);
-      if (transcript) {
-        body.push(
-          ...renderTranscriptSnapshot(
-            transcript,
-            this.tui,
-            this.cwd,
-            this.toolOutputExpanded,
-            width,
-          ),
+    const height = Math.max(
+      1,
+      Math.min(
+        Math.floor(this.tui.terminal.rows * 0.9),
+        this.tui.terminal.rows - 2 * STATUS_PANEL_MARGIN,
+      ),
+    );
+    if (width < 6 || height < 5) {
+      return new Text("Esc back · Enlarge terminal", 0, 0).render(width).slice(0, height);
+    }
+    const innerWidth = width - 4;
+    const selected = this.flattened.find(({ agent }) => agent.agent_id === this.selectedAgentId);
+    const transcriptView = this.view === "transcript" && this.transcript;
+    const header = transcriptView
+      ? [
+          this.theme.bold(`Transcript · ${this.selectedAgentId}`),
+          selected ? this.renderAgentRow(selected.agent, 0, innerWidth) : "",
+        ]
+      : this.renderHeader(innerWidth);
+    const toolKey = this.keybindings.getKeys("app.tools.expand").join("/");
+    const helpText = transcriptView
+      ? `Esc tree · End live · ${toolKey} tools · ↑↓/PgUp/PgDn scroll · ${this.following ? "Following" : "Paused"}`
+      : "Esc close · Enter transcript · ↑↓ select · PgUp/PgDn page";
+    const help = new Text(this.theme.fg("text", helpText), 0, 0)
+      .render(innerWidth)
+      .slice(0, Math.min(2, height - 4));
+    const visibleHeader = header.slice(0, Math.max(1, height - help.length - 3));
+    this.bodyHeight = Math.max(1, height - 2 - visibleHeader.length - help.length);
+    let body: string[];
+    if (transcriptView) {
+      const layout = renderTranscriptSnapshot(
+        transcriptView,
+        this.tui,
+        this.cwd,
+        this.toolOutputExpanded,
+        innerWidth,
+        this.transcriptCache,
+      );
+      if (!this.following && this.transcriptLayout) {
+        this.scrollOffset = anchoredTranscriptOffset(
+          this.transcriptLayout,
+          layout,
+          this.scrollOffset,
         );
       }
-    }
-    const viewportHeight = this.viewportHeight();
-    const selectedLine = this.selectedAgentId ? rowStarts.get(this.selectedAgentId) : undefined;
-    if (this.ensureSelectionVisible && selectedLine !== undefined) {
-      if (selectedLine < this.scrollOffset) this.scrollOffset = selectedLine;
-      if (selectedLine >= this.scrollOffset + viewportHeight) {
-        this.scrollOffset = selectedLine - viewportHeight + 1;
+      this.transcriptLayout = layout;
+      body = layout.lines;
+      this.transcriptLineCount = body.length;
+      const maximum = Math.max(0, body.length - this.bodyHeight);
+      this.scrollOffset = this.following ? maximum : Math.min(this.scrollOffset, maximum);
+    } else {
+      body = this.flattened.map(({ agent, depth }) =>
+        this.renderAgentRow(agent, depth, innerWidth),
+      );
+      if (body.length === 0) body.push("No Child Agents yet.");
+      const selectedLine = this.flattened.findIndex(
+        ({ agent }) => agent.agent_id === this.selectedAgentId,
+      );
+      if (this.ensureSelectionVisible && selectedLine >= 0) {
+        if (selectedLine < this.scrollOffset) this.scrollOffset = selectedLine;
+        if (selectedLine >= this.scrollOffset + this.bodyHeight)
+          this.scrollOffset = selectedLine - this.bodyHeight + 1;
       }
+      this.ensureSelectionVisible = false;
+      this.scrollOffset = Math.min(this.scrollOffset, Math.max(0, body.length - this.bodyHeight));
     }
-    this.ensureSelectionVisible = false;
-    this.scrollOffset = Math.min(this.scrollOffset, Math.max(0, body.length - viewportHeight));
-    const visibleBody = body.slice(this.scrollOffset, this.scrollOffset + viewportHeight);
-    const help = truncateToWidth(
-      this.theme.fg(
-        "dim",
-        "↑↓ select  Enter Recent Activity  configured tool key expands output  PgUp/PgDn scroll  Esc close",
-      ),
-      width,
-      "…",
-    );
-    return [...header, ...visibleBody, help];
+    const visibleBody = body.slice(this.scrollOffset, this.scrollOffset + this.bodyHeight);
+    while (visibleBody.length < this.bodyHeight) visibleBody.push("");
+    const border = (text: string) => this.theme.fg("border", text);
+    const rows = [...visibleHeader, ...visibleBody, ...help].map((line) => {
+      const content = truncateToWidth(line, innerWidth, "…");
+      return this.theme.bg(
+        "customMessageBg",
+        `${border("│")} ${content}${" ".repeat(innerWidth - visibleWidth(content))} ${border("│")}`,
+      );
+    });
+    return [border(`╭${"─".repeat(width - 2)}╮`), ...rows, border(`╰${"─".repeat(width - 2)}╯`)];
   }
 
-  /** Invalidate no cached layout because each render derives the current snapshot. */
-  invalidate(): void {}
+  /** Rebuild native transcript components when their theme changes. */
+  invalidate(): void {
+    this.transcriptCache.messages = new WeakMap();
+    this.transcriptCache.results = new WeakMap();
+  }
 
   /** Release the live refresh owner idempotently. */
   dispose(): void {
@@ -315,15 +490,16 @@ export class MinimalSubagentsStatusPanelComponent implements Component {
     this.flattened = flattenStatusAgents(this.status);
     const liveIds = new Set(this.flattened.map(({ agent }) => agent.agent_id));
     if (!this.selectedAgentId || !liveIds.has(this.selectedAgentId)) {
+      if (this.view === "transcript") {
+        this.notice = `${this.selectedAgentId} is no longer available.`;
+        this.view = "tree";
+        this.transcript = undefined;
+      }
+      this.ensureSelectionVisible = true;
       this.selectedAgentId = this.flattened[0]?.agent.agent_id;
     }
-    for (const agentId of this.expandedAgentIds) {
-      if (!liveIds.has(agentId)) {
-        this.expandedAgentIds.delete(agentId);
-        this.transcripts.delete(agentId);
-        continue;
-      }
-      this.refreshAgentTranscript(agentId);
+    if (this.view === "transcript" && this.selectedAgentId) {
+      this.refreshAgentTranscript(this.selectedAgentId);
     }
   }
 
@@ -355,13 +531,13 @@ export class MinimalSubagentsStatusPanelComponent implements Component {
       ),
       truncateToWidth(`Coordinator Tools: ${toolState}`, width, "…"),
       truncateToWidth(`Direct Children: ${running} running · ${idle} idle`, width, "…"),
-      "",
+      this.theme.fg("warning", this.notice),
     ];
   }
 
   private renderAgentRow(agent: AgentSummary, depth: number, width: number): string {
     const selected = agent.agent_id === this.selectedAgentId;
-    const disclosure = this.expandedAgentIds.has(agent.agent_id) ? "▾" : "▸";
+    const disclosure = "▸";
     const status = subagentStatusLadder(agent);
     const elapsed = formatSubagentDuration(agent.elapsed_ms);
     const task = agent.task?.replace(/\s+/g, " ").trim();
@@ -371,7 +547,21 @@ export class MinimalSubagentsStatusPanelComponent implements Component {
     return truncateToWidth(selected ? this.theme.fg("accent", line) : line, width, "…");
   }
 
+  private scroll(delta: number): void {
+    this.scrollOffset = Math.max(0, this.scrollOffset + delta);
+    this.ensureSelectionVisible = false;
+    if (this.view === "transcript") {
+      const maximum = Math.max(0, this.transcriptLineCount - this.viewportHeight());
+      this.scrollOffset = Math.min(this.scrollOffset, maximum);
+      this.following = this.scrollOffset === maximum;
+    }
+  }
+
   private moveSelection(delta: number): void {
+    if (this.view === "transcript") {
+      this.scroll(delta);
+      return;
+    }
     if (this.flattened.length === 0) return;
     const current = this.flattened.findIndex(
       ({ agent }) => agent.agent_id === this.selectedAgentId,
@@ -381,34 +571,30 @@ export class MinimalSubagentsStatusPanelComponent implements Component {
     this.ensureSelectionVisible = true;
   }
 
-  private toggleSelectedAgent(): void {
-    const agentId = this.selectedAgentId;
-    if (!agentId) return;
-    if (this.expandedAgentIds.delete(agentId)) {
-      this.transcripts.delete(agentId);
-      return;
-    }
-    this.expandedAgentIds.add(agentId);
-    this.refreshAgentTranscript(agentId);
+  private openSelectedTranscript(): void {
+    if (this.view === "transcript" || !this.selectedAgentId) return;
+    this.view = "transcript";
+    this.notice = "";
+    this.following = true;
+    this.scrollOffset = 0;
+    this.toolOutputExpanded = false;
+    this.refreshAgentTranscript(this.selectedAgentId);
   }
 
   private refreshAgentTranscript(agentId: string): void {
     try {
-      this.transcripts.set(agentId, this.coordinator.inspectTranscript(agentId));
+      this.transcript = this.coordinator.inspectTranscript(agentId);
     } catch (error) {
-      this.transcripts.set(agentId, {
+      this.transcript = {
         messages: [],
         toolDefinitions: [],
         fallback: error instanceof Error ? error.message : String(error),
-      });
+      };
     }
   }
 
   private viewportHeight(): number {
-    return Math.max(
-      STATUS_PANEL_MIN_VIEWPORT_LINES,
-      this.tui.terminal.rows - STATUS_PANEL_FIXED_LINE_COUNT,
-    );
+    return this.bodyHeight;
   }
 
   /** Settle the custom view and release its refresh timer exactly once. */
@@ -423,6 +609,7 @@ export class MinimalSubagentsStatusPanelComponent implements Component {
 export class MinimalSubagentsStatusPanelController {
   private activePanel?: MinimalSubagentsStatusPanelComponent;
   private activePromise?: Promise<void>;
+  private overlayHandle?: OverlayHandle;
 
   /** Bind the panel owner to one Root Agent session and refresh lifecycle. */
   constructor(
@@ -434,7 +621,10 @@ export class MinimalSubagentsStatusPanelController {
 
   /** Open or focus the single live view; RPC receives a notification and structured modes stay silent. */
   open(): Promise<void> {
-    if (this.activePromise) return this.activePromise;
+    if (this.activePromise) {
+      this.overlayHandle?.focus();
+      return this.activePromise;
+    }
     if (this.context.mode === "rpc") {
       const status = this.coordinator.inspectStatus();
       const direct = "agents" in status ? status.agents : [status.agent];
@@ -449,20 +639,34 @@ export class MinimalSubagentsStatusPanelController {
     if (this.context.mode !== "tui") return Promise.resolve();
 
     const promise = this.context.ui
-      .custom<void>((tui, theme, keybindings, done) => {
-        const panel = new MinimalSubagentsStatusPanelComponent(
-          this.coordinator,
-          this.getAccess,
-          tui,
-          theme,
-          keybindings,
-          this.context.cwd,
-          () => done(undefined),
-          this.startRefresh,
-        );
-        this.activePanel = panel;
-        return panel;
-      })
+      .custom<void>(
+        (tui, theme, keybindings, done) => {
+          const panel = new MinimalSubagentsStatusPanelComponent(
+            this.coordinator,
+            this.getAccess,
+            tui,
+            theme,
+            keybindings,
+            this.context.cwd,
+            () => done(undefined),
+            this.startRefresh,
+          );
+          this.activePanel = panel;
+          return panel;
+        },
+        {
+          overlay: true,
+          overlayOptions: {
+            anchor: "center",
+            width: "90%",
+            maxHeight: "90%",
+            margin: STATUS_PANEL_MARGIN,
+          },
+          onHandle: (handle) => {
+            this.overlayHandle = handle;
+          },
+        },
+      )
       .catch(() => {
         this.context.ui.notify("Subagents status view failed.", "error");
       })
@@ -470,6 +674,7 @@ export class MinimalSubagentsStatusPanelController {
         this.activePanel?.dispose();
         this.activePanel = undefined;
         this.activePromise = undefined;
+        this.overlayHandle = undefined;
       });
     this.activePromise = promise;
     return promise;

package/src/minimal-subagents-types.ts

@@ -123,14 +123,14 @@ export interface RecentAgentActivity {
   truncated: boolean;
 }
 
-/** Holds a bounded, image-free process-local Child Agent transcript for trusted status UI. */
+/** Holds the complete selected-branch Child Session Transcript for trusted status UI. */
 export interface ChildAgentTranscriptSnapshot {
   messages: AgentMessage[];
-  /** Index of the current streaming assistant message when it remains in the bounded tail. */
+  /** Index of the current streaming assistant message, when not yet committed. */
   streamingAssistantIndex?: number;
   /** Real Child Agent tool definitions referenced by visible tool calls. */
   toolDefinitions: ToolDefinition[];
-  /** Best-known status or result text when no live Child Agent runtime exists. */
+  /** Explanation when neither live nor verified saved history is available. */
   fallback?: string;
 }
 
@@ -241,7 +241,7 @@ export interface ChildAgentRuntime {
   snapshotCommittedMessages(): AgentMessage[];
   /** Clone child transcript messages including the current streaming assistant tail. */
   snapshotActivityMessages(): AgentMessage[];
-  /** Select the bounded process-local transcript and its real visible tool definitions. */
+  /** Snapshot the full selected branch and streaming output with its real tool definitions. */
   snapshotActivityTranscript?(): ChildAgentTranscriptSnapshot;
   hasDeliveryEvidence(sourceAgentId: string, sourceTurnId: string, deliveryId?: string): boolean;
   getUsage(): Usage | undefined;
@@ -259,6 +259,8 @@ export interface AgentSessionFactory {
   createIdentity(agent: PersistedAgent, importedMessages: AgentMessage[]): PersistedSessionIdentity;
   /** Open one verified persisted Child Agent runtime for launch or restoration. */
   openRuntime(agent: PersistedAgent): Promise<ChildAgentRuntime>;
+  /** Read verified saved history independently of runtime restoration dependencies. */
+  readTranscript?(agent: PersistedAgent): ChildAgentTranscriptSnapshot;
   resolveLaunchMissingDependencies(agent: PersistedAgent): Promise<string[]>;
   resolveRestorationMissingDependencies(agent: PersistedAgent): Promise<string[]>;
   resolveThinkingLevel(modelId: string, requested: ThinkingLevel): ThinkingLevel;

package/src/minimal-subagents-ui.ts

@@ -13,6 +13,7 @@ import {
 import type { MinimalSubagentsCoordinator } from "./minimal-subagents-coordinator.js";
 import {
   formatSubagentDuration,
+  orderActiveAgentSubtrees,
   renderSubagentStatusLabel,
   renderSubagentStatusSymbol,
   subagentStatusLadder,
@@ -128,7 +129,7 @@ export function buildMinimalSubagentsWidgetView(
     if (chosenIds.size + additions.length > MINIMAL_SUBAGENTS_WIDGET_ROW_LIMIT) continue;
     for (const item of additions) chosenIds.add(item.agent.agent_id);
   }
-  const rows = flattened
+  const rows = flattenAgentHierarchy(orderActiveAgentSubtrees(agents))
     .filter((item) => chosenIds.has(item.agent.agent_id))
     .map((item): MinimalSubagentsWidgetRow => {
       const structural = !meaningfulIds.has(item.agent.agent_id);