@tomflow/proflow-execution-browser-extension 0.1.44 → 0.1.45

package/CHANGELOG.md

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

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

package/dist/extension/background.js

@@ -14137,16 +14137,23 @@ function createTaskObserver(options) {
         conversationLocator: binding.conversationLocator
       };
     }
-    if (resumeSignal) {
+    const effectiveResumeSignal = resumeSignal ?? (projection.resumeSignalRef && projection.taskStatus === "ACTIVE" && node.status === "IN_PROGRESS" ? {
+      trigger: "TASK_RESUMED",
+      ref: projection.resumeSignalRef,
+      targetWorkerRef: binding.workerRef,
+      nodeId: node.nodeId,
+      runNo: node.runNo
+    } : void 0);
+    if (effectiveResumeSignal) {
       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)
+      if (effectiveResumeSignal.nodeId !== node.nodeId || effectiveResumeSignal.runNo !== node.runNo)
         return {
           kind: "NOOP",
           taskId,
           reason: "RESUME_GENERATION_MISMATCH"
         };
-      if (resumeSignal.targetWorkerRef !== binding.workerRef)
+      if (effectiveResumeSignal.targetWorkerRef !== binding.workerRef)
         return {
           kind: "NOOP",
           taskId,
@@ -14159,9 +14166,9 @@ function createTaskObserver(options) {
         runNo: node.runNo,
         roleRef: binding.roleRef,
         workerRef: binding.workerRef,
-        trigger: resumeSignal.trigger,
+        trigger: effectiveResumeSignal.trigger,
         conversationLocator: binding.conversationLocator,
-        underlyingRef: resumeSignal.ref
+        underlyingRef: effectiveResumeSignal.ref
       };
     }
     return { kind: "NOOP", taskId, reason: "NO_NEXT_STEP" };
@@ -14457,6 +14464,14 @@ var taskObserver = createTaskObserver({
     }
   }
 });
