pi-agent-browser-native 0.9.5 → 0.9.7

package/dist/extensions/agent-browser/lib/orchestration/native-session-defaults.js

@@ -1,231 +0,0 @@
-import { createHash } from "node:crypto";
-import { homedir } from "node:os";
-import { join, resolve } from "node:path";
-import { extractExplicitSessionName, getBooleanFlagValue, isUpstreamEnvFlagEnabled, scanUpstreamGlobalFlagOccurrences, } from "../argv-grammar.js";
-import { parseArgvDescriptor } from "../argv-descriptor.js";
-import { needsManagedSession } from "../command-policy.js";
-import { getUpstreamEffectiveBatchSteps } from "./batch-stdin.js";
-import { hasLaunchScopedFlagToken } from "../launch-scoped-flags.js";
-import { getAgentBrowserProcessEnvironment, withAgentBrowserProcessEnvironment, } from "../process-environment.js";
-import { isPlainTextInspectionArgs } from "../runtime.js";
-import { hasLocalLaunchDefaults, loadNativeIdentity, LOCAL_LAUNCH_DEFAULT_FLAGS, } from "./native-config.js";
-import { withRootBrowserLaunch } from "./native-root-launch.js";
-function cliValue(args, flag) {
-    return scanUpstreamGlobalFlagOccurrences([...args], flag).at(-1)?.value;
-}
-function requestsConnection(tokens, stdin) {
-    return (tokens[0] === "connect" ||
-        getUpstreamEffectiveBatchSteps(tokens, stdin).some((step) => requestsConnection(step)));
-}
-function rootBrowserSessionName(rootSessionId) {
-    return `pi-root-${createHash("sha256").update(rootSessionId).digest("hex").slice(0, 24)}`;
-}
-function nativeBooleanOverrides(args) {
-    const overrides = [];
-    for (const flag of ["--debug", "--no-auto-dialog"]) {
-        const value = getBooleanFlagValue([...args], flag);
-        if (value !== undefined) {
-            overrides.push([flag, String(value)]);
-        }
-    }
-    return overrides;
-}
-/** Owns one native config resolution and pure adaptation, never browser/auth authority. */
-class NativeSessionCall {
-    input;
-    context;
-    runner;
-    env = getAgentBrowserProcessEnvironment();
-    configPath;
-    configPaths;
-    rootName;
-    browserCommand;
-    rootFallback;
-    identity = {};
-    constructor(input, context, runner) {
-        this.input = input;
-        this.context = context;
-        this.runner = runner;
-        const configArg = scanUpstreamGlobalFlagOccurrences([...input.toolArgs], "--config").at(0);
-        this.configPath = configArg?.value ?? this.env.AGENT_BROWSER_CONFIG;
-        this.configPaths =
-            this.configPath !== undefined
-                ? [resolve(context.cwd, this.configPath)]
-                : [
-                    join(homedir(), ".agent-browser", "config.json"),
-                    join(context.cwd, "agent-browser.json"),
-                ];
-        this.rootName =
-            context.root === undefined ? undefined : rootBrowserSessionName(context.root.id);
-        this.browserCommand =
-            input.kind !== "electron" &&
-                needsManagedSession(parseArgvDescriptor([...input.toolArgs]), input.toolStdin);
-        const session = extractExplicitSessionName([...input.toolArgs]);
-        this.rootFallback =
-            context.root !== undefined &&
-                this.env.AGENT_BROWSER_SESSION === undefined &&
-                (session === undefined || session === this.rootName) &&
-                this.browserCommand;
-    }
-    attachment() {
-        const autoConnect = getBooleanFlagValue([...this.input.toolArgs], "--auto-connect") ??
-            (isUpstreamEnvFlagEnabled(this.env.AGENT_BROWSER_AUTO_CONNECT) ||
-                this.identity.autoConnect === true);
-        return (hasLaunchScopedFlagToken([...this.input.toolArgs], "--cdp") ||
-            this.env.AGENT_BROWSER_CDP !== undefined ||
-            this.identity.cdp !== undefined ||
-            autoConnect ||
-            parseArgvDescriptor([...this.input.toolArgs]).upstreamCommandTokens[0] === "connect");
-    }
-    restoreEligible() {
-        return (![
-            "--restore",
-            "--session-name",
-            "--state",
-            "--allowed-domains",
-            "--provider",
-            "-p",
-            "--device",
-        ].some((flag) => hasLaunchScopedFlagToken([...this.input.toolArgs], flag)) &&
-            !["restore", "sessionName", "state", "allowedDomains", "provider"].some((key) => this.identity[key] !== undefined) &&
-            ![
-                "AGENT_BROWSER_RESTORE",
-                "AGENT_BROWSER_SESSION_NAME",
-                "AGENT_BROWSER_STATE",
-                "AGENT_BROWSER_ALLOWED_DOMAINS",
-                "AGENT_BROWSER_PROVIDER",
-            ].some((key) => this.env[key] !== undefined));
-    }
-    chromeLaunch() {
-        const args = this.input.toolArgs;
-        const engine = cliValue(args, "--engine") ?? this.env.AGENT_BROWSER_ENGINE ?? this.identity.engine;
-        const chromeEngine = engine === undefined || engine === "chrome";
-        const nativeLaunchDefaults = hasLocalLaunchDefaults(this.identity, this.env);
-        // Native config/env can submit launch options on local commands too. Leave their args
-        // unchanged so browser calls and sessionless helpers do not reconfigure the same daemon.
-        const chromeStartupArgs = nativeLaunchDefaults
-            ? undefined
-            : this.chromeStartupArgs(chromeEngine);
-        const configuredChromeLaunch = nativeLaunchDefaults ||
-            LOCAL_LAUNCH_DEFAULT_FLAGS.some((flag) => scanUpstreamGlobalFlagOccurrences([...args], flag).length > 0);
-        return { chromeEngine, chromeStartupArgs, configuredChromeLaunch };
-    }
-    chromeStartupArgs(chromeEngine) {
-        if (!this.localChrome(chromeEngine)) {
-            return undefined;
-        }
-        const launchArgs = cliValue(this.input.toolArgs, "--args") ?? this.env.AGENT_BROWSER_ARGS ?? this.identity.args;
-        return ["--no-startup-window", ...(typeof launchArgs === "string" ? [launchArgs] : [])].join(",");
-    }
-    localChrome(chromeEngine) {
-        const args = this.input.toolArgs;
-        const provider = cliValue(args, "--provider") ??
-            cliValue(args, "-p") ??
-            this.env.AGENT_BROWSER_PROVIDER ??
-            this.identity.provider;
-        const batchAttaches = requestsConnection(parseArgvDescriptor([...args]).upstreamCommandTokens, this.input.toolStdin);
-        return (this.browserCommand &&
-            !this.attachment() &&
-            !batchAttaches &&
-            provider === undefined &&
-            chromeEngine);
-    }
-    confirmationActions(args) {
-        return (cliValue(args, "--confirm-actions") ??
-            this.env.AGENT_BROWSER_CONFIRM_ACTIONS ??
-            (typeof this.identity.confirmActions === "string" ? this.identity.confirmActions : undefined));
-    }
-    configEnvironment() {
-        return this.configPath === undefined
-            ? {}
-            : { AGENT_BROWSER_CONFIG: resolve(this.context.cwd, this.configPath) };
-    }
-    executionEnvironment(args, session, namespace) {
-        const idle = cliValue(args, "--idle-timeout");
-        const actionPolicy = cliValue(args, "--action-policy");
-        const confirm = cliValue(args, "--confirm-actions");
-        return {
-            ...(idle !== undefined ? { AGENT_BROWSER_IDLE_TIMEOUT_MS: idle } : {}),
-            ...(actionPolicy !== undefined ? { AGENT_BROWSER_ACTION_POLICY: actionPolicy } : {}),
-            ...(confirm !== undefined ? { AGENT_BROWSER_CONFIRM_ACTIONS: confirm } : {}),
-            ...this.booleanEnvironment(args),
-            ...this.configEnvironment(),
-            ...(session !== undefined ? { AGENT_BROWSER_SESSION: session } : {}),
-            ...(namespace !== undefined ? { AGENT_BROWSER_NAMESPACE: namespace } : {}),
-        };
-    }
-    booleanEnvironment(args) {
-        const debug = getBooleanFlagValue([...args], "--debug");
-        const noAutoDialog = getBooleanFlagValue([...args], "--no-auto-dialog");
-        return {
-            ...(debug !== undefined ? { AGENT_BROWSER_DEBUG: debug ? "1" : undefined } : {}),
-            ...(noAutoDialog !== undefined
-                ? { AGENT_BROWSER_NO_AUTO_DIALOG: noAutoDialog ? "1" : "0" }
-                : {}),
-        };
-    }
-    runElectron() {
-        const nativeConfirmActions = this.env.AGENT_BROWSER_CONFIRM_ACTIONS ??
-            (typeof this.identity.confirmActions === "string" ? this.identity.confirmActions : undefined);
-        const launch = this.input.kind === "electron" && this.input.compiledElectron.action === "launch";
-        return withAgentBrowserProcessEnvironment({ ...(launch ? { AGENT_BROWSER_SESSION: undefined } : {}), ...this.configEnvironment() }, () => this.runner({ ...this.input, nativeConfirmActions }));
-    }
-    rootDefaultSession(configuredSession) {
-        return this.rootName !== undefined &&
-            configuredSession === undefined &&
-            this.rootFallback &&
-            !this.attachment()
-            ? this.rootName
-            : undefined;
-    }
-    runBrowser() {
-        const configuredSession = this.env.AGENT_BROWSER_SESSION ?? this.identity.session;
-        const rootDefault = this.rootDefaultSession(configuredSession);
-        const session = configuredSession ?? rootDefault;
-        const namespace = this.env.AGENT_BROWSER_NAMESPACE ?? this.identity.namespace;
-        const args = session !== undefined && extractExplicitSessionName([...this.input.toolArgs]) === undefined
-            ? ["--session", session, ...this.input.toolArgs]
-            : this.input.toolArgs;
-        const launch = this.chromeLaunch();
-        const input = {
-            ...this.input,
-            toolArgs: args,
-            nativeConfirmActions: this.confirmationActions(args),
-            chromeStartupArgs: launch.chromeStartupArgs,
-            configuredChromeLaunch: launch.configuredChromeLaunch,
-        };
-        const defaults = rootDefault === undefined
-            ? undefined
-            : this.rootLaunchRunner({
-                ...launch,
-                cwd: this.context.cwd,
-                rootName: rootDefault,
-                namespace,
-                input,
-                env: this.env,
-                identity: this.identity,
-                restoreEligible: this.restoreEligible(),
-                defaultProfile: this.context.root?.profile,
-                defaultExecutable: this.context.root?.executablePath,
-            });
-        return withAgentBrowserProcessEnvironment(this.executionEnvironment(args, session, namespace), () => this.runner(input, defaults), nativeBooleanOverrides(args));
-    }
-    rootLaunchRunner(policy) {
-        return (browserRun, signal = this.context.signal) => withRootBrowserLaunch(policy, browserRun, signal);
-    }
-    async run() {
-        this.identity = await loadNativeIdentity(this.configPaths, {
-            cwd: this.context.cwd,
-            signal: this.context.signal,
-            rootFallback: this.rootFallback,
-            browserCommand: this.browserCommand,
-        });
-        return this.input.kind === "electron" ? this.runElectron() : this.runBrowser();
-    }
-}
-export async function withNativeSessionDefaults(input, context, run) {
-    if (isPlainTextInspectionArgs([...input.toolArgs])) {
-        return run(input);
-    }
-    return new NativeSessionCall(input, context, run).run();
-}

