pi-agent-browser-native 0.2.34 → 0.2.36

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

@@ -12,6 +12,22 @@ 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 sourceEvidence = Object.freeze({
+  repository: "vercel-labs/agent-browser",
+  upstreamHead: "4ad284890cb59564af603e6de403dd75dd19e832",
+  upstreamPackageVersion: "0.27.0",
+  inspectedSources: Object.freeze([
+    "agent-browser --version",
+    "agent-browser --help",
+    "selected agent-browser <command> --help output",
+    "README.md",
+    "CHANGELOG.md",
+    "agent-browser.schema.json",
+    "cli/src/commands.rs",
+    "cli/src/flags.rs",
+  ]),
+});
+
 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 = []) =>
@@ -28,15 +44,30 @@ const helpCommands = Object.freeze([
   helpCommand("skills help", ["skills", "--help"]),
   helpCommand("skills list", ["skills", "list"]),
   helpCommand("core skill full", ["skills", "get", "core", "--full"]),
+  helpCommand("open help", ["open", "--help"]),
+  helpCommand("click help", ["click", "--help"]),
+  helpCommand("key help", ["key", "--help"]),
+  helpCommand("scroll help", ["scroll", "--help"]),
+  helpCommand("scrollinto help", ["scrollinto", "--help"]),
+  helpCommand("keydown help", ["keydown", "--help"]),
+  helpCommand("keyup help", ["keyup", "--help"]),
+  helpCommand("get help", ["get", "--help"]),
+  helpCommand("is help", ["is", "--help"]),
+  helpCommand("mouse help", ["mouse", "--help"]),
+  helpCommand("set help", ["set", "--help"]),
   helpCommand("tab help", ["tab", "--help"]),
   helpCommand("snapshot help", ["snapshot", "--help"]),
+  helpCommand("eval help", ["eval", "--help"]),
   helpCommand("wait help", ["wait", "--help"]),
   helpCommand("screenshot help", ["screenshot", "--help"]),
+  helpCommand("pdf help", ["pdf", "--help"]),
+  helpCommand("close help", ["close", "--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("session help", ["session", "--help"]),
   helpCommand("frame help", ["frame", "--help"]),
   helpCommand("dialog help", ["dialog", "--help"]),
   helpCommand("window help", ["window", "--help"]),
@@ -51,6 +82,15 @@ const helpCommands = Object.freeze([
   helpCommand("trace help", ["trace", "--help"]),
   helpCommand("profiler help", ["profiler", "--help"]),
   helpCommand("record help", ["record", "--help"]),
+  helpCommand("console help", ["console", "--help"]),
+  helpCommand("errors help", ["errors", "--help"]),
+  helpCommand("clipboard help", ["clipboard", "--help"]),
+  helpCommand("tap help", ["tap", "--help"]),
+  helpCommand("swipe help", ["swipe", "--help"]),
+  helpCommand("device help", ["device", "--help"]),
+  helpCommand("install help", ["install", "--help"]),
+  helpCommand("upgrade help", ["upgrade", "--help"]),
+  helpCommand("profiles help", ["profiles", "--help"]),
 ]);
 
 const inventorySections = Object.freeze([
@@ -62,16 +102,21 @@ const inventorySections = Object.freeze([
       "skills get core",
       "skills get core --full",
       "skills get <name>",
+      "skills get <name> --full",
+      "skills get --all",
       "skills get electron",
       "skills get slack",
       "skills get dogfood",
       "skills get vercel-sandbox",
       "skills get agentcore",
       "skills path [name]",
+      "AGENT_BROWSER_SKILLS_DIR",
     ],
     [
       root("skills get core --full"),
       ["skills help", "get <name> --full"],
+      ["skills help", "get --all"],
+      ["skills help", "AGENT_BROWSER_SKILLS_DIR"],
       ["skills list", "core"],
       ["skills list", "electron"],
       ["skills list", "slack"],
@@ -87,12 +132,19 @@ const inventorySections = Object.freeze([
     "core-commands",
     "Core page, element, navigation, and extraction commands",
     [
+      "open [url]",
       "open <url>",
+      "goto <url>",
+      "navigate <url>",
       "click <sel>",
+      "click <sel> --new-tab",
       "dblclick <sel>",
       "type <sel> <text>",
       "fill <sel> <text>",
       "press <key>",
+      "key <key>",
+      "keydown <key>",
+      "keyup <key>",
       "keyboard type <text>",
       "keyboard inserttext <text>",
       "keydown Shift",
@@ -106,33 +158,68 @@ const inventorySections = Object.freeze([
       "upload <sel> <files...>",
       "download <sel> <path>",
       "scroll <dir> [px]",
+      "scroll <dir> [px] --selector <sel>",
       "scrollintoview <sel>",
+      "scrollinto <sel>",
       "wait <sel|ms>",
+      "wait --url <pattern>",
+      "wait --load <state>",
+      "wait --fn <expression>",
+      "wait --text <text>",
+      "wait --download [path]",
+      "screenshot [selector] [path]",
       "screenshot [path]",
       "screenshot --full",
       "screenshot --annotate",
       "pdf <path>",
       "snapshot",
+      "snapshot --cursor",
+      "snapshot --interactive",
+      "snapshot --urls",
+      "snapshot --compact",
+      "snapshot --depth <n>",
+      "snapshot --selector <sel>",
       "eval <js>",
+      "eval --stdin",
+      "eval -b <base64>",
       "connect <port|url>",
       "close [--all]",
+      "quit",
+      "exit",
       "back",
       "forward",
       "reload",
       "pushstate <url>",
       "get <what> [selector]",
+      "get cdp-url",
+      "get box <selector>",
+      "get styles <selector>",
       "is <what> <selector>",
       "find <locator> <value> <action>",
+      "find first <sel>",
+      "find last <sel>",
+      "find nth <n> <sel>",
+      "find role <role> --name <name>",
+      "find ... --exact",
       "mouse <action> [args]",
       "set <setting> [value]",
+      "set media <features>",
+      "tap <selector>",
+      "swipe <direction> [distance]",
     ],
     [
+      ["open help", "open [url]"],
+      ["open help", "aliases still require a URL."],
       root("open <url>"),
       root("click <sel>"),
+      ["click help", "--new-tab"],
       root("dblclick <sel>"),
       root("type <sel> <text>"),
       root("fill <sel> <text>"),
       root("press <key>"),
+      ["key help", "Aliases: key"],
+      ["keydown help", "keydown <key>"],
+      ["keyup help", "keyup <key>"],
       root("keyboard type <text>"),
       root("keyboard inserttext <text>"),
       root("hover <sel>"),
@@ -144,29 +231,57 @@ const inventorySections = Object.freeze([
       root("upload <sel> <files...>"),
       root("download <sel> <path>"),
       root("scroll <dir> [px]"),
+      ["scroll help", "--selector <sel>"],
       root("scrollintoview <sel>"),
+      ["scrollinto help", "Aliases: scrollinto"],
       root("wait <sel|ms>"),
+      ["wait help", "--url <pattern>"],
+      ["wait help", "--load <state>"],
+      ["wait help", "--fn <expression>"],
+      ["wait help", "--text <text>"],
+      ["wait help", "--download [path]"],
       root("screenshot [path]"),
+      ["screenshot help", "screenshot [selector] [path]"],
       root("pdf <path>"),
+      ["pdf help", "Save page as PDF"],
       root("snapshot"),
+      ["snapshot help", "--interactive"],
+      ["snapshot help", "--urls"],
+      ["snapshot help", "--compact"],
+      ["snapshot help", "--depth <n>"],
+      ["snapshot help", "--selector <sel>"],
       root("eval <js>"),
+      ["eval help", "--stdin"],
+      ["eval help", "-b, --base64"],
       root("connect <port|url>"),
       root("close [--all]"),
+      ["close help", "Aliases: quit, exit"],
       root("back"),
       root("forward"),
       root("reload"),
       root("pushstate <url>"),
       root("Get Info:  agent-browser get <what> [selector]"),
+      ["get help", "box <selector>"],
+      ["get help", "styles <selector>"],
+      ["get help", "cdp-url"],
       root("Check State:  agent-browser is <what> <selector>"),
       root("Find Elements:  agent-browser find <locator> <value> <action> [text]"),
+      ["find help", "first <selector>"],
+      ["find help", "last <selector>"],
+      ["find help", "nth <index> <selector>"],
+      ["find help", "--name <name>"],
+      ["find help", "--exact"],
       root("Mouse:  agent-browser mouse <action> [args]"),
       root("Browser Settings:  agent-browser set <setting> [value]"),
+      ["set help", "media [dark|light]"],
       ["keyboard help", "type <text>"],
       ["keyboard help", "inserttext <text>"],
       ["screenshot help", "--full, -f"],
       ["screenshot help", "--annotate"],
       ["find help", "role <role>"],
       ["find help", "testid <id>"],
+      ["tap help", "tap <selector>"],
+      ["swipe help", "swipe <direction> [distance]"],
     ],
   ),
   section(
@@ -177,8 +292,16 @@ const inventorySections = Object.freeze([
       "session list",
       "state save <path>",
       "state load <path>",
+      "state list",
+      "state show <filename>",
+      "state rename <old-name> <new-name>",
+      "state clear [session-name] [--all]",
+      "state clear -a",
+      "state clean --older-than <days>",
       "tab list",
+      "tab new [url]",
       "tab new --label <name> [url]",
+      "tab close [target]",
       "tab <t<N>|label>",
       "frame <selector|main>",
       "dialog accept [text]",
@@ -190,7 +313,15 @@ const inventorySections = Object.freeze([
       root("session list"),
       ["state help", "save <path>"],
       ["state help", "load <path>"],
+      ["state help", "list"],
+      ["state help", "show <filename>"],
+      ["state help", "rename <old-name> <new-name>"],
+      ["state help", "clear [session-name] [--all]"],
+      ["state help", "agent-browser state clear --all"],
+      ["state help", "clean --older-than <days>"],
+      ["tab help", "new [url]"],
       ["tab help", "new --label <name> [url]"],
+      ["tab help", "close [t<N>|label]"],
       ["tab help", "Stable tab ids"],
       ["frame help", "frame <selector|main>"],
       ["dialog help", "dialog <accept|dismiss|status> [text]"],
@@ -203,13 +334,21 @@ const inventorySections = Object.freeze([
     [
       "network <action>",
       "network route <url> [--abort|--body <json>] [--resource-type <csv>]",
+      "network unroute [url]",
+      "network requests [--clear] [--filter <pattern>] [--type <csv>] [--method <method>] [--status <code|range>]",
       "network request <requestId>",
+      "network har start",
+      "network har stop [path]",
       "cookies [get|set|clear]",
+      "cookies set <name> <value> --url <url> --domain <domain> --path <path> --httpOnly --secure --sameSite <Strict|Lax|None> --expires <timestamp>",
       "cookies set --curl <file>",
       "storage <local|session>",
       "diff snapshot",
+      "diff snapshot --baseline <file> --selector <sel> --compact --depth <n>",
       "diff screenshot --baseline",
+      "diff screenshot --baseline <file> --output <file> --threshold <0-1> --selector <sel> --full",
       "diff url <u1> <u2>",
+      "diff url <u1> <u2> --screenshot --wait-until <strategy> --selector <sel> --compact --depth <n>",
       "trace start|stop [path]",
       "profiler start|stop [path]",
       "record start <path> [url]",
@@ -220,6 +359,10 @@ const inventorySections = Object.freeze([
       "highlight <sel>",
       "inspect",
       "clipboard <op> [text]",
+      "clipboard read",
+      "clipboard write <text>",
+      "clipboard copy",
+      "clipboard paste",
       "stream enable [--port <n>]",
       "stream disable",
       "stream status",
@@ -229,11 +372,15 @@ const inventorySections = Object.freeze([
       "react renders stop [--json]",
       "react suspense [--only-dynamic] [--json]",
       "vitals [url] [--json]",
+      "web-vitals [url] [--json]",
       "removeinitscript <id>",
     ],
     [
       root("network <action>"),
       root("--resource-type <csv>"),
+      ["network help", "unroute [url]"],
+      ["network help", "network har start"],
+      ["network help", "network har stop ./capture.har"],
       root("cookies [get|set|clear]"),
       root("cookies set --curl <file>"),
       root("storage <local|session>"),
@@ -248,6 +395,10 @@ const inventorySections = Object.freeze([
       root("highlight <sel>"),
       root("inspect"),
       root("clipboard <op> [text]"),
+      ["clipboard help", "read"],
+      ["clipboard help", "write <text>"],
+      ["clipboard help", "copy"],
+      ["clipboard help", "paste"],
       root("stream enable [--port <n>]"),
       root("stream disable"),
       root("stream status"),
@@ -258,31 +409,47 @@ const inventorySections = Object.freeze([
       root("react suspense [--only-dynamic] [--json]"),
       root("vitals [url] [--json]"),
       root("removeinitscript <id>"),
+      ["network help", "requests [options]"],
+      ["network help", "--type <types>"],
+      ["network help", "--method <method>"],
+      ["network help", "--status <code>"],
       ["network help", "request <requestId>"],
       ["network help", "har <start|stop>"],
       ["storage help", "set <key> <value>"],
+      ["diff help", "diff snapshot [options]"],
+      ["diff help", "--baseline <f>"],
+      ["diff help", "--output <file>"],
+      ["diff help", "--threshold <0-1>"],
+      ["diff help", "--wait-until <strategy>"],
       ["diff help", "diff screenshot --baseline <f>"],
       ["trace help", "trace <operation> [path]"],
       ["profiler help", "--categories <list>"],
       ["record help", "record restart <path.webm> [url]"],
+      ["console help", "--clear"],
+      ["errors help", "--clear"],
     ],
   ),
   section(
     "batch-auth-setup-ai",
-    "Batch, auth, confirmations, setup, dashboard, and AI commands",
+    "Batch, auth, confirmations, setup, dashboard, devices, and AI commands",
     [
       "batch [--bail]",
       "auth save <name>",
+      "auth save <name> --url <url> --username <user> --password <pass>",
+      "auth save <name> --username-selector <s> --password-selector <s> --submit-selector <s>",
       "auth save <name> --password-stdin",
       "auth login <name>",
       "auth list",
       "auth show <name>",
       "auth delete <name>",
+      "auth remove <name>",
       "confirm <id>",
       "deny <id>",
       "chat <message>",
+      "dashboard [start]",
       "dashboard start --port <n>",
       "dashboard stop",
+      "device list",
       "install",
       "install --with-deps",
       "upgrade",
@@ -299,12 +466,19 @@ const inventorySections = Object.freeze([
       root("deny <id>"),
       root("chat <message>"),
       root("dashboard start --port <n>"),
+      ["device help", "device list"],
       root("install --with-deps"),
       root("upgrade"),
       root("doctor [--fix]"),
       root("profiles"),
       ["batch help", "--bail"],
+      ["auth help", "--url <url>"],
+      ["auth help", "--username <user>"],
+      ["auth help", "--password <pass>"],
       ["auth help", "--password-stdin"],
+      ["auth help", "--username-selector <s>"],
+      ["auth help", "--password-selector <s>"],
+      ["auth help", "--submit-selector <s>"],
       ["dashboard help", "dashboard [start|stop] [options]"],
       ["chat help", "chat <message>"],
       ["doctor help", "--offline"],
@@ -403,6 +577,7 @@ const inventorySections = Object.freeze([
       "AGENT_BROWSER_DEBUG",
       "AGENT_BROWSER_CONFIG",
       "AGENT_BROWSER_DEFAULT_TIMEOUT",
+      "--idle-timeout <ms>",
       "AGENT_BROWSER_STREAM_PORT",
       "AGENT_BROWSER_IDLE_TIMEOUT_MS",
       "AGENT_BROWSER_ENCRYPTION_KEY",
@@ -410,6 +585,27 @@ const inventorySections = Object.freeze([
       "AGENT_BROWSER_IOS_UDID",
       "AI_GATEWAY_URL",
       "AI_GATEWAY_API_KEY",
+      "BROWSERBASE_API_KEY",
+      "BROWSERBASE_PROJECT_ID",
+      "BROWSERLESS_API_KEY",
+      "BROWSERLESS_API_URL",
+      "BROWSERLESS_BROWSER_TYPE",
+      "BROWSERLESS_STEALTH",
+      "BROWSERLESS_TTL",
+      "BROWSER_USE_API_KEY",
+      "KERNEL_API_KEY",
+      "KERNEL_HEADLESS",
+      "KERNEL_STEALTH",
+      "KERNEL_TIMEOUT_SECONDS",
+      "KERNEL_PROFILE_NAME",
+      "AGENTCORE_API_KEY",
+      "AGENTCORE_REGION",
+      "AGENTCORE_BROWSER_ID",
+      "AGENTCORE_PROFILE_ID",
+      "AGENTCORE_SESSION_TIMEOUT",
+      "AWS_PROFILE",
+      "AWS_ACCESS_KEY_ID",
+      "AWS_SECRET_ACCESS_KEY",
     ],
     [
       root("--profile <name|path>"),
@@ -508,6 +704,7 @@ const inventorySections = Object.freeze([
 
 export const CAPABILITY_BASELINE = Object.freeze({
   targetVersion: "0.27.0",
+  sourceEvidence,
   helpCommands,
   inventorySections,
   docRequiredTokens: Object.freeze(inventorySections.flatMap((entry) => entry.docTokens)),