@oh-my-pi/pi-coding-agent 17.2.4 → 17.2.6

package/dist/types/config/service-tier.d.ts

@@ -13,6 +13,8 @@ export declare const SERVICE_TIER_GOOGLE_VALUES: readonly ["none", "flex", "prio
 export type ServiceTierOpenAISettingValue = (typeof SERVICE_TIER_OPENAI_VALUES)[number];
 export type ServiceTierAnthropicSettingValue = (typeof SERVICE_TIER_ANTHROPIC_VALUES)[number];
 export type ServiceTierGoogleSettingValue = (typeof SERVICE_TIER_GOOGLE_VALUES)[number];
+/** Whether a runtime value is a supported OpenAI service-tier setting. */
+export declare function isServiceTierOpenAISettingValue(value: string): value is ServiceTierOpenAISettingValue;
 /** Whether a runtime value names a provider family with an independent service-tier knob. */
 export declare function isServiceTierFamily(value: unknown): value is ServiceTierFamily;
 /** Whether a runtime value is a supported service tier for one provider family. */

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

@@ -924,6 +924,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Reveal assistant text and streamed tool input smoothly while chunks arrive";
         };
     };
+    readonly "display.hideToolActivity": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly group: "Display";
+            readonly label: "Hide Tool Activity";
+            readonly description: "Hide model-initiated tool calls and results from the transcript";
+        };
+    };
     readonly "display.showTokenUsage": {
         readonly type: "boolean";
         readonly default: false;
@@ -3499,6 +3509,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Start language servers on first use (lsp tool or editing a matching file type) instead of at session startup";
         };
     };
+    readonly "lsp.shared": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "files";
+            readonly group: "LSP";
+            readonly label: "Shared Language Servers";
+            readonly description: "Share one language server per project across omp instances via the daemon broker (falls back to private servers when unavailable)";
+        };
+    };
     readonly "lsp.formatOnWrite": {
         readonly type: "boolean";
         readonly default: false;
@@ -3994,25 +4014,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly tab: "tools";
             readonly group: "Available Tools";
             readonly label: "Computer";
-            readonly description: "Enable native host-desktop screenshots and input for OpenAI computer use";
-        };
-    };
-    readonly "computer.backend": {
-        readonly type: "enum";
-        readonly values: readonly ["auto", "native"];
-        readonly default: "auto";
-        readonly ui: {
-            readonly tab: "tools";
-            readonly group: "Computer";
-            readonly label: "Computer Backend";
-            readonly description: "Select automatic or explicit platform-native desktop capture and input";
-            readonly options: readonly [{
-                readonly value: "auto";
-                readonly label: "Auto";
-            }, {
-                readonly value: "native";
-                readonly label: "Native";
-            }];
+            readonly description: "Enable the scriptable host-desktop control tool (screenshots, input, accessibility)";
         };
     };
     readonly "computer.display": {
@@ -4027,7 +4029,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "computer.maxWidth": {
         readonly type: "number";
-        readonly default: 1920;
+        readonly default: 3840;
         readonly ui: {
             readonly tab: "tools";
             readonly group: "Computer";
@@ -4037,7 +4039,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "computer.maxHeight": {
         readonly type: "number";
-        readonly default: 1200;
+        readonly default: 2400;
         readonly ui: {
             readonly tab: "tools";
             readonly group: "Computer";
@@ -4191,6 +4193,26 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Default HTTP CDP discovery endpoint (for example http://127.0.0.1:9222) to attach to instead of launching a browser. Explicit app.cdp_url or app.path on the tool call take precedence.";
         };
     };
+    readonly "browser.relay": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Grep & Browser";
+            readonly label: "Browser Relay";
+            readonly description: "Drive your own Chrome tabs through the omp browser relay. Install the extension once (`omp browser-relay install`); the relay server auto-starts when the browser tool needs it. Takes precedence over Browser CDP URL; set PI_BROWSER_RELAY=0 or PI_BROWSER_RELAY=1 to override.";
+        };
+    };
+    readonly "browser.relayUrl": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Grep & Browser";
+            readonly label: "Browser Relay URL";
+            readonly description: "omp browser relay endpoint (default http://127.0.0.1:9224).";
+        };
+    };
     readonly "browser.headless": {
         readonly type: "boolean";
         readonly default: true;
@@ -5186,6 +5208,32 @@ export declare const SETTINGS_SCHEMA: {
             })[];
         };
     };
