pi-agent-browser-native 0.2.42 → 0.2.44

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

@@ -14,6 +14,7 @@ import { detectConfirmationRequired } from "./confirmation.js";
 import type {
 	AgentBrowserEnvelope,
 	AgentBrowserNextAction,
+	NetworkRouteDiagnostic,
 	SessionArtifactManifest,
 	ToolPresentation,
 } from "./contracts.js";
@@ -29,7 +30,9 @@ import {
 	extractImagePath,
 	formatArtifactMetadataLines,
 	formatArtifactSummary,
+	formatMissingArtifactFailureText,
 	getSavedFileDetails,
+	hasMissingFileArtifact,
 	isManifestFileArtifact,
 	type ArtifactRequestContext,
 } from "./presentation/artifacts.js";
@@ -37,7 +40,9 @@ import { buildBatchPresentation, isAgentBrowserBatchResultArray } from "./presen
 import { getPresentationPaths } from "./presentation/content.js";
 import {
 	buildNetworkRequestsNextActions,
+	buildStreamNextActions,
 	enrichStreamStatusData,
+	formatNetworkRouteDiagnosticsText,
 	redactPresentationData,
 } from "./presentation/diagnostics.js";
 import { buildErrorPresentation } from "./presentation/errors.js";
@@ -71,6 +76,8 @@ export async function buildToolPresentation(options: {
 	cwd: string;
 	envelope?: AgentBrowserEnvelope;
 	errorText?: string;
+	networkRouteDiagnostics?: NetworkRouteDiagnostic[];
+	networkRoutes?: import("./contracts.js").NetworkRouteRecord[];
 	persistentArtifactStore?: PersistentSessionArtifactStore;
 	sessionName?: string;
 }): Promise<ToolPresentation> {
@@ -83,6 +90,8 @@ export async function buildToolPresentation(options: {
 		cwd,
 		envelope,
 		errorText,
+		networkRouteDiagnostics,
+		networkRoutes,
 		persistentArtifactStore,
 		sessionName,
 	} = options;
@@ -108,6 +117,7 @@ export async function buildToolPresentation(options: {
 			buildNestedToolPresentation: buildToolPresentation,
 			cwd,
 			data,
+			networkRoutes,
 			persistentArtifactStore,
 			sessionName,
 			summary,
@@ -124,6 +134,11 @@ export async function buildToolPresentation(options: {
 		};
 	}
 
+	if (networkRouteDiagnostics && networkRouteDiagnostics.length > 0 && presentation.content[0]?.type === "text") {
+		const diagnosticText = formatNetworkRouteDiagnosticsText(networkRouteDiagnostics);
+		if (diagnosticText) presentation.content[0] = { ...presentation.content[0], text: `${diagnosticText}\n\n${presentation.content[0].text}` };
+		presentation.networkRouteDiagnostics = networkRouteDiagnostics;
+	}
 	if (artifacts.length > 0 && !presentation.artifacts) {
 		presentation.artifacts = artifacts;
 	}
@@ -161,6 +176,19 @@ export async function buildToolPresentation(options: {
 	) ?? presentationWithManifest.artifactVerification;
 
 	const confirmationRequired = detectConfirmationRequired(data);
+	const missingArtifactFailureText = formatMissingArtifactFailureText(presentationWithManifest.artifacts);
+	if (missingArtifactFailureText && hasMissingFileArtifact(presentationWithManifest.artifacts)) {
+		presentationWithManifest.resultCategory = "failure";
+		presentationWithManifest.failureCategory = "artifact-missing";
+		presentationWithManifest.successCategory = undefined;
+		presentationWithManifest.summary = missingArtifactFailureText;
+		if (presentationWithManifest.content[0]?.type === "text") {
+			presentationWithManifest.content[0] = { ...presentationWithManifest.content[0], text: `${missingArtifactFailureText}\n\n${presentationWithManifest.content[0].text}` };
+		} else {
+			presentationWithManifest.content.unshift({ type: "text", text: missingArtifactFailureText });
+		}
+	}
+
 	if (!presentationWithManifest.resultCategory) {
 		const categoryDetails = buildAgentBrowserResultCategoryDetails({
 			artifacts: presentationWithManifest.artifacts,
@@ -199,12 +227,14 @@ export async function buildToolPresentation(options: {
 		successCategory: presentationWithManifest.successCategory,
 	});
 	const networkNextActions = commandInfo.command === "network" && commandInfo.subcommand === "requests" && presentationWithManifest.resultCategory === "success"
-		? buildNetworkRequestsNextActions(data, sessionName)
+		? buildNetworkRequestsNextActions(data, sessionName, presentationWithManifest.networkRouteDiagnostics)
 		: undefined;
+	const streamNextActions = presentationWithManifest.resultCategory === "success" ? buildStreamNextActions(commandInfo, data, sessionName) : undefined;
 	presentationWithManifest.nextActions = mergeNextActions(
 		presentationWithManifest.nextActions,
 		genericNextActions,
 		networkNextActions,
+		streamNextActions,
 	);
 	presentationWithManifest.pageChangeSummary = presentationWithManifest.pageChangeSummary ?? buildPageChangeSummary({
 		artifacts: presentationWithManifest.artifacts,

package/extensions/agent-browser/lib/results/selector-recovery.ts

@@ -3,7 +3,7 @@
  * Responsibilities: Parse find/semantic action targets, match current snapshot refs, build public diagnostics, text, and safe nextActions.
  * Scope: Selector recovery policy only; subprocess snapshot probing and result orchestration stay in the extension entrypoint.
  * Usage: The extension entrypoint supplies command tokens plus snapshot data after a selector-not-found failure.
- * Invariants/Assumptions: Fill recovery must never echo or auto-submit the user-provided fill text; keyboard insertion remains a separate explicit action.
+ * Invariants/Assumptions: Public fill recovery must never echo or auto-submit the user-provided fill text; guarded semanticAction fill pre-resolution may execute only one exact current editable ref.
  */
 
 import { isRecord } from "../parsing.js";
@@ -199,14 +199,22 @@ export interface VisibleRefActionResolution {
 }
 
 export function resolveVisibleRefActionFromSnapshot(options: {
+	allowFill?: boolean;
 	compiledAction: SelectorRecoveryCompiledAction;
 	snapshotData: unknown;
 }): VisibleRefActionResolution | undefined {
 	const target = getFindVisibleRefFallbackTarget(options.compiledAction.args, { allowLeadingDashFillText: true });
-	if (!target || target.action === "fill" || target.action === "select") return undefined;
+	if (!target || target.action === "select") return undefined;
 	const snapshot = extractRefSnapshotFromData(options.snapshotData);
 	if (!snapshot) return undefined;
-	const candidate = getVisibleRefFallbackCandidates(target, options.snapshotData).find((item) => item.args !== undefined);
+	const candidates = getVisibleRefFallbackCandidates(target, options.snapshotData);
+	if (target.action === "fill") {
+		if (!options.allowFill || candidates.length !== 1 || target.text === undefined) return undefined;
+		const [candidate] = candidates;
+		if (!candidate || candidate.editableEvidence === false || !EDITABLE_CONTROL_ROLES.has(candidate.role.toLowerCase())) return undefined;
+		return { args: ["fill", candidate.ref, target.text], snapshot };
+	}
+	const candidate = candidates.find((item) => item.args !== undefined);
 	if (!candidate?.args) return undefined;
 	return { args: candidate.args, snapshot };
 }

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

@@ -13,6 +13,7 @@ export * from "./artifact-manifest.js";
 export * from "./artifact-state.js";
 export * from "./editable-ref-evidence.js";
 export * from "./network.js";
+export * from "./network-routes.js";
 export * from "./next-actions.js";
 export * from "./recovery-actions.js";
 export * from "./recovery-next-actions.js";

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

@@ -8,6 +8,7 @@
 
 export { getAgentBrowserErrorText, parseAgentBrowserEnvelope } from "./results/envelope.js";
 export { buildToolPresentation } from "./results/presentation.js";
+export { applyNetworkRouteRecords, buildNetworkRouteDiagnostics } from "./results/network-routes.js";
 export {
 	buildAgentBrowserResultCategoryDetails,
 	classifyAgentBrowserFailureCategory,
@@ -30,6 +31,8 @@ export type {
 	AgentBrowserResultCategory,
 	AgentBrowserResultCategoryDetails,
 	AgentBrowserSuccessCategory,
+	NetworkRouteDiagnostic,
+	NetworkRouteRecord,
 	FileArtifactKind,
 	FileArtifactMetadata,
 	ToolPresentation,

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

@@ -355,6 +355,12 @@ export function redactInvocationArgs(args: string[]): string[] {
 		redacted[commandStartIndex + 4] = "[REDACTED]";
 	}
 
+	if (commandStartIndex !== undefined && args[commandStartIndex] === "clipboard" && args[commandStartIndex + 1] === "write") {
+		for (let index = commandStartIndex + 2; index < redacted.length; index += 1) {
+			redacted[index] = "[REDACTED]";
+		}
+	}
+
 	return redacted;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-agent-browser-native",
-  "version": "0.2.42",
+  "version": "0.2.44",
   "description": "pi extension that exposes agent-browser as a native tool for browser automation",
   "type": "module",
   "author": "Mitch Fultz (https://github.com/fitchmultz)",
@@ -62,9 +62,9 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "^0.78.0",
-    "@earendil-works/pi-coding-agent": "^0.78.0",
-    "@earendil-works/pi-tui": "^0.78.0",
+    "@earendil-works/pi-ai": "^0.78.1",
+    "@earendil-works/pi-coding-agent": "^0.78.1",
+    "@earendil-works/pi-tui": "^0.78.1",
     "@types/node": "^25.6.1",
     "tsx": "^4.21.0",
     "typebox": "^1.1.38",

package/platform-smoke.config.mjs

@@ -8,11 +8,20 @@ export default {
 	artifactRoot: ".artifacts/platform-smoke",
 	requiredTargets: ["macos", "ubuntu", "windows-native"],
 	requiredSuites: ["platform-build", "browser-dogfood-smoke"],
+	supportedTargets: ["macos", "ubuntu", "windows-native"],
 	requiredCrabbox: {
 		install: "Homebrew package or PLATFORM_SMOKE_CRABBOX override",
-		minVersion: "0.24.0",
+		minVersion: "0.26.0",
+	},
+	macos: {
+		host: "localhost",
+		port: 22,
 	},
 	ubuntuContainerImage: "pi-agent-browser-native-platform:node24-agent-browser0.27.1",
+	windowsParallels: {
+		sourceVm: "pi-extension-windows-template",
+		snapshot: "crabbox-ready",
+	},
 	nodeValidationMajor: 22,
 	agentBrowserVersion: CAPABILITY_BASELINE.targetVersion,
 };

package/scripts/doctor.mjs

@@ -22,6 +22,7 @@ const PACKAGE_NAME = "pi-agent-browser-native";
 const REPO_URL_FRAGMENT = "github.com/fitchmultz/pi-agent-browser-native";
 const EXTENSION_ENTRYPOINT = "extensions/agent-browser/index.ts";
 const EXPECTED_VERSION = CAPABILITY_BASELINE.targetVersion;
+const RECOMMENDED_PI_VERSION = "0.78.1";
 const DEFAULT_AGENT_DIR = resolve(homedir(), ".pi/agent");
 const THIS_PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 
@@ -29,6 +30,27 @@ export function normalizeAgentBrowserVersion(output) {
 	return String(output ?? "").trim().replace(/^agent-browser\s+/, "");
 }
 
+export function normalizePiVersion(output) {
+	return String(output ?? "").trim().replace(/^pi\s+/, "");
+}
+
+function parseVersionParts(version) {
+	const match = String(version ?? "").match(/^(\d+)\.(\d+)\.(\d+)(?:\b|[-+])/);
+	if (!match) return undefined;
+	return match.slice(1).map((part) => Number.parseInt(part, 10));
+}
+
+function versionAtLeast(actual, minimum) {
+	const actualParts = parseVersionParts(actual);
+	const minimumParts = parseVersionParts(minimum);
+	if (!actualParts || !minimumParts) return undefined;
+	for (let index = 0; index < minimumParts.length; index += 1) {
+		if (actualParts[index] > minimumParts[index]) return true;
+		if (actualParts[index] < minimumParts[index]) return false;
+	}
+	return true;
+}
+
 function printHelp() {
 	console.log(`pi-agent-browser-doctor
 
@@ -45,7 +67,8 @@ Options:
 Checks:
   1. agent-browser is installed on PATH.
   2. agent-browser --version matches the package capability baseline.
-  3. Pi settings and repo-local autoload locations do not point at multiple active pi-agent-browser-native sources.
+  3. pi --version is at least the recommended Pi floor for this release.
+  4. Pi settings and repo-local autoload locations do not point at multiple active pi-agent-browser-native sources.
 
 Examples:
   pi-agent-browser-doctor
@@ -101,6 +124,11 @@ async function defaultRunAgentBrowser(args) {
 	return `${stdout}${stderr}`;
 }
 
+async function defaultRunPi(args) {
+	const { stdout, stderr } = await execFile("pi", args, { maxBuffer: 1024 * 1024 });
+	return `${stdout}${stderr}`;
+}
+
 async function defaultPathExists(path) {
 	try {
 		await access(path);
@@ -270,6 +298,43 @@ async function collectRepoLocalSources({ cwd, pathExists }) {
 	return sources;
 }
 
+async function checkPiVersion({ runPi }) {
+	try {
+		const rawOutput = await runPi(["--version"]);
+		const version = normalizePiVersion(rawOutput);
+		const supported = versionAtLeast(version, RECOMMENDED_PI_VERSION);
+		if (supported === false) {
+			return {
+				status: "warn",
+				title: `Pi ${RECOMMENDED_PI_VERSION} or newer is recommended; found ${version || "<empty>"}.`,
+				lines: [
+					"This package does not hard-pin Pi 0.78.1, but this release was audited against Pi 0.78.1 extension/package behavior.",
+					"Update Pi before release validation or lifecycle debugging if you see tool routing, /reload, exact-session, or package-install differences.",
+				],
+			};
+		}
+		if (supported === undefined) {
+			return {
+				status: "warn",
+				title: `Could not parse pi --version output: ${version || "<empty>"}.`,
+				lines: [`Pi ${RECOMMENDED_PI_VERSION} or newer is recommended for this release's validation baseline.`],
+			};
+		}
+		return { status: "pass", title: `Pi version is within the recommended baseline: ${version}`, lines: [] };
+	} catch (error) {
+		const code = error && typeof error === "object" ? error.code : undefined;
+		return {
+			status: "warn",
+			title: "Could not inspect pi --version.",
+			lines: [
+				`Pi ${RECOMMENDED_PI_VERSION} or newer is recommended for this release's validation baseline, but it is not hard-pinned as a runtime requirement.`,
+				"Make sure the same shell that launches pi can run `pi --version` when debugging lifecycle or package-install behavior.",
+				code && code !== "ENOENT" ? `Spawn error: ${String(code)}` : undefined,
+			].filter(Boolean),
+		};
+	}
+}
+
 async function checkAgentBrowserVersion({ runAgentBrowser }) {
 	try {
 		const rawOutput = await runAgentBrowser(["--version"]);
@@ -358,6 +423,7 @@ export async function evaluateDoctor(options = {}) {
 	const readText = options.readText ?? ((path) => readFile(path, "utf8"));
 	const pathExists = options.pathExists ?? defaultPathExists;
 	const runAgentBrowser = options.runAgentBrowser ?? defaultRunAgentBrowser;
+	const runPi = options.runPi ?? defaultRunPi;
 	const checks = [];
 	const failures = [];
 	const warnings = [];
@@ -366,6 +432,9 @@ export async function evaluateDoctor(options = {}) {
 	checks.push(versionCheck);
 	if (versionCheck.status === "fail") failures.push(versionCheck);
 
+	const piVersionCheck = await checkPiVersion({ runPi });
+	checks.push(piVersionCheck);
+
 	if (!options.skipSourceCheck) {
 		const sourceCheck = await checkPiSources({ cwd, agentDir, settingsPaths, readText, pathExists });
 		checks.push(sourceCheck);

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

@@ -14,49 +14,77 @@ function packageSlug(config = {}) {
 	return process.env.PLATFORM_SMOKE_PACKAGE_SLUG || config.packageName || "pi-agent-browser-native";
 }
 
-export function buildTargetBaseArgs(targetName, config = {}) {
+export function describeTarget(targetName, config = {}) {
+	const slug = packageSlug(config);
 	switch (targetName) {
 		case "macos": {
 			const user = env("PLATFORM_SMOKE_MAC_USER") || env("USER");
-			const host = env("PLATFORM_SMOKE_MAC_HOST") || "localhost";
-			const workRoot = env("PLATFORM_SMOKE_MAC_WORK_ROOT") || `/Users/${user}/crabbox/${packageSlug(config)}`;
-			return [
-				"--provider", "ssh",
-				"--target", "macos",
-				"--static-host", host,
-				"--static-user", user,
-				"--static-port", "22",
-				"--static-work-root", workRoot,
-			];
+			const host = env("PLATFORM_SMOKE_MAC_HOST") || config.macos?.host || "localhost";
+			const port = String(env("PLATFORM_SMOKE_MAC_PORT") || config.macos?.port || 22);
+			const workRoot = env("PLATFORM_SMOKE_MAC_WORK_ROOT") || config.macos?.workRoot || `/Users/${user}/crabbox/${slug}`;
+			return {
+				provider: "ssh",
+				crabboxTarget: "macos",
+				shell: "posix",
+				workRoot,
+				args: [
+					"--provider", "ssh",
+					"--target", "macos",
+					"--static-host", host,
+					"--static-user", user,
+					"--static-port", port,
+					"--static-work-root", workRoot,
+				],
+			};
 		}
 		case "ubuntu": {
 			const image = env("PLATFORM_SMOKE_UBUNTU_IMAGE") || config.ubuntuContainerImage || "pi-agent-browser-native-platform:node24-agent-browser0.27.1";
-			return [
-				"--provider", "local-container",
-				"--target", "linux",
-				"--local-container-image", image,
-			];
+			return {
+				provider: "local-container",
+				crabboxTarget: "linux",
+				shell: "posix",
+				image,
+				workRoot: config.localContainer?.workRoot || "/work/crabbox",
+				args: [
+					"--provider", "local-container",
+					"--target", "linux",
+					"--local-container-image", image,
+				],
+			};
 		}
 		case "windows-native": {
-			const vm = env("PLATFORM_SMOKE_WINDOWS_VM") || "pi-extension-windows-template";
-			const snapshot = env("PLATFORM_SMOKE_WINDOWS_SNAPSHOT") || "crabbox-ready";
-			const user = env("PLATFORM_SMOKE_WINDOWS_USER") || env("USER");
-			const workRoot = env("PLATFORM_SMOKE_WINDOWS_WORK_ROOT") || `C:\\crabbox\\${packageSlug(config)}`;
-			return [
-				"--provider", "parallels",
-				"--target", "windows",
-				"--windows-mode", "normal",
-				"--parallels-source", vm,
-				"--parallels-source-snapshot", snapshot,
-				"--parallels-user", user,
-				"--parallels-work-root", workRoot,
-			];
+			const vm = env("PLATFORM_SMOKE_WINDOWS_VM") || config.windowsParallels?.sourceVm || "pi-extension-windows-template";
+			const snapshot = env("PLATFORM_SMOKE_WINDOWS_SNAPSHOT") || config.windowsParallels?.snapshot || "crabbox-ready";
+			const user = env("PLATFORM_SMOKE_WINDOWS_USER") || config.windowsParallels?.user || env("USER");
+			const workRoot = env("PLATFORM_SMOKE_WINDOWS_WORK_ROOT") || config.windowsParallels?.workRoot || `C:\\crabbox\\${slug}`;
+			return {
+				provider: "parallels",
+				crabboxTarget: "windows",
+				shell: "powershell",
+				workRoot,
+				windowsMode: "normal",
+				sourceVm: vm,
+				snapshot,
+				args: [
+					"--provider", "parallels",
+					"--target", "windows",
+					"--windows-mode", "normal",
+					"--parallels-source", vm,
+					"--parallels-source-snapshot", snapshot,
+					"--parallels-user", user,
+					"--parallels-work-root", workRoot,
+				],
+			};
 		}
 		default:
 			throw new Error(`unknown platform smoke target: ${targetName}`);
 	}
 }
 
+export function buildTargetBaseArgs(targetName, config = {}) {
+	return describeTarget(targetName, config).args;
+}
+
 export function leaseIdFor(targetName, slug) {
 	if (targetName === "macos") return "static_localhost";
 	return slug;

package/scripts/platform-smoke/doctor.mjs

@@ -105,6 +105,17 @@ function checkForbiddenProjectFiles(failures) {
 }
 
 function crabboxProviders(cbox) {
+	const jsonOutput = silent(cbox, ["providers", "--json"]);
+	if (jsonOutput) {
+		try {
+			const parsed = JSON.parse(jsonOutput);
+			if (Array.isArray(parsed)) return parsed.map((provider) => provider.name ?? provider.id ?? provider.provider).filter(Boolean);
+			if (Array.isArray(parsed.providers)) return parsed.providers.map((provider) => provider.name ?? provider.id ?? provider.provider).filter(Boolean);
+			if (typeof parsed === "object" && parsed) return Object.keys(parsed.providers ?? parsed);
+		} catch {
+			// Fall through to text parsing for older or non-JSON provider output.
+		}
+	}
 	const output = silent(cbox, ["providers"]);
 	if (!output) return [];
 	return output.split(/\r?\n/)
@@ -212,9 +223,10 @@ export async function runDoctor(config) {
 		const ubuntuImage = env("PLATFORM_SMOKE_UBUNTU_IMAGE") || config?.ubuntuContainerImage || "pi-agent-browser-native-platform:node24-agent-browser0.27.1";
 		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") || "localhost";
-		const macRoot = env("PLATFORM_SMOKE_MAC_WORK_ROOT") || `/Users/${macUser}/crabbox/${packageName}`;
-		checkCrabboxProvider(cbox, ["--provider", "ssh", "--target", "macos", "--static-host", macHost, "--static-user", macUser, "--static-port", "22", "--static-work-root", macRoot], "macOS ssh", failures);
+		const macHost = env("PLATFORM_SMOKE_MAC_HOST") || config?.macos?.host || "localhost";
+		const macPort = String(env("PLATFORM_SMOKE_MAC_PORT") || config?.macos?.port || 22);
+		const macRoot = env("PLATFORM_SMOKE_MAC_WORK_ROOT") || config?.macos?.workRoot || `/Users/${macUser}/crabbox/${packageName}`;
+		checkCrabboxProvider(cbox, ["--provider", "ssh", "--target", "macos", "--static-host", macHost, "--static-user", macUser, "--static-port", macPort, "--static-work-root", macRoot], "macOS ssh", failures);
 	}
 
 	console.log("\n── Docker / Ubuntu ──");
@@ -226,8 +238,9 @@ export async function runDoctor(config) {
 
 	console.log("\n── macOS SSH ──");
 	const sshUser = env("PLATFORM_SMOKE_MAC_USER") || env("USER");
-	const sshHost = env("PLATFORM_SMOKE_MAC_HOST") || "localhost";
-	const sshProbe = shell(`ssh -o BatchMode=yes -o ConnectTimeout=5 -o StrictHostKeyChecking=no ${sshUser}@${sshHost} 'node --version && npm --version && git --version && agent-browser --version'`);
+	const sshHost = env("PLATFORM_SMOKE_MAC_HOST") || config?.macos?.host || "localhost";
+	const sshPort = String(env("PLATFORM_SMOKE_MAC_PORT") || config?.macos?.port || 22);
+	const sshProbe = shell(`ssh -o BatchMode=yes -o ConnectTimeout=5 -o StrictHostKeyChecking=no -p ${sshPort} ${sshUser}@${sshHost} 'node --version && npm --version && git --version && agent-browser --version'`);
 	if (sshProbe) {
 		ok(`SSH ${sshUser}@${sshHost}: ${sshProbe.split(/\r?\n/).join(" | ")}`);
 		if (agentBrowserVersion && !sshProbe.includes(agentBrowserVersion)) fail(`macOS SSH agent-browser does not match expected ${agentBrowserVersion}`, failures);
@@ -241,10 +254,10 @@ export async function runDoctor(config) {
 			fail("prlctl not found", failures);
 		} else {
 			ok("prlctl found");
-			const vmName = env("PLATFORM_SMOKE_WINDOWS_VM") || "pi-extension-windows-template";
-			const snapshot = env("PLATFORM_SMOKE_WINDOWS_SNAPSHOT") || "crabbox-ready";
-			const user = env("PLATFORM_SMOKE_WINDOWS_USER") || env("USER");
-			const workRoot = env("PLATFORM_SMOKE_WINDOWS_WORK_ROOT") || `C:\\crabbox\\${packageName}`;
+			const vmName = env("PLATFORM_SMOKE_WINDOWS_VM") || config?.windowsParallels?.sourceVm || "pi-extension-windows-template";
+			const snapshot = env("PLATFORM_SMOKE_WINDOWS_SNAPSHOT") || config?.windowsParallels?.snapshot || "crabbox-ready";
+			const user = env("PLATFORM_SMOKE_WINDOWS_USER") || config?.windowsParallels?.user || env("USER");
+			const workRoot = env("PLATFORM_SMOKE_WINDOWS_WORK_ROOT") || config?.windowsParallels?.workRoot || `C:\\crabbox\\${packageName}`;
 			const list = shell("prlctl list -a --no-header 2>/dev/null");
 			if (!list) {
 				fail("prlctl list returned no VMs", failures);