@oh-my-pi/pi-coding-agent 17.0.9 → 17.1.0

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

@@ -1,3 +1,4 @@
+import { type ImageProvider } from "../tools/image-providers.js";
 import { type SearchProviderId } from "../web/search/types.js";
 /** Unified settings schema - single source of truth for all settings.
  *
@@ -72,10 +73,17 @@ interface UiString extends UiBase {
      */
     options?: ReadonlyArray<SubmenuOption> | "runtime";
 }
+interface UiArray extends UiBase {
+    /** Membership choices. Without options, an array setting has no UI representation (config-file only). */
+    options?: ReadonlyArray<SubmenuOption>;
+    /** Selection order is meaningful; the editor renders positions and supports reordering. */
+    ordered?: boolean;
+}
 /** Wide ui shape exposed to consumers that walk the schema generically. */
 export type AnyUiMetadata = UiBase & {
     options?: ReadonlyArray<SubmenuOption> | "runtime";
     secret?: boolean;
+    ordered?: boolean;
 };
 interface BooleanDef {
     type: "boolean";
@@ -101,7 +109,7 @@ interface EnumDef<T extends readonly string[]> {
 interface ArrayDef<T> {
     type: "array";
     default: T[];
-    ui?: UiBase;
+    ui?: UiArray;
 }
 interface RecordDef<T> {
     type: "record";
@@ -819,6 +827,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Render Mermaid fenced code blocks as ASCII diagrams";
         };
     };
+    readonly "tui.titleState": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly group: "Display";
+            readonly label: "Terminal Title Run State";
+            readonly description: "Show the agent run state in the terminal title's separator — an animated spinner while working, '>' when it's your turn, '!' when the agent is waiting on you";
+        };
+    };
     readonly "tui.hyperlinks": {
         readonly type: "enum";
         readonly values: readonly ["off", "auto", "always"];
@@ -1080,6 +1098,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Render the workspace directory tree in the system prompt. WARNING: This can bust prompt caching across sessions when files are modified.";
         };
     };
+    readonly "workspace.additionalDirectories": {
+        readonly type: "array";
+        readonly default: string[];
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "General";
+            readonly label: "Additional Workspace Dirs";
+            readonly description: "Extra workspace directories added to every session as additional roots (multi-root workspace). Managed live via /add-dir and /remove-dir. Paths resolve relative to cwd; absolute paths recommended. The agent is told these roots exist and can read/grep/glob them.";
+        };
+    };
     readonly personality: {
         readonly type: "enum";
         readonly values: readonly ["default", "friendly", "pragmatic", "none"];
@@ -1441,6 +1469,73 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Allow retry recovery to switch to configured fallback models";
         };
     };
+    readonly "retry.usageAwareFallback": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Retry & Fallback";
+            readonly label: "Usage-Aware Fallback";
+            readonly description: "Use reliable coding-plan quota reports to prefer same-provider accounts, then configured fallback models, before a hard usage limit. Ordinary configured API keys are excluded.";
+        };
+    };
+    readonly "retry.usageReservePct": {
+        readonly type: "number";
+        readonly default: 10;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Retry & Fallback";
+            readonly label: "Reserve Margin";
+            readonly description: "Treat a coding-plan model as near its limit below this remaining percentage. Unknown or unmapped usage keeps the primary model.";
+            readonly condition: "usageAwareFallbackEnabled";
+            readonly options: readonly [{
+                readonly value: "5";
+                readonly label: "5%";
+                readonly description: "Act only when nearly exhausted";
+            }, {
+                readonly value: "10";
+                readonly label: "10%";
+                readonly description: "Balanced safety margin";
+            }, {
+                readonly value: "15";
+                readonly label: "15%";
+                readonly description: "Conservative";
+            }, {
+                readonly value: "20";
+                readonly label: "20%";
+                readonly description: "Early protection";
+            }, {
+                readonly value: "25";
+                readonly label: "25%";
+                readonly description: "Very conservative";
+            }];
+        };
+    };
+    readonly "retry.usageReservePolicy": {
+        readonly type: "enum";
+        readonly values: readonly ["confirm", "auto", "fail-closed"];
+        readonly default: "confirm";
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Retry & Fallback";
+            readonly label: "Reserve Policy";
+            readonly description: "What to do when every same-provider coding-plan account is inside the reserve margin.";
+            readonly condition: "usageAwareFallbackEnabled";
+            readonly options: readonly [{
+                readonly value: "confirm";
+                readonly label: "Confirm interactively";
+                readonly description: "Keep interactive sessions on the primary until confirmed; background agents auto-fallback";
+            }, {
+                readonly value: "auto";
+                readonly label: "Auto-fallback";
+                readonly description: "Always select the next eligible configured fallback";
+            }, {
+                readonly value: "fail-closed";
+                readonly label: "Fail closed";
+                readonly description: "Do not spend reserve quota or select a fallback";
+            }];
+        };
+    };
     readonly "retry.fallbackChains": {
         readonly type: "record";
         readonly default: Record<string, string[]>;
@@ -1750,6 +1845,17 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Notify when the agent finishes a turn";
         };
     };
