@tomflow/proflow-task-orchestration 0.1.10 → 0.1.11

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @tomflow/proflow-task-orchestration
 
+## 0.1.11
+
+### 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.10
 
 ### Patch Changes

package/dist/deployment/adapter.d.ts

@@ -4,7 +4,7 @@ declare const success: () => {
         readonly ok: true;
         readonly status: "SUCCEEDED";
         readonly moduleRef: "task-orchestration";
-        readonly moduleVersion: "0.1.10";
+        readonly moduleVersion: "0.1.11";
     };
     observedEffects: string[];
 };
@@ -17,7 +17,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-orchestration";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.11";
             data: {
                 setupStatus: "READY";
                 runtimeStatus: "NOT_APPLICABLE";
@@ -32,7 +32,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-orchestration";
-            moduleVersion: "0.1.10";
+            moduleVersion: "0.1.11";
             data: {
                 docs: string;
             };

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "task-orchestration";
     readonly packageName: "@tomflow/proflow-task-orchestration";
-    readonly moduleVersion: "0.1.10";
+    readonly moduleVersion: "0.1.11";
     readonly kind: "library";
     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: "task-orchestration",
     packageName: "@tomflow/proflow-task-orchestration",
-    moduleVersion: "0.1.10",
+    moduleVersion: "0.1.11",
     kind: "library",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/contracts.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { requiredTaskAgentPackageRefs } from "./model.js";
+import { requiredTaskAgentPackageRefs, taskWaitTypes } from "./model.js";
 export const publicOperationNames = [
     "createTaskGroup",
     "getTaskGroup",
@@ -136,7 +136,7 @@ const schemas = {
     waitNode: z
         .object({
         ...nodeVersion,
-        waitType: id,
+        waitType: z.enum(taskWaitTypes),
         reasonCode: id,
         message: id,
         relatedRef: id.optional(),

package/dist/src/model.d.ts

@@ -1,4 +1,6 @@
 export declare const requiredTaskAgentPackageRefs: readonly ["@tomflow/proflow-agent-product", "@tomflow/proflow-agent-controller-dev", "@tomflow/proflow-agent-test-ops"];
+export declare const taskWaitTypes: readonly ["BUSINESS_CONFIRMATION", "REQUIREMENT_BLOCKED", "EXTERNAL_BUSINESS_DEPENDENCY"];
+export type TaskWaitType = (typeof taskWaitTypes)[number];
 export type TaskGroupStatus = "READY" | "ACTIVE" | "SUCCEEDED";
 export type TaskStatus = "PENDING" | "READY" | "ACTIVE" | "WAITING" | "FAILED" | "PAUSED" | "SUCCEEDED" | "TERMINATED";
 export type NodeStatus = "PENDING" | "READY" | "IN_PROGRESS" | "WAITING" | "FAILED" | "SUCCEEDED" | "TERMINATED";

package/dist/src/model.js

@@ -3,3 +3,8 @@ export const requiredTaskAgentPackageRefs = [
     "@tomflow/proflow-agent-controller-dev",
     "@tomflow/proflow-agent-test-ops",
 ];
+export const taskWaitTypes = [
+    "BUSINESS_CONFIRMATION",
+    "REQUIREMENT_BLOCKED",
+    "EXTERNAL_BUSINESS_DEPENDENCY",
+];

package/dist/src/services.d.ts

@@ -144,6 +144,7 @@ export declare function createTaskServices(options: {
             } | null;
             canDrive: boolean;
             blockedReason: string | null;
+            resumeSignalRef: string | null;
         }>;
         getNodeContext: (raw: unknown) => TaskResult<{
             task: Pick<Task, "taskId" | "title" | "objective" | "status" | "version">;

package/dist/src/services.js

@@ -726,15 +726,24 @@ export function createTaskServices(options) {
             const current = task.currentNodeId
                 ? tx.nodes.get(task.currentNodeId)
                 : undefined;
+            if (task.status === "WAITING" && current?.status !== "WAITING")
+                throw new DomainError("TASK_INVALID_STATE", "A WAITING Task must have a current WAITING Node.");
             if (current?.status === "FAILED")
                 throw new DomainError("TASK_INVALID_STATE", "A failed Node must be explicitly reopened before resume.");
-            if (current?.status === "WAITING")
+            if (current?.status === "WAITING") {
+                const unresolved = tx.messages
+                    .listPending()
+                    .some((message) => message.taskId === task.taskId &&
+                    message.nodeId === current.nodeId);
+                if (unresolved)
+                    throw new DomainError("TASK_BLOCKER_UNRESOLVED", "The current Node still has an unresolved business blocker.");
                 tx.nodes.update({
                     ...current,
                     status: "IN_PROGRESS",
                     version: current.version + 1,
                     updatedAt: timestamp,
                 });
+            }
             const updated = {
                 ...task,
                 status: "ACTIVE",
@@ -910,6 +919,8 @@ export function createTaskServices(options) {
             checkVersion(node.version, input.expectedNodeVersion, "NODE_VERSION_CONFLICT");
             if (task.status !== "ACTIVE")
                 throw new DomainError("TASK_INVALID_STATE", "Task must be ACTIVE before a Node can wait.");
+            if (task.currentNodeId !== node.nodeId)
+                throw new DomainError("NODE_NOT_CURRENT", "Only the current Node can enter WAITING.");
             if (node.status !== "IN_PROGRESS" ||
                 !matchesWorker(input.actorRef, node.workerRef))
                 throw new DomainError(!matchesWorker(input.actorRef, node.workerRef)
@@ -950,10 +961,14 @@ export function createTaskServices(options) {
             const node = requireNode(tx, input.taskId, input.nodeId);
             checkVersion(task.version, input.expectedTaskVersion, "TASK_VERSION_CONFLICT");
             checkVersion(node.version, input.expectedNodeVersion, "NODE_VERSION_CONFLICT");
-            if (!["ACTIVE", "WAITING"].includes(task.status))
-                throw new DomainError("TASK_INVALID_STATE", "Task cannot accept a Node failure in its current state.");
-            if (!["IN_PROGRESS", "WAITING"].includes(node.status))
-                throw new DomainError("NODE_INVALID_STATE", "Node cannot fail.");
+            if (task.status !== "ACTIVE")
+                throw new DomainError("TASK_INVALID_STATE", "Task must be ACTIVE before the current run can fail.");
+            if (task.currentNodeId !== node.nodeId)
+                throw new DomainError("NODE_NOT_CURRENT", "Only the current Node can record a run failure.");
+            if (!matchesWorker(input.actorRef, node.workerRef))
+                throw new DomainError("WORKER_MISMATCH", "Only the bound running Worker may fail the current Node.");
+            if (node.status !== "IN_PROGRESS")
+                throw new DomainError("NODE_INVALID_STATE", "Only the current IN_PROGRESS run can fail.");
             const failedNode = {
                 ...node,
                 status: "FAILED",
@@ -1116,6 +1131,13 @@ export function createTaskServices(options) {
             else if (!terminal && !roleBinding?.workerRef)
                 blockedReason = "TASK_ROLE_BINDING_REQUIRED";
             const canDrive = !terminal && blockedReason === null;
+            let durableResumeEventId;
+            if (task.status === "ACTIVE" && currentNode?.status === "IN_PROGRESS")
+                for (const taskEvent of tx.events.listByTask(task.taskId))
+                    if (taskEvent.eventType === "TASK_RESUMED" &&
+                        taskEvent.taskVersion === task.version &&
+                        taskEvent.eventId !== undefined)
+                        durableResumeEventId = taskEvent.eventId;
             return {
                 taskId: task.taskId,
                 taskStatus: task.status,
@@ -1140,6 +1162,9 @@ export function createTaskServices(options) {
                     : null,
                 canDrive,
                 blockedReason,
+                resumeSignalRef: durableResumeEventId === undefined
+                    ? null
+                    : `task-event:${durableResumeEventId}`,
             };
         }),
         getNodeContext: (raw) => queryWithDocumentRecovery("getNodeContext", raw, (tx, input) => {

package/dist/src/transitions.js

@@ -7,7 +7,7 @@ const taskTransitions = {
     READY: ["ACTIVE", "TERMINATED"],
     ACTIVE: ["WAITING", "PAUSED", "FAILED", "SUCCEEDED", "TERMINATED"],
     WAITING: ["ACTIVE", "PAUSED", "TERMINATED"],
-    FAILED: ["PAUSED", "TERMINATED"],
+    FAILED: ["TERMINATED"],
     PAUSED: ["ACTIVE", "TERMINATED"],
     SUCCEEDED: [],
     TERMINATED: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-task-orchestration",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -23,8 +23,8 @@
     "@tomflow/proflow-module-contract": "^0.1.13"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.13",
     "@tomflow/proflow-task-migration-runner": "^0.1.11",
+    "@tomflow/proflow-deployment-conformance": "^0.1.13",
     "@tomflow/proflow-task-store-sqlite": "^0.1.11"
   },
   "description": "Owns the Task & Orchestration public contract, domain rules and application services.",

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "task-orchestration",
 	"packageName": "@tomflow/proflow-task-orchestration",
-	"moduleVersion": "0.1.10",
+	"moduleVersion": "0.1.11",
 	"kind": "library",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",