pi-agent-browser-native 0.9.5 → 0.9.7

package/dist/extensions/agent-browser/lib/runtime-tab-correction.js

@@ -1,65 +0,0 @@
-function normalizeComparableUrl(url) {
-    const normalizedUrl = url.trim();
-    if (normalizedUrl.length === 0) {
-        return;
-    }
-    try {
-        const parsedUrl = new URL(normalizedUrl);
-        parsedUrl.hash = "";
-        return parsedUrl.toString();
-    }
-    catch {
-        return;
-    }
-}
-function normalizeTabSelectionValue(value) {
-    const normalizedValue = value?.trim();
-    return normalizedValue !== undefined && normalizedValue.length > 0 ? normalizedValue : undefined;
-}
-function extractTabSelection(tab) {
-    const tabId = normalizeTabSelectionValue(tab.tabId);
-    if (tabId !== undefined) {
-        return { selectedTab: tabId, selectionKind: "tabId" };
-    }
-    const label = normalizeTabSelectionValue(tab.label);
-    if (label !== undefined) {
-        return { selectedTab: label, selectionKind: "label" };
-    }
-    if (typeof tab.index === "number" && Number.isInteger(tab.index) && tab.index >= 0) {
-        return { selectedTab: String(tab.index), selectionKind: "index" };
-    }
-    return;
-}
-function selectMatchingTab(tabs, targetTitle) {
-    const title = typeof targetTitle === "string" ? targetTitle.trim() : "";
-    const titledMatch = title.length === 0
-        ? undefined
-        : tabs.find((tab) => typeof tab.title === "string" && tab.title.trim() === title);
-    return {
-        selection: extractTabSelection(titledMatch ?? tabs[0]),
-        targetTitle: title.length > 0 ? title : undefined,
-    };
-}
-export function chooseOpenResultTabCorrection(options) {
-    const normalizedTargetUrl = typeof options.targetUrl === "string" ? normalizeComparableUrl(options.targetUrl) : undefined;
-    if (normalizedTargetUrl === undefined) {
-        return;
-    }
-    const tabsWithIndices = options.tabs.map((tab, index) => ({
-        ...tab,
-        index: typeof tab.index === "number" ? tab.index : index,
-        label: normalizeTabSelectionValue(tab.label),
-        tabId: normalizeTabSelectionValue(tab.tabId),
-    }));
-    const activeTab = tabsWithIndices.find((tab) => tab.active === true) ??
-        tabsWithIndices.find((tab) => tab.index === options.activeTabIndex);
-    if (activeTab && normalizeComparableUrl(activeTab.url ?? "") === normalizedTargetUrl) {
-        return;
-    }
-    const matchingTabs = tabsWithIndices.filter((tab) => normalizeComparableUrl(tab.url ?? "") === normalizedTargetUrl);
-    if (matchingTabs.length === 0) {
-        return;
-    }
-    const { selection, targetTitle } = selectMatchingTab(matchingTabs, options.targetTitle);
-    return selection ? { ...selection, targetTitle, targetUrl: normalizedTargetUrl } : undefined;
-}

package/dist/extensions/agent-browser/lib/runtime-timeouts.js

