@narumitw/pi-chrome-devtools 0.50.1 → 0.52.0

package/src/chrome-devtools.ts

@@ -1,10 +1,15 @@
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import { shutdownManagedBrowser } from "./browser-manager.js";
+import {
+	availableChromeDevtoolsTools,
+	configureLazyChromeDevtoolsTools,
+	createChromeDevtoolsLoadTool,
+	initializeAvailableChromeDevtoolsTools,
+} from "./lazy-tools.js";
 import { applyRuntimeBrowserSettings, state } from "./runtime.js";
-import { loadSettings } from "./settings.js";
+import { loadSettings, waitForSettingsWrites } from "./settings.js";
 import {
 	allChromeDevtoolsTools,
-	applyChromeDevtoolsTools,
 	buildCommandGuide,
 	buildQuickstartMessage,
 	buildToolStatusMessage,
@@ -20,19 +25,28 @@ import {
 	selectPageTool,
 } from "./tools.js";
 
-type CommandAction = "menu" | "help" | "quickstart" | "status" | "tools" | "enable" | "disable";
+type CommandAction =
+	| "menu"
+	| "help"
+	| "quickstart"
+	| "status"
+	| "settings"
+	| "tools"
+	| "enable"
+	| "disable";
 type CommandContext = ExtensionCommandContext;
 const STATUS_KEY = "chrome-devtools";
 const COMMAND_COMPLETIONS = [
 	{ value: "help", label: "help", description: "Show command usage" },
 	{ value: "quickstart", label: "quickstart", description: "Show endpoint and launch help" },
 	{ value: "status", label: "status", description: "Show tool and settings status" },
-	{ value: "tools", label: "tools", description: "Select Chrome DevTools tools" },
+	{ value: "settings", label: "settings", description: "Edit browser connection settings" },
+	{ value: "tools", label: "tools", description: "Choose lazy-loadable Chrome DevTools tools" },
 	{ value: "toggle", label: "toggle", description: "Alias for tools" },
 	{ value: "select", label: "select", description: "Compatibility alias for tools" },
-	{ value: "enable", label: "enable", description: "Enable all Chrome DevTools tools" },
+	{ value: "enable", label: "enable", description: "Make all Chrome DevTools tools available" },
 	{ value: "on", label: "on", description: "Compatibility alias for enable" },
-	{ value: "disable", label: "disable", description: "Disable all Chrome DevTools tools" },
+	{ value: "disable", label: "disable", description: "Make all Chrome DevTools tools unavailable" },
 	{ value: "off", label: "off", description: "Compatibility alias for disable" },
 ];
 export default function chromeDevtools(pi: ExtensionAPI) {
@@ -41,11 +55,13 @@ export default function chromeDevtools(pi: ExtensionAPI) {
 	pi.registerTool(navigateTool);
 	pi.registerTool(evaluateTool);
 	pi.registerTool(screenshotTool);
+	pi.registerTool(createChromeDevtoolsLoadTool(pi));
 
 	pi.registerCommand("chrome-devtools", {
 		description: "Open Chrome DevTools help and tool controls",
 		getArgumentCompletions: (prefix) => commandCompletions(prefix),
 		handler: async (args, ctx) => {
+			initializeAvailableChromeDevtoolsTools(pi);
 			const generation = state.sessionGeneration;
 			await handleChromeDevtoolsCommand(pi, args, ctx, generation);
 		},
@@ -53,6 +69,7 @@ export default function chromeDevtools(pi: ExtensionAPI) {
 
 	pi.on("session_start", async (_event, ctx) => {
 		const generation = ++state.sessionGeneration;
+		initializeAvailableChromeDevtoolsTools(pi);
 		replaceSessionController("Chrome DevTools session replaced");
 		state.shuttingDown = false;
 		state.settingsNotice = undefined;
@@ -69,9 +86,11 @@ export default function chromeDevtools(pi: ExtensionAPI) {
 		for (const warning of settings.warnings) {
 			ctx.ui.notify(sanitizeChromeDevtoolsDisplay(warning), "warning");
 		}
-		if (settings.kind === "loaded" && settings.settings.tools) {
-			applyChromeDevtoolsTools(pi, settings.settings.tools);
-		}
+		const availableTools =
+			settings.kind === "loaded" && settings.settings.tools
+				? settings.settings.tools
+				: availableChromeDevtoolsTools(pi);
+		configureLazyChromeDevtoolsTools(pi, availableTools);
 	});
 
 	pi.on("session_shutdown", async (_event, ctx) => {
@@ -80,6 +99,7 @@ export default function chromeDevtools(pi: ExtensionAPI) {
 		ctx.ui.setStatus(STATUS_KEY, undefined);
 		const browserShutdown = shutdownManagedBrowser(undefined, { cancelLaunch: true });
 		await waitForChromeDevtoolsSettings();
+		await waitForSettingsWrites();
 		await browserShutdown;
 	});
 }
@@ -110,6 +130,15 @@ async function handleChromeDevtoolsCommand(
 			ctx.ui.notify(status, "info");
 			return;
 		}
+		case "settings": {
+			if (!ctx.hasUI || (ctx.mode !== "tui" && ctx.mode !== "rpc")) {
+				throw new Error("/chrome-devtools settings requires TUI or RPC mode");
+			}
+			const { showChromeDevtoolsBrowserSettings } = await import("./browser-settings-menu.js");
+			if (generation !== state.sessionGeneration) return;
+			await showChromeDevtoolsBrowserSettings(ctx, generation);
+			return;
+		}
 		case "tools": {
 			if (!ctx.hasUI || (ctx.mode !== "tui" && ctx.mode !== "rpc")) {
 				throw new Error("/chrome-devtools tools requires TUI or RPC mode");
@@ -120,10 +149,10 @@ async function handleChromeDevtoolsCommand(
 			return;
 		}
 		case "enable":
-			await updateChromeDevtoolsTools(pi, ctx, allChromeDevtoolsTools(), "enabled all");
+			await updateChromeDevtoolsTools(pi, ctx, allChromeDevtoolsTools(), "made all available");
 			return;
 		case "disable":
-			await updateChromeDevtoolsTools(pi, ctx, [], "disabled all");
+			await updateChromeDevtoolsTools(pi, ctx, [], "made all unavailable");
 			return;
 	}
 
@@ -164,6 +193,7 @@ export function parseCommand(args: string): CommandAction | "unknown" {
 	if (command === "help") return "help";
 	if (command === "quickstart") return "quickstart";
 	if (command === "status") return "status";
+	if (command === "settings") return "settings";
 	if (command === "tools" || command === "select" || command === "toggle") return "tools";
 	if (command === "enable" || command === "on") return "enable";
 	if (command === "disable" || command === "off") return "disable";
@@ -185,6 +215,7 @@ export {
 	isLocalDevToolsHost,
 	quoteCommandPart,
 } from "./browser-manager.js";
+export { CHROME_DEVTOOLS_LOAD_TOOL_NAME } from "./lazy-tools.js";
 export { parseConfiguredPort } from "./runtime.js";
 export {
 	hasParentPathSegment,

package/src/lazy-tools.ts

@@ -0,0 +1,143 @@
+import { defineTool, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { CHROME_DEVTOOLS_TOOL_NAMES, type ChromeDevToolsToolName } from "./tool-names.js";
+
+export const CHROME_DEVTOOLS_LOAD_TOOL_NAME = "chrome_devtools_load";
+
+const AVAILABLE_TOOLS_STORE = Symbol.for("@narumitw/pi-chrome-devtools.available-tools-store");
+type ChromeDevtoolsGlobal = typeof globalThis & {
+	[AVAILABLE_TOOLS_STORE]?: WeakMap<ExtensionAPI, Set<ChromeDevToolsToolName>>;
+};
+const sharedGlobal = globalThis as ChromeDevtoolsGlobal;
+const existingAvailableToolsStore = sharedGlobal[AVAILABLE_TOOLS_STORE];
+const availableToolsByApi =
+	existingAvailableToolsStore ?? new WeakMap<ExtensionAPI, Set<ChromeDevToolsToolName>>();
+if (!existingAvailableToolsStore) sharedGlobal[AVAILABLE_TOOLS_STORE] = availableToolsByApi;
+
+const SEARCH_TEXT: Record<ChromeDevToolsToolName, string> = {
+	chrome_devtools_list_pages: "list open inspectable chrome browser pages tabs targets",
+	chrome_devtools_select_page: "select choose active chrome browser page tab target",
+	chrome_devtools_navigate: "navigate open create chrome browser page url website",
+	chrome_devtools_evaluate: "evaluate run javascript expression dom inspect chrome browser page",
+	chrome_devtools_screenshot: "capture screenshot png image visual chrome browser page",
+};
+
+export function initializeAvailableChromeDevtoolsTools(pi: ExtensionAPI) {
+	if (availableToolsByApi.has(pi)) return;
+	const activeTools = new Set(pi.getActiveTools());
+	setAvailableTools(
+		pi,
+		CHROME_DEVTOOLS_TOOL_NAMES.filter((name) => activeTools.has(name)),
+	);
+}
+
+export function configureLazyChromeDevtoolsTools(
+	pi: ExtensionAPI,
+	availableTools: readonly ChromeDevToolsToolName[],
+) {
+	setAvailableTools(pi, availableTools);
+	const nonCapabilityTools = pi
+		.getActiveTools()
+		.filter((name) => !CHROME_DEVTOOLS_TOOL_NAMES.includes(name as ChromeDevToolsToolName));
+	pi.setActiveTools(unique([...nonCapabilityTools, CHROME_DEVTOOLS_LOAD_TOOL_NAME]));
+}
+
+export function applyAvailableChromeDevtoolsTools(
+	pi: ExtensionAPI,
+	availableTools: readonly ChromeDevToolsToolName[],
+) {
+	const available = setAvailableTools(pi, availableTools);
+	const active = pi
+		.getActiveTools()
+		.filter(
+			(name) =>
+				!CHROME_DEVTOOLS_TOOL_NAMES.includes(name as ChromeDevToolsToolName) ||
+				available.has(name as ChromeDevToolsToolName),
+		);
+	pi.setActiveTools(unique([...active, CHROME_DEVTOOLS_LOAD_TOOL_NAME]));
+}
+
+export function availableChromeDevtoolsTools(pi: ExtensionAPI) {
+	const available = availableToolsByApi.get(pi) ?? new Set();
+	return CHROME_DEVTOOLS_TOOL_NAMES.filter((name) => available.has(name));
+}
+
+export function createChromeDevtoolsLoadTool(pi: ExtensionAPI) {
+	return defineTool({
+		name: CHROME_DEVTOOLS_LOAD_TOOL_NAME,
+		label: "Chrome DevTools: Load Tools",
+		description:
+			"Find and enable Chrome DevTools browser tools relevant to a task. Loaded tools remain available for the session.",
+		promptSnippet: "Load Chrome DevTools browser capabilities on demand",
+		promptGuidelines: [
+			"Use chrome_devtools_load when a task requires inspecting or controlling a Chrome browser and the needed chrome_devtools_* capability is not active.",
+		],
+		parameters: Type.Object({
+			query: Type.String({
+				description: "Browser capability or task to find tools for.",
+				maxLength: 500,
+			}),
+			limit: Type.Optional(
+				Type.Integer({
+					description: "Maximum tools to load. Defaults to 3.",
+					minimum: 1,
+					maximum: 5,
+				}),
+			),
+		}),
+		async execute(_toolCallId, params, signal) {
+			signal?.throwIfAborted();
+			const available = new Set(availableChromeDevtoolsTools(pi));
+			const matches = matchChromeDevtoolsTools(params.query, params.limit ?? 3, available);
+			const active = pi.getActiveTools();
+			const activeSet = new Set(active);
+			const added = matches.filter((name) => !activeSet.has(name));
+			if (added.length > 0) {
+				pi.setActiveTools(unique([...active, ...added]));
+			}
+
+			const text =
+				matches.length === 0
+					? "No available Chrome DevTools tools matched the query."
+					: added.length > 0
+						? `Loaded Chrome DevTools tools: ${added.join(", ")}`
+						: `Matching Chrome DevTools tools are already loaded: ${matches.join(", ")}`;
+			return {
+				content: [{ type: "text" as const, text }],
+				details: { matches, added },
+			};
+		},
+	});
+}
+
+function matchChromeDevtoolsTools(
+	query: string,
+	limit: number,
+	available: ReadonlySet<ChromeDevToolsToolName>,
+) {
+	const terms = query
+		.toLowerCase()
+		.split(/[^a-z0-9]+/)
+		.filter((term) => term.length >= 2);
+	if (terms.length === 0) return [];
+	return CHROME_DEVTOOLS_TOOL_NAMES.filter((name) => available.has(name))
+		.map((name, index) => ({
+			name,
+			index,
+			score: terms.reduce((score, term) => score + (SEARCH_TEXT[name].includes(term) ? 1 : 0), 0),
+		}))
+		.filter((match) => match.score > 0)
+		.sort((left, right) => right.score - left.score || left.index - right.index)
+		.slice(0, limit)
+		.map((match) => match.name);
+}
+
+function setAvailableTools(pi: ExtensionAPI, availableTools: readonly ChromeDevToolsToolName[]) {
+	const available = new Set(availableTools);
+	availableToolsByApi.set(pi, available);
+	return available;
+}
+
+function unique(values: readonly string[]) {
+	return [...new Set(values)];
+}

package/src/menu.ts

@@ -1,20 +1,20 @@
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import { defineMenu, runMenu, runTask } from "@narumitw/pi-tui-kit";
 import { browserLifecycleState, devToolsEndpoint, launchModeLabel } from "./browser-manager.js";
+import { availableChromeDevtoolsTools } from "./lazy-tools.js";
 import { state } from "./runtime.js";
 import { loadSettings, type SettingsLoadResult } from "./settings.js";
 import { CHROME_DEVTOOLS_TOOL_NAMES, type ChromeDevToolsToolName } from "./tool-names.js";
 import {
 	buildBrowserStatusMessage,
 	buildCommandGuide,
-	buildSettingsSetupMessage,
 	sanitizeChromeDevtoolsDisplay,
 	setSelectedChromeDevtoolsTools,
 } from "./tool-selector.js";
 
 type CommandContext = ExtensionCommandContext;
-type MainScreen = "main" | "browserStatus" | "settings" | "help";
-type MainAction = "tools" | "bulk";
+type MainScreen = "main" | "browserStatus" | "help";
+type MainAction = "tools" | "bulk" | "settings";
 type ToolScreen = "tools" | "review";
 type ToolAction = "toggle" | "selectAll" | "selectNone" | "review" | "apply" | "cancel";
 
@@ -75,8 +75,8 @@ export async function showChromeDevtoolsMenu(
 				items: [
 					{
 						id: "tools",
-						label: "Choose browser tools…",
-						description: "Select what Pi may do in Chrome.",
+						label: "Choose available browser tools…",
+						description: "Choose which capabilities the loader may expose.",
 						disabled: Boolean(current.mutationBlockedReason),
 						disabledReason: current.mutationBlockedReason,
 						action: "tools",
@@ -85,8 +85,8 @@ export async function showChromeDevtoolsMenu(
 						id: "bulk",
 						label:
 							current.activeTools.length === CHROME_DEVTOOLS_TOOL_NAMES.length
-								? "Disable all browser tools…"
-								: "Enable all browser tools…",
+								? "Make all browser tools unavailable…"
+								: "Make all browser tools available…",
 						description:
 							current.activeTools.length === CHROME_DEVTOOLS_TOOL_NAMES.length
 								? "Preview 0 of 5; other active tools stay enabled."
@@ -103,9 +103,9 @@ export async function showChromeDevtoolsMenu(
 					},
 					{
 						id: "settings",
-						label: "Settings & setup",
-						description: "Files, sources, trust, and reload steps.",
-						to: "settings",
+						label: "Browser settings",
+						description: "Edit endpoint, auto-launch, and browser executable settings.",
+						action: "settings",
 					},
 					{
 						id: "help",
@@ -124,14 +124,6 @@ export async function showChromeDevtoolsMenu(
 				viewportSize: "adaptive",
 				hint: "back",
 			}),
-			settings: () => ({
-				kind: "review",
-				title: "Settings & setup",
-				content: buildSettingsSetupMessage(),
-				format: { kind: "text" },
-				viewportSize: "adaptive",
-				hint: "back",
-			}),
 			help: () => ({
 				kind: "review",
 				title: "Chrome DevTools help",
@@ -162,6 +154,13 @@ export async function showChromeDevtoolsMenu(
 				if (result?.applied && isCurrent()) updateSnapshotAfterApply(current, result.selectedTools);
 				return result?.closeParent ? { kind: "close" } : { kind: "stay" };
 			},
+			settings: async () => {
+				const { showChromeDevtoolsBrowserSettings } = await import("./browser-settings-menu.js");
+				if (!isCurrent()) return { kind: "stay" };
+				const result = await showChromeDevtoolsBrowserSettings(ctx, generation);
+				if (!isCurrent()) return { kind: "stay" };
+				return result.closeParent ? { kind: "close" } : { kind: "stay" };
+			},
 		},
 	});
 	await runMenu(ctx, menu, {
@@ -250,8 +249,8 @@ export async function showChromeDevtoolsToolWorkflow(
 				kind: "review",
 				title: "Review tool changes",
 				lines: [
-					`Current: ${current.accepted.size}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
-					`Proposed: ${current.draft.size}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
+					`Currently available: ${current.accepted.size}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
+					`Proposed availability: ${current.draft.size}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
 				],
 				content: buildToolReview(current),
 				format: { kind: "text" },
@@ -307,7 +306,7 @@ export async function showChromeDevtoolsToolWorkflow(
 				current.draft = new Set(selectedTools);
 				current.applied = true;
 				ctx.ui.notify(
-					`Saved: ${selectedTools.length} of ${CHROME_DEVTOOLS_TOOL_NAMES.length} browser tools enabled.`,
+					`Saved: ${selectedTools.length} of ${CHROME_DEVTOOLS_TOOL_NAMES.length} browser tools available to lazy-load.`,
 					"info",
 				);
 				return { kind: "close" };
@@ -363,7 +362,7 @@ function buildMenuSnapshot(pi: ExtensionAPI, settings: SettingsLoadResult): Menu
 				? "not saved"
 				: arraysEqual(activeTools, persistedTools)
 					? "saved"
-					: "runtime differs from saved selection";
+					: "runtime catalog differs from saved catalog";
 	const settingsWarning = [
 		...new Set([settings.notice, state.settingsNotice].filter(Boolean)),
 	].join("\n");
@@ -379,7 +378,7 @@ function buildMenuSnapshot(pi: ExtensionAPI, settings: SettingsLoadResult): Menu
 
 function mainStateLines(snapshot: MenuSnapshot) {
 	return sanitizeLines([
-		`Tools: ${snapshot.activeTools.length} of ${CHROME_DEVTOOLS_TOOL_NAMES.length} enabled · ${snapshot.persistenceLabel}`,
+		`Lazy catalog: ${snapshot.activeTools.length} of ${CHROME_DEVTOOLS_TOOL_NAMES.length} available · ${snapshot.persistenceLabel}`,
 		`Browser: ${browserLifecycleSummary()}`,
 		`Endpoint: ${devToolsEndpoint()}`,
 		...(snapshot.settingsWarning ? [`Settings warning: ${snapshot.settingsWarning}`] : []),
@@ -406,7 +405,7 @@ function toolDraftLines(current: ToolWorkflowState) {
 		return sanitizeLines([`Unavailable: ${current.mutationBlockedReason}`]);
 	const changes = symmetricDifferenceSize(current.accepted, current.draft);
 	return [
-		`Current accepted: ${current.accepted.size}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
+		`Currently available: ${current.accepted.size}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
 		changes === 0
 			? "No unapplied changes · Escape cancels"
 			: `${changes} unapplied ${changes === 1 ? "change" : "changes"} · Escape cancels`,
@@ -415,25 +414,26 @@ function toolDraftLines(current: ToolWorkflowState) {
 }
 
 function buildToolReview(current: ToolWorkflowState) {
-	const enabled = CHROME_DEVTOOLS_TOOL_NAMES.filter((name) => current.draft.has(name));
-	const disabled = CHROME_DEVTOOLS_TOOL_NAMES.filter((name) => !current.draft.has(name));
+	const available = CHROME_DEVTOOLS_TOOL_NAMES.filter((name) => current.draft.has(name));
+	const unavailable = CHROME_DEVTOOLS_TOOL_NAMES.filter((name) => !current.draft.has(name));
 	return sanitizeChromeDevtoolsDisplay(
 		[
-			`Current browser tools: ${current.accepted.size}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
-			`Proposed browser tools: ${current.draft.size}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
+			`Current available browser tools: ${current.accepted.size}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
+			`Proposed available browser tools: ${current.draft.size}/${CHROME_DEVTOOLS_TOOL_NAMES.length}`,
 			"",
-			"Enabled after apply:",
-			...(enabled.length > 0
-				? enabled.map((name) => `  - ${TOOL_PRESENTATION[name].label} (${name})`)
+			"Available to lazy-load after apply:",
+			...(available.length > 0
+				? available.map((name) => `  - ${TOOL_PRESENTATION[name].label} (${name})`)
 				: ["  - none"]),
 			"",
-			"Disabled after apply:",
-			...(disabled.length > 0
-				? disabled.map((name) => `  - ${TOOL_PRESENTATION[name].label} (${name})`)
+			"Unavailable after apply:",
+			...(unavailable.length > 0
+				? unavailable.map((name) => `  - ${TOOL_PRESENTATION[name].label} (${name})`)
 				: ["  - none"]),
 			"",
 			"Other active Pi tools remain unchanged.",
-			"The accepted selection is saved for future sessions.",
+			"Newly available tools remain deferred until chrome_devtools_load selects them.",
+			"The accepted availability policy is saved for future sessions.",
 		].join("\n"),
 	);
 }
@@ -447,8 +447,7 @@ function updateSnapshotAfterApply(
 }
 
 function activeChromeTools(pi: ExtensionAPI) {
-	const active = new Set(pi.getActiveTools());
-	return CHROME_DEVTOOLS_TOOL_NAMES.filter((toolName) => active.has(toolName));
+	return availableChromeDevtoolsTools(pi);
 }
 
 function orderedTools(tools: ReadonlySet<ChromeDevToolsToolName>) {

package/src/runtime.ts

@@ -1,8 +1,13 @@
 import type { ChildProcess } from "node:child_process";
-import type { EffectiveBrowserSettings } from "./settings.js";
+import {
+	DEFAULT_BROWSER_HOST,
+	DEFAULT_BROWSER_PORT,
+	type EffectiveBrowserSettings,
+	parseConfiguredPort,
+} from "./settings.js";
 
-export const DEFAULT_HOST = "127.0.0.1";
-export const DEFAULT_PORT = 9222;
+export const DEFAULT_HOST = DEFAULT_BROWSER_HOST;
+export const DEFAULT_PORT = DEFAULT_BROWSER_PORT;
 export const DEFAULT_TIMEOUT_MS = 10_000;
 export const DEFAULT_HTTP_TIMEOUT_MS = 1_000;
 export const DEFAULT_ENDPOINT_WAIT_MS = 5_000;
@@ -26,6 +31,8 @@ export interface ChromeDevToolsState {
 	hostConfigured: boolean;
 	portConfigured: boolean;
 	autoLaunchEnabled: boolean;
+	endpointSource: EffectiveBrowserSettings["endpointSource"];
+	autoLaunchSource: EffectiveBrowserSettings["autoLaunchSource"];
 	browserExecutable?: string;
 	extensionPaths: string[];
 	browserExecutableSource: EffectiveBrowserSettings["executablePathSource"];
@@ -71,29 +78,19 @@ export interface BrowserCandidate extends BrowserCandidateDefinition {
 	resolvedExecutable: string;
 }
 
-export function parseConfiguredPort(value: string | undefined) {
-	if (value === undefined) return undefined;
-	const trimmedValue = value.trim();
-	if (!/^\d+$/.test(trimmedValue)) return undefined;
-	const port = Number(trimmedValue);
-	if (!Number.isInteger(port) || port < 1 || port > 65_535) return undefined;
-	return port;
-}
-
-const configuredHost = process.env.PI_CHROME_DEVTOOLS_HOST ?? DEFAULT_HOST;
-const configuredPortOverride = parseConfiguredPort(process.env.PI_CHROME_DEVTOOLS_PORT);
-const configuredPort = configuredPortOverride ?? DEFAULT_PORT;
+export { parseConfiguredPort };
 
 export const state: ChromeDevToolsState = {
-	host: configuredHost,
-	port: configuredPort,
-	configuredPort,
-	hostConfigured: process.env.PI_CHROME_DEVTOOLS_HOST !== undefined,
-	portConfigured: configuredPortOverride !== undefined,
-	autoLaunchEnabled: process.env.PI_CHROME_DEVTOOLS_AUTO_LAUNCH !== "0",
-	browserExecutable: process.env.PI_CHROME_DEVTOOLS_BROWSER,
+	host: DEFAULT_HOST,
+	port: DEFAULT_PORT,
+	configuredPort: DEFAULT_PORT,
+	hostConfigured: false,
+	portConfigured: false,
+	autoLaunchEnabled: true,
+	endpointSource: "default",
+	autoLaunchSource: "default",
 	extensionPaths: [],
-	browserExecutableSource: process.env.PI_CHROME_DEVTOOLS_BROWSER ? "environment" : "default",
+	browserExecutableSource: "default",
 	extensionPathsSource: "default",
 	projectSettingsTrusted: false,
 	shuttingDown: false,
@@ -106,6 +103,14 @@ export function applyRuntimeBrowserSettings(
 	paths: { user: string; project?: string },
 	projectTrusted: boolean,
 ) {
+	state.host = browser.host;
+	state.port = browser.port;
+	state.configuredPort = browser.port;
+	state.hostConfigured = browser.hostConfigured;
+	state.portConfigured = browser.portConfigured;
+	state.autoLaunchEnabled = browser.autoLaunchEnabled;
+	state.endpointSource = browser.endpointSource;
+	state.autoLaunchSource = browser.autoLaunchSource;
 	state.browserExecutable = browser.executablePath;
 	state.extensionPaths = [...browser.extensionPaths];
 	state.browserExecutableSource = browser.executablePathSource;