@tomflow/proflow-execution-browser-extension 0.1.21 → 0.1.23

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @tomflow/proflow-execution-browser-extension
+
+## 0.1.23
+
+### Patch Changes
+
+- Wait for Chrome unpacked-extension registration to become observably enabled after heartbeat pairing before Browser setup reports success.
+
+## 0.1.22
+
+### Patch Changes
+
+- Make Browser Extension static materialization version-idempotent, freeze real-user install/remove acceptance paths, and remove unsupported Reload/Disable-Enable test scenarios.

package/dist/deployment/adapter.d.ts

@@ -47,7 +47,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             data: {
                 loadDir: string;
             };
@@ -60,7 +60,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.21";
+            readonly moduleVersion: "0.1.23";
         };
         observedEffects: never[];
     }>;
@@ -70,7 +70,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
                 runtimeStatus: "NOT_APPLICABLE";
@@ -95,7 +95,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             ok: false;
             status: "ACTION_REQUIRED";
             data: {
@@ -127,14 +127,14 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.21";
+            readonly moduleVersion: "0.1.23";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             ok: false;
             status: "FAILED";
             error: {
@@ -167,7 +167,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             data: {
                 docs: string;
             };
@@ -180,11 +180,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.21";
+            readonly moduleVersion: "0.1.23";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.21";
+            moduleVersion: "0.1.23";
             ok: false;
             status: "FAILED";
             error: {
@@ -201,7 +201,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.21";
+            readonly moduleVersion: "0.1.23";
         };
         observedEffects: never[];
     }>;

package/dist/deployment/adapter.js

@@ -1,9 +1,9 @@
 import { readFileSync } from "node:fs";
-import { cp, mkdir, readFile, writeFile } from "node:fs/promises";
+import { cp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { basename, dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { deterministicLoopbackPort, ensureModuleSecretFile, moduleWorkspaceStateDirectory, readModuleSharedFacts, writeModuleSharedFacts, } from "@tomflow/proflow-module-contract";
-import { probeChromeExtensionState } from "../src/chrome-extension-state.js";
+import { probeChromeExtensionState, waitForChromeExtensionEnabled, } from "../src/chrome-extension-state.js";
 import { openBrowserExtensionManager, runInteractiveBrowserExtensionSetup, } from "../src/install-workflow.js";
 import { createBrowserExtensionPairingServer } from "../src/pairing.js";
 import { descriptor } from "./descriptor.js";
@@ -40,6 +40,25 @@ function packageRoot() {
 export function browserExtensionLoadDir(workspaceRoot) {
     return join(resolve(workspaceRoot), ".proflow", "deployment", "browser-extension", "execution-browser-extension");
 }
+const materializationFile = (context) => join(browserExtensionLoadDir(context.workspaceRoot), ".proflow-materialization.json");
+async function materializationReady(context) {
+    const loadDir = browserExtensionLoadDir(context.workspaceRoot);
+    try {
+        const raw = JSON.parse(await readFile(materializationFile(context), "utf8"));
+        if (raw.contract !== "proflow.browser-extension-materialization.v1" ||
+            raw.moduleVersion !== descriptor.moduleVersion)
+            return false;
+        await Promise.all([
+            readFile(join(loadDir, "manifest.json")),
+            readFile(join(loadDir, "dist", "extension", "background.js")),
+            readFile(join(loadDir, "extension", "options.html")),
+        ]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 const stateDir = (context) => moduleWorkspaceStateDirectory(context, descriptor.moduleRef);
 const setupFile = (context) => join(stateDir(context), "setup.json");
 const installFlowFile = (context) => join(stateDir(context), "install-flow.json");
@@ -93,8 +112,11 @@ export async function materializeProductionConfig(input) {
     return { loadDir };
 }
 async function installPackage(context) {
-    const sourceRoot = packageRoot();
     const loadDir = browserExtensionLoadDir(context.workspaceRoot);
+    if (await materializationReady(context))
+        return loadDir;
+    const sourceRoot = packageRoot();
+    await rm(loadDir, { recursive: true, force: true });
     await mkdir(join(loadDir, "dist"), { recursive: true });
     await cp(join(sourceRoot, "dist", "extension"), join(loadDir, "dist", "extension"), { recursive: true, force: true });
     await cp(join(sourceRoot, "extension"), join(loadDir, "extension"), {
@@ -104,6 +126,10 @@ async function installPackage(context) {
     await cp(join(sourceRoot, "manifest.json"), join(loadDir, "manifest.json"), {
         force: true,
     });
+    await writeFile(materializationFile(context), `${JSON.stringify({
+        contract: "proflow.browser-extension-materialization.v1",
+        moduleVersion: descriptor.moduleVersion,
+    }, null, 2)}\n`, { mode: 0o600 });
     return loadDir;
 }
 async function readSetup(context) {
@@ -509,7 +535,7 @@ export const behaviorAdapter = {
                 installFlow?.developerModeConfirmed !== true) {
                 await persistDeveloperModeConfirmation(context);
             }
-            await runInteractiveBrowserExtensionSetup({
+            const paired = await runInteractiveBrowserExtensionSetup({
                 workspaceRoot: context.workspaceRoot,
                 ...(input?.timeoutMs === undefined
                     ? {}
@@ -517,6 +543,14 @@ export const behaviorAdapter = {
                 ...(input?.desktop === undefined ? {} : { desktop: input.desktop }),
                 ...(input?.pair === undefined ? {} : { pair: input.pair }),
             });
+            if (input?.pair === undefined) {
+                const chromeState = await waitForChromeExtensionEnabled({
+                    extensionId: paired.extensionId,
+                    loadDir: browserExtensionLoadDir(context.workspaceRoot),
+                }, { timeoutMs: 5_000 });
+                if (chromeState !== "ENABLED")
+                    throw new Error(`Chrome extension registration did not stabilize as ENABLED after pairing (${chromeState})`);
+            }
             return {
                 result: base,
                 observedEffects: ["Materialize the unpacked MV3 extension package"],

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "execution-browser-extension";
     readonly packageName: "@tomflow/proflow-execution-browser-extension";
-    readonly moduleVersion: "0.1.21";
+    readonly moduleVersion: "0.1.23";
     readonly kind: "browser-extension";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";

package/dist/deployment/descriptor.js

@@ -3,7 +3,7 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "execution-browser-extension",
     packageName: "@tomflow/proflow-execution-browser-extension",
-    moduleVersion: "0.1.21",
+    moduleVersion: "0.1.23",
     kind: "browser-extension",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/chrome-extension-state.d.ts

@@ -1,4 +1,14 @@
 export type ChromeExtensionState = "ENABLED" | "DISABLED" | "MISSING" | "UNKNOWN";
+export type ChromeExtensionStateProbe = () => Promise<ChromeExtensionState>;
+export declare function waitForChromeExtensionEnabled(input: {
+    extensionId: string;
+    loadDir: string;
+    userDataRoot?: string;
+}, options?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+    probe?: ChromeExtensionStateProbe;
+}): Promise<ChromeExtensionState>;
 export declare function probeChromeExtensionState(input: {
     extensionId: string;
     loadDir: string;

package/dist/src/chrome-extension-state.js

@@ -37,6 +37,18 @@ async function preferredProfiles(root) {
         ? [lastUsed, ...profiles.filter((name) => name !== lastUsed)]
         : profiles;
 }
+export async function waitForChromeExtensionEnabled(input, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 5_000;
+    const intervalMs = options.intervalMs ?? 100;
+    const probe = options.probe ?? (() => probeChromeExtensionState(input));
+    const deadline = Date.now() + timeoutMs;
+    let observed = await probe();
+    while (observed !== "ENABLED" && observed !== "DISABLED" && Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        observed = await probe();
+    }
+    return observed;
+}
 export async function probeChromeExtensionState(input) {
     const root = input.userDataRoot ?? defaultUserDataRoot();
     if (!root)

package/manifest.json

@@ -1,17 +1,28 @@
 {
 	"manifest_version": 3,
 	"name": "ProFlow Execution Browser",
-	"version": "0.1.21",
-	"permissions": ["tabs", "storage", "sidePanel"],
-	"host_permissions": ["https://chatgpt.com/*", "http://127.0.0.1/*"],
+	"version": "0.1.23",
+	"permissions": [
+		"tabs",
+		"storage",
+		"sidePanel"
+	],
+	"host_permissions": [
+		"https://chatgpt.com/*",
+		"http://127.0.0.1/*"
+	],
 	"background": {
 		"service_worker": "dist/extension/background.js",
 		"type": "module"
 	},
 	"content_scripts": [
 		{
-			"matches": ["https://chatgpt.com/g/*"],
-			"js": ["dist/extension/content.js"],
+			"matches": [
+				"https://chatgpt.com/g/*"
+			],
+			"js": [
+				"dist/extension/content.js"
+			],
 			"run_at": "document_idle"
 		},
 		{
@@ -19,7 +30,9 @@
 				"https://chatgpt.com/gpts/editor",
 				"https://chatgpt.com/gpts/editor/*"
 			],
-			"js": ["dist/extension/provisioning-content.js"],
+			"js": [
+				"dist/extension/provisioning-content.js"
+			],
 			"run_at": "document_idle"
 		}
 	],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-browser-extension",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
   "type": "module",
   "publishConfig": {

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "execution-browser-extension",
 	"packageName": "@tomflow/proflow-execution-browser-extension",
-	"moduleVersion": "0.1.21",
+	"moduleVersion": "0.1.23",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",