@oh-my-pi/pi-coding-agent 16.2.12 → 16.3.0

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

@@ -2,6 +2,8 @@
 type ToolArgsRevealComponent = {
     updateArgs(args: unknown, toolCallId?: string): void;
 };
+/** String fields the streamed-args decode reads incrementally for `toolName`. */
+export declare function streamingStringKeysForTool(toolName: string, rawInput: boolean): readonly string[] | undefined;
 type ToolArgsRevealControllerOptions = {
     getSmoothStreaming(): boolean;
     requestRender(): void;
@@ -9,8 +11,29 @@ type ToolArgsRevealControllerOptions = {
 type ToolArgsRevealTarget = {
     rawInput: boolean;
     exposeRawPartialJson: boolean;
-    fullArgs: Record<string, unknown>;
+    streamingStringKeys?: readonly string[];
 };
+type StreamedToolArgsSource = {
+    /** Custom-tool raw text stream (`customWireName` tools): never JSON-parsed. */
+    rawInput: boolean;
+    /** Provider-parsed arguments, spread UNDER the fresh decode: a dialect
+     *  projector may carry keys a raw re-parse cannot recover, but any key the
+     *  fresh parse does recover wins — provider parses lag the stream by up to
+     *  STREAMING_JSON_PARSE_MIN_GROWTH bytes mid-stream. */
+    fullArgs?: Record<string, unknown>;
+    /** See {@link streamingStringKeysForTool}. */
+    streamingStringKeys?: readonly string[];
+};
+/**
+ * One-shot decode of a streamed tool-call argument buffer into display args —
+ * the same decode the live reveal applies frame-by-frame, for paths that see
+ * the buffer once (transcript rebuilds on theme change, settings, focus
+ * replay). Keeps a rebuilt preview identical to the live preview: parsed
+ * fields come from a fresh parse of the full buffer, `streamingStringKeys`
+ * fields from the incremental string decoder (which also wins ties in the
+ * live path), never from the provider's throttled `arguments`.
+ */
+export declare function decodeStreamedToolArgs(partialJson: string, source: StreamedToolArgsSource): Record<string, unknown>;
 /**
  * Paces streamed tool-call arguments the same way StreamingRevealController
  * paces assistant text: providers that deliver `partialJson` in large batches
@@ -30,8 +53,12 @@ export declare class ToolArgsRevealController {
     constructor(options: ToolArgsRevealControllerOptions);
     /**
      * Record the latest streamed argument text for a tool call and return the
-     * args to render right now. With smoothing disabled the full target passes
-     * through in the caller's legacy shape (`{ ...args, __partialJson }`).
+     * args to render right now. With smoothing disabled nothing is paced — the
+     * full received buffer decodes in one step — but the entry still runs the
+     * incremental string decoder + parse throttle, so streamed text fields
+     * (write `content`, edit bodies, eval `code`) stay fresh between the
+     * provider's own throttled full-JSON parses instead of lagging up to
+     * STREAMING_JSON_PARSE_MIN_GROWTH bytes behind.
      */
     setTarget(id: string, partialJson: string, target: ToolArgsRevealTarget): Record<string, unknown>;
     /** Attach the component future ticks push frames into. */

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

@@ -9,9 +9,10 @@ import { KeybindingsManager } from "../config/keybindings";
 import { Settings } from "../config/settings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
 import type { CompactOptions } from "../extensibility/extensions/types";
+import type { Skill } from "../extensibility/skills";
 import type { MCPManager } from "../mcp";
 import { type PlanApprovalDetails } from "../plan-mode/approved-plan";
-import type { AgentSession } from "../session/agent-session";
+import { type AgentSession } from "../session/agent-session";
 import type { CompactMode } from "../session/compact-modes";
 import { HistoryStorage } from "../session/history-storage";
 import type { SessionContext } from "../session/session-context";
@@ -62,8 +63,10 @@ export interface InteractiveModeOptions {
 }
 /**
  * Build the anchored subagent HUD block: a bold accent "Subagents" header plus
- * one hooked row per running agent in the same `Id: description` shape the
+ * one tree row per running agent in the same `Id: description` shape the
  * inline task rows use (muted task preview when no description was given).
+ * Layout mirrors the Todos HUD exactly: unindented header, then
+ * `renderTreeList` rows (dim connectors) shifted right by one space.
  * Only detached background spawns are listed: a sync task call blocks the
  * parent turn and its inline tool block already renders progress live, and
  * eval `agent()` spawns are rendered by their own eval cell tree.
@@ -78,7 +81,6 @@ export declare class InteractiveMode implements InteractiveModeContext {
     keybindings: KeybindingsManager;
     agent: Agent;
     historyStorage?: HistoryStorage;
-    titleSystemPrompt?: string;
     ui: TUI;
     chatContainer: TranscriptContainer;
     pendingMessagesContainer: Container;
@@ -153,7 +155,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     lastStatusSpacer: Spacer | undefined;
     lastStatusText: Text | undefined;
     fileSlashCommands: Set<string>;
-    skillCommands: Map<string, string>;
+    skillCommands: Map<string, Skill>;
     oauthManualInput: OAuthManualInputManager;
     collabHost?: CollabHost;
     collabGuest?: CollabGuestLink;
@@ -167,10 +169,14 @@ export declare class InteractiveMode implements InteractiveModeContext {
     focusParentSession(): Promise<void>;
     unfocusSession(): Promise<void>;
     clearTransientSessionUi(): void;
-    constructor(session: AgentSession, version: string, changelogMarkdown?: string | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: MCPManager, eventBus?: EventBus, titleSystemPrompt?: string);
+    constructor(session: AgentSession, version: string, changelogMarkdown?: string | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: MCPManager, eventBus?: EventBus);
     playWelcomeIntro(): void;
     init(options?: InteractiveModeInitOptions): Promise<void>;
-    /** Reload the title-generation system prompt override for the provided working directory. */
+    /** Reload the title-generation system prompt override for the provided working
+     *  directory and stash it on the session so first-input titling
+     *  ({@link input-controller}) and replan-driven refresh
+     *  ({@link AgentSession.#refreshTitleAfterReplan}) share one source
+     *  ({@link discoverTitleSystemPromptFile}; issue #3734). */
     refreshTitleSystemPrompt(cwd?: string): Promise<void>;
     /** Reload slash commands and autocomplete for the provided working directory. */
     refreshSlashCommandState(cwd?: string): Promise<void>;
@@ -212,7 +218,6 @@ export declare class InteractiveMode implements InteractiveModeContext {
     updateEditorBorderColor(): void;
     /** Refresh the running-subagents status badge from the active local or collab registry. */
     syncRunningSubagentBadge(): void;
-    updateEditorTopBorder(): void;
     rebuildChatFromMessages(): void;
     /**
      * Render the ctrl+p model-role cycle chip track into its own anchored

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

@@ -51,6 +51,11 @@ export declare class RpcClient {
     constructor(options?: RpcClientOptions);
     /**
      * Start the RPC agent process.
+     *
+     * Safe to call again after {@link stop} on the same instance: a fresh
+     * {@link AbortController} is minted for each start, and any failure after
+     * the child spawn kills the child and clears internal state so callers may
+     * retry without leaking processes.
      */
     start(): Promise<void>;
     /**

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

@@ -2,7 +2,7 @@ import { type ExtensionUIContext, type ExtensionUIDialogOptions } from "../../ex
 import type { AgentSession } from "../../session/agent-session";
 import type { EventBus } from "../../utils/event-bus";
 import { RpcSubagentRegistry } from "./rpc-subagents";
-import type { RpcCommand, RpcExtensionUIRequest, RpcExtensionUIResponse, RpcHostToolCallRequest, RpcHostToolCancelRequest, RpcHostUriCancelRequest, RpcHostUriRequest, RpcResponse } from "./rpc-types";
+import type { RpcCommand, RpcExtensionUIRequest, RpcExtensionUIResponse, RpcHostToolCallRequest, RpcHostToolCancelRequest, RpcHostToolResult, RpcHostToolUpdate, RpcHostUriCancelRequest, RpcHostUriRequest, RpcHostUriResult, RpcResponse } from "./rpc-types";
 export type * from "./rpc-types";
 export type PendingExtensionRequest = {
     resolve: (response: RpcExtensionUIResponse) => void;
@@ -70,6 +70,69 @@ export declare function watchAndReportLocalOnlyPromptResult(input: {
     onError: (error: Error) => void;
     extensionUserMessageTracker: RpcExtensionUserMessageTracker;
 }): void;
+/**
+ * Dependencies for {@link dispatchRpcInputFrame}. Provided by the RPC mode
+ * entrypoint; broken out so tests can drive the input loop with stubs.
+ */
+export interface RpcInputFrameDeps {
+    handleCommand: (command: RpcCommand) => Promise<RpcResponse>;
+    output: RpcOutput;
+    errorResponse: (id: string | undefined, command: string, message: string) => RpcResponse;
+    trackBackgroundTask?: (task: Promise<void>) => void;
+    pendingExtensionRequests: Map<string, PendingExtensionRequest>;
+    onHostToolResult: (frame: RpcHostToolResult) => void;
+    onHostToolUpdate: (frame: RpcHostToolUpdate) => void;
+    onHostUriResult: (frame: RpcHostUriResult) => void;
+}
+/**
+ * Dispatch a single parsed frame from the RPC input stream.
+ *
+ * Bash commands are dispatched in the background so the caller (the stdin loop
+ * in {@link runRpcMode}) can keep reading subsequent frames while a shell
+ * command is still running. This lets a client send `abort_bash` (or any other
+ * command) while a long-running `bash` is in flight. Response correlation is
+ * preserved via each command's `id`; ordering across concurrent commands is
+ * not guaranteed and clients MUST match on `id`.
+ *
+ * @returns `undefined` when the frame was routed to a side-channel handler
+ *   (extension UI response, host tool/URI frames) or dispatched in the
+ *   background (`bash`). Otherwise a promise that resolves once the response
+ *   for the command has been emitted via `output`. Errors from `handleCommand`
+ *   on non-`bash` commands propagate; the caller is expected to wrap them.
+ */
+export declare function dispatchRpcInputFrame(parsed: unknown, deps: RpcInputFrameDeps): Promise<void> | undefined;
+/**
+ * Coordinates deferred shutdown with in-flight background input tasks.
+ *
+ * `pi.shutdown()` from an extension only *requests* shutdown; the process must
+ * not exit while a background-dispatched command (`bash`, see
+ * {@link dispatchRpcInputFrame}) still owes the client a response frame. The
+ * coordinator tracks those tasks, re-checks the shutdown request whenever one
+ * settles (covering a shutdown requested mid-bash with no follow-up client
+ * frame), and drains every tracked task before invoking `performShutdown`.
+ * The shutdown sequence is latched so concurrent triggers (input loop and
+ * settling tasks) run it exactly once.
+ */
+export declare class RpcShutdownCoordinator {
+    #private;
+    constructor(options: {
+        isShutdownRequested: () => boolean;
+        performShutdown: () => Promise<void>;
+    });
+    /**
+     * Track a background input task. When it settles it is untracked and the
+     * shutdown request is re-checked, so a deferred shutdown fires even when
+     * no further client frames arrive.
+     */
+    track(task: Promise<void>): void;
+    /** Await every tracked task, including tasks tracked while draining. */
+    drain(): Promise<void>;
+    /**
+     * If shutdown was requested, drain background tasks (so every owed
+     * response frame is written) before running the shutdown sequence.
+     */
+    checkShutdownRequested(): Promise<void>;
+}
 export type RpcSubagentResetRegistry = Pick<RpcSubagentRegistry, "clear">;
 export declare function handleRpcSessionChange(session: RpcSessionChangeSession, command: RpcSessionChangeCommand, subagentRegistry?: RpcSubagentResetRegistry): Promise<RpcSessionChangeResult>;
 export declare function requestRpcEditor(pendingRequests: Map<string, PendingExtensionRequest>, output: RpcOutput, title: string, prefill?: string, dialogOptions?: ExtensionUIDialogOptions, editorOptions?: {

package/dist/types/modes/session-teardown.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Signal-safe session teardown: persists the in-progress editor draft, then
+ * disposes the session (which emits `session_shutdown`, cancels the session's
+ * background async jobs, and closes the session manager). Shared by the TUI
+ * Ctrl+C/Ctrl+D/`/exit` keypress path in `InteractiveMode.shutdown()` and by
+ * the postmortem `SIGINT`/`SIGTERM`/`SIGHUP`/`uncaughtException` handlers so a
+ * real kernel signal executes the exact same teardown as a keypress exit.
+ *
+ * Extracted (rather than inlined into `InteractiveMode`) so the callback body
+ * is directly unit-testable without instantiating the full TUI stack.
+ */
+import { type postmortem } from "@oh-my-pi/pi-utils";
+/** Dependencies the teardown captures at construction time. */
+export interface SessionTeardownDeps {
+    /** Snapshot the current editor text; called once, before disposal touches session state. */
+    getDraftText: () => string;
+    /**
+     * Synchronously mark the session as disposing before any awaited teardown
+     * work. This closes the async gap where deferred jobs could otherwise start
+     * after a signal requested shutdown but before `disposeSession()` begins.
+     */
+    beginDispose: () => void;
+    /**
+     * Persist the snapshotted draft. Called even for an empty string so a
+     * previously-persisted draft sidecar is cleared on a clean exit.
+     */
+    saveDraft: (text: string) => Promise<void>;
+    /**
+     * Dispose the session — emits `session_shutdown`, drains async jobs, closes
+     * the manager. Receives the postmortem reason that triggered the teardown
+     * (undefined on the keypress/`/exit` path) so `AgentSession.dispose()` can
+     * persist the real exit reason instead of the generic `"dispose"`.
+     */
+    disposeSession: (reason?: postmortem.Reason) => Promise<void>;
+}
+/**
+ * Idempotent teardown: concurrent/repeat invocations share one settled
+ * promise. The optional `reason` is the postmortem reason that triggered the
+ * teardown (`sigterm`, `sighup`, `uncaught_exception`, …); only the FIRST
+ * call's reason is used — later callers await the same settled promise.
+ */
+export type SessionTeardown = (reason?: postmortem.Reason) => Promise<void>;
+/**
+ * Build a promise-memoized teardown function. The first call snapshots the
+ * draft text, marks the session disposing synchronously, runs `saveDraft`
+ * (draft-loss protection for `--resume`), then `disposeSession`; subsequent
+ * calls await the same settled promise, so the keypress
+ * `InteractiveMode.shutdown()` path and the postmortem signal callback cannot
+ * double-emit `session_shutdown`, double-dispose the session's async-job
+ * manager, or race each other.
+ *
+ * The postmortem callback forwards its `Reason` so the persisted
+ * `session_exit` diagnostic carries the real trigger (`sigterm`, `sighup`,
+ * `uncaught_exception`, …) instead of the generic `"dispose"` that plain
+ * programmatic disposal records. First call wins: a signal arriving after a
+ * keypress-initiated teardown awaits the in-flight promise and its reason is
+ * dropped — by then the exit entry is already being written as a normal exit.
+ *
+ * `saveDraft` failures are logged but never abort the disposal chain — a
+ * draft-write error must not leak background bash/task jobs or skip the
+ * extension `session_shutdown` event.
+ */
+export declare function createSessionTeardown(deps: SessionTeardownDeps): SessionTeardown;

package/dist/types/modes/session-teardown.test.d.ts

@@ -0,0 +1 @@
+export {};

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.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "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.julia" | "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.files" | "tab.shell" | "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" | "tool.delete" | "tool.move";
+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.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "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.julia" | "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.files" | "tab.shell" | "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" | "tool.delete" | "tool.move";
 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 */
@@ -182,6 +182,7 @@ export declare class Theme {
         cacheMiss: string;
         input: string;
         output: string;
+        throughput: string;
         host: string;
         session: string;
         package: string;
@@ -262,19 +263,23 @@ export declare var theme: Theme;
 export declare function getCurrentThemeName(): string | undefined;
 /** Returns unstyled `text` before `initTheme()` assigns the global theme; use only for early-render paths. */
 export declare function fgOrPlain(color: ThemeColor, text: string, styledText?: string): string;
+export interface ThemeChangeEvent {
+    /** Preview/presentation-only changes should repaint live UI without replacing native scrollback. */
+    ephemeral?: boolean;
+}
 export declare function initTheme(enableWatcher?: boolean, symbolPreset?: SymbolPreset, colorBlindMode?: boolean, darkTheme?: string, lightTheme?: string): Promise<void>;
 export declare function setTheme(name: string, enableWatcher?: boolean): Promise<{
     success: boolean;
     error?: string;
 }>;
-export declare function previewTheme(name: string): Promise<{
+export declare function previewTheme(name: string, event?: ThemeChangeEvent): Promise<{
     success: boolean;
     error?: string;
 }>;
 /**
  * Enable auto-detection mode, switching to the appropriate dark/light theme.
  */
-export declare function enableAutoTheme(): void;
+export declare function enableAutoTheme(event?: ThemeChangeEvent): void;
 /**
  * Update the theme mappings for auto-detection mode.
  * When a dark/light mapping changes and auto-detection is active, re-evaluate the theme.
@@ -304,7 +309,7 @@ export declare function setColorBlindMode(enabled: boolean): Promise<void>;
  * Get the current color blind mode setting.
  */
 export declare function getColorBlindMode(): boolean;
-export declare function onThemeChange(callback: () => void): () => void;
+export declare function onThemeChange(callback: (event: ThemeChangeEvent) => void): () => void;
 /**
  * Monotonic counter bumped on any theme-affecting change that should invalidate
  * cached renders: theme swaps and reloads (including the invalid-theme dark

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

@@ -8,6 +8,7 @@ import type { KeybindingsManager } from "../config/keybindings";
 import type { Settings } from "../config/settings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
 import type { CompactOptions } from "../extensibility/extensions/types";
+import type { Skill } from "../extensibility/skills";
 import type { MCPManager } from "../mcp";
 import type { PlanApprovalDetails } from "../plan-mode/approved-plan";
 import type { AgentSession } from "../session/agent-session";
@@ -112,7 +113,6 @@ export interface InteractiveModeContext {
     historyStorage?: HistoryStorage;
     mcpManager?: MCPManager;
     lspServers?: LspStartupServerInfo[];
-    titleSystemPrompt?: string;
     collabHost?: CollabHost;
     collabGuest?: CollabGuestLink;
     eventController: EventController;
@@ -186,7 +186,7 @@ export interface InteractiveModeContext {
     lastStatusSpacer: Spacer | undefined;
     lastStatusText: Text | undefined;
     fileSlashCommands: Set<string>;
-    skillCommands: Map<string, string>;
+    skillCommands: Map<string, Skill>;
     oauthManualInput: OAuthManualInputManager;
     todoPhases: TodoPhase[];
     init(options?: InteractiveModeInitOptions): Promise<void>;
@@ -278,7 +278,6 @@ export interface InteractiveModeContext {
     getUserMessageText(message: Message): string;
     findLastAssistantMessage(): AssistantMessage | undefined;
     extractAssistantText(message: AssistantMessage): string;
-    updateEditorTopBorder(): void;
     /** Refresh the running-subagents status badge from the active local or collab registry. */
     syncRunningSubagentBadge(): void;
     updateEditorBorderColor(): void;

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

@@ -60,6 +60,8 @@ export interface CopySource {
 export declare function extractBlocks(text: string): MessageBlock[];
 /** Extract fenced code blocks from assistant markdown, in document order. */
 export declare function extractCodeBlocks(text: string): CodeBlock[];
+/** Walk the transcript backwards for the most recent fenced assistant code block. */
+export declare function extractLastCodeBlock(messages: readonly AgentMessage[]): CodeBlock | undefined;
 /** 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. */

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

@@ -0,0 +1 @@
+export {};

package/dist/types/sdk.d.ts

@@ -54,6 +54,15 @@ export interface CreateAgentSessionOptions {
     customSystemPrompt?: string;
     /** Already-loaded text appended through the bundled system prompt templates. */
     appendSystemPrompt?: string;
+    /**
+     * Already-loaded title-generation system prompt override (typically
+     * {@link discoverTitleSystemPromptFile} → {@link resolvePromptInput}). When
+     * set, every automatic session-title generation path on this session — the
+     * first-input title and the replan-driven refresh — uses this prompt
+     * instead of the bundled default. Refresh on cwd change via
+     * {@link AgentSession.setTitleSystemPrompt}.
+     */
+    titleSystemPrompt?: string;
     /** Optional provider-facing session identifier for prompt caches and sticky auth selection.
      * Keeps persisted session files isolated while reusing provider-side caches. */
     providerSessionId?: string;

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

@@ -17,6 +17,7 @@ import { Agent, type AgentEvent, type AgentMessage, type AgentState, type AgentT
 import { type CompactionResult, type ShakeConfig } from "@oh-my-pi/pi-agent-core/compaction";
 import type { AssistantMessage, Context, ImageContent, Message, MessageAttribution, Model, ProviderSessionState, ResetCreditAccountStatus, ResetCreditRedeemOutcome, ResetCreditTarget, ServiceTier, ServiceTierByFamily, ServiceTierFamily, SimpleStreamOptions, TextContent, ToolChoice, UsageReport } from "@oh-my-pi/pi-ai";
 import { Effort } from "@oh-my-pi/pi-ai";
+import { postmortem } from "@oh-my-pi/pi-utils";
 import { type AdvisorConfig } from "../advisor";
 import { type AsyncJob, type AsyncJobDeliveryState, AsyncJobManager } from "../async";
 import type { Rule } from "../capability/rule";
@@ -43,7 +44,7 @@ import type { PlanModeState } from "../plan-mode/state";
 import { type SecretObfuscator } from "../secrets/obfuscator";
 import { type ConfiguredThinkingLevel } from "../thinking";
 import { type DiscoverableTool, type DiscoverableToolSearchIndex } from "../tool-discovery/tool-index";
-import type { CheckpointState } from "../tools/checkpoint";
+import type { CheckpointState, CompletedRewindState } from "../tools/checkpoint";
 import { type TodoItem, type TodoPhase } from "../tools/todo";
 import type { ClientBridge } from "./client-bridge";
 import { type CustomMessage } from "./messages";
@@ -120,6 +121,25 @@ export type AgentSessionEvent = AgentEvent | {
 };
 /** Listener function for agent session events */
 export type AgentSessionEventListener = (event: AgentSessionEvent) => void;
+/**
+ * Budget for callers on the user-visible `/quit` / `/exit` shutdown path that
+ * want to cap how long they wait for `MnemopiSessionState.dispose()` to finish
+ * its consolidate pass. Consolidate fires fresh LLM fact extractions, each a
+ * 1–3 s round-trip, so interactive shutdown passes this budget to keep the
+ * UI responsive. Callers that keep the process/session host alive must omit it
+ * so dispose still awaits the full consolidate-then-close pipeline.
+ */
+export declare const SHUTDOWN_CONSOLIDATE_BUDGET_MS = 1500;
+export interface AgentSessionDisposeOptions {
+    mnemopiConsolidateTimeoutMs?: number;
+    /**
+     * Postmortem reason that triggered this dispose (signal/fatal teardown
+     * paths). When set, the persisted `session_exit` diagnostic records it
+     * instead of the generic `"dispose"` used for normal programmatic disposal
+     * (`/quit`, test teardown, subagent completion).
+     */
+    reason?: postmortem.Reason;
+}
 export type CommandMetadataChangedListener = () => void | Promise<void>;
 export type AsyncJobSnapshotItem = Pick<AsyncJob, "id" | "type" | "status" | "label" | "startTime">;
 export interface AsyncJobSnapshot {
@@ -295,6 +315,14 @@ export interface AgentSessionConfig {
      * teardown never tears down the shared servers.
      */
     disconnectOwnedMcpManager?: () => Promise<void>;
+    /**
+     * Override the bundled system prompt used by automatic session-title
+     * generation paths (initial title + replan refresh). Source-of-truth is
+     * `TITLE_SYSTEM.md` discovered via {@link discoverTitleSystemPromptFile} and
+     * resolved through {@link resolvePromptInput}; refresh after a `/move`-style
+     * cwd change via {@link AgentSession.setTitleSystemPrompt}.
+     */
+    titleSystemPrompt?: string;
 }
 /** Options for AgentSession.prompt() */
 export interface PromptOptions {
@@ -346,7 +374,7 @@ export interface RoleModelCycleResult {
 export interface ResolvedRoleModel {
     role: string;
     model: Model;
-    thinkingLevel?: ThinkingLevel;
+    thinkingLevel?: ConfiguredThinkingLevel;
     explicitThinkingLevel: boolean;
 }
 /** The set of resolvable role models plus the index of the currently active
@@ -530,11 +558,7 @@ export declare class AgentSession {
      * 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.
-     */
-    dispose(): Promise<void>;
+    dispose(options?: AgentSessionDisposeOptions): Promise<void>;
     freshSession(): FreshSessionResult | undefined;
     /** Full agent state */
     get state(): AgentState;
@@ -692,6 +716,7 @@ export declare class AgentSession {
     get clientBridge(): ClientBridge | undefined;
     setClientBridge(bridge: ClientBridge | undefined): void;
     getCheckpointState(): CheckpointState | undefined;
+    getLastCompletedRewind(): CompletedRewindState | undefined;
     setCheckpointState(state: CheckpointState | undefined): void;
     /**
      * Inject the plan mode context message into the conversation history.
@@ -812,6 +837,15 @@ export declare class AgentSession {
     get skillWarnings(): readonly SkillWarning[];
     getTodoPhases(): TodoPhase[];
     setTodoPhases(phases: TodoPhase[]): void;
+    /** Currently-applied {@link TITLE_SYSTEM.md} override, or undefined when the
+     *  bundled prompt is in effect. Consumed by {@link InteractiveMode} so the
+     *  first-input title path and the replan refresh share one source. */
+    get titleSystemPrompt(): string | undefined;
+    /** Replace the title-generation system prompt override. Called by
+     *  {@link InteractiveMode.refreshTitleSystemPrompt} after the session cwd
+     *  changes (e.g. `/move` relocation) so the next replan refresh resolves
+     *  against the destination project's override. */
+    setTitleSystemPrompt(prompt: string | undefined): void;
     /**
      * Abort current operation and wait for agent to become idle.
      *
@@ -1112,14 +1146,13 @@ export declare class AgentSession {
     /** Whether there are pending Python messages waiting to be flushed */
     get hasPendingPythonMessages(): boolean;
     /**
-     * Surfaces (and consumes) IRC incoming asides that have reached this running
-     * session but have not yet been folded into the next model step.
+     * Surfaces (and consumes) pending IRC incoming records before the next model
+     * step can inject them automatically.
      *
      * The inbox tool injects the formatted body into the tool result, so the
-     * model sees it once via the result. Leaving the record in
-     * {@link #pendingIrcAsides} would let the aside provider deliver it a second
-     * time at the next step boundary — including on `peek`, which is why peek
-     * also drains here.
+     * model sees it once via the result. Leaving the record in either pending
+     * IRC queue would deliver it a second time at the next step boundary —
+     * including on `peek`, which is why peek also drains here.
      */
     drainPendingIrcInboxMessages(agentId: string): IrcMessage[];
     /**

package/dist/types/session/exit-diagnostics.d.ts

@@ -0,0 +1,48 @@
+import type { SessionEntry } from "./session-entries";
+export declare const TOOL_EXECUTION_START_CUSTOM_TYPE = "tool_execution_start";
+export declare const SESSION_EXIT_CUSTOM_TYPE = "session_exit";
+/**
+ * Compact projection of tool-call arguments persisted with the start marker.
+ * The assistant message already carries the full arguments; this exists only
+ * so `appendArgumentSummary` can name the command/path in resume warnings
+ * without duplicating whole argument payloads into the session JSONL.
+ */
+export interface ToolArgumentSummary {
+    command?: string;
+    path?: string;
+}
+/** Persisted marker written before a tool implementation starts running. */
+export interface ToolExecutionStartData {
+    toolCallId: string;
+    toolName: string;
+    args?: ToolArgumentSummary;
+    intent?: string;
+    startedAt: string;
+}
+/** Tool call left without a matching toolResult at the end of a branch. */
+export interface PendingToolCallDiagnostic {
+    toolCallId?: string;
+    toolName: string;
+    args?: unknown;
+    intent?: string;
+    assistantTimestamp?: number;
+    startedAt?: string;
+}
+/** Session shutdown marker written during normal and fatal process teardown. */
+export interface SessionExitData {
+    reason: string;
+    kind: "normal" | "signal" | "fatal" | "process_exit";
+    recordedAt: string;
+    pendingToolCalls?: PendingToolCallDiagnostic[];
+}
+/**
+ * Project full tool-call arguments down to the fields the pending-tool-call
+ * resume warning actually renders (`command`/`path`), truncated. Returns
+ * `undefined` when the arguments carry neither, so callers can omit `args`
+ * entirely instead of persisting an empty object.
+ */
+export declare function summarizeToolArguments(args: unknown): ToolArgumentSummary | undefined;
+/** Finds tool calls left pending at the end of a session branch. */
+export declare function collectPendingToolCalls(entries: readonly SessionEntry[]): PendingToolCallDiagnostic[];
+/** Builds the resume warning shown when a prior branch ended mid-tool-call. */
+export declare function describePendingToolCalls(entries: readonly SessionEntry[]): string | undefined;

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

@@ -8,6 +8,11 @@ export declare function parseSessionContent(content: string): {
     entries: FileEntry[];
     titleSlot: SessionTitleUpdate | undefined;
 };
+/** Exported for testing — the ≥8MiB streaming path (works on any file size). */
+export declare function loadEntriesFromFileStream(filePath: string): Promise<{
+    entries: FileEntry[];
+    titleSlot: SessionTitleUpdate | undefined;
+}>;
 /** Read only the fixed-size head window to detect a physical title slot. */
 export declare function readTitleSlotFromFile(filePath: string, storage?: SessionStorage): Promise<SessionTitleSlotEntry | undefined>;
 /** Exported for compaction.test.ts */

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

@@ -27,13 +27,15 @@ import { type AgentDefinition, type AgentProgress, type ReviewFinding, type Sing
 export type { YieldItem } from "./types";
 /**
  * Soft per-agent request budgets (assistant requests per run). When a subagent
- * crosses its budget it receives ONE steering notice asking it to wrap up; at
- * 1.5x the budget the run is aborted gracefully so partial output is salvaged.
- * The `default` key applies to agents without an explicit entry and can be
- * overridden via the `task.softRequestBudget` setting (0 disables the guard).
+ * crosses its budget it can receive an optional steering notice asking it to
+ * wrap up; at 1.5x the budget the run is aborted gracefully so partial output is
+ * salvaged. The `default` key applies to agents without an explicit entry and
+ * can be overridden via the `task.softRequestBudget` setting (0 disables the
+ * guard). The notice is off by default and controlled separately by
+ * `task.softRequestBudgetNotice`.
  */
 export declare const SOFT_REQUEST_BUDGET: Record<string, number>;
-/** Steering notice injected once when a subagent crosses its soft request budget. */
+/** Optional steering notice injected when a subagent crosses its soft request budget. */
 export declare function buildBudgetNotice(requests: number): string;
 /** Options for subagent execution */
 export interface ExecutorOptions {
@@ -74,6 +76,11 @@ export interface ExecutorOptions {
     parentActiveModelPattern?: string;
     thinkingLevel?: ThinkingLevel;
     outputSchema?: unknown;
+    /**
+     * Caller supplied a schema that supersedes the agent's native output prompt.
+     * Eval `agent(..., schema=...)` sets this so built-in agents ignore stale yield labels.
+     */
+    outputSchemaOverridesAgent?: boolean;
     /** Parent task recursion depth (0 = top-level, 1 = first child, etc.) */
     taskDepth?: number;
     /**

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

@@ -30,6 +30,7 @@ export declare function mapWithConcurrencyLimit<T, R>(items: T[], concurrency: n
  * immediately — matching `task.maxConcurrency = 0`'s "Unlimited" semantics in the
  * settings UI ([#3305](https://github.com/can1357/oh-my-pi/issues/3305)).
  */
+export declare function normalizeConcurrencyLimit(max: number): number;
 export declare class Semaphore {
     #private;
     constructor(max: number);