+    readonly "error.notify": {
+        readonly type: "enum";
+        readonly values: readonly ["on", "off"];
+        readonly default: "off";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Notifications";
+            readonly label: "Error Notification";
+            readonly description: "Notify when the agent stops with an error";
+        };
+    };
     readonly "ask.timeout": {
         readonly type: "number";
         readonly default: 0;
@@ -3245,6 +3351,16 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "read.renderMarkdown": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "files";
+            readonly group: "Reading";
+            readonly label: "Markdown Previews";
+            readonly description: "Render Markdown read results as formatted terminal Markdown previews instead of raw source";
+        };
+    };
     readonly "read.summarize.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -3405,6 +3521,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Automatically background long-running bash commands and deliver the result later";
         };
     };
+    readonly "bash.patterns": {
+        readonly type: "array";
+        readonly default: readonly [];
+        readonly ui: {
+            readonly tab: "shell";
+            readonly group: "Bash";
+            readonly label: "Bash Approval Patterns";
+            readonly description: "Ordered bash command approval rules. Each item has match and approval fields; only '*' wildcards are supported.";
+        };
+    };
     readonly "bashInterceptor.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -3419,6 +3545,27 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "array";
         readonly default: BashInterceptorRule[];
     };
+    readonly "bash.direnv": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "off"];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "shell";
+            readonly group: "Bash";
+            readonly label: "direnv Auto-Load";
+            readonly description: "Auto-load a repo's direnv/devenv `.envrc` into the bash session so devenv tools and env vars are present without manual `direnv exec`. Honors direnv's allow list: an `.envrc` you haven't `direnv allow`ed is never executed";
+        };
+    };
+    readonly "bash.direnvLoadTimeoutMs": {
+        readonly type: "number";
+        readonly default: 30000;
+        readonly ui: {
+            readonly tab: "shell";
+            readonly group: "Bash";
+            readonly label: "direnv Load Timeout (ms)";
+            readonly description: "Max wait for the first `direnv export` (a cold devenv shell can be slow); on timeout the session runs without the direnv env";
+        };
+    };
     readonly "shellMinimizer.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -4051,6 +4198,40 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Mount rarely-used (discoverable) tools under xd:// device URLs driven via read/write instead of shipping their schemas on every request. Disable to expose every enabled tool top-level.";
         };
     };