+    readonly "providers.webSearchTimeoutSeconds": {
+        readonly type: "number";
+        readonly default: 60;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Web Search Timeout";
+            readonly description: "Hard timeout for each provider's search transport before web_search advances to the next fallback, in seconds (maximum 300)";
+            readonly options: readonly [{
+                readonly value: "30";
+                readonly label: "30 seconds";
+            }, {
+                readonly value: "60";
+                readonly label: "1 minute";
+            }, {
+                readonly value: "120";
+                readonly label: "2 minutes";
+            }, {
+                readonly value: "180";
+                readonly label: "3 minutes";
+            }, {
+                readonly value: "300";
+                readonly label: "5 minutes";
+            }];
+        };
+    };
     readonly "providers.webSearchGeminiModel": {
         readonly type: "string";
         readonly default: undefined;

package/dist/types/cursor-bridge-tools.d.ts

@@ -25,7 +25,7 @@ export declare function createBridgeGrepFactory(session: ToolSession, extensionR
 /**
  * Build the `replace`-mode `edit` the bridge answers `pi_edit` with.
  *
- * `PiEditExecArgs` carries `old_text`/`new_text` pairs, which is exactly
+ * `PiEditExecArgs` carries `old_string`/`new_string` replacements, which is exactly
  * `replace`'s schema and nothing else's. The session's own instance follows the
  * configured `edit.mode` — `hashline` by default, whose schema is a single
  * `input` string — so a frame handed that instance fails validation instead of

package/dist/types/cursor.d.ts

@@ -38,7 +38,7 @@ interface CursorExecBridgeOptions {
      *
      * `PiEditExecArgs` is that mode's schema verbatim, and the session's own
      * `edit` may be in any mode — `hashline` by default — whose schema rejects
-     * `old_text`/`new_text` outright. {@link tools} therefore cannot be trusted
+     * `old_string`/`new_string` outright. {@link tools} therefore cannot be trusted
      * for this one frame: a session that starts on another provider keeps its
      * configured instance in the map (only Cursor sessions move `edit` out), and
      * switching to Cursor later does not rebuild the roster.
@@ -150,9 +150,12 @@ export declare class CursorExecHandlers implements ICursorExecHandlers {
     piRead(call: Parameters<NonNullable<ICursorExecHandlers["piRead"]>>[0]): Promise<ToolResultMessage<unknown>>;
     piBash(call: Parameters<NonNullable<ICursorExecHandlers["piBash"]>>[0]): Promise<ToolResultMessage<unknown>>;
     /**
-     * `PiEditExecArgs` is the local `edit` tool's replace mode verbatim: a path
-     * plus `old_text`/`new_text` pairs. The tool's schema is snake_case, so the
-     * proto's camelCase accessors are mapped back on the way in.
+     * `PiEditExecArgs` carries a path plus `oldText`/`newText` replacement
+     * pairs. A single replacement maps onto the model-facing single-edit
+     * `replace` schema verbatim; a multi-replacement frame still runs as ONE
+     * tool lifecycle (one start/end event pair, one aggregate diff), so it is
+     * sent in the tool's internal `edits` batch form (`ReplaceBatchParams`),
+     * which only this bridge produces.
      *
      * The replace-mode instance is requested explicitly rather than resolved
      * from {@link CursorExecBridgeOptions.tools}: the registry's `edit` is in

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

@@ -5,7 +5,7 @@ import { type EditMode } from "../utils/edit-mode.js";
 import { hashlineEditParamsSchema } from "./hashline/index.js";
 import { type ApplyPatchParams, applyPatchSchema } from "./modes/apply-patch.js";
 import { type PatchParams, patchEditSchema } from "./modes/patch.js";
-import { type ReplaceParams, replaceEditSchema } from "./modes/replace.js";
+import { type ReplaceBatchParams, type ReplaceParams, replaceEditSchema } from "./modes/replace.js";
 import { type EditToolDetails } from "./renderer.js";
 export * from "@oh-my-pi/hashline";
 export { DEFAULT_EDIT_MODE, type EditMode, normalizeEditMode } from "../utils/edit-mode.js";
@@ -22,7 +22,7 @@ export * from "./snapshot-details.js";
 export * from "./streaming.js";
 type TInput = typeof replaceEditSchema | typeof patchEditSchema | typeof hashlineEditParamsSchema | typeof applyPatchSchema;
 type HashlineParams = typeof hashlineEditParamsSchema.infer;
-type EditParams = ReplaceParams | PatchParams | HashlineParams | ApplyPatchParams;
+type EditParams = ReplaceParams | ReplaceBatchParams | PatchParams | HashlineParams | ApplyPatchParams;
 export declare class EditTool implements AgentTool<TInput> {
     #private;
     private readonly session;
@@ -36,7 +36,7 @@ export declare class EditTool implements AgentTool<TInput> {
     /**
      * `mode` pins the edit variant for this instance, for callers whose protocol
      * fixes the shape of an edit. The Cursor `pi_edit` frame carries
-     * `old_text`/`new_text` pairs, which only `replace` accepts — under the
+     * `old_string`/`new_string` args, which only `replace` accepts — under the
      * default `hashline` mode those args do not match the schema at all. Left
      * unset, the env/settings resolution applies as before.
      */

package/dist/types/edit/modes/replace.d.ts

@@ -67,11 +67,15 @@ export declare function levenshteinDistance(a: string, b: string): number;
 export declare function similarity(a: string, b: string): number;
 /**
  * Find a match for target text within content.
- * Used primarily for replace-mode edits.
+ * Used primarily for replace-mode edits; excluded ranges remain invisible to exact and fuzzy matching.
  */
 export declare function findMatch(content: string, target: string, options: {
     allowFuzzy: boolean;
     threshold?: number;
+    excludedRanges?: readonly {
+        startIndex: number;
+        endIndex: number;
+    }[];
 }): MatchOutcome;
 /**
  * Find a sequence of pattern lines within content lines.
@@ -112,25 +116,28 @@ export declare function findContextLine(lines: string[], context: string, startF
     allowFuzzy?: boolean;
     skipFunctionFallback?: boolean;
 }): ContextLineResult;
-export declare const replaceEditEntrySchema: import("arktype/internal/variants/object.ts").ObjectType<{
-    old_text: string;
-    new_text: string;
-    all?: boolean | undefined;
-}, {}>;
 export declare const replaceEditSchema: import("arktype/internal/variants/object.ts").ObjectType<{
     path: string;
-    edits: {
-        old_text: string;
-        new_text: string;
-        all?: boolean | undefined;
-    }[];
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
 }, {}>;
-export type ReplaceEditEntry = typeof replaceEditEntrySchema.infer;
 export type ReplaceParams = typeof replaceEditSchema.infer;
-export interface ExecuteReplaceSingleOptions {
+/**
+ * Internal batch form of {@link ReplaceParams}, produced only by the Cursor
+ * exec bridge: a `pi_edit` frame carries several replacements against one
+ * path but must run as a single tool lifecycle with one aggregate result.
+ * Never advertised to the model — the agent loop validates model calls
+ * against {@link replaceEditSchema}, which has no `edits` field.
+ */
+export interface ReplaceBatchParams {
+    path: string;
+    edits: Omit<ReplaceParams, "path">[];
+}
+export interface ExecuteReplaceOptions {
     session: ToolSession;
     path: string;
-    params: ReplaceEditEntry;
+    params: Omit<ReplaceParams, "path">;
     signal?: AbortSignal;
     batchRequest?: LspBatchRequest;
     allowFuzzy: boolean;
@@ -138,4 +145,4 @@ export interface ExecuteReplaceSingleOptions {
     writethrough: WritethroughCallback;
     beginDeferredDiagnosticsForPath: (path: string) => WritethroughDeferredHandle;
 }
-export declare function executeReplaceSingle(options: ExecuteReplaceSingleOptions): Promise<AgentToolResult<EditToolDetails, ReplaceEditEntry>>;
+export declare function executeReplace(options: ExecuteReplaceOptions): Promise<AgentToolResult<EditToolDetails, ReplaceParams>>;

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

@@ -68,7 +68,7 @@ interface EditRenderArgs {
     patch?: string;
     input?: string;
     _input?: string;
-    all?: boolean;
+    replace_all?: boolean;
     op?: Operation;
     rename?: unknown;
     diff?: string;

package/dist/types/eval/py/kernel.d.ts

@@ -10,7 +10,9 @@ export interface PythonKernelAvailability {
     /** The probed-working runtime, when one was found. */
     runtime?: PythonRuntime;
 }
-export declare function checkPythonKernelAvailability(cwd: string, interpreter?: string): Promise<PythonKernelAvailability>;
+export declare function checkPythonKernelAvailability(cwd: string, interpreter?: string, options?: {
+    forceProbe?: boolean;
+}): Promise<PythonKernelAvailability>;
 export declare class PythonKernel extends BaseKernel {
     private constructor();
     static start(options: KernelStartOptions): Promise<PythonKernel>;

package/dist/types/eval/py/spawn-options.d.ts

@@ -37,16 +37,16 @@ export declare function shouldHideKernelWindow(opts: {
  */
 export declare function shouldDetachKernel(platform: NodeJS.Platform): boolean;
 /**
- * TTY-based fallback used when the Win32 console probe is unavailable.
+ * Combine native Win32 and stdio TTY evidence of an inheritable console.
  *
- * Returns `true` if any of stdin/stdout/stderr is currently a TTY. This
- * correctly detects the common interactive launches and the partial-
- * redirection cases (`omp -p > out.txt`, `< in.txt`, `2> err.log`) where at
- * least one stream stays bound to the terminal. The all-stdio-redirected
- * case (`< in > out 2> err` from a console) is the reason we prefer the
- * Win32 probe over this fallback whenever possible.
+ * `GetConsoleWindow()` detects classic consoles even when every stdio stream
+ * is redirected. TTY detection covers ConPTY-backed terminals, where compiled
+ * hosts can receive a null HWND despite being attached to Windows Terminal.
+ * Either signal must preserve console inheritance: `CREATE_NO_WINDOW` can
+ * deadlock NumPy native-extension loading in the Python child.
  */
-export declare function consoleAttachedViaTTY(opts: {
+export declare function consoleAttached(opts: {
+    nativeConsole?: boolean | null;
     stdinIsTTY: boolean;
     stdoutIsTTY: boolean;
     stderrIsTTY: boolean;
@@ -56,13 +56,9 @@ export declare function __resetWindowsConsoleProbeCache(): void;
 /**
  * Whether the host process owns a console its children can inherit.
  *
- * - On Windows, the authoritative signal is `GetConsoleWindow()`. It returns
- *   a non-NULL HWND whenever the process has a console attached, regardless
- *   of how the standard streams are redirected — so an `omp -p ... < in.txt
- *   > out.txt 2> err.log` launched from a real Windows Terminal session is
- *   correctly classified as console-attached and the kernel keeps its
- *   inheritable console.
- * - On any other platform, or if the FFI probe fails, fall back to the
- *   TTY-OR heuristic. That still catches the common interactive cases.
+ * On Windows, `GetConsoleWindow()` detects classic consoles and all-stdio-
+ * redirected launches while stdio TTYs detect ConPTY-backed terminals. Either
+ * signal is sufficient. Other platforms use the same TTY evidence, although
+ * `windowsHide` is a no-op there.
  */
 export declare function hostHasInheritableConsole(): boolean;

package/dist/types/extensibility/legacy-pi-ai-shim.d.ts

@@ -19,7 +19,7 @@
  * `types.ts` via the `export *` below — pi-ai still exports both as types,
  * only the runtime `Type` builder and `StringEnum()` helper were removed.
  */
-import type { Api, AssistantMessage, Model } from "@oh-my-pi/pi-ai";
+import { type Api, type AssistantMessage, type AssistantMessageEventStream, type Context, type Model, type SimpleStreamOptions } from "@oh-my-pi/pi-ai";
 import type { Effort } from "@oh-my-pi/pi-catalog/effort";
 import { calculateCost, getBundledModel, getBundledModels, getBundledProviders, modelsAreEqual } from "@oh-my-pi/pi-catalog/models";
 import { type TSchema, Type } from "./typebox.js";
@@ -54,6 +54,13 @@ export * from "@oh-my-pi/pi-ai";
 export { calculateCost, getBundledModel, getBundledModels, getBundledProviders, modelsAreEqual, Type };
 export declare const getModel: typeof getBundledModel;
 export declare const getModels: typeof getBundledModels;
+/**
+ * Stream OpenAI Responses through the historical simple-options contract.
+ *
+ * Legacy `/compat` callers pass {@link SimpleStreamOptions}; routing through
+ * `streamSimple` preserves option normalization before provider dispatch.
+ */
+export declare function streamSimpleOpenAIResponses(model: Model<"openai-responses">, context: Context, options?: SimpleStreamOptions): AssistantMessageEventStream;
 /**
  * Compatibility re-exports for runtime helpers that upstream
  * `@earendil-works/pi-ai` exposed from its package root but omp's

package/dist/types/extensibility/legacy-pi-coding-agent-shim.d.ts

@@ -398,7 +398,7 @@ export { getProjectDir } from "@oh-my-pi/pi-utils";
  * canonical helper.
  */
 export declare function getPackageDir(): string;
-export { compact, estimateTokens } from "@oh-my-pi/pi-agent-core/compaction";
+export { compact, estimateTokens, serializeConversation } from "@oh-my-pi/pi-agent-core/compaction";
 export { CONFIG_DIR_NAME } from "@oh-my-pi/pi-utils";
 export { parseArgs } from "../cli/args.js";
 export * from "../index.js";

package/dist/types/extensibility/plugins/legacy-pi-compat.d.ts

@@ -71,6 +71,8 @@ export declare function __rewriteLegacyExtensionSourceForTests(source: string, i
  * no-op.
  */
 export declare function ensureGraphCommonJsRequireRegistered(): void;
+/** Test seam for compiled-binary dependency graph discovery and rewriting. */
+export declare function __collectLegacyPiExtensionSourcesForTests(entryPath: string): Promise<ReadonlyMap<string, string>>;
 /**
  * Load a legacy Pi extension module from its real on-disk location.
  *

package/dist/types/launch/broker.d.ts

@@ -1,2 +1,2 @@
-/** Start the detached per-project daemon broker selected by the CLI worker host. */
+/** Start the detached project or global daemon broker selected by the CLI worker host. */
 export declare function startDaemonBrokerFromEnvironment(): Promise<void>;

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

@@ -1,4 +1,4 @@
-import { type DaemonOperation, type DaemonRpcResult } from "./protocol.js";
+import { type DaemonCompletionNotification, type DaemonOperation, type DaemonRpcResult } from "./protocol.js";
 /** Broker location and lifecycle overrides used by smoke tests and isolated consumers. */
 export interface DaemonBrokerClientOptions {
     /** Runtime directory override; defaults to the project-scoped config path. */
@@ -6,17 +6,28 @@ export interface DaemonBrokerClientOptions {
     /** Last-client shutdown grace override in milliseconds. */
     idleGraceMs?: number;
 }
-/** Persistent per-process connection to one project's daemon broker. */
+export interface DaemonCompletionUnregisterOptions {
+    /** Detach this process without deleting broker-persisted pending notifications. */
+    preservePending?: boolean;
+}
+/** Persistent per-process connection to one project or global daemon broker. */
 export interface DaemonBrokerClient {
+    onCompletion(owner: string, sink: (notification: DaemonCompletionNotification) => Promise<void> | void): (options?: DaemonCompletionUnregisterOptions) => void;
+    /** Canonical project directory or synthetic directory identifying a global scope. */
     readonly projectDir: string;
     request(operation: DaemonOperation, signal?: AbortSignal): Promise<DaemonRpcResult>;
     close(): void;
 }
-/** Create an independent socket connection to one project's shared daemon broker. */
+/** A request reached the broker and the broker rejected the operation. */
+export declare class DaemonBrokerRejectedError extends Error {
+}
+/** Create an independent socket connection to one daemon broker scope. */
 export declare function createDaemonBrokerClient(projectDir: string, options?: DaemonBrokerClientOptions): Promise<DaemonBrokerClient>;
 /** Get the process-shared daemon broker client for one canonical project directory. */
 export declare function daemonClientForProject(projectDir: string): Promise<DaemonBrokerClient>;
-/** Close every project broker connection held by this omp process. */
+/** Get the process-shared client that leases one profile-independent, machine-global daemon broker. */
+export declare function daemonClientForGlobal(service: string): Promise<DaemonBrokerClient>;
+/** Close every project and machine-global broker connection held by this omp process. */
 export declare function closeDaemonClients(): Promise<void>;
 /** Exercise worker-host broker startup and authenticated RPC for distribution smoke tests. */
 export declare function smokeTestDaemonBroker(): Promise<void>;

package/dist/types/launch/ensure.d.ts

@@ -0,0 +1,8 @@
+import type { DaemonBrokerClient } from "./client.js";
+import type { DaemonSnapshot } from "./protocol.js";
+/** Snapshot a broker daemon, treating "unknown daemon" and broker errors as absent. */
+export declare function describeQuietly(client: DaemonBrokerClient, name: string, label: string, signal?: AbortSignal): Promise<DaemonSnapshot | undefined>;
+/** Block until the daemon reports ready; undefined on timeout or pre-ready exit. */
+export declare function waitReady(client: DaemonBrokerClient, name: string, label: string, signal?: AbortSignal, timeoutMs?: number): Promise<DaemonSnapshot | undefined>;
+/** Best-effort stop before replacing a wedged or endpoint-less daemon. */
+export declare function stopQuietly(client: DaemonBrokerClient, name: string, label: string, signal?: AbortSignal): Promise<void>;

package/dist/types/launch/paths.d.ts

@@ -1,5 +1,5 @@
 import { getDaemonRuntimeDir } from "@oh-my-pi/pi-utils";
 /** Resolve the private runtime directory shared by omp processes in one project directory. */
 export { getDaemonRuntimeDir as daemonRuntimeDir };
-/** Resolve the Unix socket or Windows named pipe used by one project broker. */
+/** Resolve the Unix socket or Windows named pipe used by one daemon broker scope. */
 export declare function daemonBrokerEndpoint(projectDir: string, runtimeDir: string): string;

package/dist/types/launch/protocol.d.ts

@@ -6,7 +6,7 @@ export declare const DAEMON_BROKER_WORKER_ARG = "__omp_worker_daemon_broker";
 /** Fixed dimensions negotiated with every supervised PTY. */
 export declare const DAEMON_PTY_COLUMNS = 120;
 export declare const DAEMON_PTY_ROWS = 40;
-/** Environment key carrying the broker's canonical project directory. */
+/** Environment key carrying the broker's canonical project or synthetic global scope directory. */
 export declare const DAEMON_PROJECT_DIR_ENV = "OMP_DAEMON_PROJECT_DIR";
 /** Environment key carrying the broker's private runtime directory. */
 export declare const DAEMON_RUNTIME_DIR_ENV = "OMP_DAEMON_RUNTIME_DIR";
@@ -36,7 +36,7 @@ export interface DaemonSpec {
     persist: boolean;
     detached: boolean;
 }
-/** Serializable daemon state visible to every client in one project directory. */
+/** Serializable daemon state visible to every client in one broker scope. */
 export interface DaemonSnapshot {
     name: string;
     id: string;
@@ -150,6 +150,13 @@ export type DaemonRpcResult = {
 export interface DaemonWireRequest {
     id: string;
     token: string;
+    owners?: string[];
+    detachedOwners?: string[];
+    completionEvents?: boolean;
+    completionAcks?: string[];
+    completionUnsubscribes?: string[];
+    completionReplays?: string[];
+    completionSubscriptionId?: string;
     operation: DaemonOperation;
 }
 /** Response envelope kept raw until matched with its pending operation. */
@@ -162,6 +169,14 @@ export type DaemonWireResponse = {
     ok: false;
     error: string;
 };
+/** Unsolicited terminal completion sent to the socket that owns a daemon. */
+export interface DaemonCompletionNotification {
+    event: "daemon-completed";
+    completionId: string;
+    owner: string;
+    daemon: DaemonSnapshot;
+}
+export type DaemonWireMessage = DaemonWireResponse | DaemonCompletionNotification;
 /** Decode and validate a daemon launch specification. */
 export declare function parseDaemonSpec(value: unknown): DaemonSpec;
 /** Decode and validate one daemon snapshot. */
@@ -170,5 +185,7 @@ export declare function parseDaemonSnapshot(value: unknown): DaemonSnapshot;
 export declare function parseDaemonWireRequest(value: unknown): DaemonWireRequest;
 /** Decode a socket response envelope before resolving a pending call. */
 export declare function parseDaemonWireResponse(value: unknown): DaemonWireResponse;
+/** Decode one broker response or unsolicited completion notification. */
+export declare function parseDaemonWireMessage(value: unknown): DaemonWireMessage;
 /** Decode a broker result using its pending operation as the discriminator. */
 export declare function parseDaemonRpcResult(operation: DaemonOperation, value: unknown): DaemonRpcResult;

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

@@ -1,4 +1,6 @@
 import type { LspClient, ServerConfig } from "./types.js";
+/** Enable or disable attaching to broker-shared language servers. */
+export declare function setSharedLspEnabled(enabled: boolean): void;
 /**
  * Configure the idle timeout for LSP clients.
  * @param ms - Timeout in milliseconds, or null/undefined to disable

package/dist/types/lsp/mux/daemon.d.ts

@@ -0,0 +1,15 @@
+import type { LspTransport } from "../types.js";
+/**
+ * Open a broker-shared transport for one language server, ensuring the mux
+ * daemon first. Returns null (after a debug log) when the shared path is
+ * unavailable so the caller falls back to a process-local spawn.
+ */
+export declare function connectSharedLspTransport(opts: {
+    command: string;
+    args: string[];
+    cwd: string;
+    env?: Record<string, string>;
+    signal?: AbortSignal;
+}): Promise<LspTransport | null>;
+/** Exercise worker-host mux startup and the ping handshake for distribution smoke tests. */
+export declare function smokeTestLspMux(): Promise<void>;

package/dist/types/lsp/mux/protocol.d.ts

@@ -0,0 +1,57 @@
+/** Hidden CLI selector used to re-enter the LSP mux worker. */
+export declare const LSP_MUX_WORKER_ARG = "__omp_worker_lsp_mux";
+/** Environment key carrying the socket endpoint the mux must listen on. */
+export declare const LSP_MUX_SOCKET_ENV = "OMP_LSP_MUX_SOCKET";
+/** Environment key carrying the canonical project directory the mux serves. */
+export declare const LSP_MUX_PROJECT_DIR_ENV = "OMP_LSP_MUX_PROJECT_DIR";
+/** Stable broker daemon name for the shared LSP mux. */
+export declare const LSP_MUX_DAEMON_NAME = "omp.lsp.mux";
+/** Broker readiness regex matched against the banner printed by the worker. */
+export declare const LSP_MUX_READY_PATTERN: string;
+/** Banner printed on stdout once the mux socket accepts connections. */
+export declare function lspMuxReadyBanner(endpoint: string): string;
+/** Resolve the Unix socket or Windows named pipe for one project scope. */
+export declare function lspMuxEndpoint(projectDir: string, runtimeDir: string): string;
+/**
+ * First (and only pre-LSP) request on a fresh connection: binds the link to
+ * one shared server instance, spawning it on first use. Params:
+ * {@link MuxConnectParams}, result: {@link MuxConnectResult}. After the
+ * response the link carries ordinary LSP traffic for that server.
+ */
+export declare const MUX_CONNECT_METHOD = "omp/muxConnect";
+/**
+ * Liveness probe answered with {@link MUX_PING_RESULT} without binding the
+ * link to a server. Used by the smoke probe and the ensure loop.
+ */
+export declare const MUX_PING_METHOD = "omp/muxPing";
+export declare const MUX_PING_RESULT = "pong";
+/**
+ * Notification on a bound link: kill the shared server process (all sessions
+ * on it are disconnected). Sent by `lsp reload` when the generic reload path
+ * decides the server is wedged — a plain per-session `shutdown`/`exit` is
+ * intercepted by the mux and would leave the wedged server running for
+ * every other instance.
+ */
+export declare const MUX_RESTART_METHOD = "omp/muxRestartServer";
+/** Handshake parameters identifying (and if needed spawning) a shared server. */
+export interface MuxConnectParams {
+    /** Executable to spawn (the client's `resolvedCommand ?? command`). */
+    command: string;
+    /** Arguments passed verbatim to the executable. */
+    args: string[];
+    /** Workspace root the server runs in; part of the server identity key. */
+    cwd: string;
+    /** Extra environment overlaid on the mux daemon's own env for the spawn. */
+    env?: Record<string, string>;
+}
+/** Handshake result. */
+export interface MuxConnectResult {
+    /** Server identity key inside the mux (`${command}:${cwd}`). */
+    key: string;
+    /** True when this handshake spawned the server process. */
+    spawned: boolean;
+    /** Pid of the shared server process. */
+    pid?: number;
+}
+/** Server identity key used by the mux registry. */
+export declare function muxServerKey(command: string, cwd: string): string;

package/dist/types/lsp/mux/server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Broker-owned, in-process-testable multiplexer for shared language-server children.
+ */
+export declare class LspMuxServer {
+    #private;
+    /** Called after the mux has had no connected sessions for its idle grace period. */
+    onIdle?: () => void;
+    /** Number of currently connected mux links, including unbound ping links. */
+    get sessionCount(): number;
+    /** Keys of currently live shared language-server children. */
+    get serverKeys(): string[];
+    /** Listen for Content-Length framed mux links at a Unix socket or named pipe. */
+    listen(endpoint: string): Promise<void>;
+    /** Gracefully close all children, links, and the listening endpoint. */
+    shutdown(): Promise<void>;
+}
+/** Start the detached LSP mux selected by the CLI worker host environment. */
+export declare function startLspMuxFromEnvironment(): Promise<void>;