@tomflow/proflow-execution-browser-extension 0.1.18 → 0.1.20

package/dist/deployment/adapter.d.ts

@@ -24,7 +24,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.18";
+            moduleVersion: "0.1.20";
             data: {
                 loadDir: string;
             };
@@ -37,7 +37,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.18";
+            readonly moduleVersion: "0.1.20";
         };
         observedEffects: never[];
     }>;
@@ -47,7 +47,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.18";
+            moduleVersion: "0.1.20";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
                 runtimeStatus: "NOT_APPLICABLE";
@@ -66,7 +66,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.18";
+            moduleVersion: "0.1.20";
             ok: false;
             status: "ACTION_REQUIRED";
             data: {
@@ -98,14 +98,14 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.18";
+            readonly moduleVersion: "0.1.20";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.18";
+            moduleVersion: "0.1.20";
             ok: false;
             status: "FAILED";
             error: {
@@ -138,7 +138,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.18";
+            moduleVersion: "0.1.20";
             data: {
                 docs: string;
             };
@@ -151,11 +151,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.18";
+            readonly moduleVersion: "0.1.20";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.18";
+            moduleVersion: "0.1.20";
             ok: false;
             status: "FAILED";
             error: {
@@ -172,7 +172,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.18";
+            readonly moduleVersion: "0.1.20";
         };
         observedEffects: never[];
     }>;

package/dist/deployment/adapter.js

@@ -3,6 +3,7 @@ import { cp, mkdir, readFile, 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 { openBrowserExtensionManager, runInteractiveBrowserExtensionSetup, } from "../src/install-workflow.js";
 import { createBrowserExtensionPairingServer } from "../src/pairing.js";
 import { descriptor } from "./descriptor.js";
@@ -132,11 +133,12 @@ async function persistDeveloperModeConfirmation(context) {
     await mkdir(stateDir(context), { recursive: true, mode: 0o700 });
     await writeFile(installFlowFile(context), `${JSON.stringify({ developerModeConfirmed: true })}\n`, { mode: 0o600 });
 }
-async function readEvidence(context, loadDir) {
+async function readEvidenceCandidate(context, loadDir) {
     try {
         const raw = JSON.parse(await readFile(verificationFile(context), "utf8"));
         return raw.contract === "proflow.browser-extension-verification.v1" &&
-            raw.moduleVersion === descriptor.moduleVersion &&
+            typeof raw.moduleVersion === "string" &&
+            raw.moduleVersion.length > 0 &&
             raw.loadDir === loadDir &&
             typeof raw.extensionId === "string" &&
             /^[a-z]{32}$/.test(raw.extensionId) &&
@@ -153,6 +155,12 @@ async function readEvidence(context, loadDir) {
         return undefined;
     }
 }
+async function readEvidence(context, loadDir) {
+    const evidence = await readEvidenceCandidate(context, loadDir);
+    return evidence?.moduleVersion === descriptor.moduleVersion
+        ? evidence
+        : undefined;
+}
 async function ownFacts(context) {
     await mkdir(stateDir(context), { recursive: true, mode: 0o700 });
     const loadDir = browserExtensionLoadDir(context.workspaceRoot);
@@ -247,15 +255,83 @@ async function persistPairedBrowserExtension(context, prepared, identity) {
     await writeFile(verificationFile(context), `${JSON.stringify(evidence, null, 2)}\n`, { mode: 0o600 });
     return identity;
 }
+function connectionRefused(error) {
+    if (!(error instanceof TypeError))
+        return false;
+    const cause = Reflect.get(error, "cause");
+    return (typeof cause === "object" &&
+        cause !== null &&
+        Reflect.get(cause, "code") === "ECONNREFUSED");
+}
+async function probeRunningBridgeSession(prepared, extensionId, timeoutMs) {
+    try {
+        const response = await fetch(`${prepared.bridgeEndpoint}/v1/session/status`, {
+            headers: {
+                authorization: `Bearer ${await credential(prepared.bridgeTokenFile)}`,
+                origin: `chrome-extension://${extensionId}`,
+            },
+            signal: AbortSignal.timeout(Math.max(25, Math.min(500, timeoutMs))),
+        });
+        if (!response.ok)
+            throw new Error(`RUNNING_BRIDGE_STATUS_${response.status}`);
+        const body = (await response.json());
+        if (typeof body !== "object" || body === null || Array.isArray(body))
+            throw new Error("RUNNING_BRIDGE_STATUS_INVALID");
+        if (Reflect.get(body, "online") !== true)
+            return { kind: "PRESENT" };
+        const extensionInstanceId = Reflect.get(body, "extensionInstanceId");
+        if (typeof extensionInstanceId !== "string" ||
+            extensionInstanceId.length === 0)
+            throw new Error("RUNNING_BRIDGE_STATUS_INVALID");
+        return {
+            kind: "PRESENT",
+            identity: { extensionId, extensionInstanceId },
+        };
+    }
+    catch (error) {
+        if (connectionRefused(error))
+            return { kind: "ABSENT" };
+        throw error;
+    }
+}
+async function revalidateRunningBridge(prepared, extensionId, timeoutMs, onWaiting) {
+    const startedAt = Date.now();
+    const graceMs = Math.min(2_000, Math.max(25, Math.floor(timeoutMs / 4)));
+    let waitingShown = false;
+    while (true) {
+        const remainingMs = Math.max(1, timeoutMs - (Date.now() - startedAt));
+        const probe = await probeRunningBridgeSession(prepared, extensionId, remainingMs);
+        if (probe.kind === "ABSENT")
+            return undefined;
+        if (probe.identity)
+            return probe.identity;
+        const elapsedMs = Date.now() - startedAt;
+        if (!waitingShown && elapsedMs >= graceMs) {
+            waitingShown = true;
+            await onWaiting?.({
+                loadDir: prepared.loadDir,
+                endpoint: prepared.bridgeEndpoint,
+            });
+        }
+        if (elapsedMs >= timeoutMs)
+            throw new Error("PAIRING_TIMEOUT");
+        await new Promise((resolve) => setTimeout(resolve, Math.min(100, Math.max(10, timeoutMs - elapsedMs))));
+    }
+}
 export async function pairBrowserExtensionSetup(context, options = {}) {
     await mkdir(stateDir(context), { recursive: true, mode: 0o700 });
     await installPackage(context);
     const existingSetup = await readSetup(context);
-    const existingEvidence = await readEvidence(context, browserExtensionLoadDir(context.workspaceRoot));
+    const existingEvidence = await readEvidenceCandidate(context, browserExtensionLoadDir(context.workspaceRoot));
     const canRevalidateExisting = Boolean(existingSetup &&
         existingEvidence &&
         existingSetup.extensionId === existingEvidence.extensionId);
     const prepared = await materializeRuntimeConfig(context);
+    if (canRevalidateExisting && existingSetup) {
+        const runningIdentity = await revalidateRunningBridge(prepared, existingSetup.extensionId, options.timeoutMs ?? 120_000, options.onWaiting);
+        if (runningIdentity)
+            return persistPairedBrowserExtension(context, prepared, runningIdentity);
+    }
     const pairing = await createBrowserExtensionPairingServer({
         token: await credential(prepared.bridgeTokenFile),
         host: "127.0.0.1",
@@ -310,7 +386,16 @@ export const behaviorAdapter = {
         const loadDir = browserExtensionLoadDir(context.workspaceRoot);
         const setup = await readSetup(context);
         const evidence = await readEvidence(context, loadDir);
-        const setupReady = Boolean(setup && evidence && setup.extensionId === evidence.extensionId);
+        const chromeState = setup && evidence && setup.extensionId === evidence.extensionId
+            ? await probeChromeExtensionState({
+                extensionId: evidence.extensionId,
+                loadDir,
+            })
+            : "MISSING";
+        const setupReady = Boolean(setup &&
+            evidence &&
+            setup.extensionId === evidence.extensionId &&
+            chromeState === "ENABLED");
         return {
             result: {
                 ...base,

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.18";
+    readonly moduleVersion: "0.1.20";
     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.18",
+    moduleVersion: "0.1.20",
     kind: "browser-extension",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/bridge.js

@@ -129,6 +129,15 @@ export async function createBrowserRealityBridgeServer(options) {
                 send(response, 200, { accepted: true });
                 return;
             }
+            if (request.method === "GET" && url.pathname === "/v1/session/status") {
+                const online = session !== undefined &&
+                    now().getTime() - session.lastHeartbeatAt <= freshnessMs;
+                send(response, 200, {
+                    online,
+                    extensionInstanceId: session?.extensionInstanceId ?? null,
+                });
+                return;
+            }
             if (!session)
                 throw new BrowserRealityBridgeError("BRIDGE_OFFLINE", "extension session has not completed hello");
             if (url.searchParams.get("extensionInstanceId") !==

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

@@ -0,0 +1,6 @@
+export type ChromeExtensionState = "ENABLED" | "DISABLED" | "MISSING" | "UNKNOWN";
+export declare function probeChromeExtensionState(input: {
+    extensionId: string;
+    loadDir: string;
+    userDataRoot?: string;
+}): Promise<ChromeExtensionState>;

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

@@ -0,0 +1,66 @@
+import { readdir, readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+function defaultUserDataRoot() {
+    if (process.platform === "darwin")
+        return join(homedir(), "Library", "Application Support", "Google", "Chrome");
+    if (process.platform === "linux")
+        return join(homedir(), ".config", "google-chrome");
+    if (process.platform === "win32" && process.env.LOCALAPPDATA)
+        return join(process.env.LOCALAPPDATA, "Google", "Chrome", "User Data");
+    return undefined;
+}
+function entryState(entry, expectedLoadDir) {
+    if (typeof entry.path !== "string" || resolve(entry.path) !== expectedLoadDir)
+        return undefined;
+    const disabledByReason = Array.isArray(entry.disable_reasons) && entry.disable_reasons.length > 0;
+    const disabledByState = entry.state === 0;
+    return disabledByReason || disabledByState ? "DISABLED" : "ENABLED";
+}
+async function settingsFrom(path) {
+    const raw = JSON.parse(await readFile(path, "utf8"));
+    return raw.extensions?.settings ?? {};
+}
+async function preferredProfiles(root) {
+    let lastUsed;
+    try {
+        const localState = JSON.parse(await readFile(join(root, "Local State"), "utf8"));
+        if (typeof localState.profile?.last_used === "string")
+            lastUsed = localState.profile.last_used;
+    }
+    catch { }
+    const entries = await readdir(root, { withFileTypes: true });
+    const profiles = entries
+        .filter((entry) => entry.isDirectory() && /^(Default|Profile \d+)$/.test(entry.name))
+        .map((entry) => entry.name);
+    return lastUsed && profiles.includes(lastUsed)
+        ? [lastUsed, ...profiles.filter((name) => name !== lastUsed)]
+        : profiles;
+}
+export async function probeChromeExtensionState(input) {
+    const root = input.userDataRoot ?? defaultUserDataRoot();
+    if (!root)
+        return "UNKNOWN";
+    const expectedLoadDir = resolve(input.loadDir);
+    try {
+        const profiles = await preferredProfiles(root);
+        let sawMatchingDisabled = false;
+        for (const profile of profiles) {
+            for (const file of ["Secure Preferences", "Preferences"]) {
+                try {
+                    const settings = await settingsFrom(join(root, profile, file));
+                    const observed = entryState(settings[input.extensionId] ?? {}, expectedLoadDir);
+                    if (observed === "ENABLED")
+                        return "ENABLED";
+                    if (observed === "DISABLED")
+                        sawMatchingDisabled = true;
+                }
+                catch { }
+            }
+        }
+        return sawMatchingDisabled ? "DISABLED" : "MISSING";
+    }
+    catch {
+        return "UNKNOWN";
+    }
+}

package/manifest.json

@@ -1,28 +1,17 @@
 {
 	"manifest_version": 3,
 	"name": "ProFlow Execution Browser",
-	"version": "0.1.18",
-	"permissions": [
-		"tabs",
-		"storage",
-		"sidePanel"
-	],
-	"host_permissions": [
-		"https://chatgpt.com/*",
-		"http://127.0.0.1/*"
-	],
+	"version": "0.1.20",
+	"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"
 		},
 		{
@@ -30,9 +19,7 @@
 				"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.18",
+  "version": "0.1.20",
   "description": "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
   "type": "module",
   "publishConfig": {
@@ -31,8 +31,8 @@
     "@tomflow/proflow-module-contract": "^0.1.13"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.13",
-    "@tomflow/proflow-execution-runtime": "^0.1.15"
+    "@tomflow/proflow-execution-runtime": "^0.1.15",
+    "@tomflow/proflow-deployment-conformance": "^0.1.13"
   },
   "keywords": [
     "proflow",

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.18",
+	"moduleVersion": "0.1.20",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",

package/CHANGELOG.md

@@ -1,79 +0,0 @@
-# @tomflow/proflow-execution-browser-extension
-
-## 0.1.18
-
-### Patch Changes
-
-- Close the final Deployment replay defects: make Dev Tunnel CLI version probing tolerate real service latency, keep Browser Extension setup idempotent across retries, and remember a non-sensitive Provider endpoint across temporary outages without fabricating readiness.
-
-## 0.1.17
-
-### Patch Changes
-
-- Repack the Deployment Closeout release from freshly rebuilt artifacts and enforce build + publishability before every canonical publish.
-
-## 0.1.16
-
-### Patch Changes
-
-- Harden Deployment Closeout: fail closed on partial installs and package-manager conflicts, normalize Git workspace isolation, make Dev Tunnel status fast and resumable without fabricating login failures, and align Browser Extension setup/conformance behavior.
-
-## 0.1.15
-
-### Patch Changes
-
-- Add professional setup orchestration, Provider FAST/THINK input, recoverable managed Dev Tunnel provisioning, Browser installation guidance, and precise status diagnostics.
-
-## 0.1.14
-
-### Patch Changes
-
-- Retire the obsolete Carrier package and Browser standalone management CLI, make Platform setup/status preserve owner and dependency semantics, and enforce read-only status observation across the final Real-3 deployment closeout.
-
-## 0.1.13
-
-### Patch Changes
-
-- Ship the Phase 3 browser, tunnel, model automation, platform readiness, and documentation closure as one verifiable platform snapshot.
-
-## 0.1.12
-
-### Patch Changes
-
-- Distinguish dependency blocking from verified failure, expose Module-owned status diagnostics, remove automatic docs paging, consolidate start checks, add contextual help, and clarify uninstall output.
-
-## 0.1.11
-
-### Patch Changes
-
-- Upgrade the ProFlow terminal experience, stream Registry and package-manager progress, publish structured Chinese Module documentation, and provide numbered package-owned Setup assistants.
-
-## 0.1.10
-
-### Patch Changes
-
-- Make every setup command directly runnable from a workspace and render setup failures without Node stack traces.
-
-## 0.1.9
-
-### Patch Changes
-
-- Improve terminal progress and localized status output, publish readable Chinese module docs, and add guided setup assistants for external resources.
-
-## 0.1.8
-
-### Patch Changes
-
-- Resolve DOCS.md from both source and built deployment adapters, prove all 24 built adapters return the published body, and announce package synchronization before the package manager blocks.
-
-## 0.1.7
-
-### Patch Changes
-
-- Replace JSON terminal protocols with typed CLI outcomes, add real-time Chinese progress and lifecycle summaries, publish DOCS content, standardize executable setup plans and package-owned setup commands, and preserve only user-owned pnpm policy during uninstall.
-
-## 0.1.6
-
-### Patch Changes
-
-- Align all Modules to the seven-command setup contract with executable package-owned setup guidance and full Platform setup aggregation.