pi-chrome 0.15.23 → 0.15.25

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable user-facing changes to `pi-chrome`.
 
+## 0.15.25 — 2026-05-16
+
+- **Reload after older installs.** `/reload` now recovers from stale singleton state left by pi-chrome 0.15.19 and earlier instead of skipping the freshly loaded extension.
+- **Test suite coverage.** Added gate buckets plus strict-CSP fallback, dynamic wait readiness, and explicit tab lifecycle challenges.
+
+## 0.15.24 — 2026-05-16
+
+- **Unload Chrome tools on lock.** `chrome_*` tools now deactivate when `/chrome revoke` runs or timed authorization expires, keeping the prompt/tool list small after Chrome control locks again.
+
 ## 0.15.23 — 2026-05-16
 
 - **Attribution.** The 0.15.22 features below are pulled from Dani Bednarski's fork (`DaniBedz/pi-chrome`). Thank you, Dani.

package/extensions/chrome-profile-bridge/browser-extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Pi Chrome Connector",
-  "version": "0.15.23",
+  "version": "0.15.25",
   "description": "Lets Pi control tabs in Chrome via a local connector at 127.0.0.1.",
   "permissions": [
     "tabs",

package/extensions/chrome-profile-bridge/index.ts

@@ -441,6 +441,28 @@ class ChromeProfileBridge {
 const tabActionValues = ["list", "new", "activate", "close", "version"] as const;
 const imageFormatValues = ["png", "jpeg"] as const;
 const waitForValues = ["selector", "expression"] as const;
+const CHROME_TOOL_NAMES = [
+	"chrome_launch",
+	"chrome_tab",
+	"chrome_snapshot",
+	"chrome_navigate",
+	"chrome_evaluate",
+	"chrome_click",
+	"chrome_type",
+	"chrome_fill",
+	"chrome_key",
+	"chrome_wait_for",
+	"chrome_list_console_messages",
+	"chrome_list_network_requests",
+	"chrome_get_network_request",
+	"chrome_screenshot",
+	"chrome_hover",
+	"chrome_drag",
+	"chrome_tap",
+	"chrome_scroll",
+	"chrome_upload_file",
+] as const;
+const CHROME_TOOL_NAME_SET = new Set<string>(CHROME_TOOL_NAMES);
 
 function StringEnum<T extends readonly [string, ...string[]]>(values: T) {
 	return Type.Union(values.map((value) => Type.Literal(value)) as [ReturnType<typeof Type.Literal>, ...ReturnType<typeof Type.Literal>[]]);
@@ -448,22 +470,50 @@ function StringEnum<T extends readonly [string, ...string[]]>(values: T) {
 
 export default function (pi: ExtensionAPI): void {
 	const instanceToken = Symbol("pi-chrome-instance");
+	const currentRoot = extensionRoot();
 	const globalState = globalThis as typeof globalThis & {
-		[PI_CHROME_GLOBAL_KEY]?: { version: string; root: string; token: symbol };
+		[PI_CHROME_GLOBAL_KEY]?: { version: string; root: string; token?: symbol };
 	};
 	const alreadyLoaded = globalState[PI_CHROME_GLOBAL_KEY];
-	if (alreadyLoaded) {
+	if (alreadyLoaded?.token || (alreadyLoaded && alreadyLoaded.root !== currentRoot)) {
 		console.warn(
-			`pi-chrome already loaded from ${alreadyLoaded.root} (v${alreadyLoaded.version}); skipping duplicate from ${extensionRoot()}.`,
+			`pi-chrome already loaded from ${alreadyLoaded.root} (v${alreadyLoaded.version}); skipping duplicate from ${currentRoot}.`,
 		);
 		return;
 	}
-	globalState[PI_CHROME_GLOBAL_KEY] = { version: PI_CHROME_VERSION, root: extensionRoot(), token: instanceToken };
+	// pi-chrome <=0.15.19 set the singleton flag but did not clear it on reload.
+	// If the stale flag points at this same extension root, replace it instead of
+	// skipping the freshly reloaded extension.
+	globalState[PI_CHROME_GLOBAL_KEY] = { version: PI_CHROME_VERSION, root: currentRoot, token: instanceToken };
 
 	const bridge = new ChromeProfileBridge(DEFAULT_HOST, DEFAULT_PORT);
 	let backgroundDefault = false;
 	let chromeAuthorizedUntil: number | "indefinite" | undefined;
 	let chromeToolsRegistered = false;
+	let authExpiryTimer: NodeJS.Timeout | undefined;
+
+	const clearAuthExpiryTimer = (): void => {
+		if (!authExpiryTimer) return;
+		clearTimeout(authExpiryTimer);
+		authExpiryTimer = undefined;
+	};
+
+	const activeToolNamesWithoutChrome = (): string[] => pi.getActiveTools().filter((name) => !CHROME_TOOL_NAME_SET.has(name));
+
+	const activateChromeTools = (): void => {
+		registerChromeTools(pi);
+		pi.setActiveTools([...new Set([...pi.getActiveTools(), ...CHROME_TOOL_NAMES])]);
+	};
+
+	const deactivateChromeTools = (): void => {
+		pi.setActiveTools(activeToolNamesWithoutChrome());
+	};
+
+	const lockChromeControl = (): void => {
+		clearAuthExpiryTimer();
+		chromeAuthorizedUntil = undefined;
+		deactivateChromeTools();
+	};
 
 	const authSummary = (): string => {
 		if (chromeAuthorizedUntil === "indefinite") return "authorized indefinitely";
@@ -477,7 +527,7 @@ export default function (pi: ExtensionAPI): void {
 	const chromeControlAuthorized = (): boolean => {
 		if (chromeAuthorizedUntil === "indefinite") return true;
 		if (typeof chromeAuthorizedUntil === "number" && chromeAuthorizedUntil > Date.now()) return true;
-		chromeAuthorizedUntil = undefined;
+		if (chromeAuthorizedUntil !== undefined) lockChromeControl();
 		return false;
 	};
 
@@ -495,6 +545,21 @@ export default function (pi: ExtensionAPI): void {
 		}
 	};
 
+	const scheduleAuthExpiry = (ctx: ExtensionContext, until: number | "indefinite"): void => {
+		clearAuthExpiryTimer();
+		if (until === "indefinite") return;
+		authExpiryTimer = setTimeout(() => {
+			if (chromeAuthorizedUntil !== until) return;
+			try {
+				lockChromeControl();
+				ctx.ui.notify("Chrome control authorization expired. Run /chrome authorize to allow chrome_* tools again.", "info");
+				updateChromeStatus(ctx);
+			} catch (error) {
+				console.warn(`Failed to expire pi-chrome authorization cleanly: ${(error as Error).message}`);
+			}
+		}, Math.max(0, until - Date.now()));
+	};
+
 	const authorizedBridgeSend = (action: string, params: Record<string, unknown>, timeoutMs = DEFAULT_TIMEOUT_MS, signal?: AbortSignal): Promise<unknown> => {
 		requireChromeControlAuthorized();
 		return bridge.send(action, params, timeoutMs, signal);
@@ -520,6 +585,7 @@ export default function (pi: ExtensionAPI): void {
 	});
 
 	pi.on("session_shutdown", () => {
+		clearAuthExpiryTimer();
 		bridge.stop();
 		if (globalState[PI_CHROME_GLOBAL_KEY]?.token === instanceToken) {
 			delete globalState[PI_CHROME_GLOBAL_KEY];
@@ -653,8 +719,9 @@ Usage rules:
 			ctx.ui.notify("Chrome control remains locked.", "info");
 			return;
 		}
-		registerChromeTools(pi);
 		chromeAuthorizedUntil = until;
+		activateChromeTools();
+		scheduleAuthExpiry(ctx, until);
 		ctx.ui.notify(`Chrome control authorized for ${label}.`, "info");
 		updateChromeStatus(ctx);
 	};
@@ -677,7 +744,7 @@ Usage rules:
 	};
 
 	const revokeHandler = (ctx: ExtensionContext) => {
-		chromeAuthorizedUntil = undefined;
+		lockChromeControl();
 		ctx.ui.notify("Chrome control locked. Run /chrome authorize to allow chrome_* tools again.", "info");
 		updateChromeStatus(ctx);
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-chrome",
-	"version": "0.15.23",
+	"version": "0.15.25",
 	"scripts": {
 		"version": "node scripts/sync-manifest-version.js",
 		"prepublishOnly": "node scripts/sync-manifest-version.js"