+async function resumeTaskWorker(taskId) {
+  const projection = await invokeObserverApplication("task.projection", {
+    taskId
+  });
+  if (projection.taskId !== taskId || projection.taskStatus !== "ACTIVE" || projection.currentNode?.status !== "IN_PROGRESS" || !projection.resumeSignalRef)
+    throw new Error("TASK_RESUMED_OWNER_FACTS_INVALID");
+  return taskObserver.drive(taskId);
+}
 async function resumeAfterApprovalDecision(approvalRef) {
   const context = await invokeObserverApplication("approval.executionContext", {
     approvalRef
@@ -15042,6 +15057,8 @@ async function executeCommand(command) {
     void runObserverRecovery();
     return { scheduled: true };
   }
+  if (command.type === "TASK_OBSERVER_RESUME")
+    return resumeTaskWorker(text(command.taskId, "TASK_ID"));
   if (command.type === "CARRIER_ATTENTION_ACTION") {
     if (command.action !== "allowOnce" && command.action !== "deny")
       throw new Error("ATTENTION_ACTION_INVALID");
@@ -15525,8 +15542,10 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
       return;
     }
     void invokeTaskApplication(message.operation, message.input).then(
-      (value) => {
-        void runObserverRecovery();
+      async (value) => {
+        if (message.operation === "task.resume")
+          await resumeTaskWorker(text(message.input?.taskId, "TASK_ID"));
+        else void runObserverRecovery();
         sendResponse({ ok: true, value });
       },
       (error46) => sendResponse({

package/dist/extension/tasks.js

@@ -70,7 +70,9 @@ const nodesTarget = element("#nodes");
 const errorTarget = element("#error");
 const resultTarget = element("#result");
 const startButton = element("#start-task");
+const resumeButton = element("#resume-task");
 const ensureWorkersButton = element("#ensure-workers");
+const pendingMessagesTarget = element("#pending-messages");
 const newTaskForm = element("#new-task-form");
 const approvalsTarget = element("#approvals");
 const carrierAttentionsTarget = element("#carrier-attentions");
@@ -236,8 +238,38 @@ async function loadTask(taskId) {
     selected = (await taskApplication("task.get", { taskId }));
     selectedTarget.textContent = `${selected.taskId} · ${selected.status} · v${selected.version}`;
     startButton.disabled = selected.status !== "READY";
+    resumeButton.hidden = !["WAITING", "PAUSED"].includes(selected.status);
+    resumeButton.disabled =
+        selected.status === "WAITING" && selected.pendingMessages.length > 0;
     ensureWorkersButton.disabled =
         selected.status === "SUCCEEDED" || selected.status === "TERMINATED";
+    pendingMessagesTarget.replaceChildren();
+    for (const message of selected.pendingMessages) {
+        const row = document.createElement("div");
+        row.className = "task";
+        const label = document.createElement("div");
+        label.textContent = `${message.messageType} · ${message.reasonCode}`;
+        const detail = document.createElement("div");
+        detail.className = "meta";
+        detail.textContent = message.message;
+        const acknowledge = document.createElement("button");
+        acknowledge.type = "button";
+        acknowledge.textContent = "Resolve blocker";
+        acknowledge.addEventListener("click", () => {
+            void run(async () => {
+                if (!selected)
+                    return;
+                await taskApplication("message.acknowledge", {
+                    messageId: message.messageId,
+                    resolution: "Resolved from Extension Task Page",
+                    idempotencyKey: requestId("extension-acknowledge-message"),
+                });
+                await loadTask(selected.taskId);
+            });
+        });
+        row.append(label, detail, acknowledge);
+        pendingMessagesTarget.append(row);
+    }
     nodesTarget.replaceChildren();
     for (const node of selected.nodes) {
         const row = document.createElement("div");
@@ -245,7 +277,7 @@ async function loadTask(taskId) {
         const label = document.createElement("span");
         label.textContent = `${node.title} · ${node.status} · run ${node.runNo}`;
         row.append(label);
-        if (["SUCCEEDED", "FAILED", "WAITING"].includes(node.status)) {
+        if (["SUCCEEDED", "FAILED"].includes(node.status)) {
             const reopen = document.createElement("button");
             reopen.type = "button";
             reopen.textContent = "Reopen";
@@ -392,6 +424,27 @@ startButton.addEventListener("click", () => {
         }
     });
 });
+resumeButton.addEventListener("click", () => {
+    void run(async () => {
+        if (!selected)
+            return;
+        setBusy(resumeButton, true);
+        try {
+            await taskApplication("task.resume", {
+                taskId: selected.taskId,
+                expectedTaskVersion: selected.version,
+                idempotencyKey: requestId("extension-resume-task"),
+            });
+            await loadTask(selected.taskId);
+            await refreshTasks();
+        }
+        finally {
+            resumeButton.disabled =
+                selected?.status === "WAITING" &&
+                    (selected.pendingMessages?.length ?? 0) > 0;
+        }
+    });
+});
 ensureWorkersButton.addEventListener("click", () => {
     void run(async () => {
         if (!selected)

package/dist/src/bridge.js

@@ -268,6 +268,14 @@ export async function createBrowserRealityBridgeServer(options) {
                         ? await options.taskWeb.invokeTask(body.operation, body.input)
                         : await options.taskWeb.invokeApproval(body.operation, body.input);
                     if (taskRequest &&
+                        body.operation === "task.resume" &&
+                        commandConsumerReady()) {
+                        void requestCommand({
+                            type: "TASK_OBSERVER_RESUME",
+                            taskId: stringField(body.input, "taskId"),
+                        }).catch(() => undefined);
+                    }
+                    else if (taskRequest &&
                         taskWebObserverRecoveryOperations.has(body.operation) &&
                         commandConsumerReady()) {
                         // The Task mutation is already durable and must not be coupled to

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

@@ -27,9 +27,10 @@ export type TaskDriveProjection = {
     } | null;
     canDrive: boolean;
     blockedReason: string | null;
+    resumeSignalRef: string | null;
 };
 export type TaskObserverResumeSignal = {
-    trigger: "EXECUTION_RESULT_READY" | "PEER_REPLY_READY" | "RECOVERY_RESUME";
+    trigger: "EXECUTION_RESULT_READY" | "PEER_REPLY_READY" | "RECOVERY_RESUME" | "TASK_RESUMED";
     ref: string;
     targetWorkerRef: string;
     nodeId: string;

package/dist/src/task-observer.js

@@ -71,17 +71,29 @@ export function createTaskObserver(options) {
                 conversationLocator: binding.conversationLocator,
             };
         }
-        if (resumeSignal) {
+        const effectiveResumeSignal = resumeSignal ??
+            (projection.resumeSignalRef &&
+                projection.taskStatus === "ACTIVE" &&
+                node.status === "IN_PROGRESS"
+                ? {
+                    trigger: "TASK_RESUMED",
+                    ref: projection.resumeSignalRef,
+                    targetWorkerRef: binding.workerRef,
+                    nodeId: node.nodeId,
+                    runNo: node.runNo,
+                }
+                : undefined);
+        if (effectiveResumeSignal) {
             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)
+            if (effectiveResumeSignal.nodeId !== node.nodeId ||
+                effectiveResumeSignal.runNo !== node.runNo)
                 return {
                     kind: "NOOP",
                     taskId,
                     reason: "RESUME_GENERATION_MISMATCH",
                 };
-            if (resumeSignal.targetWorkerRef !== binding.workerRef)
+            if (effectiveResumeSignal.targetWorkerRef !== binding.workerRef)
                 return {
                     kind: "NOOP",
                     taskId,
@@ -94,9 +106,9 @@ export function createTaskObserver(options) {
                 runNo: node.runNo,
                 roleRef: binding.roleRef,
                 workerRef: binding.workerRef,
-                trigger: resumeSignal.trigger,
+                trigger: effectiveResumeSignal.trigger,
                 conversationLocator: binding.conversationLocator,
-                underlyingRef: resumeSignal.ref,
+                underlyingRef: effectiveResumeSignal.ref,
             };
         }
         return { kind: "NOOP", taskId, reason: "NO_NEXT_STEP" };

package/extension/background.ts

@@ -29,6 +29,7 @@ import {
 import {
 	createTaskObserver,
 	type TaskDriveProjection,
+	type TaskObserverDecision,
 	type TaskObserverDiagnosticAssessment,
 	type TaskObserverDiagnosticFailure,
 } from "../src/task-observer.js";
@@ -77,7 +78,8 @@ type BridgeCommand = {
 		| "SCREENSHOT"
 		| "PERFORM"
 		| "CARRIER_ATTENTION_ACTION"
-		| "TASK_OBSERVER_RECOVER";
+		| "TASK_OBSERVER_RECOVER"
+		| "TASK_OBSERVER_RESUME";
 	tabId?: number;
 	url?: string;
 	text?: string;
@@ -85,6 +87,7 @@ type BridgeCommand = {
 	request?: Record<string, unknown>;
 	attentionRef?: string;
 	action?: "allowOnce" | "deny";
+	taskId?: string;
 };
 type ContentSnapshotRequest = { type: "PROFLOW_PAGE_SNAPSHOT_REQUEST" };
 type ContentCommand = {
@@ -540,6 +543,20 @@ const taskObserver = createTaskObserver({
 	},
 });
 
+async function resumeTaskWorker(taskId: string) {
+	const projection = (await invokeObserverApplication("task.projection", {
+		taskId,
+	})) as TaskDriveProjection;
+	if (
+		projection.taskId !== taskId ||
+		projection.taskStatus !== "ACTIVE" ||
+		projection.currentNode?.status !== "IN_PROGRESS" ||
+		!projection.resumeSignalRef
+	)
+		throw new Error("TASK_RESUMED_OWNER_FACTS_INVALID");
+	return taskObserver.drive(taskId);
+}
+
 async function resumeAfterApprovalDecision(approvalRef: string) {
 	const context = await invokeObserverApplication("approval.executionContext", {
 		approvalRef,
@@ -734,7 +751,7 @@ function runObserverRecovery() {
 						)
 					)
 						continue;
-					let decision;
+					let decision: TaskObserverDecision | null;
 					if (candidate.kind === "RECOVERY_RESUME") {
 						if (
 							typeof candidate.nodeId !== "string" ||
@@ -1355,6 +1372,8 @@ async function executeCommand(command: BridgeCommand): Promise<unknown> {
 		void runObserverRecovery();
 		return { scheduled: true };
 	}
+	if (command.type === "TASK_OBSERVER_RESUME")
+		return resumeTaskWorker(text(command.taskId, "TASK_ID"));
 	if (command.type === "CARRIER_ATTENTION_ACTION") {
 		if (command.action !== "allowOnce" && command.action !== "deny")
 			throw new Error("ATTENTION_ACTION_INVALID");
@@ -1941,8 +1960,10 @@ chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
 			return;
 		}
 		void invokeTaskApplication(message.operation, message.input).then(
-			(value) => {
-				void runObserverRecovery();
+			async (value) => {
+				if (message.operation === "task.resume")
+					await resumeTaskWorker(text(message.input?.taskId, "TASK_ID"));
+				else void runObserverRecovery();
 				sendResponse({ ok: true, value });
 			},
 			(error: unknown) =>

package/extension/tasks.html

@@ -51,7 +51,9 @@
 			<h2>Selected Task</h2>
 			<div id="selected-task" class="meta">None selected.</div>
 			<button id="start-task" type="button" disabled>Confirm / Start</button>
+			<button id="resume-task" type="button" hidden>Resume</button>
 			<button id="ensure-workers" type="button" disabled>Recover missing Workers</button>
+			<div id="pending-messages"></div>
 			<div id="nodes"></div>
 		</section>
 

package/extension/tasks.ts

@@ -108,6 +108,13 @@ type TaskView = TaskSummary & {
 		runNo: number;
 		version: number;
 	}>;
+	pendingMessages: Array<{
+		messageId: string;
+		nodeId: string | null;
+		messageType: string;
+		reasonCode: string;
+		message: string;
+	}>;
 };
 
 function element<T extends HTMLElement>(selector: string): T {
@@ -124,7 +131,9 @@ const nodesTarget = element<HTMLElement>("#nodes");
 const errorTarget = element<HTMLElement>("#error");
 const resultTarget = element<HTMLElement>("#result");
 const startButton = element<HTMLButtonElement>("#start-task");
+const resumeButton = element<HTMLButtonElement>("#resume-task");
 const ensureWorkersButton = element<HTMLButtonElement>("#ensure-workers");
+const pendingMessagesTarget = element<HTMLElement>("#pending-messages");
 const newTaskForm = element<HTMLFormElement>("#new-task-form");
 const approvalsTarget = element<HTMLElement>("#approvals");
 const carrierAttentionsTarget = element<HTMLElement>("#carrier-attentions");
@@ -342,8 +351,37 @@ async function loadTask(taskId: string) {
 	selected = (await taskApplication("task.get", { taskId })) as TaskView;
 	selectedTarget.textContent = `${selected.taskId} · ${selected.status} · v${selected.version}`;
 	startButton.disabled = selected.status !== "READY";
+	resumeButton.hidden = !["WAITING", "PAUSED"].includes(selected.status);
+	resumeButton.disabled =
+		selected.status === "WAITING" && selected.pendingMessages.length > 0;
 	ensureWorkersButton.disabled =
 		selected.status === "SUCCEEDED" || selected.status === "TERMINATED";
+	pendingMessagesTarget.replaceChildren();
+	for (const message of selected.pendingMessages) {
+		const row = document.createElement("div");
+		row.className = "task";
+		const label = document.createElement("div");
+		label.textContent = `${message.messageType} · ${message.reasonCode}`;
+		const detail = document.createElement("div");
+		detail.className = "meta";
+		detail.textContent = message.message;
+		const acknowledge = document.createElement("button");
+		acknowledge.type = "button";
+		acknowledge.textContent = "Resolve blocker";
+		acknowledge.addEventListener("click", () => {
+			void run(async () => {
+				if (!selected) return;
+				await taskApplication("message.acknowledge", {
+					messageId: message.messageId,
+					resolution: "Resolved from Extension Task Page",
+					idempotencyKey: requestId("extension-acknowledge-message"),
+				});
+				await loadTask(selected.taskId);
+			});
+		});
+		row.append(label, detail, acknowledge);
+		pendingMessagesTarget.append(row);
+	}
 	nodesTarget.replaceChildren();
 	for (const node of selected.nodes) {
 		const row = document.createElement("div");
@@ -351,7 +389,7 @@ async function loadTask(taskId: string) {
 		const label = document.createElement("span");
 		label.textContent = `${node.title} · ${node.status} · run ${node.runNo}`;
 		row.append(label);
-		if (["SUCCEEDED", "FAILED", "WAITING"].includes(node.status)) {
+		if (["SUCCEEDED", "FAILED"].includes(node.status)) {
 			const reopen = document.createElement("button");
 			reopen.type = "button";
 			reopen.textContent = "Reopen";
@@ -515,6 +553,26 @@ startButton.addEventListener("click", () => {
 	});
 });
 
+resumeButton.addEventListener("click", () => {
+	void run(async () => {
+		if (!selected) return;
+		setBusy(resumeButton, true);
+		try {
+			await taskApplication("task.resume", {
+				taskId: selected.taskId,
+				expectedTaskVersion: selected.version,
+				idempotencyKey: requestId("extension-resume-task"),
+			});
+			await loadTask(selected.taskId);
+			await refreshTasks();
+		} finally {
+			resumeButton.disabled =
+				selected?.status === "WAITING" &&
+				(selected.pendingMessages?.length ?? 0) > 0;
+		}
+	});
+});
+
 ensureWorkersButton.addEventListener("click", () => {
 	void run(async () => {
 		if (!selected) return;

package/manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-execution-browser-extension",
-  "version": "0.1.44",
+  "version": "0.1.45",
   "description": "Execution-owned MV3 Browser executor, evidence provider and browser application surface.",
   "type": "module",
   "publishConfig": {
@@ -27,8 +27,8 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-execution-contracts": "^0.1.10",
-    "@tomflow/proflow-module-contract": "^0.1.13"
+    "@tomflow/proflow-module-contract": "^0.1.13",
+    "@tomflow/proflow-execution-contracts": "^0.1.10"
   },
   "devDependencies": {
     "@tomflow/proflow-deployment-conformance": "^0.1.13",

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