@phnx-labs/agents-cli 1.22.117 → 1.22.118

package/dist/lib/browser/drivers/ssh.js

@@ -1,467 +0,0 @@
-import { spawn, execFileSync } from 'child_process';
-import * as net from 'net';
-import { CDPClient, discoverBrowserWsUrl, verifyBrowserIdentity } from '../cdp.js';
-import { getPortOccupant } from '../chrome.js';
-import { parseEndpointUrl } from '../profiles.js';
-import { writeProfileRuntime, clearProfileRuntime } from '../runtime-state.js';
-// shellQuote lives in the shared ssh-exec helper (single choke point); re-export
-// so existing importers of `shellQuote` from this module keep working.
-import { shellQuote, assertValidSshTarget, controlOpts, sshConnectOpts } from '../../ssh-exec.js';
-export { shellQuote };
-// The `ssh -L` tunnel spawn is shared with `agents computer --device`; it lives in
-// the single ssh-tunnel helper. Calling it with no options preserves this
-// driver's original foreground, stderr-captured behavior exactly.
-import { startSSHTunnel } from '../../ssh-tunnel.js';
-import { encodePwshBase64 } from '../../pwsh.js';
-/** Lifecycle for a registry-driven tunnel vs a profile the daemon launched. */
-export function persistRemoteLifecycle(persistRemote) {
-    return persistRemote
-        ? { launchRemote: false, killOnCleanup: false }
-        : { launchRemote: true, killOnCleanup: true };
-}
-export async function connectSSH(endpoint, profile, 
-/**
- * Runtime key (`<profile>@<device>`) this connection is stored under. It
- * keys the tunnel's runtime record; `profile.name` is the bare, user-facing
- * name and appears only in messages (RUSH-2709).
- */
-key, opts = {}) {
-    const url = new URL(endpoint);
-    if (url.protocol !== 'ssh:') {
-        throw new Error(`Invalid SSH endpoint: ${endpoint}`);
-    }
-    const user = url.username || process.env.USER || 'root';
-    // Use the shared parser so the documented `ssh://host?port=N` form works
-    // identically to `ssh://host:N`. Previously `url.port` alone meant every
-    // `?port=`-style profile silently fell back to 9222.
-    const parsed = parseEndpointUrl(endpoint);
-    if (!parsed) {
-        throw new Error(`Could not extract host:port from SSH endpoint: ${endpoint}`);
-    }
-    const host = parsed.host;
-    const remotePort = parsed.port;
-    // `&os=windows` switches the remote-command dialect (cmd.exe launch via
-    // `start`, taskkill teardown). Anything else — including absent — is posix.
-    // The query param is the single source of truth so the driver never has to
-    // be threaded a separate per-profile field.
-    const remoteOs = (url.searchParams.get('os') || '').toLowerCase() === 'windows' ? 'windows' : 'posix';
-    // Bind the tunnel to the SAME local port the user configured. Using an
-    // allocated port instead made `status` print confusing rows like
-    // `port 9200 (configured 10005)` and made it impossible to predict which
-    // local port a profile would land on. Now `ssh://host?port=N` => local N.
-    const localPort = remotePort;
-    // Preflight: if the local port is busy with something that isn't our
-    // own SSH tunnel for this very target, bail with a clear error. Letting
-    // ssh -L race ahead would either silently succeed (binding to a second
-    // port via fail-safe) or fail with cryptic stderr.
-    const occupant = getPortOccupant(localPort);
-    if (occupant && !isOwnTunnel(occupant.pid, host, remotePort)) {
-        throw new Error(`Local port ${localPort} (needed for SSH tunnel to ${host}:${remotePort}) ` +
-            `is already in use by ${occupant.command} (pid ${occupant.pid}). ` +
-            `Either kill that process (\`kill ${occupant.pid}\`) or change the profile's port.`);
-    }
-    // A non-zero remote exit (missing exe, auth failure, bad launch) now rejects
-    // with the captured stderr and propagates. An already-running browser exits 0
-    // (the launch backgrounds/WMI-spawns regardless), so this does not spuriously
-    // fail the reconnect path — only genuine launch failures reach the caller
-    // instead of being swallowed and mis-reported later as a tunnel timeout.
-    //
-    // persistRemote skips the launch: launching would mint a logged-out
-    // `--user-data-dir=/tmp/agents-browser-N` under a name that means a
-    // credentialed browser on the declaring device.
-    const lifecycle = persistRemoteLifecycle(Boolean(opts.persistRemote));
-    if (lifecycle.launchRemote) {
-        await ensureRemoteBrowser(user, host, profile.browser, remotePort, remoteOs, profile.binary);
-    }
-    let tunnel;
-    if (occupant) {
-        // Reuse the existing tunnel rather than spawning a duplicate.
-        tunnel = { pid: occupant.pid, kill: () => { try {
-                process.kill(occupant.pid);
-            }
-            catch { /* gone */ } } };
-    }
-    else {
-        tunnel = await startSSHTunnel(user, host, localPort, remotePort);
-    }
-    try {
-        await waitForPort(localPort, 8000);
-    }
-    catch {
-        tunnel.kill();
-        throw new Error(`SSH tunnel failed to establish to ${host}`);
-    }
-    let wsUrl;
-    let browser;
-    try {
-        ({ wsUrl, browser } = await discoverBrowserWsUrl(localPort, 'localhost', profile.name));
-    }
-    catch (err) {
-        tunnel.kill();
-        if (opts.persistRemote) {
-            const why = err instanceof Error ? err.message : String(err);
-            throw new Error(`Browser profile "${profile.name}" is declared on ${host}, but nothing is speaking CDP on port ${remotePort}: ${why}`);
-        }
-        throw err;
-    }
-    try {
-        verifyBrowserIdentity(browser, profile.browser, remotePort, host);
-    }
-    catch (err) {
-        tunnel.kill();
-        throw err;
-    }
-    const cdp = new CDPClient();
-    await cdp.connect(wsUrl);
-    // Record the tunnel in the profile's runtime so a future daemon — or
-    // the orphan reaper after a crash — can find and clean it up. The
-    // `kind: 'tunnel'` flag distinguishes it from a locally-launched
-    // browser process.
-    const tunnelPid = tunnel.pid ?? 0;
-    if (tunnelPid > 0) {
-        writeProfileRuntime(key, {
-            pid: 0,
-            port: localPort,
-            command: 'ssh',
-            kind: 'tunnel',
-            tunnelPid,
-        });
-    }
-    return {
-        cdp,
-        port: localPort,
-        pid: tunnelPid,
-        cleanup: () => {
-            cdp.close();
-            // Kill the remote browser BEFORE tearing down the tunnel — but only
-            // when we launched it. persistRemote is an attach to someone else's
-            // declared browser; killing it would drop the logins the caller came
-            // for. Fire-and-forget — cleanup stays synchronous.
-            if (lifecycle.killOnCleanup) {
-                killRemoteBrowser(user, host, remoteOs, remotePort).catch(() => { });
-            }
-            tunnel.kill();
-            clearProfileRuntime(key);
-        },
-    };
-}
-async function waitForPort(port, timeoutMs) {
-    const start = Date.now();
-    while (Date.now() - start < timeoutMs) {
-        try {
-            await tryConnect(port);
-            return;
-        }
-        catch {
-            await sleep(200);
-        }
-    }
-    throw new Error(`Port ${port} not ready after ${timeoutMs}ms`);
-}
-function tryConnect(port) {
-    return new Promise((resolve, reject) => {
-        const socket = net.createConnection({ port, host: '127.0.0.1' });
-        socket.on('connect', () => {
-            socket.destroy();
-            resolve();
-        });
-        socket.on('error', reject);
-    });
-}
-// macOS .app launchers — the historical POSIX table.
-const POSIX_BROWSER_PATHS = {
-    chrome: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-    comet: '/Applications/Comet.app/Contents/MacOS/Comet',
-    chromium: '/Applications/Chromium.app/Contents/MacOS/Chromium',
-    brave: '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
-    edge: '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
-    arc: '/Applications/Arc.app/Contents/MacOS/Arc',
-};
-// Windows App Paths registry keys per browser. CreateProcess (used by WMI
-// Win32_Process.Create) does not honor App Paths the way ShellExecute/`start`
-// does, so the launch script resolves the real `.exe` path from this registry
-// key at runtime — covering both Program Files and Program Files (x86)
-// installs without hardcoding (or guessing) the location.
-const WIN_BROWSER_APPPATH = {
-    chrome: 'chrome.exe',
-    chromium: 'chrome.exe',
-    brave: 'brave.exe',
-    edge: 'msedge.exe',
-};
-/** Single-quote a string for embedding inside a PowerShell literal. */
-function psSingleQuote(s) {
-    return "'" + s.replace(/'/g, "''") + "'";
-}
-/**
- * Wrap a PowerShell script as a `-EncodedCommand` invocation. Base64 of the
- * UTF-16LE bytes is a single quote-free token, so it rides through Node spawn
- * → Windows sshd → cmd.exe with zero escaping hazards (hand-quoted
- * `powershell -Command "…"` is fragile the moment a path or URL is involved).
- */
-export function encodePowerShell(script) {
-    return `powershell -NoProfile -EncodedCommand ${encodePwshBase64(script)}`;
-}
-/**
- * The PowerShell that launches the browser on a Windows remote. Three hard
- * requirements shaped this:
- *   1. The browser must OUTLIVE the ssh session. Windows OpenSSH terminates
- *      the session's job tree on disconnect, which reaps both `start /B` and
- *      `Start-Process` children (verified against a real box). A scheduled
- *      task runs under the Task Scheduler service, so the process survives
- *      after we drop the ssh connection and reconnect over the CDP tunnel.
- *   2. The browser must run in the user's INTERACTIVE session. The previous
- *      WMI `Win32_Process.Create` launch also survived disconnect, but it
- *      spawned Edge in session 0 (the services session): the CDP socket bound
- *      and accepted, yet the DevTools server never initialized — every
- *      /json/version probe hung forever and DevToolsActivePort was never
- *      written (verified against a real box, Edg/150). A scheduled task
- *      registered and started by the logged-on user runs in that user's
- *      interactive session, where DevTools comes up normally.
- *   3. A distinct `--user-data-dir` so a fresh instance bound to the debugging
- *      port comes up even when the user already has Edge open.
- * CreateProcess ignores App Paths, so we resolve the real `.exe` from the
- * registry at runtime rather than relying on a bare `msedge` name. The task is
- * unregistered immediately after start — the browser keeps running; nothing
- * lingers in the scheduler.
- */
-export function buildWindowsLaunchScript(browserType, port, customBinary) {
-    let exeStmts;
-    if (customBinary) {
-        exeStmts = [`$exe = ${psSingleQuote(customBinary)}`];
-    }
-    else if (browserType === 'custom') {
-        throw new Error('browser: custom requires a binary path in the profile');
-    }
-    else {
-        const exeKey = WIN_BROWSER_APPPATH[browserType];
-        if (!exeKey)
-            throw new Error(`Unknown browser type for windows remote: ${browserType}`);
-        const appPath = `SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\App Paths\\${exeKey}`;
-        // Per-user installs — the DEFAULT for Edge and Chrome — register App Paths
-        // under HKCU, not HKLM, so an HKLM-only lookup silently missed them and the
-        // launch failed. Resolve from HKLM first, then fall through to HKCU.
-        // Windows PowerShell 5.1 (what `powershell.exe` is) has no `??`, so the
-        // fallback is an explicit `if`. A missing exe `throw`s so the failure rides
-        // out as a non-zero ssh exit (surfaced by ensureRemoteBrowser) instead of a
-        // silent empty launch.
-        exeStmts = [
-            `$exe = (Get-ItemProperty 'HKLM:\\${appPath}' -EA SilentlyContinue).'(default)'`,
-            `if (-not $exe) { $exe = (Get-ItemProperty 'HKCU:\\${appPath}' -EA SilentlyContinue).'(default)' }`,
-            `if (-not $exe) { throw 'browser exe not found in HKLM/HKCU App Paths: ${exeKey}' }`,
-        ];
-    }
-    // Keep the `--remote-allow-origins=http://127.0.0.1:${port}` literal in
-    // source — a test asserts CDP is never opened to `*`.
-    return [
-        ...exeStmts,
-        // First-run / default-browser modals block automation (same rationale as
-        // the local launcher in chrome.ts), and the crash-restore bubble is worse
-        // here: `browser stop` hard-kills the remote process, so the NEXT launch
-        // against the same --user-data-dir marks the profile crashed and session
-        // restore swaps the initial page target — closing its CDP websocket while
-        // a command is pending (reproduced live: Page.captureScreenshot rejected
-        // with "CDP connection closed" on every reused-profile launch).
-        `$args = '--remote-debugging-port=${port}` +
-            ` --remote-allow-origins=http://127.0.0.1:${port}` +
-            ` --no-first-run --no-default-browser-check` +
-            ` --hide-crash-restore-bubble --disable-session-crashed-bubble` +
-            ` --disable-background-timer-throttling --user-data-dir="' + $env:TEMP + '\\agents-browser-${port}"'`,
-        `$action = New-ScheduledTaskAction -Execute $exe -Argument $args`,
-        `Register-ScheduledTask -TaskName 'agents-browser-${port}' -Action $action -Force | Out-Null`,
-        `Start-ScheduledTask -TaskName 'agents-browser-${port}'`,
-        `Unregister-ScheduledTask -TaskName 'agents-browser-${port}' -Confirm:$false`,
-    ].join('; ');
-}
-/**
- * The PowerShell that kills whatever holds the CDP port on a Windows remote.
- * Tree-kill (`taskkill /T`), not `Stop-Process`: Chromium is multi-process, and
- * killing only the port-owning main process orphans its children. The orphans
- * keep the profile's SingletonLock, so every later launch against the same
- * `--user-data-dir` delegates to the zombie tree, exits, and never binds the
- * CDP port — `browser start --device` then fails until someone hand-cleans the
- * box (found live on win-mini by the #561 e2e suite).
- */
-export function buildWindowsKillScript(port) {
-    return (`Get-NetTCPConnection -LocalPort ${port} -State Listen -ErrorAction SilentlyContinue ` +
-        `| ForEach-Object { taskkill /PID $_.OwningProcess /T /F 2>$null } | Out-Null`);
-}
-/**
- * Build the remote command that launches the browser detached with a CDP port.
- * POSIX backgrounds the `.app` binary with `… &`; Windows resolves the exe and
- * starts it via an interactive one-shot scheduled task (encoded PowerShell)
- * so it survives the ssh session AND serves CDP (session 0 never does).
- */
-export function buildLaunchCmd(remoteOs, browserType, port, customBinary) {
-    if (remoteOs === 'windows') {
-        return encodePowerShell(buildWindowsLaunchScript(browserType, port, customBinary));
-    }
-    const browserPath = customBinary ?? POSIX_BROWSER_PATHS[browserType];
-    if (!browserPath) {
-        if (browserType === 'custom') {
-            throw new Error('browser: custom requires a binary path in the profile');
-        }
-        throw new Error(`Unknown browser type for posix remote: ${browserType}`);
-    }
-    return [
-        shellQuote(browserPath),
-        `--remote-debugging-port=${port}`,
-        shellQuote(`--remote-allow-origins=http://127.0.0.1:${port}`),
-        '--disable-background-timer-throttling',
-        `--user-data-dir=/tmp/agents-browser-${port}`,
-        '</dev/null >/dev/null 2>&1 &',
-    ].join(' ');
-}
-/**
- * Build the remote command that kills whatever holds the CDP port.
- * POSIX uses `lsof`+`kill`; Windows uses encoded PowerShell
- * (Get-NetTCPConnection → Stop-Process).
- */
-export function buildKillCmd(remoteOs, port) {
-    if (remoteOs === 'windows') {
-        return encodePowerShell(buildWindowsKillScript(port));
-    }
-    return `pids=$(lsof -ti ${shellQuote(`:${port}`)} 2>/dev/null); [ -z "$pids" ] || kill -9 $pids 2>/dev/null || true`;
-}
-export async function ensureRemoteBrowser(user, host, browserType, port, remoteOs, customBinary) {
-    // `user`/`host` derive from an ssh:// profile endpoint (git-tracked user
-    // config). Validate the composed target before it reaches the raw `ssh` spawn:
-    // an endpoint like `ssh://-Fattack@victim` would otherwise place `-Fattack` at
-    // the target position, where OpenSSH parses it as `-F <file>` and an
-    // attacker-supplied ssh config's ProxyCommand yields local code execution.
-    assertValidSshTarget(`${user}@${host}`);
-    const remoteCmd = buildLaunchCmd(remoteOs, browserType, port, customBinary);
-    return new Promise((resolve, reject) => {
-        // Capture stderr so a real launch failure (missing exe, auth denied, bad
-        // CreateProcess) surfaces here as a clear error. Previously stdio was
-        // ignored and this resolved on close regardless of exit code, so failures
-        // were swallowed and only re-emerged 8s later as a generic
-        // "SSH tunnel failed to establish".
-        // Options BEFORE the target (matching `sshExec`): OpenSSH's BSD getopt on
-        // macOS stops at the first non-option, so any `-o` after `user@host` would
-        // be swallowed into the remote command instead of applied.
-        const child = spawn('ssh', [
-            ...sshConnectOpts(controlOpts()),
-            `${user}@${host}`,
-            remoteCmd,
-        ], { stdio: ['ignore', 'ignore', 'pipe'], windowsHide: true });
-        let stderr = '';
-        child.stderr?.on('data', (d) => {
-            stderr += d.toString();
-        });
-        let settled = false;
-        const timer = setTimeout(() => {
-            if (settled)
-                return;
-            settled = true;
-            // ssh is still running the backgrounding launch command past our window.
-            // Killing the local ssh client does NOT reap the WMI/detached remote
-            // browser, so treat this as launched and let waitForPort confirm.
-            child.kill();
-            resolve();
-        }, 2000);
-        child.on('close', (code) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            if (code && code !== 0) {
-                const detail = stderr.trim();
-                reject(new Error(`Remote browser launch failed on ${host} (ssh exit ${code})` +
-                    (detail ? `: ${detail}` : '')));
-            }
-            else {
-                resolve();
-            }
-        });
-        child.on('error', (err) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            reject(err);
-        });
-    });
-}
-/**
- * Kill the remote browser holding the CDP port. Invoked on stop/cleanup so the
- * task-launched (Windows) / detached (posix) browser process is not orphaned when
- * the ssh tunnel is torn down — killing only the tunnel left it running on
- * win-mini after every `browser stop`. Best-effort: never rejects.
- */
-export function killRemoteBrowser(user, host, remoteOs, port) {
-    return runSSHCommand(user, host, buildKillCmd(remoteOs, port));
-}
-function runSSHCommand(user, host, cmd) {
-    return new Promise((resolve, reject) => {
-        // Reject an option-injecting target (e.g. a `-`-leading user from a crafted
-        // ssh:// profile) before it reaches the raw `ssh` spawn. Reject rather than
-        // throw synchronously so `killRemoteBrowser(...).catch()` stays best-effort.
-        // See ensureRemoteBrowser.
-        try {
-            assertValidSshTarget(`${user}@${host}`);
-        }
-        catch (err) {
-            reject(err);
-            return;
-        }
-        // Reuse the shared hardened baseline so a hung TCP SYN to an unreachable
-        // host is bounded by ConnectTimeout (the local 3s kill below only bounds a
-        // connected-but-slow command, not the connect itself). Options precede the
-        // target — see ensureRemoteBrowser.
-        const child = spawn('ssh', [...sshConnectOpts(controlOpts()), `${user}@${host}`, cmd], {
-            stdio: 'ignore',
-            windowsHide: true,
-        });
-        child.on('close', () => resolve());
-        child.on('error', () => resolve());
-        setTimeout(() => {
-            child.kill();
-            resolve();
-        }, 3000);
-    });
-}
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/**
- * Identify whether a pid listening on our target local port is an SSH
- * tunnel WE would have spawned for `host:remotePort`. Used so that two
- * agents-browser invocations of the same SSH profile share a tunnel
- * rather than failing the second one with "port in use".
- *
- * Best-effort match against the ssh -L command line via `ps`. If we
- * can't read the cmd or the args don't look like ours, treat as not-ours.
- *
- * Windows has no `ps`, so the POSIX branch below always throws there and every
- * reuse check returned false — the second invocation to the same host:port then
- * failed "port in use". On win32 we instead reuse the netstat -ano + tasklist
- * occupant lookup (getPortOccupant): the tunnel binds `remotePort` locally
- * (localPort === remotePort in the caller), so the pid holding that port is our
- * ssh.exe. tasklist only exposes the image name, not the full command line, so
- * we can't match host/remotePort as tightly as the POSIX branch — an ssh
- * process on our exact local port is our tunnel in practice.
- */
-export function isOwnTunnel(pid, host, remotePort) {
-    if (process.platform === 'win32') {
-        const occupant = getPortOccupant(remotePort);
-        if (!occupant || occupant.pid !== pid)
-            return false;
-        return occupant.command.toLowerCase().startsWith('ssh');
-    }
-    try {
-        const out = execFileSync('ps', ['-p', String(pid), '-o', 'command='], {
-            encoding: 'utf-8',
-            stdio: ['ignore', 'pipe', 'ignore'],
-        }).toString().trim();
-        if (!out.startsWith('ssh'))
-            return false;
-        if (!out.includes(host))
-            return false;
-        if (!out.includes(`:${remotePort}`) && !out.includes(`:127.0.0.1:${remotePort}`))
-            return false;
-        return true;
-    }
-    catch {
-        return false;
-    }
-}