+    readonly "tools.xdevDocs": {
+        readonly type: "enum";
+        readonly values: readonly ["inline", "builtins", "catalog"];
+        readonly default: "builtins";
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Discovery & MCP";
+            readonly label: "xd:// Prompt Docs";
+            readonly description: "Choose which mounted-device docs and schemas are inlined in the system prompt. Built-ins keeps core tools inline while MCP and extension tools stay on-demand.";
+            readonly options: readonly [{
+                readonly value: "inline";
+                readonly label: "All Devices";
+                readonly description: "Inline docs and schemas for every mounted device.";
+            }, {
+                readonly value: "builtins";
+                readonly label: "Built-ins Only";
+                readonly description: "Inline built-in docs; fetch MCP and extension docs on demand.";
+            }, {
+                readonly value: "catalog";
+                readonly label: "Catalog Only";
+                readonly description: "List every device; fetch all docs on demand.";
+            }];
+        };
+    };
+    readonly "tools.xdevInlineDevices": {
+        readonly type: "array";
+        readonly default: string[];
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Discovery & MCP";
+            readonly label: "xd:// Inline Devices";
+            readonly description: "When xd:// Prompt Docs is Built-ins Only, inline dynamic devices whose names match these glob patterns (for example mcp__context_mode_*). Catalog Only ignores this setting.";
+        };
+    };
     readonly "mcp.enableProjectConfig": {
         readonly type: "boolean";
         readonly default: true;
@@ -4295,7 +4476,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly tab: "tasks";
             readonly group: "Subagents";
             readonly label: "Batch Task Calls";
-            readonly description: "Switch the task tool to its batch shape: one call carries { agent, context, tasks[] } — one subagent per item (with per-item isolation) and a required shared context prepended to every assignment. With async.enabled=true, each spawn runs as an independent background agent with the normal idle/parked lifecycle; otherwise the call blocks for merged results. Disable to restore the flat single-spawn schema.";
+            readonly description: "Switch the task tool to its batch shape: one call carries { context, tasks[] } — one subagent per item, with an optional per-item agent (defaulting to the session spawn-policy agent), per-item isolation, and a required shared context prepended to every assignment. With async.enabled=true, each spawn runs as an independent background agent with the normal idle/parked lifecycle; otherwise the call blocks for merged results. Disable to restore the flat single-spawn schema.";
         };
     };
     readonly "task.maxConcurrency": {
@@ -4606,7 +4787,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly tab: "providers";
             readonly group: "Privacy";
             readonly label: "Hide Secrets";
-            readonly description: "Obfuscate secrets before sending to AI providers";
+            readonly description: "Obfuscate configured secrets and redact credential-shaped tokens before sending to AI providers";
         };
     };
     readonly "providers.ollama-cloud.maxConcurrency": {
@@ -4619,112 +4800,108 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Maximum concurrent Ollama Cloud subagent runs per process; 0 disables the provider-specific limit";
         };
     };
