@fluidgrids/workflows 2026.1028.1 → 2026.1029.1

package/schema/run-event.schema.json

@@ -1189,6 +1189,7 @@
             "workflowKey",
             "workflowId"
           ],
+          "description": "The open run of a workflow id, following its continue-as-new chain; firstRunId pins the chain (R2).",
           "properties": {
             "workflowKey": {
               "type": "string",
@@ -1199,12 +1200,82 @@
               "type": "string",
               "minLength": 1,
               "maxLength": 256
+            },
+            "firstRunId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
             }
           },
           "additionalProperties": false
         }
       ]
     },
+    "runRetryPolicy": {
+      "type": "object",
+      "required": [
+        "initialDelayMs"
+      ],
+      "description": "Run-level retry (11 §2.17), in milliseconds. maxAttempts counts every attempt; absent means unlimited, bounded by the execution timeout.",
+      "properties": {
+        "maxAttempts": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "initialDelayMs": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "backoffMultiplier": {
+          "type": "number",
+          "minimum": 1
+        },
+        "maxDelayMs": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "retryOnErrorTypes": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "TIMEOUT",
+              "TRANSIENT",
+              "DEPENDENCY",
+              "AUTHORIZATION",
+              "VALIDATION",
+              "PERMANENT",
+              "UNKNOWN"
+            ]
+          }
+        },
+        "nonRetryableErrorTypes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "timeouts": {
+      "type": "object",
+      "description": "The three workflow timeouts (11 §2.20), in milliseconds.",
+      "properties": {
+        "executionTimeout": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "runTimeout": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "workflowTaskTimeout": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": false
+    },
     "childOptions": {
       "type": "object",
       "required": [
@@ -1266,9 +1337,101 @@
         "startDelay": {
           "type": "integer",
           "minimum": 0
+        },
+        "retry": {
+          "$ref": "#/$defs/runRetryPolicy"
+        },
+        "versioningBehavior": {
+          "enum": [
+            "PINNED",
+            "AUTO_UPGRADE"
+          ]
+        },
+        "idReusePolicy": {
+          "enum": [
+            "ALLOW_DUPLICATE",
+            "ALLOW_DUPLICATE_FAILED_ONLY",
+            "REJECT_DUPLICATE"
+          ]
+        },
+        "idConflictPolicy": {
+          "enum": [
+            "FAIL",
+            "USE_EXISTING",
+            "TERMINATE_EXISTING"
+          ]
         }
       }
     },
+    "legacyCanRetryPolicy": {
+      "type": "object",
+      "required": [
+        "retryDelay"
+      ],
+      "description": "The R1 activity-shaped CONTINUE_AS_NEW retry: whatever explicitRetryPolicy wrote from a Partial<RetryPolicy>, so numbers carry no integer or minimum constraint. It never had a meaning, and the service ignores it.",
+      "properties": {
+        "maxRetries": {
+          "type": "number"
+        },
+        "retryDelay": {
+          "type": "number"
+        },
+        "backoffMultiplier": {
+          "type": "number"
+        },
+        "maxDelay": {
+          "type": "number"
+        },
+        "retryOnErrorTypes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "nonRetryableErrorTypes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "canOptions": {
+      "type": "object",
+      "description": "Options of a CONTINUE_AS_NEW command (C-SCHEMA, frozen in R2). retry is the R2 run-retry policy of the new run, or the R1 activity shape (retryDelay, maxRetries, maxDelay) that R1 bundles wrote and R2 bundles still write for that shape: it never had a meaning, and the service ignores it instead of reading it as a run-retry policy.",
+      "properties": {
+        "taskQueue": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "retry": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/runRetryPolicy"
+            },
+            {
+              "$ref": "#/$defs/legacyCanRetryPolicy"
+            }
+          ]
+        },
+        "workflowTaskTimeout": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "context": {
+          "type": "object"
+        },
+        "versioningBehavior": {
+          "enum": [
+            "PINNED",
+            "AUTO_UPGRADE"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
     "headers": {
       "type": "object",
       "additionalProperties": {
@@ -1375,6 +1538,35 @@
           "type": "string",
           "minLength": 1,
           "maxLength": 256
+        },
+        "startDelayMs": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "R2: the start delay of a delayed run (11 §2.23); the first task waits for it."
+        },
+        "runAttempt": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "R2: the run-level retry attempt (11 §2.17), 1-based."
+        },
+        "businessId": {
+          "type": "string",
+          "description": "R2: the workflow id (11 §2.1), stored as WorkflowRun.businessId."
+        },
+        "workflowId": {
+          "type": "string",
+          "description": "R2: the same value as businessId."
+        },
+        "timeouts": {
+          "$ref": "#/$defs/timeouts"
+        },
+        "retry": {
+          "$ref": "#/$defs/runRetryPolicy"
+        },
+        "priority": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5
         }
       }
     },
