@fluidgrids/workflows 2026.1028.2 → 2026.1029.1

package/fixtures/histories/continue-as-new-r1-retry-options.history.json

@@ -0,0 +1,83 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "continue-as-new-r1-retry-options",
+  "description": "Phase B (R1) continue-as-new options: the activity-shaped retry with a fractional retryDelay and a backoffMultiplier below 1, as R1 wrote it. Still a valid command and a valid WORKFLOW_CONTINUED_AS_NEW.",
+  "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": 1767225600000,
+  "workflowFn": "r1CanRetry",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "r1CanRetry",
+        "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": "WORKFLOW_CONTINUED_AS_NEW",
+      "payload": {
+        "input": {
+          "round": 1
+        },
+        "options": {
+          "taskQueue": "managed",
+          "retry": {
+            "retryDelay": 1500.5,
+            "backoffMultiplier": 0.5,
+            "maxDelay": 150050
+          }
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/execution-timeout-chain.history.json

@@ -0,0 +1,98 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "execution-timeout-chain",
+  "description": "A three-hour execution timeout bounds the chain: the second run, started at 2 h by continue-as-new, times out with WORKFLOW_EXECUTION at 3 h.",
+  "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": 1767236400000,
+  "workflowFn": "executionTimeoutChain",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "executionTimeoutChain",
+        "input": {
+          "round": 1
+        },
+        "taskQueue": "managed",
+        "randomnessSeed": "run-2",
+        "timeouts": {
+          "executionTimeout": 10800000
+        },
+        "lastCompletionResult": {
+          "round": 1
+        }
+      },
+      "createdAt": "2026-01-01T02:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-2-task-1"
+      },
+      "createdAt": "2026-01-01T02:00:00.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-2-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T02:00:00.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-2-task-1"
+      },
+      "createdAt": "2026-01-01T02:00:00.000Z",
+      "taskId": "run-2-task-1"
+    },
+    {
+      "seq": 5,
+      "type": "TIMER_STARTED",
+      "payload": {
+        "timerId": "t1",
+        "durationMs": 7200000,
+        "fireAt": "2026-01-01T04:00:00.000Z"
+      },
+      "createdAt": "2026-01-01T02:00:00.000Z",
+      "taskId": "run-2-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "WORKFLOW_TIMED_OUT",
+      "payload": {
+        "timeoutType": "WORKFLOW_EXECUTION",
+        "failure": {
+          "errorType": "TIMEOUT",
+          "message": "The execution timeout of the chain expired",
+          "type": "TimeoutFailure",
+          "timeoutType": "WORKFLOW_EXECUTION",
+          "source": "engine"
+        }
+      },
+      "createdAt": "2026-01-01T03:00:00.000Z"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/external-cancel-resolved.history.json

@@ -0,0 +1,123 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "external-cancel-resolved",
+  "description": "getRunHandle(runId).cancel() resolves when EXTERNAL_RUN_CANCEL_RESOLVED { ok: true } is delivered, not when the target ends.",
+  "source": "src/parity-handles.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"
+  },
+  "nowMs": 1767225600000,
+  "workflowFn": "cancelOther",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "cancelOther",
+        "input": {
+          "target": "run-1"
+        },
+        "taskQueue": "managed",
+        "randomnessSeed": "run-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-2-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-2-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-2-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-2-task-1"
+    },
+    {
+      "seq": 5,
+      "type": "EXTERNAL_RUN_CANCEL_REQUESTED",
+      "payload": {
+        "externalId": "x1",
+        "target": {
+          "runId": "run-1"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-2-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "EXTERNAL_RUN_CANCEL_RESOLVED",
+      "payload": {
+        "externalId": "x1",
+        "ok": true,
+        "targetRunId": "run-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 7,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-2-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 8,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-2-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-2-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-2-task-2"
+    },
+    {
+      "seq": 10,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "delivered": true
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-2-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/external-cancel-unknown-target.history.json

@@ -0,0 +1,127 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "external-cancel-unknown-target",
+  "description": "A cancel aimed at a workflow id with no run resolves with { ok: false } and a failure; the awaitable rejects and the code catches it.",
+  "source": "src/parity-handles.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": "cancelUnknown",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "cancelUnknown",
+        "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": "EXTERNAL_RUN_CANCEL_REQUESTED",
+      "payload": {
+        "externalId": "x1",
+        "target": {
+          "workflowKey": "cancel-target",
+          "workflowId": "nobody"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "EXTERNAL_RUN_CANCEL_RESOLVED",
+      "payload": {
+        "externalId": "x1",
+        "ok": false,
+        "failure": {
+          "errorType": "VALIDATION",
+          "message": "The target run is not open",
+          "type": "ServerFailure"
+        }
+      },
+      "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": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "delivered": false,
+          "kind": "ServerFailure"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/failure-error-types-fails-run.history.json

@@ -0,0 +1,144 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "failure-error-types-fails-run",
+  "description": "A class listed in failureErrorTypes (QuotaExceeded) fails the run with FAIL_WORKFLOW instead of failing the task.",
+  "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": 1767225600000,
+  "workflowFn": "failureErrorTypes",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "failureErrorTypes",
+        "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/quota"
+        },
+        "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/quota"
+        }
+      },
+      "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_FAILED",
+      "payload": {
+        "failure": {
+          "errorType": "UNKNOWN",
+          "message": "the monthly quota is used up",
+          "type": "QuotaExceeded",
+          "source": "sdk-ts"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}