@fluidgrids/workflows 2026.1029.1 → 2026.1030.1

package/schema/payload-fields.json

@@ -0,0 +1,162 @@
+{
+  "format": "fluidgrids.payload-fields",
+  "formatVersion": 2,
+  "description": "JSON pointers of user payloads per event type (relative to the payload) and per command type (relative to the command). `events` and `commands` are plain payload pointers. `eventFailures` and `commandFailures` point at failure objects: the payloads of a failure are the `failure.payloads` pointers relative to it, and the same rule applies again to the failure at `failure.cause` (recursively, to the end of the cause chain). Payload codecs and the at-rest envelope apply to these pointers only; everything else stays in clear text. A value that is not plain JSON is carried as {\"$fgp\": 1, \"encoding\", \"metadata\"?, \"data\" (base64)}.",
+  "encodedMarker": "$fgp",
+  "encodedVersion": 1,
+  "encodings": [
+    "json/plain",
+    "binary/plain",
+    "binary/encrypted",
+    "kms/envelope"
+  ],
+  "events": {
+    "WORKFLOW_STARTED": [
+      "/input",
+      "/lastCompletionResult",
+      "/context"
+    ],
+    "ACTIVITY_SCHEDULED": [
+      "/args"
+    ],
+    "ACTIVITY_HEARTBEAT": [
+      "/details"
+    ],
+    "ACTIVITY_COMPLETED": [
+      "/result"
+    ],
+    "ACTIVITY_CANCELLED": [
+      "/details"
+    ],
+    "SIGNAL_RECEIVED": [
+      "/payload"
+    ],
+    "UPDATE_ADMITTED": [
+      "/args"
+    ],
+    "UPDATE_ACCEPTED": [
+      "/args"
+    ],
+    "UPDATE_COMPLETED": [
+      "/result"
+    ],
+    "CHILD_RUN_INITIATED": [
+      "/input",
+      "/options/context"
+    ],
+    "CHILD_RUN_COMPLETED": [
+      "/result"
+    ],
+    "EXTERNAL_RUN_SIGNALED": [
+      "/payload"
+    ],
+    "SIDE_EFFECT_RECORDED": [
+      "/value"
+    ],
+    "LOCAL_ACTIVITY_COMPLETED": [
+      "/result"
+    ],
+    "CONTEXT_UPSERTED": [
+      "/entries"
+    ],
+    "MARKER_RECORDED": [
+      "/data/currentDetails"
+    ],
+    "WORKFLOW_COMPLETED": [
+      "/output"
+    ],
+    "WORKFLOW_CANCELLED": [
+      "/details"
+    ],
+    "WORKFLOW_CONTINUED_AS_NEW": [
+      "/input",
+      "/options/context"
+    ]
+  },
+  "commands": {
+    "SCHEDULE_ACTIVITY": [
+      "/args"
+    ],
+    "START_CHILD_RUN": [
+      "/input",
+      "/options/context"
+    ],
+    "SIGNAL_RUN": [
+      "/payload"
+    ],
+    "RECORD_SIDE_EFFECT": [
+      "/value"
+    ],
+    "RECORD_MARKER": [
+      "/data/currentDetails"
+    ],
+    "COMPLETE_WORKFLOW": [
+      "/output"
+    ],
+    "UPSERT_CONTEXT": [
+      "/entries"
+    ],
+    "RECORD_LOCAL_ACTIVITY": [
+      "/result"
+    ],
+    "CONTINUE_AS_NEW": [
+      "/input",
+      "/options/context"
+    ],
+    "COMPLETE_UPDATE": [
+      "/result"
+    ]
+  },
+  "eventFailures": {
+    "WORKFLOW_STARTED": [
+      "/lastFailure"
+    ],
+    "ACTIVITY_FAILED": [
+      "/failure"
+    ],
+    "ACTIVITY_TIMED_OUT": [
+      "/failure"
+    ],
+    "UPDATE_COMPLETED": [
+      "/failure"
+    ],
+    "CHILD_RUN_FAILED": [
+      "/failure"
+    ],
+    "EXTERNAL_RUN_SIGNALED": [
+      "/failure"
+    ],
+    "EXTERNAL_RUN_CANCEL_RESOLVED": [
+      "/failure"
+    ],
+    "LOCAL_ACTIVITY_FAILED": [
+      "/failure"
+    ],
+    "WORKFLOW_FAILED": [
+      "/failure"
+    ],
+    "WORKFLOW_TIMED_OUT": [
+      "/failure"
+    ]
+  },
+  "commandFailures": {
+    "FAIL_WORKFLOW": [
+      "/failure"
+    ],
+    "RECORD_LOCAL_ACTIVITY": [
+      "/failure"
+    ],
+    "REJECT_UPDATE": [
+      "/failure"
+    ],
+    "COMPLETE_UPDATE": [
+      "/failure"
+    ]
+  },
+  "failure": {
+    "payloads": [
+      "/details"
+    ],
+    "cause": "/cause"
+  }
+}

package/schema/run-event.schema.json

@@ -1360,6 +1360,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)."
         }
       }
     },
@@ -1436,7 +1448,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",
@@ -1567,6 +1580,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)."
         }
       }
     },
@@ -1704,85 +1736,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",
@@ -2044,6 +2184,9 @@
         "actor": {},
         "idempotencyKey": {
           "type": "string"
+        },
+        "headers": {
+          "$ref": "#/$defs/headers"
         }
       }
     },
@@ -2064,7 +2207,10 @@
           "minLength": 1,
           "maxLength": 256
         },
-        "args": {}
+        "args": {},
+        "headers": {
+          "$ref": "#/$defs/headers"
+        }
       }
     },
     "payload_UPDATE_ACCEPTED": {
@@ -2084,7 +2230,10 @@
           "minLength": 1,
           "maxLength": 256
         },
-        "args": {}
+        "args": {},
+        "headers": {
+          "$ref": "#/$defs/headers"
+        }
       }
     },
     "payload_UPDATE_COMPLETED": {
@@ -2142,6 +2291,9 @@
             "GRAPH",
             "DURABLE_FN"
           ]
+        },
+        "headers": {
+          "$ref": "#/$defs/headers"
         }
       }
     },
@@ -2512,6 +2664,13 @@
         },
         "reason": {
           "type": "string"
+        },
+        "actor": {},
+        "reapplySignals": {
+          "type": "boolean"
+        },
+        "reapplyUpdates": {
+          "type": "boolean"
         }
       }
     },