@fluidgrids/workflows 2026.1027.1 → 2026.1028.2

package/fixtures/histories/continue-as-new-suggested.history.json

@@ -0,0 +1,352 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "continue-as-new-suggested",
+  "description": "A loop runs until continueAsNewSuggested turns true (40-event cap); replay sees the value each task saw.",
+  "source": "src/continue-as-new.ts",
+  "info": {
+    "workspaceId": "test-workspace",
+    "taskQueue": "managed",
+    "attempt": 1,
+    "startedAt": "2026-01-01T00:00:00.000Z",
+    "runStartedAt": "2026-01-01T00:00:00.000Z",
+    "historyLimit": {
+      "events": 40,
+      "bytes": 16777216
+    },
+    "runId": "run-1"
+  },
+  "nowMs": 1767225606000,
+  "workflowFn": "suggested",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "suggested",
+        "input": {
+          "round": 0
+        },
+        "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": 1000,
+        "fireAt": "2026-01-01T00:00:01.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "TIMER_FIRED",
+      "payload": {
+        "timerId": "t1"
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z"
+    },
+    {
+      "seq": 7,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z"
+    },
+    {
+      "seq": 8,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 10,
+      "type": "TIMER_STARTED",
+      "payload": {
+        "timerId": "t2",
+        "durationMs": 1000,
+        "fireAt": "2026-01-01T00:00:02.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 11,
+      "type": "TIMER_FIRED",
+      "payload": {
+        "timerId": "t2"
+      },
+      "createdAt": "2026-01-01T00:00:02.000Z"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:02.000Z"
+    },
+    {
+      "seq": 13,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-3",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:02.000Z"
+    },
+    {
+      "seq": 14,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:02.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 15,
+      "type": "TIMER_STARTED",
+      "payload": {
+        "timerId": "t3",
+        "durationMs": 1000,
+        "fireAt": "2026-01-01T00:00:03.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:02.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 16,
+      "type": "TIMER_FIRED",
+      "payload": {
+        "timerId": "t3"
+      },
+      "createdAt": "2026-01-01T00:00:03.000Z"
+    },
+    {
+      "seq": 17,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-4"
+      },
+      "createdAt": "2026-01-01T00:00:03.000Z"
+    },
+    {
+      "seq": 18,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-4",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:03.000Z"
+    },
+    {
+      "seq": 19,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-4"
+      },
+      "createdAt": "2026-01-01T00:00:03.000Z",
+      "taskId": "run-1-task-4"
+    },
+    {
+      "seq": 20,
+      "type": "TIMER_STARTED",
+      "payload": {
+        "timerId": "t4",
+        "durationMs": 1000,
+        "fireAt": "2026-01-01T00:00:04.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:03.000Z",
+      "taskId": "run-1-task-4"
+    },
+    {
+      "seq": 21,
+      "type": "TIMER_FIRED",
+      "payload": {
+        "timerId": "t4"
+      },
+      "createdAt": "2026-01-01T00:00:04.000Z"
+    },
+    {
+      "seq": 22,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-5"
+      },
+      "createdAt": "2026-01-01T00:00:04.000Z"
+    },
+    {
+      "seq": 23,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-5",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:04.000Z"
+    },
+    {
+      "seq": 24,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-5"
+      },
+      "createdAt": "2026-01-01T00:00:04.000Z",
+      "taskId": "run-1-task-5"
+    },
+    {
+      "seq": 25,
+      "type": "TIMER_STARTED",
+      "payload": {
+        "timerId": "t5",
+        "durationMs": 1000,
+        "fireAt": "2026-01-01T00:00:05.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:04.000Z",
+      "taskId": "run-1-task-5"
+    },
+    {
+      "seq": 26,
+      "type": "TIMER_FIRED",
+      "payload": {
+        "timerId": "t5"
+      },
+      "createdAt": "2026-01-01T00:00:05.000Z"
+    },
+    {
+      "seq": 27,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-6"
+      },
+      "createdAt": "2026-01-01T00:00:05.000Z"
+    },
+    {
+      "seq": 28,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-6",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:05.000Z"
+    },
+    {
+      "seq": 29,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-6"
+      },
+      "createdAt": "2026-01-01T00:00:05.000Z",
+      "taskId": "run-1-task-6"
+    },
+    {
+      "seq": 30,
+      "type": "TIMER_STARTED",
+      "payload": {
+        "timerId": "t6",
+        "durationMs": 1000,
+        "fireAt": "2026-01-01T00:00:06.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:05.000Z",
+      "taskId": "run-1-task-6"
+    },
+    {
+      "seq": 31,
+      "type": "TIMER_FIRED",
+      "payload": {
+        "timerId": "t6"
+      },
+      "createdAt": "2026-01-01T00:00:06.000Z"
+    },
+    {
+      "seq": 32,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-7"
+      },
+      "createdAt": "2026-01-01T00:00:06.000Z"
+    },
+    {
+      "seq": 33,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-7",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:06.000Z"
+    },
+    {
+      "seq": 34,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-7"
+      },
+      "createdAt": "2026-01-01T00:00:06.000Z",
+      "taskId": "run-1-task-7"
+    },
+    {
+      "seq": 35,
+      "type": "WORKFLOW_CONTINUED_AS_NEW",
+      "payload": {
+        "input": {
+          "round": 1
+        },
+        "options": {
+          "taskQueue": "managed"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:06.000Z",
+      "taskId": "run-1-task-7"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/details-and-context.history.json

@@ -0,0 +1,176 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "details-and-context",
+  "description": "setCurrentDetails() markers and an UPSERT_CONTEXT command; log lines are not part of history.",
+  "source": "src/side-effects.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": "detailsAndContext",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "detailsAndContext",
+        "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": "MARKER_RECORDED",
+      "payload": {
+        "markerId": "m1",
+        "data": {
+          "currentDetails": "**step 1** of 2"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "CONTEXT_UPSERTED",
+      "payload": {
+        "entries": {
+          "customer": "c-9"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 7,
+      "type": "ACTIVITY_SCHEDULED",
+      "payload": {
+        "activityId": "a1",
+        "kind": "node",
+        "nodeType": "internal:http",
+        "operation": "execute",
+        "args": {
+          "url": "https://example.test/step-2"
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 8,
+      "type": "ACTIVITY_STARTED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "ACTIVITY_COMPLETED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1,
+        "result": {
+          "status": 200,
+          "url": "https://example.test/step-2"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 10,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 11,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 13,
+      "type": "MARKER_RECORDED",
+      "payload": {
+        "markerId": "m2",
+        "data": {
+          "currentDetails": "**done**"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 14,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "ok": true
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/deterministic-values.history.json

@@ -0,0 +1,128 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "deterministic-values",
+  "description": "ctx.now(), ctx.random(), ctx.uuid() and the Date/Math.random shims give the same values on replay.",
+  "source": "src/side-effects.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": 1767225660000,
+  "workflowFn": "deterministicValues",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "deterministicValues",
+        "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": 60000,
+        "fireAt": "2026-01-01T00:01:00.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "TIMER_FIRED",
+      "payload": {
+        "timerId": "t1"
+      },
+      "createdAt": "2026-01-01T00:01:00.000Z"
+    },
+    {
+      "seq": 7,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:01:00.000Z"
+    },
+    {
+      "seq": 8,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:01:00.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:01:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 10,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "first": {
+            "now": 1767225600000,
+            "random": 0.06483014556579292,
+            "uuid": "a71641aa-bc1d-46be-a51a-96337f391762"
+          },
+          "later": 1767225660000,
+          "shimmed": {
+            "dateNow": 1767225660000,
+            "mathRandom": 0.501738199731335,
+            "iso": "2026-01-01T00:01:00.000Z"
+          }
+        }
+      },
+      "createdAt": "2026-01-01T00:01:00.000Z",
+      "taskId": "run-1-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}