@@ -1,28 +0,0 @@
-import { getAgentBrowserProcessEnvironment } from "./process-environment.js";
-const DEFAULT_IMPLICIT_SESSION_IDLE_TIMEOUT_MS = 15 * 60 * 1000;
-// Native close includes a five-second Chrome exit grace after protocol shutdown.
-// Use the normal CLI watchdog budget rather than interrupting that grace.
-const DEFAULT_IMPLICIT_SESSION_CLOSE_TIMEOUT_MS = 35_000;
-function parseTimeoutMs(rawValue, minimumValue) {
-    if (rawValue === undefined) {
-        return;
-    }
-    const normalizedValue = rawValue.trim();
-    if (!/^\d+$/.test(normalizedValue)) {
-        return;
-    }
-    const parsedValue = Number(normalizedValue);
-    if (!Number.isSafeInteger(parsedValue) || parsedValue < minimumValue) {
-        return;
-    }
-    return parsedValue;
-}
-export function getImplicitSessionIdleTimeoutMs(env = getAgentBrowserProcessEnvironment()) {
-    return (parseTimeoutMs(env.PI_AGENT_BROWSER_IMPLICIT_SESSION_IDLE_TIMEOUT_MS, 0) ??
-        parseTimeoutMs(env.AGENT_BROWSER_IDLE_TIMEOUT_MS, 0) ??
-        DEFAULT_IMPLICIT_SESSION_IDLE_TIMEOUT_MS);
-}
-export function getImplicitSessionCloseTimeoutMs(env = getAgentBrowserProcessEnvironment()) {
-    return (parseTimeoutMs(env.PI_AGENT_BROWSER_IMPLICIT_SESSION_CLOSE_TIMEOUT_MS, 0) ??
-        DEFAULT_IMPLICIT_SESSION_CLOSE_TIMEOUT_MS);
-}

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

