pi-agent-browser-native 0.9.5 → 0.9.6

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-agent-browser-native",
-	"version": "0.9.5",
+	"version": "0.9.6",
 	"description": "pi extension that exposes agent-browser as a native tool for browser automation",
 	"type": "module",
 	"author": "Mitch Fultz (https://github.com/fitchmultz)",
@@ -32,7 +32,14 @@
 		"pi-agent-browser-doctor": "scripts/doctor.mjs"
 	},
 	"files": [
-		"dist",
+		"dist/extensions/agent-browser/index.js",
+		"dist/extensions/agent-browser/script-worker.js",
+		"dist/packaged/lib/config-policy.js",
+		"dist/packaged/lib/browser-session-conversion.js",
+		"dist/packaged/lib/parsing.js",
+		"dist/packaged/lib/playbook.js",
+		"dist/packaged/lib/results/snapshot.js",
+		"dist/packaged/lib/runtime.js",
 		"platform-smoke.config.mjs",
 		"scripts/config.mjs",
 		"scripts/convert-browser-session.mjs",
@@ -53,6 +60,8 @@
 		"LICENSE",
 		"docs/ARCHITECTURE.md",
 		"docs/CODE_QUALITY.md",
+		"docs/PERFORMANCE.md",
+		"docs/performance/2026-10-12.json",
 		"docs/COMMAND_REFERENCE.md",
 		"docs/ELECTRON.md",
 		"docs/RELEASE.md",
@@ -119,6 +128,7 @@
 		"prepublishOnly": "npm run verify -- release && npm pack --dry-run",
 		"build": "node ./scripts/build.mjs",
 		"startup-profile": "node ./scripts/profile-startup.mjs",
+		"performance-profile": "node --expose-gc ./scripts/profile-performance.mjs",
 		"prepare": "node ./scripts/prepare.mjs"
 	},
 	"packageManager": "npm@12.2.0",
@@ -139,6 +149,7 @@
 	"dependencies": {
 		"cross-spawn": "7.0.6",
 		"path-key": "3.1.1",
+		"stream-chain": "4.2.6",
 		"stream-json": "3.7.0",
 		"strip-json-comments": "5.0.3",
 		"which": "2.0.2"

package/scripts/build.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * Purpose: Produce the compiled runtime files that the published Pi package loads.
- * Responsibilities: Remove stale dist output, emit runtime assets, bundle the native entrypoint, and fail with clear build output.
+ * Responsibilities: Remove stale dist output, emit all checkout runtime assets, bundle the packaged entrypoints, and fail with clear build output.
  * Scope: Maintainer/package build only; runtime behavior remains in extensions/agent-browser TypeScript sources.
  * Usage: `npm run build` before package verification, lifecycle validation, and npm pack/publish.
  * Invariants/Assumptions: `node_modules` provides `typescript` and `esbuild`; Termux supplies Android-native `tsgo` on PATH. `dist/` is generated output.
@@ -51,14 +51,25 @@ async function main() {
 		}
 		throw error;
 	}
