@oh-my-pi/pi-coding-agent 15.8.3 → 15.9.1

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

@@ -15,7 +15,7 @@ import type { ExecOptions, ExecResult } from "../../exec/exec";
 import type { HookUIContext } from "../../extensibility/hooks/types";
 import type { Theme } from "../../modes/theme/theme";
 import type { ReadonlySessionManager } from "../../session/session-manager";
-import type { TodoItem } from "../../tools/todo-write";
+import type { TodoItem } from "../../tools/todo";
 /** Alias for clarity */
 export type CustomToolUIContext = HookUIContext;
 export type { ExecOptions, ExecResult } from "../../exec/exec";

package/dist/types/extensibility/extensions/types.d.ts

@@ -59,6 +59,17 @@ export interface ExtensionUIDialogOptions {
     onExternalEditor?: () => void;
     /** Optional footer hint text rendered by interactive selector */
     helpText?: string;
+    /** Render a leading radio/checkbox marker before each markable option in
+     *  select dialogs (matches the ask transcript). "radio" fills the cursor row
+     *  for single-choice; "checkbox" reflects `checkedIndices` per row for
+     *  multi-select. Options beyond `markableCount` keep the plain cursor. */
+    selectionMarker?: "radio" | "checkbox";
+    /** For `selectionMarker: "checkbox"`: option indices currently checked. */
+    checkedIndices?: readonly number[];
+    /** Number of leading options that receive a selection marker; the remaining
+     *  trailing options (e.g. "Other"/"Done" actions) keep the plain cursor.
+     *  Defaults to all options when `selectionMarker` is set. */
+    markableCount?: number;
 }
 /** Raw terminal input listener for extensions. */
 export type TerminalInputHandler = (data: string) => {

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

@@ -18,7 +18,7 @@ import type { ImageContent, TextContent, ToolResultMessage } from "@oh-my-pi/pi-
 import type { Rule } from "../capability/rule";
 import type { Goal, GoalModeState } from "../goals/state";
 import type { BranchSummaryEntry, CompactionEntry, SessionEntry } from "../session/session-manager";
-import type { TodoItem } from "../tools/todo-write";
+import type { TodoItem } from "../tools/todo";
 /** Fired on initial session load */
 export interface SessionStartEvent {
     type: "session_start";

package/dist/types/index.d.ts

@@ -22,6 +22,7 @@ export * from "./modes/theme/theme";
 export * from "./sdk";
 export * from "./session/agent-session";
 export * from "./session/auth-storage";
+export * from "./session/indexed-session-storage";
 export * from "./session/messages";
 export * from "./session/redis-session-storage";
 export * from "./session/session-dump-format";

package/dist/types/mcp/json-rpc.d.ts

@@ -11,12 +11,17 @@ export interface JsonRpcResponse<T = unknown> {
         data?: unknown;
     };
 }
+/** Options controlling a single MCP JSON-RPC HTTP request. */
+export interface CallMcpOptions {
+    signal?: AbortSignal;
+}
 /**
  * Call an MCP server with JSON-RPC 2.0 over HTTPS.
  *
  * @param url - Full MCP server URL (including any query parameters)
  * @param method - JSON-RPC method name (e.g., "tools/list", "tools/call")
  * @param params - Method parameters
+ * @param options - Optional transport controls such as cancellation.
  * @returns Parsed JSON-RPC response
  */
-export declare function callMCP<T = unknown>(url: string, method: string, params?: Record<string, unknown>): Promise<JsonRpcResponse<T>>;
+export declare function callMCP<T = unknown>(url: string, method: string, params?: Record<string, unknown>, options?: CallMcpOptions): Promise<JsonRpcResponse<T>>;

package/dist/types/mcp/tool-bridge.d.ts

@@ -53,6 +53,8 @@ export declare class MCPTool implements CustomTool<TSchema, MCPToolDetails> {
     readonly mcpToolName: string;
     /** Server name */
     readonly mcpServerName: string;
+    /** Render completed MCP calls with the result header replacing the pending call header. */
+    readonly mergeCallAndResult = true;
     /** Create MCPTool instances for all tools from an MCP server connection */
     static fromTools(connection: MCPServerConnection, tools: MCPToolDefinition[], reconnect?: MCPReconnect): MCPTool[];
     constructor(connection: MCPServerConnection, tool: MCPToolDefinition, reconnect?: MCPReconnect | undefined);
@@ -77,6 +79,8 @@ export declare class DeferredMCPTool implements CustomTool<TSchema, MCPToolDetai
     readonly mcpToolName: string;
     /** Server name */
     readonly mcpServerName: string;
+    /** Render completed MCP calls with the result header replacing the pending call header. */
+    readonly mergeCallAndResult = true;
     /** Create DeferredMCPTool instances for all tools from an MCP server */
     static fromTools(serverName: string, tools: MCPToolDefinition[], getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect): DeferredMCPTool[];
     constructor(serverName: string, tool: MCPToolDefinition, getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect | undefined);

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

@@ -12,15 +12,24 @@ interface FrameSink {
 }
 /**
  * Write a newline-delimited JSON-RPC frame to the subprocess's stdin sink,
- * swallowing synchronous errors so the caller can decide how to react.
+ * swallowing both synchronous throws and asynchronous rejections so the caller
+ * can decide how to react.
  *
- * Bun's `FileSink` may throw synchronously (most reliably on Windows) when
- * the read end of the pipe has been closed by a subprocess that exited
- * between read-loop ticks. Letting that throw escape an `async` method
- * surfaces as an unhandled promise rejection at the call site.
+ * Bun's `FileSink.write()`/`flush()` can fail two ways once the read end of the
+ * pipe has been closed by a subprocess that exited between read-loop ticks:
+ *   - a synchronous throw (most reliably observed on Windows), and
+ *   - a *rejected Promise* returned from `write()`/`flush()`, i.e. the EPIPE is
+ *     surfaced asynchronously (note the `processTicksAndRejections` frame in the
+ *     stack traces on #1710 and the follow-up report).
  *
- * Returns `true` when the frame was accepted by the sink, `false` when the
- * sink threw — callers signal transport closure on `false`.
+ * A sibling `async` method's `try/catch` only catches the synchronous case; an
+ * un-awaited rejected Promise escapes as a fatal unhandled rejection. So we both
+ * catch the throw and neutralize any returned promise's rejection.
+ *
+ * Returns `true` when the frame was accepted synchronously, `false` when the
+ * sink threw — callers signal transport closure on `false`. An asynchronous
+ * failure cannot be reflected in the return value; it is neutralized here and
+ * the dead transport is detected by the read loop / request timeout instead.
  */
 export declare function writeFrame(stdin: FrameSink, frame: string): boolean;
 /**

package/dist/types/mnemopi/state.d.ts

@@ -48,8 +48,8 @@ export declare class MnemopiSessionState {
     getScopedRetainTarget(): MnemopiScopedMemory;
     editScopedMemory(op: MnemopiMemoryEditOperation, id: string, options?: MnemopiMemoryEditOptions): MnemopiMemoryEditResult;
     formatScopedRecallWithIds(results: readonly RecallResult[]): string;
-    collectScopedRecallResults(query: string): RecallResult[];
-    recallResultsScoped(query: string): RecallResult[];
+    collectScopedRecallResults(query: string): Promise<RecallResult[]>;
+    recallResultsScoped(query: string): Promise<RecallResult[]>;
     formatScopedRecallContext(results: readonly RecallResult[], format?: "bullet" | "json"): string | undefined;
     formatContextScoped(results: readonly RecallResult[], format?: "bullet" | "json"): string;
     rememberInScope(memory: MnemopiRememberInput, options?: MnemopiRememberOptions): string | undefined;

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

@@ -16,6 +16,7 @@ export declare class AgentDashboard extends Container {
     onRequestRender?: () => void;
     private constructor();
     static create(cwd: string, settings?: Settings | null, terminalHeight?: number, modelContext?: AgentDashboardModelContext): Promise<AgentDashboard>;
+    render(width: number): string[];
     handleInput(data: string): void;
 }
 export {};

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

@@ -1,5 +1,5 @@
 import type { AssistantMessage, ImageContent, Usage } from "@oh-my-pi/pi-ai";
-import { Container } from "@oh-my-pi/pi-tui";
+import { Container, type ImageBudget } from "@oh-my-pi/pi-tui";
 import type { AssistantThinkingRenderer } from "../../extensibility/extensions/types";
 /**
  * Component that renders a complete assistant message
@@ -9,7 +9,8 @@ export declare class AssistantMessageComponent extends Container {
     private hideThinkingBlock;
     private readonly onImageUpdate?;
     private readonly thinkingRenderers;
-    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined, thinkingRenderers?: readonly AssistantThinkingRenderer[]);
+    private readonly imageBudget?;
+    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined, thinkingRenderers?: readonly AssistantThinkingRenderer[], imageBudget?: ImageBudget | undefined);
     invalidate(): void;
     setHideThinkingBlock(hide: boolean): void;
     setToolResultImages(toolCallId: string, images: ImageContent[]): void;

package/dist/types/modes/components/extensions/extension-dashboard.d.ts

@@ -22,5 +22,6 @@ export declare class ExtensionDashboard extends Container {
     onRequestRender?: () => void;
     private constructor();
     static create(cwd: string, settings?: Settings | null, terminalHeight?: number): Promise<ExtensionDashboard>;
+    render(width: number): string[];
     handleInput(data: string): void;
 }

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

@@ -44,6 +44,17 @@ export interface HookSelectorOptions {
     /** Indices into the original options that cannot be selected: they render
      *  dimmed, are skipped during navigation, and reject enter/timeout. */
     disabledIndices?: readonly number[];
+    /** Render a leading radio/checkbox marker before each markable option,
+     *  matching the ask transcript. "radio" fills the marker on the cursor row
+     *  (single-choice); "checkbox" reflects {@link checkedIndices} per row
+     *  (multi-select). Options at or beyond {@link markableCount} keep the plain
+     *  cursor prefix — used for trailing control rows like "Other"/"Done". */
+    selectionMarker?: "radio" | "checkbox";
+    /** For `selectionMarker: "checkbox"`: original-indices currently checked. */
+    checkedIndices?: readonly number[];
+    /** Number of leading options (original order) that receive a selection
+     *  marker. Defaults to every option when {@link selectionMarker} is set. */
+    markableCount?: number;
 }
 export interface HookSelectorOption {
     label: string;

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

@@ -2,13 +2,15 @@
  * Plugin settings UI components.
  *
  * Provides a hierarchical settings interface:
- * - Plugin list (shows all installed plugins)
- *   - Plugin detail (enable/disable, features, config)
+ * - Plugin list (npm plugins + marketplace plugins)
+ *   - npm plugin detail (enable/disable, features, config)
+ *   - Marketplace plugin detail (enable/disable + read-only metadata)
  *     - Feature toggles
  *     - Config value editor
  */
 import { Container } from "@oh-my-pi/pi-tui";
 import { PluginManager } from "../../extensibility/plugins/manager";
+import type { InstalledPluginSummary } from "../../extensibility/plugins/marketplace";
 import type { InstalledPlugin } from "../../extensibility/plugins/types";
 /**
  * Forwards a keystroke to `input`, but cancels via `onCancel` when the user presses Escape.
@@ -16,18 +18,32 @@ import type { InstalledPlugin } from "../../extensibility/plugins/types";
 export declare function handleInputOrEscape(data: string, input: {
     handleInput(data: string): void;
 }, onCancel: () => void): void;
+/**
+ * One row in the unified plugin list. npm and marketplace plugins live in
+ * separate registries with different shapes, so a tagged union keeps both
+ * paths type-safe end-to-end (list rendering, value lookup, detail callback).
+ */
+export type PluginListEntry = {
+    kind: "npm";
+    plugin: InstalledPlugin;
+} | {
+    kind: "marketplace";
+    plugin: InstalledPluginSummary;
+};
 export interface PluginListCallbacks {
-    onPluginSelect: (plugin: InstalledPlugin) => void;
+    onNpmSelect: (plugin: InstalledPlugin) => void;
+    onMarketplaceSelect: (plugin: InstalledPluginSummary) => void;
     onCancel: () => void;
 }
 /**
- * Shows list of installed plugins with enable/disable status.
- * Selecting a plugin opens its detail view.
+ * Shows installed plugins from both registries (npm + marketplace) with
+ * enable/disable status, scope tag, and shadow indicator. Selecting an entry
+ * fans out to the kind-specific detail callback.
  */
 export declare class PluginListComponent extends Container {
     #private;
-    private readonly plugins;
-    constructor(plugins: InstalledPlugin[], callbacks: PluginListCallbacks);
+    private readonly entries;
+    constructor(entries: ReadonlyArray<PluginListEntry>, callbacks: PluginListCallbacks);
     handleInput(data: string): void;
 }
 export interface PluginDetailCallbacks {
@@ -50,9 +66,25 @@ export declare class PluginDetailComponent extends Container {
     constructor(plugin: InstalledPlugin, manager: PluginManager, callbacks: PluginDetailCallbacks);
     handleInput(data: string): void;
 }
+export interface MarketplacePluginDetailCallbacks {
+    onEnabledChange: (enabled: boolean) => void;
+    onBack: () => void;
+}
+/**
+ * Detail view for a marketplace plugin. Marketplace plugins do not declare
+ * features or settings, so the panel exposes a single enable/disable toggle
+ * plus the read-only metadata from the installed-plugins registry.
+ */
+export declare class MarketplacePluginDetailComponent extends Container {
+    #private;
+    private plugin;
+    private readonly callbacks;
+    constructor(plugin: InstalledPluginSummary, callbacks: MarketplacePluginDetailCallbacks);
+    handleInput(data: string): void;
+}
 export interface PluginSettingsCallbacks {
     onClose: () => void;
-    onPluginChanged: () => void;
+    onPluginChanged: () => void | Promise<void>;
 }
 /**
  * Top-level plugin settings component.

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

@@ -8,10 +8,10 @@ export type SessionHistoryMatcher = (query: string) => string[];
  *
  * - `fuzzy` is the ordered fuzzy-filter result over session metadata (best first).
  * - `historyIds` are session IDs whose recorded prompts matched the query,
- *   ordered by history relevance (best first); duplicates are tolerated.
+ *   ordered by prompt-history rank (typically newest matching prompt first); duplicates are tolerated.
  *
  * Ranking: sessions matched by **both** signals lead (keeping fuzzy order), then
- * fuzzy-only matches, then history-only matches (by history order). A fuzzy match
+ * fuzzy-only matches, then history-only matches (by prompt-history order). A fuzzy match
  * is never dropped, and history matches not present in `allSessions` (e.g. deleted
  * or out-of-scope sessions) are ignored since they cannot be resumed from here.
  */
@@ -26,7 +26,7 @@ declare class SessionList implements Component {
     onExit: () => void;
     onToggleScope?: () => void;
     onDeleteRequest?: (session: SessionInfo) => void;
-    constructor(sessions: SessionInfo[], showCwd?: boolean, historyMatcher?: SessionHistoryMatcher);
+    constructor(sessions: SessionInfo[], showCwd?: boolean, historyMatcher?: SessionHistoryMatcher, getTerminalRows?: () => number);
     /** Replace the visible dataset, e.g. when toggling folder/all-projects scope. */
     setSessions(sessions: SessionInfo[], showCwd: boolean): void;
     removeSession(sessionPath: string): void;
@@ -43,6 +43,11 @@ export interface SessionSelectorOptions {
     allSessions?: SessionInfo[];
     /** Open directly in all-projects scope (e.g. the current folder has no sessions). */
     startInAllScope?: boolean;
+    /**
+     * Reads the live terminal height so the visible window fits the viewport.
+     * Omitted only in tests; defaults to a conservative 24 rows.
+     */
+    getTerminalRows?: () => number;
 }
 /**
  * Component that renders a session selector with optional confirmation dialog

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

@@ -36,7 +36,7 @@ export interface SettingsCallbacks {
     /** Get current rendered status line for inline preview */
     getStatusLinePreview?: () => string;
     /** Called when plugins change */
-    onPluginsChanged?: () => void;
+    onPluginsChanged?: () => void | Promise<void>;
     /** Called when settings panel is closed */
     onCancel: () => void;
 }

package/dist/types/modes/components/todo-reminder.d.ts

@@ -1,5 +1,5 @@
 import { Container } from "@oh-my-pi/pi-tui";
-import type { TodoItem } from "../../tools/todo-write";
+import type { TodoItem } from "../../tools/todo";
 /**
  * Component that renders a todo completion reminder notification.
  * Shows when the agent stops with incomplete todos.

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

@@ -0,0 +1,36 @@
+import { Container } from "@oh-my-pi/pi-tui";
+/**
+ * Transcript container that freezes the rendered output of every block except
+ * the bottom-most (live) one on terminals where committed native scrollback is
+ * immutable.
+ *
+ * On ED3-risk terminals with an unobservable viewport (ghostty/kitty/iTerm2/…)
+ * the renderer cannot clear saved lines (`\x1b[3J` may yank a reader) or query
+ * whether the user has scrolled, so any block that re-lays-out *after* it has
+ * scrolled past the viewport leaves a stale duplicate above the live region
+ * (a finalized assistant message re-wrapping, a tool preview collapsing to its
+ * compact result, a late async tool completion). The renderer's only safe move
+ * for such an offscreen edit is to not repaint — which is correct only if the
+ * committed region never changes underneath it.
+ *
+ * This container provides that guarantee: a block's render is snapshotted while
+ * it is the live (bottom-most) block, and once a newer block is appended it
+ * replays the snapshot instead of recomputing. Mutations after a block leaves
+ * live are intentionally deferred until the next checkpoint {@link thaw} (prompt
+ * submit → native-scrollback rebuild), where the whole transcript is replayed
+ * and any drift reconciles safely. On terminals that can rebuild history this
+ * freezing is unnecessary, so it renders every block live for full fidelity.
+ */
+export declare class TranscriptContainer extends Container {
+    #private;
+    invalidate(): void;
+    clear(): void;
+    /**
+     * Retire all frozen snapshots so the next render reflects each block's current
+     * state. Call at reconciliation checkpoints (prompt submit) where the whole
+     * transcript is replayed into native scrollback and any drift a frozen block
+     * accumulated is reconciled.
+     */
+    thaw(): void;
+    render(width: number): string[];
+}

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

@@ -23,6 +23,7 @@ import type { HookInputComponent } from "./components/hook-input";
 import type { HookSelectorComponent, HookSelectorSlider } from "./components/hook-selector";
 import { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
+import { TranscriptContainer } from "./components/transcript-container";
 import { type LoopLimitRuntime } from "./loop-limit";
 import { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
@@ -49,7 +50,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     agent: Agent;
     historyStorage?: HistoryStorage;
     ui: TUI;
-    chatContainer: Container;
+    chatContainer: TranscriptContainer;
     pendingMessagesContainer: Container;
     statusContainer: Container;
     todoContainer: Container;

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

@@ -10,7 +10,7 @@ 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 { TodoPhase } from "../../tools/todo-write";
+import type { TodoPhase } from "../../tools/todo";
 export type RpcCommand = {
     id?: string;
     type: "prompt";

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" | "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.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 */
@@ -17,7 +17,22 @@ export declare class Theme {
     #private;
     private readonly mode;
     private readonly symbolPreset;
+    /**
+     * Perceptual luma (0..1) of the status-line background — used to classify the
+     * theme light/dark. Undefined when it can't be resolved. Classified against the
+     * status line (the surface session accents render on) rather than the chat bubble
+     * (`userMessageBg`), which some themes (e.g. `porcelain`) style dark on an
+     * otherwise-light theme.
+     */
+    readonly statusLineLuminance: number | undefined;
     constructor(fgColors: Record<ThemeColor, string | number>, bgColors: Record<ThemeBg, string | number>, mode: ColorMode, symbolPreset: SymbolPreset, symbolOverrides: Partial<Record<SymbolKey, string>>, spinnerFramesOverrides?: Partial<Record<SpinnerType, string[]>>);
+    /** True when the active theme has a light status-line background. */
+    get isLight(): boolean;
+    /**
+     * Surface luminance to size session accents against on light themes; undefined on
+     * dark themes so accents stay vivid. Pass straight to `getSessionAccentHex`.
+     */
+    get accentSurfaceLuminance(): number | undefined;
     fg(color: ThemeColor, text: string): string;
     bg(color: ThemeBg, text: string): string;
     bold(text: string): string;
@@ -167,6 +182,10 @@ export declare class Theme {
         checked: string;
         unchecked: string;
     };
+    get radio(): {
+        selected: string;
+        unselected: string;
+    };
     get format(): {
         bullet: string;
         dash: string;

package/dist/types/modes/utils/keybinding-matchers.d.ts

@@ -12,4 +12,8 @@ export declare function matchesSelectCancel(data: string): boolean;
 export declare function matchesSelectUp(data: string): boolean;
 /** Match the generic selector down-navigation keybinding. */
 export declare function matchesSelectDown(data: string): boolean;
+/** Match the generic selector page-up keybinding. */
+export declare function matchesSelectPageUp(data: string): boolean;
+/** Match the generic selector page-down keybinding. */
+export declare function matchesSelectPageDown(data: string): boolean;
 export declare function matchesAppExternalEditor(data: string): boolean;

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

@@ -0,0 +1,20 @@
+import { type LocalProtocolOptions } from "../internal-urls";
+/** The session's active plan, resolved for handoff into a subagent's context. */
+export interface OverallPlanReference {
+    /** The `local://` reference path (e.g. `local://my-feature.md`), kept for display. */
+    path: string;
+    /** The full plan markdown, as written to disk. */
+    content: string;
+}
+/**
+ * Load the session's active overall plan for subagent handoff.
+ *
+ * Returns the plan referenced by `planReferencePath` when it exists on disk with
+ * non-empty content, or `undefined` when there is no plan (the file is absent or
+ * empty). This mirrors `AgentSession.#buildPlanReferenceMessage`'s gating so a
+ * subagent sees exactly the plan the main agent treats as its active reference.
+ *
+ * Callers MUST skip this during plan mode itself — read-only plan exploration
+ * uses a different prompt and a draft plan should not be handed off as approved.
+ */
+export declare function loadOverallPlanReference(planReferencePath: string, localProtocolOptions: LocalProtocolOptions): Promise<OverallPlanReference | undefined>;

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

@@ -43,7 +43,7 @@ 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 TodoItem, type TodoPhase } from "../tools/todo-write";
+import { type TodoItem, type TodoPhase } from "../tools/todo";
 import type { ClientBridge } from "./client-bridge";
 import { type CustomMessage } from "./messages";
 import type { BranchSummaryEntry, NewSessionOptions, SessionContext, SessionManager } from "./session-manager";
@@ -313,6 +313,7 @@ export declare class AgentSession {
     peekQueueInvoker(): ((input: unknown) => Promise<unknown> | unknown) | undefined;
     peekStandingResolveHandler(): ((input: unknown) => Promise<unknown> | unknown) | undefined;
     setStandingResolveHandler(handler: ((input: unknown) => Promise<unknown> | unknown) | null): void;
+    setSessionSwitchReconciler(reconciler: (() => Promise<void>) | null): void;
     /** Provider-scoped mutable state store for transport/session caches. */
     get providerSessionState(): Map<string, ProviderSessionState>;
     getHindsightSessionState(): HindsightSessionState | undefined;
@@ -637,7 +638,9 @@ export declare class AgentSession {
      * Validates API key, saves to session log but NOT to settings.
      * @throws Error if no API key available for the model
      */
-    setModelTemporary(model: Model, thinkingLevel?: ThinkingLevel): Promise<void>;
+    setModelTemporary(model: Model, thinkingLevel?: ThinkingLevel, options?: {
+        ephemeral?: boolean;
+    }): Promise<void>;
     /**
      * Cycle to next/previous model.
      * Uses scoped models (from --models flag) if available, otherwise all available models.

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

@@ -22,10 +22,9 @@ export declare class HistoryStorage {
     getRecent(limit: number): HistoryEntry[];
     search(query: string, limit: number): HistoryEntry[];
     /**
-     * IDs of the sessions whose stored prompts match `query`, ordered by match
-     * relevance (most relevant/recent first) and de-duplicated. Prompts with no
-     * recorded session are skipped. Used to augment session ranking in the
-     * resume picker with prompts that the 4KB session-list prefix never sees.
+     * IDs of the sessions whose stored prompts match `query`, ordered by prompt
+     * recency and de-duplicated. Used to augment session ranking in the resume
+     * picker with prompts that the 4KB session-list prefix never sees.
      */
     matchingSessionIds(query: string, limit?: number): string[];
 }

package/dist/types/session/indexed-session-storage.d.ts

@@ -0,0 +1,59 @@
+import type { SessionStorage, SessionStorageStat, SessionStorageWriter } from "./session-storage";
+export interface SessionStorageIndexEntry {
+    path: string;
+    size: number;
+    mtimeMs: number;
+}
+export interface SessionStorageBackend {
+    init(): Promise<void>;
+    loadIndex(): Promise<Iterable<SessionStorageIndexEntry>>;
+    readFull(path: string): Promise<string | null>;
+    readSlices(path: string, prefixBytes: number, suffixBytes: number): Promise<[string, string]>;
+    writeFull(path: string, content: string, mtimeMs: number): Promise<void>;
+    append(path: string, line: string, mtimeMs: number): Promise<void>;
+    truncate(path: string, mtimeMs: number): Promise<void>;
+    remove(paths: string[]): Promise<void>;
+    move(src: string, dst: string, mtimeMs: number): Promise<void>;
+}
+export declare class IndexedSessionStorage implements SessionStorage {
+    #private;
+    constructor(backend: SessionStorageBackend);
+    initialize(): Promise<void>;
+    refresh(): Promise<void>;
+    drain(): Promise<void>;
+    ensureDirSync(_dir: string): void;
+    existsSync(path: string): boolean;
+    writeTextSync(path: string, content: string): void;
+    statSync(path: string): SessionStorageStat;
+    listFilesSync(dir: string, pattern: string): string[];
+    exists(path: string): Promise<boolean>;
+    readText(path: string): Promise<string>;
+    readTextSlices(path: string, prefixBytes: number, suffixBytes: number): Promise<[string, string]>;
+    writeText(path: string, content: string): Promise<void>;
+    rename(src: string, dst: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+    deleteSessionWithArtifacts(sessionPath: string): Promise<void>;
+    openWriter(path: string, options?: {
+        flags?: "a" | "w";
+        onError?: (err: Error) => void;
+    }): SessionStorageWriter;
+    _writerClosed(writer: IndexedSessionStorageWriter): void;
+    _truncateForWriter(path: string): number;
+    _queueTruncate(path: string, mtimeMs: number, getError?: () => Error | undefined): Promise<void>;
+    _appendForWriter(path: string, line: string): number;
+    _queueAppend(path: string, line: string, mtimeMs: number, getError?: () => Error | undefined): Promise<void>;
+}
+declare class IndexedSessionStorageWriter implements SessionStorageWriter {
+    #private;
+    constructor(storage: IndexedSessionStorage, path: string, options?: {
+        flags?: "a" | "w";
+        onError?: (err: Error) => void;
+    });
+    writeLineSync(line: string): void;
+    writeLine(line: string): Promise<void>;
+    flush(): Promise<void>;
+    fsync(): Promise<void>;
+    close(): Promise<void>;
+    getError(): Error | undefined;
+}
+export {};

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

@@ -55,6 +55,7 @@ export declare const INTERNAL_DETAILS_FIELDS: readonly ["__pendingDisplayTag"];
  *  (null/non-object, or no listed fields present) so callers don't pay a
  *  clone cost on the common path. */
 export declare function stripInternalDetailsFields<T>(details: T | undefined): T | undefined;
+export declare function wrapSteeringForModel(messages: AgentMessage[]): AgentMessage[];
 /**
  * Strip image content blocks from `message` in place. Returns the count of
  * images removed across `content` (every role that carries `ImageContent`) and