@@ -1,163 +0,0 @@
-import { parseArgvDescriptor } from "./argv-descriptor.js";
-import { canonicalizeAgentBrowserNamespace, extractExplicitNamespace, extractExplicitSessionName, getAgentBrowserSessionIdentityKey, getBooleanFlagValue, scanUpstreamGlobalFlagOccurrences, } from "./argv-grammar.js";
-import { needsManagedSession } from "./command-policy.js";
-import { isCloseCommand } from "./command-taxonomy.js";
-import { hasLaunchScopedFlagToken, LAUNCH_SCOPED_FLAG_DEFINITIONS } from "./launch-scoped-flags.js";
-import { getAgentBrowserProcessEnvironment } from "./process-environment.js";
-import { formatInvalidValueFlagError, getInvalidValueFlagDetails, isPlainTextInspectionArgs, } from "./runtime-args-validation.js";
-import { canUseHeadlessCompatibilityUserAgent, getCompatibilityWorkaround, getDefaultHeadlessCompatUserAgent, } from "./runtime-compatibility.js";
-import { freshSessionRecoveryHint, launchFlagsRecoveryReason, selectExecutionSession, stripExplicitIdentityArgs, } from "./runtime-session-plan.js";
-export { extractCommandTokens, extractUpstreamCommandTokens, findCommandStartIndex, parseArgvDescriptor, parseCommandInfo, parseWaitCommandTokens, } from "./argv-descriptor.js";
-export { redactSensitiveText, redactSensitiveValue, redactInvocationArgs, } from "./runtime-redaction.js";
-export { getImplicitSessionIdleTimeoutMs, getImplicitSessionCloseTimeoutMs, } from "./runtime-timeouts.js";
-export { isPlainTextInspectionArgs, validateToolArgs } from "./runtime-args-validation.js";
-export { canUseHeadlessCompatibilityUserAgent, getDefaultHeadlessCompatUserAgent, } from "./runtime-compatibility.js";
-export { createEphemeralSessionSeed, createImplicitSessionName, createFreshSessionName, isRestorableManagedSessionName, resolveManagedSessionState, } from "./runtime-session-identity.js";
-export { restoreManagedSessionStateFromBranch } from "./runtime-session-replay.js";
-export { chooseOpenResultTabCorrection } from "./runtime-tab-correction.js";
-export function getStartupScopedFlags(args) {
-    return LAUNCH_SCOPED_FLAG_DEFINITIONS.map((definition) => definition.flag).filter((flag) => hasLaunchScopedFlagToken(args, flag));
-}
-function withNativeSession(args) {
-    const nativeSession = getAgentBrowserProcessEnvironment().AGENT_BROWSER_SESSION;
-    if (nativeSession !== undefined &&
-        !isPlainTextInspectionArgs(args) &&
-        extractExplicitSessionName(args) === undefined) {
-        return ["--session", nativeSession, ...args];
-    }
-    return args;
-}
-function jsonPrefix(args) {
-    return getBooleanFlagValue(args, "--json") === undefined ? ["--json"] : [];
-}
-function planningFailure(args) {
-    const invalidValueFlag = getInvalidValueFlagDetails(args);
-    const repeatedFlag = ["--session", "--namespace"].find((flag) => scanUpstreamGlobalFlagOccurrences(args, flag).length > 1);
-    if (!invalidValueFlag && repeatedFlag === undefined) {
-        return;
-    }
-    const validationError = invalidValueFlag
-        ? formatInvalidValueFlagError(invalidValueFlag)
-        : `Multiple ${repeatedFlag ?? ""} flags are not supported. Pass a single ${repeatedFlag ?? ""} value; upstream uses the last occurrence while this wrapper would otherwise mis-attribute managed-session ownership.`;
-    const plan = {
-        commandInfo: {},
-        effectiveArgs: jsonPrefix(args),
-        plainTextInspection: false,
-        startupScopedFlags: [],
-        usedImplicitSession: false,
-        validationError,
-    };
-    return invalidValueFlag ? { ...plan, invalidValueFlag } : plan;
-}
-function effectiveStartupFlags(args, managedNamespace) {
-    const explicitNamespacePresent = scanUpstreamGlobalFlagOccurrences(args, "--namespace").length > 0;
-    const explicitNamespace = extractExplicitNamespace(args);
-    return getStartupScopedFlags(args).filter((flag) => !(flag === "--namespace" &&
-        explicitNamespacePresent &&
-        explicitNamespace === canonicalizeAgentBrowserNamespace(managedNamespace)));
-}
-function targetsActiveManagedSession(selection, options, needsSession) {
-    const { sessionName } = selection;
-    return (options.managedSessionActive &&
-        needsSession &&
-        sessionName !== undefined &&
-        sessionName.length > 0 &&
-        getAgentBrowserSessionIdentityKey(sessionName, selection.namespace) ===
-            getAgentBrowserSessionIdentityKey(options.managedSessionName, options.managedSessionNamespace));
-}
-function activeLaunchRecovery(args, flags, command, prior) {
-    if (flags.length === 0 ||
-        isCloseCommand(command) ||
-        (prior.validationError !== undefined && prior.validationError.length > 0)) {
-        return prior;
-    }
-    const explicitSession = extractExplicitSessionName(args);
-    const explicit = explicitSession !== undefined && explicitSession.length > 0;
-    const recoveryArgs = explicit ? stripExplicitIdentityArgs(args, "--session") : args;
-    return {
-        recoveryHint: freshSessionRecoveryHint(recoveryArgs, launchFlagsRecoveryReason()),
-        validationError: [
-            `The current extension-managed agent-browser session is already running, so launch-scoped flags ${flags.join(", ")} would replace or be ignored by upstream agent-browser.`,
-            explicit
-                ? 'Remove the explicit `--session` and retry with `sessionMode: "fresh"` to force a fresh upstream launch.'
-                : 'Retry this call with `sessionMode: "fresh"` to force a fresh upstream launch.',
-        ].join(" "),
-    };
-}
-function activeCompatibilityPlan(args, requested, existing, prior) {
-    if (!canUseHeadlessCompatibilityUserAgent(args)) {
-        return { ...prior, compatibilityWorkaround: requested };
-    }
-    if (requested &&
-        !existing &&
-        (prior.validationError === undefined || prior.validationError.length === 0)) {
-        const sessionName = extractExplicitSessionName(args);
-        const explicit = sessionName !== undefined && sessionName.length > 0;
-        const recoveryArgs = explicit ? stripExplicitIdentityArgs(args, "--session") : args;
-        return {
-            compatibilityWorkaround: undefined,
-            recoveryHint: freshSessionRecoveryHint(recoveryArgs, "The requested site compatibility user agent is launch-scoped and needs a fresh browser session."),
-            validationError: explicit
-                ? 'The current extension-managed agent-browser session is already running without the user agent required by this site. Remove the explicit `--session` and retry with `sessionMode: "fresh"` so the compatibility user agent is applied at launch.'
-                : 'The current extension-managed agent-browser session is already running without the user agent required by this site. Retry this call with `sessionMode: "fresh"` so the compatibility user agent is applied at launch.',
-        };
-    }
-    return { ...prior, compatibilityWorkaround: requested ?? existing };
-}
-function inspectionPlan(args, commandInfo, startupScopedFlags) {
-    const explicitNamespacePresent = scanUpstreamGlobalFlagOccurrences(args, "--namespace").length > 0;
-    return {
-        commandInfo,
-        effectiveArgs: [...args],
-        namespace: explicitNamespacePresent ? (extractExplicitNamespace(args) ?? "") : undefined,
-        plainTextInspection: true,
-        startupScopedFlags,
-        usedImplicitSession: false,
-    };
-}
-export function buildExecutionPlan(inputArgs, options) {
-    const args = withNativeSession(inputArgs);
-    const startupScopedFlags = effectiveStartupFlags(args, options.managedSessionNamespace);
-    const descriptor = parseArgvDescriptor(args);
-    const commandInfo = descriptor.commandInfo;
-    if (isPlainTextInspectionArgs(args)) {
-        return inspectionPlan(args, commandInfo, startupScopedFlags);
-    }
-    const failure = planningFailure(args);
-    if (failure) {
-        return failure;
-    }
-    const needsSession = options.browserIndependentReadConfirmation !== true &&
-        needsManagedSession(descriptor, options.stdin);
-    const selection = selectExecutionSession(args, options, {
-        command: commandInfo.command,
-        needsManagedSession: needsSession,
-        startupScopedFlags,
-    });
-    const activeTarget = targetsActiveManagedSession(selection, options, needsSession);
-    const requested = getCompatibilityWorkaround(args, commandInfo);
-    const recovery = activeTarget
-        ? activeLaunchRecovery(args, startupScopedFlags, commandInfo.command, selection)
-        : selection;
-    const compatibility = activeTarget
-        ? activeCompatibilityPlan(args, requested, options.managedSessionCompatibilityWorkaround, recovery)
-        : { ...recovery, compatibilityWorkaround: requested };
-    const effectiveArgs = [...jsonPrefix(args), ...selection.prefixArgs];
-    if (compatibility.compatibilityWorkaround && !activeTarget) {
-        effectiveArgs.push("--user-agent", getDefaultHeadlessCompatUserAgent());
-    }
-    effectiveArgs.push(...selection.argsToAppend);
-    return {
-        commandInfo,
-        compatibilityWorkaround: compatibility.compatibilityWorkaround,
-        effectiveArgs,
-        managedSessionName: selection.managedSessionName,
-        namespace: selection.namespace,
-        plainTextInspection: false,
-        recoveryHint: compatibility.recoveryHint,
-        sessionName: selection.sessionName,
-        startupScopedFlags,
-        usedImplicitSession: selection.usedImplicitSession,
-        validationError: compatibility.validationError,
-    };
-}