package/dist/extensions/agent-browser/lib/orchestration/operation-paths.js

@@ -1,142 +0,0 @@
-import { isAbsolute, resolve } from "node:path";
-import { projectUpstreamGlobalFlags, scanUpstreamGlobalFlagOccurrences } from "../argv-grammar.js";
-import { getDiffFilePathIndices, getExplicitArtifactDestinationIndex, } from "./browser-run/artifact-paths.js";
-import { parseBatchCommandArgument, parseUserBatchStdin } from "./batch-stdin.js";
-const FILE_GLOBAL_FLAGS = [
-    "--config",
-    "--ca-cert",
-    "--executable-path",
-    "--extension",
-    "--init-script",
-    "--download-path",
-    "--screenshot-dir",
-    "--action-policy",
-    "--state",
-];
-/** Owns copy-on-write argv; unchanged rows retain identity for batch stdin preservation. */
-class OperationPathBinding {
-    args;
-    cwd;
-    changedArgs;
-    tokens;
-    indices;
-    constructor(args, cwd, batchStep) {
-        this.args = args;
-        this.cwd = cwd;
-        const projection = batchStep
-            ? { tokens: args, indices: args.map((_, index) => index) }
-            : projectUpstreamGlobalFlags(args);
-        this.tokens = projection.tokens;
-        this.indices = projection.indices;
-    }
-    get result() {
-        return this.changedArgs ?? this.args;
-    }
-    replace(index, value) {
-        this.changedArgs ??= [...this.args];
-        this.changedArgs[index] = value;
-    }
-    setPath(index, prefix = "") {
-        if (index === undefined) {
-            return;
-        }
-        const path = this.args.at(index)?.slice(prefix.length);
-        if (path === undefined || path.length === 0 || isAbsolute(path)) {
-            return;
-        }
-        this.replace(index, prefix + resolve(this.cwd, path));
-    }
-    bindGlobals() {
-        for (const flag of FILE_GLOBAL_FLAGS) {
-            for (const occurrence of scanUpstreamGlobalFlagOccurrences([...this.args], flag)) {
-                if (flag === "--state" && this.tokens[0] === "wait" && occurrence.index > this.indices[0]) {
-                    continue;
-                }
-                this.setPath(occurrence.index + 1);
-            }
-        }
-        for (const occurrence of scanUpstreamGlobalFlagOccurrences([...this.args], "--profile")) {
-            const value = occurrence.value;
-            // Chrome profile names are identities, not workspace file paths.
-            if (value !== undefined && /[\\/]/.test(value) && !value.startsWith("~")) {
-                this.setPath(occurrence.index + 1);
-            }
-        }
-    }
-    bindRawBatchRows() {
-        for (let index = 1; index < this.tokens.length; index++) {
-            if (this.tokens[index] === "--bail") {
-                continue;
-            }
-            const row = parseBatchCommandArgument(this.tokens[index]).step;
-            if (row === undefined) {
-                continue;
-            }
-            const bound = resolveOperationPaths(row, undefined, this.cwd, true).args;
-            if (bound !== row) {
-                this.replace(this.indices[index], bound.map((token) => `'${token.replaceAll("'", "'\\''")}'`).join(" "));
-            }
-        }
-    }
-    bindFileOperands() {
-        this.setPath(this.indices[getExplicitArtifactDestinationIndex([...this.tokens]) ?? -1]);
-        if (this.tokens[0] === "upload") {
-            for (let index = 2; index < this.tokens.length; index++) {
-                this.setPath(this.indices[index]);
-            }
-        }
-        if (this.tokens[0] === "state" && this.tokens[1] === "load") {
-            this.setPath(this.indices[2]);
-        }
-        this.setPath(this.indices[getDiffFilePathIndices([...this.tokens]).baseline ?? -1]);
-        if (this.tokens[0] === "cookies" && this.tokens[1] === "set") {
-            const index = this.tokens.indexOf("--curl");
-            if (index >= 0) {
-                this.setPath(this.indices[index + 1]);
-            }
-        }
-        this.bindWebMcpParams();
-    }
-    bindBatch(stdin) {
-        if (this.tokens.slice(1).some((token) => token !== "--bail")) {
-            this.bindRawBatchRows();
-            return { args: this.result, stdin }; // Native ignores stdin when raw rows exist.
-        }
-        const rows = parseUserBatchStdin(stdin).steps;
-        if (rows === undefined || rows.length === 0) {
-            return { args: this.result, stdin };
-        }
-        const bound = rows.map((row) => resolveOperationPaths(row, undefined, this.cwd, true).args);
-        return {
-            args: this.result,
-            stdin: bound.some((row, index) => row !== rows[index]) ? JSON.stringify(bound) : stdin,
-        };
-    }
-    bindWebMcpParams() {
-        if (this.tokens[0] !== "webmcp" || this.tokens[1] !== "invoke") {
-            return;
-        }
-        for (let index = 3; index < this.tokens.length; index++) {
-            if (!["--params", "--frame", "--timeout"].includes(this.tokens[index])) {
-                continue;
-            }
-            if (this.tokens[index] === "--params" &&
-                this.tokens.at(index + 1)?.startsWith("@") === true) {
-                this.setPath(this.indices[index + 1], "@");
-            }
-            index++;
-        }
-    }
-}
-/** Bind file operands without moving native process/config or interpreting literal form data. */
-export function resolveOperationPaths(args, stdin, cwd, batchStep = false) {
-    const binding = new OperationPathBinding(args, cwd, batchStep);
-    if (!batchStep) {
-        binding.bindGlobals();
-    }
-    if (binding.tokens[0] === "batch") {
-        return binding.bindBatch(stdin);
-    }
-    binding.bindFileOperands();
-    return { args: binding.result, stdin };
-}

