@fluidgrids/workflows 2026.1028.2 → 2026.1030.1

package/fixtures/histories/codec-opaque.history.json

@@ -0,0 +1,229 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "codec-opaque",
+  "description": "A self-hosted codec returns an encoded payload ({\"$fgp\":1,...}); the workflow passes it on untouched and the history keeps it opaque.",
+  "source": "src/phase-c-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": "codecOpaque",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "codecOpaque",
+        "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": "user",
+        "activityName": "vault.read",
+        "taskQueue": "vault",
+        "args": {
+          "id": "s-1"
+        },
+        "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": {
+          "$fgp": 1,
+          "encoding": "binary/encrypted",
+          "metadata": {
+            "keyId": "k-1"
+          },
+          "data": "c2VjcmV0"
+        }
+      },
+      "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": "ACTIVITY_SCHEDULED",
+      "payload": {
+        "activityId": "a2",
+        "kind": "node",
+        "nodeType": "internal:http",
+        "operation": "execute",
+        "args": {
+          "url": "https://example.test/store",
+          "body": {
+            "$fgp": 1,
+            "encoding": "binary/encrypted",
+            "metadata": {
+              "keyId": "k-1"
+            },
+            "data": "c2VjcmV0"
+          }
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 12,
+      "type": "ACTIVITY_STARTED",
+      "payload": {
+        "activityId": "a2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 13,
+      "type": "ACTIVITY_COMPLETED",
+      "payload": {
+        "activityId": "a2",
+        "attempt": 1,
+        "result": {
+          "status": 200,
+          "url": "https://example.test/store"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 14,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "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": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "encoded": true,
+          "secret": {
+            "$fgp": 1,
+            "encoding": "binary/encrypted",
+            "metadata": {
+              "keyId": "k-1"
+            },
+            "data": "c2VjcmV0"
+          }
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/continue-as-new-last-result.history.json

@@ -0,0 +1,86 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "continue-as-new-last-result",
+  "description": "The last run of a three-run chain: WORKFLOW_STARTED.lastCompletionResult is the previous run's continue-as-new value, read as ctx.info.lastResult.",
+  "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-3",
+    "continuedFromRunId": "run-2",
+    "firstRunId": "run-1"
+  },
+  "nowMs": 1767225600000,
+  "workflowFn": "lastResultChain",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "lastResultChain",
+        "input": {
+          "total": 3,
+          "step": 3
+        },
+        "taskQueue": "managed",
+        "randomnessSeed": "run-3",
+        "lastCompletionResult": {
+          "total": 3,
+          "step": 3
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-3-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-3-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-3-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-3-task-1"
+    },
+    {
+      "seq": 5,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "total": 6,
+          "lastResult": {
+            "total": 3,
+            "step": 3
+          }
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-3-task-1"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

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

@@ -0,0 +1,99 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "continue-as-new-options",
+  "description": "The second run of a chain started with continue-as-new options: its WORKFLOW_STARTED carries the memo, the task timeout, the run retry and AUTO_UPGRADE, and ctx.info reads them.",
+  "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": 1767225600000,
+  "workflowFn": "canOptions",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "canOptions",
+        "input": {
+          "round": 1
+        },
+        "taskQueue": "managed",
+        "randomnessSeed": "run-2",
+        "runAttempt": 1,
+        "context": {
+          "tenant": "acme"
+        },
+        "timeouts": {
+          "workflowTaskTimeout": 30000
+        },
+        "retry": {
+          "initialDelayMs": 1000,
+          "backoffMultiplier": 2,
+          "maxDelayMs": 100000,
+          "maxAttempts": 2
+        },
+        "versioningBehavior": "AUTO_UPGRADE",
+        "lastCompletionResult": {
+          "round": 1
+        }
+      },
+      "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": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "round": 1,
+          "memo": {
+            "tenant": "acme"
+          },
+          "versioningBehavior": "AUTO_UPGRADE",
+          "taskTimeout": 30000
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-2-task-1"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/continue-as-new-r1-long-task-queue.history.json

@@ -0,0 +1,78 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "continue-as-new-r1-long-task-queue",
+  "description": "A WORKFLOW_CONTINUED_AS_NEW stored by a Phase B (R1) run with a 300-character task queue, which the R1 contract accepted and the R2 command shape refuses. Parsed and projected, not replayed.",
+  "source": "src/parity-chain.ts",
+  "replay": false,
+  "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": "qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq",
+          "retry": {
+            "retryDelay": 1500.5,
+            "backoffMultiplier": 0.5,
+            "maxDelay": 150050
+          }
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-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": []
+  }
+}