@lostgradient/weft 0.17.0 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (172) hide show
  1. package/README.md +3 -1
  2. package/dist/cli/conformance.js +14 -18
  3. package/dist/cli/generated/operation-catalog.snapshot.json +331 -16
  4. package/dist/cli/generated/operation-client.generated.d.ts +39 -6
  5. package/dist/cli/generated/operation-client.generated.js +6 -0
  6. package/dist/core/context/child-workflow-pipe.d.ts +1 -1
  7. package/dist/core/context/child-workflow-pipe.js +1 -1
  8. package/dist/core/engine/construction.d.ts +2 -0
  9. package/dist/core/engine/construction.js +3 -0
  10. package/dist/core/engine/index.js +1 -0
  11. package/dist/core/engine/listing.d.ts +1 -0
  12. package/dist/core/engine/listing.js +6 -4
  13. package/dist/core/weft-error.d.ts +1 -1
  14. package/dist/core/weft-error.js +2 -1
  15. package/dist/core/worker-execution-dispatcher.d.ts +8 -0
  16. package/dist/core/worker-execution-dispatcher.js +4 -0
  17. package/dist/core/worker-execution-strategy-options.d.ts +16 -0
  18. package/dist/core/worker-execution-strategy.js +71 -89
  19. package/dist/core/worker-fault-handling.d.ts +45 -0
  20. package/dist/core/worker-fault-handling.js +88 -0
  21. package/dist/core/worker-protocol.d.ts +18 -1
  22. package/dist/core/worker-protocol.js +1 -1
  23. package/dist/core/worker-realm-readiness.d.ts +78 -0
  24. package/dist/core/worker-realm-readiness.js +127 -0
  25. package/dist/index.d.ts +3 -1
  26. package/dist/index.js +28 -1
  27. package/dist/json-schema.js +1 -1
  28. package/dist/runtime/portable.d.ts +14 -0
  29. package/dist/runtime/portable.js +10 -0
  30. package/dist/server/authorization-scope.d.ts +32 -2
  31. package/dist/server/index.d.ts +73 -8
  32. package/dist/server/index.js +11 -3
  33. package/dist/server/operations/get-principal.d.ts +75 -0
  34. package/dist/server/operations/get-principal.js +41 -0
  35. package/dist/server/operations/get-task-diagnostics.d.ts +43 -18
  36. package/dist/server/operations/get-task-diagnostics.js +87 -126
  37. package/dist/server/operations/get-worker-diagnostics.d.ts +177 -0
  38. package/dist/server/operations/get-worker-diagnostics.js +117 -0
  39. package/dist/server/operations/list-worker-registration-rejections.d.ts +79 -0
  40. package/dist/server/operations/list-worker-registration-rejections.js +60 -0
  41. package/dist/server/operations/list-workers.js +1 -3
  42. package/dist/server/operations/static-registrations.d.ts +28 -0
  43. package/dist/server/operations/static-registrations.js +248 -0
  44. package/dist/server/rest-bindings.d.ts +5 -0
  45. package/dist/server/rest-bindings.js +34 -313
  46. package/dist/server/runtime/authentication-bridge.js +6 -14
  47. package/dist/server/runtime/context.d.ts +23 -0
  48. package/dist/server/runtime/task-dispatch.d.ts +7 -1
  49. package/dist/server/runtime/task-dispatch.js +126 -55
  50. package/dist/server/runtime/task-ledger-completion.d.ts +68 -0
  51. package/dist/server/runtime/task-ledger-completion.js +72 -0
  52. package/dist/server/runtime/task-ledger-recovery.d.ts +55 -0
  53. package/dist/server/runtime/task-ledger-recovery.js +73 -0
  54. package/dist/server/runtime/task-ledger-runtime.d.ts +64 -0
  55. package/dist/server/runtime/task-ledger-runtime.js +34 -0
  56. package/dist/server/runtime/task-metrics.d.ts +6 -4
  57. package/dist/server/runtime/task-polling.d.ts +14 -12
  58. package/dist/server/runtime/task-polling.js +106 -82
  59. package/dist/server/runtime/task-reconciliation.d.ts +35 -8
  60. package/dist/server/runtime/task-reconciliation.js +75 -74
  61. package/dist/server/runtime/task-result-resolution.d.ts +2 -10
  62. package/dist/server/runtime/task-result-resolution.js +0 -67
  63. package/dist/server/runtime/task-result-view.d.ts +82 -0
  64. package/dist/server/runtime/task-result-view.js +48 -0
  65. package/dist/server/runtime/websocket-worker-messaging.d.ts +16 -0
  66. package/dist/server/runtime/websocket-worker-messaging.js +32 -0
  67. package/dist/server/runtime/websocket-worker-registration.d.ts +41 -0
  68. package/dist/server/runtime/websocket-worker-registration.js +134 -0
  69. package/dist/server/runtime/websocket-worker.d.ts +0 -1
  70. package/dist/server/runtime/websocket-worker.js +64 -116
  71. package/dist/server/serve-internals.d.ts +9 -6
  72. package/dist/server/serve-internals.js +14 -40
  73. package/dist/server/task-ledger-codec.d.ts +40 -0
  74. package/dist/server/task-ledger-codec.js +195 -0
  75. package/dist/server/task-ledger-keys.d.ts +13 -0
  76. package/dist/server/task-ledger-keys.js +5 -0
  77. package/dist/server/task-ledger-limits.d.ts +34 -0
  78. package/dist/server/task-ledger-limits.js +5 -0
  79. package/dist/server/task-ledger-transition-helpers.d.ts +38 -0
  80. package/dist/server/task-ledger-transition-helpers.js +42 -0
  81. package/dist/server/task-ledger-transitions-cancellation.d.ts +31 -0
  82. package/dist/server/task-ledger-transitions-cancellation.js +73 -0
  83. package/dist/server/task-ledger-transitions.d.ts +129 -0
  84. package/dist/server/task-ledger-transitions.js +162 -0
  85. package/dist/server/task-ledger-types.d.ts +220 -0
  86. package/dist/server/task-ledger-types.js +1 -0
  87. package/dist/server/task-ledger.d.ts +17 -0
  88. package/dist/server/task-ledger.js +24 -0
  89. package/dist/server/task-state.d.ts +25 -152
  90. package/dist/server/task-state.js +0 -188
  91. package/dist/server/worker-admission-policy.d.ts +70 -0
  92. package/dist/server/worker-admission-policy.js +0 -0
  93. package/dist/storage/compressed-storage.js +1 -1
  94. package/dist/storage/index.d.ts +0 -2
  95. package/dist/storage/interface.d.ts +0 -2
  96. package/dist/storage/interface.js +1 -1
  97. package/dist/storage/lmdb.js +1 -1
  98. package/dist/storage/memory.js +1 -1
  99. package/dist/storage/neon.js +1 -1
  100. package/dist/storage/postgres.js +1 -1
  101. package/dist/storage/resolve.js +1 -1
  102. package/dist/storage/scoped-storage.js +1 -1
  103. package/dist/storage/testing.js +1 -1
  104. package/dist/storage/turso.js +1 -1
  105. package/dist/storage/web-extension.js +2 -2
  106. package/dist/version.d.ts +1 -1
  107. package/dist/version.js +1 -1
  108. package/dist/web-extension.js +1 -1
  109. package/dist/worker/index.d.ts +2 -0
  110. package/dist/worker/index.js +30 -4
  111. package/dist/worker/manifest/canonical-json.d.ts +20 -0
  112. package/dist/worker/manifest/canonical-json.js +13 -0
  113. package/dist/worker/manifest/capabilities.d.ts +24 -0
  114. package/dist/worker/manifest/capabilities.js +74 -0
  115. package/dist/worker/manifest/content-digest.d.ts +20 -0
  116. package/dist/worker/manifest/content-digest.js +13 -0
  117. package/dist/worker/manifest/declared-shape-digest.d.ts +14 -0
  118. package/dist/worker/manifest/declared-shape-digest.js +4 -0
  119. package/dist/worker/manifest/digest.d.ts +82 -0
  120. package/dist/worker/manifest/digest.js +9 -0
  121. package/dist/worker/manifest/execution-identity.d.ts +92 -0
  122. package/dist/worker/manifest/execution-identity.js +36 -0
  123. package/dist/worker/manifest/failure.d.ts +59 -0
  124. package/dist/worker/manifest/failure.js +4 -0
  125. package/dist/worker/manifest/index.d.ts +22 -0
  126. package/dist/worker/manifest/index.js +23 -0
  127. package/dist/worker/manifest/internal-realm.d.ts +50 -0
  128. package/dist/worker/manifest/internal-realm.js +39 -0
  129. package/dist/worker/manifest/is-record.d.ts +12 -0
  130. package/dist/worker/manifest/is-record.js +6 -0
  131. package/dist/worker/manifest/json-scan.d.ts +26 -0
  132. package/dist/worker/manifest/json-scan.js +88 -0
  133. package/dist/worker/manifest/limits.d.ts +138 -0
  134. package/dist/worker/manifest/limits.js +1 -0
  135. package/dist/worker/manifest/normalize.d.ts +63 -0
  136. package/dist/worker/manifest/normalize.js +73 -0
  137. package/dist/worker/manifest/parse-json.d.ts +24 -0
  138. package/dist/worker/manifest/parse-json.js +15 -0
  139. package/dist/worker/manifest/parse.d.ts +86 -0
  140. package/dist/worker/manifest/parse.js +188 -0
  141. package/dist/worker/manifest/registry-contract-builder.d.ts +120 -0
  142. package/dist/worker/manifest/registry-contract-builder.js +65 -0
  143. package/dist/worker/manifest/types.d.ts +263 -0
  144. package/dist/worker/manifest/types.js +1 -0
  145. package/dist/worker/manifest/utf8.d.ts +13 -0
  146. package/dist/worker/manifest/utf8.js +7 -0
  147. package/dist/worker/options.d.ts +55 -8
  148. package/dist/worker/options.js +65 -9
  149. package/dist/worker/protocol-internals.d.ts +1 -2
  150. package/dist/worker/protocol-internals.js +0 -5
  151. package/dist/worker/protocol-messages.d.ts +33 -17
  152. package/dist/worker/protocol-schemas.d.ts +36 -74
  153. package/dist/worker/protocol-schemas.js +25 -18
  154. package/dist/worker/protocol-version.d.ts +18 -14
  155. package/dist/worker/protocol-version.js +1 -1
  156. package/dist/worker/protocol.js +1 -1
  157. package/dist/worker/registry/deployment-consistency.d.ts +78 -0
  158. package/dist/worker/registry/deployment-consistency.js +27 -0
  159. package/dist/worker/registry/drain.d.ts +14 -0
  160. package/dist/worker/registry/drain.js +24 -0
  161. package/dist/worker/registry/rejections.d.ts +31 -0
  162. package/dist/worker/registry/rejections.js +10 -0
  163. package/dist/worker/registry/summary.d.ts +0 -3
  164. package/dist/worker/registry/summary.js +2 -5
  165. package/dist/worker/registry/types.d.ts +10 -3
  166. package/dist/worker/registry.d.ts +47 -2
  167. package/dist/worker/registry.js +45 -32
  168. package/dist/workers/workflow-worker-entry.d.ts +12 -7
  169. package/dist/workers/workflow-worker-entry.js +9 -2
  170. package/package.json +3 -3
  171. package/dist/server/task-resolved-record.d.ts +0 -12
  172. package/dist/server/task-resolved-record.js +0 -35
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Weft
2
2
 
