@oh-my-pi/pi-coding-agent 16.3.2 → 16.3.3

package/dist/types/cli/update-cli.d.ts

@@ -19,6 +19,7 @@ export interface BinaryReplacementOptions {
 export declare function parseUpdateArgs(args: string[]): {
     force: boolean;
     check: boolean;
+    plugins: boolean;
 } | undefined;
 type UpdateMethod = "brew" | "mise" | "bun" | "binary";
 interface UpdateMethodResolutionOptions {

package/dist/types/cli/update-cli.test.d.ts

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

package/dist/types/commands/update.d.ts

@@ -15,6 +15,11 @@ export default class Update extends Command {
             description: string;
             default: boolean;
         };
+        plugins: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+            default: boolean;
+        };
     };
     run(): Promise<void>;
 }

package/dist/types/config/config-file.d.ts

@@ -1,4 +1,4 @@
-import type { Type } from "arktype";
+import { type Type } from "arktype";
 /** Minimal subset of the AJV ConfigSchemaError shape this module actually relies on. */
 interface ConfigSchemaError {
     instancePath: string;

package/dist/types/config/settings-schema.d.ts

@@ -4586,6 +4586,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Providers that web_search should never use, even as fallbacks";
         };
     };
+    readonly "providers.webSearchGeminiModel": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Gemini web_search model";
+            readonly description: "Model ID for Gemini Google Search grounding. Defaults to gemini-2.5-flash.";
+        };
+    };
     readonly "providers.antigravityEndpoint": {
         readonly type: "enum";
         readonly values: readonly ["auto", "production", "sandbox"];

package/dist/types/dap/client.d.ts

@@ -2,6 +2,14 @@ import type { DapCapabilities, DapClientState, DapEventMessage, DapInitializeArg
 interface DapSpawnOptions {
     adapter: DapResolvedAdapter;
     cwd: string;
+    /**
+     * Cap on how long the socket-mode helpers wait for the adapter to open its
+     * socket (unix) or dial back into our listener (TCP). Exposed for tests;
+     * production callers rely on the default.
+     *
+     * @internal
+     */
+    socketReadyTimeoutMs?: number;
 }
 /** Minimal write interface shared by Bun.FileSink and Bun TCP sockets. */
 interface DapWriteSink {
@@ -22,7 +30,7 @@ export declare class DapClient {
             end(): void;
         };
     });
-    static spawn({ adapter, cwd }: DapSpawnOptions): Promise<DapClient>;
+    static spawn({ adapter, cwd, socketReadyTimeoutMs }: DapSpawnOptions): Promise<DapClient>;
     get capabilities(): DapCapabilities | undefined;
     get lastActivity(): number;
     isAlive(): boolean;

package/dist/types/edit/file-snapshot-store.d.ts

@@ -59,6 +59,14 @@ export declare function recordSeenLines(session: FileSnapshotStoreOwner, absolut
  * can reject edits anchored on lines the model never saw. Best-effort: a no-op
  * when the body has no numbered rows or the snapshot already aged out. `tag`
  * must be the tag returned when this exact content was recorded.
+ *
+ * `excludedLines` prunes 1-indexed line numbers whose displayed text was
+ * column-truncated (or otherwise not shown in full). A column-clipped row
+ * still carries a `NN:` prefix — the parser sees the number and would
+ * otherwise mark the line "seen" even though only its prefix ever reached
+ * the model. Producers that apply per-line column truncation MUST supply
+ * the clipped line set so the patcher's seen-line guard keeps rejecting
+ * edits against those lines until a full-width read of them occurs.
  */
-export declare function recordSeenLinesFromBody(session: FileSnapshotStoreOwner, absolutePath: string, tag: string, body: string): void;
+export declare function recordSeenLinesFromBody(session: FileSnapshotStoreOwner, absolutePath: string, tag: string, body: string, excludedLines?: ReadonlySet<number>): void;
 export {};

package/dist/types/edit/hashline/execute.d.ts

@@ -1,6 +1,6 @@
 /**
  * Coding-agent runner that drives the hashline {@link Patcher} on behalf of
- * the `edit` tool. Converts a `{input}` tool-call payload into a
+ * the `edit` tool. Converts an `{input}` tool-call payload into a
  * fully-applied patch, wraps the result in the agent's
  * {@link AgentToolResult} shape, and attaches LSP diagnostics + `outputMeta`
  * for the renderer.

package/dist/types/edit/hashline/params.d.ts

@@ -1,7 +1,4 @@
-export declare const hashlineEditParamsSchema: import("arktype/internal/variants/object.ts").ObjectType<(In: {
-    input?: string | undefined;
-    _input?: string | undefined;
-}) => import("arktype/internal/attributes.ts").To<{
+export declare const hashlineEditParamsSchema: import("arktype/internal/variants/object.ts").ObjectType<{
     input: string;
-}>, {}>;
-export type HashlineParams = Parameters<typeof hashlineEditParamsSchema.assert>[0];
+}, {}>;
+export type HashlineParams = typeof hashlineEditParamsSchema.infer;

package/dist/types/edit/renderer.d.ts

@@ -67,6 +67,7 @@ interface EditRenderArgs {
     newText?: string;
     patch?: string;
     input?: string;
+    _input?: string;
     all?: boolean;
     op?: Operation;
     rename?: string;

package/dist/types/extensibility/plugins/parser.d.ts

@@ -41,12 +41,13 @@ export declare function parsePluginSpec(spec: string): ParsedPluginSpec;
  */
 export declare function formatPluginSpec(spec: ParsedPluginSpec): string;
 /**
- * Extract the base package name without version specifier.
+ * Extract the dependency key from an npm package specifier.
  * Used for path lookups after npm install.
  *
  * @example
  * extractPackageName("lodash@4.17.21") // "lodash"
  * extractPackageName("@scope/pkg@1.0.0") // "@scope/pkg"
  * extractPackageName("@scope/pkg") // "@scope/pkg"
+ * extractPackageName("npm:lodash") // "lodash"
  */
 export declare function extractPackageName(specifier: string): string;

package/dist/types/hindsight/client.d.ts

@@ -17,6 +17,10 @@ export interface HindsightApiOptions {
     apiKey?: string;
     userAgent?: string;
 }
+/** Caller cancellation shared by Hindsight request option bags. */
+export interface HindsightRequestOptions {
+    signal?: AbortSignal;
+}
 export interface RecallResult {
     id?: string;
     text: string;
@@ -61,7 +65,7 @@ export interface MemoryItemInput {
     strategy?: string;
     updateMode?: UpdateMode;
 }
-export interface RetainOptions {
+export interface RetainOptions extends HindsightRequestOptions {
     timestamp?: Date | string;
     context?: string;
     metadata?: Record<string, string>;
@@ -70,42 +74,42 @@ export interface RetainOptions {
     tags?: string[];
     updateMode?: UpdateMode;
 }
-export interface RetainBatchOptions {
+export interface RetainBatchOptions extends HindsightRequestOptions {
     /** Document id applied to every item that doesn't carry its own. */
     documentId?: string;
     /** Tags attached to the resulting document(s), not individual items. */
     documentTags?: string[];
     async?: boolean;
 }
-export interface RecallOptions {
+export interface RecallOptions extends HindsightRequestOptions {
     types?: string[];
     maxTokens?: number;
     budget?: Budget;
     tags?: string[];
     tagsMatch?: TagsMatch;
 }
-export interface ReflectOptions {
+export interface ReflectOptions extends HindsightRequestOptions {
     context?: string;
     budget?: Budget;
     tags?: string[];
     tagsMatch?: TagsMatch;
 }
-export interface CreateBankOptions {
+export interface CreateBankOptions extends HindsightRequestOptions {
     reflectMission?: string;
     retainMission?: string;
 }
-export interface ListMemoriesOptions {
+export interface ListMemoriesOptions extends HindsightRequestOptions {
     limit?: number;
     offset?: number;
     type?: string;
     q?: string;
     consolidationState?: ConsolidationState;
 }
-export interface ListDocumentsOptions {
+export interface ListDocumentsOptions extends HindsightRequestOptions {
     limit?: number;
     offset?: number;
 }
-export interface UpdateDocumentOptions {
+export interface UpdateDocumentOptions extends HindsightRequestOptions {
     tags?: string[];
 }
 export type MentalModelDetail = "metadata" | "content" | "full";
@@ -137,7 +141,7 @@ export interface MentalModelHistoryEntry {
     changed_at: string;
     [key: string]: unknown;
 }
-export interface CreateMentalModelOptions {
+export interface CreateMentalModelOptions extends HindsightRequestOptions {
     id?: string;
     tags?: string[];
     maxTokens?: number;
@@ -151,10 +155,10 @@ export interface RefreshMentalModelResponse {
     operation_id?: string;
     [key: string]: unknown;
 }
-export interface ListMentalModelsOptions {
+export interface ListMentalModelsOptions extends HindsightRequestOptions {
     detail?: MentalModelDetail;
 }
-export interface GetMentalModelOptions {
+export interface GetMentalModelOptions extends HindsightRequestOptions {
     detail?: MentalModelDetail;
 }
 export declare class HindsightError extends Error {

package/dist/types/hindsight/client.test.d.ts

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

package/dist/types/mcp/smithery-registry.d.ts

@@ -41,6 +41,7 @@ export interface SmitherySearchOptions {
     limit?: number;
     apiKey?: string;
     includeSemantic?: boolean;
+    signal?: AbortSignal;
 }
 export declare class SmitheryRegistryError extends Error {
     status: number;

package/dist/types/mcp/smithery-registry.test.d.ts

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

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

@@ -3,7 +3,9 @@ import type { AdvisorMessageDetails } from "../../advisor";
 import type { Theme } from "../theme/theme";
 /**
  * Display-only transcript card for advisor notes injected into the primary
- * session. Mirrors the IRC card's glyph + quote-border conventions so passive
- * advice reads as a distinct, non-interrupting aside rather than a user turn.
+ * session. Styled as a distinct voice so notes never blend into thinking
+ * output (whose `thinkingText` color equals `toolOutput` in most themes):
+ * a bold `customMessageLabel` header tag (skill-card convention), a heavy
+ * rail tinted per-note severity, and the note body on the default text color.
  */
 export declare function createAdvisorMessageCard(details: AdvisorMessageDetails | undefined, getExpanded: () => boolean, uiTheme: Theme): Component;

package/dist/types/modes/components/tool-execution.d.ts

@@ -33,12 +33,14 @@ export interface ToolExecutionHandle {
     setArgsComplete(toolCallId?: string): void;
     setExpanded(expanded: boolean): void;
 }
-/** Drive pending-tool redraws at 30fps for live tool headers and displaceable
- * poll blocks. The TUI throttles at the same cadence, and static frames diff to
- * a no-op redraw at ~zero cost. */
-export declare const SPINNER_RENDER_INTERVAL_MS: number;
-/** Advance the spinner glyph at its classic ~12.5fps step, decoupled from the
- * render cadence (mirrors `Loader`). */
+/** Redraw live tool blocks at the spinner's glyph-advance rate. Rendering more
+ * often produced identical frames — the previous 30fps cadence emitted ~2.4
+ * paints per glyph step, and although the terminal I/O layer dedupes those, the
+ * compose pipeline still ran end-to-end per frame (issue #4353). Matching the
+ * render tick to the glyph tick halves the paints during tool execution with no
+ * visible change. */
+export declare const SPINNER_RENDER_INTERVAL_MS = 80;
+/** Advance the spinner glyph at its classic ~12.5fps step (mirrors `Loader`). */
 export declare const SPINNER_GLYPH_ADVANCE_MS = 80;
 /** Phase-locked spinner glyph index shared by every live tool block so parallel
  * spinners advance in lockstep instead of each tracking its own start time. */
@@ -121,4 +123,5 @@ export declare class ToolExecutionComponent extends Container implements NativeS
     setExpanded(expanded: boolean): void;
     setShowImages(show: boolean): void;
     invalidate(): void;
+    render(width: number): readonly string[];
 }

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

@@ -31,6 +31,7 @@ export declare class TranscriptContainer extends Container implements NativeScro
     getNativeScrollbackLiveRegionStart(): number | undefined;
     getNativeScrollbackCommitSafeEnd(): number | undefined;
     getNativeScrollbackSnapshotSafeEnd(): number | undefined;
+    getNativeScrollbackOfferSafeEnd(): number | undefined;
     /**
      * Whether `component` sits below a still-mutating block — i.e. inside the
      * live region, where its rows cannot have been committed to native

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.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 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" | "advisor.rail" | "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 */

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

@@ -1,4 +1,4 @@
-import type { SessionStorage, SessionStorageStat, SessionStorageWriter } from "./session-storage";
+import type { SessionStorage, SessionStorageStat, SessionStorageWriter, WriteTextAtomicOptions } from "./session-storage";
 import { type SessionTitleUpdate } from "./session-title-slot";
 export interface SessionStorageIndexEntry {
     path: string;
@@ -36,7 +36,7 @@ export declare class IndexedSessionStorage implements SessionStorage {
     readText(path: string): Promise<string>;
     readTextSlices(path: string, prefixBytes: number, suffixBytes: number): Promise<[string, string]>;
     writeText(path: string, content: string): Promise<void>;
-    writeTextAtomic(path: string, content: string): Promise<void>;
+    writeTextAtomic(path: string, content: string, options?: WriteTextAtomicOptions): Promise<void>;
     rename(src: string, dst: string): Promise<void>;
     unlink(path: string): Promise<void>;
     deleteSessionWithArtifacts(sessionPath: string): Promise<void>;

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

@@ -19,6 +19,17 @@ export interface SessionStorageWriter {
     close(): Promise<void>;
     getError(): Error | undefined;
 }
+/**
+ * Optional guard applied by {@link SessionStorage.writeTextAtomic}. The
+ * backend MUST call `commitGuard()` synchronously immediately before it makes
+ * the staged content visible at `path`. If it returns `false`, the staged
+ * write is discarded and the target is left untouched. Backends MUST NOT
+ * yield between calling the guard and publishing the write, so a concurrent
+ * synchronous rewrite that took over cannot be overwritten by a stale body.
+ */
+export interface WriteTextAtomicOptions {
+    commitGuard?: () => boolean;
+}
 export interface SessionStorage {
     ensureDirSync(dir: string): void;
     existsSync(path: string): boolean;
@@ -38,7 +49,7 @@ export interface SessionStorage {
     /** Read the requested UTF-8 byte windows from the head and tail of the file. */
     readTextSlices(path: string, prefixBytes: number, suffixBytes: number): Promise<[string, string]>;
     writeText(path: string, content: string): Promise<void>;
-    writeTextAtomic(path: string, content: string): Promise<void>;
+    writeTextAtomic(path: string, content: string, options?: WriteTextAtomicOptions): Promise<void>;
     rename(path: string, nextPath: string): Promise<void>;
     unlink(path: string): Promise<void>;
     deleteSessionWithArtifacts(sessionPath: string): Promise<void>;
@@ -46,6 +57,15 @@ export interface SessionStorage {
         flags?: "a" | "w";
         onError?: (err: Error) => void;
     }): SessionStorageWriter;
+    /**
+     * Wait for every backing write scheduled by this storage to become durably
+     * visible. Sync backends (file, memory) return immediately because their
+     * writes complete in-body; async backends (Redis/SQL via
+     * {@link IndexedSessionStorage}) await their per-path queues so a caller
+     * driving a graceful shutdown does not exit while a fire-and-forget
+     * `writeTextSync` publish is still on the wire.
+     */
+    drain(): Promise<void>;
 }
 export declare class FileSessionStorage implements SessionStorage {
     #private;
@@ -59,9 +79,16 @@ export declare class FileSessionStorage implements SessionStorage {
     readText(path: string): Promise<string>;
     readTextSlices(path: string, prefixBytes: number, suffixBytes: number): Promise<[string, string]>;
     writeText(path: string, content: string): Promise<void>;
-    writeTextAtomic(fpath: string, content: string): Promise<void>;
+    writeTextAtomic(fpath: string, content: string, options?: WriteTextAtomicOptions): Promise<void>;
+    /**
+     * Sync rename hook. Split from `rename` so `writeTextAtomic` can perform its
+     * guard-then-publish step without a yield, and so tests can inject
+     * Windows-style EPERM at the sync layer used by the atomic path.
+     */
+    renameSync(source: string, target: string): void;
     rename(path: string, nextPath: string): Promise<void>;
     unlink(path: string): Promise<void>;
+    drain(): Promise<void>;
     openWriter(path: string, options?: {
         flags?: "a" | "w";
         onError?: (err: Error) => void;
@@ -90,10 +117,11 @@ export declare class MemorySessionStorage implements SessionStorage {
     readText(path: string): Promise<string>;
     readTextSlices(path: string, prefixBytes: number, suffixBytes: number): Promise<[string, string]>;
     writeText(path: string, content: string): Promise<void>;
-    writeTextAtomic(path: string, content: string): Promise<void>;
+    writeTextAtomic(path: string, content: string, options?: WriteTextAtomicOptions): Promise<void>;
     rename(path: string, nextPath: string): Promise<void>;
     unlink(path: string): Promise<void>;
     deleteSessionWithArtifacts(_sessionPath: string): Promise<void>;
+    drain(): Promise<void>;
     openWriter(path: string, options?: {
         flags?: "a" | "w";
         onError?: (err: Error) => void;

package/dist/types/ssh/__tests__/connection-manager-timeout.test.d.ts

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

package/dist/types/ssh/__tests__/sshfs-mount.test.d.ts

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

package/dist/types/ssh/connection-manager.d.ts

@@ -31,6 +31,25 @@ interface SSHArgsOptions {
     /** When true, omit `-n` so the remote command can read from our piped stdin. */
     allowStdin?: boolean;
 }
+declare function runSshSync(args: string[], timeoutMs?: number): Promise<{
+    exitCode: number | null;
+    stderr: string;
+}>;
+declare function runSshCaptureSync(args: string[], timeoutMs?: number): Promise<{
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Test-only surface for exercising the pre-command SSH helpers against a
+ * fake `ssh` binary with a shortened timeout. External code MUST NOT depend
+ * on this — call `ensureConnection` / `ensureHostInfo` instead.
+ * @internal
+ */
+export declare const _sshHelpersForTests: {
+    runSshSync: typeof runSshSync;
+    runSshCaptureSync: typeof runSshCaptureSync;
+};
 /**
  * Parse a raw cache-file value (or any unknown) into a normalized
  * {@link SSHHostInfo}, dropping fields that don't pass the per-field guards.

package/dist/types/ssh/sshfs-mount.d.ts

@@ -1,6 +1,15 @@
 import { type SSHConnectionTarget } from "./connection-manager";
+type MountPointStatReader = (filePath: string) => Promise<{
+    dev: number;
+}>;
+interface MountCheckOptions {
+    platform?: NodeJS.Platform;
+    stat?: MountPointStatReader;
+    which?: (command: string) => string | null;
+}
 export declare function hasSshfs(): boolean;
-export declare function isMounted(path: string): Promise<boolean>;
+export declare function isMounted(mountPath: string, options?: MountCheckOptions): Promise<boolean>;
 export declare function mountRemote(host: SSHConnectionTarget, remotePath?: string): Promise<string | undefined>;
 export declare function unmountRemote(host: SSHConnectionTarget): Promise<boolean>;
 export declare function unmountAll(): Promise<void>;
+export {};

package/dist/types/subprocess/worker-client.d.ts

@@ -55,7 +55,7 @@ export interface RefCountedWorkerHandle<Inbound, Outbound> extends WorkerHandle<
 }
 /** The raw spawned subprocess plus the parent-side fan-out sets. */
 export interface SpawnedSubprocess<Outbound> {
-    proc: Subprocess<"ignore", "ignore", "ignore">;
+    proc: Subprocess<"ignore", "ignore", number | "ignore">;
     inbound: Set<(message: Outbound) => void>;
     errors: Set<(error: Error) => void>;
     /**
@@ -67,6 +67,14 @@ export interface SpawnedSubprocess<Outbound> {
     intentionalExit: {
         value: boolean;
     };
+    /**
+     * Resolves when the file-backed stderr capture has drained after worker
+     * exit. `onExit` waits on this before surfacing the crash so the exit-error
+     * carries the *whole* tail, not whatever happened to be flushed before the
+     * exit event fired. Tests can await it deterministically instead of racing
+     * wall-clock timers.
+     */
+    stderrDrained: Promise<void>;
 }
 export interface WorkerSpawnCommand {
     cmd: string[];
@@ -94,11 +102,17 @@ export declare function resolveWorkerSpawnCmd(workerArg: string): WorkerSpawnCom
  */
 export declare function workerEnvFromParent(overlay?: Record<string, string>): Record<string, string>;
 /**
- * Spawn an inference worker subprocess and wire its IPC fan-out. The child
- * inherits no stdio (native model runtimes may otherwise print progress or
- * decoded text and corrupt the chat scrollback) and is `unref`'d outside `bun
- * test` so an idle worker never blocks process exit. `exitLabel` prefixes the
- * worker-error message surfaced for an unexpected (non-intentional) exit.
+ * Spawn an inference worker subprocess and wire its IPC fan-out. Stdio is
+ * captured (stderr redirected to a temp file, stdout ignored) so native
+ * runtimes can't corrupt the chat scrollback while the crash reason still
+ * reaches the parent. The file-backed capture deliberately avoids Bun
+ * `ReadableStream` pipes: even an unref'd child with a piped stderr stream can
+ * keep the parent event loop alive. After the worker exits, the last
+ * {@link STDERR_TAIL_LIMIT_BYTES} are appended to the `onExit` error so
+ * `tts/mnemopi/…: worker error` lines carry the actual stack instead of a bare
+ * exit code (issue #4324). The child is `unref`'d outside `bun test` so an idle
+ * worker never blocks process exit. `exitLabel` prefixes the worker-error
+ * message surfaced for an unexpected (non-intentional) exit.
  */
 export declare function createWorkerSubprocess<Outbound>(options: {
     spawnCommand: WorkerSpawnCommand;

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

@@ -5,6 +5,33 @@ import { type Theme } from "../modes/theme/theme";
 import type { ToolSession } from ".";
 import { type OutputMeta } from "./output-meta";
 export declare const BASH_DEFAULT_PREVIEW_LINES = 10;
+/**
+ * Shape a shell command line for an ACP-conformant `terminal/create` request.
+ *
+ * ACP's `command` field is documented as the executable and `args` as its
+ * argv tail (see https://agentclientprotocol.com/protocol/v1/terminals), so a
+ * spec-conformant client `spawn(command, args)`s them directly — no implicit
+ * shell. A raw `bash` tool line ("git status && echo x | head") therefore has
+ * to be wrapped in an explicit shell invocation, otherwise the client tries
+ * to spawn the whole line as argv[0] and fails with `ENOENT` for anything
+ * containing a space, pipe, `&&`, redirect, or `$(...)`.
+ *
+ * The wrap reuses the same shell binary + args the local `bash-executor` would
+ * pick via `settings.getShellConfig()` — Git Bash / `bash.exe` on Windows,
+ * `$SHELL` (bash/zsh) with the `sh` fallback on POSIX — so the ACP path
+ * preserves `bash` tool semantics (`$VAR`, `$(...)`, `source`, POSIX quoting,
+ * `-l`) instead of dropping to `cmd.exe` on Windows. The agent host's shell
+ * path is used as a proxy for the client's, matching the near-universal
+ * ACP deployment shape of an editor spawning omp as a co-hosted subprocess.
+ */
+export declare function wrapShellLineForClientTerminal(line: string, shellConfig: {
+    shell: string;
+    args: string[];
+    prefix?: string | undefined;
+}): {
+    command: string;
+    args: string[];
+};
 /**
  * Bash patterns flagged as safety critical for approval policy.
  *

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

@@ -52,5 +52,18 @@ export type ToolRenderer = {
      * `options.spinnerFrame`.
      */
     animatedPartialResult?: boolean | ((args: unknown) => boolean);
+    /**
+     * Whether replacing a streamed pending placeholder with the first result
+     * requires a full viewport repaint. Use for merged renderers whose pending
+     * streamed args may have committed placeholder rows that the result render
+     * re-anchors instead of preserving.
+     */
+    forceFirstResultViewportRepaint?: boolean;
+    /**
+     * Whether settling a provisional partial result into the final render requires
+     * a full viewport repaint. Use when the result renderer changes chrome or
+     * frame topology at `options.isPartial: true -> false`.
+     */
+    forceResultViewportRepaintOnSettle?: boolean;
 };
 export declare const toolRenderers: Record<string, ToolRenderer>;

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

@@ -70,5 +70,7 @@ export declare const sshToolRenderer: {
     mergeCallAndResult: boolean;
     provisionalPendingPreview: boolean;
     provisionalPartialResult: boolean;
+    forceFirstResultViewportRepaint: boolean;
+    forceResultViewportRepaintOnSettle: boolean;
 };
 export {};

package/dist/types/utils/fetch-timeout.d.ts

@@ -0,0 +1,4 @@
+/** Create an abort signal that fires after a timeout and preserves caller cancellation. */
+export declare function withTimeoutSignal(timeoutMs: number, signal?: AbortSignal): AbortSignal;
+/** Detect a timeout raised by an abortable fetch. */
+export declare function isTimeoutError(error: unknown): boolean;

package/dist/types/web/search/providers/base.d.ts

@@ -51,6 +51,7 @@ export interface SearchParams {
      */
     sessionId?: string;
     antigravityEndpointMode?: "auto" | "production" | "sandbox";
+    geminiModel?: string;
 }
 /** Base class for web search providers. */
 export declare abstract class SearchProvider {

package/dist/types/web/search/providers/gemini.d.ts

@@ -32,6 +32,7 @@ export interface GeminiSearchParams extends GeminiToolParams {
     sessionId?: string;
     fetch?: FetchImpl;
     antigravityEndpointMode?: "auto" | "production" | "sandbox";
+    geminiModel?: string;
 }
 export declare function buildGeminiRequestTools(params: GeminiToolParams): Array<Record<string, Record<string, unknown>>>;
 /** First configured Gemini OAuth provider plus its pre-resolved access. */