pi-agent-browser-native 0.3.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-agent-browser-native",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "pi extension that exposes agent-browser as a native tool for browser automation",
   "type": "module",
   "author": "Mitch Fultz (https://github.com/fitchmultz)",
@@ -36,7 +36,9 @@
     "scripts/config.mjs",
     "scripts/doctor.mjs",
     "scripts/prepare.mjs",
+    "scripts/build.mjs",
     "scripts/agent-browser-capability-baseline.mjs",
+    "scripts/agent-browser-target.mjs",
     "scripts/platform-smoke.mjs",
     "scripts/platform-smoke",
     "README.md",

package/platform-smoke.config.mjs

@@ -22,9 +22,9 @@ export default {
 	ubuntuContainerImage: PLATFORM_SMOKE_UBUNTU_IMAGE,
 	windowsParallels: {
 		sourceVm: "pi-extension-windows-template",
-		// Shared template snapshot; refresh when the Windows image moves past agent-browser 0.33.0.
+		// Shared template snapshot; refresh when the Windows image moves past agent-browser 0.34.0.
 		// Parent crabbox-ready remains for other projects' linked clones.
-		snapshot: "crabbox-ready-ab-0.33.0",
+		snapshot: "crabbox-ready-ab-0.34.0-d",
 	},
 	nodeValidationMajor: 22,
 	agentBrowserVersion: PLATFORM_SMOKE_AGENT_BROWSER_VERSION,

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

@@ -1,12 +1,14 @@
 /**
  * Purpose: Define the canonical upstream agent-browser capability baseline targeted by this package.
- * Responsibilities: Store the target upstream version, sampled help commands, and verifier/doc token expectations in one importable metadata object.
+ * Responsibilities: Combine the canonical target from agent-browser-target.mjs with sampled help commands and verifier/doc token expectations.
  * 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.
+ * Usage: Imported by command-reference verifier, generated docs checker, and tests when upstream agent-browser is re-baselined; runtime imports only agent-browser-target.mjs.
  * 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.
  */
 
+import { TARGET_AGENT_BROWSER_VERSION } from "./agent-browser-target.mjs";
+
 export const CAPABILITY_BASELINE_SOURCE = "scripts/agent-browser-capability-baseline.mjs";
 export const COMMAND_REFERENCE_DOC_PATH = "docs/COMMAND_REFERENCE.md";
 export const CAPABILITY_BASELINE_BLOCK_MARKER_PREFIX = "agent-browser-capability-baseline";
@@ -14,8 +16,8 @@ export const COMMAND_REFERENCE_BASELINE_BLOCK_IDS = Object.freeze(["upstream-bas
 
 const sourceEvidence = Object.freeze({
   repository: "vercel-labs/agent-browser",
-  upstreamHead: "93cdda5709e8861c0c26b0b955d8d746e9fda0d7",
-  upstreamPackageVersion: "0.33.2",
+  upstreamHead: "548b159b30eef119ccf6846c8bc807d0eaa3f6f8",
+  upstreamPackageVersion: "0.34.0",
   inspectedSources: Object.freeze([
     "agent-browser --version",
     "agent-browser --help",
@@ -36,6 +38,7 @@ const sourceEvidence = Object.freeze({
     "cli/src/native/actions.rs",
     "cli/src/native/a11y/mod.rs",
     "cli/src/native/browser.rs",
+    "cli/src/native/tab_binding.rs",
     "cli/src/native/daemon.rs",
     "cli/src/output.rs",
     "docs/src/app/webgpu/page.mdx",
@@ -365,6 +368,10 @@ const inventorySections = Object.freeze([
       "tab new --label <name> [url]",
       "tab close [target]",
       "tab <t<N>|label>",
+      "tab_gone",
+      "data.targetId",
+      "data.lastUrl",
+      "CDP target ids",
       "frame <selector|main>",
       "dialog accept [text]",
       "dialog dismiss",
@@ -387,8 +394,13 @@ const inventorySections = Object.freeze([
       ["state help", "clean --older-than <days>"],
       ["tab help", "new [url]"],
       ["tab help", "new --label <name> [url]"],
-      ["tab help", "close [t<N>|label]"],
+      ["tab help", "close [t<N>|label|target]"],
       ["tab help", "Stable tab ids"],
+      ["tab help", "tab_gone"],
+      ["tab help", "data.targetId"],
+      ["tab help", "data.lastUrl"],
+      ["core skill full", "--pin-tab"],
+      ["core skill full", "tab_gone"],
       ["frame help", "frame <selector|main>"],
       ["dialog help", "dialog <accept|dismiss|status> [text]"],
       ["window help", "window <operation>"],
@@ -615,6 +627,9 @@ const inventorySections = Object.freeze([
       "AGENT_BROWSER_STATE",
       "--auto-connect",
       "AGENT_BROWSER_AUTO_CONNECT",
+      "--pin-tab",
+      "--no-pin-tab",
+      "AGENT_BROWSER_PIN_TAB",
       "--headers <json>",
       "--init-script <path>",
       "AGENT_BROWSER_INIT_SCRIPTS",
@@ -759,6 +774,9 @@ const inventorySections = Object.freeze([
       root("AGENT_BROWSER_STATE"),
       root("--auto-connect"),
       root("AGENT_BROWSER_AUTO_CONNECT"),
+      root("--pin-tab"),
+      root("--no-pin-tab"),
+      root("AGENT_BROWSER_PIN_TAB"),
       root("--headers <json>"),
       root("--init-script <path>"),
       root("AGENT_BROWSER_INIT_SCRIPTS"),
@@ -852,7 +870,7 @@ const inventorySections = Object.freeze([
 ]);
 
 export const CAPABILITY_BASELINE = Object.freeze({
-  targetVersion: "0.33.2",
+  targetVersion: TARGET_AGENT_BROWSER_VERSION,
   sourceEvidence,
   helpCommands,
   inventorySections,

package/scripts/agent-browser-target.mjs

@@ -0,0 +1,3 @@
+export const TARGET_AGENT_BROWSER_SOURCE = "scripts/agent-browser-target.mjs";
+export const TARGET_AGENT_BROWSER_VERSION = "0.34.0";
+export const TARGET_AGENT_BROWSER_VERSION_LABEL = `agent-browser ${TARGET_AGENT_BROWSER_VERSION}`;

package/scripts/build.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * Purpose: Produce the compiled runtime files that the published Pi package loads.
+ * Responsibilities: Remove stale dist output, run TypeScript emit through the local compiler, 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` is installed and provides `typescript`; deleting `dist/` is safe because it is generated output.
+ */
+
+import { execFile as execFileCallback } from "node:child_process";
+import { rm } from "node:fs/promises";
+import { join } from "node:path";
+import process from "node:process";
+import { promisify } from "node:util";
+
+const execFile = promisify(execFileCallback);
+const binSuffix = process.platform === "win32" ? ".cmd" : "";
+const tscPath = join(process.cwd(), "node_modules", ".bin", `tsc${binSuffix}`);
+
+async function main() {
+	await rm(join(process.cwd(), "dist"), { force: true, maxRetries: 5, recursive: true, retryDelay: 100 });
+	const options = process.platform === "win32" ? { shell: true } : {};
+	try {
+		const { stderr, stdout } = await execFile(tscPath, ["-p", "tsconfig.build.json"], {
+			...options,
+			cwd: process.cwd(),
+			maxBuffer: 10 * 1024 * 1024,
+		});
+		if (stdout) process.stdout.write(stdout);
+		if (stderr) process.stderr.write(stderr);
+	} catch (error) {
+		if (error?.stdout) process.stdout.write(error.stdout);
+		if (error?.stderr) process.stderr.write(error.stderr);
+		throw error;
+	}
+}
+
+main().catch((error) => {
+	console.error(error instanceof Error ? error.message : String(error));
+	process.exitCode = 1;
+});

package/scripts/doctor.mjs

@@ -4,7 +4,7 @@
  * Responsibilities: Check upstream agent-browser PATH/version, inspect Pi settings for duplicate package/checkout sources, and print actionable remediation.
  * Scope: Read-only package diagnostics only; upstream browser runtime health remains the responsibility of upstream `agent-browser doctor`.
  * Usage: Run via `pi-agent-browser-doctor`, `npm exec --package pi-agent-browser-native -- pi-agent-browser-doctor`, or `npm run doctor` from this repository.
- * Invariants/Assumptions: The wrapper targets CAPABILITY_BASELINE.targetVersion, does not bundle agent-browser, and must not edit Pi settings or run fixing commands.
+ * Invariants/Assumptions: The wrapper targets TARGET_AGENT_BROWSER_VERSION, does not bundle agent-browser, and must not edit Pi settings or run fixing commands.
  */
 
 import { execFile as execFileCallback } from "node:child_process";
@@ -15,7 +15,8 @@ import { dirname, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
 
-import { CAPABILITY_BASELINE, CAPABILITY_BASELINE_SOURCE } from "./agent-browser-capability-baseline.mjs";
+import { CAPABILITY_BASELINE_SOURCE } from "./agent-browser-capability-baseline.mjs";
+import { TARGET_AGENT_BROWSER_SOURCE, TARGET_AGENT_BROWSER_VERSION } from "./agent-browser-target.mjs";
 
 const execFile = promisify(execFileCallback);
 const PACKAGE_NAME = "pi-agent-browser-native";
@@ -24,7 +25,7 @@ const EXTENSION_ENTRYPOINTS = Object.freeze([
 	"extensions/agent-browser/index.ts",
 	"dist/extensions/agent-browser/index.js",
 ]);
-const EXPECTED_VERSION = CAPABILITY_BASELINE.targetVersion;
+const EXPECTED_VERSION = TARGET_AGENT_BROWSER_VERSION;
 const MINIMUM_PI_VERSION = "0.84.0";
 const DEFAULT_AGENT_DIR = resolve(homedir(), ".pi/agent");
 const THIS_PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
@@ -69,7 +70,7 @@ Options:
 
 Checks:
   1. agent-browser is installed on PATH.
-  2. agent-browser --version matches the package capability baseline.
+  2. agent-browser --version matches the package target version.
   3. pi --version is at least the minimum Pi runtime version for this release.
   4. Pi settings and repo-local autoload locations do not point at multiple active pi-agent-browser-native sources.
 
@@ -345,8 +346,8 @@ async function checkAgentBrowserVersion({ runAgentBrowser }) {
 				status: "fail",
 				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}, 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.`,
+					`This wrapper targets the current version from ${TARGET_AGENT_BROWSER_SOURCE} and does not provide backwards-compatibility shims.`,
+					`Update upstream agent-browser to ${EXPECTED_VERSION}, or if you intentionally re-baselined upstream, update ${TARGET_AGENT_BROWSER_SOURCE} plus ${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.`,
 				],
 			};
 		}

package/scripts/platform-smoke/browser-dogfood-windows.ps1

@@ -1,5 +1,6 @@
 param(
-  [Parameter(Mandatory=$true)][string]$AgentBrowserVersion
+  [Parameter(Mandatory=$true)][string]$AgentBrowserVersion,
+  [switch]$SkipNpmCi
 )
 
 $ErrorActionPreference = "Continue"
@@ -90,8 +91,13 @@ Write-Output "PLATFORM_DOGFOOD_ARTIFACT_DIR=$DogfoodArtifactDir"
 $NodeVersion = (& node --version 2>$null)
 Write-Output "PLATFORM_NODE_VERSION=$NodeVersion"
 
-& npm ci 2>&1
-$NpmCiExit = $LASTEXITCODE
+if ($SkipNpmCi -and (Test-Path (Join-Path $SourceRoot "node_modules"))) {
+  Write-Output "PLATFORM_NPM_CI_SKIPPED=1"
+  $NpmCiExit = 0
+} else {
+  & npm ci 2>&1
+  $NpmCiExit = $LASTEXITCODE
+}
 Write-Output "PLATFORM_NPM_CI_EXIT=$NpmCiExit"
 
 $AgentBrowserPath = Get-AgentBrowserCommandPath

package/scripts/platform-smoke/targets.mjs

@@ -305,9 +305,9 @@ export function buildPlatformBuildCommand(targetName, packageName = "pi-agent-br
 	return lines.join("\n");
 }
 
-export function buildBrowserDogfoodCommand(targetName, agentBrowserVersion = CAPABILITY_BASELINE.targetVersion) {
+export function buildBrowserDogfoodCommand(targetName, agentBrowserVersion = CAPABILITY_BASELINE.targetVersion, dependenciesReady = false) {
 	if (platformFor(targetName) === "powershell") {
-		return `powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\platform-smoke\\browser-dogfood-windows.ps1 -AgentBrowserVersion ${psSingleQuote(agentBrowserVersion)}`;
+		return `powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\platform-smoke\\browser-dogfood-windows.ps1 -AgentBrowserVersion ${psSingleQuote(agentBrowserVersion)}${dependenciesReady ? " -SkipNpmCi" : ""}`;
 	}
 
 	const lines = [];
@@ -329,8 +329,12 @@ export function buildBrowserDogfoodCommand(targetName, agentBrowserVersion = CAP
 	lines.push(`echo "PLATFORM_AGENT_BROWSER_VERSION=$AGENT_BROWSER_VERSION_OUTPUT"`);
 	lines.push(`if [ "$AGENT_BROWSER_VERSION_COMMAND_EXIT" -eq 0 ] && [ "$AGENT_BROWSER_VERSION_OUTPUT" = "$EXPECTED_AGENT_BROWSER_VERSION" ]; then AGENT_BROWSER_READY_EXIT=0; else AGENT_BROWSER_READY_EXIT=1; fi`);
 	lines.push(`echo "PLATFORM_AGENT_BROWSER_READY_EXIT=$AGENT_BROWSER_READY_EXIT"`);
-	lines.push(`npm ci 2>&1`);
-	lines.push(`NPM_CI_EXIT=$?`);
+	if (dependenciesReady) {
+		lines.push(`if [ -d node_modules ]; then echo "PLATFORM_NPM_CI_SKIPPED=1"; NPM_CI_EXIT=0; else npm ci 2>&1; NPM_CI_EXIT=$?; fi`);
+	} else {
+		lines.push(`npm ci 2>&1`);
+		lines.push(`NPM_CI_EXIT=$?`);
+	}
 	lines.push(`echo "PLATFORM_NPM_CI_EXIT=$NPM_CI_EXIT"`);
 	lines.push(`TSX_CLI="$SOURCE_ROOT/node_modules/.bin/tsx"`);
 	lines.push(`if [ ! -x "$TSX_CLI" ]; then TSX_CLI="$(command -v tsx || true)"; fi`);
@@ -349,7 +353,7 @@ async function runBrowserDogfoodSuite(config, targetName, suiteName, leaseSessio
 	const startedAt = Date.now();
 	const platform = platformFor(targetName);
 	const slug = `${config.packageName}-${targetName}`;
-	const command = buildBrowserDogfoodCommand(targetName, config.agentBrowserVersion);
+	const command = buildBrowserDogfoodCommand(targetName, config.agentBrowserVersion, leaseSession?.dependenciesReady === true);
 	writeFileSync(resolve(suiteDir, "target.json"), JSON.stringify(targetEvidence(config, targetName, runId, slug), null, 2));
 	writeFileSync(resolve(suiteDir, "suite.json"), JSON.stringify({ suiteName, modelCalls: 0, realBrowser: true }, null, 2));
 	writeCommand(suiteDir, command);
@@ -496,12 +500,14 @@ export async function runTargetSuites(config, targetName, suiteNames) {
 	let staleCleanupResult;
 	try {
 		let sync = true;
+		let dependenciesReady = false;
 		for (const suiteName of suiteNames) {
 			console.log(`  Suite: ${suiteName}`);
-			const result = await runTargetSuite(config, targetName, suiteName, { ...lease, sync }, runId);
+			const result = await runTargetSuite(config, targetName, suiteName, { ...lease, dependenciesReady, sync }, runId);
 			results.push(result);
 			console.log(`  ${result.ok ? "PASS" : "FAIL"} ${suiteName} on ${targetName}`);
 			sync = false;
+			if (result.ok && suiteName === "platform-build") dependenciesReady = true;
 			if (!result.ok) break;
 		}
 	} finally {