@oh-my-pi/pi-coding-agent 16.1.22 → 16.2.0

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

@@ -257,6 +257,16 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "array";
         readonly default: string[];
     };
+    readonly "providers.maxInFlightRequests": {
+        readonly type: "record";
+        readonly default: Record<string, number>;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Max In-Flight Requests";
+            readonly description: 'Maximum concurrent LLM requests per provider id (for example "openai" or "anthropic"), shared across local OMP processes with this config root. Omitted providers are unlimited.';
+        };
+    };
     readonly disabledExtensions: {
         readonly type: "array";
         readonly default: string[];
@@ -735,6 +745,16 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 8;
         readonly description: "Maximum number of inline images kept as live terminal graphics (default 8). Older images fall back to a text placeholder via a full redraw once the limit is exceeded. Set to 0 to keep every image (no limit).";
     };
+    readonly "terminal.showProgress": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly group: "Display";
+            readonly label: "Native Terminal Progress";
+            readonly description: "Emit OSC 9;4 indeterminate progress while the agent or context maintenance is running";
+        };
+    };
     readonly "tui.textSizing": {
         readonly type: "boolean";
         readonly default: false;
@@ -745,6 +765,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Render Markdown H1 headings at 2x scale using Kitty's OSC 66 text-sizing protocol. Only takes effect on Kitty terminals; ignored everywhere else. Off by default.";
         };
     };
+    readonly "tui.renderMermaid": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly group: "Display";
+            readonly label: "Render Mermaid Diagrams";
+            readonly description: "Render Mermaid fenced code blocks as ASCII diagrams";
+        };
+    };
     readonly "tui.hyperlinks": {
         readonly type: "enum";
         readonly values: readonly ["off", "auto", "always"];
@@ -892,14 +922,38 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Apply loop guard to assistant prose messages in addition to thinking logs";
         };
     };
-    readonly inlineToolDescriptors: {
+    readonly "model.loopGuard.toolCallReminder": {
         readonly type: "boolean";
-        readonly default: false;
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Thinking";
+            readonly label: "Loop Guard Tool-Call Reminder";
+            readonly description: "When a Gemini reasoning stream emits many consecutive planning headers without calling a tool, interrupt it and inject a reminder to issue a tool call (requires Loop Guard)";
+        };
+    };
+    readonly inlineToolDescriptors: {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "on", "off"];
+        readonly default: "auto";
         readonly ui: {
             readonly tab: "model";
             readonly group: "Prompt";
             readonly label: "Inline Tool Descriptors";
-            readonly description: "Render full tool descriptors in the system prompt and strip top-level/nested descriptions from provider tool schemas so descriptor text is sent once";
+            readonly description: "Render full tool descriptors in the system prompt and strip top-level/nested descriptions from provider tool schemas so descriptor text is sent once. Auto enables this for Gemini models and disables it otherwise";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Inline descriptors for Gemini models; keep them in tool schemas otherwise";
+            }, {
+                readonly value: "on";
+                readonly label: "On";
+                readonly description: "Always inline descriptors in the system prompt";
+            }, {
+                readonly value: "off";
+                readonly label: "Off";
+                readonly description: "Keep descriptors in provider tool schemas only";
+            }];
         };
     };
     readonly includeModelInPrompt: {
@@ -1709,6 +1763,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Automatically compact context when it gets too large";
         };
     };
