@tomflow/proflow-execution-browser-extension 0.1.32 → 0.1.34

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.32";
+            moduleVersion: "0.1.34";
             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.32";
+            readonly moduleVersion: "0.1.34";
         };
         observedEffects: never[];
     }>;
@@ -70,7 +70,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.32";
+            moduleVersion: "0.1.34";
             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.32";
+            moduleVersion: "0.1.34";
             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.32";
+            readonly moduleVersion: "0.1.34";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.32";
+            moduleVersion: "0.1.34";
             ok: false;
             status: "FAILED";
             error: {
@@ -167,7 +167,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.32";
+            moduleVersion: "0.1.34";
             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.32";
+            readonly moduleVersion: "0.1.34";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.32";
+            moduleVersion: "0.1.34";
             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.32";
+            readonly moduleVersion: "0.1.34";
         };
         observedEffects: never[];
     }>;

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

package/dist/extension/background.js

@@ -13876,6 +13876,8 @@ function shouldTriggerObserverRecovery(previous, current) {
 // packages/execution-browser-extension/extension/background.ts
 var extensionInstanceId = `extension:${crypto.randomUUID()}`;
 var sessions = /* @__PURE__ */ new Map();
+var BROWSER_CARRIER_KEEPALIVE_KEY = "proflowBrowserSnapshot";
+var BROWSER_CARRIER_KEEPALIVE_MS = 2e4;
 var sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
 async function persistSnapshot() {
   await chrome.storage.session.set({
@@ -14517,7 +14519,12 @@ async function runBridgeLoop() {
       });
       if (!hello.ok) throw new Error("BRIDGE_HELLO_REJECTED");
       let lastHeartbeatAt = 0;
+      let lastExtensionKeepaliveAt = 0;
       while (true) {
+        if (Date.now() - lastExtensionKeepaliveAt >= BROWSER_CARRIER_KEEPALIVE_MS) {
+          await chrome.storage.session.get(BROWSER_CARRIER_KEEPALIVE_KEY).catch(() => ({}));
+          lastExtensionKeepaliveAt = Date.now();
+        }
         if (Date.now() - lastHeartbeatAt >= 5e3) {
           const heartbeat = await bridgeFetch(
             config2,

package/dist/src/bridge.d.ts

@@ -28,6 +28,9 @@ export declare function createBrowserRealityBridgeServer(options: BrowserReality
         extensionInstanceId: string | null;
         queuedCommands: number;
         pendingCommands: number;
+        lastCommandPollAt: string | null;
+        lastCommandDeliveredAt: string | null;
+        lastCommandResultAt: string | null;
     };
     close(): Promise<void>;
 }>>;

package/dist/src/bridge.js

@@ -108,11 +108,16 @@ export async function createBrowserRealityBridgeServer(options) {
     const now = options.now ?? (() => new Date());
     const idFactory = options.idFactory ?? randomUUID;
     const freshnessMs = options.heartbeatFreshnessMs ?? 10_000;
-    const commandTimeoutMs = options.commandTimeoutMs ?? 15_000;
+    // Browser commands are Promise-driven. This is only an abnormal hung-command
+    // watchdog; normal page load / content observation must not be scheduled by it.
+    const commandTimeoutMs = options.commandTimeoutMs ?? 120_000;
     const expectedOrigin = `chrome-extension://${options.extensionId}`;
     const queue = [];
     const pending = new Map();
     let session;
+    let lastCommandPollAt = null;
+    let lastCommandDeliveredAt = null;
+    let lastCommandResultAt = null;
     let closed = false;
     let endpoint = "";
     const taskBootstrap = new Map();
@@ -186,6 +191,11 @@ export async function createBrowserRealityBridgeServer(options) {
                             browserCarrier: {
                                 online: session !== undefined && now().getTime() - session.lastHeartbeatAt <= freshnessMs,
                                 extensionInstanceId: session?.extensionInstanceId ?? null,
+                                queuedCommands: queue.length,
+                                pendingCommands: pending.size,
+                                lastCommandPollAt,
+                                lastCommandDeliveredAt,
+                                lastCommandResultAt,
                             },
                         },
                     });
@@ -230,8 +240,14 @@ export async function createBrowserRealityBridgeServer(options) {
                 if (!isRecord(body) ||
                     stringField(body, "extensionId") !== options.extensionId)
                     throw new BrowserRealityBridgeError("BRIDGE_AUTH_INVALID", "extension identity mismatch");
+                const extensionInstanceId = stringField(body, "extensionInstanceId");
+                if (session?.extensionInstanceId !== extensionInstanceId) {
+                    lastCommandPollAt = null;
+                    lastCommandDeliveredAt = null;
+                    lastCommandResultAt = null;
+                }
                 session = {
-                    extensionInstanceId: stringField(body, "extensionInstanceId"),
+                    extensionInstanceId,
                     lastHeartbeatAt: now().getTime(),
                 };
                 send(response, 200, { accepted: true });
@@ -258,12 +274,15 @@ export async function createBrowserRealityBridgeServer(options) {
                 return;
             }
             if (request.method === "GET" && url.pathname === "/v1/commands/next") {
-                session.lastHeartbeatAt = now().getTime();
+                const stamp = now();
+                session.lastHeartbeatAt = stamp.getTime();
+                lastCommandPollAt = stamp.toISOString();
                 const command = queue.shift();
                 if (command) {
                     const tracked = pending.get(command.commandId);
                     if (tracked)
                         tracked.stage = "DELIVERED";
+                    lastCommandDeliveredAt = lastCommandPollAt;
                 }
                 send(response, command ? 200 : 204, command);
                 return;
@@ -278,6 +297,7 @@ export async function createBrowserRealityBridgeServer(options) {
                     throw new BrowserRealityBridgeError("BRIDGE_INPUT_INVALID", "command result is stale or unknown");
                 pending.delete(commandId);
                 clearTimeout(command.timer);
+                lastCommandResultAt = now().toISOString();
                 if (body.ok === true)
                     command.resolve(body.value);
                 else
@@ -389,6 +409,9 @@ export async function createBrowserRealityBridgeServer(options) {
                 extensionInstanceId: session?.extensionInstanceId ?? null,
                 queuedCommands: queue.length,
                 pendingCommands: pending.size,
+                lastCommandPollAt,
+                lastCommandDeliveredAt,
+                lastCommandResultAt,
             };
         },
         async close() {

package/dist/src/runtime-composition.d.ts

@@ -91,6 +91,9 @@ export declare function createBrowserExecutorComposition(options: BrowserExecuto
         extensionInstanceId: string | null;
         queuedCommands: number;
         pendingCommands: number;
+        lastCommandPollAt: string | null;
+        lastCommandDeliveredAt: string | null;
+        lastCommandResultAt: string | null;
     };
     close: () => Promise<void>;
 }>>;

package/extension/background.ts

@@ -106,7 +106,10 @@ type ChromeRuntime = {
 		onInstalled: { addListener(listener: () => void): void };
 	};
 	storage: {
-		session: { set(value: Record<string, unknown>): Promise<void> };
+		session: {
+			get(key: string): Promise<Record<string, unknown>>;
+			set(value: Record<string, unknown>): Promise<void>;
+		};
 		local: {
 			get(key: string): Promise<Record<string, unknown>>;
 			set(value: Record<string, unknown>): Promise<void>;
@@ -138,6 +141,8 @@ declare const chrome: ChromeRuntime;
 
 const extensionInstanceId = `extension:${crypto.randomUUID()}`;
 const sessions = new Map<number, ContentObservation>();
+const BROWSER_CARRIER_KEEPALIVE_KEY = "proflowBrowserSnapshot";
+const BROWSER_CARRIER_KEEPALIVE_MS = 20_000;
 
 const sleep = (milliseconds: number) =>
 	new Promise<void>((resolve) => setTimeout(resolve, milliseconds));
@@ -1002,7 +1007,17 @@ async function runBridgeLoop() {
 			});
 			if (!hello.ok) throw new Error("BRIDGE_HELLO_REJECTED");
 			let lastHeartbeatAt = 0;
+			let lastExtensionKeepaliveAt = 0;
 			while (true) {
+				if (
+					Date.now() - lastExtensionKeepaliveAt >=
+					BROWSER_CARRIER_KEEPALIVE_MS
+				) {
+					await chrome.storage.session
+						.get(BROWSER_CARRIER_KEEPALIVE_KEY)
+						.catch(() => ({}));
+					lastExtensionKeepaliveAt = Date.now();
+				}
 				if (Date.now() - lastHeartbeatAt >= 5_000) {
 					const heartbeat = await bridgeFetch(
 						config,

package/manifest.json

@@ -1,7 +1,7 @@
 {
 	"manifest_version": 3,
 	"name": "ProFlow Execution Browser",
-	"version": "0.1.32",
+	"version": "0.1.34",
 	"permissions": [
 		"tabs",
 		"storage"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-browser-extension",
-  "version": "0.1.32",
+  "version": "0.1.34",
   "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-execution-runtime": "^0.1.15",
-    "@tomflow/proflow-deployment-conformance": "^0.1.13"
+    "@tomflow/proflow-deployment-conformance": "^0.1.13",
+    "@tomflow/proflow-execution-runtime": "^0.1.16"
   },
   "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.32",
+	"moduleVersion": "0.1.34",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",