pi-agent-browser-native 0.9.4 → 0.9.6

package/dist/extensions/agent-browser/lib/results/snapshot-segments.js

@@ -1,383 +0,0 @@
-import { normalizeWhitespace, truncateText } from "./text.js";
-const SNAPSHOT_MAX_ADDITIONAL_SECTIONS = 2;
-const SNAPSHOT_FALLBACK_PREVIEW_MAX_LINES = 12;
-const SNAPSHOT_LINE_MAX_CHARS = 140;
-const SNAPSHOT_SIGNAL_ROLES = new Set([
-    "article",
-    "banner",
-    "button",
-    "checkbox",
-    "combobox",
-    "dialog",
-    "gridcell",
-    "heading",
-    "link",
-    "listitem",
-    "main",
-    "menu",
-    "menuitem",
-    "navigation",
-    "option",
-    "radio",
-    "region",
-    "row",
-    "searchbox",
-    "tab",
-    "textbox",
-]);
-const SNAPSHOT_SEGMENT_ROOT_ROLES = new Set([
-    "article",
-    "dialog",
-    "heading",
-    "main",
-    "menu",
-    "region",
-]);
-const SNAPSHOT_ROLE_PRIORITY = {
-    article: 0,
-    main: 1,
-    dialog: 2,
-    menu: 3,
-    region: 4,
-    heading: 5,
-    searchbox: 6,
-    textbox: 7,
-    combobox: 8,
-    button: 9,
-    checkbox: 10,
-    radio: 11,
-    tab: 12,
-    option: 13,
-    link: 14,
-    listitem: 14,
-    row: 15,
-    gridcell: 16,
-    navigation: 17,
-    generic: 99,
-    unknown: 100,
-};
-const SNAPSHOT_NOISE_NAME_PATTERNS = [
-    /^skip to /i,
-    /^ad$/i,
-    /^don't want to see ads\??$/i,
-    /keyboard shortcuts/i,
-    /\bpromoted\b/i,
-    /\bsponsored\b/i,
-];
-const SNAPSHOT_CHROME_SECTION_PATTERNS = [
-    /^primary$/i,
-    /^footer$/i,
-    /^navigation$/i,
-    /\bwhat['’]?s happening\b/i,
-    /\brelevant people\b/i,
-    /\btrending\b/i,
-    /\brelated\b/i,
-    /\brecommended\b/i,
-    /\bsuggested\b/i,
-];
-export function getSnapshotRolePriority(role) {
-    return SNAPSHOT_ROLE_PRIORITY[role] ?? 50;
-}
-function parseSnapshotHeadingLevel(text) {
-    const level = text.match(/\blevel=(\d+)/)?.[1];
-    return level !== undefined && level.length > 0 ? Number(level) : undefined;
-}
-export function parseSnapshotLines(snapshot) {
-    return snapshot
-        .split("\n")
-        .filter((line) => line.length > 0)
-        .map((raw, index) => {
-        const trimmed = raw.trimStart();
-        const depth = Math.floor((raw.match(/^\s*/)?.[0].length ?? 0) / 2);
-        const role = trimmed.match(/^[-*]\s+([^\s"]+)/)?.[1] ?? "unknown";
-        const name = normalizeWhitespace(trimmed.match(/"([^"]*)"/)?.[1] ?? "");
-        const ref = trimmed.match(/\bref=([^,\]\s]+)/)?.[1];
-        return {
-            depth,
-            headingLevel: parseSnapshotHeadingLevel(trimmed),
-            index,
-            name,
-            raw,
-            ref,
-            role,
-        };
-    });
-}
-export function isNoiseName(name) {
-    return SNAPSHOT_NOISE_NAME_PATTERNS.some((pattern) => pattern.test(name));
-}
-export function isChromeSectionName(name) {
-    return SNAPSHOT_CHROME_SECTION_PATTERNS.some((pattern) => pattern.test(name));
-}
-function isNoiseSnapshotLine(line) {
-    if (line.name.length > 0 && isNoiseName(line.name)) {
-        return true;
-    }
-    const loweredRaw = line.raw.toLowerCase();
-    return loweredRaw.includes("promoted") || loweredRaw.includes("sponsored");
-}
-function isPotentialSegmentRootLine(line) {
-    if (!SNAPSHOT_SEGMENT_ROOT_ROLES.has(line.role)) {
-        return false;
-    }
-    if (isNoiseSnapshotLine(line)) {
-        return false;
-    }
-    if (line.role === "heading") {
-        return line.name.length > 0 && (line.headingLevel ?? 99) <= 3;
-    }
-    if (line.role === "region") {
-        return line.name.length > 0;
-    }
-    return true;
-}
-function getHeadingPriorityScore(level) {
-    switch (level) {
-        case 1:
-            return 40;
-        case 2:
-            return 22;
-        case 3:
-            return 12;
-        case undefined:
-            return 0;
-        default:
-            return 0;
-    }
-}
-function scoreSegment(segment) {
-    const { root } = segment;
-    const distinctRefs = new Set(segment.lines.flatMap((line) => line.ref !== undefined && line.ref.length > 0 ? [line.ref] : [])).size;
-    let score = 0;
-    score += 120 - getSnapshotRolePriority(root.role) * 8;
-    score += Math.min(distinctRefs, 16);
-    score += Math.min(segment.lines.length, 12);
-    score -= Math.min(root.index, 60) / 3;
-    score -= root.depth * 6;
-    if (root.role === "heading") {
-        score += getHeadingPriorityScore(root.headingLevel);
-    }
-    if (root.name.length > 0) {
-        score += 10;
-    }
-    if (root.name.length <= 2) {
-        score -= 18;
-    }
-    if (isChromeSectionName(root.name)) {
-        score -= 45;
-    }
-    if (isNoiseName(root.name)) {
-        score -= 1000;
-    }
-    return score;
-}
-function hasDuplicateSegmentAncestor(line, stack) {
-    const name = normalizeWhitespace(line.name.toLowerCase());
-    if (name.length === 0) {
-        return false;
-    }
-    for (let index = stack.length - 1; index >= 0; index -= 1) {
-        const ancestor = stack.at(index);
-        if (ancestor &&
-            normalizeWhitespace(ancestor.name.toLowerCase()) === name &&
-            SNAPSHOT_SEGMENT_ROOT_ROLES.has(ancestor.role)) {
-            return true;
-        }
-    }
-    return false;
-}
-export function buildSnapshotSegments(snapshotLines) {
-    const roots = [];
-    const stack = [];
-    for (const line of snapshotLines) {
-        stack.length = line.depth;
-        if (isPotentialSegmentRootLine(line) && !hasDuplicateSegmentAncestor(line, stack)) {
-            roots.push(line);
-        }
-        stack[line.depth] = line;
-    }
-    return roots.map((root, index) => {
-        let endIndexExclusive = snapshotLines.length;
-        for (let nextIndex = index + 1; nextIndex < roots.length; nextIndex += 1) {
-            const candidate = roots[nextIndex];
-            if (candidate.depth <= root.depth) {
-                endIndexExclusive = candidate.index;
-                break;
-            }
-        }
-        const lines = snapshotLines.slice(root.index, endIndexExclusive);
-        const segment = {
-            endIndexExclusive,
-            lines,
-            root,
-            score: 0,
-            startIndex: root.index,
-        };
-        return Object.assign({}, segment, { score: scoreSegment(segment) });
-    });
-}
-export function choosePrimarySegment(segments) {
-    if (segments.length === 0) {
-        return undefined;
-    }
-    return (segments.find((segment) => segment.root.role === "main" || segment.root.role === "article") ??
-        segments.find((segment) => segment.root.role === "heading" && segment.root.headingLevel === 1) ??
-        segments.find((segment) => segment.score >= 90) ??
-        [...segments].sort((left, right) => {
-            const difference = right.score - left.score;
-            return difference !== 0 && !Number.isNaN(difference)
-                ? difference
-                : left.startIndex - right.startIndex;
-        })[0]);
-}
-function isChromePreviewSegment(segment) {
-    return (isChromeSectionName(segment.root.name) ||
-        (segment.root.role === "heading" && segment.root.name.length <= 2));
-}
-export function chooseAdditionalSegments(segments, primary) {
-    if (!primary) {
-        return [];
-    }
-    const seenNames = new Set([normalizeWhitespace(primary.root.name.toLowerCase())]);
-    const rankedCandidates = segments
-        .filter((segment) => segment !== primary && segment.score >= 45)
-        .sort((left, right) => {
-        const leftDistance = Math.abs(left.startIndex - primary.startIndex);
-        const rightDistance = Math.abs(right.startIndex - primary.startIndex);
-        if (leftDistance !== rightDistance) {
-            return leftDistance - rightDistance;
-        }
-        if (right.score !== left.score) {
-            return right.score - left.score;
-        }
-        return left.startIndex - right.startIndex;
-    });
-    const chosen = [];
-    for (const segment of rankedCandidates) {
-        if (chosen.length >= SNAPSHOT_MAX_ADDITIONAL_SECTIONS) {
-            break;
-        }
-        if (isChromePreviewSegment(segment)) {
-            continue;
-        }
-        const nameKey = normalizeWhitespace(segment.root.name.toLowerCase());
-        if (nameKey.length > 0 && seenNames.has(nameKey)) {
-            continue;
-        }
-        chosen.push(segment);
-        if (nameKey.length > 0) {
-            seenNames.add(nameKey);
-        }
-    }
-    return chosen.sort((left, right) => left.startIndex - right.startIndex);
-}
-export function getMeaningfulSegmentLines(segment) {
-    return segment.lines.filter((line) => {
-        if (isNoiseSnapshotLine(line)) {
-            return false;
-        }
-        if (line.role === "generic" && (line.ref ?? "") === "" && line.name.length === 0) {
-            return false;
-        }
-        if (line.role === "link" && line.name.length === 0) {
-            return false;
-        }
-        return true;
-    });
-}
-function formatPreviewLine(line, baseDepth) {
-    const leadingWhitespace = (line.raw.match(/^\s*/) ?? [""])[0].length;
-    const stripChars = Math.min(leadingWhitespace, Math.max(0, baseDepth) * 2);
-    return truncateText(line.raw.slice(stripChars), SNAPSHOT_LINE_MAX_CHARS);
-}
-function isRedundantPreviewLine(line, root) {
-    if (line === root) {
-        return false;
-    }
-    return ((root.role !== "heading" && line.depth - root.depth > 2) ||
-        (root.name.length > 0 &&
-            line.name === root.name &&
-            (line.role === "heading" || line.role === "link")));
-}
-export function buildSegmentPreview(segment, maxLines) {
-    const meaningfulLines = getMeaningfulSegmentLines(segment);
-    if (meaningfulLines.length === 0) {
-        return { omittedCount: 0, refIds: [], lines: [] };
-    }
-    const previewLines = [];
-    const previewRefIds = new Set();
-    const seenPreviewKeys = new Set();
-    const rootDepth = segment.root.depth;
-    for (const line of meaningfulLines) {
-        if (previewLines.length >= maxLines) {
-            break;
-        }
-        if (isRedundantPreviewLine(line, segment.root)) {
-            continue;
-        }
-        const key = `${line.role}:${line.name}:${line.ref ?? ""}:${line.depth}`;
-        if (seenPreviewKeys.has(key)) {
-            continue;
-        }
-        seenPreviewKeys.add(key);
-        previewLines.push(line);
-        if (line.ref !== undefined && line.ref.length > 0) {
-            previewRefIds.add(line.ref);
-        }
-    }
-    return {
-        omittedCount: Math.max(0, meaningfulLines.length - previewLines.length),
-        refIds: [...previewRefIds],
-        lines: previewLines.map((line) => formatPreviewLine(line, rootDepth)),
-    };
-}
-function hasSnapshotSignal(line) {
-    return (SNAPSHOT_SIGNAL_ROLES.has(line.role) || (line.ref ?? "").length > 0 || line.name.length > 0);
-}
-export function buildFallbackSnapshotOutline(snapshotLines) {
-    const selected = new Set();
-    for (let index = 0; index < snapshotLines.length && selected.size < 4; index += 1) {
-        if (!isNoiseSnapshotLine(snapshotLines[index])) {
-            selected.add(index);
-        }
-    }
-    for (let index = 0; index < snapshotLines.length && selected.size < SNAPSHOT_FALLBACK_PREVIEW_MAX_LINES; index += 1) {
-        const line = snapshotLines[index];
-        if (isNoiseSnapshotLine(line)) {
-            continue;
-        }
-        if (hasSnapshotSignal(line)) {
-            selected.add(index);
-        }
-    }
-    const chosenLines = [...selected]
-        .sort((left, right) => left - right)
-        .slice(0, SNAPSHOT_FALLBACK_PREVIEW_MAX_LINES)
-        .map((index) => snapshotLines[index]);
-    return {
-        omittedCount: Math.max(0, snapshotLines.length - chosenLines.length),
-        refIds: chosenLines.flatMap((line) => line.ref !== undefined && line.ref.length > 0 ? [line.ref] : []),
-        lines: chosenLines.map((line) => truncateText(line.raw, SNAPSHOT_LINE_MAX_CHARS)),
-    };
-}
-export function buildRefLineOrderMap(snapshotLines) {
-    const map = new Map();
-    for (const line of snapshotLines) {
-        if (line.ref === undefined || line.ref.length === 0 || map.has(line.ref)) {
-            continue;
-        }
-        map.set(line.ref, line.index);
-    }
-    return map;
-}
-export function canUseStructuredSnapshotPreview(snapshotLines, refEntries) {
-    if (snapshotLines.length === 0) {
-        return false;
-    }
-    const linesWithRecognizedRoles = snapshotLines.filter((line) => line.role !== "unknown").length;
-    const linesWithNames = snapshotLines.filter((line) => line.name.length > 0).length;
-    const parsedRefIds = new Set(snapshotLines.flatMap((line) => line.ref !== undefined && line.ref.length > 0 ? [line.ref] : []));
-    return (linesWithRecognizedRoles >= Math.min(snapshotLines.length, 3) ||
-        linesWithNames >= Math.min(snapshotLines.length, 3) ||
-        parsedRefIds.size >= Math.min(refEntries.length, 3));
-}

package/dist/extensions/agent-browser/lib/results/snapshot-spill.js

@@ -1,53 +0,0 @@
-import { redactSensitiveValue } from "../runtime-redaction.js";
-import { writePersistentSessionArtifactFile, writeSecureTempFile, } from "../temp.js";
-import { buildEvictedSessionArtifactEntries, formatSessionArtifactRetentionSummary, mergeSessionArtifactManifest, } from "./artifact-manifest.js";
-const SNAPSHOT_SPILL_FILE_PREFIX = "pi-agent-browser-snapshot";
-export async function writeSnapshotSpillFile(data, persistentArtifactStore) {
-    const options = {
-        content: JSON.stringify(redactSensitiveValue(data), null, 2),
-        prefix: SNAPSHOT_SPILL_FILE_PREFIX,
-        suffix: ".json",
-    };
-    if (persistentArtifactStore) {
-        const result = await writePersistentSessionArtifactFile({
-            ...options,
-            store: persistentArtifactStore,
-        });
-        return { ...result, storageScope: "persistent-session" };
-    }
-    return {
-        evictedArtifacts: [],
-        path: await writeSecureTempFile(options),
-        storageScope: "process-temp",
-    };
-}
-export function applySnapshotArtifactManifest(options) {
-    if (options.fullOutputPath === undefined ||
-        options.fullOutputPath.length === 0 ||
-        !options.spill) {
-        return {};
-    }
-    const nowMs = Date.now();
-    const entries = [
-        {
-            command: options.command,
-            createdAtMs: nowMs,
-            kind: "spill",
-            path: options.fullOutputPath,
-            retentionState: options.spill.storageScope === "persistent-session" ? "live" : "ephemeral",
-            storageScope: options.spill.storageScope,
-        },
-        ...buildEvictedSessionArtifactEntries(options.spill.evictedArtifacts, nowMs),
-    ];
-    const artifactManifest = mergeSessionArtifactManifest({
-        base: options.baseManifest,
-        entries,
-        nowMs,
-    });
-    return artifactManifest
-        ? {
-            artifactManifest,
-            artifactRetentionSummary: formatSessionArtifactRetentionSummary(artifactManifest),
-        }
-        : {};
-}

package/dist/extensions/agent-browser/lib/results/snapshot.js

@@ -1,44 +0,0 @@
-import { isRecord } from "../parsing.js";
-import { buildCompactSnapshotView } from "./snapshot-compact.js";
-import { formatRawSnapshotText, formatSnapshotSummary, getSnapshotText, } from "./snapshot-content.js";
-import { getSnapshotRefEntries } from "./snapshot-refs.js";
-import { applySnapshotArtifactManifest, writeSnapshotSpillFile, } from "./snapshot-spill.js";
-import { countLines, stringifyUnknown } from "./text.js";
-export { formatRawSnapshotText, formatSnapshotSummary } from "./snapshot-content.js";
-function shouldCompactSnapshot(rawText, data) {
-    return (rawText.length > 6_000 ||
-        countLines(getSnapshotText(data) ?? "") > 80 ||
-        getSnapshotRefEntries(data).length > 60);
-}
-async function getSnapshotSpill(data, store) {
-    try {
-        const spill = await writeSnapshotSpillFile(data, store);
-        return { spill, fullOutputPath: spill.path };
-    }
-    catch (error) {
-        return { spillErrorText: error instanceof Error ? error.message : stringifyUnknown(error) };
-    }
-}
-export async function buildSnapshotPresentation(data, persistentArtifactStore, artifactManifest) {
-    const summary = formatSnapshotSummary(data);
-    const rawText = formatRawSnapshotText(data);
-    // Native partials are patches, not accessibility trees; large-output owns oversized patches.
-    if ((isRecord(data.snapshot) && data.snapshot.kind !== "full") ||
-        !shouldCompactSnapshot(rawText, data)) {
-        return { content: [{ type: "text", text: rawText }], data, summary };
-    }
-    const { spill, fullOutputPath, spillErrorText } = await getSnapshotSpill(data, persistentArtifactStore);
-    const compact = buildCompactSnapshotView(data, fullOutputPath, spillErrorText);
-    const manifestFields = applySnapshotArtifactManifest({
-        baseManifest: artifactManifest,
-        command: "snapshot",
-        fullOutputPath,
-        spill,
-    });
-    const notice = manifestFields.artifactRetentionSummary;
-    const text = compact.content.at(0);
-    if (notice !== undefined && notice.length > 0 && text?.type === "text") {
-        compact.content[0] = { type: "text", text: `${text.text}\n\n${notice}` };
-    }
-    return { ...manifestFields, ...compact, fullOutputPath, summary: `${summary} (compact)` };
-}

package/dist/extensions/agent-browser/lib/results/text.js

@@ -1,44 +0,0 @@
-export function stringifyUnknown(value) {
-    if (typeof value === "string") {
-        return value;
-    }
-    if (typeof value === "number" || typeof value === "boolean") {
-        return String(value);
-    }
-    if (value === null || value === undefined) {
-        return "";
-    }
-    try {
-        const serialized = JSON.stringify(value, null, 2);
-        return typeof serialized === "string" ? serialized : "";
-    }
-    catch {
-        return stringifyFallback(value);
-    }
-}
-function stringifyFallback(value) {
-    if (typeof value === "bigint" || typeof value === "symbol" || typeof value === "function") {
-        return String(value);
-    }
-    return Object.prototype.toString.call(value);
-}
-export function countLines(text) {
-    return text.length === 0 ? 0 : text.split("\n").length;
-}
-export function normalizeWhitespace(text) {
-    return text.replace(/\s+/g, " ").trim();
-}
-export function truncateText(text, maxChars) {
-    if (text.length <= maxChars) {
-        return text;
-    }
-    return `${text.slice(0, Math.max(1, maxChars - 1))}…`;
-}
-export function compareRefIds(left, right) {
-    const leftMatch = left.match(/^(?:[a-zA-Z]+)?(\d+)$/);
-    const rightMatch = right.match(/^(?:[a-zA-Z]+)?(\d+)$/);
-    if (leftMatch && rightMatch) {
-        return Number(leftMatch[1]) - Number(rightMatch[1]);
-    }
-    return left.localeCompare(right);
-}

package/dist/extensions/agent-browser/lib/runtime-args-validation.js

@@ -1,133 +0,0 @@
-import { parseArgvDescriptor } from "./argv-descriptor.js";
-import { GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES, GLOBAL_VALUE_FLAGS_ALLOWING_DASH_VALUE, PREVALIDATED_VALUE_FLAGS, stripUpstreamGlobalFlags, } from "./argv-grammar.js";
-import { isOpenNavigationCommand } from "./command-taxonomy.js";
-import { TARGET_AGENT_BROWSER_VERSION } from "./upstream-version.js";
-const INSPECTION_FLAGS = new Set(["--help", "-h", "--version", "-V"]);
-const SHELL_OPERATOR_TOKENS = new Set(["&&", "||", "|", ";", ">", ">>", "<"]);
-export function isPlainTextInspectionArgs(args) {
-    return args.some((token) => INSPECTION_FLAGS.has(token));
-}
-function getSingleKeyCommandValidationError(args) {
-    const { commandInfo, upstreamCommandTokens: tokens } = parseArgvDescriptor(args);
-    const command = commandInfo.command;
-    if (!["press", "key", "keydown", "keyup"].includes(command ?? "") || tokens.length === 2) {
-        return;
-    }
-    const label = command === "key" ? "key/press" : command;
-    return `agent-browser ${label ?? ""} accepts exactly one key argument. Do not pass a selector or ref to ${label ?? ""}; focus or click the target first, then run ${command ?? ""} <key> (for example: focus @e1, then press Enter).`;
-}
-function getBareMcpValidationError(args) {
-    const { commandInfo, upstreamCommandTokens: tokens } = parseArgvDescriptor(args);
-    if (commandInfo.command !== "mcp" || tokens.includes("--help") || tokens.includes("-h")) {
-        return;
-    }
-    return "agent-browser mcp starts a stdio MCP server for external MCP clients, not a one-shot native agent_browser tool workflow. Use the native agent_browser tool modes directly, or configure an MCP client to launch `agent-browser mcp`. Use `mcp --help` for help.";
-}
-function getUnsupportedInlineWaitDownloadError(args) {
-    const descriptor = parseArgvDescriptor(args);
-    if (descriptor.commandInfo.command !== "wait" ||
-        !descriptor.upstreamCommandTokens.some((token) => token.startsWith("--download="))) {
-        return;
-    }
-    return `agent-browser ${TARGET_AGENT_BROWSER_VERSION} does not support \`wait --download=<path>\`. Pass the optional path as a separate argument: \`wait --download <path>\` (or \`wait -d <path>\`).`;
-}
-function getBareNoSandboxValidationError(args, batchStep) {
-    // Native batch rows skip global parsing; --args is effective only on the outer CLI call.
-    const tokens = batchStep ? args : stripUpstreamGlobalFlags(args);
-    const command = tokens[0];
-    const leading = command === "--no-sandbox";
-    if (!leading &&
-        (!isOpenNavigationCommand(command) || !tokens.slice(1).includes("--no-sandbox"))) {
-        return;
-    }
-    const explanation = leading
-        ? "`--no-sandbox` is not an agent-browser command."
-        : `\`--no-sandbox\` is ignored as an option by \`${command}\`.`;
-    return `${explanation} It is a Chromium launch argument. Put it in top-level \`--args\` and start a fresh session: { args: ["--args", "--no-sandbox", "open", "https://example.com"], sessionMode: "fresh" }. For batch, put --args before batch, not inside a step.`;
-}
-function getForbiddenToolTokenError(args) {
-    const shellOperator = args.find((token) => SHELL_OPERATOR_TOKENS.has(token));
-    if (shellOperator !== undefined) {
-        return `Do not pass shell operators like \`${shellOperator}\`. Pass exact agent-browser CLI arguments only.`;
-    }
-    if (args.some((token) => token === "--session-mode" || token.startsWith("--session-mode="))) {
-        return 'Do not pass `--session-mode` in args. Use the top-level agent_browser `sessionMode` field instead, for example { args: ["--profile", "Default", "open", "https://example.com"], sessionMode: "fresh" }.';
-    }
-    return;
-}
-export function validateToolArgs(args, options = {}) {
-    if (args.length === 0) {
-        return "`args` must contain at least one agent-browser command token.";
-    }
-    const forbidden = getForbiddenToolTokenError(args);
-    if (forbidden !== undefined) {
-        return forbidden;
-    }
-    return getNativeCommandShapeError(args, options.batchStep === true);
-}
-function getNativeCommandShapeError(args, batchStep) {
-    const inspection = !batchStep && isPlainTextInspectionArgs(args);
-    const invalidValueFlag = inspection ? undefined : getInvalidValueFlagDetails(args, !batchStep);
-    if (invalidValueFlag?.reason === "unsupported-assignment") {
-        return formatInvalidValueFlagError(invalidValueFlag, batchStep);
-    }
-    return ((inspection ? undefined : getBareNoSandboxValidationError(args, batchStep)) ??
-        getBareMcpValidationError(args) ??
-        getSingleKeyCommandValidationError(args) ??
-        getUnsupportedInlineWaitDownloadError(args));
-}
-function unsupportedAssignment(token, flag, allowRestoreAssignment) {
-    return (token.includes("=") &&
-        (PREVALIDATED_VALUE_FLAGS.has(flag) ||
-            GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES.has(flag) ||
-            (!allowRestoreAssignment && flag === "--restore")));
-}
-function valueFlagProblem(flag, receivedToken) {
-    if (receivedToken === undefined || (flag === "--args" && receivedToken.length === 0)) {
-        return "missing-value";
-    }
-    if (receivedToken.startsWith("-") && !GLOBAL_VALUE_FLAGS_ALLOWING_DASH_VALUE.has(flag)) {
-        return "unexpected-flag";
-    }
-    return;
-}
-export function getInvalidValueFlagDetails(args, allowRestoreAssignment = true) {
-    for (let index = 0; index < args.length; index += 1) {
-        const token = args[index];
-        if (!token.startsWith("-")) {
-            continue;
-        }
-        const flag = token.split("=", 1)[0] ?? token;
-        if (unsupportedAssignment(token, flag, allowRestoreAssignment)) {
-            return { flag, index, reason: "unsupported-assignment" };
-        }
-        if (!PREVALIDATED_VALUE_FLAGS.has(flag)) {
-            continue;
-        }
-        const receivedToken = args.at(index + 1);
-        const reason = valueFlagProblem(flag, receivedToken);
-        if (reason !== undefined) {
-            return reason === "unexpected-flag"
-                ? { flag, index, reason, receivedToken }
-                : { flag, index, reason };
-        }
-        index += 1;
-    }
-    return;
-}
-export function formatInvalidValueFlagError(details, batchStep = false) {
-    if (details.reason === "unsupported-assignment") {
-        if (batchStep) {
-            return details.flag === "--restore"
-                ? "Global `--restore=<key>` belongs before `batch` in top-level args, not inside a batch step."
-                : `Global \`${details.flag}=<value>\` is not supported inside a batch step. Move \`${details.flag}\` and its value before \`batch\` as separate top-level args.`;
-        }
-        return `agent-browser ${TARGET_AGENT_BROWSER_VERSION} does not support \`${details.flag}=<value>\`. Pass \`${details.flag}\` and its value as separate arguments.`;
-    }
-    if (details.reason === "unexpected-flag" &&
-        details.receivedToken !== undefined &&
-        details.receivedToken.length > 0) {
-        return `Flag \`${details.flag}\` requires a value, but received \`${details.receivedToken}\` instead. Pass a non-flag value immediately after \`${details.flag}\`.`;
-    }
-    return `Flag \`${details.flag}\` requires a value immediately after it. Pass a non-flag token like \`${details.flag} demo\`.`;
-}