@lostgradient/weft 0.20.0 → 0.22.0

package/README.md

@@ -1,6 +1,6 @@
 # Weft
 
-A Bun-native durable execution engine. Current release: `0.19.0`.
+A Bun-native durable execution engine. Current release: `0.22.0`.
 
 Install the library from npm as `@lostgradient/weft`:
 
@@ -96,7 +96,7 @@ const result = await handle.result();
 
 That's the core loop: `workflow({ name })` is a **chained builder** that co-locates the workflow's side-effecting steps inside `.activities({...})`, and `.execute(fn)` seals it all together and returns a `WorkflowDefinition`. Inside the generator, `ctx.run('formatGreeting', input)` autocompletes from the workflow's own activity table, typechecks the input, and infers the output. Every `yield*` is a checkpoint boundary; `handle.result()` waits for the output. Checkpoints are written to `./weft.db`, so running workflows survive process crashes.
 
-`Engine.create()` does the registration dance for you: it constructs the engine and registers each workflow in the `workflows` map, pulling in all the activities each workflow declares. It then **recovers by default** — `engine.recoverAll()` runs after registration, so any workflows still running from a previous process pick up where they left off. That's the point of durable storage, so you don't have to ask for it. Pass `recover: false` to opt out (handy for tests, for `ScopedStorage`-isolated engines, or when you want to inspect a store before migrating it). Durability is separate: each step is persisted before it commits no matter what `recover` is set to — `recover` only decides whether _this_ engine resumes that persisted work on boot. If a host owns recovery but still needs durable timers, use `startScheduler: true`; otherwise `recover: false` also leaves the real-time scheduler stopped. Run a single engine per durable store; pointing two at the same store is not yet coordinated and can double-resume a workflow.
+`Engine.create()` does the registration dance for you: it constructs the engine and registers each workflow in the `workflows` map, pulling in all the activities each workflow declares. It then **recovers by default** — `engine.recoverAll()` runs after registration, so any workflows still running from a previous process pick up where they left off. That's the point of durable storage, so you don't have to ask for it. Pass `recover: false` to opt out (handy for tests, for `ScopedStorage`-isolated engines, or when you want to inspect a store before migrating it). Durability is separate: each step is persisted before it commits no matter what `recover` is set to — `recover` only decides whether _this_ engine resumes that persisted work on boot. If a host owns recovery but still needs durable timers, use `startScheduler: true`; otherwise `recover: false` also leaves the real-time scheduler stopped. By default (`ownership: 'none'`) run a single engine per durable store: pointing two at the same store is uncoordinated and can double-resume a workflow. To share one store across engines, select `ownership: 'workflow-lease'`, which claims each workflow for exactly one engine before its generator runs.
 
 Passing an explicitly empty workflow map is the same default-registry boot shape as omitting `workflows`: `Engine.create({ workflows: {} })` recovers after registration and returns an engine whose TypeScript type is compatible with default-registry consumers such as `serve({ engine })`. Use a non-empty `workflows` map when you want TypeScript to narrow `engine.start(...)` to the registered names.
 

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