+    readonly "compaction.midTurnEnabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "Compaction";
+            readonly label: "Mid-Turn Compaction";
+            readonly description: "Check thresholds at safe mid-turn tool-loop boundaries before the next provider request";
+        };
+    };
     readonly "compaction.strategy": {
         readonly type: "enum";
         readonly values: readonly ["context-full", "handoff", "shake", "snapcompact", "off"];
@@ -3332,34 +3396,34 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
-    readonly "find.enabled": {
+    readonly "glob.enabled": {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
             readonly group: "Available Tools";
-            readonly label: "Find";
-            readonly description: "Enable the find tool for glob-based file lookup";
+            readonly label: "Glob";
+            readonly description: "Enable the glob tool for glob-based file lookup";
         };
     };
-    readonly "search.enabled": {
+    readonly "grep.enabled": {
         readonly type: "boolean";
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
             readonly group: "Available Tools";
-            readonly label: "Search";
-            readonly description: "Enable the search tool for regex content search";
+            readonly label: "Grep";
+            readonly description: "Enable the grep tool for regex content search";
         };
     };
-    readonly "search.contextBefore": {
+    readonly "grep.contextBefore": {
         readonly type: "number";
         readonly default: 1;
         readonly ui: {
             readonly tab: "tools";
-            readonly group: "Search & Browser";
-            readonly label: "Search Context Before";
-            readonly description: "Lines of context before each search match";
+            readonly group: "Grep & Browser";
+            readonly label: "Grep Context Before";
+            readonly description: "Lines of context before each grep match";
             readonly options: readonly [{
                 readonly value: "0";
                 readonly label: "0 lines";
@@ -3378,14 +3442,14 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
-    readonly "search.contextAfter": {
+    readonly "grep.contextAfter": {
         readonly type: "number";
         readonly default: 3;
         readonly ui: {
             readonly tab: "tools";
-            readonly group: "Search & Browser";
-            readonly label: "Search Context After";
-            readonly description: "Lines of context after each search match";
+            readonly group: "Grep & Browser";
+            readonly label: "Grep Context After";
+            readonly description: "Lines of context after each grep match";
             readonly options: readonly [{
                 readonly value: "0";
                 readonly label: "0 lines";
@@ -3552,7 +3616,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
-            readonly group: "Search & Browser";
+            readonly group: "Grep & Browser";
             readonly label: "Headless Browser";
             readonly description: "Launch browser in headless mode (disable to show browser UI)";
         };
@@ -3562,7 +3626,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: true;
         readonly ui: {
             readonly tab: "tools";
-            readonly group: "Search & Browser";
+            readonly group: "Grep & Browser";
             readonly label: "cmux Browser";
             readonly description: "Use cmux WKWebView surfaces for browser automation when a cmux socket is available. Set PI_BROWSER_CMUX=0 or PI_BROWSER_CMUX=1 to override.";
         };
@@ -3572,7 +3636,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: undefined;
         readonly ui: {
             readonly tab: "tools";
-            readonly group: "Search & Browser";
+            readonly group: "Grep & Browser";
             readonly label: "Screenshot Directory";
             readonly description: "Directory to save screenshots. If unset, screenshots go to a temp file. Supports ~. Examples: ~/Downloads, ~/Desktop, /sdcard/Download (Android)";
         };
@@ -3719,7 +3783,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly tab: "tools";
             readonly group: "Discovery & MCP";
             readonly label: "Essential Tools Override";
-            readonly description: "Override the always-loaded built-in tools (default: read, bash, edit, write, find, eval). Leave empty to use defaults.";
+            readonly description: "Override the always-loaded built-in tools (default: read, bash, edit, write, glob, eval). Leave empty to use defaults.";
         };
     };
     readonly "mcp.enableProjectConfig": {
@@ -3915,6 +3979,16 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "worktree.base": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly group: "Isolation";
+            readonly label: "Worktree Base Directory";
+            readonly description: "Base directory for agent-managed worktrees — task-isolation copies, `github` PR checkouts, and `omp worktree` cleanup all live here. Unset uses ~/.omp/wt. Must be an absolute or ~-relative path; relative paths are ignored. The OMP_WORKTREE_DIR env var overrides this.";
+        };
+    };
     readonly "task.eager": {
         readonly type: "enum";
         readonly values: readonly ["default", "preferred", "always"];
@@ -4275,6 +4349,10 @@ export declare const SETTINGS_SCHEMA: {
                 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";
@@ -4283,6 +4361,10 @@ export declare const SETTINGS_SCHEMA: {
                 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";
@@ -4295,6 +4377,10 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "tavily";
                 readonly label: "Tavily";
                 readonly description: "Requires TAVILY_API_KEY";
+            }, {
+                readonly value: "firecrawl";
+                readonly label: "Firecrawl";
+                readonly description: "Requires FIRECRAWL_API_KEY";
             }, {
                 readonly value: "brave";
                 readonly label: "Brave";
@@ -4315,6 +4401,10 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "searxng";
                 readonly label: "SearXNG";
                 readonly description: "Requires SEARXNG_ENDPOINT or searxng.endpoint";
+            }, {
+                readonly value: "duckduckgo";
+                readonly label: "DuckDuckGo";
+                readonly description: "Uses DuckDuckGo Instant Answer API (no API key)";
             }];
         };
     };
@@ -5062,6 +5152,30 @@ export declare const SETTINGS_SCHEMA: {
         readonly values: readonly ["unset", "granted", "denied"];
         readonly default: "unset";
     };
+    readonly "gc.blobs": {
+        readonly type: "boolean";
+        readonly default: true;
+    };
+    readonly "gc.archive": {
+        readonly type: "boolean";
+        readonly default: true;
+    };
+    readonly "gc.wal": {
+        readonly type: "boolean";
+        readonly default: true;
+    };
+    readonly "gc.coldArchiveAfterDays": {
+        readonly type: "number";
+        readonly default: 30;
+    };
+    readonly "gc.retainNewestGlobal": {
+        readonly type: "number";
+        readonly default: 20;
+    };
+    readonly "gc.retainNewestPerCwd": {
+        readonly type: "number";
+        readonly default: 10;
+    };
     readonly "thinkingBudgets.minimal": {
         readonly type: "number";
         readonly default: 1024;
@@ -5133,6 +5247,7 @@ export interface CompactionSettings {
     thresholdTokens: number;
     reserveTokens: number;
     keepRecentTokens: number;
+    midTurnEnabled: boolean;
     handoffSaveToDisk: boolean;
     autoContinue: boolean;
     remoteEnabled: boolean;
@@ -5262,6 +5377,14 @@ export interface CodexResetsSettings {
     minBlockedMinutes: number;
     keepCredits: number;
 }
+export interface GcSettings {
+    blobs: boolean;
+    archive: boolean;
+    wal: boolean;
+    coldArchiveAfterDays: number;
+    retainNewestGlobal: number;
+    retainNewestPerCwd: number;
+}
 /** Map group prefix -> typed settings interface */
 export interface GroupTypeMap {
     compaction: CompactionSettings;
@@ -5281,6 +5404,7 @@ export interface GroupTypeMap {
     cycleOrder: string[];
     shellMinimizer: ShellMinimizerSettings;
     codexResets: CodexResetsSettings;
+    gc: GcSettings;
 }
 export type GroupPrefix = keyof GroupTypeMap;
 export {};

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

@@ -28,11 +28,15 @@ export interface SettingsOptions {
     agentDir?: string;
     /** Don't persist to disk (for tests) */
     inMemory?: boolean;
+    /** Read config sources without opening storage or writing migrations */
+    readOnly?: boolean;
     /** Initial overrides */
     overrides?: Partial<Record<SettingPath, unknown>>;
     /** Extra config.yml-style overlays loaded after global/project settings */
     configFiles?: string[];
 }
+export declare function normalizeProviderMaxInFlightRequests(value: unknown): Record<string, number>;
+export declare function validateProviderMaxInFlightRequests(value: unknown): Record<string, number>;
 export declare class Settings {
     #private;
     private constructor();
@@ -41,6 +45,15 @@ export declare class Settings {
      * Call once at startup before accessing `settings`.
      */
     static init(options?: SettingsOptions): Promise<Settings>;
+    /**
+     * Load effective settings from config.yml and project providers without
+     * opening agent.db, migrating legacy settings, or writing marker files.
+     */
+    static loadReadOnly(options?: SettingsOptions): Promise<Settings>;
+    /**
+     * Load a persisted settings instance without touching the global singleton.
+     */
+    static loadIsolated(options?: SettingsOptions): Promise<Settings>;
     /**
      * Create an isolated instance for testing.
      * Does not affect the global singleton.

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

@@ -1,5 +1,5 @@
 import type { DapAdapterConfig, DapResolvedAdapter } from "./types";
-export declare function getAdapterConfigs(): Record<string, DapAdapterConfig>;
+export declare function getAdapterConfigs(cwd?: string): Record<string, DapAdapterConfig>;
 export declare function resolveAdapter(adapterName: string, cwd: string): DapResolvedAdapter | null;
 export declare function getAvailableAdapters(cwd: string): DapResolvedAdapter[];
 export declare function selectLaunchAdapter(program: string, cwd: string, adapterName?: string, programKind?: LaunchProgramKind): DapResolvedAdapter | null;

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

@@ -1,4 +1,4 @@
-import { Filesystem, type WriteResult } from "@oh-my-pi/hashline";
+import { Filesystem, type PreflightWriteOptions, type WriteResult } from "@oh-my-pi/hashline";
 import type { FileDiagnosticsResult, WritethroughCallback, WritethroughDeferredHandle } from "../../lsp";
 import type { ToolSession } from "../../tools";
 import type { LspBatchRequest } from "../renderer";
@@ -34,7 +34,9 @@ export declare class HashlineFilesystem extends Filesystem {
     canonicalPath(relativePath: string): string;
     allowTagPathRecovery(authoredPath: string, resolvedPath: string): boolean;
     readText(relativePath: string): Promise<string>;
-    preflightWrite(relativePath: string): Promise<void>;
+    preflightWrite(relativePath: string, options?: PreflightWriteOptions): Promise<void>;
+    delete(relativePath: string): Promise<void>;
+    move(fromRelative: string, toRelative: string, content?: string): Promise<void>;
     writeText(relativePath: string, content: string): Promise<WriteResult>;
     exists(relativePath: string): Promise<boolean>;
 }

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

@@ -29,6 +29,8 @@ export interface EditToolPerFileResult {
     oldText?: string;
     /** Source-of-truth content after the edit; `undefined` for delete operations. */
     newText?: string;
+    /** Pre-move source path; set only when the edit moved/renamed the file. The header renders `sourcePath → path`. */
+    sourcePath?: string;
 }
 export interface EditToolDetails {
     /** Unified diff of the changes made */
@@ -51,6 +53,8 @@ export interface EditToolDetails {
     oldText?: string;
     /** Source-of-truth content after the edit; `undefined` for delete operations. */
     newText?: string;
+    /** Pre-move source path; set only when the edit moved/renamed the file. The header renders `sourcePath → path`. */
+    sourcePath?: string;
 }
 interface EditRenderArgs {
     path?: string;

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

@@ -28,7 +28,7 @@ import type { Theme } from "../../modes/theme/theme";
 import type { CompactMode } from "../../session/compact-modes";
 import type { CustomMessage } from "../../session/messages";
 import type { ReadonlySessionManager, SessionManager } from "../../session/session-manager";
-import type { BashToolDetails, BashToolInput, FindToolDetails, FindToolInput, ReadToolDetails, ReadToolInput, SearchToolDetails, SearchToolInput, WriteToolInput } from "../../tools";
+import type { BashToolDetails, BashToolInput, GlobToolDetails, GlobToolInput, GrepToolDetails, GrepToolInput, ReadToolDetails, ReadToolInput, WriteToolInput } from "../../tools";
 import type { ApprovalMode } from "../../tools/approval";
 import type { EventBus } from "../../utils/event-bus";
 import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, GoalUpdatedEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionStopEvent, SessionStopEventResult, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
@@ -468,20 +468,20 @@ export interface WriteToolCallEvent extends ToolCallEventBase {
     toolName: "write";
     input: WriteToolInput;
 }
-export interface SearchToolCallEvent extends ToolCallEventBase {
-    toolName: "search";
-    input: SearchToolInput;
+export interface GrepToolCallEvent extends ToolCallEventBase {
+    toolName: "grep";
+    input: GrepToolInput;
 }
-export interface FindToolCallEvent extends ToolCallEventBase {
-    toolName: "find";
-    input: FindToolInput;
+export interface GlobToolCallEvent extends ToolCallEventBase {
+    toolName: "glob";
+    input: GlobToolInput;
 }
 export interface CustomToolCallEvent extends ToolCallEventBase {
     toolName: string;
     input: Record<string, unknown>;
 }
 /** Fired before a tool executes. Can block. */
-export type ToolCallEvent = BashToolCallEvent | ReadToolCallEvent | EditToolCallEvent | WriteToolCallEvent | SearchToolCallEvent | FindToolCallEvent | CustomToolCallEvent;
+export type ToolCallEvent = BashToolCallEvent | ReadToolCallEvent | EditToolCallEvent | WriteToolCallEvent | GrepToolCallEvent | GlobToolCallEvent | CustomToolCallEvent;
 interface ToolResultEventBase {
     type: "tool_result";
     toolCallId: string;
@@ -505,20 +505,20 @@ export interface WriteToolResultEvent extends ToolResultEventBase {
     toolName: "write";
     details: undefined;
 }
-export interface SearchToolResultEvent extends ToolResultEventBase {
-    toolName: "search";
-    details: SearchToolDetails | undefined;
+export interface GrepToolResultEvent extends ToolResultEventBase {
+    toolName: "grep";
+    details: GrepToolDetails | undefined;
 }
-export interface FindToolResultEvent extends ToolResultEventBase {
-    toolName: "find";
-    details: FindToolDetails | undefined;
+export interface GlobToolResultEvent extends ToolResultEventBase {
+    toolName: "glob";
+    details: GlobToolDetails | undefined;
 }
 export interface CustomToolResultEvent extends ToolResultEventBase {
     toolName: string;
     details: unknown;
 }
 /** Fired after a tool executes. Can modify result. */
-export type ToolResultEvent = BashToolResultEvent | ReadToolResultEvent | EditToolResultEvent | WriteToolResultEvent | SearchToolResultEvent | FindToolResultEvent | CustomToolResultEvent;
+export type ToolResultEvent = BashToolResultEvent | ReadToolResultEvent | EditToolResultEvent | WriteToolResultEvent | GrepToolResultEvent | GlobToolResultEvent | CustomToolResultEvent;
 /**
  * Type guard for narrowing ToolCallEvent by tool name.
  *
@@ -543,8 +543,8 @@ export declare function isToolCallEventType(toolName: "bash", event: ToolCallEve
 export declare function isToolCallEventType(toolName: "read", event: ToolCallEvent): event is ReadToolCallEvent;
 export declare function isToolCallEventType(toolName: "edit", event: ToolCallEvent): event is EditToolCallEvent;
 export declare function isToolCallEventType(toolName: "write", event: ToolCallEvent): event is WriteToolCallEvent;
-export declare function isToolCallEventType(toolName: "search", event: ToolCallEvent): event is SearchToolCallEvent;
-export declare function isToolCallEventType(toolName: "find", event: ToolCallEvent): event is FindToolCallEvent;
+export declare function isToolCallEventType(toolName: "grep", event: ToolCallEvent): event is GrepToolCallEvent;
+export declare function isToolCallEventType(toolName: "glob", event: ToolCallEvent): event is GlobToolCallEvent;
 export declare function isToolCallEventType<TName extends string, TInput extends Record<string, unknown>>(toolName: TName, event: ToolCallEvent): event is ToolCallEvent & {
     toolName: TName;
     input: TInput;

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

@@ -10,7 +10,7 @@ import type * as PiCodingAgent from "../../index";
 import type { Theme } from "../../modes/theme/theme";
 import type { HookMessage } from "../../session/messages";
 import type { ReadonlySessionManager, SessionManager } from "../../session/session-manager";
-import type { BashToolDetails, FindToolDetails, ReadToolDetails, SearchToolDetails } from "../../tools";
+import type { BashToolDetails, GlobToolDetails, GrepToolDetails, ReadToolDetails } from "../../tools";
 import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
 import type * as TypeBox from "../typebox";
 export type { ExecOptions, ExecResult } from "../../exec/exec";
@@ -254,15 +254,15 @@ export interface WriteToolResultEvent extends ToolResultEventBase {
     toolName: "write";
     details: undefined;
 }
-/** Tool result event for search tool */
-export interface SearchToolResultEvent extends ToolResultEventBase {
-    toolName: "search";
-    details: SearchToolDetails | undefined;
+/** Tool result event for grep tool */
+export interface GrepToolResultEvent extends ToolResultEventBase {
+    toolName: "grep";
+    details: GrepToolDetails | undefined;
 }
-/** Tool result event for find tool */
-export interface FindToolResultEvent extends ToolResultEventBase {
-    toolName: "find";
-    details: FindToolDetails | undefined;
+/** Tool result event for glob tool */
+export interface GlobToolResultEvent extends ToolResultEventBase {
+    toolName: "glob";
+    details: GlobToolDetails | undefined;
 }
 /** Tool result event for custom/unknown tools */
 export interface CustomToolResultEvent extends ToolResultEventBase {
@@ -274,7 +274,7 @@ export interface CustomToolResultEvent extends ToolResultEventBase {
  * Fired after a tool is executed. Hooks can modify the result.
  * Use toolName to discriminate and get typed details.
  */
-export type ToolResultEvent = BashToolResultEvent | ReadToolResultEvent | EditToolResultEvent | WriteToolResultEvent | SearchToolResultEvent | FindToolResultEvent | CustomToolResultEvent;
+export type ToolResultEvent = BashToolResultEvent | ReadToolResultEvent | EditToolResultEvent | WriteToolResultEvent | GrepToolResultEvent | GlobToolResultEvent | CustomToolResultEvent;
 /**
  * Union of all hook event types.
  */

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

@@ -55,6 +55,7 @@ export interface MarketplacePluginEntry {
     hooks?: string | Record<string, unknown>;
     mcpServers?: string | Record<string, unknown>;
     lspServers?: string | Record<string, unknown>;
+    dapAdapters?: string | Record<string, unknown>;
 }
 export type PluginSource = string | PluginSourceGitHub | PluginSourceUrl | PluginSourceGitSubdir | PluginSourceNpm;
 export interface PluginSourceGitHub {

package/dist/types/internal-urls/__tests__/ssh-protocol.test.d.ts

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

package/dist/types/internal-urls/index.d.ts

@@ -20,5 +20,6 @@ export * from "./parse";
 export * from "./router";
 export * from "./rule-protocol";
 export * from "./skill-protocol";
+export * from "./ssh-protocol";
 export type * from "./types";
 export * from "./vault-protocol";

package/dist/types/internal-urls/registry-helpers.d.ts

@@ -1,3 +1,5 @@
+export declare function registerArtifactsDir(dir: string): () => void;
+export declare function resetRegisteredArtifactDirsForTests(): void;
 /**
  * Snapshot of artifacts dirs for every registered session, deduped.
  *

package/dist/types/internal-urls/router.d.ts

@@ -16,6 +16,6 @@ export declare class InternalUrlRouter {
      * Candidate completions for the host/path portion of `scheme://<query>`.
      * Returns `null` when the scheme is unknown or does not support completion.
      */
-    complete(scheme: string, query: string): Promise<UrlCompletion[] | null>;
+    complete(scheme: string, query: string, context?: ResolveContext): Promise<UrlCompletion[] | null>;
     resolve(input: string, context?: ResolveContext): Promise<InternalResource>;
 }

package/dist/types/internal-urls/ssh-protocol.d.ts

@@ -0,0 +1,10 @@
+import type { InternalResource, InternalUrl, ProtocolHandler, ResolveContext, UrlCompletion, WriteContext } from "./types";
+export declare class SshProtocolHandler implements ProtocolHandler {
+    #private;
+    readonly scheme = "ssh";
+    readonly immutable = false;
+    resolve(url: InternalUrl, context?: ResolveContext): Promise<InternalResource>;
+    /** Autocomplete the host segment of `ssh://` with the configured SSH hosts. */
+    complete(_query?: string, context?: ResolveContext): Promise<UrlCompletion[]>;
+    write(url: InternalUrl, content: string, context?: WriteContext): Promise<void>;
+}

package/dist/types/internal-urls/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Types for the internal URL routing system.
  *
- * Internal URLs (`agent://`, `artifact://`, `history://`, `issue://`, `local://`, `mcp://`, `memory://`, `omp://`, `pr://`, `rule://`, `skill://`, and `vault://`) are resolved by tools like read,
+ * Internal URLs (`agent://`, `artifact://`, `history://`, `issue://`, `local://`, `mcp://`, `memory://`, `omp://`, `pr://`, `rule://`, `skill://`, `ssh://`, and `vault://`) are resolved by tools like read,
  * providing access to agent outputs and server resources without exposing filesystem paths.
  */
 import type { Skill } from "../extensibility/skills";
@@ -31,6 +31,13 @@ export interface InternalResource {
      * resources. Mutable resources (e.g. local://) behave like editable files.
      */
     immutable?: boolean;
+    /**
+     * True when the resource is a directory listing rather than file content.
+     * `search` refuses to grep such a resource when it has no `sourcePath` — a
+     * remote `ssh://` listing has no local path to recurse, so its listing text
+     * must never be mistaken for the directory's contents.
+     */
+    isDirectory?: boolean;
 }
 /**
  * A single autocomplete candidate for the host/path portion of a `scheme://`
@@ -88,6 +95,13 @@ export interface ResolveContext {
     localProtocolOptions?: LocalProtocolOptions;
     /** Calling session's loaded skills. Prefer this over process-global skill state. */
     skills?: readonly Skill[];
+    /**
+     * When set, handlers that would otherwise materialize an expensive directory
+     * listing (e.g. the ssh:// handler draining a full remote `ls`) instead return
+     * the directory shape (`isDirectory: true`) with empty content. `search`/`find`
+     * reject directory resources, so they never need the listing.
+     */
+    skipDirectoryListing?: boolean;
 }
 /**
  * Caller context for write operations dispatched to host-owned URI handlers.
@@ -143,6 +157,9 @@ export interface ProtocolHandler {
      * mcp://) omit it. The caller fuzzy-filters the returned set against the
      * partially typed `query`, so handlers return their full (bounded) candidate
      * list; `query` is provided only so handlers can scope expensive enumeration.
+     * `context.cwd`/`context.localProtocolOptions` carry the caller's working dir
+     * and session, for handlers whose candidates are project- or session-scoped
+     * (e.g. ssh:// hosts from a project `ssh.json`, local:// roots per session).
      */
-    complete?(query: string): Promise<UrlCompletion[]>;
+    complete?(query?: string, context?: ResolveContext): Promise<UrlCompletion[]>;
 }

package/dist/types/irc/bus.d.ts

@@ -55,9 +55,15 @@ export declare class IrcBus {
      * disabled — e.g. blocked in a synchronous task spawn awaiting the
      * sender's own batch) can generate an ephemeral side-channel auto-reply
      * instead of stranding the sender until timeout.
+     *
+     * `opts.suppressRelay` skips the display-only main-UI relay for this leg.
+     * Set by broadcast fan-out when the same broadcast also targets the main
+     * agent directly: the main agent then already sees the body as its own
+     * incoming card, so relaying the sibling legs would duplicate it.
      */
     send(msg: Omit<IrcMessage, "id" | "ts">, opts?: {
         expectsReply?: boolean;
+        suppressRelay?: boolean;
     }): Promise<IrcDeliveryReceipt>;
     /**
      * Block until a message for `agentId` (optionally from `filter.from`)