@lostgradient/weft 0.12.0 → 0.14.0

package/dist/cli/generated/operation-catalog.snapshot.json

@@ -10,7 +10,8 @@
       "tags": ["Activities"],
       "destructive": true,
       "access": {
-        "kind": "public"
+        "kind": "scoped",
+        "scopes": ["workflows:write"]
       },
       "transports": {
         "http": true,
@@ -51,7 +52,8 @@
       "tags": ["Activities"],
       "destructive": true,
       "access": {
-        "kind": "public"
+        "kind": "scoped",
+        "scopes": ["workflows:write"]
       },
       "transports": {
         "http": true,
@@ -811,7 +813,7 @@
       "name": "weft.schedules.update",
       "kind": "unary",
       "summary": "Update a recurring schedule",
-      "description": "Update an existing recurring schedule by `id`, replacing its recurrence specification, target workflow input, or start options. Returns null on success. Faults with NotFound when no schedule with the given id exists and InvalidParams for a malformed recurrence specification.",
+      "description": "Update an existing recurring schedule by `id`, replacing its recurrence specification and optionally changing description, overlap, backfill, or jitter. Omitted options retain their persisted values; schedule id, workflow type, and input remain unchanged. Returns null on success. Faults with NotFound when no schedule with the given id exists and InvalidParams for malformed fields.",
       "tags": ["Schedules"],
       "destructive": false,
       "access": {
@@ -823,16 +825,22 @@
         "jsonRpcWebSocket": true,
         "jsonRpcStdio": true
       },
-      "producibleFaults": ["Conflict", "NotFound"],
+      "producibleFaults": ["Conflict", "InvalidParams", "NotFound"],
       "inputSchema": {
         "additionalProperties": false,
         "properties": {
+          "backfill": {},
           "cronExpression": {
             "description": "Cron expression. Supply exactly one of cronExpression or every; runtime validation requires a non-empty string."
           },
+          "description": {
+            "description": "Operator-facing schedule description. Runtime validation requires a string."
+          },
           "every": {
             "description": "Interval period (duration string or milliseconds). Supply exactly one of cronExpression or every."
           },
+          "jitter": {},
+          "overlap": {},
           "scheduleId": {
             "minLength": 1,
             "type": "string"
@@ -853,7 +861,7 @@
       "destructive": true,
       "access": {
         "kind": "scoped",
-        "scopes": ["storage:admin", "storage:write"]
+        "scopes": ["storage:admin"]
       },
       "transports": {
         "http": true,
@@ -914,6 +922,64 @@
         "type": "null"
       }
     },
+    {
+      "name": "weft.storage.capabilities",
+      "kind": "unary",
+      "summary": "Report the connected storage backend's capability profile",
+      "tags": ["Storage"],
+      "destructive": false,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["storage:admin", "storage:read"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": [],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {},
+        "type": "object"
+      },
+      "outputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "atomicBatch": {
+            "type": "boolean"
+          },
+          "boundedRangeDelete": {
+            "type": "boolean"
+          },
+          "conditionalBatch": {
+            "type": "boolean"
+          },
+          "persistence": {
+            "enum": ["ephemeral", "local", "remote"],
+            "type": "string"
+          },
+          "readAfterWrite": {
+            "enum": ["linearizable", "session", "eventual"],
+            "type": "string"
+          },
+          "scanConsistency": {
+            "enum": ["snapshot", "best-effort"],
+            "type": "string"
+          }
+        },
+        "required": [
+          "persistence",
+          "readAfterWrite",
+          "scanConsistency",
+          "atomicBatch",
+          "conditionalBatch",
+          "boundedRangeDelete"
+        ],
+        "type": "object"
+      }
+    },
     {
       "name": "weft.storage.conditionalbatch",
       "kind": "unary",
@@ -921,8 +987,8 @@
       "tags": ["Storage"],
       "destructive": true,
       "access": {
-        "kind": "scopedAlternatives",
-        "alternatives": [["storage:admin"], ["storage:read", "storage:write"]]
+        "kind": "scoped",
+        "scopes": ["storage:admin"]
       },
       "transports": {
         "http": true,
@@ -1023,7 +1089,7 @@
       "destructive": true,
       "access": {
         "kind": "scoped",
-        "scopes": ["storage:admin", "storage:write"]
+        "scopes": ["storage:admin"]
       },
       "transports": {
         "http": true,
@@ -1055,7 +1121,7 @@
       "destructive": false,
       "access": {
         "kind": "scoped",
-        "scopes": ["storage:admin", "storage:read"]
+        "scopes": ["storage:admin"]
       },
       "transports": {
         "http": true,
@@ -1095,7 +1161,7 @@
       "destructive": true,
       "access": {
         "kind": "scoped",
-        "scopes": ["storage:admin", "storage:write"]
+        "scopes": ["storage:admin"]
       },
       "transports": {
         "http": true,
@@ -1131,7 +1197,7 @@
       "destructive": false,
       "access": {
         "kind": "scoped",
-        "scopes": ["storage:admin", "storage:read"]
+        "scopes": ["storage:admin"]
       },
       "transports": {
         "http": true,
@@ -1172,6 +1238,76 @@
       },
       "outputSchema": {}
     },
+    {
+      "name": "weft.system.lease",
+      "kind": "unary",
+      "summary": "Get ownership-lease health for this engine process",
+      "description": "Reports whether lease ownership is disabled, not yet held, healthy, or contested. Contested results preserve the confirmed deposed or renewal-unconfirmable reason.",
+      "tags": ["System"],
+      "destructive": false,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["system:read"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": [],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {},
+        "type": "object"
+      },
+      "outputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "expiresAt": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "fencingEpoch": {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          "heldSince": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "holderId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "holdsLease": {
+            "type": "boolean"
+          },
+          "lastRenewedAt": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "lossReason": {
+            "enum": ["deposed", "renewal-unconfirmable"],
+            "type": "string"
+          },
+          "mode": {
+            "enum": ["none", "lease"],
+            "type": "string"
+          },
+          "status": {
+            "enum": ["disabled", "healthy", "no-lease", "contested"],
+            "type": "string"
+          }
+        },
+        "required": ["mode", "status", "holdsLease"],
+        "type": "object"
+      }
+    },
     {
       "name": "weft.system.metrics",
       "kind": "unary",
@@ -1564,6 +1700,20 @@
         },
         "required": ["ok"],
         "type": "object"
+      },
+      "rest": {
+        "method": "DELETE",
+        "path": "/v1/tasks/diagnostics/dead-letter/:operationId",
+        "inputSources": {
+          "operationId": {
+            "kind": "path",
+            "pathParam": "operationId"
+          }
+        },
+        "success": {
+          "kind": "json",
+          "status": 200
+        }
       }
     },
     {
@@ -2170,6 +2320,88 @@
         ]
       }
     },
