@fluidgrids/workflows 2026.1028.2 → 2026.1030.1

package/fixtures/histories/benign-failure.history.json

@@ -0,0 +1,146 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "benign-failure",
+  "description": "An expected failure with category BENIGN keeps its category in ACTIVITY_FAILED and on the ApplicationError the code catches.",
+  "source": "src/parity-activities.ts",
+  "info": {
+    "workspaceId": "test-workspace",
+    "taskQueue": "managed",
+    "attempt": 1,
+    "startedAt": "2026-01-01T00:00:00.000Z",
+    "runStartedAt": "2026-01-01T00:00:00.000Z",
+    "runId": "run-1"
+  },
+  "nowMs": 1767225600000,
+  "workflowFn": "benign",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "benign",
+        "input": null,
+        "taskQueue": "managed",
+        "randomnessSeed": "run-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 5,
+      "type": "ACTIVITY_SCHEDULED",
+      "payload": {
+        "activityId": "a1",
+        "kind": "node",
+        "nodeType": "internal:http",
+        "operation": "execute",
+        "args": {
+          "url": "https://example.test/maybe-missing"
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "ACTIVITY_STARTED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 7,
+      "type": "ACTIVITY_FAILED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1,
+        "failure": {
+          "errorType": "VALIDATION",
+          "message": "not found",
+          "type": "NotFound",
+          "source": "node:internal:http",
+          "nonRetryable": true,
+          "category": "BENIGN"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 8,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 10,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 11,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "found": false,
+          "benign": true
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/cancel-activity-try-cancel.history.json

@@ -0,0 +1,150 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "cancel-activity-try-cancel",
+  "description": "A scope timeout cancels a queued activity with cancellationType TRY_CANCEL: REQUEST_CANCEL_ACTIVITY is sent and the awaitable rejects at once.",
+  "source": "src/parity-activities.ts",
+  "info": {
+    "workspaceId": "test-workspace",
+    "taskQueue": "managed",
+    "attempt": 1,
+    "startedAt": "2026-01-01T00:00:00.000Z",
+    "runStartedAt": "2026-01-01T00:00:00.000Z",
+    "runId": "run-1"
+  },
+  "nowMs": 1767225610000,
+  "workflowFn": "tryCancel",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "tryCancel",
+        "input": null,
+        "taskQueue": "managed",
+        "randomnessSeed": "run-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 5,
+      "type": "TIMER_STARTED",
+      "payload": {
+        "timerId": "t1",
+        "durationMs": 10000,
+        "fireAt": "2026-01-01T00:00:10.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "ACTIVITY_SCHEDULED",
+      "payload": {
+        "activityId": "a1",
+        "kind": "node",
+        "nodeType": "store/slack",
+        "operation": "sendMessage",
+        "args": {
+          "channel": "#ops",
+          "text": "slow"
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000
+        },
+        "nodeVersion": "1.0.0",
+        "cancellationType": "TRY_CANCEL"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 7,
+      "type": "TIMER_FIRED",
+      "payload": {
+        "timerId": "t1"
+      },
+      "createdAt": "2026-01-01T00:00:10.000Z"
+    },
+    {
+      "seq": 8,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:10.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:10.000Z"
+    },
+    {
+      "seq": 10,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:10.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 11,
+      "type": "ACTIVITY_CANCEL_REQUESTED",
+      "payload": {
+        "activityId": "a1"
+      },
+      "createdAt": "2026-01-01T00:00:10.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "outcome": "cancelled"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:10.000Z",
+      "taskId": "run-1-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/child-cancel-wait-requested.history.json

@@ -0,0 +1,217 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "child-cancel-wait-requested",
+  "description": "A scope timeout cancels a child awaited with cancellationType WAIT_CANCELLATION_REQUESTED: the awaitable rejects once EXTERNAL_RUN_CANCEL_RESOLVED arrives, before the child has ended.",
+  "source": "src/parity-children.ts",
+  "info": {
+    "workspaceId": "test-workspace",
+    "taskQueue": "managed",
+    "attempt": 1,
+    "startedAt": "2026-01-01T00:00:00.000Z",
+    "runStartedAt": "2026-01-01T00:00:00.000Z",
+    "runId": "run-1"
+  },
+  "nowMs": 1767229200000,
+  "workflowFn": "childCancelWaitRequested",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "childCancelWaitRequested",
+        "input": null,
+        "taskQueue": "managed",
+        "randomnessSeed": "run-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 5,
+      "type": "TIMER_STARTED",
+      "payload": {
+        "timerId": "t1",
+        "durationMs": 3600000,
+        "fireAt": "2026-01-01T01:00:00.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "CHILD_RUN_INITIATED",
+      "payload": {
+        "childId": "c1",
+        "workflowFn": "longChild",
+        "input": null,
+        "options": {
+          "parentClosePolicy": "TERMINATE",
+          "cancellationType": "WAIT_CANCELLATION_REQUESTED"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 7,
+      "type": "CHILD_RUN_STARTED",
+      "payload": {
+        "childId": "c1",
+        "childRunId": "run-2",
+        "executionKind": "DURABLE_FN"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 8,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 10,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 11,
+      "type": "TIMER_FIRED",
+      "payload": {
+        "timerId": "t1"
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z"
+    },
+    {
+      "seq": 13,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-3",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z"
+    },
+    {
+      "seq": 14,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 15,
+      "type": "EXTERNAL_RUN_CANCEL_REQUESTED",
+      "payload": {
+        "externalId": "x1",
+        "target": {
+          "childId": "c1"
+        }
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 16,
+      "type": "EXTERNAL_RUN_CANCEL_RESOLVED",
+      "payload": {
+        "externalId": "x1",
+        "ok": true,
+        "targetRunId": "run-2"
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z"
+    },
+    {
+      "seq": 17,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-4"
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z"
+    },
+    {
+      "seq": 18,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-4",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z"
+    },
+    {
+      "seq": 19,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-4"
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z",
+      "taskId": "run-1-task-4"
+    },
+    {
+      "seq": 20,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "outcome": "cancel requested"
+        }
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z",
+      "taskId": "run-1-task-4"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/child-options-roundtrip.history.json

@@ -0,0 +1,192 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "child-options-roundtrip",
+  "description": "Every child option of 11 §2.35 (workflow id policies, timeouts, retry, memo, summary, details, priority, versioning) lands in CHILD_RUN_INITIATED.options.",
+  "source": "src/parity-children.ts",
+  "info": {
+    "workspaceId": "test-workspace",
+    "taskQueue": "managed",
+    "attempt": 1,
+    "startedAt": "2026-01-01T00:00:00.000Z",
+    "runStartedAt": "2026-01-01T00:00:00.000Z",
+    "runId": "run-1"
+  },
+  "nowMs": 1767225600000,
+  "workflowFn": "childOptionsRoundtrip",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "childOptionsRoundtrip",
+        "input": null,
+        "taskQueue": "managed",
+        "randomnessSeed": "run-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 5,
+      "type": "CHILD_RUN_INITIATED",
+      "payload": {
+        "childId": "c1",
+        "workflowFn": "optionsChild",
+        "input": null,
+        "options": {
+          "parentClosePolicy": "REQUEST_CANCEL",
+          "cancellationType": "TRY_CANCEL",
+          "taskQueue": "managed",
+          "workflowId": "order-42",
+          "priority": 2,
+          "summary": "child for order 42",
+          "details": "## Order 42",
+          "context": {
+            "order": 42
+          },
+          "retry": {
+            "initialDelayMs": 2000,
+            "backoffMultiplier": 2,
+            "maxDelayMs": 200000,
+            "maxAttempts": 3
+          },
+          "versioningBehavior": "PINNED",
+          "idReusePolicy": "REJECT_DUPLICATE",
+          "idConflictPolicy": "FAIL",
+          "executionTimeout": 86400000,
+          "runTimeout": 3600000,
+          "workflowTaskTimeout": 20000
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "CHILD_RUN_STARTED",
+      "payload": {
+        "childId": "c1",
+        "childRunId": "run-2",
+        "executionKind": "DURABLE_FN"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 7,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 8,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 10,
+      "type": "CHILD_RUN_COMPLETED",
+      "payload": {
+        "childId": "c1",
+        "childRunId": "run-2",
+        "result": {
+          "workflowId": "order-42",
+          "summary": "child for order 42",
+          "memo": {
+            "order": 42
+          },
+          "attempt": 1
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 11,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-3",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 13,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 14,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "workflowId": "order-42",
+          "summary": "child for order 42",
+          "memo": {
+            "order": 42
+          },
+          "attempt": 1
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}