@tomflow/proflow-execution-browser-extension 0.1.41 → 0.1.43

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-execution-browser-extension
 
+## 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

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.41";
+            moduleVersion: "0.1.43";
             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.41";
+            readonly moduleVersion: "0.1.43";
         };
         observedEffects: never[];
     }>;
@@ -70,7 +70,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.41";
+            moduleVersion: "0.1.43";
             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.41";
+            moduleVersion: "0.1.43";
             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.41";
+            readonly moduleVersion: "0.1.43";
         };
         observedEffects: string[];
     } | {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.41";
+            moduleVersion: "0.1.43";
             ok: false;
             status: "FAILED";
             error: {
@@ -167,7 +167,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.41";
+            moduleVersion: "0.1.43";
             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.41";
+            readonly moduleVersion: "0.1.43";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "execution-browser-extension";
-            moduleVersion: "0.1.41";
+            moduleVersion: "0.1.43";
             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.41";
+            readonly moduleVersion: "0.1.43";
         };
         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.41";
+    readonly moduleVersion: "0.1.43";
     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.41",
+    moduleVersion: "0.1.43",
     kind: "browser-extension",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/extension/background.js

@@ -14090,6 +14090,8 @@ var NODE_READY_TRIGGER = "NODE_READY";
 var REOPEN_TRIGGER = "REOPEN";
 function createTaskObserver(options) {
   const advance = async (taskId, resumeSignal, anomalySignal) => {
+    if (resumeSignal && (typeof resumeSignal.nodeId !== "string" || resumeSignal.nodeId.length === 0 || !Number.isInteger(resumeSignal.runNo) || resumeSignal.runNo <= 0))
+      return { kind: "NOOP", taskId, reason: "RESUME_GENERATION_REQUIRED" };
     const projection = await options.owner.getTaskDriveProjection(taskId);
     if (projection.terminal || projection.currentNode === null)
       return { kind: "STOP_DRIVING", taskId, reason: "TERMINAL" };
@@ -14119,9 +14121,11 @@ function createTaskObserver(options) {
       };
     }
     const binding = projection.roleBinding;
-    if (!projection.canDrive || !binding?.workerRef || !binding.conversationLocator)
+    if (!binding?.workerRef || !binding.conversationLocator || binding.agentPackageRef !== node.requiredAgentPackageRef)
       return { kind: "NOOP", taskId, reason: "BINDING_NOT_READY" };
     if (node.status === "READY") {
+      if (!projection.canDrive)
+        return { kind: "NOOP", taskId, reason: "BINDING_NOT_READY" };
       return {
         kind: "WAKE",
         taskId,
@@ -14134,6 +14138,14 @@ function createTaskObserver(options) {
       };
     }
     if (resumeSignal) {
+      if (projection.taskStatus !== "ACTIVE" || node.status !== "IN_PROGRESS")
+        return { kind: "NOOP", taskId, reason: "BINDING_NOT_READY" };
+      if (resumeSignal.nodeId !== node.nodeId || resumeSignal.runNo !== node.runNo)
+        return {
+          kind: "NOOP",
+          taskId,
+          reason: "RESUME_GENERATION_MISMATCH"
+        };
       if (resumeSignal.targetWorkerRef !== binding.workerRef)
         return {
           kind: "NOOP",
@@ -14445,6 +14457,20 @@ var taskObserver = createTaskObserver({
     }
   }
 });
+async function resumeAfterApprovalDecision(approvalRef) {
+  const context = await invokeObserverApplication("approval.executionContext", {
+    approvalRef
+  });
+  if (!isRecord(context) || typeof context.executionRef !== "string" || typeof context.taskId !== "string" || typeof context.nodeId !== "string" || !Number.isInteger(context.runNo) || Number(context.runNo) <= 0 || typeof context.roleRef !== "string" || typeof context.workerRef !== "string")
+    throw new Error("APPROVAL_EXECUTION_GENERATION_REQUIRED");
+  return taskObserver.drive(context.taskId, {
+    trigger: "RECOVERY_RESUME",
+    ref: approvalRef,
+    targetWorkerRef: context.workerRef,
+    nodeId: context.nodeId,
+    runNo: Number(context.runNo)
+  });
+}
 var collaborationCarrier = createCollaborationCarrierApplication({
   task: {
     async getWorkerBinding(taskId, roleRef) {
@@ -14558,18 +14584,31 @@ function runObserverRecovery() {
             (denial) => denial.taskId === candidate.taskId && denial.workerRef === candidate.workerRef
           ))
             continue;
-          const decision = candidate.kind === "RECOVERY_RESUME" ? await taskObserver.drive(candidate.taskId, {
-            trigger: "RECOVERY_RESUME",
-            ref: candidate.executionRef,
-            targetWorkerRef: candidate.workerRef
-          }) : candidate.kind === "UNKNOWN_REALITY" ? await taskObserver.drive(candidate.taskId, void 0, {
-            kind: "UNKNOWN_REALITY",
-            ref: candidate.executionRef,
-            facts: {
-              executionRef: candidate.executionRef,
-              summary: `Execution ${candidate.executionRef} recovery remains UNKNOWN`
+          let decision;
+          if (candidate.kind === "RECOVERY_RESUME") {
+            if (typeof candidate.nodeId !== "string" || typeof candidate.runNo !== "number") {
+              await invokeObserverApplication("execution.ackSignal", {
+                signalRef: candidate.signalRef
+              });
+              continue;
             }
-          }) : null;
+            decision = await taskObserver.drive(candidate.taskId, {
+              trigger: "RECOVERY_RESUME",
+              ref: candidate.executionRef,
+              targetWorkerRef: candidate.workerRef,
+              nodeId: candidate.nodeId,
+              runNo: candidate.runNo
+            });
+          } else if (candidate.kind === "UNKNOWN_REALITY")
+            decision = await taskObserver.drive(candidate.taskId, void 0, {
+              kind: "UNKNOWN_REALITY",
+              ref: candidate.executionRef,
+              facts: {
+                executionRef: candidate.executionRef,
+                summary: `Execution ${candidate.executionRef} recovery remains UNKNOWN`
+              }
+            });
+          else decision = null;
           if (!decision) continue;
           if (decision.kind === "NOOP" && (decision.reason === "BINDING_NOT_READY" || decision.reason === "RESUME_TARGET_NOT_CURRENT_WORKER" || decision.reason === "DIAGNOSTIC_UNAVAILABLE" || decision.reason.startsWith("DIAGNOSTIC_DEFERRED:")))
             continue;
@@ -15029,8 +15068,13 @@ async function executeCommand(command) {
     );
   }
   const tabId = numeric(command.tabId, "TAB_ID");
-  if (command.type === "OBSERVE")
-    return contentCommand(tabId, { operation: "observe" });
+  if (command.type === "OBSERVE") {
+    const value = await contentCommand(tabId, { operation: "observe" });
+    const tab = await chrome.tabs.get(tabId);
+    const observed = parseSnapshotObservation(value, tab);
+    if (!observed) throw new Error("CONTENT_OBSERVATION_INVALID");
+    return observed;
+  }
   if (command.type === "SUBMIT") {
     const before = observationFor(tabId);
     const fingerprint = text(command.fingerprint, "FINGERPRINT");
@@ -15462,12 +15506,10 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
     }
     void invokeApprovalApplication(message.operation, message.input).then(
       (value) => {
-        if ((message.operation === "approval.allow" || message.operation === "approval.deny" || message.operation === "approval.revoke") && isRecord(value) && typeof value.approvalRef === "string" && typeof value.taskId === "string" && typeof value.workerRef === "string")
-          void taskObserver.drive(value.taskId, {
-            trigger: "RECOVERY_RESUME",
-            ref: value.approvalRef,
-            targetWorkerRef: value.workerRef
-          }).catch(() => void 0);
+        if ((message.operation === "approval.allow" || message.operation === "approval.deny" || message.operation === "approval.revoke") && isRecord(value) && typeof value.approvalRef === "string")
+          void resumeAfterApprovalDecision(value.approvalRef).catch(
+            () => void 0
+          );
         sendResponse({ ok: true, value });
       },
       (error46) => sendResponse({

package/dist/src/task-observer.d.ts

@@ -32,6 +32,8 @@ export type TaskObserverResumeSignal = {
     trigger: "EXECUTION_RESULT_READY" | "PEER_REPLY_READY" | "RECOVERY_RESUME";
     ref: string;
     targetWorkerRef: string;
+    nodeId: string;
+    runNo: number;
 };
 export type TaskObserverAnomalySignal = {
     kind: "FACT_CONFLICT" | "UNKNOWN_REALITY" | "STALLED" | "RECOVERY_FAILED";

package/dist/src/task-observer.js

@@ -11,6 +11,12 @@ const NODE_READY_TRIGGER = "NODE_READY";
 const REOPEN_TRIGGER = "REOPEN";
 export function createTaskObserver(options) {
     const advance = async (taskId, resumeSignal, anomalySignal) => {
+        if (resumeSignal &&
+            (typeof resumeSignal.nodeId !== "string" ||
+                resumeSignal.nodeId.length === 0 ||
+                !Number.isInteger(resumeSignal.runNo) ||
+                resumeSignal.runNo <= 0))
+            return { kind: "NOOP", taskId, reason: "RESUME_GENERATION_REQUIRED" };
         const projection = await options.owner.getTaskDriveProjection(taskId);
         // Terminal Tasks stop driving; history and bindings are retained.
         if (projection.terminal || projection.currentNode === null)
@@ -43,11 +49,13 @@ export function createTaskObserver(options) {
             };
         }
         const binding = projection.roleBinding;
-        if (!projection.canDrive ||
-            !binding?.workerRef ||
-            !binding.conversationLocator)
+        if (!binding?.workerRef ||
+            !binding.conversationLocator ||
+            binding.agentPackageRef !== node.requiredAgentPackageRef)
             return { kind: "NOOP", taskId, reason: "BINDING_NOT_READY" };
         if (node.status === "READY") {
+            if (!projection.canDrive)
+                return { kind: "NOOP", taskId, reason: "BINDING_NOT_READY" };
             // WAKE the correct Worker with a minimal trigger; the Worker then
             // performs formal work acceptance through the Task owner. A reopened
             // run reuses the same TaskRoleBinding/Conversation but keeps the reason
@@ -64,6 +72,15 @@ export function createTaskObserver(options) {
             };
         }
         if (resumeSignal) {
+            if (projection.taskStatus !== "ACTIVE" || node.status !== "IN_PROGRESS")
+                return { kind: "NOOP", taskId, reason: "BINDING_NOT_READY" };
+            if (resumeSignal.nodeId !== node.nodeId ||
+                resumeSignal.runNo !== node.runNo)
+                return {
+                    kind: "NOOP",
+                    taskId,
+                    reason: "RESUME_GENERATION_MISMATCH",
+                };
             if (resumeSignal.targetWorkerRef !== binding.workerRef)
                 return {
                     kind: "NOOP",

package/extension/background.ts

@@ -540,6 +540,30 @@ const taskObserver = createTaskObserver({
 	},
 });
 
+async function resumeAfterApprovalDecision(approvalRef: string) {
+	const context = await invokeObserverApplication("approval.executionContext", {
+		approvalRef,
+	});
+	if (
+		!isRecord(context) ||
+		typeof context.executionRef !== "string" ||
+		typeof context.taskId !== "string" ||
+		typeof context.nodeId !== "string" ||
+		!Number.isInteger(context.runNo) ||
+		Number(context.runNo) <= 0 ||
+		typeof context.roleRef !== "string" ||
+		typeof context.workerRef !== "string"
+	)
+		throw new Error("APPROVAL_EXECUTION_GENERATION_REQUIRED");
+	return taskObserver.drive(context.taskId, {
+		trigger: "RECOVERY_RESUME",
+		ref: approvalRef,
+		targetWorkerRef: context.workerRef,
+		nodeId: context.nodeId,
+		runNo: Number(context.runNo),
+	});
+}
+
 const collaborationCarrier = createCollaborationCarrierApplication({
 	task: {
 		async getWorkerBinding(taskId, roleRef) {
@@ -710,23 +734,37 @@ function runObserverRecovery() {
 						)
 					)
 						continue;
-					const decision =
-						candidate.kind === "RECOVERY_RESUME"
-							? await taskObserver.drive(candidate.taskId, {
-									trigger: "RECOVERY_RESUME",
-									ref: candidate.executionRef,
-									targetWorkerRef: candidate.workerRef,
-								})
-							: candidate.kind === "UNKNOWN_REALITY"
-								? await taskObserver.drive(candidate.taskId, undefined, {
-										kind: "UNKNOWN_REALITY",
-										ref: candidate.executionRef,
-										facts: {
-											executionRef: candidate.executionRef,
-											summary: `Execution ${candidate.executionRef} recovery remains UNKNOWN`,
-										},
-									})
-								: null;
+					let decision;
+					if (candidate.kind === "RECOVERY_RESUME") {
+						if (
+							typeof candidate.nodeId !== "string" ||
+							typeof candidate.runNo !== "number"
+						) {
+							// Missing generation is a permanent malformed resume intent, not a
+							// transient binding condition. Dispose it without ever waking a Worker
+							// so an old signal cannot occupy the bounded pending queue forever.
+							await invokeObserverApplication("execution.ackSignal", {
+								signalRef: candidate.signalRef,
+							});
+							continue;
+						}
+						decision = await taskObserver.drive(candidate.taskId, {
+							trigger: "RECOVERY_RESUME",
+							ref: candidate.executionRef,
+							targetWorkerRef: candidate.workerRef,
+							nodeId: candidate.nodeId,
+							runNo: candidate.runNo,
+						});
+					} else if (candidate.kind === "UNKNOWN_REALITY")
+						decision = await taskObserver.drive(candidate.taskId, undefined, {
+							kind: "UNKNOWN_REALITY",
+							ref: candidate.executionRef,
+							facts: {
+								executionRef: candidate.executionRef,
+								summary: `Execution ${candidate.executionRef} recovery remains UNKNOWN`,
+							},
+						});
+					else decision = null;
 					if (!decision) continue;
 					if (
 						decision.kind === "NOOP" &&
@@ -1346,8 +1384,13 @@ async function executeCommand(command: BridgeCommand): Promise<unknown> {
 		);
 	}
 	const tabId = numeric(command.tabId, "TAB_ID");
-	if (command.type === "OBSERVE")
-		return contentCommand(tabId, { operation: "observe" });
+	if (command.type === "OBSERVE") {
+		const value = await contentCommand(tabId, { operation: "observe" });
+		const tab = await chrome.tabs.get(tabId);
+		const observed = parseSnapshotObservation(value, tab);
+		if (!observed) throw new Error("CONTENT_OBSERVATION_INVALID");
+		return observed;
+	}
 	if (command.type === "SUBMIT") {
 		const before = observationFor(tabId);
 		const fingerprint = text(command.fingerprint, "FINGERPRINT");
@@ -1874,17 +1917,11 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
 						message.operation === "approval.deny" ||
 						message.operation === "approval.revoke") &&
 					isRecord(value) &&
-					typeof value.approvalRef === "string" &&
-					typeof value.taskId === "string" &&
-					typeof value.workerRef === "string"
+					typeof value.approvalRef === "string"
 				)
-					void taskObserver
-						.drive(value.taskId, {
-							trigger: "RECOVERY_RESUME",
-							ref: value.approvalRef,
-							targetWorkerRef: value.workerRef,
-						})
-						.catch(() => undefined);
+					void resumeAfterApprovalDecision(value.approvalRef).catch(
+						() => undefined,
+					);
 				sendResponse({ ok: true, value });
 			},
 			(error: unknown) =>

package/manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-browser-extension",
-  "version": "0.1.41",
+  "version": "0.1.43",
   "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.17",
-    "@tomflow/proflow-deployment-conformance": "^0.1.13"
+    "@tomflow/proflow-deployment-conformance": "^0.1.13",
+    "@tomflow/proflow-execution-runtime": "^0.1.18"
   },
   "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.41",
+	"moduleVersion": "0.1.43",
 	"kind": "browser-extension",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",