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

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/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/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/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/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/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.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 */
@@ -170,6 +170,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;

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

@@ -36,9 +36,9 @@ import { type FileSlashCommand } from "../extensibility/slash-commands";
 import { GoalRuntime } from "../goals/runtime";
 import type { Goal, GoalModeState } from "../goals/state";
 import type { HindsightSessionState } from "../hindsight/state";
+import type { IrcMessage } from "../irc/bus";
 import { type MnemopiSessionState } from "../mnemopi/state";
 import type { PlanModeState } from "../plan-mode/state";
-import { type AgentRegistry } from "../registry/agent-registry";
 import { type SecretObfuscator } from "../secrets/obfuscator";
 import { type ConfiguredThinkingLevel } from "../thinking";
 import { type DiscoverableTool, type DiscoverableToolSearchIndex } from "../tool-discovery/tool-index";
@@ -54,10 +54,10 @@ import { YieldQueue } from "./yield-queue";
 export type AgentSessionEvent = AgentEvent | {
     type: "auto_compaction_start";
     reason: "threshold" | "overflow" | "idle" | "incomplete";
-    action: "context-full" | "handoff" | "shake";
+    action: "context-full" | "handoff" | "shake" | "snapcompact";
 } | {
     type: "auto_compaction_end";
-    action: "context-full" | "handoff" | "shake";
+    action: "context-full" | "handoff" | "shake" | "snapcompact";
     result: CompactionResult | undefined;
     aborted: boolean;
     willRetry: boolean;
@@ -214,8 +214,6 @@ export interface AgentSessionConfig {
     asyncJobManager?: AsyncJobManager;
     /** Agent identity (registry id like "Main" or "Alice") used for IRC routing. */
     agentId?: string;
-    /** Shared agent registry (for forwarding IRC observations to the main session UI). */
-    agentRegistry?: AgentRegistry;
     /**
      * Override the provider-facing session ID for all API requests from this session.
      * When absent, `sessionManager.getSessionId()` is used. Needed when benchmark or
@@ -380,6 +378,16 @@ export declare class AgentSession {
      * Multiple listeners can be added. Returns unsubscribe function for this listener.
      */
     subscribe(listener: AgentSessionEventListener): () => void;
+    /**
+     * Synchronously mark the session as disposing so new work is rejected
+     * immediately: Python/eval starts throw, queued asides are dropped, and the
+     * aside provider is detached. Idempotent; `dispose()` runs it first.
+     *
+     * Wrappers that await other teardown before delegating to `dispose()` MUST
+     * call this before their first await — otherwise work started in that async
+     * gap slips past the disposal guards.
+     */
+    beginDispose(): void;
     /**
      * Remove all listeners, flush pending writes, and disconnect from agent.
      * Call this when completely done with the session.
@@ -483,6 +491,13 @@ export declare class AgentSession {
     /** All messages including custom types like BashExecutionMessage */
     get messages(): AgentMessage[];
     buildDisplaySessionContext(): SessionContext;
+    /**
+     * Full-history transcript for TUI display: every path entry in
+     * chronological order with compactions rendered inline at the point they
+     * fired (instead of replacing prior history). Display-only — NEVER feed
+     * the result to `agent.replaceMessages` or a provider.
+     */
+    buildTranscriptSessionContext(): SessionContext;
     /** Convert session messages using the same pre-LLM pipeline as the active session. */
     convertMessagesToLlm(messages: AgentMessage[], signal?: AbortSignal): Promise<Message[]>;
     /** Apply session-level stream hooks to a direct side request. */
@@ -910,27 +925,23 @@ export declare class AgentSession {
     /** Whether there are pending Python messages waiting to be flushed */
     get hasPendingPythonMessages(): boolean;
     /**
-     * Generate an ephemeral reply to a background message (e.g. an IRC ping from
-     * another agent) using this session's current model + system prompt + history.
+     * Deliver an IRC message into this session (recipient side; called by the
+     * IrcBus). Emits the `irc_message` session event for UI cards and injects
+     * the rendered message into the model's context as an `irc:incoming`
+     * custom message:
      *
-     * The incoming message is queued for injection into the recipient's persisted
-     * history immediately so timeouts/abort still preserve delivery. The reply is
-     * computed via a side-channel `streamSimple` call (analogous to `/btw`) so it
-     * never blocks on the recipient's in-flight tool calls. When a reply is
-     * generated, it is queued separately. Injection happens immediately when the
-     * session is idle, otherwise it is deferred until streaming ends.
-     */
-    respondAsBackground(args: {
-        from: string;
-        message: string;
-        awaitReply?: boolean;
-        signal?: AbortSignal;
-    }): Promise<{
-        replyText: string | null;
-    }>;
+     * - mid-turn → queued on the aside channel and folded in at the next step
+     *   boundary (non-interrupting, like async-result deliveries) → "injected";
+     * - idle → starts a real turn with the message so the recipient wakes
+     *   → "woken".
+     *
+     * Never blocks on the recipient's turn: the wake turn is fire-and-forget.
+     */
+    deliverIrcMessage(msg: IrcMessage): Promise<"injected" | "woken">;
     /**
      * Emit an IRC relay observation event on this session for UI rendering only.
-     * Does not persist the record to history. Public so other sessions can forward.
+     * Does not persist the record to history. Called by the IrcBus to surface
+     * agent↔agent traffic on the main session.
      */
     emitIrcRelayObservation(record: CustomMessage): void;
     /**
@@ -939,7 +950,7 @@ export declare class AgentSession {
      * does not block on, or interfere with, any in-flight main turn.  The
      * session's history and persisted state are NOT modified by this call.
      *
-     * Used by `respondAsBackground` (IRC) and `BtwController` (`/btw`) to share
+     * Used by `BtwController` (`/btw`) and `OmfgController` (`/omfg`) to share
      * the snapshot + stream pipeline.  The snapshot includes any in-flight
      * streaming assistant text so the model sees the half-finished response
      * rather than missing context.
@@ -1045,12 +1056,6 @@ export declare class AgentSession {
      * Includes user messages, assistant text, thinking blocks, tool calls, and tool results.
      */
     formatSessionAsText(): string;
-    /**
-     * Format the conversation as compact context for subagents.
-     * Includes only user messages and assistant text responses.
-     * Excludes: system prompt, tool definitions, tool calls/results, thinking blocks.
-     */
-    formatCompactContext(): string;
     /**
      * Check if extensions have handlers for a specific event type.
      */

package/dist/types/session/messages.d.ts

@@ -7,7 +7,7 @@
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import { type BranchSummaryMessage, type CompactionSummaryMessage } from "@oh-my-pi/pi-agent-core/compaction/messages";
 import type { AssistantMessage, ImageContent, Message, MessageAttribution, TextContent } from "@oh-my-pi/pi-ai";
-export { type BranchSummaryMessage, type CompactionSummaryMessage, createBranchSummaryMessage, createCompactionSummaryMessage, } from "@oh-my-pi/pi-agent-core/compaction/messages";
+export { type BranchSummaryMessage, type CompactionSummaryMessage, createBranchSummaryMessage, createCompactionSummaryMessage, createCustomMessage, } from "@oh-my-pi/pi-agent-core/compaction/messages";
 import type { OutputMeta } from "../tools/output-meta";
 export declare const SKILL_PROMPT_MESSAGE_TYPE = "skill-prompt";
 export declare const LSP_LATE_DIAGNOSTIC_MESSAGE_TYPE = "lsp-late-diagnostic";
@@ -33,7 +33,7 @@ export interface SkillPromptDetails {
  *
  *  Consumers: `AgentSession.#handleAgentEvent` (stamper) writes this value;
  *  `EventController.#handleMessageEnd`, `AssistantMessageComponent`,
- *  `ui-helpers.addMessageToChat` (renderers), `SessionObserverOverlay
+ *  `ui-helpers.addMessageToChat` (renderers), `AgentHubOverlayComponent
  *  #buildTranscriptLines`, `runPrintMode`, and `AcpAgent#replayAssistantMessage`
  *  (fallback error emission) read it via `isSilentAbort`. */
 export declare const SILENT_ABORT_MARKER = "__omp.silent_abort__";
@@ -175,8 +175,6 @@ export declare function bashExecutionToText(msg: BashExecutionMessage): string;
  */
 export declare function pythonExecutionToText(msg: PythonExecutionMessage): string;
 export declare function sanitizeRehydratedOpenAIResponsesAssistantMessage(message: AssistantMessage): AssistantMessage;
-/** Convert CustomMessageEntry to AgentMessage format */
-export declare function createCustomMessage(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: unknown | undefined, timestamp: string, attribution?: MessageAttribution): CustomMessage;
 /**
  * Transform AgentMessages (including custom types) to LLM-compatible Messages.
  *

package/dist/types/session/session-history-format.d.ts

@@ -0,0 +1,12 @@
+export interface HistoryFormatOptions {
+    /** Optional H1 prepended to the transcript. */
+    title?: string;
+}
+/**
+ * Format a session's message array as a concise markdown transcript.
+ *
+ * `messages` is the session's in-memory message array (or the read-only
+ * equivalent loaded from a session file) — the same shapes
+ * `session-dump-format.ts` consumes.
+ */
+export declare function formatSessionHistoryMarkdown(messages: unknown[], opts?: HistoryFormatOptions): string;