@oh-my-pi/pi-coding-agent 15.9.67 → 15.10.1

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

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

package/dist/types/modes/controllers/streaming-reveal.d.ts

@@ -0,0 +1,22 @@
+import type { AssistantMessage } from "@oh-my-pi/pi-ai";
+import type { AssistantMessageComponent } from "../components/assistant-message";
+export declare const STREAMING_REVEAL_FRAME_MS: number;
+export declare const MIN_STEP = 3;
+export declare const CATCHUP_FRAMES = 8;
+type StreamingRevealComponent = Pick<AssistantMessageComponent, "updateContent">;
+type StreamingRevealControllerOptions = {
+    getSmoothStreaming(): boolean;
+    getHideThinkingBlock(): boolean;
+    requestRender(): void;
+};
+export declare function visibleUnits(message: AssistantMessage, hideThinking: boolean): number;
+export declare function buildDisplayMessage(target: AssistantMessage, revealed: number, hideThinking: boolean): AssistantMessage;
+export declare function nextStep(backlog: number): number;
+export declare class StreamingRevealController {
+    #private;
+    constructor(options: StreamingRevealControllerOptions);
+    begin(component: StreamingRevealComponent, message: AssistantMessage): void;
+    setTarget(message: AssistantMessage): void;
+    stop(): void;
+}
+export {};

package/dist/types/modes/controllers/tan-command-controller.d.ts

@@ -0,0 +1,6 @@
+import type { InteractiveModeContext } from "../types";
+export declare class TanCommandController {
+    private readonly ctx;
+    constructor(ctx: InteractiveModeContext);
+    start(work: string): Promise<void>;
+}

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

@@ -1,9 +1,10 @@
 /**
- * Run modes for the coding agent.
+ * Interactive mode and embeddable RPC client exports for the coding agent.
+ *
+ * Branch-specific runners live in their concrete modules so importing this
+ * barrel does not pull print, RPC server, or ACP server mode into the normal
+ * TUI graph.
  */
-export { runAcpMode } from "./acp";
 export { InteractiveMode, type InteractiveModeOptions } from "./interactive-mode";
-export { type PrintModeOptions, runPrintMode } from "./print-mode";
 export { defineRpcClientTool, type ModelInfo, RpcClient, type RpcClientCustomTool, type RpcClientOptions, type RpcClientToolContext, type RpcClientToolResult, type RpcEventListener, } from "./rpc/rpc-client";
-export { runRpcMode } from "./rpc/rpc-mode";
 export type { RpcCommand, RpcHostToolCallRequest, RpcHostToolCancelRequest, RpcHostToolDefinition, RpcHostToolResult, RpcHostToolUpdate, RpcResponse, RpcSessionState, } from "./rpc/rpc-types";

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

@@ -8,7 +8,7 @@ import { Settings } from "../config/settings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
 import type { CompactOptions } from "../extensibility/extensions/types";
 import { type PlanApprovalDetails } from "../plan-mode/approved-plan";
-import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
+import type { AgentSession } from "../session/agent-session";
 import { HistoryStorage } from "../session/history-storage";
 import type { SessionContext, SessionManager } from "../session/session-manager";
 import type { ShakeMode } from "../session/shake-types";
