@fluidgrids/workflows 2026.1029.1 → 2026.1030.1

package/schema/history-file.schema.json

@@ -37,7 +37,7 @@
     },
     "replay": {
       "type": "boolean",
-      "description": "False for histories that use Phase C features (updates); they are parsed and projected but not replayed."
+      "description": "False for histories that are parsed and projected but not replayed (written by hand for a feature the recording runtime did not have)."
     },
     "info": {
       "$ref": "#/$defs/info"
@@ -376,6 +376,18 @@
             "USE_EXISTING",
             "TERMINATE_EXISTING"
           ]
+        },
+        "fairnessKey": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 255,
+          "description": "Phase C: the fairness key of the task (11 §2.11); default the workspace id."
+        },
+        "fairnessWeight": {
+          "type": "number",
+          "minimum": 0.1,
+          "maximum": 10,
+          "description": "Phase C: the weight of the fairness key, 0.1 to 10 (default 1)."
         }
       }
     },
@@ -452,7 +464,8 @@
       "type": "object",
       "additionalProperties": {
         "type": "string"
-      }
+      },
+      "description": "Interceptor headers (11 §2.10): string values; a user activity carries at most 16 KiB of JSON (checked by validateCommands)."
     },
     "payload_WORKFLOW_STARTED": {
       "type": "object",
@@ -583,6 +596,25 @@
           "type": "integer",
           "minimum": 1,
           "maximum": 5
+        },
+        "headers": {
+          "$ref": "#/$defs/headers"
+        },
+        "searchAttributes": {
+          "type": "object",
+          "description": "Phase C: the search attributes the start set (11 §2.8)."
+        },
+        "fairnessKey": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 255,
+          "description": "Phase C: the fairness key of the task (11 §2.11); default the workspace id."
+        },
+        "fairnessWeight": {
+          "type": "number",
+          "minimum": 0.1,
+          "maximum": 10,
+          "description": "Phase C: the weight of the fairness key, 0.1 to 10 (default 1)."
         }
       }
     },
@@ -720,85 +752,193 @@
       }
     },
     "payload_ACTIVITY_SCHEDULED": {
-      "type": "object",
-      "required": [
-        "activityId",
-        "kind",
-        "nodeType",
-        "operation",
-        "args",
-        "retry"
-      ],
-      "properties": {
-        "headers": {
-          "$ref": "#/$defs/headers"
-        },
-        "activityId": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 256
-        },
-        "kind": {
-          "const": "node"
-        },
-        "nodeType": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 256
-        },
-        "nodeVersion": {
-          "type": "string"
-        },
-        "operation": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 256
-        },
-        "args": {},
-        "connection": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 256
-        },
-        "retry": {
-          "$ref": "#/$defs/retryPolicy"
-        },
-        "startToCloseTimeout": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "scheduleToCloseTimeout": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "scheduleToStartTimeout": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "heartbeatTimeout": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "cancellationType": {
-          "enum": [
-            "WAIT_CANCELLATION_COMPLETED",
-            "TRY_CANCEL",
-            "ABANDON"
-          ]
-        },
-        "priority": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 5
-        },
-        "summary": {
-          "type": "string",
-          "maxLength": 200
+      "description": "The SCHEDULE_ACTIVITY command as the service accepted it: kind node, or kind user (Phase C) with activityName, taskQueue, fairness, connections and headers.",
+      "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "activityId",
+            "kind",
+            "nodeType",
+            "operation",
+            "args",
+            "retry"
+          ],
+          "properties": {
+            "activityId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            "args": {},
+            "retry": {
+              "$ref": "#/$defs/retryPolicy"
+            },
+            "startToCloseTimeout": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "scheduleToCloseTimeout": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "scheduleToStartTimeout": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "heartbeatTimeout": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "cancellationType": {
+              "enum": [
+                "WAIT_CANCELLATION_COMPLETED",
+                "TRY_CANCEL",
+                "ABANDON"
+              ]
+            },
+            "priority": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 5
+            },
+            "summary": {
+              "type": "string",
+              "maxLength": 200
+            },
+            "fairnessKey": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 255,
+              "description": "Phase C: the fairness key of the task (11 §2.11); default the workspace id."
+            },
+            "fairnessWeight": {
+              "type": "number",
+              "minimum": 0.1,
+              "maximum": 10,
+              "description": "Phase C: the weight of the fairness key, 0.1 to 10 (default 1)."
+            },
+            "kind": {
+              "const": "node"
+            },
+            "nodeType": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            "nodeVersion": {
+              "type": "string"
+            },
+            "operation": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            "connection": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            "runOn": {
+              "type": "string"
+            },
+            "headers": {
+              "$ref": "#/$defs/headers"
+            }
+          }
         },
