pi-agent-browser-native 0.9.4 → 0.9.6

package/docs/platform-smoke.md

@@ -42,7 +42,7 @@ npm run verify -- platform-smoke run --target ubuntu --suite platform-build
 
 With maintainer approval, local macOS execution can replace localhost SSH. Routine GitHub Actions has no Windows job; the separate Crabbox/Parallels release target remains as documented above. Record alternate native checks separately from Crabbox SSH or Parallels results. The default `release` and `prepublishOnly` commands still select the Crabbox matrix; record alternate suite evidence separately rather than reporting those commands as passed.
 
-On macOS, run the unchanged commands returned by `buildPlatformBuildCommand('macos', 'pi-agent-browser-native', '24.21.0')` and `buildBrowserDogfoodCommand('macos', '0.38.1', true)` in [`scripts/platform-smoke/targets.mjs`](../scripts/platform-smoke/targets.mjs), serially in a clean private source copy. Use private HOME, npm and Pi settings, and headless browser profiles. No Remote Login or host security change is required.
+On macOS, run the unchanged commands returned by `buildPlatformBuildCommand('macos', 'pi-agent-browser-native', '24.21.0')` and `buildBrowserDogfoodCommand('macos', '0.38.1', true)` in [`scripts/platform-smoke/targets.mjs`](../scripts/platform-smoke/targets.mjs), serially in a clean private source copy. Use private HOME, npm and Pi settings, and headless browser profiles, and clear inherited `PI_*` variables first: a shell started from Pi exports `PI_PACKAGE_DIR` and `PI_MANAGED_CLI`, which make the archived Pi CLI report the host package instead of the locked suite version. No Remote Login or host security change is required.
 
 Retain the exact source head/tree, package and tool versions, native OS/architecture, generated commands, stdout/stderr, every `PLATFORM_*` exit marker, actual Pi registration output, dogfood JSON and verified screenshot. Check the suite assertions below and clean up only the run's processes and temporary files. These alternatives do not waive Ubuntu or any non-platform release check.
 
@@ -80,7 +80,7 @@ PLATFORM_SMOKE_WINDOWS_WORK_ROOT="C:\\crabbox\\pi-agent-browser-native"
 PLATFORM_SMOKE_AUTH_ENV=""
 ```
 
-The Ubuntu target image is derived from `node:24-bookworm`, installs the `agent-browser` version from [`scripts/agent-browser-capability-baseline.mjs`](../scripts/agent-browser-capability-baseline.mjs), installs Debian Chromium plus the upstream Linux WebGPU/Xvfb runtime packages (`libvulkan1`, `mesa-vulkan-drivers`, and `xvfb`) through apt, creates a non-root `circleci` user, and sets `AGENT_BROWSER_EXECUTABLE_PATH=/usr/bin/chromium`. Rebuild it after upstream rebaselining, or override `PLATFORM_SMOKE_UBUNTU_IMAGE` with an equivalent prepared local image. Do not install `agent-browser` ad hoc inside the Ubuntu smoke command; a missing tool is image/template drift.
+The Ubuntu target image is derived from `node:24-bookworm`, installs the `agent-browser` version from [`scripts/agent-browser-capability-baseline.mjs`](../scripts/agent-browser-capability-baseline.mjs), installs Debian Chromium plus the upstream Linux WebGPU/Xvfb runtime packages (`libvulkan1`, `mesa-vulkan-drivers`, and `xvfb`) through apt, copies the official Go 1.27.1 toolchain onto `PATH` so `platform-target` can build the [corrected quality checker](CODE_QUALITY.md), creates a non-root `circleci` user, and sets `AGENT_BROWSER_EXECUTABLE_PATH=/usr/bin/chromium`. Rebuild it after upstream rebaselining, or override `PLATFORM_SMOKE_UBUNTU_IMAGE` with an equivalent prepared local image. Do not install `agent-browser` ad hoc inside the Ubuntu smoke command; a missing tool is image/template drift.
 
 The configured upstream `agent-browser` baseline is imported from [`scripts/agent-browser-capability-baseline.mjs`](../scripts/agent-browser-capability-baseline.mjs). Target-local browser suites verify that exact `agent-browser` version before running. Bake the exact upstream CLI and browser runtime into the Windows template/snapshot for speed and reproducibility; missing or stale Windows `agent-browser` / browser readiness is a blocked setup, not something the smoke command repairs. The Windows browser suite checks the preinstalled browser cache and prewarms one short loopback HTTP URL before the extension harness runs.
 
@@ -89,7 +89,7 @@ The configured upstream `agent-browser` baseline is imported from [`scripts/agen
 Crabbox does not install project runtime tools. The macOS host, Ubuntu image, and Windows template must already provide:
 
 - Node/npm at or above the full Node version declared by `package.json` `engines.node` and used by [`platform-smoke.config.mjs`](../platform-smoke.config.mjs).