+    {
+      "name": "weft.workflows.activities.pending.list",
+      "kind": "unary",
+      "summary": "List pending async activities for a workflow",
+      "description": "Read a bounded, deterministic page of durable activity task tokens awaiting out-of-band completion. The cursor is opaque and scoped to the selected workflow. A listed token may be consumed concurrently, so a later completion can return NotFound.",
+      "tags": ["Activities"],
+      "destructive": false,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["workflows:read"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcStdio": true,
+        "jsonRpcWebSocket": true
+      },
+      "producibleFaults": ["InvalidParams", "NotFound"],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "cursor": {
+            "maxLength": 8192,
+            "type": "string"
+          },
+          "limit": {
+            "default": 50,
+            "maximum": 200,
+            "minimum": 1,
+            "type": "integer"
+          },
+          "workflowId": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": ["workflowId", "limit"],
+        "type": "object"
+      },
+      "outputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "activityName": {
+                  "type": "string"
+                },
+                "attempt": {
+                  "exclusiveMinimum": 0,
+                  "maximum": 9007199254740991,
+                  "type": "integer"
+                },
+                "createdAt": {
+                  "type": "number"
+                },
+                "operationId": {
+                  "type": "string"
+                },
+                "step": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "token": {
+                  "type": "string"
+                }
+              },
+              "required": ["token", "operationId", "activityName", "step", "attempt", "createdAt"],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "nextCursor": {
+            "type": "string"
+          }
+        },
+        "required": ["items"],
+        "type": "object"
+      }
+    },
     {
       "name": "weft.workflows.aggregate",
       "kind": "unary",
@@ -2397,6 +2629,18 @@
             "minimum": 1,
             "type": "integer"
           },
+          "parentWorkflowExecutionToken": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "parentWorkflowId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "scheduleId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "status": {
             "anyOf": [
               {
@@ -2680,11 +2924,23 @@
             "minimum": 0,
             "type": "integer"
           },
+          "parentWorkflowExecutionToken": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "parentWorkflowId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "requestId": {
             "maxLength": 200,
             "minLength": 1,
             "type": "string"
           },
+          "scheduleId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "status": {
             "anyOf": [
               {},
@@ -2836,11 +3092,23 @@
             "minimum": 0,
             "type": "integer"
           },
+          "parentWorkflowExecutionToken": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "parentWorkflowId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "requestId": {
             "maxLength": 200,
             "minLength": 1,
             "type": "string"
           },
+          "scheduleId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "status": {
             "anyOf": [
               {},
@@ -2992,11 +3260,23 @@
             "minimum": 0,
             "type": "integer"
           },
