@fluidgrids/workflows 2026.1028.1 → 2026.1029.1

package/fixtures/histories/schedule-to-start-timeout.history.json

@@ -0,0 +1,132 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "schedule-to-start-timeout",
+  "description": "No worker starts the activity within its one-minute schedule-to-start timeout: ACTIVITY_TIMED_OUT { SCHEDULE_TO_START }, not retried although the policy allows retries.",
+  "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": 1767225660000,
+  "workflowFn": "scheduleToStart",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "scheduleToStart",
+        "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/queue"
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000,
+          "maxRetries": 5
+        },
+        "scheduleToStartTimeout": 60000
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 6,
+      "type": "ACTIVITY_TIMED_OUT",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1,
+        "timeoutType": "SCHEDULE_TO_START"
+      },
+      "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": {
+          "timedOut": true,
+          "timeoutType": "SCHEDULE_TO_START"
+        }
+      },
+      "createdAt": "2026-01-01T00:01:00.000Z",
+      "taskId": "run-1-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/start-delay-signal-ends-delay.history.json

@@ -0,0 +1,155 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "start-delay-signal-ends-delay",
+  "description": "A run started with a one-hour delay (WORKFLOW_STARTED.startDelayMs): a signal at 10 minutes ends the delay and the first task runs then.",
+  "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": 1767226200000,
+  "workflowFn": "delayedStart",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "delayedStart",
+        "input": null,
+        "taskQueue": "managed",
+        "randomnessSeed": "run-1",
+        "startDelayMs": 3600000
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "SIGNAL_RECEIVED",
+      "payload": {
+        "name": "go",
+        "payload": {
+          "by": "ops"
+        },
+        "receivedAt": "2026-01-01T00:10:00.000Z"
+      },
+      "createdAt": "2026-01-01T00:10:00.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:10:00.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:10:00.000Z"
+    },
+    {
+      "seq": 5,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:10: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/go/ops"
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000
+        }
+      },
+      "createdAt": "2026-01-01T00:10:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 7,
+      "type": "ACTIVITY_STARTED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:10:00.000Z"
+    },
+    {
+      "seq": 8,
+      "type": "ACTIVITY_COMPLETED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1,
+        "result": {
+          "status": 200,
+          "url": "https://example.test/go/ops"
+        }
+      },
+      "createdAt": "2026-01-01T00:10:00.000Z"
+    },
+    {
+      "seq": 9,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:10:00.000Z"
+    },
+    {
+      "seq": 10,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:10:00.000Z"
+    },
+    {
+      "seq": 11,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:10:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "by": "ops",
+          "startedAt": 1767226200000
+        }
+      },
+      "createdAt": "2026-01-01T00:10:00.000Z",
+      "taskId": "run-1-task-2"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/typeerror-task-retry-100.history.json

@@ -0,0 +1,137 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "typeerror-task-retry-100",
+  "description": "A TypeError fails the workflow task; the service retries it with capped backoff and writes only the first failure, so after 100 attempts the history is unchanged, the run is RUNNING and attempt 101 (17 h later) fails the same way.",
+  "source": "src/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": 1767286800000,
+  "workflowFn": "codeBug",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "codeBug",
+        "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/shape"
+        },
+        "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/shape"
+        }
+      },
+      "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_FAILED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1,
+        "cause": "WORKFLOW_CODE_ERROR",
+        "message": "TypeError: the result has no \"missing\" field"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "failed",
+    "commands": [],
+    "logs": [],
+    "failure": {
+      "cause": "WORKFLOW_CODE_ERROR",
+      "message": "TypeError: the result has no \"missing\" field",
+      "errorType": "TypeError"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluidgrids/workflows",
-  "version": "2026.1028.1",
+  "version": "2026.1029.1",
   "description": "Author FluidGrids workflows as code: the IR v2 schema and tools, the tier-1 graph builder, tier-2 durable workflow functions with their runtime, history contract, QuickJS replay runner and test environment, lift and lower between canvas JSON, TypeScript and Python, and typed node client generation.",
   "type": "module",
   "main": "./dist/index.cjs",