pi-agent-browser-native 0.9.5 → 0.9.7

package/dist/extensions/agent-browser/lib/argv-grammar.js

@@ -1,320 +0,0 @@
-import { isKnownCommandToken } from "./command-taxonomy.js";
-import { canonicalizeAgentBrowserNamespace } from "./session-identity.js";
-export { canonicalizeAgentBrowserNamespace, foldAgentBrowserFilesystemIdentity, getAgentBrowserSessionIdentityKey, isAgentBrowserSessionIdentityKeyInNamespace, deleteIdentityKeysInNamespace, } from "./session-identity.js";
-export const GLOBAL_VALUE_FLAGS = [
-    "--session",
-    "--namespace",
-    "--cdp",
-    "--config",
-    "--profile",
-    "--session-name",
-    "--restore-save",
-    "--restore-check-url",
-    "--restore-check-text",
-    "--restore-check-fn",
-    "--proxy",
-    "--proxy-bypass",
-    "--ca-cert",
-    "--headers",
-    "--executable-path",
-    "--extension",
-    "--init-script",
-    "--enable",
-    "--provider",
-    "-p",
-    "--engine",
-    "--state",
-    "--download-path",
-    "--screenshot-dir",
-    "--screenshot-format",
-    "--screenshot-quality",
-    "--color-scheme",
-    "--device",
-    "--args",
-    "--user-agent",
-    "--allowed-domains",
-    "--action-policy",
-    "--confirm-actions",
-    "--max-output",
-    "--model",
-    "--idle-timeout",
-    "--input-mode",
-];
-const COMMAND_VALUE_FLAGS = [
-    "--allowed-origins",
-    "--baseline",
-    "--body",
-    "--categories",
-    "--content",
-    "--curl",
-    "--depth",
-    "-d",
-    "--domain",
-    "--expires",
-    "--filter",
-    "--frame",
-    "--fn",
-    "--label",
-    "--load",
-    "--method",
-    "--name",
-    "--older-than",
-    "--output",
-    "--prefix",
-    "--path",
-    "--port",
-    "--params",
-    "--resource-type",
-    "--resource-types",
-    "--sameSite",
-    "--scope",
-    "--selector",
-    "-s",
-    "--status",
-    "--tags",
-    "--text",
-    "--threshold",
-    "--timeout",
-    "--type",
-    "--url",
-    "--username",
-    "--password",
-    "--wait-until",
-];
-const OPTIONAL_GLOBAL_VALUE_FLAGS = new Set(["--restore"]);
-export const VALUE_FLAGS = new Set([
-    ...GLOBAL_VALUE_FLAGS,
-    ...COMMAND_VALUE_FLAGS,
-]);
-export const PREVALIDATED_VALUE_FLAGS = new Set(GLOBAL_VALUE_FLAGS);
-export const GLOBAL_VALUE_FLAGS_ALLOWING_DASH_VALUE = new Set([
-    "--args",
-    "--session",
-]);
-export const GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES = new Set([
-    "--allow-file-access",
-    "--annotate",
-    "--auto-connect",
-    "--confirm-interactive",
-    "--content-boundaries",
-    "--debug",
-    "--headed",
-    "--hide-scrollbars",
-    "--ignore-https-errors",
-    "--json",
-    "--no-auto-dialog",
-    "--no-ca-cert",
-    "--no-pin-tab",
-    "--no-webmcp",
-    "--offline",
-    "--pin-tab",
-    "--quick",
-    "--fix",
-    "--quiet",
-    "-q",
-    "--verbose",
-    "-v",
-    "--webgpu",
-]);
-/** Match upstream's last-wins, case-sensitive boolean semantics; only exact `false` disables a present flag. */
-export function getBooleanFlagValue(args, flag) {
-    let enabled;
-    for (let index = 0; index < args.length; index += 1) {
-        const token = args[index];
-        if (token === flag) {
-            enabled = args[index + 1] !== "false";
-            if (["true", "false"].includes(args[index + 1] ?? "")) {
-                index += 1;
-            }
-            continue;
-        }
-        if (PREVALIDATED_VALUE_FLAGS.has(token)) {
-            index += 1;
-            continue;
-        }
-        if (GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES.has(token) &&
-            ["true", "false"].includes(args[index + 1] ?? "")) {
-            index += 1;
-        }
-    }
-    return enabled;
-}
-export function isBooleanFlagEnabled(args, flag) {
-    return getBooleanFlagValue(args, flag) ?? false;
-}
-/** Match upstream env_var_is_truthy exactly: lowercase only, without trimming or accepting "off". */
-export function isUpstreamEnvFlagEnabled(value) {
-    return value !== undefined && !["", "0", "false", "no"].includes(value.toLowerCase());
-}
-/** Mirror upstream global parsing: full argv, no `--` sentinel, and only global value payloads are skipped. */
-export function scanUpstreamGlobalFlagOccurrences(args, targetFlag) {
-    const occurrences = [];
-    for (let index = 0; index < args.length; index += 1) {
-        const token = args[index];
-        if (token === targetFlag) {
-            occurrences.push({ index, value: args[index + 1] });
-            index += 1;
-            continue;
-        }
-        if (PREVALIDATED_VALUE_FLAGS.has(token)) {
-            index += 1;
-            continue;
-        }
-        if (GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES.has(token) &&
-            ["true", "false"].includes(args[index + 1] ?? "")) {
-            index += 1;
-        }
-    }
-    return occurrences;
-}
-export function extractExplicitSessionName(args) {
-    return scanUpstreamGlobalFlagOccurrences(args, "--session").at(-1)?.value;
-}
-export function extractExplicitNamespace(args) {
-    return canonicalizeAgentBrowserNamespace(scanUpstreamGlobalFlagOccurrences(args, "--namespace").at(-1)?.value);
-}
-export function resolveAgentBrowserNamespace(args, envValue) {
-    const occurrences = scanUpstreamGlobalFlagOccurrences(args, "--namespace");
-    if (occurrences.length > 0) {
-        return canonicalizeAgentBrowserNamespace(occurrences.at(-1)?.value) ?? "";
-    }
-    return canonicalizeAgentBrowserNamespace(envValue);
-}
-function getRestoreFlag(token, next, seenCommand, sessionName) {
-    if (token.startsWith("--restore=")) {
-        const requested = token.slice("--restore=".length);
-        return { key: requested.length > 0 ? requested : sessionName, consumed: 0 };
-    }
-    if (token !== "--restore") {
-        return undefined;
-    }
-    if (!seenCommand && optionalGlobalValueFlagConsumesNext(token, next) && next !== undefined) {
-        return { key: next, consumed: 1 };
-    }
-    return { key: sessionName, consumed: 0 };
-}
-/** Mirror upstream's optional restore value and full-argv last-wins parsing. */
-export function extractRequestedRestoreKey(args, sessionName, envValue) {
-    let restoreKey = envValue !== undefined && envValue.length > 0 ? envValue : null;
-    let seenCommand = false;
-    for (let index = 0; index < args.length; index += 1) {
-        const token = args[index];
-        const restore = getRestoreFlag(token, args[index + 1], seenCommand, sessionName);
-        if (restore !== undefined) {
-            restoreKey = restore.key;
-            index += restore.consumed;
-            continue;
-        }
-        if (PREVALIDATED_VALUE_FLAGS.has(token)) {
-            index += 1;
-            continue;
-        }
-        if (GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES.has(token) &&
-            ["true", "false"].includes(args[index + 1] ?? "")) {
-            index += 1;
-            continue;
-        }
-        if (isKnownCommandToken(token)) {
-            seenCommand = true;
-        }
-    }
-    return restoreKey;
-}
-function getFlagName(token) {
-    return token.split("=", 1).at(0) ?? token;
-}
-export function isNonFlagToken(token) {
-    return typeof token === "string" && !token.startsWith("-");
-}
-export function hasOnlyBooleanFlags(tokens, allowedFlags) {
-    return tokens.every((token) => token.startsWith("-") && allowedFlags.has(getFlagName(token)));
-}
-export function hasOnlyOptionFlags(tokens, allowedBooleanFlags, allowedValueFlags) {
-    for (let index = 0; index < tokens.length; index += 1) {
-        const token = tokens[index];
-        if (!token.startsWith("-")) {
-            return false;
-        }
-        const flagName = getFlagName(token);
-        if (allowedBooleanFlags.has(flagName)) {
-            continue;
-        }
-        if (!allowedValueFlags.has(flagName)) {
-            return false;
-        }
-        if (token.includes("=")) {
-            continue;
-        }
-        const value = tokens.at(index + 1);
-        if (!isNonFlagToken(value)) {
-            return false;
-        }
-        index += 1;
-    }
-    return true;
-}
-export function optionalGlobalValueFlagConsumesNext(flag, nextToken) {
-    if (!OPTIONAL_GLOBAL_VALUE_FLAGS.has(flag) ||
-        nextToken === undefined ||
-        nextToken.startsWith("-")) {
-        return false;
-    }
-    return !isKnownCommandToken(nextToken);
-}
-function globalFlagWidth(token, next, seenCommand) {
-    if (token.startsWith("--restore=")) {
-        return 1;
-    }
-    if (token === "--restore") {
-        return !seenCommand && optionalGlobalValueFlagConsumesNext(token, next) ? 2 : 1;
-    }
-    if (PREVALIDATED_VALUE_FLAGS.has(token)) {
-        return 2;
-    }
-    if (GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES.has(token)) {
-        return ["true", "false"].includes(next ?? "") ? 2 : 1;
-    }
-    return 0;
-}
-export function projectUpstreamGlobalFlags(args) {
-    const indices = [];
-    const tokens = [];
-    let seenCommand = false;
-    for (let index = 0; index < args.length; index += 1) {
-        const token = args[index];
-        const width = globalFlagWidth(token, args[index + 1], seenCommand);
-        if (width > 0) {
-            index += width - 1;
-            continue;
-        }
-        tokens.push(token);
-        indices.push(index);
-        if (isKnownCommandToken(token)) {
-            seenCommand = true;
-        }
-    }
-    return { indices, tokens };
-}
-/** Mirror upstream clean_args: remove global flags wherever they appear before command parsing. */
-export function stripUpstreamGlobalFlags(args) {
-    return projectUpstreamGlobalFlags(args).tokens;
-}
-export function stripSessionlessShapeGlobalFlags(commandTokens) {
-    const stripped = [];
-    for (let index = 0; index < commandTokens.length; index += 1) {
-        const token = commandTokens[index];
-        const flagName = getFlagName(token);
-        if (token === "--json") {
-            continue;
-        }
-        if ((flagName === "--session" || flagName === "--namespace") && !token.includes("=")) {
-            index += 1;
-            continue;
-        }
-        if (token.startsWith("--session=") || token.startsWith("--namespace=")) {
-            continue;
-        }
-        stripped.push(token);
-    }
-    return stripped;
-}

