@oh-my-pi/pi-coding-agent 15.10.12 → 15.11.1

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

@@ -88,10 +88,10 @@ export type CustomToolSessionEvent = {
 } | {
     reason: "auto_compaction_start";
     trigger: "threshold" | "overflow" | "idle" | "incomplete";
-    action: "context-full" | "handoff" | "shake";
+    action: "context-full" | "handoff" | "shake" | "snapcompact";
 } | {
     reason: "auto_compaction_end";
-    action: "context-full" | "handoff" | "shake";
+    action: "context-full" | "handoff" | "shake" | "snapcompact";
     result: CompactionResult | undefined;
     aborted: boolean;
     willRetry: boolean;

package/dist/types/extensibility/shared-events.d.ts

@@ -160,12 +160,12 @@ export interface TurnEndEvent {
 export interface AutoCompactionStartEvent {
     type: "auto_compaction_start";
     reason: "threshold" | "overflow" | "idle" | "incomplete";
-    action: "context-full" | "handoff" | "shake";
+    action: "context-full" | "handoff" | "shake" | "snapcompact";
 }
 /** Fired when auto-compaction ends */
 export interface AutoCompactionEndEvent {
     type: "auto_compaction_end";
-    action: "context-full" | "handoff" | "shake";
+    action: "context-full" | "handoff" | "shake" | "snapcompact";
     result: CompactionResult | undefined;
     aborted: boolean;
     willRetry: boolean;

package/dist/types/internal-urls/history-protocol.d.ts

@@ -0,0 +1,14 @@
+import type { InternalResource, InternalUrl, ProtocolHandler, UrlCompletion } from "./types";
+/**
+ * Handler for history:// URLs.
+ *
+ * Resolves agent ids against the global AgentRegistry, serving transcripts
+ * for both live and parked agents.
+ */
+export declare class HistoryProtocolHandler implements ProtocolHandler {
+    #private;
+    readonly scheme = "history";
+    readonly immutable = false;
+    resolve(url: InternalUrl): Promise<InternalResource>;
+    complete(): Promise<UrlCompletion[]>;
+}

package/dist/types/internal-urls/index.d.ts

@@ -9,6 +9,7 @@
  */
 export * from "./agent-protocol";
 export * from "./artifact-protocol";
+export * from "./history-protocol";
 export * from "./issue-pr-protocol";
 export * from "./json-query";
 export * from "./local-protocol";

package/dist/types/internal-urls/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Types for the internal URL routing system.
  *
- * Internal URLs (`agent://`, `artifact://`, `issue://`, `local://`, `mcp://`, `memory://`, `omp://`, `pr://`, `rule://`, `skill://`, and `vault://`) are resolved by tools like read,
+ * Internal URLs (`agent://`, `artifact://`, `history://`, `issue://`, `local://`, `mcp://`, `memory://`, `omp://`, `pr://`, `rule://`, `skill://`, and `vault://`) are resolved by tools like read,
  * providing access to agent outputs and server resources without exposing filesystem paths.
  */
 import type { LocalProtocolOptions } from "./local-protocol";

package/dist/types/irc/bus.d.ts

@@ -0,0 +1,66 @@
+/**
+ * IrcBus - Process-global mailbox bus for agent-to-agent messaging.
+ *
+ * Replaces the old auto-reply model: a `send` never blocks on the recipient
+ * generating anything. Delivery resolves the recipient via the global
+ * AgentRegistry — parked agents are revived through the
+ * AgentLifecycleManager, idle agents are woken with a real turn, and busy
+ * agents receive the message as a non-interrupting aside at the next step
+ * boundary (see AgentSession.deliverIrcMessage). Replies are real turns by
+ * the recipient, observed via `wait`.
+ */
+import { AgentLifecycleManager } from "../registry/agent-lifecycle";
+import { AgentRegistry } from "../registry/agent-registry";
+export interface IrcMessage {
+    id: string;
+    /** Sender agent id. */
+    from: string;
+    /** Recipient agent id (resolved; "all" is expanded by the tool, not stored). */
+    to: string;
+    body: string;
+    ts: number;
+    /** Message id being answered. */
+    replyTo?: string;
+}
+export interface IrcDeliveryReceipt {
+    to: string;
+    outcome: "injected" | "woken" | "revived" | "failed";
+    error?: string;
+}
+export declare class IrcBus {
+    #private;
+    static global(): IrcBus;
+    /** Reset the global bus. Test-only. */
+    static resetGlobalForTests(): void;
+    constructor(registry?: AgentRegistry, lifecycle?: AgentLifecycleManager);
+    /**
+     * Fire-and-forget delivery. Never blocks on the recipient generating
+     * anything: the receipt reports how the message reached the recipient
+     * (waiter/aside = "injected", idle wake = "woken", park revival =
+     * "revived"), not what they did with it.
+     *
+     * Mailbox semantics: a successfully delivered message never lingers in
+     * the recipient's mailbox — injection/wake puts the full body into their
+     * context, so buffering it too would double-deliver via a later
+     * `wait`/`inbox` and inflate unread counts. Only a failed live hand-off
+     * is buffered for the recipient to drain later.
+     */
+    send(msg: Omit<IrcMessage, "id" | "ts">): Promise<IrcDeliveryReceipt>;
+    /**
+     * Block until a message for `agentId` (optionally from `filter.from`)
+     * arrives; consume + return it. Null on timeout (`timeoutMs <= 0` waits
+     * forever). Rejects when `signal` aborts. By default, already-buffered
+     * mail satisfies the wait before parking a future waiter; callers that
+     * need a strictly future reply can disable that drain.
+     */
+    wait(agentId: string, filter: {
+        from?: string;
+    }, timeoutMs: number, signal?: AbortSignal, options?: {
+        drainPending?: boolean;
+    }): Promise<IrcMessage | null>;
+    /** Drain (or peek) pending messages for `agentId`. */
+    inbox(agentId: string, opts?: {
+        peek?: boolean;
+    }): IrcMessage[];
+    unreadCount(agentId: string): number;
+}

package/dist/types/mcp/oauth-discovery.d.ts

@@ -10,6 +10,7 @@ export interface OAuthEndpoints {
     tokenUrl: string;
     clientId?: string;
     scopes?: string;
+    resource?: string;
 }
 export interface AuthDetectionResult {
     requiresAuth: boolean;
@@ -41,4 +42,5 @@ export declare function analyzeAuthError(error: Error, serverUrl?: string): Auth
  */
 export declare function discoverOAuthEndpoints(serverUrl: string, authServerUrl?: string, resourceMetadataUrl?: string, opts?: {
     fetch?: FetchImpl;
+    protectedResource?: string;
 }): Promise<OAuthEndpoints | null>;

package/dist/types/mcp/oauth-flow.d.ts

@@ -24,6 +24,8 @@ export interface MCPOAuthConfig {
     callbackPort?: number;
     /** Custom callback path (default: /callback or redirectUri pathname) */
     callbackPath?: string;
+    /** MCP resource URI for RFC 8707 resource indicators */
+    resource?: string;
     /** Fetch implementation for token exchange and discovery requests. */
     fetch?: FetchImpl;
 }
@@ -49,6 +51,7 @@ export declare class MCPOAuthFlow extends OAuthCallbackFlow {
      * client id via config.
      */
     get registeredClientSecret(): string | undefined;
+    get resource(): string | undefined;
     generateAuthUrl(state: string, redirectUri: string): Promise<{
         url: string;
         instructions?: string;
@@ -59,6 +62,8 @@ export declare class MCPOAuthFlow extends OAuthCallbackFlow {
  * Refresh an MCP OAuth token using the standard refresh_token grant.
  * Returns updated credentials; preserves the old refresh token if the server doesn't rotate it.
  */
-export declare function refreshMCPOAuthToken(tokenUrl: string, refreshToken: string, clientId?: string, clientSecret?: string, opts?: {
+export declare function refreshMCPOAuthToken(tokenUrl: string, refreshToken: string, clientId?: string, clientSecret?: string, resourceOrOpts?: string | {
+    fetch?: FetchImpl;
+}, opts?: {
     fetch?: FetchImpl;
 }): Promise<OAuthCredentials>;

package/dist/types/mcp/transports/stdio.d.ts

@@ -8,6 +8,7 @@ import type { MCPRequestOptions, MCPStdioServerConfig, MCPTransport } from "../.
 /** Subprocess argv for launching an MCP stdio server. */
 export interface StdioSpawnCommand {
     cmd: string[];
+    windowsHide?: boolean;
 }
 /** Inputs used to resolve platform-specific stdio spawn behavior. */
 export interface ResolveStdioSpawnOptions {

package/dist/types/mcp/types.d.ts

@@ -40,6 +40,8 @@ export interface MCPAuthConfig {
     clientId?: string;
     /** Client secret — persisted for token refresh */
     clientSecret?: string;
+    /** MCP resource URI — persisted for OAuth resource indicators during refresh */
+    resource?: string;
 }
 /** Base server config with shared options */
 interface MCPServerConfigBase {

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

@@ -0,0 +1,30 @@
+import { Container } from "@oh-my-pi/pi-tui";
+import type { KeyId } from "../../config/keybindings";
+import { IrcBus } from "../../irc/bus";
+import { AgentLifecycleManager } from "../../registry/agent-lifecycle";
+import { AgentRegistry } from "../../registry/agent-registry";
+import type { SessionObserverRegistry } from "../session-observer-registry";
+export interface AgentHubDeps {
+    /** Progress/status snapshot source (task lifecycle + progress channels). */
+    observers: SessionObserverRegistry;
+    /** Keys that toggle the hub closed from inside (app.agents.hub + app.session.observe). */
+    hubKeys: KeyId[];
+    onDone: () => void;
+    requestRender: () => void;
+    /** Injectable for tests; defaults to the process-global registry. */
+    registry?: AgentRegistry;
+    /** Injectable for tests; defaults to the process-global lifecycle manager. */
+    lifecycle?: AgentLifecycleManager;
+    /** Injectable for tests; defaults to the process-global bus. */
+    irc?: IrcBus;
+}
+export declare class AgentHubOverlayComponent extends Container {
+    #private;
+    constructor(deps: AgentHubDeps);
+    /** Tear down every subscription and timer. Called by the overlay owner on close. */
+    dispose(): void;
+    render(width: number): readonly string[];
+    handleInput(keyData: string): void;
+    /** Open the chat view for an agent id (public for table Enter and tests). */
+    openChat(id: string): void;
+}

package/dist/types/modes/components/assistant-message.d.ts

@@ -19,6 +19,7 @@ export declare class AssistantMessageComponent extends Container {
      */
     setErrorPinned(pinned: boolean): void;
     isTranscriptBlockFinalized(): boolean;
+    getTranscriptBlockVersion(): number;
     markTranscriptBlockFinalized(): void;
     setToolResultImages(toolCallId: string, images: ImageContent[]): void;
     setUsageInfo(usage: Usage): void;

package/dist/types/modes/components/compaction-summary-message.d.ts

@@ -1,13 +1,19 @@
-import { Box } from "@oh-my-pi/pi-tui";
+import { type Component } from "@oh-my-pi/pi-tui";
 import type { CompactionSummaryMessage } from "../../session/messages";
 /**
- * Component that renders a compaction message with collapsed/expanded state.
- * Uses same background color as hook messages for visual consistency.
+ * Compaction point in the transcript, rendered as a slim horizontal divider:
+ *
+ *   ──────── 📷 compacted · ctrl+o ────────
+ *
+ * The conversation above the divider stays visible (display transcript keeps
+ * full history); only the LLM context was reset. Expanding (ctrl+o) reveals
+ * the compaction summary below the divider.
  */
-export declare class CompactionSummaryMessageComponent extends Box {
+export declare class CompactionSummaryMessageComponent implements Component {
     #private;
     private readonly message;
     constructor(message: CompactionSummaryMessage);
     setExpanded(expanded: boolean): void;
     invalidate(): void;
+    render(width: number): readonly string[];
 }

package/dist/types/modes/components/custom-editor.d.ts

@@ -42,6 +42,8 @@ export declare class CustomEditor extends Editor {
     onDequeue?: () => void;
     /** Called when Caps Lock is pressed. */
     onCapsLock?: () => void;
+    /** Called when left-arrow is pressed while the editor is empty (cursor necessarily at start). */
+    onLeftAtStart?: () => void;
     setActionKeys(action: ConfigurableEditorAction, keys: KeyId[]): void;
     /**
      * Register a custom key handler. Extensions use this for shortcuts.

package/dist/types/modes/components/mcp-add-wizard.d.ts

@@ -16,10 +16,11 @@ export interface MCPAddWizardOAuthResult {
     credentialId: string;
     clientId?: string;
     clientSecret?: string;
+    resource?: string;
 }
 export declare class MCPAddWizard extends Container {
     #private;
-    constructor(onComplete: (name: string, config: MCPServerConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPServerConfig) => Promise<void>, onRender?: () => void, initialName?: string);
+    constructor(onComplete: (name: string, config: MCPServerConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string, resource?: string) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPServerConfig) => Promise<void>, onRender?: () => void, initialName?: string);
     handleInput(keyData: string): void;
 }
 export {};

package/dist/types/modes/components/settings-selector.d.ts

@@ -25,6 +25,7 @@ export interface StatusLinePreviewSettings {
     rightSegments?: StatusLineSegmentId[];
     separator?: StatusLineSeparatorStyle;
     sessionAccent?: boolean;
+    transparent?: boolean;
 }
 export interface SettingsCallbacks {
     /** Called when any setting value changes */

package/dist/types/modes/components/status-line/types.d.ts

@@ -29,6 +29,9 @@ export interface StatusLineSettings {
     segmentOptions?: StatusLineSegmentOptions;
     showHookStatus?: boolean;
     sessionAccent?: boolean;
+    /** Drop the theme's `statusLineBg` fill and powerline caps so the bar
+     *  inherits the terminal's default background. */
+    transparent?: boolean;
 }
 export type EffectiveStatusLineSettings = Required<Pick<StatusLineSettings, "leftSegments" | "rightSegments" | "separator" | "segmentOptions">> & StatusLineSettings;
 export type RGB = readonly [number, number, number];

package/dist/types/modes/components/tool-execution.d.ts

@@ -67,6 +67,14 @@ export declare class ToolExecutionComponent extends Container {
      * transcript live region.
      */
     seal(): void;
+    /**
+     * Whether this block is a waiting `job` poll (every watched job still
+     * running) that has not been sealed. Such a block never finalized, so none
+     * of its rows entered native scrollback (the ticking spinner keeps the
+     * stable-prefix ratchet at zero) and the whole block can be removed when a
+     * follow-up `job` call supersedes it.
+     */
+    isDisplaceableBlock(): boolean;
     /**
      * Stop spinner animation and cleanup resources.
      */

package/dist/types/modes/components/transcript-container.d.ts

@@ -1,4 +1,4 @@
-import { type Component, Container, type NativeScrollbackLiveRegion, type RenderStablePrefix } from "@oh-my-pi/pi-tui";
+import { type Component, Container, type NativeScrollbackCommittedRows, type NativeScrollbackLiveRegion, type RenderStablePrefix } from "@oh-my-pi/pi-tui";
 /**
  * Transcript container that renders every block's current content each frame
  * and reports the live-region seam (`NativeScrollbackLiveRegion`) that gates
@@ -22,10 +22,11 @@ import { type Component, Container, type NativeScrollbackLiveRegion, type Render
  * through {@link RenderStablePrefix} so the engine can skip marker scanning,
  * line preparation, and the committed-prefix audit for those rows.
  */
-export declare class TranscriptContainer extends Container implements NativeScrollbackLiveRegion, RenderStablePrefix {
+export declare class TranscriptContainer extends Container implements NativeScrollbackLiveRegion, NativeScrollbackCommittedRows, RenderStablePrefix {
     #private;
     invalidate(): void;
     clear(): void;
+    setNativeScrollbackCommittedRows(rows: number): void;
     getRenderStablePrefixRows(): number;
     getNativeScrollbackLiveRegionStart(): number | undefined;
     getNativeScrollbackCommitSafeEnd(): number | undefined;

package/dist/types/modes/components/ttsr-notification.d.ts

@@ -3,11 +3,15 @@ import type { Rule } from "../../capability/rule";
 /**
  * Component that renders a TTSR (Time Traveling Stream Rules) notification.
  * Shows when a rule violation is detected and the stream is being rewound.
+ * One block can carry several rules: a single event may match multiple rules,
+ * and consecutive notifications merge into the previous block via
+ * {@link addRules} while it is still the live transcript tail.
  */
 export declare class TtsrNotificationComponent extends Container {
     #private;
-    private readonly rules;
     constructor(rules: Rule[]);
+    /** Merge additional rules into this block (deduped by rule name). */
+    addRules(rules: Rule[]): void;
     setExpanded(expanded: boolean): void;
     isExpanded(): boolean;
 }

package/dist/types/modes/components/welcome.d.ts

@@ -1,7 +1,7 @@
 import { type Component } from "@oh-my-pi/pi-tui";
 /**
- * Fixed number of session rows in the welcome box so its height doesn't shift
- * between the pre-TUI splash (loading placeholder) and the loaded state.
+ * Fixed number of session rows in the welcome box so its height stays stable
+ * across recent-session updates.
  */
 export declare const WELCOME_SESSION_SLOTS = 4;
 /**
@@ -29,14 +29,8 @@ export declare class WelcomeComponent implements Component {
     private providerName;
     private recentSessions;
     private lspServers;
-    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[] | null, lspServers?: LspServerInfo[]);
+    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], lspServers?: LspServerInfo[]);
     invalidate(): void;
-    /**
-     * Freeze the logo on the intro animation's first frame. The pre-TUI startup
-     * splash uses this so the in-TUI intro — which starts at that exact frame —
-     * picks up seamlessly from the splash's static box.
-     */
-    holdIntroFirstFrame(): void;
     /**
      * Play a one-shot intro that sweeps the gradient through every phase
      * before settling on the resting frame. Safe to call multiple times —

package/dist/types/modes/controllers/selector-controller.d.ts

@@ -42,5 +42,5 @@ export declare class SelectorController {
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
     showDebugSelector(): Promise<void>;
-    showSessionObserver(registry: SessionObserverRegistry): void;
+    showAgentHub(observers: SessionObserverRegistry): void;
 }

package/dist/types/modes/controllers/tool-args-reveal.d.ts

@@ -0,0 +1,43 @@
+/** Minimal component surface the reveal pushes frames into. */
+type ToolArgsRevealComponent = {
+    updateArgs(args: unknown, toolCallId?: string): void;
+};
+type ToolArgsRevealControllerOptions = {
+    getSmoothStreaming(): boolean;
+    requestRender(): void;
+};
+/**
+ * Paces streamed tool-call arguments the same way StreamingRevealController
+ * paces assistant text: providers that deliver `partialJson` in large batches
+ * (or throttle their partial parses) would otherwise make write/edit/bash
+ * streaming previews jump in chunks. Each pending tool call reveals its raw
+ * argument stream at the shared 30fps cadence with the same adaptive
+ * catch-up step, re-parsing the revealed prefix per frame.
+ *
+ * Reveal units are UTF-16 code units of the raw stream, not graphemes —
+ * the prefix goes through a JSON parser rather than straight to the screen,
+ * so only surrogate-pair integrity matters (see {@link clampSliceEnd}).
+ */
+export declare class ToolArgsRevealController {
+    #private;
+    constructor(options: ToolArgsRevealControllerOptions);
+    /**
+     * Record the latest streamed argument text for a tool call and return the
+     * args to render right now. With smoothing disabled the full target passes
+     * through in the caller's legacy shape (`{ ...args, __partialJson }`).
+     */
+    setTarget(id: string, partialJson: string, rawInput: boolean, fullArgs: Record<string, unknown>): Record<string, unknown>;
+    /** Attach the component future ticks push frames into. */
+    bind(id: string, component: ToolArgsRevealComponent): void;
+    /** Final arguments arrived (the JSON closed): drop the reveal so the
+     *  caller's final-args render wins immediately, mirroring how assistant
+     *  text snaps to the full message at message_end. */
+    finish(id: string): void;
+    /** Snap every live entry to its full received stream and clear. Used at
+     *  message_end (abort/error mid-stream) so sealed components freeze showing
+     *  everything that arrived rather than a mid-reveal prefix. */
+    flushAll(): void;
+    /** Clear without pushing (teardown). */
+    stop(): void;
+}
+export {};

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

@@ -100,6 +100,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     locallySubmittedUserSignatures: Set<string>;
     lastSigintTime: number;
     lastEscapeTime: number;
+    lastLeftTapTime: number;
     shutdownRequested: boolean;
     hookSelector: HookSelectorComponent | undefined;
     hookInput: HookInputComponent | undefined;
@@ -210,7 +211,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
         updateFooter?: boolean;
         populateHistory?: boolean;
     }): void;
-    renderInitialMessages(prebuiltContext?: SessionContext, options?: {
+    renderInitialMessages(options?: {
         preserveExistingChat?: boolean;
         clearTerminalHistory?: boolean;
     }): void;
@@ -238,7 +239,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleMemoryCommand(text: string): Promise<void>;
     handleSTTToggle(): Promise<void>;
     showDebugSelector(): Promise<void>;
-    showSessionObserver(): void;
+    showAgentHub(): void;
     resetObserverRegistry(): void;
     handleBashCommand(command: string, excludeFromContext?: boolean): Promise<void>;
     handlePythonCommand(code: string, excludeFromContext?: boolean): Promise<void>;

package/dist/types/modes/theme/theme.d.ts

@@ -6,7 +6,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.job" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc";
 export type SpinnerType = "status" | "activity";
 export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
 /** Check if a string is a valid ThemeColor value */
@@ -150,6 +150,7 @@ export declare class Theme {
         time: string;
         pi: string;
         agents: string;
+        job: string;
         cache: string;
         input: string;
         output: string;
@@ -170,6 +171,7 @@ export declare class Theme {
         extensionContextFile: string;
         extensionInstruction: string;
         mic: string;
+        camera: string;
     };
     get thinking(): {
         minimal: string;

package/dist/types/modes/types.d.ts

@@ -117,6 +117,7 @@ export interface InteractiveModeContext {
     locallySubmittedUserSignatures: Set<string>;
     lastSigintTime: number;
     lastEscapeTime: number;
+    lastLeftTapTime: number;
     shutdownRequested: boolean;
     hookSelector: HookSelectorComponent | undefined;
     hookInput: HookInputComponent | undefined;
@@ -204,7 +205,7 @@ export interface InteractiveModeContext {
         updateFooter?: boolean;
         populateHistory?: boolean;
     }): void;
-    renderInitialMessages(prebuiltContext?: SessionContext, options?: {
+    renderInitialMessages(options?: {
         preserveExistingChat?: boolean;
         clearTerminalHistory?: boolean;
     }): void;
@@ -266,7 +267,7 @@ export interface InteractiveModeContext {
     showProviderSetup(): Promise<void>;
     showHookConfirm(title: string, message: string): Promise<boolean>;
     showDebugSelector(): Promise<void>;
-    showSessionObserver(): void;
+    showAgentHub(): void;
     resetObserverRegistry(): void;
     handleCtrlC(): void;
     handleCtrlD(): void;

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -36,7 +36,7 @@ export declare class UiHelpers {
         updateFooter?: boolean;
         populateHistory?: boolean;
     }): void;
-    renderInitialMessages(prebuiltContext?: SessionContext, options?: RenderInitialMessagesOptions): void;
+    renderInitialMessages(options?: RenderInitialMessagesOptions): void;
     clearEditor(): void;
     showError(errorMessage: string): void;
     showWarning(warningMessage: string): void;

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

@@ -0,0 +1,51 @@
+/**
+ * AgentLifecycleManager - Owns the idle → parked → revived lifecycle of
+ * adopted subagents.
+ *
+ * The task executor hands a finished agent over via {@link AgentLifecycleManager.adopt};
+ * from then on the manager arms a TTL timer whenever the agent goes `idle`,
+ * parks it on expiry (disposes the live session, keeps the AgentRef +
+ * sessionFile), and revives it on demand through
+ * {@link AgentLifecycleManager.ensureLive}. Only this manager flips
+ * `parked` ↔ `idle`.
+ */
+import type { AgentSession } from "../session/agent-session";
+import { AgentRegistry } from "./agent-registry";
+export type AgentReviver = () => Promise<AgentSession>;
+export interface AdoptOptions {
+    /** TTL before an idle agent is parked. <= 0 disables parking. */
+    idleTtlMs: number;
+    /** Recreates a live AgentSession from the ref's sessionFile. Absent => not resumable after park (e.g. isolated runs). */
+    revive?: AgentReviver;
+}
+export declare class AgentLifecycleManager {
+    #private;
+    static global(): AgentLifecycleManager;
+    /** Reset the global manager. Test-only. */
+    static resetGlobalForTests(): void;
+    constructor(registry?: AgentRegistry);
+    /**
+     * Take ownership of a finished subagent. Caller has already set registry
+     * status to "idle". Arms the TTL timer (idleTtlMs <= 0 adopts without one).
+     */
+    adopt(id: string, opts: AdoptOptions): void;
+    /** True if the id is adopted (parked or live). */
+    has(id: string): boolean;
+    /** True while {@link park} is disposing this agent's session (lets dispose hooks distinguish park from teardown). */
+    isParking(id: string): boolean;
+    /**
+     * Dispose the live session, detach it from the registry, and mark the
+     * agent `parked`. No-op unless the id is adopted and live.
+     */
+    park(id: string): Promise<void>;
+    /**
+     * Return the live session, reviving from the sessionFile if parked.
+     * Throws a plain Error if the id is unknown or parked without a reviver.
+     * Concurrent calls share one in-flight revive.
+     */
+    ensureLive(id: string): Promise<AgentSession>;
+    /** Hard removal: dispose if live, unregister from registry, drop timers. */
+    release(id: string): Promise<void>;
+    /** Teardown everything (process exit / main session dispose). */
+    dispose(): Promise<void>;
+}

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

@@ -1,13 +1,23 @@
 /**
- * AgentRegistry - Process-global registry of live AgentSession instances.
+ * AgentRegistry - Process-global registry of agents (the main session plus
+ * every subagent), keyed by stable id.
  *
- * Tracks every alive agent (the main session plus every subagent) so the
- * `irc` tool can address peers by id. Sessions are registered explicitly at
- * creation and removed when the owner releases them.
+ * Tracks each agent's status and (when live) its AgentSession so peers can be
+ * addressed by id (`irc`, `task resume`, `history://`). Sessions are
+ * registered explicitly at creation; finished agents stay registered as
+ * `idle` (live) or `parked` (session disposed, ref + sessionFile retained for
+ * revival) and are only removed on explicit release/teardown.
  */
 import type { AgentSession } from "../session/agent-session";
 export declare const MAIN_AGENT_ID = "Main";
-export type AgentStatus = "running" | "idle" | "completed" | "aborted";
+/**
+ * - `running`: a turn is in flight.
+ * - `idle`: live AgentSession in memory, awaiting work. Finished agents are
+ *   `idle`, not removed.
+ * - `parked`: session disposed; AgentRef + sessionFile retained, revivable.
+ * - `aborted`: hard-killed, terminal.
+ */
+export type AgentStatus = "running" | "idle" | "parked" | "aborted";
 export type AgentKind = "main" | "sub";
 export interface AgentRef {
     id: string;
@@ -15,6 +25,7 @@ export interface AgentRef {
     kind: AgentKind;
     parentId?: string;
     status: AgentStatus;
+    /** Null exactly when parked/aborted. */
     session: AgentSession | null;
     sessionFile: string | null;
     createdAt: number;