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

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

@@ -9,7 +9,9 @@ import type { CompactionResult } from "@oh-my-pi/pi-agent-core/compaction";
 import type { Effort, ImageContent, Model } from "@oh-my-pi/pi-ai";
 import type { BashResult } from "../../exec/bash-executor";
 import type { ContextUsage } from "../../extensibility/extensions/types";
-import type { SessionStats } from "../../session/agent-session";
+import type { AgentSessionEvent, SessionStats } from "../../session/agent-session";
+import type { FileEntry } from "../../session/session-manager";
+import type { AgentProgress, SubagentEventPayload, SubagentLifecyclePayload, SubagentProgressPayload } from "../../task";
 import type { TodoPhase } from "../../tools/todo";
 export type RpcCommand = {
     id?: string;
@@ -54,6 +56,19 @@ export type RpcCommand = {
     id?: string;
     type: "set_host_uri_schemes";
     schemes: RpcHostUriSchemeDefinition[];
+} | {
+    id?: string;
+    type: "set_subagent_subscription";
+    level: RpcSubagentSubscriptionLevel;
+} | {
+    id?: string;
+    type: "get_subagents";
+} | {
+    id?: string;
+    type: "get_subagent_messages";
+    subagentId?: string;
+    sessionFile?: string;
+    fromByte?: number;
 } | {
     id?: string;
     type: "set_model";
@@ -174,6 +189,29 @@ export interface RpcSessionState {
 export interface RpcHandoffResult {
     savedPath?: string;
 }
+export type RpcSubagentSubscriptionLevel = "off" | "progress" | "events";
+export interface RpcSubagentSnapshot {
+    id: string;
+    index: number;
+    agent: string;
+    agentSource: AgentProgress["agentSource"];
+    description?: string;
+    status: AgentProgress["status"];
+    task?: string;
+    assignment?: string;
+    sessionFile?: string;
+    lastUpdate: number;
+    progress?: AgentProgress;
+    parentToolCallId?: string;
+}
+export interface RpcSubagentMessagesResult {
+    sessionFile: string;
+    fromByte: number;
+    nextByte: number;
+    reset: boolean;
+    entries: FileEntry[];
+    messages: AgentMessage[];
+}
 export type RpcResponse = {
     id?: string;
     type: "response";
@@ -237,6 +275,28 @@ export type RpcResponse = {
     data: {
         schemes: string[];
     };
+} | {
+    id?: string;
+    type: "response";
+    command: "set_subagent_subscription";
+    success: true;
+    data: {
+        level: RpcSubagentSubscriptionLevel;
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_subagents";
+    success: true;
+    data: {
+        subagents: RpcSubagentSnapshot[];
+    };
+} | {
+    id?: string;
+    type: "response";
+    command: "get_subagent_messages";
+    success: true;
+    data: RpcSubagentMessagesResult;
 } | {
     id?: string;
     type: "response";
@@ -418,6 +478,20 @@ export type RpcResponse = {
     success: false;
     error: string;
 };
+export interface RpcSubagentLifecycleFrame {
+    type: "subagent_lifecycle";
+    payload: SubagentLifecyclePayload;
+}
+export interface RpcSubagentProgressFrame {
+    type: "subagent_progress";
+    payload: SubagentProgressPayload;
+}
+export interface RpcSubagentEventFrame {
+    type: "subagent_event";
+    payload: SubagentEventPayload;
+}
+export type RpcSubagentFrame = RpcSubagentLifecycleFrame | RpcSubagentProgressFrame | RpcSubagentEventFrame;
+export type RpcSessionEventFrame = AgentSessionEvent | RpcSubagentFrame;
 /** Emitted when an extension needs user input */
 export type RpcExtensionUIRequest = {
     type: "extension_ui_request";

package/dist/types/modes/setup-wizard/index.d.ts

@@ -14,4 +14,8 @@ export interface SetupSceneSelectionOptions {
 }
 export declare function selectSetupScenes(storedVersion: number, scenes: readonly SetupScene[], ctx?: InteractiveModeContext, options?: SetupSceneSelectionOptions): Promise<SetupScene[]>;
 export declare function markSetupWizardComplete(settings: Settings, version?: number): Promise<void>;
-export declare function runSetupWizard(ctx: InteractiveModeContext, scenes?: readonly SetupScene[]): Promise<void>;
+export interface RunSetupWizardOptions {
+    markComplete?: boolean;
+    playWelcomeIntro?: boolean;
+}
+export declare function runSetupWizard(ctx: InteractiveModeContext, scenes?: readonly SetupScene[], options?: RunSetupWizardOptions): Promise<void>;

package/dist/types/modes/setup-wizard/lazy.d.ts

@@ -0,0 +1,2 @@
+import type { InteractiveModeContext } from "../types";
+export declare function runProviderSetupWizard(ctx: InteractiveModeContext): 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

@@ -82,6 +82,7 @@ export interface InteractiveModeContext {
     historyStorage?: HistoryStorage;
     mcpManager?: MCPManager;
     lspServers?: LspStartupServerInfo[];
+    titleSystemPrompt?: string;
     isInitialized: boolean;
     isBashMode: boolean;
     toolOutputExpanded: boolean;
@@ -116,6 +117,7 @@ export interface InteractiveModeContext {
     locallySubmittedUserSignatures: Set<string>;
     lastSigintTime: number;
     lastEscapeTime: number;
+    lastLeftTapTime: number;
     shutdownRequested: boolean;
     hookSelector: HookSelectorComponent | undefined;
     hookInput: HookInputComponent | undefined;
@@ -203,7 +205,7 @@ export interface InteractiveModeContext {
         updateFooter?: boolean;
         populateHistory?: boolean;
     }): void;
-    renderInitialMessages(prebuiltContext?: SessionContext, options?: {
+    renderInitialMessages(options?: {
         preserveExistingChat?: boolean;
         clearTerminalHistory?: boolean;
     }): void;
@@ -262,9 +264,10 @@ export interface InteractiveModeContext {
     handleResumeSession(sessionPath: string): Promise<void>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    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/secrets/index.d.ts

@@ -1,5 +1,5 @@
 import type { SecretEntry } from "./obfuscator";
-export { deobfuscateSessionContext, obfuscateMessages, type SecretEntry, SecretObfuscator } from "./obfuscator";
+export { deobfuscateSessionContext, obfuscateMessages, obfuscateProviderContext, obfuscateProviderTools, type SecretEntry, SecretObfuscator, } from "./obfuscator";
 /**
  * Load secrets from project-local and global secrets.yml files.
  * Project-local entries override global entries with matching content.

package/dist/types/secrets/obfuscator.d.ts

@@ -1,4 +1,4 @@
-import type { Message } from "@oh-my-pi/pi-ai";
+import type { Context, Message, Tool } from "@oh-my-pi/pi-ai";
 import type { SessionContext } from "../session/session-manager";
 export interface SecretEntry {
     type: "plain" | "regex";
@@ -17,7 +17,13 @@ export declare class SecretObfuscator {
     deobfuscate(text: string): string;
     /** Deep-walk an object, deobfuscating all string values. */
     deobfuscateObject<T>(obj: T): T;
+    /** Deep-walk an object, obfuscating all string values. */
+    obfuscateObject<T>(obj: T): T;
 }
 export declare function deobfuscateSessionContext(sessionContext: SessionContext, obfuscator: SecretObfuscator | undefined): SessionContext;
-/** Obfuscate all text content in LLM messages (for outbound interception). */
+/** Obfuscate all string content in LLM messages (for outbound interception). */
 export declare function obfuscateMessages(obfuscator: SecretObfuscator, messages: Message[]): Message[];
+/** Obfuscate provider request context without walking live tool schema instances. */
+export declare function obfuscateProviderContext(obfuscator: SecretObfuscator | undefined, context: Context): Context;
+/** Convert tool schemas to wire JSON Schema before obfuscating provider-visible strings. */
+export declare function obfuscateProviderTools(obfuscator: SecretObfuscator | undefined, tools: Tool[] | undefined): Tool[] | undefined;

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;
@@ -127,6 +127,8 @@ export interface AgentSessionConfig {
     agent: Agent;
     sessionManager: SessionManager;
     settings: Settings;
+    /** Whether the caller explicitly requested yolo/auto-approve behavior for this session. */
+    autoApprove?: boolean;
     /** Models to cycle through with Ctrl+P (from --models flag) */
     scopedModels?: Array<{
         model: Model;
@@ -212,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
@@ -378,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.
@@ -481,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. */
@@ -548,7 +565,14 @@ export declare class AgentSession {
      * @throws Error if streaming and no streamingBehavior specified
      * @throws Error if no model selected or no API key available (when not streaming)
      */
-    prompt(text: string, options?: PromptOptions): Promise<void>;
+    /**
+     * Returns `false` when the command was fully handled locally (extension or
+     * custom-TS command consumed without calling the LLM). Returns `true` when
+     * the prompt was forwarded to the agent — either directly or queued as a
+     * steer/follow-up. Callers that render a UI or manage turn lifecycle (e.g.
+     * the ACP agent) use this to know whether to expect an `agent_end` event.
+     */
+    prompt(text: string, options?: PromptOptions): Promise<boolean>;
     promptCustomMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details" | "attribution">, options?: Pick<PromptOptions, "streamingBehavior" | "toolChoice">): Promise<void>;
     /**
      * Queue a steering message to interrupt the agent mid-run.
@@ -700,7 +724,8 @@ export declare class AgentSession {
      */
     cycleRoleModels(roleOrder: readonly string[], direction?: "forward" | "backward"): Promise<RoleModelCycleResult | undefined>;
     /**
-     * Get all available models with valid API keys.
+     * Get all available models with valid API keys, filtered by `enabledModels` when configured.
+     * See {@link filterAvailableModelsByEnabledPatterns} for supported pattern forms and limitations.
      */
     getAvailableModels(): Model[];
     /**
@@ -849,9 +874,11 @@ export declare class AgentSession {
      * @param command The bash command to execute
      * @param onChunk Optional streaming callback for output
      * @param options.excludeFromContext If true, command output won't be sent to LLM (!! prefix)
+     * @param options.useUserShell If true, allow caller to request configured user-shell routing
      */
     executeBash(command: string, onChunk?: (chunk: string) => void, options?: {
         excludeFromContext?: boolean;
+        useUserShell?: boolean;
     }): Promise<BashResult>;
     /**
      * Record a bash execution result in session history.
@@ -898,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;
     /**
@@ -927,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.
@@ -1033,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;

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

@@ -214,14 +214,31 @@ export declare function migrateSessionEntries(entries: FileEntry[]): void;
 /** Exported for compaction.test.ts */
 export declare function parseSessionEntries(content: string): FileEntry[];
 export declare function getLatestCompactionEntry(entries: SessionEntry[]): CompactionEntry | null;
+export interface BuildSessionContextOptions {
+    /**
+     * Build the full-history display transcript instead of the LLM context:
+     * every path entry in chronological order, with each compaction emitted
+     * inline as a `compactionSummary` message at the position it fired rather
+     * than replacing the history before it. Display-only — never send the
+     * result to a provider.
+     */
+    transcript?: boolean;
+}
 /**
  * Build the session context from entries using tree traversal.
  * If leafId is provided, walks from that entry to root.
  * Handles compaction and branch summaries along the path.
  */
-export declare function buildSessionContext(entries: SessionEntry[], leafId?: string | null, byId?: Map<string, SessionEntry>): SessionContext;
+export declare function buildSessionContext(entries: SessionEntry[], leafId?: string | null, byId?: Map<string, SessionEntry>, options?: BuildSessionContextOptions): SessionContext;
 /** Exported for testing */
 export declare function loadEntriesFromFile(filePath: string, storage?: SessionStorage): Promise<FileEntry[]>;
+/**
+ * Read-only message view of a session file: load entries, migrate to the
+ * current version, resolve blob refs, and build the context along the
+ * persisted leaf path (last entry). Does NOT create a writer or take the
+ * session lock — safe to call against a file another session is writing.
+ */
+export declare function loadSessionMessagesReadOnly(filePath: string): Promise<AgentMessage[]>;
 declare class RecentSessionInfo {
     #private;
     readonly path: string;
@@ -507,10 +524,11 @@ export declare class SessionManager {
      */
     getBranch(fromId?: string): SessionEntry[];
     /**
-     * Build the session context (what gets sent to the LLM).
+     * Build the session context (what gets sent to the LLM), or — with
+     * `{ transcript: true }` — the full-history display transcript.
      * Uses tree traversal from current leaf.
      */
-    buildSessionContext(): SessionContext;
+    buildSessionContext(options?: BuildSessionContextOptions): SessionContext;
     /** Strip stale OpenAI Responses assistant replay metadata from loaded in-memory entries. */
     sanitizeLoadedOpenAIResponsesReplayMetadata(): boolean;
     /**