package/dist/extensions/agent-browser/lib/bash-guard.js

@@ -1,193 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { isRecord } from "./parsing.js";
-const DIRECT_AGENT_BROWSER_BASH_BYPASS_ENV = "PI_AGENT_BROWSER_ALLOW_DIRECT_BASH";
-const DIRECT_AGENT_BROWSER_EXECUTABLE_PATTERN = /^(?:[.~]|\.\.?|\/)?(?:[^\s;&|]+\/)?agent-browser$/;
-const HARMLESS_AGENT_BROWSER_INSPECTION_PATTERN = /^\s*(?:command\s+-v|which|type\s+-P)\s+agent-browser\s*$/;
-const PACKAGE_NAME = "pi-agent-browser-native";
-function isShellAssignmentToken(token) {
-    return /^[A-Za-z_][A-Za-z0-9_]*=/.test(token);
-}
-function stripOuterQuotes(token) {
-    if (token.length >= 2 &&
-        ((token.startsWith('"') && token.endsWith('"')) ||
-            (token.startsWith("'") && token.endsWith("'")))) {
-        return token.slice(1, -1);
-    }
-    return token;
-}
-function skipAssignments(tokens, start) {
-    let index = start;
-    while (index < tokens.length && isShellAssignmentToken(tokens[index])) {
-        index += 1;
-    }
-    return index;
-}
-function skipRunnerOptions(tokens, start) {
-    let index = start;
-    while (index < tokens.length && tokens[index].startsWith("-")) {
-        index += 1;
-    }
-    return index;
-}
-function separatorWidth(command, index) {
-    const char = command[index];
-    if (char !== "\n" && char !== "|" && char !== ";" && char !== "&") {
-        return 0;
-    }
-    const operator = command.slice(index, index + 2);
-    return operator === "&&" || operator === "||" ? 2 : 1;
-}
-function segmentLaunchesAgentBrowser(tokens) {
-    let index = skipAssignments(tokens, 0);
-    if (index >= tokens.length) {
-        return false;
-    }
-    if (tokens[index] === "env") {
-        index = skipAssignments(tokens, index + 1);
-    }
-    if (tokens[index] === "npx" || tokens[index] === "bunx") {
-        index = skipRunnerOptions(tokens, index + 1);
-    }
-    if (tokens[index] === "pnpm" || tokens[index] === "yarn") {
-        if (tokens[index + 1] !== "dlx") {
-            return false;
-        }
-        index = skipRunnerOptions(tokens, index + 2);
-    }
-    return DIRECT_AGENT_BROWSER_EXECUTABLE_PATTERN.test(tokens[index] ?? "");
-}
-/** Owns only the best-effort lexical scan, not shell execution or authorization. */
-class ShellLaunchScanner {
-    currentToken = "";
-    quoteState;
-    awaitingHeredocDelimiter;
-    pendingHeredoc;
-    pendingHeredocLine = "";
-    segmentTokens = [];
-    flushToken() {
-        const token = this.currentToken;
-        this.currentToken = "";
-        if (token.length === 0) {
-            return;
-        }
-        if (this.awaitingHeredocDelimiter) {
-            this.pendingHeredoc = {
-                delimiter: stripOuterQuotes(token),
-                stripTabs: this.awaitingHeredocDelimiter.stripTabs,
-            };
-            this.awaitingHeredocDelimiter = undefined;
-            return;
-        }
-        this.segmentTokens.push(token);
-    }
-    flushSegment() {
-        this.flushToken();
-        const launches = segmentLaunchesAgentBrowser(this.segmentTokens);
-        this.segmentTokens = [];
-        return launches;
-    }
-    consumeHeredoc(char) {
-        const heredoc = this.pendingHeredoc;
-        if (!heredoc) {
-            return false;
-        }
-        if (char !== "\n") {
-            this.pendingHeredocLine += char;
-            return true;
-        }
-        const candidate = heredoc.stripTabs
-            ? this.pendingHeredocLine.replace(/^\t+/, "")
-            : this.pendingHeredocLine;
-        if (candidate === heredoc.delimiter) {
-            this.pendingHeredoc = undefined;
-        }
-        this.pendingHeredocLine = "";
-        return true;
-    }
-    consumeQuoted(command, index) {
-        const char = command[index];
-        if (this.quoteState === undefined) {
-            return undefined;
-        }
-        this.currentToken += char;
-        if (this.quoteState === "double" && char === "\\" && index + 1 < command.length) {
-            this.currentToken += command[index + 1];
-            return index + 1;
-        }
-        if ((this.quoteState === "single" && char === "'") ||
-            (this.quoteState === "double" && char === '"')) {
-            this.quoteState = undefined;
-        }
-        return index;
-    }
-    consumeTokenCharacter(command, index) {
-        const char = command[index];
-        if (char === "'" || char === '"') {
-            this.currentToken += char;
-            this.quoteState = char === "'" ? "single" : "double";
-            return index;
-        }
-        if (char === "\\" && index + 1 < command.length) {
-            this.currentToken += char + command[index + 1];
-            return index + 1;
-        }
-        if (char !== "\n" && /\s/.test(char)) {
-            this.flushToken();
-            return index;
-        }
-        if (command.slice(index, index + 2) === "<<") {
-            this.flushToken();
-            const stripTabs = command[index + 2] === "-";
-            this.awaitingHeredocDelimiter = { stripTabs };
-            return index + (stripTabs ? 2 : 1);
-        }
-        return undefined;
-    }
-    scan(command) {
-        for (let index = 0; index < command.length; index += 1) {
-            if (this.consumeHeredoc(command[index])) {
-                continue;
-            }
-            const consumed = this.consumeQuoted(command, index) ?? this.consumeTokenCharacter(command, index);
-            if (consumed !== undefined) {
-                index = consumed;
-                continue;
-            }
-            const width = separatorWidth(command, index);
-            if (width > 0) {
-                if (this.flushSegment()) {
-                    return true;
-                }
-                index += width - 1;
-                continue;
-            }
-            this.currentToken += command[index];
-        }
-        return this.flushSegment();
-    }
-}
-// Best-effort detection for common direct launches only. This is an ergonomics guard,
-// not a general-purpose bash parser or security boundary.
-export function looksLikeDirectAgentBrowserBash(command) {
-    return new ShellLaunchScanner().scan(command);
-}
-export function isHarmlessAgentBrowserInspectionCommand(command) {
-    return HARMLESS_AGENT_BROWSER_INSPECTION_PATTERN.test(command);
-}
-function isTruthyEnvValue(value) {
-    return value === "1" || value?.toLowerCase() === "true" || value?.toLowerCase() === "yes";
-}
-async function isPackageDevelopmentCwd(cwd) {
-    try {
-        const packageJson = JSON.parse(await readFile(join(cwd, "package.json"), "utf8"));
-        return isRecord(packageJson) && packageJson.name === PACKAGE_NAME;
-    }
-    catch {
-        return false;
-    }
-}
-export async function isDirectAgentBrowserBashAllowed(cwd) {
-    return (isTruthyEnvValue(process.env[DIRECT_AGENT_BROWSER_BASH_BYPASS_ENV]) ||
-        (await isPackageDevelopmentCwd(cwd)));
-}