package/dist/lib/browser/editor.d.ts

@@ -1,3 +0,0 @@
-import type { CDPClient } from './cdp.js';
-import type { RefNode } from './refs.js';
-export declare function typeEditorText(cdp: CDPClient, sessionId: string, node: RefNode, text: string, clear?: boolean): Promise<void>;

package/dist/lib/browser/editor.js

@@ -1,50 +0,0 @@
-const BEFOREINPUT_INSERT_FN = `(function(text) {
-  this.focus();
-  var sel = window.getSelection();
-  var range = document.createRange();
-  range.selectNodeContents(this);
-  range.collapse(false);
-  sel.removeAllRanges();
-  sel.addRange(range);
-  this.dispatchEvent(new InputEvent('beforeinput', {
-    inputType: 'insertText',
-    data: text,
-    bubbles: true,
-    cancelable: true,
-    composed: true,
-  }));
-})`;
-const BEFOREINPUT_CLEAR_FN = `(function() {
-  this.focus();
-  var sel = window.getSelection();
-  var range = document.createRange();
-  range.selectNodeContents(this);
-  sel.removeAllRanges();
-  sel.addRange(range);
-  this.dispatchEvent(new InputEvent('beforeinput', {
-    inputType: 'deleteContentBackward',
-    bubbles: true,
-    cancelable: true,
-    composed: true,
-  }));
-})`;
-const TRIX_INSERT_FN = `(function(text) { this.editor.insertString(text); })`;
-export async function typeEditorText(cdp, sessionId, node, text, clear = false) {
-    const { object } = await cdp.send('DOM.resolveNode', { backendNodeId: node.backendNodeId }, sessionId);
-    if (!object.objectId)
-        throw new Error(`Could not resolve DOM node for ref ${node.ref}`);
-    const objectId = object.objectId;
-    try {
-        if (node.editor === 'trix') {
-            await cdp.send('Runtime.callFunctionOn', { objectId, functionDeclaration: TRIX_INSERT_FN, arguments: [{ value: text }], returnByValue: true }, sessionId);
-            return;
-        }
-        if (clear) {
-            await cdp.send('Runtime.callFunctionOn', { objectId, functionDeclaration: BEFOREINPUT_CLEAR_FN, arguments: [], returnByValue: true }, sessionId);
-        }
-        await cdp.send('Runtime.callFunctionOn', { objectId, functionDeclaration: BEFOREINPUT_INSERT_FN, arguments: [{ value: text }], returnByValue: true }, sessionId);
-    }
-    finally {
-        await cdp.send('Runtime.releaseObject', { objectId }, sessionId);
-    }
-}

package/dist/lib/browser/ffmpeg.d.ts

@@ -1,12 +0,0 @@
-type Platform = NodeJS.Platform;
-export declare function ffmpegManualCommand(platform: Platform, osRelease?: string): string;
-export declare function resolveFfmpeg(options?: {
-    env?: NodeJS.ProcessEnv;
-    home?: string;
-    platform?: Platform;
-    osRelease?: string;
-    /** Override canonical executable directories, primarily for isolated verification. */
-    executableDirs?: string[];
-}): Promise<string>;
-export declare function resetFfmpegResolverForTest(): void;
-export {};