@fluidgrids/workflows 2026.1028.1 → 2026.1029.1

package/fixtures/histories/local-activity-completed.history.json

@@ -0,0 +1,157 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "local-activity-completed",
+  "description": "ctx.localActivity runs inside the task (localActivityRequested, then the same task again) and records one LOCAL_ACTIVITY_COMPLETED l1 before the activity it feeds; replay never runs it again.",
+  "source": "src/local-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": "localCompleted",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "localCompleted",
+        "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": "LOCAL_ACTIVITY_COMPLETED",
+      "payload": {
+        "localActivityId": "l1",
+        "attempts": 1,
+        "nodeType": "store/fx",
+        "operation": "lookupRate",
+        "result": {
+          "rate": 1.08
+        },
+        "summary": "rate lookup"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "ACTIVITY_SCHEDULED",
+      "payload": {
+        "activityId": "a1",
+        "kind": "node",
+        "nodeType": "internal:http",
+        "operation": "execute",
+        "args": {
+          "url": "https://example.test/convert/1.08"
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 7,
+      "type": "ACTIVITY_STARTED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 8,
+      "type": "ACTIVITY_COMPLETED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1,
+        "result": {
+          "status": 200,
+          "url": "https://example.test/convert/1.08"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 10,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 11,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "rate": 1.08
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/local-activity-failed.history.json

@@ -0,0 +1,93 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "local-activity-failed",
+  "description": "A non-retryable failure is recorded as LOCAL_ACTIVITY_FAILED and rejects with ActivityFailure, which the code catches.",
+  "source": "src/local-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": "localFailed",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "localFailed",
+        "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": "LOCAL_ACTIVITY_FAILED",
+      "payload": {
+        "localActivityId": "l1",
+        "attempts": 1,
+        "nodeType": "store/fx",
+        "operation": "lookupRate",
+        "failure": {
+          "errorType": "PERMANENT",
+          "message": "unknown currency",
+          "type": "PERMANENT",
+          "source": "node:store/fx",
+          "nonRetryable": true
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "failed": true,
+          "kind": "ActivityFailure"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/local-activity-retry-in-task.history.json

@@ -0,0 +1,88 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "local-activity-retry-in-task",
+  "description": "Two failed attempts are retried inside the task (attempt 2 and 3 are requested again by the runtime); the marker records attempts 3 and no retry leaves history.",
+  "source": "src/local-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": "localRetry",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "localRetry",
+        "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": "LOCAL_ACTIVITY_COMPLETED",
+      "payload": {
+        "localActivityId": "l1",
+        "attempts": 3,
+        "nodeType": "store/fx",
+        "operation": "lookupRate",
+        "result": {
+          "rate": 1.27
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "rate": 1.27
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/run-retry-last-failure.history.json

@@ -0,0 +1,90 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "run-retry-last-failure",
+  "description": "Run-level retry: attempt 1 fails with a retryable error; attempt 2 starts after the 10 s backoff with runAttempt 2 and the failure as lastFailure in WORKFLOW_STARTED.",
+  "source": "src/parity-chain.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-2",
+    "continuedFromRunId": "run-1",
+    "firstRunId": "run-1"
+  },
+  "nowMs": 1767225610000,
+  "workflowFn": "runRetry",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "runRetry",
+        "input": null,
+        "taskQueue": "managed",
+        "randomnessSeed": "run-2",
+        "runAttempt": 2,
+        "retry": {
+          "initialDelayMs": 10000,
+          "backoffMultiplier": 2,
+          "maxDelayMs": 1000000,
+          "maxAttempts": 3
+        },
+        "lastFailure": {
+          "errorType": "TRANSIENT",
+          "message": "upstream unavailable",
+          "type": "TRANSIENT",
+          "source": "sdk-ts"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-2-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:10.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-2-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:10.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-2-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:10.000Z",
+      "taskId": "run-2-task-1"
+    },
+    {
+      "seq": 5,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "attempt": 2,
+          "lastFailure": "upstream unavailable",
+          "continuedFrom": "run-1"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:10.000Z",
+      "taskId": "run-2-task-1"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/run-timeout.history.json

@@ -0,0 +1,159 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "run-timeout",
+  "description": "The one-hour run timeout expires while the run sleeps: WORKFLOW_TIMED_OUT { WORKFLOW_RUN } with a TIMEOUT failure.",
+  "source": "src/parity-chain.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": "runTimeout",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "runTimeout",
+        "input": null,
+        "taskQueue": "managed",
+        "randomnessSeed": "run-1",
+        "timeouts": {
+          "runTimeout": 3600000
+        }
+      },
+      "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/start"
+        },
+        "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_COMPLETED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1,
+        "result": {
+          "status": 200,
+          "url": "https://example.test/start"
+        }
+      },
+      "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_STARTED",
+      "payload": {
+        "timerId": "t1",
+        "durationMs": 7200000,
+        "fireAt": "2026-01-01T02:00:00.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_TIMED_OUT",
+      "payload": {
+        "timeoutType": "WORKFLOW_RUN",
+        "failure": {
+          "errorType": "TIMEOUT",
+          "message": "The run timeout expired",
+          "type": "TimeoutFailure",
+          "timeoutType": "WORKFLOW_RUN",
+          "source": "engine"
+        }
+      },
+      "createdAt": "2026-01-01T01:00:00.000Z"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}