package/dist/extensions/agent-browser/lib/batch-lifecycle.js

@@ -1,131 +0,0 @@
-import { extractUpstreamCommandTokens } from "./argv-descriptor.js";
-import { isCloseAllCommand, isCloseCommand } from "./command-taxonomy.js";
-import { isRecord } from "./parsing.js";
-import { isSuccessfulNativeConfirmedClose } from "./native-confirmation.js";
-import { detectConfirmationRequired } from "./results/confirmation.js";
-function rowCommand(value, fallback) {
-    return Array.isArray(value) && value.every((token) => typeof token === "string")
-        ? value
-        : fallback;
-}
-function rowResult(row) {
-    if (isRecord(row.result)) {
-        return row.result;
-    }
-    return isRecord(row.data) ? row.data : undefined;
-}
-function rowBrowserLaunched(row, result) {
-    const lifecycle = isRecord(row.lifecycle) ? row.lifecycle : result?.lifecycle;
-    if (!isRecord(lifecycle) || !isRecord(lifecycle.effectiveLaunch)) {
-        return undefined;
-    }
-    const launched = lifecycle.effectiveLaunch.browserLaunched;
-    return typeof launched === "boolean" ? launched : undefined;
-}
-function lifecycleStep(value, fallback) {
-    if (!isRecord(value)) {
-        return undefined;
-    }
-    const result = rowResult(value);
-    const command = rowCommand(value.command, fallback);
-    return {
-        result,
-        succeeded: value.success === true,
-        browserLaunched: rowBrowserLaunched(value, result),
-        tokens: command === undefined ? undefined : extractUpstreamCommandTokens(command),
-    };
-}
-export function batchHasSuccessfulCloseAll(data, fallbackCommands = []) {
-    if (!Array.isArray(data)) {
-        return false;
-    }
-    return data.some((row, index) => {
-        if (!isRecord(row) || row.success !== true) {
-            return false;
-        }
-        const command = rowCommand(row.command, fallbackCommands.at(index));
-        return (command !== undefined &&
-            !detectConfirmationRequired(row.result) &&
-            isCloseAllCommand(extractUpstreamCommandTokens(command)));
-    });
-}
-function successfulClose(step) {
-    return (step.succeeded &&
-        step.tokens !== undefined &&
-        !detectConfirmationRequired(step.result) &&
-        (isCloseCommand(step.tokens[0]) || isSuccessfulNativeConfirmedClose(step.tokens, step.result)));
-}
-function closedState(step) {
-    const result = step.result;
-    const closeData = step.tokens?.[0] === "confirm" && isRecord(result) && isRecord(result.result)
-        ? result.result.data
-        : result;
-    return {
-        endsClosed: true,
-        browserActiveAfterClose: false,
-        recordingClosedAfterBatch: true,
-        statePath: isRecord(closeData) && typeof closeData.statePath === "string"
-            ? closeData.statePath
-            : undefined,
-    };
-}
-function recordingState(state, step) {
-    const relaunched = step.browserLaunched !== false;
-    const browserActiveAfterClose = state.browserActiveAfterClose || relaunched;
-    let recordingClosedAfterBatch = state.recordingClosedAfterBatch;
-    const subcommand = step.tokens?.[1];
-    if (step.succeeded && subcommand === "stop") {
-        recordingClosedAfterBatch = true;
-    }
-    else if (step.succeeded &&
-        browserActiveAfterClose &&
-        (subcommand === "start" || subcommand === "restart")) {
-        recordingClosedAfterBatch = false;
-    }
-    return {
-        ...state,
-        endsClosed: state.endsClosed && !relaunched,
-        browserActiveAfterClose,
-        recordingClosedAfterBatch,
-    };
-}
-function advanceClosedState(state, step) {
-    if (step.tokens?.[0] === "record") {
-        return recordingState(state, step);
-    }
-    if (step.browserLaunched === false) {
-        return state;
-    }
-    return {
-        ...state,
-        endsClosed: false,
-        browserActiveAfterClose: true,
-        recordingClosedAfterBatch: step.tokens === undefined ? false : state.recordingClosedAfterBatch,
-    };
-}
-/** Fold in execution order. Unknown launch evidence conservatively retains active ownership, including failed rows. */
-export function getSuccessfulBatchCloseLifecycle(rows, fallbackCommands = []) {
-    if (!Array.isArray(rows)) {
-        return undefined;
-    }
-    let state;
-    for (const [index, row] of rows.entries()) {
-        const step = lifecycleStep(row, fallbackCommands.at(index));
-        if (step === undefined) {
-            continue;
-        }
-        if (successfulClose(step)) {
-            state = closedState(step);
-        }
-        else if (state !== undefined) {
-            state = advanceClosedState(state, step);
-        }
-    }
-    return state === undefined
-        ? undefined
-        : {
-            endsClosed: state.endsClosed,
-            recordingClosedAfterBatch: state.recordingClosedAfterBatch,
-            statePath: state.statePath,
-        };
-}

