@tomflow/proflow-execution-browser-extension 0.1.47 → 0.1.48

package/dist/deployment/adapter.d.ts

@@ -14,11 +14,13 @@ export type RunningBridgeProbe = {
     identity?: {
         extensionId: string;
         extensionInstanceId: string;
+        moduleVersion: string;
     };
 };
 export declare function classifyBrowserLiveSetup(input: {
     baseSetupReady: boolean;
     evidenceInstanceId?: string;
+    expectedModuleVersion: string;
     bridgeProbe: RunningBridgeProbe;
 }): {
     readonly setupReady: boolean;
@@ -26,6 +28,9 @@ export declare function classifyBrowserLiveSetup(input: {
 } | {
     setupReady: boolean;
     issueCode: "EXTENSION_SESSION_OFFLINE";
+} | {
+    setupReady: boolean;
+    issueCode: "EXTENSION_VERSION_MISMATCH";
 } | {
     setupReady: boolean;
     issueCode: "EXTENSION_SESSION_REVALIDATION_REQUIRED";
@@ -39,6 +44,7 @@ export declare function pairBrowserExtensionSetup(context: ModuleCommandContext,
 }): Promise<{
     extensionId: string;
     extensionInstanceId: string;
+    moduleVersion: string;
 }>;
 export declare const behaviorAdapter: {
     readonly install: (context: ModuleCommandContext) => Promise<{
@@ -47,7 +53,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.47";
+            moduleVersion: "0.1.48";
             data: {
                 loadDir: string;
             };
@@ -60,7 +66,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.47";
+            readonly moduleVersion: "0.1.48";
         };
         observedEffects: never[];
     }>;
@@ -70,7 +76,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.47";
+            moduleVersion: "0.1.48";
             data: {
                 setupStatus: "ACTION_REQUIRED" | "READY";
                 runtimeStatus: "NOT_APPLICABLE";
@@ -82,7 +88,7 @@ export declare const behaviorAdapter: {
                     nextCommand: string;
                 } | {
                     scope: "SETUP";
-                    code: "EXTENSION_SESSION_OFFLINE" | "EXTENSION_SESSION_REVALIDATION_REQUIRED" | undefined;
+                    code: "EXTENSION_SESSION_OFFLINE" | "EXTENSION_SESSION_REVALIDATION_REQUIRED" | "EXTENSION_VERSION_MISMATCH" | undefined;
                     message: string;
                     relatedModuleRefs: string[];
                     nextCommand: string;
@@ -95,7 +101,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.47";
+            moduleVersion: "0.1.48";
             ok: false;
             status: "ACTION_REQUIRED";
             data: {
@@ -127,14 +133,14 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.47";
+            readonly moduleVersion: "0.1.48";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.47";
+            moduleVersion: "0.1.48";
             ok: false;
             status: "FAILED";
             error: {
@@ -167,7 +173,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.47";
+            moduleVersion: "0.1.48";
             data: {
                 docs: string;
             };
@@ -180,11 +186,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.47";
+            readonly moduleVersion: "0.1.48";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.47";
+            moduleVersion: "0.1.48";
             ok: false;
             status: "FAILED";
             error: {
@@ -201,7 +207,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "execution-browser-extension";
-            readonly moduleVersion: "0.1.47";
+            readonly moduleVersion: "0.1.48";
         };
         observedEffects: never[];
     }>;

package/dist/deployment/adapter.js

@@ -263,6 +263,8 @@ async function materializeExecutorConfig(context, setup, prepared) {
     });
 }
 async function persistPairedBrowserExtension(context, prepared, identity) {
+    if (identity.moduleVersion !== descriptor.moduleVersion)
+        throw new Error("EXTENSION_VERSION_MISMATCH");
     const setup = { extensionId: identity.extensionId };
     await writeFile(setupFile(context), `${JSON.stringify(setup, null, 2)}\n`, {
         mode: 0o600,
@@ -270,7 +272,7 @@ async function persistPairedBrowserExtension(context, prepared, identity) {
     await materializeExecutorConfig(context, setup, prepared);
     const evidence = {
         contract: "proflow.browser-extension-verification.v1",
-        moduleVersion: descriptor.moduleVersion,
+        moduleVersion: identity.moduleVersion,
         loadDir: prepared.loadDir,
         extensionId: identity.extensionId,
         extensionInstanceId: identity.extensionInstanceId,
@@ -289,6 +291,11 @@ export function classifyBrowserLiveSetup(input) {
             setupReady: false,
             issueCode: "EXTENSION_SESSION_OFFLINE",
         };
+    if (input.bridgeProbe.identity.moduleVersion !== input.expectedModuleVersion)
+        return {
+            setupReady: false,
+            issueCode: "EXTENSION_VERSION_MISMATCH",
+        };
     if (input.bridgeProbe.identity.extensionInstanceId !== input.evidenceInstanceId)
         return {
             setupReady: false,
@@ -321,12 +328,15 @@ async function probeRunningBridgeSession(prepared, extensionId, timeoutMs) {
         if (Reflect.get(body, "online") !== true)
             return { kind: "PRESENT" };
         const extensionInstanceId = Reflect.get(body, "extensionInstanceId");
+        const moduleVersion = Reflect.get(body, "moduleVersion");
         if (typeof extensionInstanceId !== "string" ||
-            extensionInstanceId.length === 0)
+            extensionInstanceId.length === 0 ||
+            typeof moduleVersion !== "string" ||
+            moduleVersion.length === 0)
             throw new Error("RUNNING_BRIDGE_STATUS_INVALID");
         return {
             kind: "PRESENT",
-            identity: { extensionId, extensionInstanceId },
+            identity: { extensionId, extensionInstanceId, moduleVersion },
         };
     }
     catch (error) {
@@ -454,6 +464,7 @@ export const behaviorAdapter = {
         const live = classifyBrowserLiveSetup({
             baseSetupReady,
             ...(evidence ? { evidenceInstanceId: evidence.extensionInstanceId } : {}),
+            expectedModuleVersion: descriptor.moduleVersion,
             bridgeProbe,
         });
         const issue = !baseSetupReady
@@ -471,7 +482,9 @@ export const behaviorAdapter = {
                     code: live.issueCode,
                     message: live.issueCode === "EXTENSION_SESSION_OFFLINE"
                         ? "Chrome 扩展已加载，但当前运行会话未在线"
-                        : "Chrome 扩展已重新启动，需要自动刷新当前运行会话证据",
+                        : live.issueCode === "EXTENSION_VERSION_MISMATCH"
+                            ? "Chrome 当前运行的扩展版本与 Workspace 物化版本不一致"
+                            : "Chrome 扩展已重新启动，需要自动刷新当前运行会话证据",
                     relatedModuleRefs: ["execution-runtime"],
                     nextCommand: "platform setup",
                 };

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

package/dist/extension/background.js

@@ -14206,6 +14206,7 @@ function createTaskObserver(options) {
 
 // packages/execution-browser-extension/extension/background.ts
 var extensionInstanceId = `extension:${crypto.randomUUID()}`;
+var extensionModuleVersion = chrome.runtime.getManifest().version;
 var sessions = /* @__PURE__ */ new Map();
 var browserOpenObservationGate = createBrowserOpenObservationGate();
 var permissionHandling = /* @__PURE__ */ new Map();
@@ -15288,7 +15289,8 @@ async function runBridgeLoop() {
         method: "POST",
         body: JSON.stringify({
           extensionId: chrome.runtime.id,
-          extensionInstanceId
+          extensionInstanceId,
+          moduleVersion: extensionModuleVersion
         })
       });
       if (!hello.ok) throw new Error("BRIDGE_HELLO_REJECTED");

package/dist/src/bridge.js

@@ -217,6 +217,7 @@ export async function createBrowserRealityBridgeServer(options) {
                                 sessionOnline: sessionOnline(),
                                 commandConsumerReady: commandConsumerReady(),
                                 extensionInstanceId: session?.extensionInstanceId ?? null,
+                                moduleVersion: session?.moduleVersion ?? null,
                                 queuedCommands: queue.length,
                                 pendingCommands: pending.size,
                                 lastCommandPollAt,
@@ -317,7 +318,9 @@ export async function createBrowserRealityBridgeServer(options) {
                     stringField(body, "extensionId") !== options.extensionId)
                     throw new BrowserRealityBridgeError("BRIDGE_AUTH_INVALID", "extension identity mismatch");
                 const extensionInstanceId = stringField(body, "extensionInstanceId");
-                if (session?.extensionInstanceId !== extensionInstanceId) {
+                const moduleVersion = stringField(body, "moduleVersion");
+                if (session?.extensionInstanceId !== extensionInstanceId ||
+                    session?.moduleVersion !== moduleVersion) {
                     lastCommandPollAt = null;
                     lastCommandDeliveredAt = null;
                     lastCommandResultAt = null;
@@ -325,6 +328,7 @@ export async function createBrowserRealityBridgeServer(options) {
                 }
                 session = {
                     extensionInstanceId,
+                    moduleVersion,
                     lastHeartbeatAt: now().getTime(),
                 };
                 send(response, 200, { accepted: true });
@@ -336,6 +340,7 @@ export async function createBrowserRealityBridgeServer(options) {
                     sessionOnline: sessionOnline(),
                     commandConsumerReady: commandConsumerReady(),
                     extensionInstanceId: session?.extensionInstanceId ?? null,
+                    moduleVersion: session?.moduleVersion ?? null,
                 });
                 return;
             }

package/dist/src/install-workflow.d.ts

@@ -14,6 +14,7 @@ export type BrowserExtensionPair = (context: {
 }) => Promise<{
     extensionId: string;
     extensionInstanceId: string;
+    moduleVersion: string;
 }>;
 export declare function browserExtensionInstallInstruction(loadDir: string): string;
 export declare function browserExtensionSetupSuccessMessage(): string;
@@ -27,4 +28,5 @@ export declare function runInteractiveBrowserExtensionSetup(input: {
 }): Promise<{
     extensionId: string;
     extensionInstanceId: string;
+    moduleVersion: string;
 }>;

package/dist/src/pairing.d.ts

@@ -7,6 +7,7 @@ export interface BrowserExtensionPairingOptions {
 export type BrowserExtensionPairingResult = {
     extensionId: string;
     extensionInstanceId: string;
+    moduleVersion: string;
 };
 export declare function createBrowserExtensionPairingServer(options: BrowserExtensionPairingOptions): Promise<Readonly<{
     endpoint: string;
@@ -14,6 +15,7 @@ export declare function createBrowserExtensionPairingServer(options: BrowserExte
         paired: boolean;
         extensionId: string | null;
         extensionInstanceId: string | null;
+        moduleVersion: string | null;
     };
     waitForPairing(): Promise<BrowserExtensionPairingResult>;
     close(): Promise<void>;

package/dist/src/pairing.js

@@ -93,12 +93,13 @@ export async function createBrowserExtensionPairingServer(options) {
                 const body = await readJson(request);
                 const extensionId = text(body.extensionId);
                 const extensionInstanceId = text(body.extensionInstanceId);
+                const moduleVersion = text(body.moduleVersion);
                 if (!originId || extensionId !== originId)
                     throw new Error("PAIRING_AUTH_INVALID");
                 if (identity && identity.extensionId !== extensionId) {
                     throw new Error("PAIRING_AUTH_INVALID");
                 }
-                identity = { extensionId, extensionInstanceId };
+                identity = { extensionId, extensionInstanceId, moduleVersion };
                 send(response, 200, { accepted: true });
                 return;
             }
@@ -160,6 +161,7 @@ export async function createBrowserExtensionPairingServer(options) {
                 paired: paired !== undefined,
                 extensionId: identity?.extensionId ?? null,
                 extensionInstanceId: identity?.extensionInstanceId ?? null,
+                moduleVersion: identity?.moduleVersion ?? null,
             };
         },
         waitForPairing() {

package/extension/background.ts

@@ -132,6 +132,7 @@ type ChromeTab = {
 type ChromeRuntime = {
 	runtime: {
 		id: string;
+		getManifest(): { version: string };
 		getURL(path: string): string;
 		onMessage: {
 			addListener(
@@ -186,6 +187,7 @@ type ChromeRuntime = {
 declare const chrome: ChromeRuntime;
 
 const extensionInstanceId = `extension:${crypto.randomUUID()}`;
+const extensionModuleVersion = chrome.runtime.getManifest().version;
 const sessions = new Map<number, ContentObservation>();
 const browserOpenObservationGate = createBrowserOpenObservationGate();
 const permissionHandling = new Map<number, string>();
@@ -1637,6 +1639,7 @@ async function runBridgeLoop() {
 				body: JSON.stringify({
 					extensionId: chrome.runtime.id,
 					extensionInstanceId,
+					moduleVersion: extensionModuleVersion,
 				}),
 			});
 			if (!hello.ok) throw new Error("BRIDGE_HELLO_REJECTED");

package/manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-browser-extension",
-  "version": "0.1.47",
+  "version": "0.1.48",
   "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.47",
+	"moduleVersion": "0.1.48",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",

package/CHANGELOG.md

@@ -1,49 +0,0 @@
-# @tomflow/proflow-execution-browser-extension
-
-## 0.1.47
-
-### Patch Changes
-
-- Bound startup Carrier snapshot reconstruction so a hung ChatGPT tab cannot block durable Observer recovery, while preserving restored human-denial suppression and no-blind-replay semantics.
-
-## 0.1.46
-
-### Patch Changes
-
-- Allow the durable TASK_RESUMED observer signal to use the bounded worker.wake trigger contract while preserving arbitrary-trigger rejection and browser delivery verification.
-
-## 0.1.45
-
-### Patch Changes
-
-- Release the verified Real-3 B1 task recovery, exact execution identity, durable observer resume, bounded gateway error, and matching Agent Action contract fixes.
-
-## 0.1.44
-
-### Patch Changes
-
-- Prefer the canonical ChatGPT prompt editor over earlier fallback textareas so worker wake messages are submitted through the real composer.
-
-## 0.1.43
-
-### Patch Changes
-
-- Enrich Browser OBSERVE responses with Chrome-owned tab and window identity before returning the page observation.
-
-## 0.1.42
-
-### Patch Changes
-
-- Close Real-3 node generation identity fencing across Platform Host admission, durable Execution idempotency, and Observer/Approval resume provenance.
-
-## 0.1.41
-
-### Patch Changes
-
-- Resume the existing Task Observer after successful Tasks web mutations so READY nodes receive their normal NODE_READY or REOPEN wake without manual recovery.
-
-## 0.1.40
-
-### Patch Changes
-
-- Make the authenticated ProFlow Tasks web app self-contained so its published browser module no longer escapes the `/tasks` session surface through a runtime relative import.