@lostgradient/weft 0.23.1 → 0.24.1

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

@@ -169,6 +169,146 @@
         "type": "object"
       }
     },
+    {
+      "name": "weft.catalog.diagnostics",
+      "kind": "unary",
+      "summary": "Get bounded reference-count and removability diagnostics for one workflow revision",
+      "description": "Report whether a `(name, revision)` workflow catalog entry is installed, whether it is currently the active revision, its full reference-count breakdown, and whether it's currently removable. When `name` was ever registered as a dynamic workflow source (`engine.registerSource()`), also reports its bounded load-state diagnostics: source kind, load state, load duration, last failure category, and outstanding waiter count. Never returns manifest or contract content.",
+      "tags": ["Observability"],
+      "destructive": false,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["system:read"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": [],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "revision": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": ["name", "revision"],
+        "type": "object"
+      },
+      "outputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "active": {
+            "type": "boolean"
+          },
+          "activeRevision": {
+            "type": "string"
+          },
+          "installed": {
+            "type": "boolean"
+          },
+          "name": {
+            "type": "string"
+          },
+          "references": {
+            "additionalProperties": false,
+            "properties": {
+              "activeExecutionRealms": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "inFlightStarts": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "nonTerminalRuns": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "pendingDispatches": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "pinnedSchedules": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "registeredDefinitions": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "retainedRecoveryRecords": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "registeredDefinitions",
+              "inFlightStarts",
+              "nonTerminalRuns",
+              "pinnedSchedules",
+              "pendingDispatches",
+              "activeExecutionRealms",
+              "retainedRecoveryRecords"
+            ],
+            "type": "object"
+          },
+          "removable": {
+            "type": "boolean"
+          },
+          "revision": {
+            "type": "string"
+          },
+          "source": {
+            "additionalProperties": false,
+            "properties": {
+              "kind": {
+                "const": "module",
+                "type": "string"
+              },
+              "lastFailureCategory": {
+                "enum": ["application", "timeout", "cancellation", "resource", "system"],
+                "type": "string"
+              },
+              "loadDurationMs": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "requestedRevision": {
+                "type": "string"
+              },
+              "state": {
+                "enum": ["idle", "loading", "ready", "failed", "cancelled"],
+                "type": "string"
+              },
+              "waiterCount": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              }
+            },
+            "required": ["kind", "requestedRevision", "state", "waiterCount"],
+            "type": "object"
+          }
+        },
+        "required": ["name", "revision", "installed", "active", "references", "removable"],
+        "type": "object"
+      }
+    },
     {
       "name": "weft.events.sse",
       "kind": "stream",
@@ -817,6 +957,9 @@
           "input": {},
           "jitter": {},
           "overlap": {},
+          "revisionPolicy": {
+            "description": "Revision policy (WFT-20). Runtime validation requires \"active-at-fire\" or \"pinned\"; defaults to \"active-at-fire\"."
+          },
           "type": {
             "description": "Workflow type name. Runtime validation requires a non-empty string."
           }
@@ -986,6 +1129,9 @@
           },
           "jitter": {},
           "overlap": {},
+          "revisionPolicy": {
+            "description": "Revision policy (WFT-20). Runtime validation requires \"active-at-fire\" or \"pinned\". Omitted preserves the current policy (and pin); \"pinned\" always re-resolves and re-captures the pin against the revision active right now."
+          },
           "scheduleId": {
             "minLength": 1,
             "type": "string"
@@ -1575,14 +1721,27 @@
       "outputSchema": {
         "additionalProperties": false,
         "properties": {
+          "activeRevisions": {},
           "activities": {},
+          "generatedAt": {
+            "type": "string"
+          },
           "registryVersion": {
-            "const": 1,
+            "const": 2,
             "type": "number"
           },
-          "workflows": {}
+          "workflows": {
+            "items": {},
+            "type": "array"
+          }
         },
-        "required": ["registryVersion", "workflows", "activities"],
+        "required": [
+          "registryVersion",
+          "generatedAt",
+          "workflows",
+          "activeRevisions",
+          "activities"
+        ],
         "type": "object"
       }
     },
@@ -2229,6 +2388,9 @@
               "workflowId": {
                 "type": "string"
               },
+              "workflowRevision": {
+                "type": "string"
+              },
               "workflowType": {
                 "type": "string"
               }
@@ -2390,6 +2552,9 @@
               "workflowId": {
                 "type": "string"
               },
+              "workflowRevision": {
+                "type": "string"
+              },
               "workflowType": {
                 "type": "string"
               }
@@ -2560,6 +2725,9 @@
               "workflowId": {
                 "type": "string"
               },
+              "workflowRevision": {
+                "type": "string"
+              },
               "workflowType": {
                 "type": "string"
               }
@@ -2731,6 +2899,9 @@
               "workflowId": {
                 "type": "string"
               },
+              "workflowRevision": {
+                "type": "string"
+              },
               "workflowType": {
                 "type": "string"
               }
@@ -2898,6 +3069,9 @@
                   "workflowId": {
                     "type": "string"
                   },
+                  "workflowRevision": {
+                    "type": "string"
+                  },
                   "workflowType": {
                     "type": "string"
                   }
@@ -3052,6 +3226,9 @@
                   "workflowId": {
                     "type": "string"
                   },
+                  "workflowRevision": {
+                    "type": "string"
+                  },
                   "workflowType": {
                     "type": "string"
                   }
@@ -3205,6 +3382,9 @@
                   "workflowId": {
                     "type": "string"
                   },
+                  "workflowRevision": {
+                    "type": "string"
+                  },
                   "workflowType": {
                     "type": "string"
                   }
@@ -3368,6 +3548,9 @@
               "workflowId": {
                 "type": "string"
               },