-	// Retain emitted workers and CLI modules; bundle the extension's reachable modules with package imports external.
-	const entrypoint = join(process.cwd(), "dist", "extensions", "agent-browser", "index.js");
+	// Raw checkout libraries share module-owned state; package-only bundles must not overwrite them.
+	const distDirectory = join(process.cwd(), "dist");
+	const runtimeDirectory = join(process.cwd(), "dist", "extensions", "agent-browser");
 	await build({
 		allowOverwrite: true,
 		bundle: true,
-		entryPoints: [entrypoint],
+		entryPoints: [
+			{ in: join(runtimeDirectory, "index.js"), out: "extensions/agent-browser/index" },
+			...[
+				"lib/config-policy",
+				"lib/browser-session-conversion",
+				"lib/parsing",
+				"lib/playbook",
+				"lib/results/snapshot",
+				"lib/runtime",
+			].map((path) => ({ in: join(runtimeDirectory, `${path}.js`), out: `packaged/${path}` })),
+		],
 		format: "esm",
-		outfile: entrypoint,
+		outdir: distDirectory,
 		packages: "external",
 		platform: "node",
 		target: "node24.21",

package/scripts/config.mjs

@@ -17,7 +17,7 @@ async function loadConfigPolicyModule() {
 	if (existsSync(sourcePolicyUrl)) {
 		return import(sourcePolicyUrl.href);
 	}
-	return import("../dist/extensions/agent-browser/lib/config-policy.js");
+	return import("../dist/packaged/lib/config-policy.js");
 }
 
 const {

package/scripts/convert-browser-session.mjs

@@ -23,7 +23,7 @@ if (values.help) {
 			);
 		}
 		const { convertBrowserSession } =
-			await import("../dist/extensions/agent-browser/lib/browser-session-conversion.js");
+			await import("../dist/packaged/lib/browser-session-conversion.js");
 		const receipt = await convertBrowserSession({
 			source: values.source,
 			destination: values.output,

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

@@ -1,123 +0,0 @@
-import { GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES, VALUE_FLAGS, optionalGlobalValueFlagConsumesNext, stripUpstreamGlobalFlags, } from "./argv-grammar.js";
-import { isOpenNavigationCommand } from "./command-taxonomy.js";
-function isBooleanLiteral(token) {
-    const normalized = token?.trim().toLowerCase();
-    return normalized === "true" || normalized === "false";
-}
-function flagConsumesFollowingToken(token, nextToken) {
-    const normalizedToken = token.split("=", 1).at(0) ?? token;
-    if (optionalGlobalValueFlagConsumesNext(normalizedToken, nextToken)) {
-        return true;
-    }
-    if (token.includes("=")) {
-        return false;
-    }
-    return (VALUE_FLAGS.has(normalizedToken) ||
-        (GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES.has(normalizedToken) && isBooleanLiteral(nextToken)));
-}
-export function findCommandStartIndex(args) {
-    for (let index = 0; index < args.length; index += 1) {
-        const token = args[index];
-        if (token.startsWith("--session=") ||
-            token.startsWith("--namespace=") ||
-            token.startsWith("--restore=")) {
-            continue;
-        }
-        if (token.startsWith("-")) {
-            if (flagConsumesFollowingToken(token, args[index + 1])) {
-                index += 1;
-            }
-            continue;
-        }
-        return index;
-    }
-    return undefined;
-}
-export function extractCommandTokens(args) {
-    const commandStartIndex = findCommandStartIndex(args);
-    return commandStartIndex === undefined ? [] : args.slice(commandStartIndex);
-}
-export function extractUpstreamCommandTokens(args) {
-    return stripUpstreamGlobalFlags(extractCommandTokens(args));
-}
-function waitDownloadShape(considered, downloadIndex) {
-    const next = considered.at(downloadIndex + 1);
-    const candidate = next?.token.startsWith("--") === false ? next : undefined;
-    return {
-        downloadPath: candidate?.token,
-        downloadPathIndex: candidate?.index,
-        subcommand: considered[downloadIndex].token,
-    };
-}
-export function parseWaitCommandTokens(commandTokens) {
-    if (commandTokens[0] !== "wait") {
-        return {};
-    }
-    const considered = commandTokens.slice(1).map((token, offset) => ({ index: offset + 1, token }));
-    const timeoutIndex = considered.findIndex((entry) => entry.token === "--timeout");
-    if (timeoutIndex >= 0) {
-        considered.splice(timeoutIndex, Math.min(2, considered.length - timeoutIndex));
-    }
-    for (const flags of [
-        ["--url", "-u"],
-        ["--load", "-l"],
-        ["--fn", "-f"],
-        ["--text", "-t"],
-    ]) {
-        const match = considered.find((entry) => flags.some((flag) => flag === entry.token));
-        if (match) {
-            return { subcommand: match.token };
-        }
-    }
-    const downloadIndex = considered.findIndex((entry) => entry.token === "--download" || entry.token === "-d");
-    if (downloadIndex >= 0) {
-        return waitDownloadShape(considered, downloadIndex);
-    }
-    return { subcommand: considered[0]?.token };
-}
-function getOpenCommandTarget(commandTokens) {
-    for (let index = 1; index < commandTokens.length; index += 1) {
-        const token = commandTokens[index];
-        if (token === "--init-script" || token === "--enable") {
-            index += 1;
-            continue;
-        }
-        if (token.startsWith("--init-script=") || token.startsWith("--enable=")) {
-            continue;
-        }
-        if (token.startsWith("-")) {
-            continue;
-        }
-        return token;
-    }
-    return undefined;
-}
-function getCommandSubcommand(tokens) {
-    if (isOpenNavigationCommand(tokens.at(0))) {
-        return getOpenCommandTarget(tokens);
-    }
-    if (tokens.at(0) === "wait") {
-        return parseWaitCommandTokens(tokens).subcommand;
-    }
-    return tokens.at(1);
-}
-function parseCommandInfoFromTokens(commandTokens) {
-    const upstreamCommandTokens = stripUpstreamGlobalFlags(commandTokens);
-    const command = upstreamCommandTokens[0];
-    return {
-        command,
-        subcommand: getCommandSubcommand(upstreamCommandTokens),
-    };
-}
-export function parseCommandInfo(args) {
-    return parseCommandInfoFromTokens(extractCommandTokens(args));
-}
-export function parseArgvDescriptor(args) {
-    const commandTokens = extractCommandTokens(args);
-    const upstreamCommandTokens = stripUpstreamGlobalFlags(commandTokens);
-    return {
-        commandInfo: parseCommandInfoFromTokens(commandTokens),
-        commandTokens,
-        upstreamCommandTokens,
-    };
-}

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;
-}