package/dist/extensions/agent-browser/lib/session-identity.js

@@ -1,51 +0,0 @@
-const SESSION_COMPONENT_ALPHANUMERIC = /^[\p{Alphabetic}\p{Number}]$/u;
-/** Mirror upstream sanitize_session_component for namespace/socket/state identity. */
-export function canonicalizeAgentBrowserNamespace(value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    let normalized = "";
-    let lastWasSeparator = false;
-    for (const character of value) {
-        if (SESSION_COMPONENT_ALPHANUMERIC.test(character)) {
-            normalized += character.toLowerCase();
-            lastWasSeparator = false;
-            continue;
-        }
-        if (normalized.length > 0 && !lastWasSeparator) {
-            normalized += character === "_" ? "_" : "-";
-            lastWasSeparator = true;
-        }
-    }
-    const result = normalized.replace(/[-_]+$/u, "");
-    return result.length > 0 ? result : undefined;
-}
-export function foldAgentBrowserFilesystemIdentity(value, platform) {
-    if (platform !== "darwin" && platform !== "win32") {
-        return value;
-    }
-    // APFS aliases include full Unicode folds such as ß/SS and ς/Σ, not just ASCII case.
-    return value.normalize("NFC").toLowerCase().toUpperCase().toLowerCase().normalize("NFC");
-}
-export function getAgentBrowserSessionIdentityKey(sessionName, namespace, platform = process.platform) {
-    const canonicalNamespace = canonicalizeAgentBrowserNamespace(namespace);
-    const canonicalSessionName = foldAgentBrowserFilesystemIdentity(sessionName, platform);
-    return canonicalNamespace !== undefined
-        ? `${foldAgentBrowserFilesystemIdentity(canonicalNamespace, platform)}\0${canonicalSessionName}`
-        : canonicalSessionName;
-}
-export function isAgentBrowserSessionIdentityKeyInNamespace(identityKey, namespace) {
-    const prefix = getAgentBrowserSessionIdentityKey("", namespace);
-    return prefix.length > 0 ? identityKey.startsWith(prefix) : !identityKey.includes("\0");
-}
-/** Namespace close retires keys in the caller's ownership index, not a copy. */
-export function deleteIdentityKeysInNamespace(
-// Caller-owned identity indexes deliberately mutate under the namespace execution barrier.
-// oxlint-disable-next-line typescript/prefer-readonly-parameter-types
-entries, namespace) {
-    for (const key of entries.keys()) {
-        if (isAgentBrowserSessionIdentityKeyInNamespace(key, namespace)) {
-            entries.delete(key);
-        }
-    }
-}