+          "parentWorkflowExecutionToken": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "parentWorkflowId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "requestId": {
             "maxLength": 200,
             "minLength": 1,
             "type": "string"
           },
+          "scheduleId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "status": {
             "anyOf": [
               {},
@@ -3152,12 +3432,24 @@
             "minimum": 0,
             "type": "integer"
           },
+          "parentWorkflowExecutionToken": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "parentWorkflowId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "payload": {},
           "requestId": {
             "maxLength": 200,
             "minLength": 1,
             "type": "string"
           },
+          "scheduleId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "status": {
             "anyOf": [
               {},
@@ -3313,6 +3605,18 @@
                 "minimum": 0,
                 "type": "integer"
               },
+              "parentWorkflowExecutionToken": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "parentWorkflowId": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "scheduleId": {
+                "minLength": 1,
+                "type": "string"
+              },
               "status": {
                 "anyOf": [
                   {},
@@ -3696,6 +4000,125 @@
         "type": "object"
       }
     },
+    {
+      "name": "weft.workflows.finalizer.get",
+      "kind": "unary",
+      "summary": "Get workflow finalizer progress and outcome",
+      "description": "Read durable post-terminal finalizer progress or its succeeded or failed outcome. Returns null when the workflow did not record finalizer work.",
+      "tags": ["Workflows"],
+      "destructive": false,
+      "access": {
+        "kind": "public"
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": [],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "workflowId": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": ["workflowId"],
+        "type": "object"
+      },
+      "outputSchema": {
+        "anyOf": [
+          {
+            "oneOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "attempts": {
+                    "maximum": 9007199254740991,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "status": {
+                    "const": "pending",
+                    "type": "string"
+                  }
+                },
+                "required": ["status", "attempts"],
+                "type": "object"
+              },
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "attempts": {
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "type": "integer"
+                  },
+                  "startedAt": {
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "status": {
+                    "const": "running",
+                    "type": "string"
+                  }
+                },
+                "required": ["status", "attempts", "startedAt"],
+                "type": "object"
+              },
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "attempts": {
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "type": "integer"
+                  },
+                  "completedAt": {
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "status": {
+                    "const": "succeeded",
+                    "type": "string"
+                  }
+                },
+                "required": ["status", "attempts", "completedAt"],
+                "type": "object"
+              },
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "attempts": {
+                    "maximum": 9007199254740991,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "error": {
+                    "type": "string"
+                  },
+                  "failedAt": {
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  "status": {
+                    "const": "failed",
+                    "type": "string"
+                  }
+                },
+                "required": ["status", "attempts", "failedAt", "error"],
+                "type": "object"
+              }
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
     {
       "name": "weft.workflows.fork",
       "kind": "unary",
@@ -3769,7 +4192,7 @@
       "name": "weft.workflows.list",
       "kind": "unary",
       "summary": "List workflows",
-      "description": "List workflows visible to the caller, optionally filtered by status, type, tags, id prefix, failure category, and time range, with pagination via `limit`/`offset`. Read-only. Returns the matching workflow summaries in the engine default ordering.",
+      "description": "List workflows visible to the caller, optionally filtered by status, type, originating schedule, direct parent run, tags, id prefix, failure category, and time range, with pagination via `limit`/`offset`. Read-only. Returns the matching workflow summaries in the engine default ordering.",
       "tags": ["Workflows"],
       "destructive": false,
       "access": {
@@ -3876,6 +4299,18 @@
             "minimum": 0,
             "type": "integer"
           },
+          "parentWorkflowExecutionToken": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "parentWorkflowId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "scheduleId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "status": {
             "anyOf": [
               {},
@@ -4013,6 +4448,18 @@
             "minimum": 0,
             "type": "integer"
           },
+          "parentWorkflowExecutionToken": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "parentWorkflowId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "scheduleId": {
+            "minLength": 1,
+            "type": "string"
+          },
           "status": {
             "anyOf": [
               {},
@@ -4198,6 +4645,55 @@
         "type": "object"
       }
     },
+    {
+      "name": "weft.workflows.scheduleprovenance.get",
+      "kind": "unary",
+      "summary": "Get the schedule occurrence that launched a workflow",
+      "description": "Read the durable schedule id and optional occurrence timestamp that launched a workflow. Returns null for runs that were not launched by a schedule or whose workflow history was purged.",
+      "tags": ["Workflows"],
+      "destructive": false,
+      "access": {
+        "kind": "public"
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": [],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "workflowId": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": ["workflowId"],
+        "type": "object"
+      },
+      "outputSchema": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "occurrence": {
+                "type": "number"
+              },
+              "scheduleId": {
+                "type": "string"
+              }
+            },
+            "required": ["scheduleId"],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
     {
       "name": "weft.workflows.signal",
       "kind": "unary",