-    readonly "providers.webSearch": {
-        readonly type: "enum";
-        readonly values: readonly ["auto", ...SearchProviderId[]];
-        readonly default: "auto";
+    readonly "providers.webSearchOrder": {
+        readonly type: "array";
+        readonly default: SearchProviderId[];
         readonly ui: {
             readonly tab: "providers";
             readonly group: "Services";
-            readonly label: "Web Search Provider";
-            readonly description: "Preferred provider for the web_search tool";
-            readonly options: readonly [{
-                readonly value: "auto";
-                readonly label: "Auto";
-                readonly description: "Automatically uses the first configured web-search provider";
-            }, {
+            readonly label: "Web Search Provider Order";
+            readonly description: "Prioritized providers for the web_search tool; unlisted providers retain their default order afterward";
+            readonly options: ({
                 readonly value: "perplexity";
                 readonly label: "Perplexity";
                 readonly description: "Uses auth when configured; explicit selection falls back to anonymous search";
-            }, {
+            } | {
                 readonly value: "gemini";
                 readonly label: "Gemini";
                 readonly description: "Google Search grounding via Gemini (uses google-gemini-cli or google-antigravity OAuth)";
-            }, {
+            } | {
                 readonly value: "anthropic";
                 readonly label: "Anthropic";
                 readonly description: "Claude's native web_search tool (uses Anthropic OAuth or ANTHROPIC_API_KEY)";
-            }, {
+            } | {
                 readonly value: "codex";
                 readonly label: "OpenAI";
                 readonly description: "OpenAI's native web_search (uses ChatGPT OAuth via /login openai-codex)";
-            }, {
+            } | {
                 readonly value: "xai";
                 readonly label: "xAI";
                 readonly description: "Grok web search via xAI Responses API (requires XAI_API_KEY)";
-            }, {
+            } | {
                 readonly value: "zai";
                 readonly label: "Z.AI";
                 readonly description: "Calls Z.AI webSearchPrime MCP";
-            }, {
+            } | {
                 readonly value: "exa";
                 readonly label: "Exa";
                 readonly description: "Uses Exa API when EXA_API_KEY is set; falls back to Exa MCP";
-            }, {
+            } | {
                 readonly value: "tinyfish";
                 readonly label: "TinyFish";
                 readonly description: "Requires TINYFISH_API_KEY";
-            }, {
+            } | {
                 readonly value: "jina";
                 readonly label: "Jina";
                 readonly description: "Requires JINA_API_KEY";
-            }, {
+            } | {
                 readonly value: "kagi";
                 readonly label: "Kagi";
                 readonly description: "Requires KAGI_API_KEY and Kagi Search API beta access";
-            }, {
+            } | {
                 readonly value: "tavily";
                 readonly label: "Tavily";
                 readonly description: "Requires TAVILY_API_KEY";
-            }, {
+            } | {
                 readonly value: "firecrawl";
                 readonly label: "Firecrawl";
                 readonly description: "Uses Firecrawl API when FIRECRAWL_API_KEY is set; falls back to keyless mode";
-            }, {
+            } | {
                 readonly value: "brave";
                 readonly label: "Brave";
                 readonly description: "Requires BRAVE_API_KEY";
-            }, {
+            } | {
                 readonly value: "kimi";
                 readonly label: "Kimi";
                 readonly description: "Kimi Code search (requires a Kimi Code Console key via KIMI_SEARCH_API_KEY/MOONSHOT_SEARCH_API_KEY or /login kimi-code; not MOONSHOT_API_KEY)";
-            }, {
+            } | {
                 readonly value: "parallel";
                 readonly label: "Parallel";
                 readonly description: "Requires PARALLEL_API_KEY";
-            }, {
+            } | {
                 readonly value: "synthetic";
                 readonly label: "Synthetic";
                 readonly description: "Requires SYNTHETIC_API_KEY";
-            }, {
+            } | {
                 readonly value: "searxng";
                 readonly label: "SearXNG";
                 readonly description: "Requires SEARXNG_ENDPOINT or searxng.endpoint";
-            }, {
+            } | {
                 readonly value: "startpage";
                 readonly label: "Startpage";
                 readonly description: "Credential-free scrape of Startpage (Google-backed) results; may be bot-challenged";
-            }, {
+            } | {
                 readonly value: "duckduckgo";
                 readonly label: "DuckDuckGo";
                 readonly description: "Credential-free best-effort fallback; may be bot-challenged on datacenter/shared-egress IPs";
-            }, {
+            } | {
                 readonly value: "ecosia";
                 readonly label: "Ecosia";
                 readonly description: "Credential-free browser-backed scrape of Ecosia (Google-backed) results";
-            }, {
+            } | {
                 readonly value: "google";
                 readonly label: "Google";
                 readonly description: "Credential-free browser-backed fallback; slower and may be bot-challenged";
-            }, {
+            } | {
                 readonly value: "mojeek";
                 readonly label: "Mojeek";
                 readonly description: "Credential-free browser-backed scrape of Mojeek's independent index";
-            }, {
+            } | {
                 readonly value: "public";
                 readonly label: "Public Web";
                 readonly description: "Queries every credential-free engine in parallel and consolidates deduplicated results";
-            }];
+            })[];
+            readonly ordered: true;
         };
     };
     readonly "providers.webSearchExclude": {
@@ -4735,6 +4912,99 @@ export declare const SETTINGS_SCHEMA: {
             readonly group: "Services";
             readonly label: "Excluded Web Search Providers";
             readonly description: "Providers that web_search should never use, even as fallbacks";
+            readonly options: ({
+                readonly value: "perplexity";
+                readonly label: "Perplexity";
+                readonly description: "Uses auth when configured; explicit selection falls back to anonymous search";
+            } | {
+                readonly value: "gemini";
+                readonly label: "Gemini";
+                readonly description: "Google Search grounding via Gemini (uses google-gemini-cli or google-antigravity OAuth)";
+            } | {
+                readonly value: "anthropic";
+                readonly label: "Anthropic";
+                readonly description: "Claude's native web_search tool (uses Anthropic OAuth or ANTHROPIC_API_KEY)";
+            } | {
+                readonly value: "codex";
+                readonly label: "OpenAI";
+                readonly description: "OpenAI's native web_search (uses ChatGPT OAuth via /login openai-codex)";
+            } | {
+                readonly value: "xai";
+                readonly label: "xAI";
+                readonly description: "Grok web search via xAI Responses API (requires XAI_API_KEY)";
+            } | {
+                readonly value: "zai";
+                readonly label: "Z.AI";
+                readonly description: "Calls Z.AI webSearchPrime MCP";
+            } | {
+                readonly value: "exa";
+                readonly label: "Exa";
+                readonly description: "Uses Exa API when EXA_API_KEY is set; falls back to Exa MCP";
+            } | {
+                readonly value: "tinyfish";
+                readonly label: "TinyFish";
+                readonly description: "Requires TINYFISH_API_KEY";
+            } | {
+                readonly value: "jina";
+                readonly label: "Jina";
+                readonly description: "Requires JINA_API_KEY";
+            } | {
+                readonly value: "kagi";
+                readonly label: "Kagi";
+                readonly description: "Requires KAGI_API_KEY and Kagi Search API beta access";
+            } | {
+                readonly value: "tavily";
+                readonly label: "Tavily";
+                readonly description: "Requires TAVILY_API_KEY";
+            } | {
+                readonly value: "firecrawl";
+                readonly label: "Firecrawl";
+                readonly description: "Uses Firecrawl API when FIRECRAWL_API_KEY is set; falls back to keyless mode";
+            } | {
+                readonly value: "brave";
+                readonly label: "Brave";
+                readonly description: "Requires BRAVE_API_KEY";
+            } | {
+                readonly value: "kimi";
+                readonly label: "Kimi";
+                readonly description: "Kimi Code search (requires a Kimi Code Console key via KIMI_SEARCH_API_KEY/MOONSHOT_SEARCH_API_KEY or /login kimi-code; not MOONSHOT_API_KEY)";
+            } | {
+                readonly value: "parallel";
+                readonly label: "Parallel";
+                readonly description: "Requires PARALLEL_API_KEY";
+            } | {
+                readonly value: "synthetic";
+                readonly label: "Synthetic";
+                readonly description: "Requires SYNTHETIC_API_KEY";
+            } | {
+                readonly value: "searxng";
+                readonly label: "SearXNG";
+                readonly description: "Requires SEARXNG_ENDPOINT or searxng.endpoint";
+            } | {
+                readonly value: "startpage";
+                readonly label: "Startpage";
+                readonly description: "Credential-free scrape of Startpage (Google-backed) results; may be bot-challenged";
+            } | {
+                readonly value: "duckduckgo";
+                readonly label: "DuckDuckGo";
+                readonly description: "Credential-free best-effort fallback; may be bot-challenged on datacenter/shared-egress IPs";
+            } | {
+                readonly value: "ecosia";
+                readonly label: "Ecosia";
+                readonly description: "Credential-free browser-backed scrape of Ecosia (Google-backed) results";
+            } | {
+                readonly value: "google";
+                readonly label: "Google";
+                readonly description: "Credential-free browser-backed fallback; slower and may be bot-challenged";
+            } | {
+                readonly value: "mojeek";
+                readonly label: "Mojeek";
+                readonly description: "Credential-free browser-backed scrape of Mojeek's independent index";
+            } | {
+                readonly value: "public";
+                readonly label: "Public Web";
+                readonly description: "Queries every credential-free engine in parallel and consolidates deduplicated results";
+            })[];
         };
     };
     readonly "providers.webSearchGeminiModel": {
@@ -4771,20 +5041,15 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
-    readonly "providers.image": {
-        readonly type: "enum";
-        readonly values: readonly ["auto", "openai", "openai-codex", "antigravity", "xai", "gemini", "openrouter"];
-        readonly default: "auto";
+    readonly "providers.imageOrder": {
+        readonly type: "array";
+        readonly default: ImageProvider[];
         readonly ui: {
             readonly tab: "providers";
             readonly group: "Services";
-            readonly label: "Image Provider";
-            readonly description: "Preferred provider for image generation";
+            readonly label: "Image Provider Order";
+            readonly description: "Prioritized providers for image generation; unlisted providers follow the active session provider and the built-in order";
             readonly options: readonly [{
-                readonly value: "auto";
-                readonly label: "Auto";
-                readonly description: "Priority: per-request provider > configured provider > active session provider > GPT model image tool > Codex subscription > Antigravity > xAI > OpenRouter > Gemini";
-            }, {
                 readonly value: "openai";
                 readonly label: "OpenAI";
                 readonly description: "OPENAI_API_KEY (gpt-image-2) or active GPT model; falls back to a connected Codex subscription";
@@ -4809,6 +5074,7 @@ export declare const SETTINGS_SCHEMA: {
                 readonly label: "OpenRouter";
                 readonly description: "Requires OPENROUTER_API_KEY";
             }];
+            readonly ordered: true;
         };
     };
     readonly "providers.fireworksTier": {
@@ -5688,6 +5954,9 @@ export interface RetrySettings {
     baseDelayMs: number;
     maxDelayMs: number;
     modelFallback: boolean;
+    usageAwareFallback: boolean;
+    usageReservePct: number;
+    usageReservePolicy: "confirm" | "auto" | "fail-closed";
 }
 export interface MemoriesSettings {
     enabled: boolean;

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

@@ -88,6 +88,13 @@ export declare class Settings {
      * Clear a runtime override.
      */
     clearOverride(path: SettingPath): void;
+    /**
+     * Drop pending debounced saves and refuse any further background writes.
+     * Used when an instance is being discarded (test teardown): an armed timer
+     * or a chained in-flight save on a dropped instance would otherwise fire
+     * later and race the successor's file locks.
+     */
+    cancelPendingSaves(): void;
     /**
      * Flush any pending saves to disk.
      * Call before exit to ensure all changes are persisted.

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

@@ -72,4 +72,24 @@ export declare function waitForTcpServerListening(proc: {
     stdout: ReadableStream<Uint8Array>;
     exitCode: number | null;
 }, port: number, timeoutMs: number): Promise<void>;
+interface SocketTransport {
+    readable: ReadableStream<Uint8Array>;
+    writeSink: DapWriteSink;
+    socket: {
+        end(): void;
+    };
+}
+/**
+ * Connect to a unix domain socket and return DAP transport streams.
+ *
+ * Rejects (rather than hanging) when the connect fails — a stat-ready but dead
+ * socket returns ECONNREFUSED, a socket removed between the readiness stat and
+ * the connect returns ENOENT, a permission mismatch returns EACCES — and when
+ * neither `open` nor an error arrives within `timeoutMs` (e.g. a TOCTOU stall).
+ * `#spawnSocketUnix`'s catch then kills the detached adapter instead of leaking
+ * it. Exported so tests can drive the reject path deterministically.
+ */
+export declare function connectSocket(options: {
+    unix: string;
+}, timeoutMs: number): Promise<SocketTransport>;
 export {};

package/dist/types/exec/bash-executor.d.ts

@@ -43,6 +43,44 @@ export interface BashResult {
     artifactId?: string;
     workingDir?: string;
 }
+export interface DirenvPreflightOptions {
+    /** Caller-supplied env overlay; these values win over direnv-provided ones. */
+    callerEnv?: Record<string, string>;
+    signal?: AbortSignal;
+    /** Full direnv-load budget (`bash.direnvLoadTimeoutMs`). A positive
+     *  `callerTimeoutMs` clamps the effective load below this; `0`/undefined
+     *  leaves the full budget. */
+    timeoutMs?: number;
+    /** The caller's command deadline (ms). A positive value clamps the direnv
+     *  load so a cold `.envrc` can't outlast a short-timeout command; `0` or
+     *  undefined means "no caller clamp" — the load keeps its full `timeoutMs`
+     *  budget (a disabled command deadline is NOT a 0 ms load). Centralizing the
+     *  clamp here keeps every backend (executeBash, ACP terminal, PTY) on one
+     *  contract instead of each re-deriving it. */
+    callerTimeoutMs?: number;
+    /** `bash.direnv` setting — `"off"` skips the load entirely. */
+    direnvSetting: "auto" | "off";
+    /** Shell wrapper prefix (profiler/strace) to place *after* the unset prefix,
+     *  matching `executeBash`'s ordering. Backends that apply their own shell
+     *  wrapping (ACP `wrapShellLineForClientTerminal`) omit this. */
+    commandPrefix?: string | undefined;
+}
+/**
+ * Load the repo's direnv/devenv env and fold it into a `(command, env)` pair so
+ * every bash backend (one-shot `executeBash`, ACP client terminal, PTY) exposes
+ * the same devenv tools. Encapsulates: load the diff, merge `set` under the
+ * caller's overlay (caller wins), and prepend a regex-gated `unset -v` for
+ * variables the `.envrc` removes (skipping any the caller re-supplied).
+ *
+ * Returns the possibly-prefixed command plus the merged env, or the inputs
+ * unchanged (`env` = `callerEnv`) when direnv is off, absent, or has no `.envrc`.
+ * Pure transform: does NOT layer non-interactive env defaults — that stays the
+ * caller's job (so interactive PTY/ACP paths keep their own env shape).
+ */
+export declare function applyDirenvPreflight(command: string, cwd: string, opts: DirenvPreflightOptions): Promise<{
+    command: string;
+    env: Record<string, string> | undefined;
+}>;
 /** Translate `ShellMinimizerSettings` into native `MinimizerOptions`, or `undefined` when disabled. */
 export declare function buildMinimizerOptions(group: ShellMinimizerSettings): MinimizerOptions | undefined;
 export declare function isPersistentShellCdCommand(command: string): boolean;