package/dist/extensions/agent-browser/lib/session-page-observation.js

@@ -1,357 +0,0 @@
-import { browserStringArray } from "./browser-value-parsing.js";
-import { extractUpstreamCommandTokens } from "./argv-descriptor.js";
-import { getAgentBrowserSessionIdentityKey } from "./argv-grammar.js";
-import { isCloseCommand, isOpenNavigationCommand, isReadOnlyDiagnosticSessionTargetCommand, isRecordPageTransitionCommand, isUnverifiedPageTransitionCommand, isWebMcpPageMutationCommand, isWindowOrDiffPageTransitionCommand, } from "./command-taxonomy.js";
-import { isRecord } from "./parsing.js";
-import { detectConfirmationRequired } from "./results/confirmation.js";
-import { isSuccessfulNativeConfirmedClose } from "./read-confirmation.js";
-import { getEditableRefEvidence } from "./results/editable-ref-evidence.js";
-import { enrichSnapshotRefEntries, getFullSnapshotData, getSnapshotRefEntries, } from "./results/snapshot-refs.js";
-import { parseSnapshotLines } from "./results/snapshot-segments.js";
-export function normalizeComparableUrl(url) {
-    const normalizedUrl = url?.trim();
-    if (normalizedUrl === undefined || normalizedUrl.length === 0) {
-        return undefined;
-    }
-    try {
-        const parsedUrl = new URL(normalizedUrl);
-        parsedUrl.hash = "";
-        return parsedUrl.toString();
-    }
-    catch {
-        return undefined;
-    }
-}
-function trimmedOptionalValue(value) {
-    const trimmed = value?.trim();
-    return trimmed !== undefined && trimmed.length > 0 ? trimmed : undefined;
-}
-export function normalizeSessionTabTarget(target) {
-    if (!target) {
-        return undefined;
-    }
-    const url = trimmedOptionalValue(target.url);
-    if (url === undefined || normalizeComparableUrl(url) === undefined) {
-        return undefined;
-    }
-    const targetId = trimmedOptionalValue(target.targetId);
-    return {
-        ...(targetId !== undefined ? { targetId } : {}),
-        title: trimmedOptionalValue(target.title),
-        url,
-    };
-}
-export function isAboutBlankUrl(url) {
-    return normalizeComparableUrl(url) === "about:blank";
-}
-export function isAboutBlankSessionTabTarget(target) {
-    return isAboutBlankUrl(target?.url);
-}
-export function commandExplicitlyTargetsAboutBlank(commandTokens) {
-    return ((commandTokens[0] === "window" && commandTokens[1] === "new") ||
-        commandTokens.some((token) => isAboutBlankUrl(token)));
-}
-export function targetsMatch(left, right) {
-    if (!left || !right) {
-        return true;
-    }
-    return normalizeComparableUrl(left.url) === normalizeComparableUrl(right.url);
-}
-function extractStringResultField(data, fieldName) {
-    if (typeof data === "string") {
-        if (fieldName === "value") {
-            return data;
-        }
-        const text = data.trim();
-        return text.length > 0 ? text : undefined;
-    }
-    if (!isRecord(data) || typeof data[fieldName] !== "string") {
-        return undefined;
-    }
-    if (fieldName === "value") {
-        return data[fieldName];
-    }
-    const text = data[fieldName].trim();
-    return text.length > 0 ? text : undefined;
-}
-function extractSessionTabTargetFromData(data) {
-    const directTarget = normalizeSessionTabTarget({
-        targetId: isRecord(data) && typeof data.targetId === "string" ? data.targetId : undefined,
-        title: extractStringResultField(data, "title"),
-        url: extractStringResultField(data, "url"),
-    });
-    if (directTarget) {
-        return directTarget;
-    }
-    if (isRecord(data) && typeof data.origin === "string") {
-        return normalizeSessionTabTarget({ url: data.origin });
-    }
-    return undefined;
-}
-function extractBatchResultCommand(item) {
-    return browserStringArray(item.command);
-}
-function confirmedNavigationResult(command, data) {
-    if (command === "confirm" &&
-        isRecord(data) &&
-        data.confirmed === true &&
-        (data.action === "navigate" || data.action === "url") &&
-        isRecord(data.result) &&
-        data.result.success === true &&
-        !detectConfirmationRequired(data)) {
-        return data.result;
-    }
-    return undefined;
-}
-export function extractSessionTabTargetFromCommandData(commandTokens, data) {
-    const [command, subcommand] = commandTokens;
-    const confirmed = confirmedNavigationResult(command, data);
-    if (confirmed) {
-        return extractSessionTabTargetFromData(confirmed.data);
-    }
-    if (command === "get" && subcommand === "url") {
-        return normalizeSessionTabTarget({
-            url: extractStringResultField(data, "url") ?? extractStringResultField(data, "result"),
-        });
-    }
-    return isReadOnlyDiagnosticSessionTargetCommand(command, subcommand)
-        ? undefined
-        : extractSessionTabTargetFromData(data);
-}
-class BatchTargetObservation {
-    target;
-    pendingTitle;
-    observe(item) {
-        if (detectConfirmationRequired(item.result)) {
-            return;
-        }
-        // Only this native row can describe the active tab's identity.
-        if (this.target?.targetId !== undefined && this.target.targetId.length > 0) {
-            this.target = normalizeSessionTabTarget({ title: this.target.title, url: this.target.url });
-        }
-        const tokens = extractUpstreamCommandTokens(extractBatchResultCommand(item));
-        this.invalidateTransition(tokens);
-        if (item.success === false) {
-            return;
-        }
-        this.observeResult(tokens, item.result);
-    }
-    invalidateTransition(tokens) {
-        const [name, subcommand] = tokens;
-        if (isOpenNavigationCommand(name) ||
-            isUnverifiedPageTransitionCommand(name, subcommand) ||
-            (name === "click" && tokens.includes("--new-tab"))) {
-            this.target = undefined;
-            this.pendingTitle = undefined;
-        }
-    }
-    observeResult(tokens, result) {
-        const [name, subcommand] = tokens;
-        if (isCloseCommand(name) || isSuccessfulNativeConfirmedClose(tokens, result)) {
-            this.target = undefined;
-            this.pendingTitle = undefined;
-            return;
-        }
-        if (name === "get" && subcommand === "title") {
-            this.pendingTitle = extractStringResultField(result, "title");
-            return;
-        }
-        if (name === "get" && subcommand === "url") {
-            const target = normalizeSessionTabTarget({
-                title: this.pendingTitle,
-                url: extractStringResultField(result, "url"),
-            });
-            if (target) {
-                this.target = target;
-            }
-        }
-        else {
-            const target = extractSessionTabTargetFromCommandData(tokens.slice(0, 2), result);
-            if (target) {
-                this.target = target;
-            }
-        }
-        this.pendingTitle = undefined;
-    }
-}
-export function extractSessionTabTargetFromBatchResults(data) {
-    if (!Array.isArray(data)) {
-        return undefined;
-    }
-    const observation = new BatchTargetObservation();
-    for (const item of data) {
-        if (isRecord(item)) {
-            observation.observe(item);
-        }
-    }
-    return observation.target;
-}
-export function deriveSessionTabTarget(options) {
-    if (isCloseCommand(options.command)) {
-        return undefined;
-    }
-    const commandDataTarget = extractSessionTabTargetFromCommandData([options.command, options.subcommand].filter((token) => token !== undefined), options.data);
-    const observedTarget = normalizeSessionTabTarget(options.navigationSummary) ??
-        extractSessionTabTargetFromBatchResults(options.data) ??
-        commandDataTarget;
-    if (observedTarget || !isUnverifiedPageTransitionCommand(options.command, options.subcommand)) {
-        return observedTarget ?? options.previousTarget;
-    }
-    return undefined;
-}
-function extractRefSnapshotRefs(data) {
-    if (!isRecord(data) || !isRecord(data.refs)) {
-        return undefined;
-    }
-    const snapshotLines = typeof data.snapshot === "string" ? parseSnapshotLines(data.snapshot) : [];
-    const lineByRef = new Map(snapshotLines.flatMap((line) => line.ref !== undefined && line.ref.length > 0 ? [[line.ref, line.raw]] : []));
-    const entries = enrichSnapshotRefEntries(getSnapshotRefEntries(data), snapshotLines);
-    const refs = Object.fromEntries(entries.flatMap((entry) => {
-        if (!/^e\d+$/.test(entry.id) || entry.role.length === 0) {
-            return [];
-        }
-        const isContentEditable = getEditableRefEvidence({
-            ref: entry.refData,
-            text: lineByRef.get(entry.id),
-        });
-        return [
-            [
-                entry.id,
-                {
-                    ...(isContentEditable === true ? { isContentEditable: true } : {}),
-                    ...(entry.isEditable !== undefined ? { isEditable: entry.isEditable } : {}),
-                    name: entry.name,
-                    role: entry.role,
-                },
-            ],
-        ];
-    }));
-    return Object.keys(refs).length > 0 ? refs : undefined;
-}
-export function extractRefSnapshotFromData(value) {
-    if (detectConfirmationRequired(value)) {
-        return undefined;
-    }
-    const data = getFullSnapshotData(value);
-    if (!data) {
-        return undefined;
-    }
-    const refs = extractRefSnapshotRefs(data);
-    return {
-        refIds: isRecord(data.refs)
-            ? Object.keys(data.refs).filter((refId) => /^e\d+$/.test(refId))
-            : [],
-        ...(refs ? { refs } : {}),
-        target: extractSessionTabTargetFromData(data),
-    };
-}
-function getBatchResultFailureText(item) {
-    const result = isRecord(item.result) ? item.result : undefined;
-    const parts = [
-        item.error,
-        result?.error,
-        typeof item.result === "string" ? item.result : undefined,
-    ].filter((part) => typeof part === "string" && part.trim().length > 0);
-    return parts.length > 0 ? parts.join("\n") : undefined;
-}
-export function buildNoActivePageRefSnapshotInvalidation() {
-    return {
-        reason: "no-active-page",
-        summary: "The latest snapshot for this session reported No active page. Old page-scoped refs are invalid until snapshot -i succeeds.",
-    };
-}
-export function buildPageTransitionRefSnapshotInvalidation(summary) {
-    return {
-        reason: "page-transition",
-        summary: summary ??
-            "Recording starts and URL-bearing restarts conservatively invalidate earlier page-scoped refs. Run snapshot -i before using refs; this is not evidence of a page change.",
-    };
-}
-export function getCommandRefSnapshotInvalidation(commandTokens) {
-    if (isRecordPageTransitionCommand(commandTokens)) {
-        return buildPageTransitionRefSnapshotInvalidation();
-    }
-    if (isWindowOrDiffPageTransitionCommand(commandTokens[0], commandTokens[1])) {
-        return buildPageTransitionRefSnapshotInvalidation("A window new or diff url command replaced or navigated the active page and invalidated prior refs. Run snapshot -i before using page-scoped refs.");
-    }
-    if (isWebMcpPageMutationCommand(commandTokens)) {
-        return buildPageTransitionRefSnapshotInvalidation("A WebMCP invoke, result, or cancel command can mutate, rerender, or navigate the page, so the prior snapshot refs were invalidated. Run snapshot -i before using page-scoped refs.");
-    }
-    return undefined;
-}
-export function isNoActivePageSnapshotFailure(command, text) {
-    return command === "snapshot" && /\bno active page\b/i.test(text ?? "");
-}
-function batchResultClosed(item, tokens) {
-    return (item.success !== false &&
-        !detectConfirmationRequired(item.result) &&
-        (isCloseCommand(tokens[0]) || isSuccessfulNativeConfirmedClose(tokens, item.result)));
-}
-function nextBatchRefState(item, previous) {
-    const tokens = extractUpstreamCommandTokens(extractBatchResultCommand(item));
-    if (batchResultClosed(item, tokens)) {
-        return undefined;
-    }
-    const invalidation = getCommandRefSnapshotInvalidation(tokens);
-    if (invalidation) {
-        return { invalidation };
-    }
-    if (tokens[0] !== "snapshot") {
-        return previous;
-    }
-    if (item.success === false) {
-        return isNoActivePageSnapshotFailure(tokens[0], getBatchResultFailureText(item))
-            ? { invalidation: buildNoActivePageRefSnapshotInvalidation() }
-            : previous;
-    }
-    const snapshot = extractRefSnapshotFromData(item.result);
-    if (snapshot) {
-        return { snapshot };
-    }
-    if (isRecord(item.result) && isRecord(item.result.snapshot)) {
-        return { refreshArgs: tokens.filter((token) => token !== "--delta" && token !== "--full") };
-    }
-    return previous;
-}
-export function extractLatestRefSnapshotStateFromBatchResults(data) {
-    if (!Array.isArray(data)) {
-        return undefined;
-    }
-    let latest;
-    for (const item of data) {
-        if (isRecord(item)) {
-            latest = nextBatchRefState(item, latest);
-        }
-    }
-    return latest;
-}
-export function shouldApplyTabTargetUpdate(current, unknownOrder, updateOrder) {
-    return updateOrder >= Math.max(current?.order ?? 0, unknownOrder ?? 0);
-}
-export function shouldApplyRefStateUpdate(options) {
-    const currentOrder = Math.max(options.currentSnapshot?.order ?? 0, options.currentInvalidation?.order ?? 0);
-    return options.updateOrder >= currentOrder;
-}
-export function stripRefSnapshotOrder(snapshot) {
-    return snapshot
-        ? {
-            ...(snapshot.snapshotId !== undefined && snapshot.snapshotId.length > 0
-                ? { snapshotId: snapshot.snapshotId }
-                : {}),
-            ...(snapshot.generation !== undefined && snapshot.generation.length > 0
-                ? { generation: snapshot.generation }
-                : {}),
-            refIds: snapshot.refIds,
-            ...(snapshot.refs ? { refs: snapshot.refs } : {}),
-            target: snapshot.target,
-        }
-        : undefined;
-}
-export function stripRefSnapshotInvalidationOrder(invalidation) {
-    return invalidation ? { reason: invalidation.reason, summary: invalidation.summary } : undefined;
-}
-export function getSessionPageStateKey(sessionName, namespace) {
-    return sessionName !== undefined && sessionName.length > 0
-        ? getAgentBrowserSessionIdentityKey(sessionName, namespace)
-        : undefined;
-}