+              "workflowRevision": {
+                "type": "string"
+              },
               "workflowType": {
                 "type": "string"
               }
@@ -4241,6 +4424,36 @@
         ]
       }
     },
+    {
+      "name": "weft.workflows.active.get",
+      "kind": "unary",
+      "summary": "Get the currently active revision pointer for a workflow",
+      "description": "Read the current `{ revision, generation, activatedAt }` active pointer for `name`. Read-only, in-memory (matches `RegistrySnapshot.activeRevisions`' staleness contract exactly). Faults with NotFound when `name` has never been activated.",
+      "tags": ["Workflow Catalog"],
+      "destructive": false,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["workflows:read"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": ["InvalidParams", "NotFound"],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "description": "Workflow name. Runtime validation requires a wire-safe identifier."
+          }
+        },
+        "required": ["name"],
+        "type": "object"
+      },
+      "outputSchema": {}
+    },
     {
       "name": "weft.workflows.activities.pending.list",
       "kind": "unary",
@@ -7466,6 +7679,171 @@
         "type": "object"
       }
     },
+    {
+      "name": "weft.workflows.revisions.activate",
+      "kind": "unary",
+      "summary": "Activate an installed workflow revision",
+      "description": "Activate an already-installed `(name, revision)` as the durably advertised active revision for `name`. Returns the structured result verbatim: `{ applied: true, pointer }` on success, or `{ applied: false, reason, ... }` on refusal — surfaced as a Conflict fault with `reason` one of `incompatible`, `stale-generation`, `expected-generation-required`, or `conflict`. Faults with NotFound when the revision was never installed. Never changes which in-process handler `engine.start()` dispatches to — see the workflow-versioning guide.",
+      "tags": ["Workflow Catalog"],
+      "destructive": true,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["workflows:admin"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": ["Conflict", "InvalidParams", "NotFound"],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "expectedGeneration": {
+            "description": "The durable generation this caller last observed. Required once the workflow has an active revision — omitting it there refuses with expected-generation-required."
+          },
+          "name": {
+            "description": "Workflow name. Runtime validation requires a wire-safe identifier."
+          },
+          "policy": {
+            "description": "Optional compatibility policy override."
+          },
+          "revision": {
+            "description": "Installed revision to activate. Runtime validation requires a non-empty string."
+          }
+        },
+        "required": ["name", "revision"],
+        "type": "object"
+      },
+      "outputSchema": {}
+    },
+    {
+      "name": "weft.workflows.revisions.get",
+      "kind": "unary",
+      "summary": "Get one installed workflow revision",
+      "description": "Read one durably installed `(name, revision)` workflow catalog record. Read-only. Faults with NotFound when no such revision was installed.",
+      "tags": ["Workflow Catalog"],
+      "destructive": false,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["workflows:read"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": ["InvalidParams", "NotFound"],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "description": "Workflow name. Runtime validation requires a wire-safe identifier."
+          },
+          "revision": {
+            "description": "Installed revision. Runtime validation requires a non-empty string."
+          }
+        },
+        "required": ["name", "revision"],
+        "type": "object"
+      },
+      "outputSchema": {}
+    },
+    {
+      "name": "weft.workflows.revisions.install",
+      "kind": "unary",
+      "summary": "Durably install a workflow revision manifest",
+      "description": "Validate and durably install a `WorkflowRevisionManifest` for a workflow the engine already has an in-process definition for. Idempotent on a byte-identical reinstall of the same (name, revision). Faults with InvalidParams when the manifest fails validation or names a workflow with no in-process definition, and Conflict when (name, revision) is already installed with different contract content. Does not check `manifest.workflowVersion` against the in-process definition's own version — that mismatch is a normal activation-time `incompatible` refusal, not an install-time error. Never changes which in-process handler `engine.start()` dispatches to.",
+      "tags": ["Workflow Catalog"],
+      "destructive": false,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["workflows:admin"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": ["Conflict", "InvalidParams"],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "manifest": {
+            "description": "An untrusted WorkflowRevisionManifest, validated at invoke time."
+          }
+        },
+        "required": ["manifest"],
+        "type": "object"
+      },
+      "outputSchema": {}
+    },
+    {
+      "name": "weft.workflows.revisions.list",
+      "kind": "unary",
+      "summary": "List every installed revision of a workflow",
+      "description": "Read every durably installed revision of `name`, sorted deterministically by revision. Read-only. Returns an empty array for a name with no installed revisions, rather than a NotFound fault — an empty catalog is not an error.",
+      "tags": ["Workflow Catalog"],
+      "destructive": false,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["workflows:read"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": ["InvalidParams"],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "description": "Workflow name. Runtime validation requires a wire-safe identifier."
+          }
+        },
+        "required": ["name"],
+        "type": "object"
+      },
+      "outputSchema": {}
+    },
+    {
+      "name": "weft.workflows.revisions.preload",
+      "kind": "unary",
+      "summary": "Load, validate, and install a registered dynamic workflow source revision",
+      "description": "Load, validate, and install `(name, revision)` — previously recorded via engine.registerSource() — durably into the workflow catalog. Faults NotFound when no source was ever registered for this exact key, and Conflict when the load fails or the loaded module fails validation.",
+      "tags": ["Workflow Catalog"],
+      "destructive": false,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["workflows:admin"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": ["Conflict", "InvalidParams", "NotFound"],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "description": "Workflow name. Runtime validation requires a wire-safe identifier."
+          },
+          "revision": {
+            "description": "The registerSource()-registered revision to load, validate, and install. Runtime validation requires a non-empty string."
+          }
+        },
+        "required": ["name", "revision"],
+        "type": "object"
+      },
+      "outputSchema": {}
+    },
     {
       "name": "weft.workflows.scheduleprovenance.get",
       "kind": "unary",