@@ -1620,6 +1620,10 @@
       "inputSchema": {
         "additionalProperties": false,
         "properties": {
+          "includeExpectedDelayed": {
+            "default": false,
+            "type": "boolean"
+          },
           "limit": {
             "default": 50,
             "maximum": 200,
@@ -1652,6 +1656,12 @@
             "minimum": 0,
             "type": "integer"
           },
+          "unadoptedAfterMs": {
+            "default": 60000,
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
           "workflowId": {
             "minLength": 1,
             "type": "string"
@@ -1661,6 +1671,8 @@
           "staleQueuedAfterMs",
           "staleHeartbeatAfterMs",
           "retryStormMinimumAttempts",
+          "includeExpectedDelayed",
+          "unadoptedAfterMs",
           "limit"
         ],
         "type": "object"
@@ -1670,90 +1682,193 @@
         "properties": {
           "items": {
             "items": {
-              "additionalProperties": false,
-              "properties": {
-                "activityName": {
-                  "type": "string"
-                },
-                "deadLetterReason": {
-                  "const": "result-resolution-storage-exhausted",
-                  "type": "string"
-                },
-                "deadLetteredAt": {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "evidence": {
-                  "items": {
-                    "type": "string"
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "activityName": {
+                      "type": "string"
+                    },
+                    "deadLetterReason": {
+                      "const": "result-resolution-storage-exhausted",
+                      "type": "string"
+                    },
+                    "deadLetteredAt": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "evidence": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "executionLatencyMs": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "heartbeatAgeMs": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "kind": {
+                      "enum": [
+                        "stuck-queued",
+                        "stale-inflight",
+                        "retry-storm",
+                        "all-workers-at-capacity",
+                        "dead-lettered"
+                      ],
+                      "type": "string"
+                    },
+                    "lastRequeueReason": {
+                      "type": "string"
+                    },
+                    "operationId": {
+                      "type": "string"
+                    },
+                    "queue": {
+                      "type": "string"
+                    },
+                    "queueLatencyMs": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "requeueCount": {
+                      "maximum": 9007199254740991,
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    "resolutionReason": {
+                      "type": "string"
+                    },
+                    "retryAttempts": {
+                      "maximum": 9007199254740991,
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    "retryCount": {
+                      "maximum": 9007199254740991,
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    "state": {
+                      "enum": ["queued", "inflight", "resolved", "capacity", "dead-lettered"],
+                      "type": "string"
+                    },
+                    "storageError": {
+                      "type": "string"
+                    },
+                    "workerId": {
+                      "type": "string"
+                    },
+                    "workflowId": {
+                      "type": "string"
+                    }
                   },
-                  "type": "array"
-                },
-                "executionLatencyMs": {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "heartbeatAgeMs": {
-                  "minimum": 0,
-                  "type": "number"
+                  "required": ["kind", "state", "retryCount", "requeueCount", "evidence"],
+                  "type": "object"
                 },
-                "kind": {
-                  "enum": [
-                    "stuck-queued",
-                    "stale-inflight",
-                    "retry-storm",
-                    "all-workers-at-capacity",
-                    "dead-lettered"
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "availableAt": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "evidence": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "kind": {
+                      "const": "delayed",
+                      "type": "string"
+                    },
+                    "operationId": {
+                      "type": "string"
+                    },
+                    "queue": {
+                      "type": "string"
+                    },
+                    "requeueCount": {
+                      "maximum": 9007199254740991,
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    "retryCount": {
+                      "maximum": 9007199254740991,
+                      "minimum": 0,
+                      "type": "integer"
+                    },
+                    "state": {
+                      "const": "queued",
+                      "type": "string"
+                    },
+                    "workflowId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "state",
+                    "operationId",
+                    "queue",
+                    "retryCount",
+                    "requeueCount",
+                    "availableAt",
+                    "evidence"
                   ],
-                  "type": "string"
-                },
-                "lastRequeueReason": {
-                  "type": "string"
-                },
-                "operationId": {
-                  "type": "string"
-                },
-                "queue": {
-                  "type": "string"
-                },
-                "queueLatencyMs": {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "requeueCount": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "resolutionReason": {
-                  "type": "string"
-                },
-                "retryAttempts": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "retryCount": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "state": {
-                  "enum": ["queued", "inflight", "resolved", "capacity", "dead-lettered"],
-                  "type": "string"
-                },
-                "storageError": {
-                  "type": "string"
-                },
-                "workerId": {
-                  "type": "string"
+                  "type": "object"
                 },
-                "workflowId": {
-                  "type": "string"
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "adopted": {
+                      "const": false,
+                      "type": "boolean"
+                    },
+                    "evidence": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "kind": {
+                      "const": "unadopted-terminal",
+                      "type": "string"
+                    },
+                    "operationId": {
+                      "type": "string"
+                    },
+                    "queue": {
+                      "type": "string"
+                    },
+                    "state": {
+                      "const": "resolved",
+                      "type": "string"
+                    },
+                    "terminalAt": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "workflowId": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "state",
+                    "operationId",
+                    "queue",
+                    "terminalAt",
+                    "adopted",
+                    "evidence"
+                  ],
+                  "type": "object"
                 }
-              },
-              "required": ["kind", "state", "retryCount", "requeueCount", "evidence"],
-              "type": "object"
+              ]
             },
             "type": "array"
           },
@@ -1775,6 +1890,11 @@
                 "minimum": 0,
                 "type": "integer"
               },
+              "delayed": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
               "retryStorms": {
                 "maximum": 9007199254740991,
                 "minimum": 0,
@@ -1789,6 +1909,11 @@
                 "maximum": 9007199254740991,
                 "minimum": 0,
                 "type": "integer"
+              },
+              "unadoptedTerminal": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
               }
             },
             "required": [
@@ -1796,7 +1921,9 @@
               "staleInflight",
               "retryStorms",
               "allWorkersAtCapacity",
-              "deadLettered"
+              "deadLettered",
+              "delayed",
+              "unadoptedTerminal"
             ],
             "type": "object"
           }