@oh-my-pi/pi-coding-agent 16.3.0 → 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"];
@@ -4752,6 +4762,16 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "speech.enhanced": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Enhanced Speech Rewriting";
+            readonly description: "Rewrite assistant output into natural spoken prose with the tiny/smol model before synthesis (describes code, drops links and markdown). Falls back to mechanical cleanup on failure";
+        };
+    };
     readonly "speech.voice": {
         readonly type: "enum";
         readonly values: readonly string[];

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/discovery/helpers.d.ts

@@ -236,6 +236,8 @@ export declare function resolveActiveProjectRegistryPath(cwd: string): Promise<s
  * never alias as the project registry.
  */
 export declare function resolveOrDefaultProjectRegistryPath(cwd: string): Promise<string | undefined>;
+/** Register a process-global plugin cache invalidator called whenever plugin roots are cleared. */
+export declare function registerPluginCacheInvalidator(invalidator: () => void): void;
 /**
  * List all installed Claude Code plugin roots from the plugin cache.
  * Reads ~/.claude/plugins/installed_plugins.json and ~/.omp/plugins/installed_plugins.json,

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/irc/bus.d.ts

@@ -8,10 +8,11 @@
  * agents receive the message as a non-interrupting aside at the next step
  * boundary (see AgentSession.deliverIrcMessage). Replies are real turns by
  * the recipient, observed via `wait` — with one exception: when the sender
- * awaits a reply and the recipient is mid-turn with async execution
- * disabled, the recipient session generates an ephemeral side-channel
- * auto-reply (it may be blocked in a synchronous task spawn whose batch
- * includes the sender, so a real turn could never happen in time).
+ * awaits a reply and the recipient cannot run a real reply turn in time
+ * (mid-turn with async execution disabled — possibly blocked in a
+ * synchronous task spawn whose batch includes the sender — or idle in plan
+ * mode, where autonomous wake turns are suppressed), the recipient session
+ * generates an ephemeral side-channel auto-reply.
  */
 import { AgentLifecycleManager } from "../registry/agent-lifecycle";
 import { AgentRegistry } from "../registry/agent-registry";

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/agent-session.d.ts

@@ -882,12 +882,10 @@ export declare class AgentSession {
     /**
      * Set model directly.
      * Validates that a credential source is configured (synchronously, without
-     * refreshing OAuth or running command-backed key programs). The active
-     * session switches by default; when `currentContextTokens` is provided and
-     * exceeds the refreshed candidate's context window, the live switch is
-     * skipped while role persistence still runs. Returns whether the active
-     * model actually switched, computed against the refreshed metadata so
-     * dynamic providers (e.g. llama.cpp) honor their post-load contextWindow.
+     * refreshing OAuth or running command-backed key programs). Active switches
+     * always take effect; if the current transcript is too large for the target
+     * model, the next prompt's compaction/error path owns that recovery instead
+     * of leaving the session pinned to the old model.
      * @throws Error if no API key available for the model
      */
     setModel(model: Model, role?: string, options?: {
@@ -1163,18 +1161,20 @@ export declare class AgentSession {
      *
      * - mid-turn → queued on the aside channel and folded in at the next step
      *   boundary (non-interrupting, like async-result deliveries) → "injected";
+     * - idle in plan mode → appended into context without waking an autonomous
+     *   turn (convergence stays user-driven) → "injected";
      * - idle → starts a real turn with the message so the recipient wakes
      *   → "woken".
      *
      * Never blocks on the recipient's turn: the wake turn is fire-and-forget.
      *
-     * When the sender expects a reply (`send await:true`) and this session is
-     * mid-turn with async execution disabled, the next step boundary may be
-     * gated on the sender's own batch finishing (blocking task spawns), so a
-     * real reply turn can never happen in time. In that case an ephemeral
-     * side-channel auto-reply is generated from the current context (the old
-     * `respondAsBackground` path) and sent back over the bus on this agent's
-     * behalf.
+     * When the sender expects a reply (`send await:true`) and this session
+     * cannot produce a real reply turn in time — mid-turn with async execution
+     * disabled (the next step boundary may be gated on the sender's own batch
+     * finishing), or idle in plan mode (wake turns are suppressed) — an
+     * ephemeral side-channel auto-reply is generated from the current context
+     * (the old `respondAsBackground` path) and sent back over the bus on this
+     * agent's behalf.
      */
     deliverIrcMessage(msg: IrcMessage, opts?: {
         expectsReply?: boolean;

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/task/discovery.d.ts

@@ -6,8 +6,11 @@ export interface DiscoveryResult {
 }
 /**
  * Discover agents from filesystem and merge with bundled agents.
- *
- * Precedence (highest wins): project .omp, user .omp, Claude plugin agents, then bundled
+ * Precedence (highest wins): project `.omp/agents`, user `.omp/agents`,
+ * OMP extension-package agents in `listOmpExtensionRoots` source order
+ * (CLI roots > project `extensions:` settings > user `extensions:` settings >
+ * installed npm/link plugins), Claude marketplace plugin agents (project
+ * scope before user), then bundled.
  * @param cwd - Current working directory for project agent discovery
  */
 export declare function discoverAgents(cwd: string, home?: string): Promise<DiscoveryResult>;

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

@@ -10,4 +10,5 @@ export declare const taskToolRenderer: {
     readonly renderCall: typeof renderCall;
     readonly renderResult: typeof renderResult;
     readonly mergeCallAndResult: true;
+    readonly animatedPartialResult: true;
 };