pi-agent-browser-native 0.2.44 → 0.2.46

package/extensions/agent-browser/lib/results/presentation/registry.ts

@@ -33,6 +33,58 @@ function formatConfirmationRequiredSummary(confirmation: ConfirmationRequiredPre
 	return `Confirmation required: ${confirmation.id}`;
 }
 
+const VITALS_METRICS = ["lcp", "fcp", "ttfb", "inp", "cls"] as const;
+
+function coerceVitalsMetricValue(value: unknown): number | undefined {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (isRecord(value)) {
+		for (const nestedKey of ["value", "duration", "startTime", "score"] as const) {
+			const nestedValue = value[nestedKey];
+			if (typeof nestedValue === "number" && Number.isFinite(nestedValue)) return nestedValue;
+		}
+	}
+	return undefined;
+}
+
+function getVitalsMetric(data: Record<string, unknown>, key: string): number | undefined {
+	const metrics = isRecord(data.metrics) ? data.metrics : undefined;
+	return coerceVitalsMetricValue(data[key] ?? data[key.toUpperCase()] ?? metrics?.[key] ?? metrics?.[key.toUpperCase()]);
+}
+
+function formatVitalsMetric(key: string, value: number): string {
+	return key === "cls" ? `${key.toUpperCase()}: ${value}` : `${key.toUpperCase()}: ${Math.round(value)}ms`;
+}
+
+function getVitalsMetrics(data: Record<string, unknown>): string[] {
+	return VITALS_METRICS.flatMap((key) => {
+		const value = getVitalsMetric(data, key);
+		return value === undefined ? [] : [formatVitalsMetric(key, value)];
+	});
+}
+
+function getVitalsUnavailableReason(data: Record<string, unknown>): string {
+	for (const key of ["reason", "message", "error", "status"] as const) {
+		const value = data[key];
+		if (typeof value === "string" && value.trim().length > 0) return redactModelFacingText(value.trim());
+	}
+	return "No Core Web Vitals metric fields were present in the upstream result.";
+}
+
+function formatVitalsText(data: Record<string, unknown>): string {
+	const url = typeof data.url === "string" && data.url.trim().length > 0 ? redactModelFacingText(data.url.trim()) : undefined;
+	const metrics = getVitalsMetrics(data);
+	const lines = [url ? `Vitals for ${url}` : "Vitals result"];
+	if (metrics.length > 0) lines.push(...metrics.map((metric) => `- ${metric}`));
+	else lines.push(`Metrics unavailable: ${getVitalsUnavailableReason(data)}`);
+	return lines.join("\n");
+}
+
+function formatVitalsSummary(data: Record<string, unknown>): string | undefined {
+	const metrics = getVitalsMetrics(data);
+	if (metrics.length > 0) return `Vitals: ${metrics.join(", ")}`;
+	return "Vitals: metrics unavailable";
+}
+
 function formatConfirmationRequiredText(confirmation: ConfirmationRequiredPresentation): string {
 	const lines = [
 		"Confirmation required.",
@@ -87,6 +139,14 @@ const COMMAND_PRESENTERS: Record<string, CommandPresenter> = {
 		summary: (_commandInfo, data) => isRecord(data) && Array.isArray(data.tabs) ? `Tabs: ${data.tabs.length}` : undefined,
 		text: (_commandInfo, data) => isRecord(data) ? getTabSummary(data) : undefined,
 	},
+	vitals: {
+		summary: (_commandInfo, data) => isRecord(data) ? formatVitalsSummary(data) : undefined,
+		text: (_commandInfo, data) => isRecord(data) ? formatVitalsText(data) : undefined,
+	},
+	"web-vitals": {
+		summary: (_commandInfo, data) => isRecord(data) ? formatVitalsSummary(data) : undefined,
+		text: (_commandInfo, data) => isRecord(data) ? formatVitalsText(data) : undefined,
+	},
 };
 
 function formatBatchSummary(data: unknown): string | undefined {

package/extensions/agent-browser/lib/results/presentation.ts

@@ -66,6 +66,10 @@ function mergeNextActions(...groups: Array<AgentBrowserNextAction[] | undefined>
 	return merged.length > 0 ? merged : undefined;
 }
 
+function shouldAddAnnotatedScreenshotGuidance(commandInfo: CommandInfo, args: string[] | undefined): boolean {
+	return commandInfo.command === "screenshot" && (args?.includes("--annotate") ?? false);
+}
+
 export async function buildToolPresentation(options: {
 	artifactManifest?: SessionArtifactManifest;
 	args?: string[];
@@ -103,7 +107,7 @@ export async function buildToolPresentation(options: {
 
 	const data = enrichStreamStatusData(commandInfo, envelope?.data);
 	const presentationData = redactPresentationData(commandInfo, data);
-	const artifacts = await extractFileArtifacts({ artifactRequest, commandInfo: presentationCommandInfo, cwd, data, sessionName });
+	const artifacts = await extractFileArtifacts({ artifactManifest, artifactRequest, commandInfo: presentationCommandInfo, cwd, data, sessionName });
 	const artifactVerification = buildArtifactVerificationSummary(artifacts);
 	const artifactSummary = formatArtifactSummary(artifacts);
 	const summary = artifactSummary ?? formatPresentationSummary(commandInfo, data, compiledSemanticAction);
@@ -151,6 +155,11 @@ export async function buildToolPresentation(options: {
 		}
 	}
 
+	if (shouldAddAnnotatedScreenshotGuidance(commandInfo, args) && presentation.content[0]?.type === "text") {
+		const guidance = "Annotated screenshot note: dense pages can produce overlapping labels. If the labels are noisy, capture a scoped element screenshot, take a non-annotated screenshot, or use snapshot -i high-value refs as the machine-readable map.";
+		presentation.content[0] = { ...presentation.content[0], text: `${presentation.content[0].text}\n\n${guidance}` };
+	}
+
 	const imagePath = artifactRequest?.absolutePath ?? extractImagePath(commandInfo, cwd, data);
 	const presentationWithImage = imagePath ? await attachInlineImage(presentation, imagePath) : presentation;
 	const compactedPresentation = await compactLargePresentationOutput({

package/extensions/agent-browser/lib/results/snapshot-high-value-controls.ts

@@ -17,6 +17,7 @@ const SNAPSHOT_HIGH_VALUE_CONTROL_ROLES = new Set([
 	"button",
 	"checkbox",
 	"combobox",
+	"link",
 	"menuitem",
 	"option",
 	"radio",
@@ -30,11 +31,12 @@ const SNAPSHOT_HIGH_VALUE_CONTROL_ROLE_PRIORITY: Record<string, number> = {
 	textbox: 1,
 	combobox: 2,
 	button: 3,
-	tab: 4,
-	checkbox: 5,
-	radio: 6,
-	option: 7,
-	menuitem: 8,
+	link: 4,
+	tab: 5,
+	checkbox: 6,
+	radio: 7,
+	option: 8,
+	menuitem: 9,
 };
 
 const SNAPSHOT_SURFACE_CONTROL_NAME_PATTERNS = [
@@ -46,6 +48,10 @@ const SNAPSHOT_PRIMARY_ACTION_BUTTON_NAME_PATTERNS = [
 	/^(?:add|apply|ask|confirm|connect|continue|create|launch|new|open|refresh|retry|run|save|search|send|start|submit)\b/i,
 ];
 
+const SNAPSHOT_HIGH_VALUE_LINK_NAME_PATTERNS = [
+	/^[a-z0-9_.-]+\/[a-z0-9_.-]+$/i,
+];
+
 function getHighValueControlRole(entry: SnapshotRefEntry): string {
 	return entry.isEditable === true && (entry.role === "unknown" || entry.role === "generic") ? "textbox" : entry.role;
 }
@@ -129,9 +135,14 @@ const SNAPSHOT_HIGH_VALUE_CONTROL_CATEGORY_RULES: readonly HighValueControlCateg
 	},
 ] as const;
 
+function isHighValueLinkRef(entry: SnapshotRefEntry): boolean {
+	return entry.name.length > 0 && SNAPSHOT_HIGH_VALUE_LINK_NAME_PATTERNS.some((pattern) => pattern.test(entry.name));
+}
+
 export function isHighValueControlEntry(entry: SnapshotRefEntry): boolean {
 	const role = getHighValueControlRole(entry);
 	if (!SNAPSHOT_HIGH_VALUE_CONTROL_ROLES.has(role)) return false;
+	if (role === "link") return isHighValueLinkRef(entry);
 	if (entry.isEditable === false && (role === "searchbox" || role === "textbox" || role === "combobox")) return false;
 	return entry.name.length > 0 || isEditableControlRef(entry);
 }

package/extensions/agent-browser/lib/results/snapshot.ts

@@ -221,6 +221,7 @@ export async function buildSnapshotPresentation(
 		...(roleCountsText ? [`Top roles: ${roleCountsText}`] : []),
 		"",
 		"Compact snapshot view.",
+		"Viewport note: compact snapshots are DOM/signal-prioritized, not guaranteed to start with the currently scrolled viewport; use the full raw snapshot, a screenshot, or listed high-value refs when viewport context matters.",
 	];
 
 	if (fallbackPreview) {
@@ -294,6 +295,7 @@ export async function buildSnapshotPresentation(
 			fullOutputPath,
 			origin,
 			previewMode: fallbackPreview ? "outline" : "structured",
+			viewportOrdering: "dom-signal-prioritized",
 			spillError: spillErrorText,
 			previewRefIds: [...previewRefIds],
 			highValueControlRefIds: visibleHighValueControlEntries.map((entry) => entry.id),

package/extensions/agent-browser/lib/runtime.ts

@@ -619,6 +619,15 @@ export function createFreshSessionName(baseSessionName: string, ephemeralSeed: s
 	return `${baseSessionName}-fresh-${suffix}`;
 }
 
+function getSingleKeyCommandValidationError(args: string[]): string | undefined {
+	const { commandInfo, commandTokens } = parseArgvDescriptor(args);
+	const command = commandInfo.command;
+	if (command !== "press" && command !== "key" && command !== "keydown" && command !== "keyup") return undefined;
+	if (commandTokens.length === 2) return undefined;
+	const label = command === "key" ? "key/press" : command;
+	return `agent-browser ${label} accepts exactly one key argument. Do not pass a selector or ref to ${label}; focus or click the target first, then run ${command} <key> (for example: focus @e1, then press Enter).`;
+}
+
 export function validateToolArgs(args: string[]): string | undefined {
 	if (args.length === 0) {
 		return "`args` must contain at least one agent-browser command token.";
@@ -634,7 +643,7 @@ export function validateToolArgs(args: string[]): string | undefined {
 		return "Do not pass `--session-mode` in args. Use the top-level agent_browser `sessionMode` field instead, for example { args: [\"--profile\", \"Default\", \"open\", \"https://example.com\"], sessionMode: \"fresh\" }.";
 	}
 
-	return undefined;
+	return getSingleKeyCommandValidationError(args);
 }
 
 function getInvalidValueFlagDetails(args: string[]): InvalidValueFlagDetails | undefined {

package/extensions/agent-browser/lib/session-page-state.ts

@@ -8,6 +8,9 @@
 
 import { isCloseCommand, isReadOnlyDiagnosticSessionTargetCommand } from "./command-taxonomy.js";
 import { isRecord } from "./parsing.js";
+import { getEditableRefEvidence } from "./results/editable-ref-evidence.js";
+import { enrichSnapshotRefEntries, getSnapshotRefEntries } from "./results/snapshot-refs.js";
+import { parseSnapshotLines } from "./results/snapshot-segments.js";
 
 export interface SessionTabTarget {
 	title?: string;
@@ -21,7 +24,7 @@ interface OrderedSessionTabTarget {
 
 export interface SessionRefSnapshot {
 	refIds: string[];
-	refs?: Record<string, { name: string; role: string }>;
+	refs?: Record<string, { isContentEditable?: boolean; isEditable?: boolean; name: string; role: string }>;
 	target?: SessionTabTarget;
 }
 
@@ -230,11 +233,15 @@ function getRestoredSessionTabTarget(details: Record<string, unknown>, command:
 	return storedTarget;
 }
 
-function extractRefSnapshotRefs(data: unknown): Record<string, { name: string; role: string }> | undefined {
+function extractRefSnapshotRefs(data: unknown): Record<string, { isContentEditable?: boolean; isEditable?: boolean; name: string; role: string }> | undefined {
 	if (!isRecord(data) || !isRecord(data.refs)) return undefined;
-	const refs = Object.fromEntries(Object.entries(data.refs).flatMap(([refId, entry]) => {
-		if (!/^e\d+$/.test(refId) || !isRecord(entry) || typeof entry.name !== "string" || typeof entry.role !== "string") return [];
-		return [[refId, { name: entry.name, role: entry.role }] as const];
+	const snapshotLines = typeof data.snapshot === "string" ? parseSnapshotLines(data.snapshot) : [];
+	const lineByRef = new Map(snapshotLines.flatMap((line) => line.ref ? [[line.ref, line.raw] as const] : []));
+	const entries = enrichSnapshotRefEntries(getSnapshotRefEntries(data), snapshotLines);
+	const refs = Object.fromEntries(entries.flatMap((entry) => {
+		if (!/^e\d+$/.test(entry.id) || entry.role.length === 0) return [];
+		const isContentEditable = getEditableRefEvidence({ ref: entry.refData, text: lineByRef.get(entry.id) });
+		return [[entry.id, { ...(isContentEditable === true ? { isContentEditable: true } : {}), ...(entry.isEditable !== undefined ? { isEditable: entry.isEditable } : {}), name: entry.name, role: entry.role }] as const];
 	}));
 	return Object.keys(refs).length > 0 ? refs : undefined;
 }
@@ -310,7 +317,9 @@ function getRestoredRefSnapshot(details: Record<string, unknown>): SessionRefSna
 		? Object.fromEntries(refIds.flatMap((refId) => {
 			const entry = refRecord[refId];
 			if (!isRecord(entry) || typeof entry.name !== "string" || typeof entry.role !== "string") return [];
-			return [[refId, { name: entry.name, role: entry.role }] as const];
+			const isContentEditable = typeof entry.isContentEditable === "boolean" ? entry.isContentEditable : undefined;
+			const isEditable = typeof entry.isEditable === "boolean" ? entry.isEditable : undefined;
+			return [[refId, { ...(isContentEditable !== undefined ? { isContentEditable } : {}), ...(isEditable !== undefined ? { isEditable } : {}), name: entry.name, role: entry.role }] as const];
 		}))
 		: undefined;
 	return {

package/extensions/agent-browser/lib/string-enum-schema.ts

@@ -0,0 +1,20 @@
+/**
+ * Purpose: Build compact JSON-schema string enums without importing pi runtime helpers.
+ * Responsibilities: Mirror pi-ai StringEnum's `{ type: "string", enum: [...] }` shape while keeping extension startup imports light.
+ * Scope: Schema construction only.
+ */
+
+import { JsonSchema, type TSchemaOptions, type TUnsafe } from "./json-schema.js";
+
+export type StringEnumBuilder = typeof StringEnum;
+
+export function StringEnum<const Values extends readonly string[]>(
+	values: Values,
+	options?: TSchemaOptions,
+): TUnsafe<Values[number]> {
+	return JsonSchema.Unsafe<Values[number]>({
+		type: "string",
+		enum: [...values],
+		...options,
+	});
+}

package/extensions/agent-browser/lib/web-search.ts

@@ -4,9 +4,8 @@
  * Scope: Live web search only; browser automation remains in the `agent_browser` tool.
  */
 
-import { StringEnum } from "@earendil-works/pi-ai";
-import { defineTool } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
+import { JsonSchema, type JsonSchemaBuilder } from "./json-schema.js";
+import { StringEnum as localStringEnum, type StringEnumBuilder } from "./string-enum-schema.js";
 import {
 	DEFAULT_WEB_SEARCH_PROVIDER,
 	WEB_SEARCH_PROVIDERS,
@@ -119,8 +118,12 @@ export interface WebSearchProviderAdapter<Request = unknown, Response = unknown>
 	provider: WebSearchProvider;
 }
 
-export const AgentBrowserWebSearchParams = Type.Object(
-	{
+export function createAgentBrowserWebSearchParamsSchema(
+	Type: JsonSchemaBuilder = JsonSchema,
+	StringEnum: StringEnumBuilder = localStringEnum,
+) {
+	return Type.Object(
+		{
 		query: Type.String({
 			minLength: 1,
 			description: "Search query to run with the configured Exa or Brave web search provider.",
@@ -172,9 +175,12 @@ export const AgentBrowserWebSearchParams = Type.Object(
 				description: "Optional freshness window: pd=past day, pw=past week, pm=past month, py=past year.",
 			}),
 		),
-	},
-	{ additionalProperties: false },
-);
+		},
+		{ additionalProperties: false },
+	);
+}
+
+export const AgentBrowserWebSearchParams = createAgentBrowserWebSearchParamsSchema();
 
 const HTML_ENTITY_REPLACEMENTS: Readonly<Record<string, string>> = {
 	amp: "&",
@@ -644,22 +650,34 @@ function buildMissingCredentialError(provider: WebSearchProviderParam): string {
 	return "No Exa or Brave web search credential resolved. Configure webSearch.exaApiKey or webSearch.braveApiKey, or load EXA_API_KEY/BRAVE_API_KEY in the runtime environment.";
 }
 
+type AgentBrowserWebSearchParamsInput = {
+	country?: string;
+	count?: number;
+	freshness?: SearchFreshness;
+	offset?: number;
+	provider?: WebSearchProviderParam;
+	query: string;
+	safesearch?: "off" | "moderate" | "strict";
+	searchLang?: string;
+	searchType?: ExaSearchType;
+};
+
 export function createAgentBrowserWebSearchTool(configState: AgentBrowserConfigState) {
 	const requestGate = new WebSearchRequestGate();
-	return defineTool({
+	return {
 		name: AGENT_BROWSER_WEB_SEARCH_TOOL_NAME,
 		label: "Agent Browser Web Search",
 		description: `Search the web with Exa or Brave when configured. Returns up to ${MAX_SEARCH_RESULT_COUNT} concise web results.`,
 		promptSnippet: "Search the live web with Exa or Brave for current or external information.",
 		promptGuidelines: [
 			"Use agent_browser_web_search when live web search would help answer the task, find current external information, or discover candidate URLs for agent_browser.",
-			"The tool chooses Exa or Brave from configured keys; when both are available, Exa is preferred by default unless webSearch.preferredProvider says otherwise. Use provider only when the user/config calls for a specific provider.",
+			"agent_browser_web_search chooses Exa or Brave from configured keys; when both are available, Exa is preferred by default unless webSearch.preferredProvider says otherwise. Use provider only when the user/config calls for a specific provider.",
 			"Prefer agent_browser_web_search over opening a search engine results page with agent_browser when a quick result list is enough; use agent_browser for interaction, DOM, screenshots, or auth.",
 			"Do not issue parallel or repeated agent_browser_web_search calls; use one high-signal query, inspect the results, then only run a focused follow-up if needed. If the provider returns HTTP 429, stop searching and tell the user the API plan/rate limit needs time or a plan change.",
 			"After using agent_browser_web_search, cite result URLs in the final answer when web evidence informed the answer.",
 		],
 		parameters: AgentBrowserWebSearchParams,
-		async execute(_toolCallId, params, signal) {
+		async execute(_toolCallId: string, params: AgentBrowserWebSearchParamsInput, signal?: AbortSignal) {
 			if (!configState.webSearchEnabled) {
 				throw new Error("agent_browser_web_search is disabled by pi-agent-browser-native config.");
 			}
@@ -695,9 +713,9 @@ export function createAgentBrowserWebSearchTool(configState: AgentBrowserConfigS
 				results: normalized.results,
 			};
 			return {
-				content: [{ type: "text", text: formatSearchResults(adapter.provider, normalized.returnedQuery, normalized.results) }],
+				content: [{ type: "text" as const, text: formatSearchResults(adapter.provider, normalized.returnedQuery, normalized.results) }],
 				details,
 			};
 		},
-	});
+	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-agent-browser-native",
-  "version": "0.2.44",
+  "version": "0.2.46",
   "description": "pi extension that exposes agent-browser as a native tool for browser automation",
   "type": "module",
   "author": "Mitch Fultz (https://github.com/fitchmultz)",
@@ -80,7 +80,7 @@
     "check:platform-smoke": "node --check platform-smoke.config.mjs && node --check scripts/platform-smoke.mjs && node --check scripts/platform-smoke/doctor.mjs && node --check scripts/platform-smoke/crabbox-runner.mjs && node --check scripts/platform-smoke/targets.mjs && node --check scripts/platform-smoke/artifacts.mjs && tsx --test test/platform-smoke.test.ts",
     "smoke:platform": "node scripts/platform-smoke.mjs",
     "smoke:platform:doctor": "node scripts/platform-smoke.mjs doctor",
-    "smoke:platform:ubuntu-image": "docker build -t pi-agent-browser-native-platform:node24-agent-browser0.27.1 --build-arg AGENT_BROWSER_VERSION=0.27.1 -f scripts/platform-smoke/linux-image/Dockerfile .",
+    "smoke:platform:ubuntu-image": "node scripts/platform-smoke/build-ubuntu-image.mjs",
     "smoke:platform:macos": "node scripts/platform-smoke.mjs run --target macos",
     "smoke:platform:ubuntu": "node scripts/platform-smoke.mjs run --target ubuntu",
     "smoke:platform:windows-native": "node scripts/platform-smoke.mjs run --target windows-native",

package/platform-smoke.config.mjs

@@ -3,6 +3,9 @@
 
 import { CAPABILITY_BASELINE } from "./scripts/agent-browser-capability-baseline.mjs";
 
+export const PLATFORM_SMOKE_AGENT_BROWSER_VERSION = CAPABILITY_BASELINE.targetVersion;
+export const PLATFORM_SMOKE_UBUNTU_IMAGE = `pi-agent-browser-native-platform:node24-agent-browser${PLATFORM_SMOKE_AGENT_BROWSER_VERSION}`;
+
 export default {
 	packageName: "pi-agent-browser-native",
 	artifactRoot: ".artifacts/platform-smoke",
@@ -17,11 +20,11 @@ export default {
 		host: "localhost",
 		port: 22,
 	},
-	ubuntuContainerImage: "pi-agent-browser-native-platform:node24-agent-browser0.27.1",
+	ubuntuContainerImage: PLATFORM_SMOKE_UBUNTU_IMAGE,
 	windowsParallels: {
 		sourceVm: "pi-extension-windows-template",
 		snapshot: "crabbox-ready",
 	},
 	nodeValidationMajor: 22,
-	agentBrowserVersion: CAPABILITY_BASELINE.targetVersion,
+	agentBrowserVersion: PLATFORM_SMOKE_AGENT_BROWSER_VERSION,
 };

package/scripts/platform-smoke/build-ubuntu-image.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+
+import { CAPABILITY_BASELINE } from "../agent-browser-capability-baseline.mjs";
+
+const version = CAPABILITY_BASELINE.targetVersion;
+const image = `pi-agent-browser-native-platform:node24-agent-browser${version}`;
+const args = [
+	"build",
+	"-t",
+	image,
+	"--build-arg",
+	`AGENT_BROWSER_VERSION=${version}`,
+	"-f",
+	"scripts/platform-smoke/linux-image/Dockerfile",
+	".",
+];
+
+console.log(`Building ${image}`);
+const result = spawnSync("docker", args, { stdio: "inherit" });
+if (result.error) {
+	console.error(result.error.message);
+	process.exit(1);
+}
+process.exit(result.status ?? 1);

package/scripts/platform-smoke/crabbox-runner.mjs

@@ -2,6 +2,10 @@
 
 import { spawn } from "node:child_process";
 
+import { CAPABILITY_BASELINE } from "../agent-browser-capability-baseline.mjs";
+
+const DEFAULT_UBUNTU_IMAGE = `pi-agent-browser-native-platform:node24-agent-browser${CAPABILITY_BASELINE.targetVersion}`;
+
 function env(name) {
 	return process.env[name] ?? "";
 }
@@ -38,7 +42,7 @@ export function describeTarget(targetName, config = {}) {
 			};
 		}
 		case "ubuntu": {
-			const image = env("PLATFORM_SMOKE_UBUNTU_IMAGE") || config.ubuntuContainerImage || "pi-agent-browser-native-platform:node24-agent-browser0.27.1";
+			const image = env("PLATFORM_SMOKE_UBUNTU_IMAGE") || config.ubuntuContainerImage || DEFAULT_UBUNTU_IMAGE;
 			return {
 				provider: "local-container",
 				crabboxTarget: "linux",

package/scripts/platform-smoke/doctor.mjs

@@ -4,6 +4,10 @@ import { execFileSync, execSync } from "node:child_process";
 import { accessSync, constants, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 
+import { CAPABILITY_BASELINE } from "../agent-browser-capability-baseline.mjs";
+
+const DEFAULT_UBUNTU_IMAGE = `pi-agent-browser-native-platform:node24-agent-browser${CAPABILITY_BASELINE.targetVersion}`;
+
 function env(name) {
 	return process.env[name] ?? "";
 }
@@ -220,7 +224,7 @@ export async function runDoctor(config) {
 	console.log("\n── Crabbox providers ──");
 	if (cboxPath) {
 		checkRequiredProviders(cbox, failures);
-		const ubuntuImage = env("PLATFORM_SMOKE_UBUNTU_IMAGE") || config?.ubuntuContainerImage || "pi-agent-browser-native-platform:node24-agent-browser0.27.1";
+		const ubuntuImage = env("PLATFORM_SMOKE_UBUNTU_IMAGE") || config?.ubuntuContainerImage || DEFAULT_UBUNTU_IMAGE;
 		checkCrabboxProvider(cbox, ["--provider", "local-container", "--local-container-image", ubuntuImage], "ubuntu local-container", failures);
 		const macUser = env("PLATFORM_SMOKE_MAC_USER") || env("USER");
 		const macHost = env("PLATFORM_SMOKE_MAC_HOST") || config?.macos?.host || "localhost";
@@ -233,7 +237,7 @@ export async function runDoctor(config) {
 	const dockerVersion = shell("docker info --format '{{.ServerVersion}}'");
 	if (dockerVersion) ok(`Docker ${dockerVersion}`);
 	else fail("Docker is not available or not running", failures);
-	const ubuntuImage = env("PLATFORM_SMOKE_UBUNTU_IMAGE") || config?.ubuntuContainerImage || "pi-agent-browser-native-platform:node24-agent-browser0.27.1";
+	const ubuntuImage = env("PLATFORM_SMOKE_UBUNTU_IMAGE") || config?.ubuntuContainerImage || DEFAULT_UBUNTU_IMAGE;
 	ok(`Ubuntu image: ${ubuntuImage}`);
 
 	console.log("\n── macOS SSH ──");

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

@@ -1,12 +1,10 @@
 # Local Crabbox Ubuntu/Linux target image for pi-agent-browser-native platform smoke.
-# Build with:
-#   docker build -t pi-agent-browser-native-platform:node24-agent-browser0.27.1 \
-#     --build-arg AGENT_BROWSER_VERSION=0.27.1 \
-#     -f scripts/platform-smoke/linux-image/Dockerfile .
+# Build with npm run smoke:platform:ubuntu-image so the agent-browser version
+# comes from scripts/agent-browser-capability-baseline.mjs.
 
 FROM node:24-bookworm
 
-ARG AGENT_BROWSER_VERSION=0.27.1
+ARG AGENT_BROWSER_VERSION
 
 USER root
 RUN apt-get update \

package/scripts/platform-smoke/targets.mjs

@@ -15,6 +15,7 @@ import {
 	writeManifest,
 	writeSummary,
 } from "./artifacts.mjs";
+import { CAPABILITY_BASELINE } from "../agent-browser-capability-baseline.mjs";
 import { cleanupStaleTargetState, crabboxBin, describeTarget, runOnLease, stopLease, warmupLease } from "./crabbox-runner.mjs";
 
 export function platformFor(targetName) {
@@ -300,7 +301,7 @@ export function buildPlatformBuildCommand(targetName, packageName = "pi-agent-br
 	return lines.join("\n");
 }
 
-export function buildBrowserDogfoodCommand(targetName, agentBrowserVersion = "0.27.1") {
+export function buildBrowserDogfoodCommand(targetName, agentBrowserVersion = CAPABILITY_BASELINE.targetVersion) {
 	if (platformFor(targetName) === "powershell") {
 		return `powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\platform-smoke\\browser-dogfood-windows.ps1 -AgentBrowserVersion ${psSingleQuote(agentBrowserVersion)}`;
 	}