@myagentroam/node 0.13.3 → 0.13.4

package/dist/connection/direct-transfer-service.js

@@ -26,7 +26,10 @@ export class DirectTransferService {
     disposed = false;
     static async create(options) {
         const range = options.udpPortRange?.() ?? { begin: 49_152, end: 49_215 };
-        const createIceUdpMuxListener = options.createIceUdpMuxListener ?? ((port) => new NativeIceUdpMuxListener(port));
+        const createIceUdpMuxListener = options.createIceUdpMuxListener ??
+            ((port) => new NativeIceUdpMuxListener(port, process.platform === 'win32' && process.env['MAR_QUICK_START_OWNER'] === '1'
+                ? '0.0.0.0'
+                : undefined));
         // Windows can accept an IPv6 mux bind while another IPv4 endpoint owns the port.
         const probe = options.probeUdp4Port ?? (process.platform === 'win32' ? probeUdp4Port : undefined);
         const listener = await bindIceUdpMuxListener(range, createIceUdpMuxListener, probe);

package/dist/hosting/hosted-conversation-node-service.js

@@ -874,13 +874,15 @@ export class HostedConversationNodeService {
 function hostedRequest(raw) {
     if (!record(raw))
         throw new Error('HOSTED_CONVERSATION_NOT_AUTHORIZED');
-    const { __usageGrant, __requestUserId, __template, __marAgentModel, __marAgentModels, __marAgentCompact, __marAgentRuntimeScopeId, __workspaceWatchSessionHash, __templateDeleted, __sourceTemplateId, ...data } = raw;
+    const { __usageGrant, __requestUserId, __template, __marAgentModel, __marAgentModels, __marAgentCompact, __marAgentRuntimeScopeId, __searchBackendAvailable, __workspaceWatchSessionHash, __templateDeleted, __sourceTemplateId, ...data } = raw;
     if (typeof __requestUserId !== 'number' ||
         !Number.isSafeInteger(__requestUserId) ||
         __requestUserId <= 0)
         throw new Error('HOSTED_CONVERSATION_NOT_AUTHORIZED');
     if (__templateDeleted !== undefined && __templateDeleted !== true)
         throw new Error('HOSTED_CONVERSATION_NOT_AUTHORIZED');
+    if (__searchBackendAvailable !== undefined && typeof __searchBackendAvailable !== 'boolean')
+        throw new Error('HOSTED_CONVERSATION_NOT_AUTHORIZED');
     if (__sourceTemplateId !== undefined &&
         (typeof __sourceTemplateId !== 'string' || __sourceTemplateId.length === 0))
         throw new Error('HOSTED_CONVERSATION_NOT_AUTHORIZED');
@@ -889,6 +891,9 @@ function hostedRequest(raw) {
         throw new Error('HOSTED_CONVERSATION_NOT_AUTHORIZED');
     return {
         data,
+        ...(__searchBackendAvailable === undefined
+            ? {}
+            : { searchBackendAvailable: __searchBackendAvailable }),
         ...(__sourceTemplateId === undefined ? {} : { sourceTemplateId: __sourceTemplateId }),
         ...(__usageGrant === undefined
             ? {}

package/dist/hosting/hosted-conversation-runs.js

@@ -140,6 +140,9 @@ export class HostedConversationRuns {
             access: 'full-access',
             modelId: selected.id,
             models: networkModels(allowedModels(version, models), version.draft.networkMode),
+            ...(payload.searchBackendAvailable === undefined
+                ? {}
+                : { searchBackendAvailable: payload.searchBackendAvailable }),
             ...(payload.compact === undefined ? {} : { compact: payload.compact }),
             ...(payload.runtimeScopeId === undefined ? {} : { runtimeScopeId: payload.runtimeScopeId }),
             systemInstruction: systemInstruction(version, generatedImagesLogicalPath),

package/dist/main.js

@@ -18,6 +18,23 @@ const browserPath = readOption(args, '--browser-cache');
 if (browserPath !== undefined)
     process.env['PLAYWRIGHT_BROWSERS_PATH'] = browserPath;
 if (command === 'run') {
+    let earlyQuickStop = false;
+    let quickStop;
+    process.on('message', (message) => {
+        if (typeof message !== 'object' ||
+            message === null ||
+            !('type' in message) ||
+            message.type !== 'node-quick-start-stop')
+            return;
+        earlyQuickStop = true;
+        quickStop?.();
+    });
+    if (process.env['MAR_QUICK_START_OWNER'] === '1') {
+        process.once('disconnect', () => {
+            earlyQuickStop = true;
+            quickStop?.();
+        });
+    }
     const nodeConfig = await loadNodeConfig(config);
     let releaseOwner;
     try {
@@ -59,7 +76,7 @@ if (command === 'run') {
         });
     };
     const supervisorHandoff = new SupervisorUpgradeHandoff();
-    const supportsProgress = await supervisorHandoff.handshake();
+    const supportsProgress = process.env['MAR_QUICK_START_OWNER'] !== '1' && (await supervisorHandoff.handshake());
     if (!supportsProgress)
         supervisorHandoff.close();
     connector = new NodeConnector({
@@ -71,8 +88,12 @@ if (command === 'run') {
     for (const signal of ['SIGINT', 'SIGTERM']) {
         process.on(signal, () => shutdown());
     }
+    quickStop = () => shutdown();
     try {
-        await connector.start();
+        if (earlyQuickStop)
+            shutdown();
+        else
+            await connector.start();
     }
     catch (error) {
         nodeLog('node.start.failed', { code: safeErrorCode(error, 'NODE_START_FAILED') });

package/dist/marctl/package.json

@@ -1 +1 @@
-{"type":"module","version":"0.13.3"}
+{"type":"module","version":"0.13.4"}

package/dist/runner/mar-agent/execution-input.js

@@ -4,7 +4,8 @@ export function captureMarAgentExecutionInput(input) {
         model: input.marAgentModel,
         models: input.marAgentModels,
         compact: input.marAgentCompact,
-        runtimeScopeId: input.marAgentRuntimeScopeId
+        runtimeScopeId: input.marAgentRuntimeScopeId,
+        searchBackendAvailable: input.searchBackendAvailable
     });
 }
 /** Only the MAR boundary understands either the wire input or its captured form. */
@@ -24,6 +25,7 @@ export function resolveMarAgentExecutionInput(input, modelId) {
         model: parsed.data,
         models: resolveRunModels(parsed.data, input?.models),
         compact: input?.compact,
+        searchBackendAvailable: input?.searchBackendAvailable !== false,
         ...(typeof input?.runtimeScopeId === 'string' ? { runtimeScopeId: input.runtimeScopeId } : {})
     };
 }

package/dist/runner/mar-agent/hosted-conversation-runtime.js

@@ -346,6 +346,9 @@ export class MarAgentHostedConversationRuntime {
             const webAccess = 'webAccess' in input && input.webAccess;
             const extensions = combineExecutionExtensions(imageExtensions, createWebToolsExtensions({
                 enabled: webAccess,
+                ...('searchBackendAvailable' in input && input.searchBackendAvailable !== undefined
+                    ? { searchBackendAvailable: input.searchBackendAvailable }
+                    : {}),
                 hostedSearchModelIds: models
                     .filter((model) => model.hostedWebSearch)
                     .map((model) => model.id),

package/dist/runner/mar-agent/managed-run-controller.js

@@ -323,6 +323,9 @@ export class MarAgentManagedRunController {
             });
             const extensions = combineExecutionExtensions(imageExtensions, createWebToolsExtensions({
                 enabled: true,
+                ...(input.searchBackendAvailable === undefined
+                    ? {}
+                    : { searchBackendAvailable: input.searchBackendAvailable }),
                 hostedSearchModelIds: executionModels
                     .filter((model) => model.hostedWebSearch)
                     .map((model) => model.id),

package/dist/runner/mar-agent/web-tools-extensions.js

@@ -39,7 +39,9 @@ export const webFetchToolDefinition = {
 export function createWebToolsExtensions(input) {
     const tools = input.enabled
         ? [
-            ...((input.hostedSearchModelIds !== undefined || !input.hostedWebSearch) && input.webSearch
+            ...(input.searchBackendAvailable !== false &&
+                (input.hostedSearchModelIds !== undefined || !input.hostedWebSearch) &&
+                input.webSearch
                 ? [webSearchToolDefinition]
                 : []),
             ...(input.webFetch ? [webFetchToolDefinition] : [])

package/dist/service/agent-network-invoke.js

@@ -47,7 +47,10 @@ export function executionAgentActor(input) {
             marAgentModel: captured.model,
             marAgentModels: captured.models,
             marAgentCompact: captured.compact,
-            marAgentRuntimeScopeId: captured.runtimeScopeId
+            marAgentRuntimeScopeId: captured.runtimeScopeId,
+            ...(typeof captured.searchBackendAvailable === 'boolean'
+                ? { searchBackendAvailable: captured.searchBackendAvailable }
+                : {})
         }
     };
 }
@@ -120,7 +123,10 @@ export function agentNetworkExecutionCommand(input) {
                     marAgentModel: data.marAgentModel,
                     marAgentModels: data.marAgentModels,
                     marAgentCompact: data.marAgentCompact,
-                    marAgentRuntimeScopeId: data.marAgentRuntimeScopeId
+                    marAgentRuntimeScopeId: data.marAgentRuntimeScopeId,
+                    ...(typeof data.searchBackendAvailable === 'boolean'
+                        ? { searchBackendAvailable: data.searchBackendAvailable }
+                        : {})
                 },
                 ...(usageGrant.success ? { usageGrant: usageGrant.data } : {}),
                 ...(typeof data.personalInstructions === 'string'
@@ -159,7 +165,10 @@ export function agentNetworkExecutionCommand(input) {
                     marAgentModel: resources.marAgentModel,
                     marAgentModels: resources.marAgentModels,
                     marAgentCompact: resources.marAgentCompact,
-                    marAgentRuntimeScopeId: resources.marAgentRuntimeScopeId
+                    marAgentRuntimeScopeId: resources.marAgentRuntimeScopeId,
+                    ...(typeof resources.searchBackendAvailable === 'boolean'
+                        ? { searchBackendAvailable: resources.searchBackendAvailable }
+                        : {})
                 }
             };
         return invokeAgentNetwork(input.service, boundActor, data.action, data.input, undefined, data.__requestAbortSignal instanceof AbortSignal ? data.__requestAbortSignal : undefined);

package/dist/service/node-upgrade-coordinator.js

@@ -37,6 +37,8 @@ export class NodeUpgradeCoordinator {
         }
     }
     request(data) {
+        if (process.env['MAR_QUICK_START_OWNER'] === '1')
+            throw new Error('NODE_UPGRADE_UNAVAILABLE');
         const input = record(data);
         const targetVersion = input.targetVersion;
         if (typeof targetVersion !== 'string' || !STABLE_VERSION.test(targetVersion))

package/dist/service/supervised-node-child.js

@@ -1,18 +1,22 @@
 import { spawn } from 'node:child_process';
 import { terminateProcessTree } from '../process-tree.js';
 /** Wait for the child process itself, not inherited output handles held by descendants. */
-export function runSupervisedNodeChild(entrypoint, configPath, accept, accepted, upgradeAttemptId) {
+export function runSupervisedNodeChild(entrypoint, configPath, accept, accepted, upgradeAttemptId, stopSignal) {
     return new Promise((resolve) => {
         const child = spawn(process.execPath, [entrypoint, 'run', '--config', configPath], {
             windowsHide: true,
             stdio: ['inherit', 'inherit', 'inherit', 'ipc'],
             env: {
                 ...process.env,
-                MAR_NODE_SUPERVISED: '1',
+                MAR_NODE_SUPERVISED: process.env['MAR_QUICK_START_OWNER'] === '1' ? '0' : '1',
                 ...(upgradeAttemptId === undefined ? {} : { MAR_NODE_UPGRADE_ATTEMPT_ID: upgradeAttemptId })
             },
             detached: process.platform !== 'win32'
         });
+        if (process.env['MAR_QUICK_START_OWNER'] === '1' &&
+            child.pid !== undefined &&
+            process.connected)
+            process.send?.({ type: 'node-quick-start-child', pid: child.pid }, () => { });
         let done = false;
         let signalled = false;
         let channelId;
@@ -34,6 +38,7 @@ export function runSupervisedNodeChild(entrypoint, configPath, accept, accepted,
                 clearTimeout(reapDeadline);
             process.off('SIGINT', onSigint);
             process.off('SIGTERM', onSigterm);
+            stopSignal?.removeEventListener('abort', onQuickStop);
             if (child.connected)
                 child.disconnect();
             if (reclaimFailed)
@@ -54,21 +59,61 @@ export function runSupervisedNodeChild(entrypoint, configPath, accept, accepted,
         };
         const onSigint = () => forward('SIGINT');
         const onSigterm = () => forward('SIGTERM');
+        const onQuickStop = () => {
+            if (done || signalled)
+                return;
+            signalled = true;
+            if (deadline !== undefined)
+                clearTimeout(deadline);
+            send(child, { type: 'node-quick-start-stop' });
+            deadline = setTimeout(() => {
+                forced = true;
+                reclaiming = true;
+                reapDeadline = setTimeout(() => finish(null, true), 10_000);
+                void terminateProcessTree(child)
+                    .then(() => {
+                    reclaimed = true;
+                    if (exited !== undefined)
+                        finish(exited.code);
+                })
+                    .catch(() => finish(null, true));
+                if (process.platform !== 'win32' && child.pid !== undefined) {
+                    try {
+                        process.kill(-child.pid, 'SIGKILL');
+                    }
+                    catch {
+                        child.kill('SIGKILL');
+                    }
+                }
+            }, 30_000);
+        };
         process.on('SIGINT', onSigint);
         process.on('SIGTERM', onSigterm);
+        stopSignal?.addEventListener('abort', onQuickStop, { once: true });
+        if (stopSignal?.aborted)
+            onQuickStop();
         child.on('error', () => {
             if (child.pid === undefined)
                 finish(null);
         });
         child.once('exit', (code) => {
+            if (process.env['MAR_QUICK_START_OWNER'] === '1' &&
+                child.pid !== undefined &&
+                process.connected)
+                process.send?.({ type: 'node-quick-start-child-exited', pid: child.pid }, () => { });
             exited = { code };
             if (!reclaiming || reclaimed)
                 finish(code);
         });
         child.on('message', (message) => {
-            if (done || signalled || typeof message !== 'object' || message === null)
+            if (done || typeof message !== 'object' || message === null)
                 return;
             const value = message;
+            if (signalled) {
+                if (stopSignal?.aborted && value['type'] === 'node-upgrade-hello')
+                    send(child, { type: 'node-quick-start-stop' });
+                return;
+            }
             if (value['type'] === 'node-upgrade-hello' &&
                 channelId === undefined &&
                 typeof value['channelId'] === 'string') {

package/dist/supervisor.js

@@ -12,16 +12,50 @@ import { terminateProcessTree } from './process-tree.js';
 const UPGRADE_EXIT_CODE = 75;
 const STABLE_VERSION = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u;
 export async function superviseNode(configPath, bootstrapEntrypoint) {
+    const stop = new AbortController();
+    let ownerDisconnected = false;
+    const onMessage = (message) => {
+        if (typeof message === 'object' &&
+            message !== null &&
+            'type' in message &&
+            message.type === 'node-quick-start-stop')
+            stop.abort();
+    };
+    process.on('message', onMessage);
+    const onOwnerDisconnect = () => {
+        ownerDisconnected = true;
+        process.exitCode = 1;
+        stop.abort();
+    };
+    if (process.env['MAR_QUICK_START_OWNER'] === '1')
+        process.once('disconnect', onOwnerDisconnect);
+    try {
+        await superviseNodeUntilStopped(configPath, bootstrapEntrypoint, stop.signal);
+    }
+    finally {
+        if (ownerDisconnected)
+            process.exitCode = 1;
+        process.off('message', onMessage);
+        process.off('disconnect', onOwnerDisconnect);
+    }
+}
+async function superviseNodeUntilStopped(configPath, bootstrapEntrypoint, stopSignal) {
     const config = await loadNodeConfig(configPath);
     const dataDirectory = dirname(nodeDatabasePath(config, configPath));
     const activePath = resolve(dataDirectory, 'node-active-entrypoint');
-    let entrypoint = await readActiveEntrypoint(activePath, bootstrapEntrypoint);
+    let entrypoint = process.env['MAR_QUICK_START_OWNER'] === '1'
+        ? bootstrapEntrypoint
+        : await readActiveEntrypoint(activePath, bootstrapEntrypoint);
     let reporter;
     let awaitingOnline;
     for (;;) {
+        if (stopSignal.aborted)
+            return;
         const requestPath = nodeUpgradeRequestPath(nodeDatabasePath(config, configPath));
         let reportingIdentity;
         const childResult = await runSupervisedNodeChild(entrypoint, configPath, async (handoff) => {
+            if (process.env['MAR_QUICK_START_OWNER'] === '1')
+                return false;
             const currentConfig = await loadNodeConfig(configPath);
             if (currentConfig.nodeId === undefined ||
                 !STABLE_VERSION.test(handoff.targetVersion) ||
@@ -42,12 +76,15 @@ export async function superviseNode(configPath, bootstrapEntrypoint) {
             reporter?.stop();
             reporter = next;
             next.update({ attemptId: handoff.attemptId, step: 'CLOSING_NODE' });
-        }, awaitingOnline);
+        }, awaitingOnline, stopSignal);
         if (childResult.signalled) {
             reporter?.stop();
-            process.exitCode = childResult.code ?? 1;
+            process.exitCode =
+                childResult.forced || childResult.reclaimFailed ? 1 : (childResult.code ?? 1);
             return;
         }
+        if (stopSignal.aborted)
+            return;
         if (childResult.reclaimFailed) {
             if (childResult.handoff !== undefined)
                 await reporter?.finish({
@@ -90,6 +127,11 @@ export async function superviseNode(configPath, bootstrapEntrypoint) {
             process.exitCode = code;
             return;
         }
+        if (process.env['MAR_QUICK_START_OWNER'] === '1' &&
+            (code === UPGRADE_EXIT_CODE || childResult.handoff !== undefined)) {
+            process.exitCode = 1;
+            return;
+        }
         if (code !== UPGRADE_EXIT_CODE && childResult.handoff === undefined) {
             if (code === 0)
                 return;
@@ -110,7 +152,7 @@ export async function superviseNode(configPath, bootstrapEntrypoint) {
                 !STABLE_VERSION.test(targetVersion))
                 throw new Error('NODE_UPGRADE_REQUEST_INVALID');
             const prefix = resolve(dataDirectory, 'node-versions', targetVersion);
-            const installDeadline = Date.now() + 15 * 60_000;
+            const installDeadline = Date.now() + 20 * 60_000;
             if (childResult.handoff !== undefined)
                 reporter?.update({ attemptId: childResult.handoff.attemptId, step: 'INSTALLING' });
             failureStage = 'PREPARE_INSTALL_DIRECTORY';
@@ -126,7 +168,7 @@ export async function superviseNode(configPath, bootstrapEntrypoint) {
                 `@myagentroam/node@${targetVersion}`
             ]);
             failureStage = 'NPM_INSTALL';
-            const installResult = await runProcess(invocation.command, invocation.args, false, installDeadline);
+            const installResult = await runProcess(invocation.command, invocation.args, false, installDeadline, stopSignal);
             failureExitCode = installResult.code;
             if (installResult.reclaimFailed) {
                 installReclaimFailed = true;
@@ -144,7 +186,7 @@ export async function superviseNode(configPath, bootstrapEntrypoint) {
             const rebuild = platformCliInvocation('npm', ['rebuild', '--prefix', prefix, 'node-pty']);
             failureStage = 'NATIVE_REBUILD';
             failureExitCode = undefined;
-            const rebuildResult = await runProcess(rebuild.command, rebuild.args, false, installDeadline);
+            const rebuildResult = await runProcess(rebuild.command, rebuild.args, false, installDeadline, stopSignal);
             failureExitCode = rebuildResult.code;
             if (rebuildResult.reclaimFailed) {
                 installReclaimFailed = true;
@@ -163,7 +205,7 @@ export async function superviseNode(configPath, bootstrapEntrypoint) {
             failureExitCode = undefined;
             const browserInstall = await runProcess(process.execPath, [
                 resolve(prefix, 'node_modules', '@myagentroam', 'node', 'scripts', 'install-web-browser.mjs')
-            ], true, installDeadline);
+            ], true, installDeadline, stopSignal);
             failureExitCode = browserInstall.code;
             if (browserInstall.reclaimFailed) {
                 installReclaimFailed = true;
@@ -243,11 +285,16 @@ export async function superviseNode(configPath, bootstrapEntrypoint) {
                 code: 'NODE_UPGRADE_REQUEST_CLEANUP_FAILED'
             });
         }
-        if (stopping)
+        if (stopping) {
+            if (stopSignal.aborted)
+                process.exitCode = 1;
             return;
+        }
     }
 }
-async function runProcess(command, args, inherit, deadlineAt) {
+async function runProcess(command, args, inherit, deadlineAt, stopSignal) {
+    if (stopSignal.aborted)
+        return { code: null, signalled: true, timedOut: false, reclaimFailed: false };
     return new Promise((resolveProcess) => {
         const child = spawn(command, args, {
             windowsHide: true,
@@ -293,6 +340,28 @@ async function runProcess(command, args, inherit, deadlineAt) {
         };
         const onSigint = () => forward('SIGINT');
         const onSigterm = () => forward('SIGTERM');
+        const onQuickStop = () => {
+            if (signalled || settled)
+                return;
+            signalled = true;
+            timedOut = true;
+            reapDeadline = setTimeout(() => finish(null, true), 10_000);
+            void terminateProcessTree(child)
+                .then(() => {
+                reclaimed = true;
+                if (exited !== undefined)
+                    finish(exited.code);
+            })
+                .catch(() => finish(null, true));
+            if (process.platform !== 'win32' && child.pid !== undefined) {
+                try {
+                    process.kill(-child.pid, 'SIGKILL');
+                }
+                catch {
+                    child.kill('SIGKILL');
+                }
+            }
+        };
         const finish = (code, reclaimFailed = false) => {
             if (settled)
                 return;
@@ -302,12 +371,16 @@ async function runProcess(command, args, inherit, deadlineAt) {
                 clearTimeout(reapDeadline);
             process.off('SIGINT', onSigint);
             process.off('SIGTERM', onSigterm);
+            stopSignal.removeEventListener('abort', onQuickStop);
             if (reclaimFailed)
                 child.unref();
             resolveProcess({ code, signalled, timedOut, reclaimFailed });
         };
         process.on('SIGINT', onSigint);
         process.on('SIGTERM', onSigterm);
+        stopSignal.addEventListener('abort', onQuickStop, { once: true });
+        if (stopSignal.aborted)
+            onQuickStop();
         child.on('error', () => {
             if (child.pid === undefined)
                 finish(null);

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.13.3",
+  "version": "0.13.4",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/myagentroam/mar.git",
+    "directory": "mar-node"
+  },
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -32,7 +37,7 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.3.233",
     "@modelcontextprotocol/sdk": "1.32.0",
-    "@myagentroam/binaries": "0.10.1",
+    "@myagentroam/binaries": "0.10.2",
     "@opencode-ai/sdk": "1.18.20",
     "minimatch": "^10.2.6",
     "node-datachannel": "0.33.4",
@@ -44,14 +49,14 @@
     "turndown-plugin-gfm": "^1.0.2",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/agent": "0.13.3",
-    "@myagentroam/protocol": "0.13.3"
+    "@myagentroam/agent": "0.13.4",
+    "@myagentroam/protocol": "0.13.4"
   },
   "devDependencies": {
     "@types/turndown": "^5.0.6",
     "@types/ws": "^8.18.1",
-    "@myagentroam/code-navigation": "0.11.1",
-    "@myagentroam/marctl": "0.13.3"
+    "@myagentroam/marctl": "0.13.4",
+    "@myagentroam/code-navigation": "0.11.1"
   },
   "exports": {
     "./config": {

package/scripts/install-web-browser.mjs

@@ -25,15 +25,12 @@ export async function installWebBrowser(options = {}) {
   }
   const require = createRequire(import.meta.url);
   const cli = resolve(dirname(require.resolve('playwright/package.json')), 'cli.js');
-  const run =
-    options.run ??
-    ((command, args) =>
-      spawnSync(command, args, {
-        stdio: 'inherit',
-        env: environment,
-        timeout: 300_000
-      }));
-  const result = run(process.execPath, [cli, 'install', 'chromium', '--no-shell']);
+  const run = options.run ?? spawnSync;
+  const result = run(process.execPath, [cli, 'install', 'chromium', '--no-shell'], {
+    stdio: 'inherit',
+    env: environment,
+    timeout: 12 * 60_000
+  });
   if (result.error || result.signal || result.status !== 0)
     throw new Error(
       'NODE_WEB_BROWSER_INSTALL_FAILED: Chromium download failed. Check network access or preinstall the matching Playwright Chromium runtime.'