3
- A Bun-native durable execution engine. Current release: `0.17.0`.
3
+ A Bun-native durable execution engine. Current release: `0.19.0`.
4
4
 
5
5
  Install the library from npm as `@lostgradient/weft`:
6
6
 
@@ -378,6 +378,8 @@ import { RemoteWorker } from '@lostgradient/weft';
378
378
 
379
379
  const worker = new RemoteWorker({
380
380
  serverUrl: 'wss://weft.internal:7233',
381
+ deploymentName: 'orders',
382
+ buildId: '2026.08.19-1',
381
383
  workflows: {
382
384
  orderFulfillment: {
383
385
  name: 'orderFulfillment',
@@ -1,23 +1,20 @@
1
1
  import { decode } from "../core/codec.js";
2
2
  import { Engine } from "../core/engine.js";
3
3
  import { serve } from "../server/index.js";
4
- import { KEYS } from "../storage/interface.js";
4
+ import { isRemoteTaskTerminalResolved, taskLedgerKey } from "../server/task-ledger.js";
5
5
  import { MemoryStorage } from "../storage/memory.js";
6
6
  import {
7
7
  REMOTE_WORKER_PROTOCOL_VERSION,
8
8
  REMOTE_WORKER_SUPPORTED_PROTOCOL_VERSIONS
9
9
  } from "../worker/protocol.js";
10
10
  const CONFORMANCE_QUEUE = "conformance", CONFORMANCE_ACTIVITIES = [
11
- "weft.conformance.echo",
12
- "weft.conformance.sleep",
13
- "weft.conformance.cancel"
11
+ "conformance.echo",
12
+ "conformance.sleep",
13
+ "conformance.cancel"
14
14
  ], CONFORMANCE_HEARTBEAT_INTERVAL_MS = 25;
15
15
  function createCheck(name, ok, message) {
16
16
  return { name, ok, message };
17
17
  }
18
- function isRecord(value) {
19
- return value !== null && typeof value === "object" && !Array.isArray(value);
20
- }
21
18
  async function waitForCondition(predicate, timeoutMs, label) {
22
19
  const deadline = Date.now() + timeoutMs;
23
20
  let lastError;
@@ -110,17 +107,12 @@ async function waitForWorkerIdle(server, workerId, timeoutMs) {
110
107
  }
111
108
  throw Error(`Timed out after ${timeoutMs}ms waiting for worker ${workerId} to become idle`);
112
109
  }
113
- function isResolvedRecord(value) {
114
- if (!isRecord(value))
115
- return !1;
116
- return typeof value.operationId === "string" && (value.status === "completed" || value.status === "failed") && typeof value.resolvedAt === "number";
117
- }
118
110
  async function readResolvedStatus(storage, operationId) {
119
- const stored = await storage.get(KEYS.operationResolved(operationId));
111
+ const stored = await storage.get(taskLedgerKey(operationId));
120
112
  if (stored === null)
121
113
  return;
122
114
  const decoded = decode(stored);
123
- if (!isResolvedRecord(decoded))
115
+ if (!isRemoteTaskTerminalResolved(decoded))
124
116
  return;
125
117
  return decoded.status;
126
118
  }
@@ -131,6 +123,7 @@ async function dispatchAndWait(server, storage, operationId, activityName, input
131
123
  if (!await server.dispatchTask({
132
124
  operationId,
133
125
  activityName,
126
+ workflowType: "conformance",
134
127
  input,
135
128
  queue: CONFORMANCE_QUEUE,
136
129
  visibilityTimeout: Math.max(500, timeoutMs)
@@ -151,15 +144,16 @@ async function runConformanceChecks(command, timeoutMs) {
151
144
  worker = startWorker(command, server);
152
145
  const workerId = await waitForRegisteredWorker(server, timeoutMs), registered = server.registry.getWorker(workerId);
153
146
  checks.push(createCheck("register", registered?.queue === CONFORMANCE_QUEUE && CONFORMANCE_ACTIVITIES.every((activity) => registered.activities.includes(activity)), `registered worker ${workerId}`));
154
- await dispatchAndWait(server, storage, "conformance-echo", "weft.conformance.echo", { ok: !0 }, "completed", timeoutMs);
147
+ await dispatchAndWait(server, storage, "conformance-echo", "conformance.echo", { ok: !0 }, "completed", timeoutMs);
155
148
  checks.push(createCheck("task completion", !0, "echo task resolved"));
156
149
  await waitForWorkerHeartbeat(server, workerId, timeoutMs);
157
- await dispatchAndWait(server, storage, "conformance-heartbeat", "weft.conformance.sleep", { milliseconds: CONFORMANCE_HEARTBEAT_INTERVAL_MS * 3 }, "completed", timeoutMs);
150
+ await dispatchAndWait(server, storage, "conformance-heartbeat", "conformance.sleep", { milliseconds: CONFORMANCE_HEARTBEAT_INTERVAL_MS * 3 }, "completed", timeoutMs);
158
151
  checks.push(createCheck("heartbeat", !0, "heartbeat observed while worker was connected"));
159
152
  const cancelOperationId = "conformance-cancel";
160
153
  if (!await server.dispatchTask({
161
154
  operationId: cancelOperationId,
162
- activityName: "weft.conformance.cancel",
155
+ activityName: "conformance.cancel",
156
+ workflowType: "conformance",
163
157
  input: { milliseconds: timeoutMs },
164
158
  queue: CONFORMANCE_QUEUE,
165
159
  visibilityTimeout: Math.max(500, timeoutMs)
@@ -173,7 +167,8 @@ async function runConformanceChecks(command, timeoutMs) {
173
167
  const reconnectOperationId = "conformance-reconnect", reconnectDelayMs = Math.min(1500, Math.max(250, Math.floor(timeoutMs * 0.75)));
174
168
  if (!await server.dispatchTask({
175
169
  operationId: reconnectOperationId,
176
- activityName: "weft.conformance.sleep",
170
+ activityName: "conformance.sleep",
171
+ workflowType: "conformance",
177
172
  input: { milliseconds: reconnectDelayMs },
178
173
  queue: CONFORMANCE_QUEUE,
179
174
  visibilityTimeout: Math.max(500, timeoutMs)
@@ -185,6 +180,7 @@ async function runConformanceChecks(command, timeoutMs) {
185
180
  await stopWorker(worker);
186
181
  worker = replacementWorker;
187
182
  await waitForCondition(() => server.registry.getWorker(workerId) === void 0, timeoutMs, "original worker disconnect");
183
+ await waitForCondition(() => (server.registry.getWorker(replacementWorkerId)?.inFlight ?? 0) > 0 || server.registry.getWorker(replacementWorkerId) === void 0, timeoutMs, "reassigned reconnect task delivered to replacement worker");
188
184
  await waitForWorkerIdle(server, replacementWorkerId, timeoutMs);
189
185
  await waitForResolvedStatus(storage, reconnectOperationId, "completed", timeoutMs);
190
186
  checks.push(createCheck("reconnect", !0, "in-flight task completed after reconnect"));
@@ -1403,6 +1403,79 @@
1403
1403
  },
1404
1404
  "outputSchema": {}
1405
1405
  },
1406
+ {
1407
+ "name": "weft.system.principal",
1408
+ "kind": "unary",
1409
+ "summary": "Report the caller's resolved principal and granted scopes",
1410
+ "description": "Report the caller's own resolved principal: the authentication method ('jwt', 'api-key', 'mtls', 'stdio-local', or 'unauthenticated'), the normalized subject when one exists, and the granted authorization scopes, sorted. Public access: an unauthenticated caller receives method 'unauthenticated' with an empty scope list rather than an error, so clients can distinguish \"no credential\" from \"credential with few scopes\" without probing other operations. Reflects only the request credential — never server auth configuration.",
1411
+ "tags": ["System"],
1412
+ "destructive": false,
1413
+ "access": {
1414
+ "kind": "public"
1415
+ },
1416
+ "transports": {
1417
+ "http": true,
1418
+ "jsonRpcHttp": true,
1419
+ "jsonRpcWebSocket": true,
1420
+ "jsonRpcStdio": true
1421
+ },
1422
+ "producibleFaults": [],
1423
+ "inputSchema": {
1424
+ "additionalProperties": false,
1425
+ "properties": {},
1426
+ "type": "object"
1427
+ },
1428
+ "outputSchema": {
1429
+ "additionalProperties": false,
1430
+ "properties": {
1431
+ "method": {
1432
+ "enum": ["jwt", "api-key", "mtls", "stdio-local", "unauthenticated"],
1433
+ "type": "string"
1434
+ },
1435
+ "scopes": {
1436
+ "items": {
1437
+ "enum": [
1438
+ "workflows:read",
1439
+ "workflows:write",
1440
+ "workflows:admin",
1441
+ "schedules:read",
1442
+ "schedules:write",
1443
+ "signals:write",
1444
+ "updates:write",
1445
+ "queries:read",
1446
+ "reviews:read",
1447
+ "reviews:write",
1448
+ "attributes:read",
1449
+ "attributes:write",
1450
+ "tags:write",
1451
+ "streams:read",
1452
+ "events:read",
1453
+ "storage:read",
1454
+ "storage:write",
1455
+ "storage:admin",
1456
+ "workers:write",
1457
+ "system:read",
1458
+ "system:admin"
1459
+ ],
1460
+ "type": "string"
1461
+ },
1462
+ "type": "array"
1463
+ },
1464
+ "subject": {
1465
+ "anyOf": [
1466
+ {
1467
+ "type": "string"
1468
+ },
1469
+ {
1470
+ "type": "null"
1471
+ }
1472
+ ]
1473
+ }
1474
+ },
1475
+ "required": ["method", "subject", "scopes"],
1476
+ "type": "object"
1477
+ }
1478
+ },
1406
1479
  {
1407
1480
  "name": "weft.system.registry",
1408
1481
  "kind": "unary",
@@ -1635,7 +1708,6 @@
1635
1708
  "type": "string"
1636
1709
  },
1637
1710
  "lastRequeueReason": {
1638
- "enum": ["visibility-timeout", "worker-disconnect"],
1639
1711
  "type": "string"
1640
1712
  },
1641
1713
  "operationId": {
@@ -1749,7 +1821,7 @@
1749
1821
  "jsonRpcWebSocket": false,
1750
1822
  "jsonRpcStdio": false
1751
1823
  },
1752
- "producibleFaults": [],
1824
+ "producibleFaults": ["NotFound"],
1753
1825
  "inputSchema": {
1754
1826
  "additionalProperties": false,
1755
1827
  "properties": {
@@ -1983,6 +2055,185 @@
1983
2055
  ]
1984
2056
  }
1985
2057
  },
2058
+ {
2059
+ "name": "weft.workers.diagnostics",
2060
+ "kind": "unary",
2061
+ "summary": "Get bounded instance and deployment-version diagnostics for one connected worker",
2062
+ "description": "Report one connected worker's identity split into two parts: `instance` (this live connection — queue, health, connection timestamps) and `deploymentVersion` (the artifact it loaded — SDK/runtime identity, manifest digest, and every advertised workflow's version, revision, and contract hash). Returns `worker: null` when the workerId is not currently connected. Excludes capabilities and raw payload schemas.",
2063
+ "tags": ["Observability"],
2064
+ "destructive": false,
2065
+ "access": {
2066
+ "kind": "scoped",
2067
+ "scopes": ["system:read"]
2068
+ },
2069
+ "transports": {
2070
+ "http": true,
2071
+ "jsonRpcHttp": true,
2072
+ "jsonRpcWebSocket": true,
2073
+ "jsonRpcStdio": true
2074
+ },
2075
+ "producibleFaults": [],
2076
+ "inputSchema": {
2077
+ "additionalProperties": false,
2078
+ "properties": {
2079
+ "workerId": {
2080
+ "minLength": 1,
2081
+ "type": "string"
2082
+ }
2083
+ },
2084
+ "required": ["workerId"],
2085
+ "type": "object"
2086
+ },
2087
+ "outputSchema": {
2088
+ "additionalProperties": false,
2089
+ "properties": {
2090
+ "worker": {
2091
+ "anyOf": [
2092
+ {
2093
+ "additionalProperties": false,
2094
+ "properties": {
2095
+ "deploymentVersion": {
2096
+ "additionalProperties": false,
2097
+ "properties": {
2098
+ "artifactDigest": {
2099
+ "type": "string"
2100
+ },
2101
+ "buildId": {
2102
+ "type": "string"
2103
+ },
2104
+ "deploymentName": {
2105
+ "type": "string"
2106
+ },
2107
+ "manifestDigest": {
2108
+ "type": "string"
2109
+ },
2110
+ "manifestVersion": {
2111
+ "type": "number"
2112
+ },
2113
+ "protocolVersion": {
2114
+ "type": "number"
2115
+ },
2116
+ "runtimeName": {
2117
+ "type": "string"
2118
+ },
2119
+ "runtimeVersion": {
2120
+ "type": "string"
2121
+ },
2122
+ "sdkVersion": {
2123
+ "type": "string"
2124
+ },
2125
+ "workflows": {
2126
+ "additionalProperties": {
2127
+ "additionalProperties": false,
2128
+ "properties": {
2129
+ "activities": {
2130
+ "additionalProperties": {
2131
+ "additionalProperties": false,
2132
+ "properties": {
2133
+ "contractHash": {
2134
+ "type": "string"
2135
+ },
2136
+ "implementationRevision": {
2137
+ "type": "string"
2138
+ }
2139
+ },
2140
+ "required": ["contractHash", "implementationRevision"],
2141
+ "type": "object"
2142
+ },
2143
+ "propertyNames": {
2144
+ "type": "string"
2145
+ },
2146
+ "type": "object"
2147
+ },
2148
+ "contractHash": {
2149
+ "type": "string"
2150
+ },
2151
+ "workflowRevision": {
2152
+ "type": "string"
2153
+ },
2154
+ "workflowVersion": {
2155
+ "type": "string"
2156
+ }
2157
+ },
2158
+ "required": [
2159
+ "workflowVersion",
2160
+ "workflowRevision",
2161
+ "contractHash",
2162
+ "activities"
2163
+ ],
2164
+ "type": "object"
2165
+ },
2166
+ "propertyNames": {
2167
+ "type": "string"
2168
+ },
2169
+ "type": "object"
2170
+ }
2171
+ },
2172
+ "required": [
2173
+ "deploymentName",
2174
+ "buildId",
2175
+ "artifactDigest",
2176
+ "runtimeName",
2177
+ "runtimeVersion",
2178
+ "sdkVersion",
2179
+ "manifestVersion",
2180
+ "protocolVersion",
2181
+ "manifestDigest",
2182
+ "workflows"
2183
+ ],
2184
+ "type": "object"
2185
+ },
2186
+ "instance": {
2187
+ "additionalProperties": false,
2188
+ "properties": {
2189
+ "connectedAt": {
2190
+ "type": "number"
2191
+ },
2192
+ "health": {
2193
+ "enum": ["active", "draining", "drained"],
2194
+ "type": "string"
2195
+ },
2196
+ "heartbeatAgeMs": {
2197
+ "type": "number"
2198
+ },
2199
+ "lastHeartbeatAt": {
2200
+ "type": "number"
2201
+ },
2202
+ "queue": {
2203
+ "type": "string"
2204
+ },
2205
+ "startedAt": {
2206
+ "type": "number"
2207
+ },
2208
+ "workerId": {
2209
+ "type": "string"
2210
+ }
2211
+ },
2212
+ "required": [
2213
+ "workerId",
2214
+ "queue",
2215
+ "health",
2216
+ "connectedAt",
2217
+ "startedAt",
2218
+ "lastHeartbeatAt",
2219
+ "heartbeatAgeMs"
2220
+ ],
2221
+ "type": "object"
2222
+ }
2223
+ },
2224
+ "required": ["instance", "deploymentVersion"],
2225
+ "type": "object"
2226
+ },
2227
+ {
2228
+ "type": "null"
2229
+ }
2230
+ ]
2231
+ }
2232
+ },
2233
+ "required": ["worker"],
2234
+ "type": "object"
2235
+ }
2236
+ },
1986
2237
  {
1987
2238
  "name": "weft.workers.drain",
1988
2239
  "kind": "unary",
@@ -2162,16 +2413,6 @@
2162
2413
  "drainingWorkers": {
2163
2414
  "type": "number"
2164
2415
  },
2165
- "gitSha": {
2166
- "anyOf": [
2167
- {
2168
- "type": "string"
2169
- },
2170
- {
2171
- "type": "null"
2172
- }
2173
- ]
2174
- },
2175
2416
  "health": {
2176
2417
  "enum": ["active", "draining", "drained"],
2177
2418
  "type": "string"
@@ -2207,7 +2448,6 @@
2207
2448
  "deploymentName",
2208
2449
  "buildId",
2209
2450
  "runtimeVersion",
2210
- "gitSha",
2211
2451
  "health",
2212
2452
  "workers",
2213
2453
  "activeWorkers",
@@ -2254,9 +2494,6 @@
2254
2494
  "deploymentName": {
2255
2495
  "type": "string"
2256
2496
  },
2257
- "gitSha": {
2258
- "type": "string"
2259
- },
2260
2497
  "health": {
2261
2498
  "enum": ["active", "draining", "drained"],
2262
2499
  "type": "string"
@@ -2310,6 +2547,84 @@
2310
2547
  "type": "object"
2311
2548
  }
2312
2549
  },
2550
+ {
2551
+ "name": "weft.workers.rejections",
2552
+ "kind": "unary",
2553
+ "summary": "List recently declined worker registration attempts",
2554
+ "description": "Bounded, most-recent-first log of declined `register` attempts: rejection code, attempted workerId when known, and whatever deployment/queue identity had already been parsed by the time the rejecting gate ran. No free-text message and no manifest content.",
2555
+ "tags": ["Observability"],
2556
+ "destructive": false,
2557
+ "access": {
2558
+ "kind": "scoped",
2559
+ "scopes": ["system:read"]
2560
+ },
2561
+ "transports": {
2562
+ "http": true,
2563
+ "jsonRpcHttp": true,
2564
+ "jsonRpcWebSocket": true,
2565
+ "jsonRpcStdio": true
2566
+ },
2567
+ "producibleFaults": [],
2568
+ "inputSchema": {
2569
+ "additionalProperties": false,
2570
+ "properties": {
2571
+ "limit": {
2572
+ "default": 20,
2573
+ "maximum": 100,
2574
+ "minimum": 1,
2575
+ "type": "integer"
2576
+ }
2577
+ },
2578
+ "required": ["limit"],
2579
+ "type": "object"
2580
+ },
2581
+ "outputSchema": {
2582
+ "additionalProperties": false,
2583
+ "properties": {
2584
+ "items": {
2585
+ "items": {
2586
+ "additionalProperties": false,
2587
+ "properties": {
2588
+ "buildId": {
2589
+ "type": "string"
2590
+ },
2591
+ "code": {
2592
+ "enum": [
2593
+ "invalid_registration",
2594
+ "unsupported_protocol_version",
2595
+ "deployment_conflict",
2596
+ "registration_rejected"
2597
+ ],
2598
+ "type": "string"
2599
+ },
2600
+ "deploymentName": {
2601
+ "type": "string"
2602
+ },
2603
+ "queue": {
2604
+ "type": "string"
2605
+ },
2606
+ "rejectedAt": {
2607
+ "type": "number"
2608
+ },
2609
+ "workerId": {
2610
+ "type": "string"
2611
+ }
2612
+ },
2613
+ "required": ["code", "rejectedAt"],
2614
+ "type": "object"
2615
+ },
2616
+ "type": "array"
2617
+ },
2618
+ "limit": {
2619
+ "maximum": 100,
2620
+ "minimum": 1,
2621
+ "type": "integer"
2622
+ }
2623
+ },
2624
+ "required": ["items", "limit"],
2625
+ "type": "object"
2626
+ }
2627
+ },
2313
2628
  {
2314
2629
  "name": "weft.workers.resume",
2315
2630
  "kind": "unary",
@@ -1,7 +1,7 @@
1
1
  import { type CatalogWeftClient, type WeftClientConnection } from '../operation-client-runtime.ts';
2
- export declare const CATALOG_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
2
+ export declare const CATALOG_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.principal", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.diagnostics", "weft.workers.drain", "weft.workers.list", "weft.workers.rejections", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
3
3
  export type CatalogOperationName = (typeof CATALOG_OPERATION_NAMES)[number];
4
- export declare const CLIENT_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.diagnostics.deadletters.clear", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
4
+ export declare const CLIENT_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.principal", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.diagnostics.deadletters.clear", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.diagnostics", "weft.workers.drain", "weft.workers.list", "weft.workers.rejections", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
5
5
  export type ClientOperationName = (typeof CLIENT_OPERATION_NAMES)[number];
6
6
  export declare const CLIENT_REST_OPERATION_BINDINGS: {
7
7
  readonly 'weft.tasks.diagnostics.deadletters.clear': {
@@ -251,6 +251,15 @@ export type ClientOperationTypes = {
251
251
  readonly output: unknown;
252
252
  readonly faults: never;
253
253
  };
254
+ 'weft.system.principal': {
255
+ readonly input: {};
256
+ readonly output: {
257
+ readonly method: 'jwt' | 'api-key' | 'mtls' | 'stdio-local' | 'unauthenticated';
258
+ readonly scopes: ReadonlyArray<'workflows:read' | 'workflows:write' | 'workflows:admin' | 'schedules:read' | 'schedules:write' | 'signals:write' | 'updates:write' | 'queries:read' | 'reviews:read' | 'reviews:write' | 'attributes:read' | 'attributes:write' | 'tags:write' | 'streams:read' | 'events:read' | 'storage:read' | 'storage:write' | 'storage:admin' | 'workers:write' | 'system:read' | 'system:admin'>;
259
+ readonly subject: unknown;
260
+ };
261
+ readonly faults: never;
262
+ };
254
263
  'weft.system.registry': {
255
264
  readonly input: {};
256
265
  readonly output: {
@@ -295,7 +304,7 @@ export type ClientOperationTypes = {
295
304
  readonly executionLatencyMs?: number;
296
305
  readonly heartbeatAgeMs?: number;
297
306
  readonly kind: 'stuck-queued' | 'stale-inflight' | 'retry-storm' | 'all-workers-at-capacity' | 'dead-lettered';
298
- readonly lastRequeueReason?: 'visibility-timeout' | 'worker-disconnect';
307
+ readonly lastRequeueReason?: string;
299
308
  readonly operationId?: string;
300
309
  readonly queue?: string;
301
310
  readonly queueLatencyMs?: number;
@@ -326,7 +335,7 @@ export type ClientOperationTypes = {
326
335
  readonly output: {
327
336
  readonly ok: boolean;
328
337
  };
329
- readonly faults: never;
338
+ readonly faults: 'NotFound';
330
339
  };
331
340
  'weft.updates.result.get': {
332
341
  readonly input: {
@@ -350,6 +359,15 @@ export type ClientOperationTypes = {
350
359
  readonly output: unknown;
351
360
  readonly faults: never;
352
361
  };
362
+ 'weft.workers.diagnostics': {
363
+ readonly input: {
364
+ readonly workerId: string;
365
+ };
366
+ readonly output: {
367
+ readonly worker: unknown;
368
+ };
369
+ readonly faults: never;
370
+ };
353
371
  'weft.workers.drain': {
354
372
  readonly input: {
355
373
  readonly reason?: string;
@@ -367,7 +385,6 @@ export type ClientOperationTypes = {
367
385
  readonly deploymentName: unknown;
368
386
  readonly drainedWorkers: number;
369
387
  readonly drainingWorkers: number;
370
- readonly gitSha: unknown;
371
388
  readonly health: 'active' | 'draining' | 'drained';
372
389
  readonly inFlight: number;
373
390
  readonly oldestStartedAt: unknown;
@@ -382,7 +399,6 @@ export type ClientOperationTypes = {
382
399
  readonly concurrency: number;
383
400
  readonly connectedAt: number;
384
401
  readonly deploymentName?: string;
385
- readonly gitSha?: string;
386
402
  readonly health: 'active' | 'draining' | 'drained';
387
403
  readonly heartbeatAgeMs: number;
388
404
  readonly id: string;
@@ -396,6 +412,23 @@ export type ClientOperationTypes = {
396
412
  };
397
413
  readonly faults: never;
398
414
  };
415
+ 'weft.workers.rejections': {
416
+ readonly input: {
417
+ readonly limit: number;
418
+ };
419
+ readonly output: {
420
+ readonly items: ReadonlyArray<{
421
+ readonly buildId?: string;
422
+ readonly code: 'invalid_registration' | 'unsupported_protocol_version' | 'deployment_conflict' | 'registration_rejected';
423
+ readonly deploymentName?: string;
424
+ readonly queue?: string;
425
+ readonly rejectedAt: number;
426
+ readonly workerId?: string;
427
+ }>;
428
+ readonly limit: number;
429
+ };
430
+ readonly faults: never;
431
+ };
399
432
  'weft.workers.resume': {
400
433
  readonly input: {
401
434
  readonly workerId: string;
@@ -21,14 +21,17 @@ export const CATALOG_OPERATION_NAMES = [
21
21
  "weft.storage.capabilities",
22
22
  "weft.system.lease",
23
23
  "weft.system.metrics",
24
+ "weft.system.principal",
24
25
  "weft.system.registry",
25
26
  "weft.task.queues.list",
26
27
  "weft.tasks.diagnostics",
27
28
  "weft.updates.result.get",
28
29
  "weft.worker.deployments.drain",
29
30
  "weft.worker.deployments.resume",
31
+ "weft.workers.diagnostics",
30
32
  "weft.workers.drain",
31
33
  "weft.workers.list",
34
+ "weft.workers.rejections",
32
35
  "weft.workers.resume",
33
36
  "weft.workflows.activities.pending.list",
34
37
  "weft.workflows.aggregate",
@@ -82,6 +85,7 @@ export const CATALOG_OPERATION_NAMES = [
82
85
  "weft.storage.capabilities",
83
86
  "weft.system.lease",
84
87
  "weft.system.metrics",
88
+ "weft.system.principal",
85
89
  "weft.system.registry",
86
90
  "weft.task.queues.list",
87
91
  "weft.tasks.diagnostics",
@@ -89,8 +93,10 @@ export const CATALOG_OPERATION_NAMES = [
89
93
  "weft.updates.result.get",
90
94
  "weft.worker.deployments.drain",
91
95
  "weft.worker.deployments.resume",
96
+ "weft.workers.diagnostics",
92
97
  "weft.workers.drain",
93
98
  "weft.workers.list",
99
+ "weft.workers.rejections",
94
100
  "weft.workers.resume",
95
101
  "weft.workflows.activities.pending.list",
96
102
  "weft.workflows.aggregate",
@@ -9,7 +9,7 @@ export declare function normalizePipeStage(internals: ContextInternals, stage: W
9
9
  export declare function resolveChildWorkflowTarget<TInput = unknown, TOutput = unknown>(internals: ContextInternals, target: ChildWorkflowTarget<TInput, TOutput>): string;
10
10
  export declare function resolveMapConcurrency(totalItems: number, requestedConcurrency: number | undefined): number;
11
11
  export declare function createCompositionToken(internals: ContextInternals, kind: 'map' | 'pipe' | 'reduce'): string;
12
- export declare function createCompositionChildWorkflowOptions(internals: ContextInternals, token: string, index: number, options?: AwaitChildWorkflowOptions | undefined): AwaitChildWorkflowOptions;
12
+ export declare function createCompositionChildWorkflowOptions(internals: ContextInternals, token: string, index: number, options?: AwaitChildWorkflowOptions): AwaitChildWorkflowOptions;
13
13
  export declare function createReduceChildWorkflowOptions(internals: ContextInternals, token: string, index: number, options: WorkflowReduceOptions | undefined): AwaitChildWorkflowOptions;
14
14
  export declare function primeParallelOperations(operations: Generator<ContextOperationRequest, unknown, unknown>[]): ContextOperationRequest[];
15
15
  export declare function startChild<TResult = unknown>(context: Context, internals: ContextInternals, workflowType: string, input: unknown, options?: ChildWorkflowOptions): Generator<ContextOperationRequest, TResult | ChildWorkflowHandle<TResult>, unknown>;