@fluidgrids/workflows 2026.1028.2 → 2026.1030.1

package/fixtures/histories/handler-drain-warn.history.json

@@ -0,0 +1,222 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "handler-drain-warn",
+  "description": "The workflow returns while the audit handler still runs: the open final task (its completion removed from the file) returns one warning and unfinishedHandlers; the note handler uses ABANDON and is not reported.",
+  "source": "src/parity-handlers.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": "handlerDrain",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "handlerDrain",
+        "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": "SIGNAL_RECEIVED",
+      "payload": {
+        "name": "audit",
+        "payload": {
+          "entry": "e-1"
+        },
+        "receivedAt": "2026-01-01T00:00:00.000Z"
+      },
+      "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": "TIMER_STARTED",
+      "payload": {
+        "timerId": "t2",
+        "durationMs": 120000,
+        "fireAt": "2026-01-01T00:02:00.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 11,
+      "type": "SIGNAL_RECEIVED",
+      "payload": {
+        "name": "note",
+        "payload": {
+          "text": "later"
+        },
+        "receivedAt": "2026-01-01T00:00:00.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 13,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-3",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 14,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 15,
+      "type": "TIMER_STARTED",
+      "payload": {
+        "timerId": "t3",
+        "durationMs": 3600000,
+        "fireAt": "2026-01-01T01:00:00.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 16,
+      "type": "TIMER_FIRED",
+      "payload": {
+        "timerId": "t1"
+      },
+      "createdAt": "2026-01-01T00:01:00.000Z"
+    },
+    {
+      "seq": 17,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-4"
+      },
+      "createdAt": "2026-01-01T00:01:00.000Z"
+    },
+    {
+      "seq": 18,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-4",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:01:00.000Z"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [
+      {
+        "type": "COMPLETE_WORKFLOW",
+        "output": {
+          "done": true
+        }
+      }
+    ],
+    "logs": [
+      {
+        "level": "warn",
+        "message": "The workflow finished while 1 signal handler was still running (audit x1); await ctx.allHandlersFinished() before returning, or set unfinishedPolicy: 'ABANDON' on the handler",
+        "data": [
+          {
+            "kind": "signal",
+            "name": "audit",
+            "count": 1
+          }
+        ]
+      }
+    ],
+    "unfinishedHandlers": [
+      {
+        "kind": "signal",
+        "name": "audit",
+        "count": 1
+      }
+    ]
+  }
+}

package/fixtures/histories/heartbeat-details-on-retry.history.json

@@ -0,0 +1,145 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "heartbeat-details-on-retry",
+  "description": "Attempt 1 heartbeats { page: 4 } and fails; attempt 2 receives the details and resumes at page 4. Only the final attempt leaves history.",
+  "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": 1767225601000,
+  "workflowFn": "heartbeatResume",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "heartbeatResume",
+        "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": "store/exporter",
+        "operation": "exportPages",
+        "args": {
+          "pages": 10
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000,
+          "maxRetries": 3
+        },
+        "nodeVersion": "2.0.0",
+        "heartbeatTimeout": 30000
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "ACTIVITY_STARTED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 2
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z"
+    },
+    {
+      "seq": 7,
+      "type": "ACTIVITY_COMPLETED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 2,
+        "result": {
+          "exported": 10,
+          "resumedFrom": 4
+        }
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z"
+    },
+    {
+      "seq": 8,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z"
+    },
+    {
+      "seq": 10,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 11,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "exported": 10,
+          "resumedFrom": 4
+        }
+      },
+      "createdAt": "2026-01-01T00:00:01.000Z",
+      "taskId": "run-1-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/interceptor-headers.history.json

@@ -0,0 +1,339 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "interceptor-headers",
+  "description": "Exported interceptors copy the start header traceparent onto every activity and child (ACTIVITY_SCHEDULED, CHILD_RUN_INITIATED headers) and wrap signals with their sender header.",
+  "source": "src/phase-c-interceptors.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": "traced",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "traced",
+        "input": null,
+        "taskQueue": "managed",
+        "randomnessSeed": "run-1",
+        "headers": {
+          "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
+        }
+      },
+      "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/traced"
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000
+        },
+        "headers": {
+          "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
+        }
+      },
+      "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_COMPLETED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1,
+        "result": {
+          "status": 200,
+          "url": "https://example.test/traced"
+        }
+      },
+      "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": "CHILD_RUN_INITIATED",
+      "payload": {
+        "childId": "c1",
+        "workflowKey": "graph-child",
+        "input": {
+          "n": 1
+        },
+        "options": {
+          "parentClosePolicy": "TERMINATE"
+        },
+        "headers": {
+          "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 12,
+      "type": "CHILD_RUN_STARTED",
+      "payload": {
+        "childId": "c1",
+        "childRunId": "run-1-c1",
+        "executionKind": "GRAPH"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 13,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 14,
+      "type": "CHILD_RUN_COMPLETED",
+      "payload": {
+        "childId": "c1",
+        "childRunId": "run-1-c1",
+        "result": {
+          "echoed": {
+            "n": 1
+          }
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 15,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-3",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 16,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 17,
+      "type": "ACTIVITY_SCHEDULED",
+      "payload": {
+        "activityId": "a2",
+        "kind": "user",
+        "activityName": "billing.charge",
+        "taskQueue": "payments",
+        "args": {
+          "amount": 3
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000
+        },
+        "headers": {
+          "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 18,
+      "type": "ACTIVITY_STARTED",
+      "payload": {
+        "activityId": "a2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 19,
+      "type": "ACTIVITY_COMPLETED",
+      "payload": {
+        "activityId": "a2",
+        "attempt": 1,
+        "result": {
+          "chargeId": "ch_t"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 20,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-4"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 21,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-4",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 22,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-4"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-4"
+    },
+    {
+      "seq": 23,
+      "type": "SIGNAL_RECEIVED",
+      "payload": {
+        "name": "note",
+        "payload": {
+          "text": "hi"
+        },
+        "receivedAt": "2026-01-01T00:00:00.000Z",
+        "headers": {
+          "sender": "ops"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 24,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-5"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 25,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-5",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 26,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-5"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-5"
+    },
+    {
+      "seq": 27,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "child": {
+            "echoed": {
+              "n": 1
+            }
+          },
+          "seen": [
+            {
+              "from": "ops",
+              "payload": {
+                "text": "hi"
+              }
+            }
+          ]
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-5"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}