-        "runOn": {
-          "type": "string"
+        {
+          "type": "object",
+          "required": [
+            "activityId",
+            "kind",
+            "activityName",
+            "taskQueue",
+            "args",
+            "retry"
+          ],
+          "properties": {
+            "activityId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            "args": {},
+            "retry": {
+              "$ref": "#/$defs/retryPolicy"
+            },
+            "startToCloseTimeout": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "scheduleToCloseTimeout": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "scheduleToStartTimeout": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "heartbeatTimeout": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "cancellationType": {
+              "enum": [
+                "WAIT_CANCELLATION_COMPLETED",
+                "TRY_CANCEL",
+                "ABANDON"
+              ]
+            },
+            "priority": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 5
+            },
+            "summary": {
+              "type": "string",
+              "maxLength": 200
+            },
+            "fairnessKey": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 255,
+              "description": "Phase C: the fairness key of the task (11 §2.11); default the workspace id."
+            },
+            "fairnessWeight": {
+              "type": "number",
+              "minimum": 0.1,
+              "maximum": 10,
+              "description": "Phase C: the weight of the fairness key, 0.1 to 10 (default 1)."
+            },
+            "kind": {
+              "const": "user"
+            },
+            "activityName": {
+              "type": "string",
+              "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,127}$"
+            },
+            "taskQueue": {
+              "type": "string",
+              "pattern": "^[a-z0-9][a-z0-9-]{0,62}$"
+            },
+            "connections": {
+              "type": "array",
+              "maxItems": 16,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256
+              },
+              "description": "Connection names the worker may resolve for each started attempt (H2: declared by the definition and on the worker token allow-list)."
+            },
+            "headers": {
+              "$ref": "#/$defs/headers"
+            }
+          }
         }
-      }
+      ]
     },
     "payload_ACTIVITY_STARTED": {
       "type": "object",
@@ -1060,6 +1200,9 @@
         "actor": {},
         "idempotencyKey": {
           "type": "string"
+        },
+        "headers": {
+          "$ref": "#/$defs/headers"
         }
       }
     },
@@ -1080,7 +1223,10 @@
           "minLength": 1,
           "maxLength": 256
         },
-        "args": {}
+        "args": {},
+        "headers": {
+          "$ref": "#/$defs/headers"
+        }
       }
     },
     "payload_UPDATE_ACCEPTED": {
@@ -1100,7 +1246,10 @@
           "minLength": 1,
           "maxLength": 256
         },
-        "args": {}
+        "args": {},
+        "headers": {
+          "$ref": "#/$defs/headers"
+        }
       }
     },
     "payload_UPDATE_COMPLETED": {
@@ -1158,6 +1307,9 @@
             "GRAPH",
             "DURABLE_FN"
           ]
+        },
+        "headers": {
+          "$ref": "#/$defs/headers"
         }
       }
     },
@@ -1528,6 +1680,13 @@
         },
         "reason": {
           "type": "string"
+        },
+        "actor": {},
+        "reapplySignals": {
+          "type": "boolean"
+        },
+        "reapplyUpdates": {
+          "type": "boolean"
         }
       }
     },
@@ -2818,6 +2977,21 @@
         },
         "retry": {
           "$ref": "#/$defs/runRetryPolicy"
+        },
+        "searchAttributes": {
+          "type": "object"
+        },
+        "fairnessKey": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 255,
+          "description": "Phase C: the fairness key of the task (11 §2.11); default the workspace id."
+        },
+        "fairnessWeight": {
+          "type": "number",
+          "minimum": 0.1,
+          "maximum": 10,
+          "description": "Phase C: the weight of the fairness key, 0.1 to 10 (default 1)."
         }
       }
     }

package/schema/ir-v2.schema.json

@@ -387,6 +387,251 @@
               }
             }
           }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "internal:signal-run"