package/dist/extensions/agent-browser/lib/browser-execution-claim-codec.js

@@ -1,61 +0,0 @@
-import { isRecord } from "./parsing.js";
-import { isBrowserStringArray } from "./browser-value-parsing.js";
-export const POLICY_LOCK_MAX_BYTES = 1_048_576;
-function claimNumber(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : undefined;
-}
-function claimStartIdentity(value) {
-    return typeof value === "string" && value.length > 0 ? value : undefined;
-}
-function validClaimToken(value) {
-    return (typeof value === "string" &&
-        value.length > 0 &&
-        !value.includes("/") &&
-        !value.includes("\\") &&
-        !value.includes("\0"));
-}
-function claimSessionNames(value) {
-    if (value === null) {
-        return null;
-    }
-    return isBrowserStringArray(value) && value.length > 0 ? value : undefined;
-}
-export function parseOwner(content) {
-    if (Buffer.byteLength(content) > POLICY_LOCK_MAX_BYTES) {
-        return undefined;
-    }
-    try {
-        const parsed = JSON.parse(content);
-        if (!isRecord(parsed) || parsed.version !== 4) {
-            return undefined;
-        }
-        const pid = claimNumber(parsed.pid);
-        const sessionNames = claimSessionNames(parsed.sessionNames);
-        const startIdentity = claimStartIdentity(parsed.startIdentity);
-        if (pid === undefined ||
-            sessionNames === undefined ||
-            startIdentity === undefined ||
-            !validClaimToken(parsed.token)) {
-            return undefined;
-        }
-        return { sessionNames, pid, startIdentity, token: parsed.token, version: 4 };
-    }
-    catch {
-        return undefined;
-    }
-}
-export function parseTicket(content, token) {
-    if (Buffer.byteLength(content) > POLICY_LOCK_MAX_BYTES) {
-        return undefined;
-    }
-    try {
-        const parsed = JSON.parse(content);
-        if (!isRecord(parsed) || parsed.version !== 4 || parsed.token !== token) {
-            return undefined;
-        }
-        return claimNumber(parsed.ticket);
-    }
-    catch {
-        return undefined;
-    }
-}