@oh-my-pi/pi-coding-agent 17.2.8 → 17.2.10

package/dist/types/async/job-manager.d.ts

@@ -51,6 +51,11 @@ export interface AsyncJobDeliveryState {
     nextRetryAt?: number;
     pendingJobIds: string[];
 }
+export interface AsyncJobReapResult {
+    settled: boolean;
+    pendingJobIds: string[];
+    completion: Promise<void>;
+}
 export interface AsyncJobRegisterOptions {
     id?: string;
     /** Registry id of the agent that owns this job; used to scope cancelAll. */
@@ -167,6 +172,13 @@ export declare class AsyncJobManager {
         timeoutMs?: number;
         excludeSuppressed?: boolean;
     }): Promise<boolean>;
+    /**
+     * Cancel every job owned by `ownerId`, then wait only until `deadlineAt`.
+     * The returned completion keeps waiting for actual process settlement when
+     * the deadline expires, so callers can move that cleanup out of the
+     * user-visible Task wait without losing ownership of the live work.
+     */
+    cancelAndReapOwnerJobs(ownerId: string, deadlineAt: number): Promise<AsyncJobReapResult>;
     drainDeliveries(options?: {
         timeoutMs?: number;
         filter?: AsyncJobFilter;

package/dist/types/cli/args.d.ts

@@ -50,6 +50,7 @@ export interface Args {
     noPty?: boolean;
     hooks?: string[];
     extensions?: string[];
+    trustedExtensions?: string[];
     noExtensions?: boolean;
     pluginDirs?: string[];
     print?: boolean;

package/dist/types/config/model-resolver.d.ts

@@ -97,18 +97,31 @@ export declare function parseModelPattern(pattern: string, availableModels: Mode
 export interface ModelRoleLookup {
     getModelRole(role: ModelRole | string): string | undefined;
 }
+/**
+ * Extract the first explicit model-role alias from a raw model selection.
+ *
+ * This intentionally runs before role expansion so callers can retain the
+ * source identity (`@smol`, `pi/slow`, or `*`) even when it resolves to a
+ * concrete provider/model or inherited fallback. Bare role names and explicit
+ * provider/model selectors are not role aliases.
+ */
+export declare function resolveExplicitModelRole(value: string | string[] | undefined, settings?: ModelRoleLookup): string | undefined;
 /**
  * Expand a role alias like "@smol" to the configured model string.
  */
 export declare function expandRoleAlias(value: string, settings?: ModelRoleLookup): string;
 export declare function resolveConfiguredModelPatterns(value: string | string[] | undefined, settings?: ModelRoleLookup): string[];
 export interface AgentModelPatternResolutionOptions {
+    /** Highest-priority request selector, when supplied by a caller. */
+    requestModel?: string | string[];
     settingsOverride?: string | string[];
     agentModel?: string | string[];
     settings?: Settings;
     activeModelPattern?: string;
     fallbackModelPattern?: string;
 }
+/** Return the raw selector source that supplies the effective agent patterns. */
+export declare function resolveAgentModelSource(options: AgentModelPatternResolutionOptions): string | string[] | undefined;
 export declare function resolveAgentModelPatterns(options: AgentModelPatternResolutionOptions): string[];
 /** Default prewalk hand-off target when no explicit target is configured. */
 export declare const DEFAULT_PREWALK_TARGET = "@smol";

package/dist/types/discovery/agents.d.ts

@@ -1,4 +1,14 @@
 import type { LoadContext } from "../capability/types.js";
+interface UserPathCandidateOptions {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    windowsUserProfile?: () => string | undefined;
+    wslPath?: (windowsPath: string) => string | undefined;
+}
+/** Resolve the Windows host profile home exposed to WSL, if available. */
+export declare function getWslWindowsHomeCandidate(options?: UserPathCandidateOptions): string | undefined;
+/** User-level paths: ~/.agent[s]/<segments>, plus the Windows host profile under WSL. */
+export declare function getUserPathCandidates(ctx: LoadContext, ...segments: string[]): string[];
 /**
  * Project-level paths: walk up from cwd to repoRoot, returning `.agent/<segments>`
  * and `.agents/<segments>` at each ancestor.
@@ -10,3 +20,4 @@ import type { LoadContext } from "../capability/types.js";
  * directory — see https://github.com/can1357/oh-my-pi/issues/1116.
  */
 export declare function getProjectPathCandidates(ctx: LoadContext, ...segments: string[]): string[];
+export {};

package/dist/types/extensibility/custom-commands/types.d.ts

@@ -5,7 +5,7 @@
  * Unlike markdown commands which expand to prompts, custom commands can execute
  * arbitrary logic with full access to the hook context.
  */
-import type * as arktype from "@oh-my-pi/omptype";
+import type { type as ArkType } from "@oh-my-pi/omptype";
 import type * as TypeBox from "@oh-my-pi/omptype/typebox";
 import type * as zod from "@oh-my-pi/omptype/zod";
 import type { ExecOptions, ExecResult, HookCommandContext } from "../../extensibility/hooks/types.js";
@@ -20,11 +20,11 @@ export interface CustomCommandAPI {
     cwd: string;
     /** Execute a shell command */
     exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
-    /** Injected zod-backed typebox shim (legacy/compat). */
+    /** Injected TypeBox shim (legacy/compat). */
     typebox: typeof TypeBox;
-    /** Injected arktype module for validation in custom commands. */
-    arktype: typeof arktype;
-    /** Injected omptype-backed zod facade for command validation. */
+    /** Injected omptype schema builder for custom commands. */
+    arktype: typeof ArkType;
+    /** Injected Zod-compatible omptype builder for custom commands. */
     zod: typeof zod;
     /** Injected pi-coding-agent exports */
     pi: typeof PiCodingAgent;

package/dist/types/extensibility/custom-tools/types.d.ts

@@ -57,7 +57,7 @@ export interface CustomToolAPI {
     typebox: typeof TypeBox;
     /** Injected arktype module for arktype-authored custom tools. */
     arktype: typeof ArkType;
-    /** Injected omptype-backed zod facade for parameter schemas. */
+    /** Injected Zod-compatible omptype builder for custom tools. */
     zod: typeof zod;
     /** Injected pi-coding-agent exports */
     pi: typeof PiCodingAgent;

package/dist/types/extensibility/extensions/loader.d.ts

@@ -1,7 +1,7 @@
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { ServiceTierByFamily } from "@oh-my-pi/pi-ai";
 import { EventBus } from "../../utils/event-bus.js";
-import type { Extension, ExtensionFactory, ExtensionRuntime as IExtensionRuntime, LoadExtensionsResult, ProviderConfig } from "./types.js";
+import type { Extension, ExtensionFactory, ExtensionRuntime as IExtensionRuntime, LoadExtensionsResult, ProviderConfig, ToolInfo } from "./types.js";
 export declare class ExtensionRuntimeNotInitializedError extends Error {
     constructor();
 }
@@ -21,7 +21,7 @@ export declare class ExtensionRuntime implements IExtensionRuntime {
     appendEntry(): void;
     setLabel(): void;
     getActiveTools(): string[];
-    getAllTools(): string[];
+    getAllTools(): ToolInfo[];
     setActiveTools(): Promise<void>;
     getCommands(): never;
     setModel(): Promise<boolean>;

package/dist/types/extensibility/extensions/types.d.ts

@@ -7,7 +7,7 @@
  * - Register commands, keyboard shortcuts, and CLI flags
  * - Interact with the user via UI primitives
  */
-import type { Type as arktype } from "@oh-my-pi/omptype";
+import type { type as ArkType } from "@oh-my-pi/omptype";
 import type * as TypeBox from "@oh-my-pi/omptype/typebox";
 import type * as zod from "@oh-my-pi/omptype/zod";
 import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel, ToolApproval, ToolLoadMode } from "@oh-my-pi/pi-agent-core";
@@ -432,6 +432,32 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
     /** Custom rendering for tool result display */
     renderResult?: (result: AgentToolResult<TDetails>, options: ToolRenderResultOptions, theme: Theme, args?: Static<TParams>) => Component;
 }
+/** Whether a tool's source is scoped to the user, the project, or a transient runtime session. */
+export type SourceScope = "user" | "project" | "temporary";
+/** Whether a tool's source came from an installed package or a top-level (loose) file. */
+export type SourceOrigin = "package" | "top-level";
+/**
+ * Provenance metadata describing where a registered tool came from. Mirrors the
+ * `@earendil-works/pi-coding-agent` `SourceInfo` contract so extensions authored
+ * against upstream pi (e.g. gentle-pi) can read `sourceInfo.source` unchanged.
+ */
+export interface SourceInfo {
+    /** Synthetic or on-disk identifier for the tool's origin (e.g. `<builtin:read>`). */
+    path: string;
+    /** Origin class: `"builtin"`, `"sdk"`, `"mcp"`, or `"extension"`. */
+    source: string;
+    scope: SourceScope;
+    origin: SourceOrigin;
+    baseDir?: string;
+}
+/** Tool metadata returned by {@link ExtensionAPI.getAllTools}: identity, schema, and source provenance. */
+export interface ToolInfo {
+    name: string;
+    description: string;
+    parameters: TSchema;
+    promptGuidelines?: string[];
+    sourceInfo: SourceInfo;
+}
 /** Fired after session_start to allow extensions to provide additional resource paths. */
 export interface ResourcesDiscoverEvent {
     type: "resources_discover";
@@ -736,11 +762,11 @@ export type ExtensionServiceTier<Family extends ServiceTierFamily> = Family exte
 export interface ExtensionAPI {
     /** File logger for error/warning/debug messages */
     logger: typeof PiLogger;
-    /** Injected zod-backed typebox shim for legacy `Type.Object(...)` parameter authoring. */
+    /** Injected TypeBox shim for legacy `Type.Object(...)` parameter authoring. */
     typebox: typeof TypeBox;
-    /** Injected arktype module for arktype-authored extension tools (canonical going forward). */
-    arktype: typeof arktype;
-    /** Injected omptype-backed zod facade for extension tool parameter schemas. */
+    /** Injected omptype schema builder for extension tools. */
+    arktype: typeof ArkType;
+    /** Injected Zod-compatible omptype builder for extension tools. */
     zod: typeof zod;
     /** Injected pi-coding-agent exports for accessing SDK utilities */
     pi: typeof PiCodingAgent;
@@ -835,8 +861,8 @@ export interface ExtensionAPI {
     exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
     /** Get the list of currently active tool names. */
     getActiveTools(): string[];
-    /** Get all configured tools (built-in + extension tools). */
-    getAllTools(): string[];
+    /** Get all configured tools (built-in + extension tools) with schema and source metadata. */
+    getAllTools(): ToolInfo[];
     /** Set the active tools by name. */
     setActiveTools(toolNames: string[]): Promise<void>;
     /** Get available slash commands in the current session. */
@@ -999,7 +1025,7 @@ export type SendUserMessageHandler = (content: string | (TextContent | ImageCont
 }) => void;
 export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) => void;
 export type GetActiveToolsHandler = () => string[];
-export type GetAllToolsHandler = () => string[];
+export type GetAllToolsHandler = () => ToolInfo[];
 export type GetCommandsHandler = () => SlashCommandInfo[];
 export type SetActiveToolsHandler = (toolNames: string[]) => Promise<void>;
 export type SetModelHandler = (model: Model) => Promise<boolean>;

package/dist/types/extensibility/hooks/types.d.ts

@@ -1,4 +1,4 @@
-import type { Type } from "@oh-my-pi/omptype";
+import type { type as ArkType } from "@oh-my-pi/omptype";
 import type * as TypeBox from "@oh-my-pi/omptype/typebox";
 import type * as zod from "@oh-my-pi/omptype/zod";
 import type { ImageContent, Message, Model, TextContent } from "@oh-my-pi/pi-ai";
@@ -418,11 +418,11 @@ export interface HookAPI {
     exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
     /** File logger for error/warning/debug messages */
     logger: typeof PiLogger;
-    /** Injected zod-backed typebox shim (legacy/compat — prefer `arktype`). */
+    /** Injected TypeBox shim (legacy/compat — prefer `arktype`). */
     typebox: typeof TypeBox;
-    /** Injected arktype module for arktype-authored hooks. */
-    arktype: typeof Type;
-    /** Injected omptype-backed zod facade for hook validation. */
+    /** Injected omptype schema builder for hooks. */
+    arktype: typeof ArkType;
+    /** Injected Zod-compatible omptype builder for hooks. */
     zod: typeof zod;
     /** Injected pi-coding-agent exports */
     pi: typeof PiCodingAgent;

package/dist/types/extensibility/legacy-pi-coding-agent-shim.d.ts

@@ -92,6 +92,16 @@ export interface WriteOperations {
 export interface WriteToolOptions {
     operations?: WriteOperations;
 }
+/**
+ * Convert an image attachment to PNG using the legacy package-root contract.
+ *
+ * Invalid or unsupported image data returns `null`, matching Pi's historical
+ * helper instead of surfacing Bun's decoder error to extensions.
+ */
+export declare function convertToPng(base64Data: string, mimeType: string): Promise<{
+    data: string;
+    mimeType: string;
+} | null>;
 /** Format the active shortcut for legacy extensions that render keybinding hints. */
 export declare function keyText(action: Keybinding): string;
 /** Parse frontmatter using the historical Pi package-root helper. */

package/dist/types/hindsight/state.d.ts

@@ -93,7 +93,6 @@ export declare class HindsightSessionState {
     retainSession(messages: HindsightMessage[]): Promise<void>;
     maybeRetainOnAgentEnd(): Promise<void>;
     forceRetainCurrentSession(): Promise<void>;
-    maybeRecallOnAgentStart(): Promise<void>;
     beforeAgentStartPrompt(promptText: string): Promise<string | undefined>;
     recallForCompaction(messages: HindsightMessage[]): Promise<string | undefined>;
     runMentalModelLoad(scope: BankScope): Promise<void>;

package/dist/types/index.d.ts

@@ -1,8 +1,8 @@
 import { HookEditorComponent, HookInputComponent, HookSelectorComponent } from "./modes/components/index.js";
+export * as zod from "@oh-my-pi/omptype/zod";
+export { z } from "@oh-my-pi/omptype/zod";
 export { Container, Markdown, Spacer, Text } from "@oh-my-pi/pi-tui";
 export { getAgentDir, logger, VERSION } from "@oh-my-pi/pi-utils";
-export * as zod from "zod/v4";
-export { z } from "zod/v4";
 export * from "./config/keybindings.js";
 export * from "./config/model-registry.js";
 export type * from "./config/prompt-templates.js";

package/dist/types/lsp/utils.d.ts

@@ -14,6 +14,14 @@ export declare function fileToUri(filePath: string): string;
  * Handles Windows drive letters correctly.
  */
 export declare function uriToFile(uri: string): string;
+/** Map that treats equivalent file URI spellings as the same key. */
+export declare class EquivalentUriMap<Value> extends Map<string, Value> {
+    #private;
+    delete(uri: string): boolean;
+    get(uri: string): Value | undefined;
+    has(uri: string): boolean;
+    set(uri: string, value: Value): this;
+}
 /**
  * Convert diagnostic severity number to string name.
  */

package/dist/types/main.d.ts

@@ -28,7 +28,7 @@ export interface AcpSessionFactoryOptions {
     sessionDir?: string;
     authStorage: AuthStorage;
     modelRegistry: ModelRegistry;
-    parsedArgs: Pick<Args, "apiKey">;
+    parsedArgs: Pick<Args, "apiKey" | "trustedExtensions">;
     rawArgs: string[];
     createSession: (options: CreateAgentSessionOptions) => Promise<CreateAgentSessionResult>;
 }

package/dist/types/modes/acp/acp-agent.d.ts

@@ -1,5 +1,5 @@
-import { type Agent, type AgentSideConnection, type AuthenticateRequest, type AuthenticateResponse, type ClientCapabilities, type CloseSessionRequest, type CloseSessionResponse, type ForkSessionRequest, type ForkSessionResponse, type InitializeRequest, type InitializeResponse, type ListSessionsRequest, type ListSessionsResponse, type LoadSessionRequest, type LoadSessionResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type ResumeSessionRequest, type ResumeSessionResponse, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse, type SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
 import { type postmortem } from "@oh-my-pi/pi-utils";
+import { type Agent, type AgentSideConnection, type AuthenticateRequest, type AuthenticateResponse, type ClientCapabilities, type CloseSessionRequest, type CloseSessionResponse, type ForkSessionRequest, type ForkSessionResponse, type InitializeRequest, type InitializeResponse, type ListSessionsRequest, type ListSessionsResponse, type LoadSessionRequest, type LoadSessionResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type ResumeSessionRequest, type ResumeSessionResponse, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse, type SetSessionModeRequest, type SetSessionModeResponse } from "@oh-my-pi/pi-utils/acp";
 import { type ExtensionUIContext } from "../../extensibility/extensions/index.js";
 import type { AgentSession } from "../../session/agent-session.js";
 /**

package/dist/types/modes/acp/acp-client-bridge.d.ts

@@ -4,6 +4,6 @@
  * `AgentSession`) can route through the client when it advertises the
  * relevant capabilities at `initialize` time.
  */
-import type { AgentSideConnection, ClientCapabilities } from "@agentclientprotocol/sdk";
+import type { AgentSideConnection, ClientCapabilities } from "@oh-my-pi/pi-utils/acp";
 import type { ClientBridge } from "../../session/client-bridge.js";
 export declare function createAcpClientBridge(connection: AgentSideConnection, sessionId: string, clientCapabilities: ClientCapabilities | undefined): ClientBridge;

package/dist/types/modes/acp/acp-event-mapper.d.ts

@@ -1,4 +1,4 @@
-import type { SessionNotification, SessionUpdate, ToolKind } from "@agentclientprotocol/sdk";
+import type { SessionNotification, SessionUpdate, ToolKind } from "@oh-my-pi/pi-utils/acp";
 import type { AgentSessionEvent } from "../../session/agent-session.js";
 interface MessageProgress {
     textEmitted: boolean;

package/dist/types/modes/acp/acp-mode.d.ts

@@ -1,4 +1,4 @@
-import { AgentSideConnection, type Stream } from "@agentclientprotocol/sdk";
+import { AgentSideConnection, type Stream } from "@oh-my-pi/pi-utils/acp";
 import type { AgentSession } from "../../session/agent-session.js";
 import { AcpAgent } from "./acp-agent.js";
 /** Creates sessions requested by an ACP client. */

package/dist/types/modes/components/agent-hub-projection.d.ts

@@ -0,0 +1,38 @@
+import type { AgentMetricsSummary, AgentRef, AgentStatus } from "../../registry/agent-registry.js";
+import type { ObservableSession } from "../session-observer-registry.js";
+export type AgentMetrics = AgentMetricsSummary;
+export interface AggregateMetrics extends AgentMetrics {
+    reportedAgents: number;
+    /** Rows whose duration is an observer-measured active runtime. */
+    activeDurationAgents: number;
+}
+export interface AgentTreeProjection {
+    rows: AgentRef[];
+    depthById: Map<string, number>;
+    parentById: Map<string, string>;
+    lastSiblingById: Map<string, boolean>;
+}
+export declare const STATUS_ORDER: Record<AgentStatus, number>;
+/** Exact observer usage for one roster entry. */
+export declare function progressMetrics(observed: ObservableSession | undefined): AgentMetrics | undefined;
+/**
+ * Read direct assistant usage from a live session. SessionStats also includes
+ * usage embedded in completed `task` tool results, so using it for a parent
+ * row would double-count child rows in the aggregate.
+ */
+export declare function readSessionMetrics(session: NonNullable<AgentRef["session"]>): AgentMetrics | undefined;
+export declare function aggregateMetrics(args: {
+    rows: readonly AgentRef[];
+    observedById: ReadonlyMap<string, ObservableSession>;
+    metricsFor: (ref: AgentRef, observed: ObservableSession | undefined) => AgentMetrics | undefined;
+    fallbackStatsSession: (ref: AgentRef, observed: ObservableSession | undefined) => NonNullable<AgentRef["session"]> | undefined;
+    sessionMetrics: WeakMap<object, {
+        metrics: AgentMetrics | undefined;
+    }>;
+    refreshFallback: boolean;
+}): {
+    metrics: AggregateMetrics;
+    hasFallbackLiveSessions: boolean;
+};
+/** Parent-before-child projection preserving the roster's stable sibling order. */
+export declare function projectAgentTree(refs: readonly AgentRef[]): AgentTreeProjection;

package/dist/types/modes/components/agent-hub-renderer.d.ts

@@ -0,0 +1,41 @@
+import { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { Settings } from "../../config/settings.js";
+import { type AgentRef } from "../../registry/agent-registry.js";
+import type { ObservableSession } from "../session-observer-registry.js";
+import type { AgentMetrics } from "./agent-hub-projection.js";
+export interface RosterRender {
+    lines: string[];
+    hitRows: Array<number | undefined>;
+}
+/** Legacy progress snapshots may omit counters; snapshot absence remains distinct. */
+export declare function metricNumber(value: number | undefined): number;
+/** Compute the max content width for the current terminal, accounting for chrome. */
+export declare function contentWidth(): number;
+/** Remove terminal controls and normalize a value before it reaches the TUI. */
+export declare function sanitizeDisplayText(text: string): string;
+/** Sanitize a line for TUI display and truncate it to the viewport width. */
+export declare function sanitizeLine(text: string, maxWidth?: number): string;
+export declare function clampHubLine(line: string, width: number): string;
+/** Status glyph, colored per theme status conventions. The title-line counts spell out the words. */
+export declare function statusGlyph(status: AgentRef["status"]): string;
+export declare function statusText(status: AgentRef["status"], text: string): string;
+/** Model id + thinking level (`sonnet-4-6 ◒ high`), level colored per theme. */
+export declare function formatModelBadge(modelId: string, level: ThinkingLevel | undefined): string;
+/** Textual model-role tag; color reinforces (but never replaces) the label. */
+export declare function formatRoleBadge(role: string, settings: Settings): string;
+/** Format a resolved selector, preserving provider identity when requested. */
+export declare function formatResolvedModelBadge(resolved: string, preserveProvider?: boolean, fallbackLevel?: ThinkingLevel): string;
+/**
+ * Resolved model + reasoning level for a hub row. Exact executor progress is
+ * authoritative (and survives completion); direct live sessions are the
+ * fallback for agents without an observer snapshot.
+ */
+export declare function modelBadge(ref: AgentRef, observed: ObservableSession | undefined): string | undefined;
+export declare function formatMetricDuration(metrics: AgentMetrics): string | undefined;
+export declare function formatCost(cost: number): string;
+export declare function formatMetrics(metrics: AgentMetrics): string;
+export declare function contextGauge(tokens: number, window: number): string;
+/** Fit a child-id preview without joining an arbitrarily large child set. */
+export declare function formatChildIds(children: readonly AgentRef[], width: number): string;
+/** Bash `tree`-style ancestry prefix, clipped from the left on pathological depth. */
+export declare function treeBranch(ref: AgentRef, maxWidth: number, depthById: ReadonlyMap<string, number>, parentById: ReadonlyMap<string, string>, lastSiblingById: ReadonlyMap<string, boolean>): string;

package/dist/types/modes/components/agent-hub.d.ts

@@ -4,8 +4,8 @@
  * One overlay, two views:
  * - Table view: every registered agent except Main (Main IS the ambient
  *   chat), live from the global AgentRegistry — status, unread irc count,
- *   current/last task, last activity. Select with j/k, Enter opens a chat,
- *   `r` revives a parked agent, `x` aborts + releases one.
+ *   current/last task, last activity. Navigate with keys, wheel, hover, and
+ *   click; `r` revives a parked agent, `x` aborts + releases one.
  * - Chat view: per-agent transcript (incremental session-file tail, absorbed
  *   from the old session observer overlay) plus an input line. Submitting
  *   revives a parked agent, then prompts/steers it; the message lands in the
@@ -13,9 +13,10 @@
  *
  * Replaces the old SessionObserverOverlayComponent (ctrl+s observer).
  */
-import { type AgentTool } from "@oh-my-pi/pi-agent-core";
-import { Container, type TUI } from "@oh-my-pi/pi-tui";
+import type { AgentTool } from "@oh-my-pi/pi-agent-core";
+import { Container, type SelectListMouseTarget, type TUI } from "@oh-my-pi/pi-tui";
 import type { KeyId } from "../../config/keybindings.js";
+import type { Settings } from "../../config/settings.js";
 import type { MessageRenderer } from "../../extensibility/extensions/types.js";
 import { IrcBus } from "../../irc/bus.js";
 import { AgentLifecycleManager } from "../../registry/agent-lifecycle.js";
@@ -39,6 +40,8 @@ export interface AgentHubRemote {
 export interface AgentHubDeps {
     /** Progress/status snapshot source (task lifecycle + progress channels). */
     observers: SessionObserverRegistry;
+    /** Production settings used to resolve textual model-role tags. */
+    settings?: Settings;
     /** Keys that toggle the hub closed from inside (app.agents.hub + app.session.observe). */
     hubKeys: KeyId[];
     onDone: () => void;
@@ -69,7 +72,7 @@ export interface AgentHubDeps {
     /** Collab guest: route actions/transcripts to the host instead of local sessions. */
     remote?: AgentHubRemote;
 }
-export declare class AgentHubOverlayComponent extends Container {
+export declare class AgentHubOverlayComponent extends Container implements SelectListMouseTarget {
     #private;
     /** Resolves after persisted historical subagents have been registered and rows refreshed. */
     readonly persistedSubagentsReady: Promise<void>;
@@ -101,4 +104,8 @@ export declare class AgentHubOverlayComponent extends Container {
      * restored when the viewer closes. No-op without a real TUI (render-only test stub).
      */
     openChat(id: string): void;
+    handleWheel(delta: -1 | 1): void;
+    hitTest(line: number): number | undefined;
+    setHoverIndex(index: number | null): void;
+    clickItem(index: number): void;
 }

package/dist/types/modes/components/model-browser.d.ts

@@ -50,8 +50,16 @@ export declare function sortModelItems(items: ModelBrowserItem[], options?: Sort
 /** Compact glyph for a configured thinking level; empty for `inherit` (nothing to show). */
 export declare function thinkingLevelGlyph(level: ConfiguredThinkingLevel): string;
 /**
- * A slim role chip: `●default ◉` — solid dot for configured assignments,
+ * A slim role chip: `● default ◉` — solid dot for configured assignments,
  * hollow for auto-selected fallbacks, thinking glyph attached when set.
+ *
+ * The space after the status glyph is load-bearing. Under the `nerd` preset
+ * these are Nerd Font private-use icons (U+F111 / U+F10C) whose glyphs are
+ * drawn two cells wide, while `visibleWidth` counts them as one
+ * (`ambiguousIsNarrow: true` in tui/utils.ts — the PUA block is
+ * East_Asian_Width=Ambiguous). Without a separator the icon overhangs and
+ * eats the label's first character (`● default` renders as `●efault`).
+ * Mirrors the spacing already used for `status.success` in model-hub.
  */
 export declare function formatRoleChip(role: string, assignment: RoleAssignment, settings: Settings): string;
 /** Behavior switches for {@link ModelBrowser}. */

package/dist/types/modes/interactive-mode.d.ts

@@ -284,7 +284,14 @@ export declare class InteractiveMode implements InteractiveModeContext {
     initializeHookRunner(uiContext: ExtensionUIContext, hasUI: boolean): void;
     setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => CustomEditor) | undefined): void;
     present(content: Component | readonly Component[]): void;
-    /** Defer transcript command panels until the active turn can no longer grow above them. */
+    /**
+     * Defer transcript command panels while the agent is streaming, then mount
+     * them at the next settle, terminal or not. A non-terminal settle is only a
+     * scheduling pause, so resumed streaming can still land below a panel
+     * flushed there. That is preferred over leaving it queued behind a command
+     * the user runs during the pause, which mounts immediately and would put the
+     * older panel out of order.
+     */
     presentCommandOutput(content: Component | readonly Component[]): void;
     /** Mount every command panel queued for the current session while the agent was streaming. */
     flushPendingCommandOutput(): void;

package/dist/types/modes/session-observer-registry.d.ts

@@ -28,6 +28,8 @@ export declare class SessionObserverRegistry {
     /** Add a change listener. Returns unsubscribe function. */
     onChange(cb: (kind: SessionObserverChangeKind) => void): () => void;
     setMainSession(sessionFile?: string): void;
+    /** Return one tracked session without copying or sorting the registry. */
+    getSession(id: string): ObservableSession | undefined;
     getSessions(): ObservableSession[];
     getActiveSubagentCount(): number;
     /** Clear all tracked sessions (e.g. on session switch). Keeps EventBus subscriptions and listeners. */

package/dist/types/registry/agent-lifecycle.d.ts

@@ -108,5 +108,5 @@ export declare class AgentLifecycleManager {
         tombstone?: boolean;
     }): Promise<boolean>;
     /** Teardown everything (process exit / main session dispose). */
-    dispose(): Promise<void>;
+    dispose(deadlineAt?: number): Promise<void>;
 }

package/dist/types/registry/agent-registry.d.ts

@@ -10,6 +10,9 @@
  */
 import type { AgentSession } from "../session/agent-session.js";
 export declare const MAIN_AGENT_ID = "Main";
+/** Sidecar marker retained beside a child transcript after an explicit kill. */
+export declare const AGENT_TOMBSTONE_SUFFIX = ".tombstone";
+export declare function getAgentTombstonePath(sessionFile: string): string;
 /**
  * - `running`: a turn is in flight.
  * - `idle`: live AgentSession in memory, awaiting work. Finished agents are
@@ -18,6 +21,8 @@ export declare const MAIN_AGENT_ID = "Main";
  * - `aborted`: hard-killed, terminal.
  */
 export type AgentStatus = "running" | "idle" | "parked" | "aborted";
+/** Provenance of a displayed duration: active runtime, transcript span, or unavailable. */
+export type AgentDurationKind = "active" | "span" | "unknown";
 /**
  * - `main`/`sub`: the user-facing agent tree (driving agent + task subagents).
  * - `advisor`: a passive review transcript persisted like a subagent for usage
@@ -25,6 +30,33 @@ export type AgentStatus = "running" | "idle" | "parked" | "aborted";
  *   agent-facing rosters (`hub`, `history://`) and not messageable/revivable.
  */
 export type AgentKind = "main" | "sub" | "advisor";
+/** Persisted per-agent totals reconstructed from the child session transcript. */
+export interface AgentMetricsSummary {
+    tokens: number;
+    requests: number;
+    tools: number;
+    cost: number;
+    durationMs: number;
+    durationKind?: AgentDurationKind;
+    contextTokens?: number;
+    contextWindow?: number;
+}
+/** Historical identity and telemetry that remain available after the live session is disposed. */
+export interface AgentHistorySummary {
+    agent?: string;
+    modelRole?: string;
+    resolvedModel?: string;
+    /** Whether the last resolved model was selected by retry fallback routing. */
+    resolvedModelIsFallback?: boolean;
+    metrics?: AgentMetricsSummary;
+    readOnly?: boolean;
+    /** Durable task output artifact, when the executor wrote one. */
+    outputPath?: string;
+    /** Captured isolated-worktree patch, when patch capture succeeded. */
+    patchPath?: string;
+    /** Isolated branch identity, when branch-mode capture succeeded. */
+    branchName?: string;
+}
 export interface AgentRef {
     id: string;
     displayName: string;
@@ -38,6 +70,8 @@ export interface AgentRef {
     lastActivity: number;
     /** Short gist of what the agent is currently doing (latest intent or tool), for the work-aware roster. Display-only. */
     activity?: string;
+    /** Persisted identity and telemetry restored after the live observer is gone. */
+    history?: AgentHistorySummary;
 }
 export type AgentRefExpectation = AgentRef | AgentSession;
 export type RegistryEvent = {
@@ -46,6 +80,9 @@ export type RegistryEvent = {
 } | {
     type: "status_changed";
     ref: AgentRef;
+} | {
+    type: "metadata_changed";
+    ref: AgentRef;
 } | {
     type: "removed";
     ref: AgentRef;
@@ -59,6 +96,14 @@ export interface RegisterInput {
     session: AgentSession | null;
     sessionFile?: string | null;
     status?: AgentStatus;
+    /** Last persisted task summary, when restoring a historical agent. */
+    activity?: string;
+    /** Original registration timestamp, when known from persisted history. */
+    createdAt?: number;
+    /** Last transcript activity timestamp, when known from persisted history. */
+    lastActivity?: number;
+    /** Persisted identity and telemetry restored after the live observer is gone. */
+    history?: AgentHistorySummary;
 }
 export declare class AgentRegistry {
     #private;
@@ -73,6 +118,8 @@ export declare class AgentRegistry {
      * id after its prior generation disappeared or was hard-killed.
      */
     registerIfAvailable(input: RegisterInput, expected: AgentRef | null): AgentRef | undefined;
+    /** Attach transcript-derived identity and telemetry without changing lifecycle state. */
+    setHistory(id: string, history: AgentHistorySummary, expectedSessionFile?: string): boolean;
     setStatus(id: string, status: AgentStatus, expected?: AgentRefExpectation): boolean;
     /**
      * Record a short activity gist for the work-aware roster. Display-only and

package/dist/types/registry/persisted-agents.d.ts

@@ -1,3 +1,5 @@
 import { type AgentRegistry } from "./agent-registry.js";
 /** Register persisted subagent and advisor transcripts as parked registry refs. */
-export declare function registerPersistedSubagents(registry: AgentRegistry, sessionFile: string | null | undefined): Promise<void>;
+export declare function registerPersistedSubagents(registry: AgentRegistry, sessionFile: string | null | undefined, options?: {
+    shouldContinue?: () => boolean;
+}): Promise<void>;