@@ -1425,6 +1617,9 @@
           "type": "integer",
           "minimum": 1,
           "description": "The history length the attempt was leased with (run.taskStartedSeq), when it is not this event's own seq. Required on the WORKFLOW_TASK_STARTED of a transient attempt: input events with a higher seq that precede this event arrived during the attempt and belong to the next activation."
+        },
+        "version": {
+          "description": "R2: the workflow version whose bundle served the task (it differs from WORKFLOW_STARTED.version after an AUTO_UPGRADE or a versioning override)."
         }
       }
     },
@@ -2201,6 +2396,19 @@
         "attempts": {
           "type": "integer",
           "minimum": 1
+        },
+        "nodeType": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "operation": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "summary": {
+          "type": "string"
         }
       }
     },
@@ -2223,6 +2431,19 @@
         "attempts": {
           "type": "integer",
           "minimum": 1
+        },
+        "nodeType": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "operation": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "summary": {
+          "type": "string"
         }
       }
     },
@@ -2300,7 +2521,44 @@
         "override"
       ],
       "properties": {
-        "override": {}
+        "override": {
+          "description": "The per-run override (11 §2.27): { behavior: PINNED, version } pins the run, { behavior: AUTO_UPGRADE } upgrades it, null removes the override.",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "type": "object",
+              "required": [
+                "behavior",
+                "version"
+              ],
+              "properties": {
+                "behavior": {
+                  "const": "PINNED"
+                },
+                "version": {}
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "required": [
+                "behavior"
+              ],
+              "properties": {
+                "behavior": {
+                  "const": "AUTO_UPGRADE"
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "actor": {},
+        "reason": {
+          "type": "string"
+        }
       }
     },
     "payload_WORKFLOW_COMPLETED": {
@@ -2351,6 +2609,9 @@
             "WORKFLOW_RUN",
             "WORKFLOW_EXECUTION"
           ]
+        },
+        "failure": {
+          "$ref": "#/$defs/failure"
         }
       }
     },
@@ -2363,7 +2624,8 @@
       "properties": {
         "input": {},
         "options": {
-          "type": "object"
+          "type": "object",
+          "description": "The CONTINUE_AS_NEW options as the service recorded them. New commands are checked against canOptions; histories recorded before R2 may hold any object the R1 contract accepted."
         },
         "newRunId": {
           "type": "string"

package/schema/workflow-command.schema.json

@@ -467,6 +467,7 @@
             "workflowKey",
             "workflowId"
           ],
+          "description": "The open run of a workflow id, following its continue-as-new chain; firstRunId pins the chain (R2).",
           "properties": {
             "workflowKey": {
               "type": "string",
@@ -477,12 +478,82 @@
               "type": "string",
               "minLength": 1,
               "maxLength": 256
+            },
+            "firstRunId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
             }
           },
           "additionalProperties": false
         }
       ]
     },
