@fluidgrids/workflows 2026.1028.2 → 2026.1030.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
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
         }
       ]
     },
@@ -463,6 +708,38 @@
             "PINNED",
             "AUTO_UPGRADE"
           ]
+        },
+        "retry": {
+          "type": "object",
+          "description": "Run-level retry of DURABLE_FN runs (11 §2.17); delays are seconds or duration strings. Graph runs keep their own meaning of retry.",
+          "properties": {
+            "maxAttempts": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "initialDelay": {
+              "type": [
+                "number",
+                "string"
+              ]
+            },
+            "backoffMultiplier": {
+              "type": "number",
+              "minimum": 1
+            },
+            "maxDelay": {
+              "type": [
+                "number",
+                "string"
+              ]
+            },
+            "nonRetryableErrorTypes": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
         }
       }
     },
@@ -588,6 +865,10 @@
                   },
                   "taskQueue": {
                     "type": "string"
+                  },
+                  "config": {
+                    "$ref": "#/$defs/config",
+                    "description": "R2: the run-level settings of this function's workflow() declaration (retry, timeout, executionTimeout, workflowTaskTimeout, versioningBehavior). The service resolves run options per workflowFn from this table, never from the definition-level config, so a same-bundle child started on its parent's definition gets its own settings. Absent: the function declares none."
                   }
                 }
               }
@@ -616,6 +897,15 @@
             "isolate",
             "worker"
           ]
+        },
+        "features": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true,
+          "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."
         }
       }
     },

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"
+  }
+}