@@ -63,7 +63,6 @@ export declare class InteractiveMode implements InteractiveModeContext {
     hookWidgetContainerBelow: Container;
     statusLine: StatusLineComponent;
     isInitialized: boolean;
-    isBackgrounded: boolean;
     isBashMode: boolean;
     toolOutputExpanded: boolean;
     todoExpanded: boolean;
@@ -150,6 +149,16 @@ export declare class InteractiveMode implements InteractiveModeContext {
     rebuildChatFromMessages(): void;
     /** Apply any deferred model switch after the current stream ends. */
     flushPendingModelSwitch(): Promise<void>;
+    showPlanReview(planContent: string, title: string, options: string[], dialogOptions?: {
+        helpText?: string;
+        disabledIndices?: number[];
+        onExternalEditor?: () => void;
+        onPlanEdited?: (content: string) => void;
+        onFeedbackChange?: (feedback: string) => void;
+        initialIndex?: number;
+    }, extra?: {
+        slider?: HookSelectorSlider;
+    }): Promise<string | undefined>;
     handlePlanModeCommand(initialPrompt?: string): Promise<void>;
     handleGoalModeCommand(rest?: string): Promise<void>;
     handlePlanApproval(details: PlanApprovalDetails): Promise<void>;
@@ -158,9 +167,9 @@ export declare class InteractiveMode implements InteractiveModeContext {
     checkShutdownRequested(): Promise<void>;
     setToolUIContext(uiContext: ExtensionUIContext, hasUI: boolean): void;
     initializeHookRunner(uiContext: ExtensionUIContext, hasUI: boolean): void;
-    createBackgroundUiContext(): ExtensionUIContext;
     setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => CustomEditor) | undefined): void;
-    handleBackgroundEvent(event: AgentSessionEvent): Promise<void>;
+    present(content: Component | readonly Component[]): void;
+    resetTranscript(): void;
     showStatus(message: string, options?: {
         dim?: boolean;
     }): void;
@@ -208,13 +217,14 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleToolsCommand(): void;
     handleContextCommand(): void;
     handleClearCommand(): Promise<void>;
+    handleFreshCommand(): Promise<void>;
     handleDropCommand(): Promise<void>;
     handleForkCommand(): Promise<void>;
     handleMoveCommand(targetPath: string): Promise<void>;
     handleRenameCommand(title: string): Promise<void>;
     handleMemoryCommand(text: string): Promise<void>;
     handleSTTToggle(): Promise<void>;
-    showDebugSelector(): void;
+    showDebugSelector(): Promise<void>;
     showSessionObserver(): void;
     resetObserverRegistry(): void;
     handleBashCommand(command: string, excludeFromContext?: boolean): Promise<void>;
@@ -246,9 +256,9 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleCtrlD(): void;
     handleCtrlZ(): void;
     handleDequeue(): void;
-    handleBackgroundCommand(): void;
     handleImagePaste(): Promise<boolean>;
     handleBtwCommand(question: string): Promise<void>;
+    handleTanCommand(work: string): Promise<void>;
     hasActiveBtw(): boolean;
     handleBtwEscape(): boolean;
     handleOmfgCommand(complaint: string): Promise<void>;

package/dist/types/modes/setup-version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Setup version the wizard advances a fresh install to. Bump it whenever a new
+ * setup scene lands (or an existing scene raises its `minVersion`).
+ *
+ * Kept in its own dependency-free module so the cold-launch gate in `main.ts`
+ * can answer "is the stored setup version stale?" without statically importing
+ * the full wizard — every scene (sign-in/OAuth, web search, theme previews) plus
+ * the overlay component and their TUI deps. MUST equal `max(scene.minVersion)`
+ * across `ALL_SCENES`; the `setup-wizard` barrel and test suite guard it.
+ */
+export declare const CURRENT_SETUP_VERSION = 1;

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

@@ -1,9 +1,10 @@
 import type { Settings } from "../../config/settings";
+import { CURRENT_SETUP_VERSION } from "../setup-version";
 import type { InteractiveModeContext } from "../types";
 import type { SetupScene } from "./scenes/types";
 export type { SetupScene, SetupSceneController, SetupSceneHost, SetupSceneResult } from "./scenes/types";
+export { CURRENT_SETUP_VERSION };
 export declare const ALL_SCENES: readonly [SetupScene, SetupScene, SetupScene];
-export declare const CURRENT_SETUP_VERSION: number;
 export interface SetupSceneSelectionOptions {
     resuming?: boolean;
     isTTY?: boolean;

package/dist/types/modes/setup-wizard/scenes/web-search.d.ts

@@ -2,7 +2,8 @@ import type { SetupSceneHost, SetupTab } from "./types";
 /**
  * "Web search" panel: picks the provider the web_search tool should prefer and
  * reports whether the highlighted provider is ready to use given current
- * credentials (env keys or OAuth sign-ins from the Sign in tab).
+ * credentials (env keys or OAuth sign-ins from the Sign in tab) or an
+ * unauthenticated fallback.
  */
 export declare class WebSearchTab implements SetupTab {
     #private;

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" | "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.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";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "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";
 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 */

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

@@ -8,7 +8,7 @@ import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectIte
 import type { CompactOptions } from "../extensibility/extensions/types";
 import type { MCPManager } from "../mcp";
 import type { PlanApprovalDetails } from "../plan-mode/approved-plan";
-import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
+import type { AgentSession } from "../session/agent-session";
 import type { HistoryStorage } from "../session/history-storage";
 import type { SessionContext, SessionManager } from "../session/session-manager";
 import type { ShakeMode } from "../session/shake-types";
@@ -51,6 +51,7 @@ export type TodoPhase = {
 };
 export interface InteractiveModeInitOptions {
     suppressWelcomeIntro?: boolean;
+    clearInitialTerminalHistory?: boolean;
 }
 export type InteractiveSelectorDialogOptions = ExtensionUIDialogOptions & Pick<HookSelectorOptions, "disabledIndices">;
 export interface InteractiveModeContext {
@@ -76,7 +77,6 @@ export interface InteractiveModeContext {
     mcpManager?: MCPManager;
     lspServers?: LspStartupServerInfo[];
     isInitialized: boolean;
-    isBackgrounded: boolean;
     isBashMode: boolean;
     toolOutputExpanded: boolean;
     todoExpanded: boolean;
@@ -126,9 +126,21 @@ export interface InteractiveModeContext {
     checkShutdownRequested(): Promise<void>;
     setToolUIContext(uiContext: ExtensionUIContext, hasUI: boolean): void;
     initializeHookRunner(uiContext: ExtensionUIContext, hasUI: boolean): void;
-    createBackgroundUiContext(): ExtensionUIContext;
     setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => CustomEditor) | undefined): void;
-    handleBackgroundEvent(event: AgentSessionEvent): Promise<void>;
+    /**
+     * Mount transcript content and repaint once. The single sink for "show this in
+     * chat": producers build and return a `Component` (or a `ChatBlock` carrying
+     * its own lifecycle) and hand it here instead of touching `chatContainer` /
+     * `ui.requestRender()` directly. `ChatBlock`s are mounted (their `onMount`
+     * runs) so their timers/subscriptions start.
+     */
+    present(content: Component | readonly Component[]): void;
+    /**
+     * Dispose every live block in the transcript (stopping timers/subscriptions)
+     * and clear it. Used before a full rebuild so animated/streaming blocks do not
+     * leak.
+     */
+    resetTranscript(): void;
     showStatus(message: string, options?: {
         dim?: boolean;
     }): void;
@@ -208,6 +220,7 @@ export interface InteractiveModeContext {
     handleDumpCommand(): void;
     handleDebugTranscriptCommand(): Promise<void>;
     handleClearCommand(): Promise<void>;
+    handleFreshCommand(): Promise<void>;
     handleDropCommand(): Promise<void>;
     handleForkCommand(): Promise<void>;
     handleBashCommand(command: string, excludeFromContext?: boolean): Promise<void>;
@@ -241,16 +254,16 @@ export interface InteractiveModeContext {
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
     showHookConfirm(title: string, message: string): Promise<boolean>;
-    showDebugSelector(): void;
+    showDebugSelector(): Promise<void>;
     showSessionObserver(): void;
     resetObserverRegistry(): void;
     handleCtrlC(): void;
     handleCtrlD(): void;
     handleCtrlZ(): void;
     handleDequeue(): void;
-    handleBackgroundCommand(): void;
     handleImagePaste(): Promise<boolean>;
     handleBtwCommand(question: string): Promise<void>;
+    handleTanCommand(work: string): Promise<void>;
     hasActiveBtw(): boolean;
     handleBtwEscape(): boolean;
     handleOmfgCommand(complaint: string): Promise<void>;

package/dist/types/modes/utils/copy-targets.d.ts

@@ -6,6 +6,17 @@ export interface CodeBlock {
     /** Block body with the trailing newline stripped. */
     code: string;
 }
+/** A blockquote block: a maximal run of `>`-prefixed lines from markdown. */
+export interface QuoteBlock {
+    /** Block body with each line's `>` marker (and one optional space) removed. */
+    text: string;
+}
+/** A drillable block within an assistant message, in document order. */
+export type MessageBlock = ({
+    kind: "code";
+} & CodeBlock) | ({
+    kind: "quote";
+} & QuoteBlock);
 /** A runnable command found in the transcript. */
 export interface LastCommand {
     kind: "bash" | "eval";
@@ -19,7 +30,7 @@ export interface LastCommand {
  * `children` to drill into.
  */
 export interface CopyTarget {
-    /** Stable identifier (e.g. "msg:1", "msg:1:code:0", "msg:1:all", "cmd:1"). */
+    /** Stable id (e.g. "msg:1", "msg:1:code:0", "msg:1:quote:0", "msg:1:all", "cmd:1"). */
     id: string;
     label: string;
     /** Dim annotation: line/block counts, language, or tool name. */
@@ -40,8 +51,17 @@ export interface CopySource {
     readonly messages: readonly AgentMessage[];
     getLastVisibleHandoffText(): string | undefined;
 }
+/**
+ * Split assistant markdown into drillable blocks — fenced code and `>`-quoted
+ * runs — in document order. Fences mask their bodies, so a `>` line inside a
+ * code block is never mistaken for a quote. An unclosed fence is treated as
+ * ordinary text, matching the fenced-block grammar.
+ */
+export declare function extractBlocks(text: string): MessageBlock[];
 /** Extract fenced code blocks from assistant markdown, in document order. */
 export declare function extractCodeBlocks(text: string): CodeBlock[];
+/** Extract `>`-quoted blocks from assistant markdown, in document order. */
+export declare function extractQuoteBlocks(text: string): QuoteBlock[];
 /** Walk the transcript backwards for the most recent bash command or eval code. */
 export declare function extractLastCommand(messages: readonly AgentMessage[]): LastCommand | undefined;
 /**

package/dist/types/plan-mode/approved-plan.d.ts

@@ -1,9 +1,10 @@
 /** Shape forwarded from the plan-mode resolve handler to InteractiveMode's
  *  approval popup. Populated by the standing handler that the resolve tool
- *  dispatches to when the agent submits `resolve { action: "apply" }`. */
+ *  dispatches to when the agent submits `resolve { action: "apply" }`.
+ *  `planFilePath` is the agent-chosen `local://<slug>-plan.md` artifact — it is
+ *  never renamed on approval, so links to it stay valid for the session. */
 export interface PlanApprovalDetails {
     planFilePath: string;
-    finalPlanFilePath: string;
     title: string;
     planExists: boolean;
 }
@@ -39,11 +40,29 @@ export declare function resolvePlanTitle(input: {
  *  Replaces `-`/`_` separators with spaces and capitalizes the first letter.
  *  Returns an empty string when the input collapses to whitespace. */
 export declare function humanizePlanTitle(title: string): string;
-interface RenameApprovedPlanFileOptions {
+/** The `local://` URL a plan slug maps to. The agent writes the plan here and
+ *  passes the slug to `resolve`; the file is never renamed, so this URL — and
+ *  any hyperlink to it — stays valid for the life of the session. */
+export declare function planFileUrlForSlug(slug: string): string;
+export interface ResolveApprovedPlanInput {
+    /** The agent's `extra.title` from the `resolve` call, if any. */
+    suppliedTitle?: unknown;
+    /** The plan path recorded in plan-mode state (the entry default or a prior plan). */
+    statePlanFilePath: string;
+    /** Read a plan `local://` URL, returning null when the file does not exist. */
+    readPlan: (planUrl: string) => Promise<string | null>;
+    /** Optional fallback: list candidate plan `local://` URLs (newest first) so a
+     *  plan whose name can't be reconstructed (e.g. a dropped `extra.title`) is
+     *  still found. */
+    listPlanFiles?: () => Promise<string[]>;
+}
+export interface ResolvedApprovedPlan {
     planFilePath: string;
-    finalPlanFilePath: string;
-    getArtifactsDir: () => string | null;
-    getSessionId: () => string | null;
+    planContent: string;
+    title: string;
 }
-export declare function renameApprovedPlanFile(options: RenameApprovedPlanFileOptions): Promise<void>;
-export {};
+/** Locate the plan file the agent wrote and finalize its title — without
+ *  renaming anything. Tries, in order: the slug derived from `extra.title`
+ *  (`local://<slug>-plan.md`), the plan path from plan-mode state, then a scan
+ *  of recent plan files. Throws a `ToolError` guiding the agent when none exist. */
+export declare function resolveApprovedPlan(input: ResolveApprovedPlanInput): Promise<ResolvedApprovedPlan>;

package/dist/types/plan-mode/plan-protection.d.ts

@@ -3,10 +3,10 @@ import { type ProtectedToolContext } from "@oh-my-pi/pi-agent-core/compaction/to
  * Build a compaction protection matcher that keeps `read` results for the active
  * plan file intact through prune/shake — the plan analog of skill-read
  * protection. Matches both the canonical `local://PLAN.md` alias and the
- * session's current plan reference path (e.g. a titled `local://<title>.md`), so
- * the plan survives compaction whether the agent reads it by alias or by title.
+ * session's current plan reference path (the agent-chosen `local://<slug>-plan.md`),
+ * so the plan survives compaction whether the agent reads it by alias or by name.
  *
- * `getPlanReferencePath` is evaluated at match time so a mid-session retitle
- * (plan approval renames `PLAN.md` → `<title>.md`) is honored immediately.
+ * `getPlanReferencePath` is evaluated at match time so the plan path set on
+ * approval is honored immediately.
  */
 export declare function createPlanReadMatcher(getPlanReferencePath: () => string): (context: ProtectedToolContext) => boolean;

package/dist/types/sdk.d.ts

@@ -13,7 +13,7 @@ import { type FileSlashCommand } from "./extensibility/slash-commands";
 import type { HindsightSessionState } from "./hindsight/state";
 import { type LocalProtocolOptions } from "./internal-urls";
 import { MCPManager, type MCPToolsLoadResult } from "./mcp";
-import { type MnemopiSessionState } from "./mnemopi/state";
+import type { MnemopiSessionState } from "./mnemopi/state";
 import { AgentRegistry } from "./registry/agent-registry";
 import { AgentSession } from "./session/agent-session";
 import { AuthStorage } from "./session/auth-storage";
@@ -51,6 +51,8 @@ export interface CreateAgentSessionOptions {
     /** Optional provider-facing session identifier for prompt caches and sticky auth selection.
      * Keeps persisted session files isolated while reusing provider-side caches. */
     providerSessionId?: string;
+    /** Optional provider-facing prompt cache key, distinct from request lineage. */
+    providerPromptCacheKey?: string;
     /** Custom tools to register (in addition to built-in tools). Accepts both CustomTool and ToolDefinition. */
     customTools?: (CustomTool | ToolDefinition)[];
     /** Inline extensions (merged with discovery). */

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

@@ -294,6 +294,11 @@ export interface SessionStats {
     premiumRequests: number;
     cost: number;
 }
+export interface FreshSessionResult {
+    previousSessionId: string;
+    sessionId: string;
+    closedProviderSessions: number;
+}
 export declare const ANTHROPIC_TOOL_CALL_BATCH_CAP = 4;
 export declare function resolveToolCallBatchCapForModel(model: Model | undefined): number | undefined;
 export declare class AgentSession {
@@ -308,6 +313,8 @@ export declare class AgentSession {
     constructor(config: AgentSessionConfig);
     /** Model registry for API key resolution and model discovery */
     get modelRegistry(): ModelRegistry;
+    get asyncJobManager(): AsyncJobManager | undefined;
+    getAgentId(): string | undefined;
     /** Advance the tool-choice queue and return the next directive for the upcoming LLM call. */
     nextToolChoice(): ToolChoice | undefined;
     /**
@@ -378,6 +385,7 @@ export declare class AgentSession {
      * Call this when completely done with the session.
      */
     dispose(): Promise<void>;
+    freshSession(): FreshSessionResult | undefined;
     /** Full agent state */
     get state(): AgentState;
     /** Current model (may be undefined if not yet selected) */
@@ -609,9 +617,22 @@ export declare class AgentSession {
     setTodoPhases(phases: TodoPhase[]): void;
     /**
      * Abort current operation and wait for agent to become idle.
+     *
+     * `reason` (e.g. `USER_INTERRUPT_LABEL`) rides the agent's `AbortController`
+     * and surfaces verbatim on the aborted assistant message's `errorMessage`, so
+     * the transcript can distinguish a deliberate user interrupt from an opaque
+     * abort. Omit it for internal/lifecycle aborts.
      */
     abort(options?: {
         goalReason?: "interrupted" | "internal";
+        reason?: string;
+    }): Promise<void>;
+    /**
+     * Abort active work, then immediately resume the agent so queued steer/follow-up
+     * messages drain instead of waiting for another natural turn boundary.
+     */
+    interruptAndFlushQueuedMessages(options?: {
+        reason?: string;
     }): Promise<void>;
     /**
      * Start a new session, optionally with initial messages and parent tracking.

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

@@ -40,6 +40,18 @@ export declare const SILENT_ABORT_MARKER = "__omp.silent_abort__";
  *  than string-comparing inline so refactors to the marker constant (e.g.,
  *  namespacing changes) propagate through every consumer in lockstep. */
 export declare function isSilentAbort(errorMessage: string | undefined): boolean;
+/** Reason threaded through `AbortController.abort(reason)` when the user aborts
+ *  the turn with Esc (see `AgentSession.abort`). The agent surfaces it verbatim
+ *  on the aborted assistant message's `errorMessage`, so the transcript reads as
+ *  a deliberate user interrupt instead of an opaque failure. */
+export declare const USER_INTERRUPT_LABEL = "Interrupted by user";
+/** Resolve the operator-facing label for an aborted assistant turn. A custom
+ *  abort reason (e.g. `USER_INTERRUPT_LABEL`) threaded onto `errorMessage` is
+ *  shown verbatim; aborts with no threaded reason fall back to the retry-aware
+ *  generic label. Centralizes the live-stream (`EventController`), replay
+ *  (`ui-helpers`), and component (`AssistantMessageComponent`) render paths so
+ *  they stay in lockstep. */
+export declare function resolveAbortLabel(errorMessage: string | undefined, retryAttempt?: number): string;
 /** Extract the optional `__pendingDisplayTag` field from a CustomMessage's
  *  `details` blob. Safe over `unknown`; returns undefined when the field is
  *  absent or non-string. */

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

@@ -565,7 +565,9 @@ export declare class SessionManager {
      * Fork a session into the current project directory.
      * Copies history from another session file while creating a new session file in the current sessionDir.
      */
-    static forkFrom(sourcePath: string, cwd: string, sessionDir?: string, storage?: SessionStorage): Promise<SessionManager>;
+    static forkFrom(sourcePath: string, cwd: string, sessionDir?: string, storage?: SessionStorage, options?: {
+        suppressBreadcrumb?: boolean;
+    }): Promise<SessionManager>;
     /**
      * Open a specific session file.
      * @param path Path to session file

package/dist/types/slash-commands/types.d.ts

@@ -69,15 +69,13 @@ export interface SlashCommandRuntime {
 }
 /**
  * Runtime visible to TUI-only handlers (`handleTui`). Carries the interactive
- * mode context plus the background-detach hook. Intentionally narrower than
- * `SlashCommandRuntime` so existing callers can keep building it from just
- * `{ ctx, handleBackgroundCommand }`; when the TUI dispatcher needs to invoke
- * a `handle` (no `handleTui` override), it synthesizes a `SlashCommandRuntime`
- * from `ctx`.
+ * mode context. Intentionally narrower than `SlashCommandRuntime` so existing
+ * callers can keep building it from just `{ ctx }`; when the TUI dispatcher
+ * needs to invoke a `handle` (no `handleTui` override), it synthesizes a
+ * `SlashCommandRuntime` from `ctx`.
  */
 export interface TuiSlashCommandRuntime {
     ctx: InteractiveModeContext;
-    handleBackgroundCommand: () => void;
 }
 /** Unified slash-command spec consumed by both TUI and ACP dispatchers. */
 export interface SlashCommandSpec extends BuiltinSlashCommand {

package/dist/types/task/executor.d.ts

@@ -7,6 +7,8 @@ import type { AgentTelemetryConfig, ThinkingLevel } from "@oh-my-pi/pi-agent-cor
 import { ModelRegistry } from "../config/model-registry";
 import type { PromptTemplate } from "../config/prompt-templates";
 import { Settings } from "../config/settings";
+import { type SettingPath } from "../config/settings-schema";
+import type { CustomTool } from "../extensibility/custom-tools/types";
 import { type Skill } from "../extensibility/skills";
 import type { HindsightSessionState } from "../hindsight/state";
 import type { LocalProtocolOptions } from "../internal-urls";
@@ -48,6 +50,13 @@ export interface ExecutorOptions {
     outputSchema?: unknown;
     /** Parent task recursion depth (0 = top-level, 1 = first child, etc.) */
     taskDepth?: number;
+    /**
+     * Override the `task.maxRuntimeMs` wall-clock cap for this run. When provided
+     * it wins over the settings value; `0` disables the per-subagent wall-clock
+     * limit entirely. Used by the eval `agent()` bridge, whose parent cell
+     * watchdog is already suspended for the call's duration.
+     */
+    maxRuntimeMs?: number;
     enableLsp?: boolean;
     signal?: AbortSignal;
     onProgress?: (progress: AgentProgress) => void;
@@ -114,6 +123,11 @@ interface FinalizeSubprocessOutputResult {
 export declare const SUBAGENT_WARNING_NULL_YIELD = "SYSTEM WARNING: Subagent called yield with null data.";
 export declare const SUBAGENT_WARNING_MISSING_YIELD = "SYSTEM WARNING: Subagent exited without calling yield tool after 3 reminders.";
 export declare function finalizeSubprocessOutput(args: FinalizeSubprocessOutputArgs): FinalizeSubprocessOutputResult;
+/**
+ * Create proxy tools that reuse the parent's MCP connections.
+ */
+export declare function createMCPProxyTools(mcpManager: MCPManager): CustomTool[];
+export declare function createSubagentSettings(baseSettings: Settings, overrides?: Partial<Record<SettingPath, unknown>>): Settings;
 /**
  * Run a single agent in-process.
  */

package/dist/types/task/index.d.ts

@@ -29,6 +29,7 @@ export declare class TaskTool implements AgentTool<TaskToolSchemaInstance, TaskT
     readonly strict = true;
     readonly loadMode = "discoverable";
     readonly renderResult: typeof renderResult;
+    readonly mergeCallAndResult = true;
     get parameters(): TaskToolSchemaInstance;
     renderCall(args: unknown, options: Parameters<typeof renderTaskCall>[1], theme: Theme): import("@oh-my-pi/pi-tui").Component;
     /** Dynamic description that reflects current disabled-agent settings */

package/dist/types/task/render.d.ts

@@ -1,6 +1,6 @@
 import type { Component } from "@oh-my-pi/pi-tui";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
-import type { Theme } from "../modes/theme/theme";
+import { type Theme } from "../modes/theme/theme";
 import type { TaskParams, TaskToolDetails } from "./types";
 /**
  * Render the tool call arguments.
@@ -19,8 +19,9 @@ export declare function renderResult(result: {
         text?: string;
     }>;
     details?: TaskToolDetails;
-}, options: RenderResultOptions, theme: Theme): Component;
+}, options: RenderResultOptions, theme: Theme, args?: TaskParams): Component;
 export declare const taskToolRenderer: {
     renderCall: typeof renderCall;
     renderResult: typeof renderResult;
+    mergeCallAndResult: boolean;
 };

package/dist/types/telemetry-export.d.ts

@@ -10,7 +10,7 @@ export declare function isTelemetryExportEnabled(): boolean;
  * the OTEL kill-switches are engaged), so it is safe to call unconditionally at
  * startup.
  */
-export declare function initTelemetryExport(): void;
+export declare function initTelemetryExport(): Promise<void>;
 /**
  * Flush any buffered spans to the exporter. No-op when export is disabled.
  * Hosts embedding the agent can call this at natural boundaries (e.g. the end

package/dist/types/tools/archive-reader.d.ts

@@ -31,6 +31,8 @@ type EntryStorage = TarStorage | ZipStorage;
 interface ArchiveIndexEntry extends ArchiveNode {
     storage?: EntryStorage;
 }
+export declare function formatArchiveEntryLines(entries: readonly ArchiveDirectoryEntry[]): string[];
+export declare function sniffArchiveFormat(bytes: Uint8Array): ArchiveFormat | undefined;
 export declare function parseArchivePathCandidates(filePath: string): ArchivePathCandidate[];
 export declare class ArchiveReader {
     #private;
@@ -41,4 +43,7 @@ export declare class ArchiveReader {
     readFile(subPath: string): Promise<ExtractedArchiveFile>;
 }
 export declare function openArchive(filePath: string): Promise<ArchiveReader>;
+export declare function listArchiveRoot(bytes: Uint8Array, format: ArchiveFormat, opts?: {
+    limit?: number;
+}): Promise<string>;
 export {};

package/dist/types/tools/ast-edit.d.ts

@@ -34,6 +34,9 @@ export interface AstEditToolDetails {
     /** Absolute base directory used during the edit. Used by the renderer to resolve
      * display-relative paths to absolute paths for OSC 8 hyperlinks. */
     searchPath?: string;
+    /** Session cwd at edit time. Display header paths are cwd-relative, so the
+     * renderer resolves them against this; `searchPath` is the scope target. */
+    cwd?: string;
 }
 export declare class AstEditTool implements AgentTool<typeof astEditSchema, AstEditToolDetails> {
     private readonly session;

package/dist/types/tools/ast-grep.d.ts

@@ -31,6 +31,9 @@ export interface AstGrepToolDetails {
     /** Absolute base directory used during search. Used by the renderer to resolve
      * display-relative paths to absolute paths for OSC 8 hyperlinks. */
     searchPath?: string;
+    /** Session cwd at search time. Display header/match paths are cwd-relative, so
+     * the renderer resolves them against this; `searchPath` is the scope target. */
+    cwd?: string;
 }
 export declare class AstGrepTool implements AgentTool<typeof astGrepSchema, AstGrepToolDetails> {
     private readonly session;

package/dist/types/tools/bash.d.ts

@@ -99,6 +99,7 @@ export interface ShellRendererConfig<TArgs> {
     resolveCommand?: (args: TArgs | undefined) => string | undefined;
     resolveCwd?: (args: TArgs | undefined) => string | undefined;
     resolveEnv?: (args: TArgs | undefined) => Record<string, string> | undefined;
+    showHeader?: boolean;
 }
 export declare function getBashEnvForDisplay(args: BashRenderArgs): Record<string, string> | undefined;
 /**