pi-agent-browser-native 0.2.24 → 0.2.26

package/scripts/agent-browser-capability-baseline.mjs

@@ -4,6 +4,7 @@
  * Scope: Versioned capability metadata only; it does not execute agent-browser or validate documentation by itself.
  * Usage: Imported by command-reference verifier, generated docs checker, and tests when upstream agent-browser is re-baselined.
  * Invariants/Assumptions: This package targets the current installed upstream agent-browser only and does not keep compatibility shims for older versions.
+ * Related: `docs/SUPPORT_MATRIX.md` maps `CAPABILITY_BASELINE.inventorySections` to human docs, runtime behavior, tests, and verification gates; refresh that matrix whenever this baseline changes.
  */
 
 export const CAPABILITY_BASELINE_SOURCE = "scripts/agent-browser-capability-baseline.mjs";
@@ -11,118 +12,506 @@ export const COMMAND_REFERENCE_DOC_PATH = "docs/COMMAND_REFERENCE.md";
 export const CAPABILITY_BASELINE_BLOCK_MARKER_PREFIX = "agent-browser-capability-baseline";
 export const COMMAND_REFERENCE_BASELINE_BLOCK_IDS = Object.freeze(["upstream-baseline", "capability-token-baseline"]);
 
+const helpCommand = (label, args) => Object.freeze({ label, args: Object.freeze(args) });
+const expectation = (help, token) => Object.freeze({ help, token });
+const section = (id, title, docTokens, upstreamExpectations = []) =>
+  Object.freeze({
+    id,
+    title,
+    docTokens: Object.freeze(docTokens),
+    upstreamExpectations: Object.freeze(upstreamExpectations.map(([help, token]) => expectation(help, token))),
+  });
+const root = (token) => ["root help", token];
+
+const helpCommands = Object.freeze([
+  helpCommand("root help", ["--help"]),
+  helpCommand("skills help", ["skills", "--help"]),
+  helpCommand("skills list", ["skills", "list"]),
+  helpCommand("core skill full", ["skills", "get", "core", "--full"]),
+  helpCommand("tab help", ["tab", "--help"]),
+  helpCommand("snapshot help", ["snapshot", "--help"]),
+  helpCommand("wait help", ["wait", "--help"]),
+  helpCommand("screenshot help", ["screenshot", "--help"]),
+  helpCommand("find help", ["find", "--help"]),
+  helpCommand("network help", ["network", "--help"]),
+  helpCommand("cookies help", ["cookies", "--help"]),
+  helpCommand("storage help", ["storage", "--help"]),
+  helpCommand("state help", ["state", "--help"]),
+  helpCommand("frame help", ["frame", "--help"]),
+  helpCommand("dialog help", ["dialog", "--help"]),
+  helpCommand("window help", ["window", "--help"]),
+  helpCommand("keyboard help", ["keyboard", "--help"]),
+  helpCommand("batch help", ["batch", "--help"]),
+  helpCommand("auth help", ["auth", "--help"]),
+  helpCommand("stream help", ["stream", "--help"]),
+  helpCommand("dashboard help", ["dashboard", "--help"]),
+  helpCommand("chat help", ["chat", "--help"]),
+  helpCommand("doctor help", ["doctor", "--help"]),
+  helpCommand("diff help", ["diff", "--help"]),
+  helpCommand("trace help", ["trace", "--help"]),
+  helpCommand("profiler help", ["profiler", "--help"]),
+  helpCommand("record help", ["record", "--help"]),
+]);
+
+const inventorySections = Object.freeze([
+  section(
+    "skills",
+    "Built-in skills",
+    [
+      "skills list",
+      "skills get core",
+      "skills get core --full",
+      "skills get <name>",
+      "skills get electron",
+      "skills get slack",
+      "skills get dogfood",
+      "skills get vercel-sandbox",
+      "skills get agentcore",
+      "skills path [name]",
+    ],
+    [
+      root("skills get core --full"),
+      ["skills help", "get <name> --full"],
+      ["skills list", "core"],
+      ["skills list", "electron"],
+      ["skills list", "slack"],
+      ["skills list", "dogfood"],
+      ["skills list", "vercel-sandbox"],
+      ["skills list", "agentcore"],
+      ["core skill full", "agent-browser frame @e3"],
+      ["core skill full", "agent-browser dialog accept"],
+      ["core skill full", "agent-browser state save ./auth.json"],
+    ],
+  ),
+  section(
+    "core-commands",
+    "Core page, element, navigation, and extraction commands",
+    [
+      "open <url>",
+      "click <sel>",
+      "dblclick <sel>",
+      "type <sel> <text>",
+      "fill <sel> <text>",
+      "press <key>",
+      "keyboard type <text>",
+      "keyboard inserttext <text>",
+      "keydown Shift",
+      "keyup Shift",
+      "hover <sel>",
+      "focus <sel>",
+      "check <sel>",
+      "uncheck <sel>",
+      "select <sel> <val...>",
+      "drag <src> <dst>",
+      "upload <sel> <files...>",
+      "download <sel> <path>",
+      "scroll <dir> [px]",
+      "scrollintoview <sel>",
+      "wait <sel|ms>",
+      "screenshot [path]",
+      "screenshot --full",
+      "screenshot --annotate",
+      "pdf <path>",
+      "snapshot",
+      "eval <js>",
+      "connect <port|url>",
+      "close [--all]",
+      "back",
+      "forward",
+      "reload",
+      "pushstate <url>",
+      "get <what> [selector]",
+      "is <what> <selector>",
+      "find <locator> <value> <action>",
+      "mouse <action> [args]",
+      "set <setting> [value]",
+    ],
+    [
+      root("open <url>"),
+      root("click <sel>"),
+      root("dblclick <sel>"),
+      root("type <sel> <text>"),
+      root("fill <sel> <text>"),
+      root("press <key>"),
+      root("keyboard type <text>"),
+      root("keyboard inserttext <text>"),
+      root("hover <sel>"),
+      root("focus <sel>"),
+      root("check <sel>"),
+      root("uncheck <sel>"),
+      root("select <sel> <val...>"),
+      root("drag <src> <dst>"),
+      root("upload <sel> <files...>"),
+      root("download <sel> <path>"),
+      root("scroll <dir> [px]"),
+      root("scrollintoview <sel>"),
+      root("wait <sel|ms>"),
+      root("screenshot [path]"),
+      root("pdf <path>"),
+      root("snapshot"),
+      root("eval <js>"),
+      root("connect <port|url>"),
+      root("close [--all]"),
+      root("back"),
+      root("forward"),
+      root("reload"),
+      root("pushstate <url>"),
+      root("Get Info:  agent-browser get <what> [selector]"),
+      root("Check State:  agent-browser is <what> <selector>"),
+      root("Find Elements:  agent-browser find <locator> <value> <action> [text]"),
+      root("Mouse:  agent-browser mouse <action> [args]"),
+      root("Browser Settings:  agent-browser set <setting> [value]"),
+      ["keyboard help", "type <text>"],
+      ["keyboard help", "inserttext <text>"],
+      ["screenshot help", "--full, -f"],
+      ["screenshot help", "--annotate"],
+      ["find help", "role <role>"],
+      ["find help", "testid <id>"],
+    ],
+  ),
+  section(
+    "state-tabs-frames-dialogs",
+    "Sessions, state, tabs, frames, dialogs, and windows",
+    [
+      "session",
+      "session list",
+      "state save <path>",
+      "state load <path>",
+      "tab list",
+      "tab new --label <name> [url]",
+      "tab <t<N>|label>",
+      "frame <selector|main>",
+      "dialog accept [text]",
+      "dialog dismiss",
+      "dialog status",
+      "window new",
+    ],
+    [
+      root("session list"),
+      ["state help", "save <path>"],
+      ["state help", "load <path>"],
+      ["tab help", "new --label <name> [url]"],
+      ["tab help", "Stable tab ids"],
+      ["frame help", "frame <selector|main>"],
+      ["dialog help", "dialog <accept|dismiss|status> [text]"],
+      ["window help", "window <operation>"],
+    ],
+  ),
+  section(
+    "network-storage-artifacts-diagnostics",
+    "Network, storage, artifacts, diagnostics, and performance",
+    [
+      "network <action>",
+      "network route <url> [--abort|--body <json>] [--resource-type <csv>]",
+      "network request <requestId>",
+      "cookies [get|set|clear]",
+      "cookies set --curl <file>",
+      "storage <local|session>",
+      "diff snapshot",
+      "diff screenshot --baseline",
+      "diff url <u1> <u2>",
+      "trace start|stop [path]",
+      "profiler start|stop [path]",
+      "record start <path> [url]",
+      "record restart <path> [url]",
+      "record stop",
+      "console [--clear]",
+      "errors [--clear]",
+      "highlight <sel>",
+      "inspect",
+      "clipboard <op> [text]",
+      "stream enable [--port <n>]",
+      "stream disable",
+      "stream status",
+      "react tree",
+      "react inspect <id>",
+      "react renders start",
+      "react renders stop [--json]",
+      "react suspense [--only-dynamic] [--json]",
+      "vitals [url] [--json]",
+      "removeinitscript <id>",
+    ],
+    [
+      root("network <action>"),
+      root("--resource-type <csv>"),
+      root("cookies [get|set|clear]"),
+      root("cookies set --curl <file>"),
+      root("storage <local|session>"),
+      root("diff snapshot"),
+      root("diff screenshot --baseline"),
+      root("trace start|stop [path]"),
+      root("profiler start|stop [path]"),
+      root("record start <path> [url]"),
+      root("record stop"),
+      root("console [--clear]"),
+      root("errors [--clear]"),
+      root("highlight <sel>"),
+      root("inspect"),
+      root("clipboard <op> [text]"),
+      root("stream enable [--port <n>]"),
+      root("stream disable"),
+      root("stream status"),
+      root("react tree"),
+      root("react inspect <id>"),
+      root("react renders start"),
+      root("react renders stop [--json]"),
+      root("react suspense [--only-dynamic] [--json]"),
+      root("vitals [url] [--json]"),
+      root("removeinitscript <id>"),
+      ["network help", "request <requestId>"],
+      ["network help", "har <start|stop>"],
+      ["storage help", "set <key> <value>"],
+      ["diff help", "diff screenshot --baseline <f>"],
+      ["trace help", "trace <operation> [path]"],
+      ["profiler help", "--categories <list>"],
+      ["record help", "record restart <path.webm> [url]"],
+    ],
+  ),
+  section(
+    "batch-auth-setup-ai",
+    "Batch, auth, confirmations, setup, dashboard, and AI commands",
+    [
+      "batch [--bail]",
+      "auth save <name>",
+      "auth save <name> --password-stdin",
+      "auth login <name>",
+      "auth list",
+      "auth show <name>",
+      "auth delete <name>",
+      "confirm <id>",
+      "deny <id>",
+      "chat <message>",
+      "dashboard start --port <n>",
+      "dashboard stop",
+      "install",
+      "install --with-deps",
+      "upgrade",
+      "doctor [--fix]",
+      "doctor --offline --quick",
+      "doctor --json",
+      "profiles",
+    ],
+    [
+      root("batch [--bail]"),
+      root("auth save <name>"),
+      root("auth login <name>"),
+      root("confirm <id>"),
+      root("deny <id>"),
+      root("chat <message>"),
+      root("dashboard start --port <n>"),
+      root("install --with-deps"),
+      root("upgrade"),
+      root("doctor [--fix]"),
+      root("profiles"),
+      ["batch help", "--bail"],
+      ["auth help", "--password-stdin"],
+      ["dashboard help", "dashboard [start|stop] [options]"],
+      ["chat help", "chat <message>"],
+      ["doctor help", "--offline"],
+      ["doctor help", "--json"],
+    ],
+  ),
+  section(
+    "options-and-env",
+    "Global flags, config, providers, policy, and environment",
+    [
+      "--profile <name|path>",
+      "AGENT_BROWSER_PROFILE",
+      "--session <name>",
+      "AGENT_BROWSER_SESSION",
+      "--session-name <name>",
+      "AGENT_BROWSER_SESSION_NAME",
+      "--state <path>",
+      "AGENT_BROWSER_STATE",
+      "--auto-connect",
+      "AGENT_BROWSER_AUTO_CONNECT",
+      "--headers <json>",
+      "--init-script <path>",
+      "AGENT_BROWSER_INIT_SCRIPTS",
+      "--enable <feature>",
+      "AGENT_BROWSER_ENABLE",
+      "--executable-path <path>",
+      "AGENT_BROWSER_EXECUTABLE_PATH",
+      "--extension <path>",
+      "AGENT_BROWSER_EXTENSIONS",
+      "--args <args>",
+      "AGENT_BROWSER_ARGS",
+      "--user-agent <ua>",
+      "AGENT_BROWSER_USER_AGENT",
+      "--proxy <server>",
+      "AGENT_BROWSER_PROXY",
+      "HTTP_PROXY",
+      "HTTPS_PROXY",
+      "ALL_PROXY",
+      "--proxy-bypass <hosts>",
+      "AGENT_BROWSER_PROXY_BYPASS",
+      "NO_PROXY",
+      "--ignore-https-errors",
+      "AGENT_BROWSER_IGNORE_HTTPS_ERRORS",
+      "--allow-file-access",
+      "AGENT_BROWSER_ALLOW_FILE_ACCESS",
+      "--headed",
+      "AGENT_BROWSER_HEADED",
+      "--cdp <port>",
+      "--color-scheme <scheme>",
+      "AGENT_BROWSER_COLOR_SCHEME",
+      "--download-path <path>",
+      "AGENT_BROWSER_DOWNLOAD_PATH",
+      "--engine <name>",
+      "AGENT_BROWSER_ENGINE",
+      "--no-auto-dialog",
+      "AGENT_BROWSER_NO_AUTO_DIALOG",
+      "--json",
+      "AGENT_BROWSER_JSON",
+      "--annotate",
+      "AGENT_BROWSER_ANNOTATE",
+      "--screenshot-dir <path>",
+      "AGENT_BROWSER_SCREENSHOT_DIR",
+      "--screenshot-quality <n>",
+      "AGENT_BROWSER_SCREENSHOT_QUALITY",
+      "--screenshot-format <fmt>",
+      "AGENT_BROWSER_SCREENSHOT_FORMAT",
+      "--content-boundaries",
+      "AGENT_BROWSER_CONTENT_BOUNDARIES",
+      "--max-output <chars>",
+      "AGENT_BROWSER_MAX_OUTPUT",
+      "--allowed-domains <list>",
+      "AGENT_BROWSER_ALLOWED_DOMAINS",
+      "--action-policy <path>",
+      "AGENT_BROWSER_ACTION_POLICY",
+      "--confirm-actions <list>",
+      "AGENT_BROWSER_CONFIRM_ACTIONS",
+      "--confirm-interactive",
+      "AGENT_BROWSER_CONFIRM_INTERACTIVE",
+      "-p, --provider <name>",
+      "AGENT_BROWSER_PROVIDER",
+      "browserbase",
+      "kernel",
+      "browseruse",
+      "browserless",
+      "agentcore",
+      "--device <name>",
+      "AGENT_BROWSER_IOS_DEVICE",
+      "agent-browser -p ios device list",
+      "agent-browser -p ios swipe up",
+      "agent-browser -p ios tap @e1",
+      "--model <name>",
+      "AI_GATEWAY_MODEL",
+      "-v, --verbose",
+      "-q, --quiet",
+      "--debug",
+      "AGENT_BROWSER_DEBUG",
+      "AGENT_BROWSER_CONFIG",
+      "AGENT_BROWSER_DEFAULT_TIMEOUT",
+      "AGENT_BROWSER_STREAM_PORT",
+      "AGENT_BROWSER_IDLE_TIMEOUT_MS",
+      "AGENT_BROWSER_ENCRYPTION_KEY",
+      "AGENT_BROWSER_STATE_EXPIRE_DAYS",
+      "AGENT_BROWSER_IOS_UDID",
+      "AI_GATEWAY_URL",
+      "AI_GATEWAY_API_KEY",
+    ],
+    [
+      root("--profile <name|path>"),
+      root("AGENT_BROWSER_PROFILE"),
+      root("--session <name>"),
+      root("AGENT_BROWSER_SESSION"),
+      root("--session-name <name>"),
+      root("AGENT_BROWSER_SESSION_NAME"),
+      root("--state <path>"),
+      root("AGENT_BROWSER_STATE"),
+      root("--auto-connect"),
+      root("AGENT_BROWSER_AUTO_CONNECT"),
+      root("--headers <json>"),
+      root("--init-script <path>"),
+      root("AGENT_BROWSER_INIT_SCRIPTS"),
+      root("--enable <feature>"),
+      root("AGENT_BROWSER_ENABLE"),
+      root("--executable-path <path>"),
+      root("AGENT_BROWSER_EXECUTABLE_PATH"),
+      root("--extension <path>"),
+      root("AGENT_BROWSER_EXTENSIONS"),
+      root("--args <args>"),
+      root("AGENT_BROWSER_ARGS"),
+      root("--user-agent <ua>"),
+      root("AGENT_BROWSER_USER_AGENT"),
+      root("--proxy <server>"),
+      root("AGENT_BROWSER_PROXY"),
+      root("HTTP_PROXY / HTTPS_PROXY"),
+      root("ALL_PROXY"),
+      root("--proxy-bypass <hosts>"),
+      root("AGENT_BROWSER_PROXY_BYPASS"),
+      root("NO_PROXY"),
+      root("--ignore-https-errors"),
+      root("AGENT_BROWSER_IGNORE_HTTPS_ERRORS"),
+      root("--allow-file-access"),
+      root("AGENT_BROWSER_ALLOW_FILE_ACCESS"),
+      root("--headed"),
+      root("AGENT_BROWSER_HEADED"),
+      root("--cdp <port>"),
+      root("--color-scheme <scheme>"),
+      root("AGENT_BROWSER_COLOR_SCHEME"),
+      root("--download-path <path>"),
+      root("AGENT_BROWSER_DOWNLOAD_PATH"),
+      root("--engine <name>"),
+      root("AGENT_BROWSER_ENGINE"),
+      root("--no-auto-dialog"),
+      root("AGENT_BROWSER_NO_AUTO_DIALOG"),
+      root("--json"),
+      root("AGENT_BROWSER_JSON"),
+      root("--annotate"),
+      root("AGENT_BROWSER_ANNOTATE"),
+      root("--screenshot-dir <path>"),
+      root("AGENT_BROWSER_SCREENSHOT_DIR"),
+      root("--screenshot-quality <n>"),
+      root("AGENT_BROWSER_SCREENSHOT_QUALITY"),
+      root("--screenshot-format <fmt>"),
+      root("AGENT_BROWSER_SCREENSHOT_FORMAT"),
+      root("--content-boundaries"),
+      root("AGENT_BROWSER_CONTENT_BOUNDARIES"),
+      root("--max-output <chars>"),
+      root("AGENT_BROWSER_MAX_OUTPUT"),
+      root("--allowed-domains <list>"),
+      root("AGENT_BROWSER_ALLOWED_DOMAINS"),
+      root("--action-policy <path>"),
+      root("AGENT_BROWSER_ACTION_POLICY"),
+      root("--confirm-actions <list>"),
+      root("AGENT_BROWSER_CONFIRM_ACTIONS"),
+      root("--confirm-interactive"),
+      root("AGENT_BROWSER_CONFIRM_INTERACTIVE"),
+      root("--provider <name>"),
+      root("AGENT_BROWSER_PROVIDER"),
+      root("agent-browser -p ios device list"),
+      root("agent-browser -p ios swipe up"),
+      root("agent-browser -p ios tap @e1"),
+      root("--device <name>"),
+      root("AGENT_BROWSER_IOS_DEVICE"),
+      root("--model <name>"),
+      root("AI_GATEWAY_MODEL"),
+      root("--verbose"),
+      root("--quiet"),
+      root("--debug"),
+      root("AGENT_BROWSER_DEBUG"),
+      root("--config <path>"),
+      root("AGENT_BROWSER_CONFIG"),
+      root("AGENT_BROWSER_DEFAULT_TIMEOUT"),
+      root("AGENT_BROWSER_STREAM_PORT"),
+      root("AGENT_BROWSER_IDLE_TIMEOUT_MS"),
+      root("AGENT_BROWSER_ENCRYPTION_KEY"),
+      root("AGENT_BROWSER_STATE_EXPIRE_DAYS"),
+      root("AGENT_BROWSER_IOS_UDID"),
+      root("AI_GATEWAY_URL"),
+      root("AI_GATEWAY_API_KEY"),
+    ],
+  ),
+]);
+
 export const CAPABILITY_BASELINE = Object.freeze({
   targetVersion: "0.27.0",
-  helpCommands: Object.freeze([
-    Object.freeze({ label: "root help", args: Object.freeze(["--help"]) }),
-    Object.freeze({ label: "tab help", args: Object.freeze(["tab", "--help"]) }),
-    Object.freeze({ label: "snapshot help", args: Object.freeze(["snapshot", "--help"]) }),
-    Object.freeze({ label: "wait help", args: Object.freeze(["wait", "--help"]) }),
-  ]),
-  docRequiredTokens: Object.freeze([
-    "skills list",
-    "skills get core --full",
-    "keyboard type <text>",
-    "scroll <dir> [px]",
-    "scrollintoview <sel>",
-    "connect <port|url>",
-    "is <what> <selector>",
-    "find <locator> <value> <action>",
-    "mouse <action> [args]",
-    "set <setting> [value]",
-    "network <action>",
-    "cookies [get|set|clear]",
-    "storage <local|session>",
-    "diff snapshot",
-    "trace start|stop [path]",
-    "profiler start|stop [path]",
-    "record start <path> [url]",
-    "console [--clear]",
-    "errors [--clear]",
-    "highlight <sel>",
-    "inspect",
-    "clipboard <op> [text]",
-    "stream enable [--port <n>]",
-    "react tree",
-    "react inspect <id>",
-    "react renders start",
-    "react renders stop [--json]",
-    "react suspense [--only-dynamic] [--json]",
-    "vitals [url] [--json]",
-    "pushstate <url>",
-    "removeinitscript <id>",
-    "--init-script <path>",
-    "--enable <feature>",
-    "AGENT_BROWSER_INIT_SCRIPTS",
-    "AGENT_BROWSER_ENABLE",
-    "network route <url> [--abort|--body <json>] [--resource-type <csv>]",
-    "cookies set --curl <file>",
-    "auth save <name>",
-    "confirm <id>",
-    "deny <id>",
-    "chat <message>",
-    "dashboard start --port <n>",
-    "install --with-deps",
-    "upgrade",
-    "doctor [--fix]",
-    "profiles",
-    "snapshot -i --urls",
-    "snapshot --urls",
-    "wait --download [path]",
-    "tab new --label <name> [url]",
-    "--action-policy <path>",
-    "--confirm-actions <list>",
-    "--engine <name>",
-    "AGENT_BROWSER_CONFIG",
-  ]),
-  upstreamExpectations: Object.freeze([
-    Object.freeze({ token: "skills", help: "root help" }),
-    Object.freeze({ token: "keyboard", help: "root help" }),
-    Object.freeze({ token: "scroll", help: "root help" }),
-    Object.freeze({ token: "scrollintoview", help: "root help" }),
-    Object.freeze({ token: "connect", help: "root help" }),
-    Object.freeze({ token: "is", help: "root help" }),
-    Object.freeze({ token: "find", help: "root help" }),
-    Object.freeze({ token: "mouse", help: "root help" }),
-    Object.freeze({ token: "set", help: "root help" }),
-    Object.freeze({ token: "network", help: "root help" }),
-    Object.freeze({ token: "cookies [get|set|clear]", help: "root help" }),
-    Object.freeze({ token: "storage", help: "root help" }),
-    Object.freeze({ token: "diff snapshot", help: "root help" }),
-    Object.freeze({ token: "trace start|stop [path]", help: "root help" }),
-    Object.freeze({ token: "profiler start|stop [path]", help: "root help" }),
-    Object.freeze({ token: "record start <path> [url]", help: "root help" }),
-    Object.freeze({ token: "console [--clear]", help: "root help" }),
-    Object.freeze({ token: "errors [--clear]", help: "root help" }),
-    Object.freeze({ token: "highlight <sel>", help: "root help" }),
-    Object.freeze({ token: "inspect", help: "root help" }),
-    Object.freeze({ token: "clipboard <op> [text]", help: "root help" }),
-    Object.freeze({ token: "stream enable [--port <n>]", help: "root help" }),
-    Object.freeze({ token: "react tree", help: "root help" }),
-    Object.freeze({ token: "react inspect <id>", help: "root help" }),
-    Object.freeze({ token: "react renders start", help: "root help" }),
-    Object.freeze({ token: "react renders stop [--json]", help: "root help" }),
-    Object.freeze({ token: "react suspense [--only-dynamic] [--json]", help: "root help" }),
-    Object.freeze({ token: "vitals [url] [--json]", help: "root help" }),
-    Object.freeze({ token: "pushstate <url>", help: "root help" }),
-    Object.freeze({ token: "removeinitscript <id>", help: "root help" }),
-    Object.freeze({ token: "--init-script <path>", help: "root help" }),
-    Object.freeze({ token: "--enable <feature>", help: "root help" }),
-    Object.freeze({ token: "--resource-type <csv>", help: "root help" }),
-    Object.freeze({ token: "cookies set --curl <file>", help: "root help" }),
-    Object.freeze({ token: "auth save <name>", help: "root help" }),
-    Object.freeze({ token: "confirm <id>", help: "root help" }),
-    Object.freeze({ token: "deny <id>", help: "root help" }),
-    Object.freeze({ token: "chat <message>", help: "root help" }),
-    Object.freeze({ token: "dashboard start --port <n>", help: "root help" }),
-    Object.freeze({ token: "install --with-deps", help: "root help" }),
-    Object.freeze({ token: "upgrade", help: "root help" }),
-    Object.freeze({ token: "doctor [--fix]", help: "root help" }),
-    Object.freeze({ token: "profiles", help: "root help" }),
-    Object.freeze({ token: "-u, --urls", help: "snapshot help" }),
-    Object.freeze({ token: "--download [path]", help: "wait help" }),
-    Object.freeze({ token: "new --label <name> [url]", help: "tab help" }),
-  ]),
+  helpCommands,
+  inventorySections,
+  docRequiredTokens: Object.freeze(inventorySections.flatMap((entry) => entry.docTokens)),
+  upstreamExpectations: Object.freeze(inventorySections.flatMap((entry) => entry.upstreamExpectations)),
 });
 
 export function expectedVersionLabel() {

package/scripts/doctor.mjs

@@ -280,7 +280,7 @@ async function checkAgentBrowserVersion({ runAgentBrowser }) {
 				title: `agent-browser version drift: expected ${EXPECTED_VERSION}, found ${version || "<empty>"}.`,
 				lines: [
 					`This wrapper targets the current baseline from ${CAPABILITY_BASELINE_SOURCE} and does not provide backwards-compatibility shims.`,
-					`Update upstream agent-browser to ${EXPECTED_VERSION}, or if you intentionally re-baselined upstream, update ${CAPABILITY_BASELINE_SOURCE} and refresh docs.`,
+					`Update upstream agent-browser to ${EXPECTED_VERSION}, or if you intentionally re-baselined upstream, update ${CAPABILITY_BASELINE_SOURCE}, run \`npm run docs -- command-reference write\`, refresh docs/COMMAND_REFERENCE.md, and rerun \`npm run verify -- command-reference\` plus \`npm run verify -- real-upstream\` with test/fixtures/agent-browser-real-output-shapes.json aligned to the new target version.`,
 				],
 			};
 		}