+              }
+            },
+            "required": [
+              "type"
+            ]
+          },
+          "then": {
+            "description": "Phase C (fluidgrids.run-control): signal another run of the workspace (05 §4). A retried node delivers once (dedupe key signal-node:<nodeStateId>:<attempt>).",
+            "required": [
+              "args"
+            ],
+            "properties": {
+              "args": {
+                "required": [
+                  "state"
+                ],
+                "properties": {
+                  "state": {
+                    "type": "object",
+                    "required": [
+                      "signalName",
+                      "target"
+                    ],
+                    "properties": {
+                      "signalName": {
+                        "type": "string",
+                        "minLength": 1
+                      },
+                      "target": {
+                        "description": "The run to signal: { runId }, { workflowKey, workflowId, firstRunId? } (the open run of that workflow id) or { parent: true }. Values may be expressions.",
+                        "oneOf": [
+                          {
+                            "type": "object",
+                            "required": [
+                              "runId"
+                            ],
+                            "properties": {
+                              "runId": {
+                                "type": "string",
+                                "minLength": 1
+                              }
+                            },
+                            "additionalProperties": false
+                          },
+                          {
+                            "type": "object",
+                            "required": [
+                              "workflowKey",
+                              "workflowId"
+                            ],
+                            "properties": {
+                              "workflowKey": {
+                                "type": "string",
+                                "minLength": 1
+                              },
+                              "workflowId": {
+                                "type": "string",
+                                "minLength": 1
+                              },
+                              "firstRunId": {
+                                "type": "string",
+                                "minLength": 1
+                              }
+                            },
+                            "additionalProperties": false
+                          },
+                          {
+                            "type": "object",
+                            "required": [
+                              "parent"
+                            ],
+                            "properties": {
+                              "parent": {
+                                "const": true
+                              }
+                            },
+                            "additionalProperties": false
+                          }
+                        ]
+                      },
+                      "payload": {},
+                      "failOnUndelivered": {
+                        "type": "boolean",
+                        "description": "Default true: an undelivered signal fails the node."
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "internal:set-search-attributes"
+              }
+            },
+            "required": [
+              "type"
+            ]
+          },
+          "then": {
+            "description": "Phase C (fluidgrids.search-attributes): upsert the run search attributes (11 §2.8); a null value removes one. Values may be expressions; the service validates them against the workspace definitions.",
+            "required": [
+              "args"
+            ],
+            "properties": {
+              "args": {
+                "required": [
+                  "state"
+                ],
+                "properties": {
+                  "state": {
+                    "type": "object",
+                    "required": [
+                      "attributes"
+                    ],
+                    "properties": {
+                      "attributes": {
+                        "type": "object",
+                        "minProperties": 1
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "internal:schedule"
+              }
+            },
+            "required": [
+              "type"
+            ]
+          },
+          "then": {
+            "properties": {
+              "args": {
+                "properties": {
+                  "state": {
+                    "description": "Phase C schedule policies (11 §2.16, §2.33; fluidgrids.schedule-policies). Every field is optional; a trigger without overlapPolicy keeps the ALLOW_ALL behaviour of earlier versions.",
+                    "properties": {
+                      "overlapPolicy": {
+                        "enum": [
+                          "SKIP",
+                          "BUFFER_ONE",
+                          "BUFFER_ALL",
+                          "CANCEL_OTHER",
+                          "TERMINATE_OTHER",
+                          "ALLOW_ALL"
+                        ]
+                      },
+                      "catchupWindow": {
+                        "oneOf": [
+                          {
+                            "type": "number",
+                            "minimum": 0
+                          },
+                          {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        ]
+                      },
+                      "pauseOnFailure": {
+                        "type": "boolean"
+                      },
+                      "limitedActions": {
+                        "type": "integer",
+                        "minimum": 1
+                      },
+                      "scheduleContext": {
+                        "type": "object"
+                      },
+                      "scheduleSearchAttributes": {
+                        "type": "object"
+                      },
+                      "spec": {
+                        "description": "One of cron, calendar or interval, plus excludeCalendars (calendar entries whose matches are skipped), startAt, endAt (ISO 8601), timezone and jitter.",
+                        "properties": {
+                          "cron": {
+                            "type": "string"
+                          },
+                          "calendar": {
+                            "type": "array",
+                            "items": {
+                              "type": "object"
+                            }
+                          },
+                          "interval": {
+                            "type": "array",
+                            "items": {
+                              "type": "object"
+                            }
+                          },
+                          "excludeCalendars": {
+                            "type": "array",
+                            "items": {
+                              "type": "object"
+                            }
+                          },
+                          "startAt": {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          "endAt": {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          "timezone": {
+                            "type": "string"
+                          },
+                          "jitter": {
+                            "oneOf": [
+                              {
+                                "type": "number",
+                                "minimum": 0
+                              },
+                              {
+                                "type": "string",
+                                "minLength": 1
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
         }
       ]
     },
@@ -660,7 +905,7 @@
             "minLength": 1
           },
           "uniqueItems": true,
-          "description": "Runtime features the bundle uses (C-FEATURES, SDK R2): localActivity, externalCancel, childOptions, canOptions, autoUpgrade, runRetry, timeouts; Phase C adds userActivity, updates, queries, searchAttributes, dynamic and interceptors. A bundle without the field was built before R2 and uses none."
+          "description": "Runtime features the bundle uses (C-FEATURES): localActivity, externalCancel, childOptions, canOptions, autoUpgrade, runRetry, timeouts (SDK R2); userActivity, updates, queries, searchAttributes, dynamic and interceptors (Phase C, C-R1). A bundle without the field was built before R2 and uses none."
         }
       }
     },