-- Git and `tar`.
+- Git, `tar`, and Go (the version `scripts/prepare-quality-checker.mjs` selects) for the `platform-target` corrected-checker build.
 - Upstream `agent-browser` matching this wrapper’s capability baseline. The Ubuntu target gets it from [`scripts/platform-smoke/linux-image/Dockerfile`](../scripts/platform-smoke/linux-image/Dockerfile); the Windows template gets it from the shared `pi-extension-windows-template` snapshot named in [`platform-smoke.config.mjs`](../platform-smoke.config.mjs) (currently `crabbox-ready-ab-0.33.0`, a child of the shared `crabbox-ready` base used by other projects' linked clones).
 - Browser/runtime dependencies needed by upstream `agent-browser`.
 - Native PowerShell and OpenSSH Server on Windows.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-agent-browser-native",
-	"version": "0.9.4",
+	"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,9 +60,12 @@
 		"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",
+		"docs/REFERENCE.md",
 		"docs/SESSION_STORAGE.md",
 		"docs/platform-smoke.md",
 		"docs/REQUIREMENTS.md",
@@ -113,11 +123,12 @@
 		"smoke:platform:all": "npm run smoke:platform:doctor && node scripts/platform-smoke.mjs run --target macos,ubuntu,windows-native",
 		"check:compat": "node scripts/compat-host.mjs && npm run typecheck && npm test && node scripts/verify-package.mjs --smoke-pi",
 		"typecheck": "node ./scripts/project.mjs verify typecheck",
-		"test": "node ./scripts/build.mjs && tsx --test --test-reporter=tap --test-concurrency=1 \"test/**/*.test.ts\"",
+		"test": "node ./scripts/build.mjs && node ./scripts/prepare-quality-checker.mjs && tsx --test --test-reporter=tap \"test/**/!(*.serial).test.ts\" && tsx --test --test-reporter=tap --test-concurrency=1 \"test/**/*.serial.test.ts\"",
 		"verify": "node ./scripts/project.mjs verify",
 		"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",
@@ -138,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 {
@@ -35,6 +35,7 @@ const {
 	getWebSearchProviderLabel,
 	isWebSearchProvider,
 	loadAgentBrowserConfigStateSync,
+	parseAgentBrowserConfigJson,
 	summarizeConfigFiles,
 } = await loadConfigPolicyModule();
 
@@ -51,22 +52,22 @@ function usage() {
 	return `pi-agent-browser-native config helper
 
 Usage through npm exec:
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config paths
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config show
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config web-search status
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config web-search set-key --stdin --provider <exa|brave> [--global|--project]
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config web-search set-env <ENV_VAR> [--provider brave|exa] [--global|--project]
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config web-search set-command <command> --provider <exa|brave> [--global|--project]
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config web-search clear --provider <exa|brave|all> [--global|--project]
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config web-search prefer <exa|brave|auto> [--global|--project]
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config web-search enable [--global|--project]
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config web-search disable [--global|--project]
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config browser profile status
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config browser profile set <name|path> [--policy explicit-only|authenticated-only|always] [--global|--project]
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config browser profile clear [--global|--project]
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config browser executable status
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config browser executable set <path> [--global|--project]
-  npm exec --yes --package pi-agent-browser-native@latest -- pi-agent-browser-config browser executable clear [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config paths
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config show
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config web-search status
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config web-search set-key --stdin --provider <exa|brave> [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config web-search set-env <ENV_VAR> [--provider brave|exa] [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config web-search set-command <command> --provider <exa|brave> [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config web-search clear --provider <exa|brave|all> [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config web-search prefer <exa|brave|auto> [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config web-search enable [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config web-search disable [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config browser profile status
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config browser profile set <name|path> [--policy explicit-only|authenticated-only|always] [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config browser profile clear [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config browser executable status
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config browser executable set <path> [--global|--project]
+  npm exec --yes --package pi-agent-browser-native -- pi-agent-browser-config browser executable clear [--global|--project]
 
 Notes:
   Global config:  ~/.pi/config/pi-agent-browser-native/config.json
@@ -111,11 +112,14 @@ function readConfig(path) {
 	if (!existsSync(path)) {
 		return { ...DEFAULT_CONFIG };
 	}
-	const parsed = JSON.parse(readFileSync(path, "utf8"));
-	if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+	const parsed = parseAgentBrowserConfigJson(readFileSync(path, "utf8"));
+	if (!parsed.ok) {
+		throw new Error(`${path}: ${parsed.error}`);
+	}
+	if (!parsed.value || typeof parsed.value !== "object" || Array.isArray(parsed.value)) {
 		throw new Error(`${path} must contain a JSON object.`);
 	}
-	return { ...DEFAULT_CONFIG, ...parsed };
+	return { ...DEFAULT_CONFIG, ...parsed.value };
 }
 
 function writeConfig(path, config) {

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/scripts/doctor.mjs

@@ -33,13 +33,13 @@ const DEFAULT_AGENT_DIR = resolve(homedir(), ".pi/agent");
 /** @typedef {{readonly checks: readonly DoctorCheck[], readonly failures: readonly DoctorCheck[], readonly warnings: readonly string[]}} DoctorReport */
 /** @typedef {{readonly cwd?: string, readonly agentDir?: string, readonly settingsPaths?: readonly string[], readonly skipSourceCheck?: boolean, readonly readText?: (path: string) => Promise<string | undefined>, readonly pathExists?: (path: string) => Promise<boolean>, readonly runAgentBrowser?: (args: readonly string[]) => Promise<string>, readonly runPi?: (args: readonly string[]) => Promise<string>}} DoctorOptions */
 
-export function normalizeAgentBrowserVersion(output) {
+function normalizeAgentBrowserVersion(output) {
 	return String(output ?? "")
 		.trim()
 		.replace(/^agent-browser\s+/, "");
 }
 
-export function normalizePiVersion(output) {
+function normalizePiVersion(output) {
 	return String(output ?? "")
 		.trim()
 		.replace(/^pi\s+/, "");

package/scripts/platform-smoke/lease-evidence.mjs

@@ -13,6 +13,8 @@ import {
 } from "./suite-evidence.mjs";
 import { resolve } from "node:path";
 
+/** @typedef {{readonly code: number | null, readonly signal: string | null, readonly stdout?: string, readonly stderr?: string}} ProcessReceipt */
+/** @param {{readonly config: {readonly artifactRoot: string, readonly packageName: string, readonly [key: string]: unknown}, readonly targetName: string, readonly leaseId: string, readonly stopResult: ProcessReceipt, readonly staleCleanupResult?: ProcessReceipt | null, readonly runId?: string}} options */
 export function createLeaseCleanupResult({
 	config,
 	targetName,
@@ -83,10 +85,6 @@ export function createLeaseCleanupResult({
 	return { ok: assertions.ok, suiteDir, assertions };
 }
 
-export function createLeaseCleanupFailureResult(options) {
-	return createLeaseCleanupResult({ ...options, staleCleanupResult: null });
-}
-
 export function createLeaseWarmupFailureResult(
 	config,
 	targetName,

package/scripts/platform-smoke/linux-image/Dockerfile

@@ -1,13 +1,19 @@
 # Local Crabbox Ubuntu/Linux target image for pi-agent-browser-native platform smoke.
 # Build with npm run smoke:platform:ubuntu-image so the agent-browser version
-# comes from scripts/agent-browser-capability-baseline.mjs.
+# comes from scripts/agent-browser-capability-baseline.mjs. The Go toolchain
+# matches the version scripts/prepare-quality-checker.mjs selects for the
+# corrected quality checker that platform-target builds.
+
+FROM golang:1.27.1-bookworm AS go
 
 FROM node:24-bookworm
 
 ARG AGENT_BROWSER_VERSION
 
 USER root
-RUN apt-get update \
+COPY --from=go /usr/local/go /usr/local/go
+RUN ln -s /usr/local/go/bin/go /usr/local/go/bin/gofmt /usr/local/bin/ \
+	&& apt-get update \
 	&& apt-get install -y --no-install-recommends ca-certificates chromium fonts-liberation git libvulkan1 mesa-vulkan-drivers openssh-client tar xvfb \
 	&& npm install -g "agent-browser@${AGENT_BROWSER_VERSION}" \
 	&& groupadd -g 1002 circleci \

package/scripts/platform-smoke/targets.mjs

@@ -21,11 +21,7 @@ import {
 } from "./suite-evidence.mjs";
 
 export { buildBrowserDogfoodCommand, buildPlatformBuildCommand } from "./commands.mjs";
-export {
-	createLeaseCleanupFailureResult,
-	createLeaseCleanupResult,
-	createLeaseWarmupFailureResult,
-} from "./lease-evidence.mjs";
+export { createLeaseCleanupResult, createLeaseWarmupFailureResult } from "./lease-evidence.mjs";
 export { nodeVersionAtLeast } from "./suite-checks.mjs";
 export { platformFor } from "./suite-evidence.mjs";
 

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