+    "runRetryPolicy": {
+      "type": "object",
+      "required": [
+        "initialDelayMs"
+      ],
+      "description": "Run-level retry (11 §2.17), in milliseconds. maxAttempts counts every attempt; absent means unlimited, bounded by the execution timeout.",
+      "properties": {
+        "maxAttempts": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "initialDelayMs": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "backoffMultiplier": {
+          "type": "number",
+          "minimum": 1
+        },
+        "maxDelayMs": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "retryOnErrorTypes": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "TIMEOUT",
+              "TRANSIENT",
+              "DEPENDENCY",
+              "AUTHORIZATION",
+              "VALIDATION",
+              "PERMANENT",
+              "UNKNOWN"
+            ]
+          }
+        },
+        "nonRetryableErrorTypes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "timeouts": {
+      "type": "object",
+      "description": "The three workflow timeouts (11 §2.20), in milliseconds.",
+      "properties": {
+        "executionTimeout": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "runTimeout": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "workflowTaskTimeout": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": false
+    },
     "childOptions": {
       "type": "object",
       "required": [
@@ -544,9 +615,101 @@
         "startDelay": {
           "type": "integer",
           "minimum": 0
+        },
+        "retry": {
+          "$ref": "#/$defs/runRetryPolicy"
+        },
+        "versioningBehavior": {
+          "enum": [
+            "PINNED",
+            "AUTO_UPGRADE"
+          ]
+        },
+        "idReusePolicy": {
+          "enum": [
+            "ALLOW_DUPLICATE",
+            "ALLOW_DUPLICATE_FAILED_ONLY",
+            "REJECT_DUPLICATE"
+          ]
+        },
+        "idConflictPolicy": {
+          "enum": [
+            "FAIL",
+            "USE_EXISTING",
+            "TERMINATE_EXISTING"
+          ]
         }
       }
     },
+    "legacyCanRetryPolicy": {
+      "type": "object",
+      "required": [
+        "retryDelay"
+      ],
+      "description": "The R1 activity-shaped CONTINUE_AS_NEW retry: whatever explicitRetryPolicy wrote from a Partial<RetryPolicy>, so numbers carry no integer or minimum constraint. It never had a meaning, and the service ignores it.",
+      "properties": {
+        "maxRetries": {
+          "type": "number"
+        },
+        "retryDelay": {
+          "type": "number"
+        },
+        "backoffMultiplier": {
+          "type": "number"
+        },
+        "maxDelay": {
+          "type": "number"
+        },
+        "retryOnErrorTypes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "nonRetryableErrorTypes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "canOptions": {
+      "type": "object",
+      "description": "Options of a CONTINUE_AS_NEW command (C-SCHEMA, frozen in R2). retry is the R2 run-retry policy of the new run, or the R1 activity shape (retryDelay, maxRetries, maxDelay) that R1 bundles wrote and R2 bundles still write for that shape: it never had a meaning, and the service ignores it instead of reading it as a run-retry policy.",
+      "properties": {
+        "taskQueue": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "retry": {
+          "oneOf": [
+            {
+              "$ref": "#/$defs/runRetryPolicy"
+            },
+            {
+              "$ref": "#/$defs/legacyCanRetryPolicy"
+            }
+          ]
+        },
+        "workflowTaskTimeout": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "context": {
+          "type": "object"
+        },
+        "versioningBehavior": {
+          "enum": [
+            "PINNED",
+            "AUTO_UPGRADE"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
     "headers": {
       "type": "object",
       "additionalProperties": {
@@ -939,6 +1102,20 @@
         "attempts": {
           "type": "integer",
           "minimum": 1
+        },
+        "nodeType": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "operation": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "summary": {
+          "type": "string",
+          "maxLength": 200
         }
       },
       "additionalProperties": false,
@@ -971,7 +1148,7 @@
         },
         "input": {},
         "options": {
-          "type": "object"
+          "$ref": "#/$defs/canOptions"
         }
       },
       "additionalProperties": false