package/dist/extensions/agent-browser/lib/orchestration/output-file.js

@@ -1,276 +0,0 @@
-import { mkdir, readFile, realpath, stat, writeFile } from "node:fs/promises";
-import { dirname, extname, isAbsolute, resolve } from "node:path";
-import { isRecord } from "../parsing.js";
-import { isStringArray } from "../input-modes/shared.js";
-import { getBooleanFlagValue } from "../argv-grammar.js";
-import { isSessionArtifactManifest } from "../results/artifact-manifest.js";
-import { parseCommandInfo, redactSensitiveValue } from "../runtime.js";
-import { stringifyUnknown } from "../results/text.js";
-export function normalizeRequestedOutputPath(path) {
-    return path.startsWith("@") ? path.slice(1) : path;
-}
-function getTextContent(result) {
-    return result.content
-        .filter((item) => item.type === "text")
-        .map((item) => item.text)
-        .join("\n\n");
-}
-function getResultCommand(details) {
-    return parseCommandInfo(isStringArray(details?.args) ? details.args : []);
-}
-function isRecordingReceiptResult(result) {
-    const details = isRecord(result.details) ? result.details : undefined;
-    return (details?.command === "record" ||
-        getResultCommand(details).command === "record" ||
-        details?.recordingRecovery !== undefined ||
-        (Array.isArray(details?.batchSteps) &&
-            details.batchSteps.some((step) => isRecord(step) && Array.isArray(step.command) && step.command[0] === "record")));
-}
-export function canWriteAgentBrowserOutput(result) {
-    return (isRecordingReceiptResult(result) ||
-        (result.isError !== true &&
-            !(isRecord(result.details) && result.details.resultCategory === "failure")));
-}
-function getOutputSource(result) {
-    if (isRecordingReceiptResult(result)) {
-        return "recording-receipt";
-    }
-    return isRecord(result.details) && result.details.data !== undefined
-        ? "details.data"
-        : "content.text";
-}
-function preferredString(record, primary, fallback) {
-    const first = record?.[primary];
-    if (typeof first === "string") {
-        return first;
-    }
-    const second = fallback === undefined ? undefined : record?.[fallback];
-    return typeof second === "string" ? second : undefined;
-}
-async function readCompactedSpill(path, manifest) {
-    const live = manifest?.entries.some((entry) => entry.kind === "spill" &&
-        (entry.path === path || entry.absolutePath === path) &&
-        (entry.storageScope === "persistent-session" || entry.storageScope === "process-temp") &&
-        (entry.retentionState === "live" || entry.retentionState === "ephemeral"));
-    if (path === undefined || path.length === 0 || live !== true) {
-        throw new Error("Full compacted output is unavailable from the wrapper-managed spill; outputPath was not written.");
-    }
-    const text = await readFile(path, "utf8");
-    if (extname(path) !== ".json") {
-        return text;
-    }
-    const parsed = JSON.parse(text);
-    return parsed;
-}
-async function rehydrateCompactedData(data, details, manifest) {
-    if (isRecord(data) && data.compacted === true) {
-        return readCompactedSpill(preferredString(details, "fullOutputPath"), manifest);
-    }
-    if (!Array.isArray(data)) {
-        return data;
-    }
-    const batchSteps = Array.isArray(details.batchSteps) ? details.batchSteps : [];
-    return Promise.all(data.map(async (row, index) => {
-        if (!isRecord(row) || !isRecord(row.result) || row.result.compacted !== true) {
-            return row;
-        }
-        const rawStep = batchSteps[index];
-        const step = isRecord(rawStep) ? rawStep : undefined;
-        const path = preferredString(step, "fullOutputPath") ?? preferredString(row.result, "fullOutputPath");
-        return { ...row, result: await readCompactedSpill(path, manifest) };
-    }));
-}
-function recordingAttempt(details, success) {
-    return {
-        success,
-        agentBrowserStarted: details.agentBrowserStarted ?? null,
-        exitCode: details.exitCode ?? null,
-        timedOut: details.timedOut === true,
-        error: details.error ?? details.validationError ?? null,
-        parseError: details.parseError ?? null,
-    };
-}
-function recordingError(result, details, success) {
-    return details.error ?? (success ? null : (details.summary ?? getTextContent(result)));
-}
-function recordingReceipt(result, data, details) {
-    const success = result.isError !== true && details.resultCategory !== "failure";
-    const recovery = isRecord(details.recordingRecovery) ? details.recordingRecovery : undefined;
-    const command = getResultCommand(details);
-    return redactSensitiveValue({
-        success,
-        error: recordingError(result, details, success),
-        command: details.command ?? command.command,
-        subcommand: details.subcommand ?? command.subcommand,
-        sessionName: details.sessionName,
-        namespace: details.namespace,
-        attempt: recovery?.attempt ?? recordingAttempt(details, success),
-        data: data ?? null,
-        artifacts: details.artifacts,
-        artifactVerification: details.artifactVerification,
-        recordingRecovery: recovery,
-    });
-}
-async function getOutputPayload(result) {
-    const details = isRecord(result.details) ? result.details : undefined;
-    if (details === undefined) {
-        return { source: "content.text", value: getTextContent(result) };
-    }
-    const manifest = isSessionArtifactManifest(details.artifactManifest)
-        ? details.artifactManifest
-        : undefined;
-    const data = await rehydrateCompactedData(details.data, details, manifest);
-    if (isRecordingReceiptResult(result)) {
-        return { source: "recording-receipt", value: recordingReceipt(result, data, details) };
-    }
-    return data === undefined
-        ? { source: "content.text", value: getTextContent(result) }
-        : { source: "details.data", value: data };
-}
-function jsonOutputNotice(result, text, message, failed) {
-    const nativeText = isRecord(result.details) &&
-        isStringArray(result.details.args) &&
-        getBooleanFlagValue(result.details.args, "--json") === false;
-    if (nativeText) {
-        return undefined;
-    }
-    try {
-        const json = JSON.parse(text);
-        if (isRecord(json) && typeof json.success === "boolean") {
-            return JSON.stringify({
-                ...json,
-                ...(failed ? { success: false, error: message } : {}),
-                outputFileNotice: message,
-            }, null, 2);
-        }
-    }
-    catch {
-        /* Non-JSON native text receives a prose notice instead. */
-    }
-    return undefined;
-}
-function appendOutputFileNotice(result, message, failed = false) {
-    const content = [...result.content];
-    if (content[0]?.type === "text") {
-        const json = jsonOutputNotice(result, content[0].text, message, failed);
-        content[0] = { type: "text", text: json ?? `${content[0].text}\n\n${message}` };
-        return content;
-    }
-    return [{ type: "text", text: message }, ...content];
-}
-function getArtifactPaths(result, cwd) {
-    const details = isRecord(result.details) ? result.details : undefined;
-    if (details === undefined || !Array.isArray(details.artifacts)) {
-        return [];
-    }
-    return details.artifacts.flatMap((artifact) => {
-        if (!isRecord(artifact)) {
-            return [];
-        }
-        const path = preferredString(artifact, "absolutePath", "path");
-        return path !== undefined && path.length > 0
-            ? [isAbsolute(path) ? path : resolve(cwd, path)]
-            : [];
-    });
-}
-async function pathsReferToSameFile(left, right) {
-    if (resolve(left) === resolve(right)) {
-        return true;
-    }
-    try {
-        if ((await realpath(left)) === (await realpath(right))) {
-            return true;
-        }
-    }
-    catch {
-        /* Missing paths can still be compared through stat when both resolve later. */
-    }
-    try {
-        const [leftStat, rightStat] = await Promise.all([stat(left), stat(right)]);
-        return leftStat.dev === rightStat.dev && leftStat.ino === rightStat.ino;
-    }
-    catch {
-        return false;
-    }
-}
-async function overlapsArtifact(result, path, cwd) {
-    for (const artifact of getArtifactPaths(result, cwd)) {
-        // Stop on the first alias; never write while any browser artifact identity remains unchecked.
-        // oxlint-disable-next-line no-await-in-loop
-        if (await pathsReferToSameFile(path, artifact)) {
-            return true;
-        }
-    }
-    return false;
-}
-function failedOutputResult(result, outputFile, rejected) {
-    const details = isRecord(result.details) ? { ...result.details } : {};
-    delete details.successCategory;
-    const message = outputFile.error ?? "Output file failed.";
-    return {
-        ...result,
-        content: appendOutputFileNotice(result, rejected
-            ? `Output file rejected: ${message}`
-            : `Output file failed: ${outputFile.path} (${message}).`, true),
-        details: {
-            ...details,
-            error: message,
-            summary: rejected ? "Output file rejected." : "Output file failed.",
-            failureCategory: rejected
-                ? "validation-error"
-                : (details.failureCategory ?? "upstream-error"),
-            outputFile,
-            resultCategory: "failure",
-        },
-        isError: true,
-    };
-}
-async function saveOutput(result, destination, preserveText) {
-    const payload = await getOutputPayload(result);
-    const serialized = typeof payload.value === "string"
-        ? payload.value
-        : `${JSON.stringify(payload.value, null, 2)}\n`;
-    await mkdir(dirname(destination.absolutePath), { recursive: true });
-    await writeFile(destination.absolutePath, serialized, "utf8");
-    const bytes = Buffer.byteLength(serialized, "utf8");
-    const outputFile = {
-        ...destination,
-        bytes,
-        source: payload.source,
-        status: "saved",
-    };
-    const details = isRecord(result.details) ? { ...result.details, outputFile } : { outputFile };
-    return {
-        ...result,
-        content: preserveText
-            ? result.content
-            : appendOutputFileNotice(result, `Output file: ${destination.path} (${bytes} bytes from ${payload.source}).`),
-        details,
-    };
-}
-export async function applyAgentBrowserOutputPath(options) {
-    if (options.outputPath === undefined ||
-        options.outputPath.length === 0 ||
-        !canWriteAgentBrowserOutput(options.result)) {
-        return options.result;
-    }
-    const path = normalizeRequestedOutputPath(options.outputPath);
-    const destination = {
-        absolutePath: isAbsolute(path) ? path : resolve(options.cwd, path),
-        path,
-        source: getOutputSource(options.result),
-        status: "failed",
-    };
-    if (await overlapsArtifact(options.result, destination.absolutePath, options.cwd)) {
-        return failedOutputResult(options.result, {
-            ...destination,
-            error: "outputPath resolves to the same file as a browser artifact destination; choose a separate outputPath or omit it. The browser artifact was preserved.",
-        }, true);
-    }
-    try {
-        return await saveOutput(options.result, destination, options.preserveTextContent === true);
-    }
-    catch (error) {
-        return failedOutputResult(options.result, { ...destination, error: error instanceof Error ? error.message : stringifyUnknown(error) }, false);
-    }
-}