@astrale-os/sdk 0.6.0-beta.5 → 0.6.0-beta.51

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 (651) hide show
  1. package/README.md +213 -60
  2. package/dist/application/action/action.d.ts +6 -0
  3. package/dist/application/action/authoring.d.ts +1 -1
  4. package/dist/application/action/context.d.ts +89 -33
  5. package/dist/application/action/define.d.ts +3 -3
  6. package/dist/application/action/index.d.ts +1 -1
  7. package/dist/application/define.d.ts +8 -6
  8. package/dist/application/define.js +28 -14
  9. package/dist/application/dependency/index.d.ts +1 -1
  10. package/dist/application/dependency/invoker.d.ts +21 -10
  11. package/dist/application/domain.d.ts +30 -0
  12. package/dist/application/error/error.d.ts +16 -1
  13. package/dist/application/error/error.js +39 -5
  14. package/dist/application/error/index.d.ts +1 -1
  15. package/dist/application/error/index.js +1 -1
  16. package/dist/application/index.d.ts +4 -4
  17. package/dist/application/index.js +1 -1
  18. package/dist/application/integration/define.d.ts +8 -1
  19. package/dist/application/integration/index.d.ts +2 -2
  20. package/dist/application/integration/integration.d.ts +13 -1
  21. package/dist/application/integration/operation.d.ts +16 -3
  22. package/dist/application/mutation/authoring/builder.d.ts +81 -33
  23. package/dist/application/mutation/authoring/builder.js +100 -30
  24. package/dist/application/mutation/authoring/guard.d.ts +37 -0
  25. package/dist/application/mutation/authoring/guard.js +150 -0
  26. package/dist/application/mutation/authoring/index.d.ts +5 -2
  27. package/dist/application/mutation/authoring/index.js +2 -1
  28. package/dist/application/mutation/authoring/names.d.ts +19 -0
  29. package/dist/application/mutation/authoring/names.js +83 -0
  30. package/dist/application/mutation/authoring/properties.d.ts +5 -3
  31. package/dist/application/mutation/authoring/properties.js +35 -2
  32. package/dist/application/mutation/authoring/transition.d.ts +3 -2
  33. package/dist/application/mutation/authoring/transition.js +4 -1
  34. package/dist/application/mutation/define.d.ts +24 -10
  35. package/dist/application/mutation/define.js +49 -53
  36. package/dist/application/mutation/execution/execute.d.ts +2 -2
  37. package/dist/application/mutation/execution/execute.js +78 -7
  38. package/dist/application/mutation/execution/executor.d.ts +4 -1
  39. package/dist/application/mutation/execution/executor.js +6 -1
  40. package/dist/application/mutation/failure.d.ts +17 -1
  41. package/dist/application/mutation/failure.js +40 -19
  42. package/dist/application/mutation/index.d.ts +9 -5
  43. package/dist/application/mutation/index.js +5 -2
  44. package/dist/application/mutation/legacy/v6/builder.d.ts +84 -0
  45. package/dist/application/mutation/legacy/v6/define.d.ts +18 -0
  46. package/dist/application/mutation/legacy/v6/define.js +56 -0
  47. package/dist/application/mutation/legacy/v6/mutation.d.ts +28 -0
  48. package/dist/application/mutation/{authoring → legacy/v6}/precondition.d.ts +4 -0
  49. package/dist/application/mutation/mutation.d.ts +47 -19
  50. package/dist/application/query/answer/answer.d.ts +117 -0
  51. package/dist/application/query/answer/conformance.d.ts +4 -0
  52. package/dist/application/query/answer/conformance.js +27 -0
  53. package/dist/application/query/answer/facts.d.ts +17 -0
  54. package/dist/application/query/answer/facts.js +57 -0
  55. package/dist/application/query/composite/builder.d.ts +1 -1
  56. package/dist/application/query/composite/builder.js +2 -2
  57. package/dist/application/query/composite/plan.d.ts +1 -5
  58. package/dist/application/query/composite/plan.js +1 -3
  59. package/dist/application/query/composite/query.d.ts +1 -2
  60. package/dist/application/query/define.d.ts +3 -34
  61. package/dist/application/query/define.js +5 -131
  62. package/dist/application/query/defined/define.d.ts +45 -0
  63. package/dist/application/query/defined/define.js +96 -0
  64. package/dist/application/query/defined/query.d.ts +139 -0
  65. package/dist/application/query/definition.d.ts +12 -0
  66. package/dist/application/query/definition.js +47 -0
  67. package/dist/application/query/execution/bounds.d.ts +22 -0
  68. package/dist/application/query/execution/bounds.js +88 -0
  69. package/dist/application/query/execution/client.d.ts +21 -0
  70. package/dist/application/query/execution/crossings.d.ts +25 -0
  71. package/dist/application/query/execution/crossings.js +218 -0
  72. package/dist/application/query/execution/error.d.ts +71 -0
  73. package/dist/application/query/execution/error.js +50 -0
  74. package/dist/application/query/execution/execute.d.ts +4 -10
  75. package/dist/application/query/execution/execute.js +3 -45
  76. package/dist/application/query/execution/executor.d.ts +2 -2
  77. package/dist/application/query/execution/refusal.d.ts +37 -0
  78. package/dist/application/query/execution/refusal.js +80 -0
  79. package/dist/application/query/execution/rows.d.ts +42 -0
  80. package/dist/application/query/execution/rows.js +326 -0
  81. package/dist/application/query/execution/run.d.ts +85 -0
  82. package/dist/application/query/execution/run.js +372 -0
  83. package/dist/application/query/execution/split.d.ts +24 -0
  84. package/dist/application/query/execution/split.js +190 -0
  85. package/dist/application/query/failure.d.ts +8 -0
  86. package/dist/application/query/failure.js +8 -0
  87. package/dist/application/query/handles/build.d.ts +10 -0
  88. package/dist/application/query/handles/build.js +53 -0
  89. package/dist/application/query/handles/conditions.d.ts +94 -0
  90. package/dist/application/query/handles/domain.d.ts +157 -0
  91. package/dist/application/query/handles/handles.d.ts +285 -0
  92. package/dist/application/query/handles/handles.js +1 -0
  93. package/dist/application/query/handles/model.d.ts +106 -0
  94. package/dist/application/query/handles/model.js +261 -0
  95. package/dist/application/query/handles/plan.d.ts +100 -0
  96. package/dist/application/query/handles/plan.js +37 -0
  97. package/dist/application/query/handles/reads.d.ts +106 -0
  98. package/dist/application/query/handles/reads.js +978 -0
  99. package/dist/application/query/handles/relations.d.ts +106 -0
  100. package/dist/application/query/handles/relations.js +1 -0
  101. package/dist/application/query/handles/rows.d.ts +94 -0
  102. package/dist/application/query/handles/rows.js +4 -0
  103. package/dist/application/query/handles/terms.d.ts +103 -0
  104. package/dist/application/query/handles/terms.js +282 -0
  105. package/dist/application/query/index.d.ts +14 -8
  106. package/dist/application/query/index.js +10 -5
  107. package/dist/application/query/language/index.d.ts +2 -0
  108. package/dist/application/query/language/index.js +2 -0
  109. package/dist/application/query/language/query.d.ts +323 -0
  110. package/dist/application/query/language/query.js +2 -0
  111. package/dist/application/query/{collection → legacy/v6/collection}/identity.d.ts +2 -2
  112. package/dist/application/query/{collection → legacy/v6/collection}/metadata.d.ts +1 -1
  113. package/dist/application/query/{collection → legacy/v6/collection}/union.d.ts +4 -4
  114. package/dist/application/query/{collection → legacy/v6/collection}/union.js +15 -8
  115. package/dist/application/query/legacy/v6/conformance.d.ts +15 -0
  116. package/dist/application/query/legacy/v6/conformance.js +46 -0
  117. package/dist/application/query/legacy/v6/define.d.ts +37 -0
  118. package/dist/application/query/legacy/v6/define.js +90 -0
  119. package/dist/application/query/legacy/v6/execution/execute.d.ts +18 -0
  120. package/dist/application/query/legacy/v6/execution/execute.js +50 -0
  121. package/dist/application/query/legacy/v6/index.d.ts +7 -0
  122. package/dist/application/query/legacy/v6/index.js +3 -0
  123. package/dist/application/query/legacy/v6/kernel.d.ts +6 -0
  124. package/dist/application/query/legacy/v6/kernel.js +5 -0
  125. package/dist/application/query/{single → legacy/v6/single}/pagination.js +1 -1
  126. package/dist/application/query/{single → legacy/v6/single}/query.d.ts +2 -14
  127. package/dist/application/query/legacy/v6/single/query.js +1 -0
  128. package/dist/application/query/query.d.ts +19 -4
  129. package/dist/application/routes/admission.d.ts +3 -3
  130. package/dist/application/routes/admission.js +3 -3
  131. package/dist/application/routes/index.d.ts +3 -2
  132. package/dist/application/routes/route.d.ts +3 -3
  133. package/dist/application/runtime/actions.js +3 -0
  134. package/dist/application/runtime/declarations.d.ts +6 -6
  135. package/dist/application/runtime/define.d.ts +5 -5
  136. package/dist/application/runtime/workflows.d.ts +3 -1
  137. package/dist/application/runtime/workflows.js +3 -4
  138. package/dist/application/view/define.js +4 -6
  139. package/dist/application/view/frontend.d.ts +2 -2
  140. package/dist/application/view/index.d.ts +1 -1
  141. package/dist/application/view/route.d.ts +0 -14
  142. package/dist/application/view/route.js +1 -64
  143. package/dist/application/workflow/authoring.d.ts +3 -2
  144. package/dist/application/workflow/context.d.ts +8 -2
  145. package/dist/application/workflow/define.d.ts +4 -4
  146. package/dist/application/workflow/define.js +14 -9
  147. package/dist/application/workflow/durable.d.ts +211 -0
  148. package/dist/application/workflow/durable.js +1 -0
  149. package/dist/application/workflow/index.d.ts +3 -2
  150. package/dist/application/workflow/runner/inline.js +3 -4
  151. package/dist/application/workflow/runner/runner.d.ts +2 -2
  152. package/dist/application/workflow/step/output.d.ts +2 -0
  153. package/dist/application/workflow/step/output.js +73 -0
  154. package/dist/application/workflow/workflow.d.ts +5 -3
  155. package/dist/deployment/adapter/adapter.d.ts +55 -13
  156. package/dist/deployment/adapter/bundle/bundle.d.ts +36 -0
  157. package/dist/deployment/adapter/bundle/bundle.js +1 -0
  158. package/dist/deployment/adapter/bundle/file.d.ts +10 -0
  159. package/dist/deployment/adapter/bundle/file.js +1 -0
  160. package/dist/deployment/adapter/bundle/index.d.ts +2 -0
  161. package/dist/deployment/adapter/bundle/index.js +1 -0
  162. package/dist/deployment/adapter/define.d.ts +4 -3
  163. package/dist/deployment/adapter/define.js +107 -23
  164. package/dist/deployment/adapter/index.d.ts +4 -3
  165. package/dist/deployment/adapter/index.js +1 -0
  166. package/dist/deployment/adapter/release/command.d.ts +33 -0
  167. package/dist/deployment/adapter/release/command.js +1 -0
  168. package/dist/deployment/adapter/release/context.d.ts +94 -0
  169. package/dist/deployment/adapter/release/context.js +1 -0
  170. package/dist/deployment/adapter/release/index.d.ts +4 -0
  171. package/dist/deployment/adapter/release/index.js +1 -0
  172. package/dist/deployment/adapter/release/list.d.ts +53 -0
  173. package/dist/deployment/adapter/release/list.js +1 -0
  174. package/dist/deployment/adapter/release/refusal.d.ts +10 -0
  175. package/dist/deployment/adapter/release/refusal.js +14 -0
  176. package/dist/deployment/adapter/release/result.d.ts +56 -0
  177. package/dist/deployment/adapter/release/result.js +1 -0
  178. package/dist/deployment/address/configuration.d.ts +96 -0
  179. package/dist/deployment/address/configuration.js +274 -0
  180. package/dist/deployment/address/fingerprint.d.ts +5 -0
  181. package/dist/deployment/address/fingerprint.js +27 -0
  182. package/dist/deployment/address/index.d.ts +5 -0
  183. package/dist/deployment/address/index.js +4 -0
  184. package/dist/deployment/address/label.d.ts +42 -0
  185. package/dist/deployment/address/label.js +80 -0
  186. package/dist/deployment/address/line.d.ts +29 -0
  187. package/dist/deployment/address/line.js +53 -0
  188. package/dist/deployment/address/record.d.ts +73 -0
  189. package/dist/deployment/address/record.js +138 -0
  190. package/dist/deployment/address/summary.d.ts +30 -0
  191. package/dist/deployment/address/summary.js +1 -0
  192. package/dist/deployment/address/vectors.d.ts +60 -0
  193. package/dist/deployment/address/vectors.js +517 -0
  194. package/dist/deployment/authoring.d.ts +0 -2
  195. package/dist/deployment/authoring.js +0 -1
  196. package/dist/deployment/build/build.d.ts +15 -2
  197. package/dist/deployment/build/compile.d.ts +4 -4
  198. package/dist/deployment/build/compile.js +19 -17
  199. package/dist/deployment/build/frontend/compilation.d.ts +2 -4
  200. package/dist/deployment/build/frontend/compilation.js +0 -5
  201. package/dist/deployment/build/frontend/digest.js +1 -5
  202. package/dist/deployment/build/index.d.ts +1 -0
  203. package/dist/deployment/build/index.js +1 -0
  204. package/dist/deployment/build/manifest.d.ts +59 -0
  205. package/dist/deployment/build/manifest.js +118 -0
  206. package/dist/deployment/build/material.d.ts +2 -2
  207. package/dist/deployment/build/material.js +31 -13
  208. package/dist/deployment/build/schema.d.ts +2 -2
  209. package/dist/deployment/deployment.d.ts +3 -2
  210. package/dist/deployment/environment.d.ts +6 -0
  211. package/dist/deployment/environment.js +6 -0
  212. package/dist/deployment/index.d.ts +4 -6
  213. package/dist/deployment/index.js +1 -2
  214. package/dist/deployment/release/addressing.d.ts +6 -5
  215. package/dist/deployment/release/addressing.js +2 -3
  216. package/dist/deployment/release/assemble.d.ts +6 -3
  217. package/dist/deployment/release/assemble.js +12 -10
  218. package/dist/deployment/release/release.d.ts +16 -5
  219. package/dist/deployment/release/seal.d.ts +14 -0
  220. package/dist/deployment/release/seal.js +22 -0
  221. package/dist/deployment/release/{publication → served}/callables.d.ts +2 -2
  222. package/dist/deployment/release/{publication → served}/callables.js +2 -2
  223. package/dist/deployment/release/served/index.d.ts +11 -0
  224. package/dist/deployment/release/served/index.js +26 -0
  225. package/dist/deployment/release/{publication → served}/views.d.ts +2 -2
  226. package/dist/deployment/release/{publication → served}/views.js +0 -1
  227. package/dist/deployment/runtime/admission.d.ts +2 -2
  228. package/dist/deployment/runtime/admission.js +5 -5
  229. package/dist/deployment/verify/index.d.ts +3 -4
  230. package/dist/deployment/verify/index.js +2 -3
  231. package/dist/deployment/verify/preflight/bundle.d.ts +18 -0
  232. package/dist/deployment/verify/preflight/bundle.js +71 -0
  233. package/dist/deployment/verify/preflight/index.d.ts +1 -12
  234. package/dist/deployment/verify/preflight/index.js +1 -12
  235. package/dist/deployment/verify/readiness/fetch.d.ts +13 -0
  236. package/dist/deployment/verify/readiness/fetch.js +26 -0
  237. package/dist/deployment/verify/readiness/identity.d.ts +3 -6
  238. package/dist/deployment/verify/readiness/identity.js +3 -3
  239. package/dist/deployment/verify/readiness/index.d.ts +15 -8
  240. package/dist/deployment/verify/readiness/index.js +25 -6
  241. package/dist/deployment/verify/readiness/release.d.ts +8 -0
  242. package/dist/deployment/verify/readiness/release.js +22 -0
  243. package/dist/deployment/worker/address.d.ts +26 -0
  244. package/dist/deployment/worker/address.js +43 -0
  245. package/dist/deployment/worker/build.d.ts +60 -0
  246. package/dist/deployment/worker/build.js +172 -0
  247. package/dist/deployment/worker/configuration.d.ts +73 -0
  248. package/dist/deployment/worker/configuration.js +165 -0
  249. package/dist/deployment/worker/content.d.ts +38 -0
  250. package/dist/deployment/worker/content.js +169 -0
  251. package/dist/deployment/worker/index.d.ts +29 -0
  252. package/dist/deployment/worker/index.js +29 -0
  253. package/dist/deployment/worker/limits.d.ts +30 -0
  254. package/dist/deployment/worker/limits.js +30 -0
  255. package/dist/deployment/worker/record.d.ts +29 -0
  256. package/dist/deployment/worker/record.js +69 -0
  257. package/dist/deployment/worker/request.d.ts +118 -0
  258. package/dist/deployment/worker/request.js +280 -0
  259. package/dist/deployment/worker/response.d.ts +101 -0
  260. package/dist/deployment/worker/response.js +207 -0
  261. package/dist/execution/cache/cache.d.ts +17 -0
  262. package/dist/execution/cache/cache.js +11 -0
  263. package/dist/execution/cache/index.d.ts +2 -0
  264. package/dist/execution/cache/index.js +2 -0
  265. package/dist/execution/cache/memory.d.ts +13 -0
  266. package/dist/execution/cache/memory.js +48 -0
  267. package/dist/execution/identity/authentication.d.ts +33 -3
  268. package/dist/execution/identity/authentication.js +90 -36
  269. package/dist/execution/identity/callback.d.ts +20 -20
  270. package/dist/execution/identity/callback.js +34 -26
  271. package/dist/execution/identity/delivery.d.ts +6 -4
  272. package/dist/execution/identity/delivery.js +25 -20
  273. package/dist/execution/identity/identity.d.ts +17 -3
  274. package/dist/execution/identity/identity.js +12 -4
  275. package/dist/execution/identity/jwks.d.ts +5 -0
  276. package/dist/execution/identity/jwks.js +92 -102
  277. package/dist/execution/index.d.ts +6 -4
  278. package/dist/execution/index.js +4 -2
  279. package/dist/execution/invocation/admission/age.d.ts +57 -0
  280. package/dist/execution/invocation/admission/age.js +208 -0
  281. package/dist/execution/invocation/admission/authentication.d.ts +13 -13
  282. package/dist/execution/invocation/admission/authentication.js +52 -44
  283. package/dist/execution/invocation/admission/authority.d.ts +28 -6
  284. package/dist/execution/invocation/admission/authority.js +9 -2
  285. package/dist/execution/invocation/admission/index.d.ts +4 -3
  286. package/dist/execution/invocation/admission/index.js +3 -2
  287. package/dist/execution/invocation/admission/input.d.ts +2 -2
  288. package/dist/execution/invocation/admission/input.js +16 -2
  289. package/dist/execution/invocation/admission/target.d.ts +11 -0
  290. package/dist/execution/invocation/admission/target.js +22 -3
  291. package/dist/execution/invocation/capabilities/bind.d.ts +14 -0
  292. package/dist/execution/invocation/capabilities/bind.js +74 -0
  293. package/dist/execution/invocation/capabilities/index.d.ts +1 -0
  294. package/dist/execution/invocation/capabilities/index.js +1 -0
  295. package/dist/execution/invocation/dependency/bind.d.ts +3 -1
  296. package/dist/execution/invocation/dependency/bind.js +36 -16
  297. package/dist/execution/invocation/dispatch/action.js +4 -2
  298. package/dist/execution/invocation/dispatch/context.d.ts +7 -6
  299. package/dist/execution/invocation/dispatch/context.js +11 -44
  300. package/dist/execution/invocation/dispatch/workflow.js +4 -6
  301. package/dist/execution/invocation/handler.js +8 -2
  302. package/dist/execution/invocation/index.d.ts +2 -2
  303. package/dist/execution/invocation/index.js +1 -1
  304. package/dist/execution/invocation/integration/authentication.d.ts +3 -3
  305. package/dist/execution/invocation/integration/authentication.js +7 -7
  306. package/dist/execution/invocation/integration/call.d.ts +2 -1
  307. package/dist/execution/invocation/integration/call.js +3 -3
  308. package/dist/execution/invocation/integration/clients.d.ts +1 -1
  309. package/dist/execution/invocation/integration/index.d.ts +1 -0
  310. package/dist/execution/invocation/integration/index.js +1 -0
  311. package/dist/execution/invocation/invocation.d.ts +6 -0
  312. package/dist/execution/invocation/invocation.js +129 -21
  313. package/dist/execution/invocation/lifecycle/active.d.ts +8 -2
  314. package/dist/execution/invocation/lifecycle/active.js +3 -3
  315. package/dist/execution/invocation/lifecycle/index.d.ts +1 -1
  316. package/dist/execution/invocation/result/errors.d.ts +0 -10
  317. package/dist/execution/invocation/result/errors.js +4 -16
  318. package/dist/execution/invocation/result/index.d.ts +3 -2
  319. package/dist/execution/invocation/result/index.js +2 -1
  320. package/dist/execution/invocation/result/project.js +41 -1
  321. package/dist/execution/invocation/result/undeclared.d.ts +7 -0
  322. package/dist/execution/invocation/result/undeclared.js +18 -0
  323. package/dist/execution/node/serve.d.ts +2 -2
  324. package/dist/execution/node/serve.js +1 -1
  325. package/dist/execution/runtime/index.d.ts +1 -0
  326. package/dist/execution/runtime/index.js +1 -0
  327. package/dist/execution/runtime/load.d.ts +3 -3
  328. package/dist/execution/runtime/load.js +3 -2
  329. package/dist/execution/runtime/release.d.ts +17 -0
  330. package/dist/execution/runtime/release.js +7 -0
  331. package/dist/execution/serve.d.ts +18 -4
  332. package/dist/execution/serve.js +10 -0
  333. package/dist/execution/service/create.js +43 -7
  334. package/dist/execution/service/initialization.d.ts +4 -4
  335. package/dist/execution/service/initialization.js +23 -14
  336. package/dist/execution/service/release.d.ts +2 -2
  337. package/dist/execution/service/release.js +3 -2
  338. package/dist/execution/service/service.d.ts +20 -5
  339. package/dist/execution/service/serving/delivery.d.ts +5 -0
  340. package/dist/execution/service/{publication → serving}/delivery.js +4 -1
  341. package/dist/execution/service/{publication → serving}/index.d.ts +1 -1
  342. package/dist/execution/service/serving/installation.d.ts +4 -0
  343. package/dist/execution/service/serving/installation.js +9 -0
  344. package/dist/execution/service/serving/source.d.ts +11 -0
  345. package/dist/execution/service/serving/source.js +15 -0
  346. package/dist/execution/workflows/attempts.d.ts +87 -0
  347. package/dist/execution/workflows/attempts.js +205 -0
  348. package/dist/execution/workflows/discovery.d.ts +14 -0
  349. package/dist/execution/workflows/discovery.js +151 -0
  350. package/dist/execution/workflows/engine.d.ts +83 -0
  351. package/dist/execution/workflows/engine.js +1 -0
  352. package/dist/execution/workflows/envelope.d.ts +12 -0
  353. package/dist/execution/workflows/envelope.js +46 -0
  354. package/dist/execution/workflows/failure.d.ts +56 -0
  355. package/dist/execution/workflows/failure.js +204 -0
  356. package/dist/execution/workflows/index.d.ts +4 -0
  357. package/dist/execution/workflows/index.js +3 -0
  358. package/dist/execution/workflows/integrations.d.ts +13 -0
  359. package/dist/execution/workflows/integrations.js +25 -0
  360. package/dist/execution/workflows/options.d.ts +81 -0
  361. package/dist/execution/workflows/options.js +158 -0
  362. package/dist/execution/workflows/receiver.d.ts +24 -0
  363. package/dist/execution/workflows/receiver.js +99 -0
  364. package/dist/execution/workflows/route.d.ts +12 -0
  365. package/dist/execution/workflows/route.js +35 -0
  366. package/dist/execution/workflows/run.d.ts +23 -0
  367. package/dist/execution/workflows/run.js +369 -0
  368. package/dist/execution/workflows/steps.d.ts +48 -0
  369. package/dist/execution/workflows/steps.js +93 -0
  370. package/dist/index.d.ts +4 -4
  371. package/dist/index.js +2 -2
  372. package/dist/platform/graph/alias.d.ts +1 -5
  373. package/dist/platform/graph/alias.js +1 -5
  374. package/dist/platform/graph/document/index.d.ts +1 -1
  375. package/dist/platform/graph/document/index.js +1 -1
  376. package/dist/platform/graph/index.d.ts +1 -1
  377. package/dist/platform/graph/index.js +1 -1
  378. package/dist/platform/release/index.d.ts +2 -0
  379. package/dist/platform/release/index.js +2 -0
  380. package/dist/platform/schema/callable-authoring.d.ts +21 -0
  381. package/dist/platform/schema/callable-authoring.js +27 -0
  382. package/dist/platform/schema/class-authoring.d.ts +56 -12
  383. package/dist/platform/schema/class-authoring.js +37 -4
  384. package/dist/platform/schema/class-icon-svg.d.ts +9 -0
  385. package/dist/platform/schema/class-icon-svg.js +29 -0
  386. package/dist/platform/schema/class-icon.d.ts +3 -8
  387. package/dist/platform/schema/class-icon.js +2 -29
  388. package/dist/platform/schema/index.d.ts +6 -4
  389. package/dist/platform/schema/index.js +2 -1
  390. package/dist/platform/schema/kernel-compiled.d.ts +2 -0
  391. package/dist/platform/schema/kernel-compiled.js +2 -0
  392. package/dist/platform/schema/kernel.d.ts +4 -2
  393. package/dist/platform/schema/property.d.ts +5 -0
  394. package/dist/platform/schema/schema-authoring.d.ts +14 -7
  395. package/dist/platform/schema/schema-authoring.js +5 -1
  396. package/dist/platform/versioning/dependents.d.ts +18 -0
  397. package/dist/platform/versioning/dependents.js +15 -0
  398. package/dist/platform/versioning/index.d.ts +5 -0
  399. package/dist/platform/versioning/index.js +5 -0
  400. package/dist/platform/versioning/name.d.ts +38 -0
  401. package/dist/platform/versioning/name.js +58 -0
  402. package/dist/platform/versioning/reference.d.ts +48 -0
  403. package/dist/platform/versioning/reference.js +95 -0
  404. package/dist/platform/versioning/version.d.ts +72 -0
  405. package/dist/platform/versioning/version.js +98 -0
  406. package/dist/project/admit.js +1 -5
  407. package/dist/project/define.d.ts +4 -4
  408. package/dist/project/define.js +55 -35
  409. package/dist/project/index.d.ts +1 -1
  410. package/dist/project/install-command.d.ts +6 -0
  411. package/dist/project/install-command.js +9 -0
  412. package/dist/project/project.d.ts +10 -8
  413. package/dist/testing/dataset/define.d.ts +1 -1
  414. package/dist/testing/durable/engine.d.ts +128 -0
  415. package/dist/testing/durable/engine.js +619 -0
  416. package/dist/testing/durable/index.d.ts +3 -0
  417. package/dist/testing/durable/index.js +1 -0
  418. package/dist/testing/durable/steps.d.ts +30 -0
  419. package/dist/testing/durable/steps.js +45 -0
  420. package/dist/testing/index.d.ts +8 -1
  421. package/dist/testing/index.js +6 -1
  422. package/dist/testing/load.js +1 -1
  423. package/dist/testing/query.d.ts +22 -0
  424. package/dist/testing/query.js +35 -0
  425. package/dist/tooling/cli/adapter-command.d.ts +35 -0
  426. package/dist/tooling/cli/adapter-command.js +66 -0
  427. package/dist/tooling/cli/arguments.d.ts +17 -6
  428. package/dist/tooling/cli/arguments.js +175 -52
  429. package/dist/tooling/cli/build.d.ts +55 -0
  430. package/dist/tooling/cli/build.js +77 -0
  431. package/dist/tooling/cli/bun.d.ts +0 -1
  432. package/dist/tooling/cli/bun.js +0 -7
  433. package/dist/tooling/cli/commit.d.ts +35 -0
  434. package/dist/tooling/cli/commit.js +235 -0
  435. package/dist/tooling/cli/deploy-mode.d.ts +26 -0
  436. package/dist/tooling/cli/deploy-mode.js +59 -0
  437. package/dist/tooling/cli/deploy-result.d.ts +80 -0
  438. package/dist/tooling/cli/deploy-result.js +64 -0
  439. package/dist/tooling/cli/diff/declared.d.ts +7 -0
  440. package/dist/tooling/cli/diff/declared.js +27 -0
  441. package/dist/tooling/cli/diff/index.d.ts +30 -0
  442. package/dist/tooling/cli/diff/index.js +58 -0
  443. package/dist/tooling/cli/diff/render.d.ts +15 -0
  444. package/dist/tooling/cli/diff/render.js +131 -0
  445. package/dist/tooling/cli/diff/report.d.ts +88 -0
  446. package/dist/tooling/cli/diff/report.js +154 -0
  447. package/dist/tooling/cli/dotenv.d.ts +5 -5
  448. package/dist/tooling/cli/dotenv.js +6 -36
  449. package/dist/tooling/cli/help.js +173 -60
  450. package/dist/tooling/cli/immutable-deployment.d.ts +83 -0
  451. package/dist/tooling/cli/immutable-deployment.js +135 -0
  452. package/dist/tooling/cli/index.d.ts +12 -4
  453. package/dist/tooling/cli/index.js +6 -3
  454. package/dist/tooling/cli/installed-on.d.ts +83 -0
  455. package/dist/tooling/cli/installed-on.js +156 -0
  456. package/dist/tooling/cli/list.d.ts +152 -0
  457. package/dist/tooling/cli/list.js +331 -0
  458. package/dist/tooling/cli/log.d.ts +5 -2
  459. package/dist/tooling/cli/log.js +9 -2
  460. package/dist/tooling/cli/orchestrate.d.ts +0 -6
  461. package/dist/tooling/cli/orchestrate.js +252 -91
  462. package/dist/tooling/cli/project.d.ts +3 -3
  463. package/dist/tooling/cli/publish/index.d.ts +81 -0
  464. package/dist/tooling/cli/publish/index.js +383 -0
  465. package/dist/tooling/cli/publish/report.d.ts +49 -0
  466. package/dist/tooling/cli/publish/report.js +15 -0
  467. package/dist/tooling/cli/registry/client.d.ts +121 -0
  468. package/dist/tooling/cli/registry/client.js +354 -0
  469. package/dist/tooling/cli/registry/error.d.ts +11 -0
  470. package/dist/tooling/cli/registry/error.js +17 -0
  471. package/dist/tooling/cli/registry/executable.d.ts +35 -0
  472. package/dist/tooling/cli/registry/executable.js +96 -0
  473. package/dist/tooling/cli/registry/index.d.ts +9 -0
  474. package/dist/tooling/cli/registry/index.js +8 -0
  475. package/dist/tooling/cli/registry/installations.d.ts +67 -0
  476. package/dist/tooling/cli/registry/installations.js +108 -0
  477. package/dist/tooling/cli/registry/process.d.ts +36 -0
  478. package/dist/tooling/cli/registry/process.js +119 -0
  479. package/dist/tooling/cli/secrets.d.ts +9 -0
  480. package/dist/tooling/cli/secrets.js +19 -0
  481. package/dist/tooling/cli/yank.d.ts +34 -0
  482. package/dist/tooling/cli/yank.js +32 -0
  483. package/dist/tooling/linter/adapters/typescript/definition-calls.d.ts +34 -0
  484. package/dist/tooling/linter/adapters/typescript/definition-calls.js +88 -0
  485. package/dist/tooling/linter/adapters/typescript/imports.d.ts +0 -1
  486. package/dist/tooling/linter/adapters/typescript/imports.js +1 -5
  487. package/dist/tooling/linter/adapters/typescript/index.d.ts +3 -2
  488. package/dist/tooling/linter/adapters/typescript/index.js +3 -2
  489. package/dist/tooling/linter/adapters/typescript/query-observation.js +37 -12
  490. package/dist/tooling/linter/adapters/typescript/syntax.d.ts +3 -3
  491. package/dist/tooling/linter/adapters/typescript/syntax.js +13 -25
  492. package/dist/tooling/linter/adapters/typescript/type-analysis.d.ts +2 -0
  493. package/dist/tooling/linter/adapters/typescript/type-analysis.js +10 -0
  494. package/dist/tooling/linter/implementations/source/callable-requirements.d.ts +1 -2
  495. package/dist/tooling/linter/implementations/source/callable-requirements.js +11 -16
  496. package/dist/tooling/linter/implementations/source/definitions.d.ts +2 -0
  497. package/dist/tooling/linter/implementations/source/definitions.js +425 -0
  498. package/dist/tooling/linter/implementations/source/dependencies.js +13 -72
  499. package/dist/tooling/linter/implementations/source/global.js +18 -11
  500. package/dist/tooling/linter/implementations/source/mutations.js +146 -48
  501. package/dist/tooling/linter/implementations/source/policy-edges.d.ts +2 -0
  502. package/dist/tooling/linter/implementations/source/policy-edges.js +113 -0
  503. package/dist/tooling/linter/implementations/source/providers.js +5 -5
  504. package/dist/tooling/linter/implementations/source/queries.js +1 -17
  505. package/dist/tooling/linter/implementations/source/shared.d.ts +19 -5
  506. package/dist/tooling/linter/implementations/source/shared.js +131 -55
  507. package/dist/tooling/linter/implementations/source/verifiers.js +4 -2
  508. package/dist/tooling/linter/implementations/source/views.js +2 -2
  509. package/dist/tooling/linter/implementations/source/workflows.js +499 -17
  510. package/dist/tooling/linter/policy/generated.js +15 -64
  511. package/dist/tooling/linter/requirements/registry.js +11 -9
  512. package/dist/tooling/packaging/declarations/ownership.js +1 -1
  513. package/dist/tooling/packaging/finalize.d.ts +1 -1
  514. package/dist/tooling/packaging/finalize.js +1 -1
  515. package/docs/admission-age.md +88 -0
  516. package/docs/auth-api-migration.md +55 -0
  517. package/docs/business-errors.md +42 -0
  518. package/docs/domain-definition-migration.md +44 -0
  519. package/docs/domain-schema-migration.md +36 -0
  520. package/docs/durable-workflows.md +473 -0
  521. package/docs/handler-dependencies.md +285 -0
  522. package/docs/legacy/query-v6.md +62 -0
  523. package/docs/queries.md +492 -0
  524. package/docs/release.md +155 -0
  525. package/docs/schema-cost.md +124 -0
  526. package/package.json +53 -21
  527. package/dist/application/application.d.ts +0 -28
  528. package/dist/application/query/execution/projection.d.ts +0 -3
  529. package/dist/application/query/execution/projection.js +0 -3
  530. package/dist/deployment/adapter/deploy/context.d.ts +0 -15
  531. package/dist/deployment/adapter/deploy/index.d.ts +0 -2
  532. package/dist/deployment/adapter/deploy/result.d.ts +0 -50
  533. package/dist/deployment/adapter/prepare/artifact.d.ts +0 -33
  534. package/dist/deployment/adapter/prepare/context.d.ts +0 -23
  535. package/dist/deployment/adapter/prepare/index.d.ts +0 -2
  536. package/dist/deployment/deploy.d.ts +0 -20
  537. package/dist/deployment/deploy.js +0 -31
  538. package/dist/deployment/release/publication/index.d.ts +0 -6
  539. package/dist/deployment/release/publication/index.js +0 -6
  540. package/dist/deployment/release/publication/manifest.d.ts +0 -3
  541. package/dist/deployment/release/publication/manifest.js +0 -5
  542. package/dist/deployment/release/publication/requirements.d.ts +0 -3
  543. package/dist/deployment/release/publication/requirements.js +0 -3
  544. package/dist/deployment/release/publication/seal.d.ts +0 -10
  545. package/dist/deployment/release/publication/seal.js +0 -39
  546. package/dist/deployment/verify/preflight/artifact.d.ts +0 -6
  547. package/dist/deployment/verify/preflight/artifact.js +0 -122
  548. package/dist/deployment/verify/preflight/publication.d.ts +0 -4
  549. package/dist/deployment/verify/preflight/publication.js +0 -14
  550. package/dist/deployment/verify/readiness/deployment.d.ts +0 -3
  551. package/dist/deployment/verify/readiness/deployment.js +0 -151
  552. package/dist/deployment/verify/readiness/publication.d.ts +0 -11
  553. package/dist/deployment/verify/readiness/publication.js +0 -41
  554. package/dist/execution/service/errors.d.ts +0 -3
  555. package/dist/execution/service/errors.js +0 -3
  556. package/dist/execution/service/publication/delivery.d.ts +0 -2
  557. package/dist/execution/service/publication/installation.d.ts +0 -3
  558. package/dist/execution/service/publication/installation.js +0 -8
  559. package/dist/execution/service/publication/source.d.ts +0 -3
  560. package/dist/execution/service/publication/source.js +0 -11
  561. package/dist/platform/publication/index.d.ts +0 -2
  562. package/dist/platform/publication/index.js +0 -2
  563. package/dist/tooling/cli/astrale/authority.d.ts +0 -5
  564. package/dist/tooling/cli/astrale/authority.js +0 -11
  565. package/dist/tooling/cli/astrale/executable.d.ts +0 -2
  566. package/dist/tooling/cli/astrale/executable.js +0 -47
  567. package/dist/tooling/cli/astrale/failure.d.ts +0 -6
  568. package/dist/tooling/cli/astrale/failure.js +0 -48
  569. package/dist/tooling/cli/astrale/instance.d.ts +0 -11
  570. package/dist/tooling/cli/astrale/instance.js +0 -52
  571. package/dist/tooling/cli/astrale/process.d.ts +0 -13
  572. package/dist/tooling/cli/astrale/process.js +0 -94
  573. package/dist/tooling/cli/astrale/version.d.ts +0 -18
  574. package/dist/tooling/cli/astrale/version.js +0 -55
  575. package/dist/tooling/cli/credential.d.ts +0 -2
  576. package/dist/tooling/cli/credential.js +0 -57
  577. package/dist/tooling/cli/deprecations.d.ts +0 -9
  578. package/dist/tooling/cli/deprecations.js +0 -15
  579. package/dist/tooling/cli/development/candidate.d.ts +0 -25
  580. package/dist/tooling/cli/development/candidate.js +0 -176
  581. package/dist/tooling/cli/development/deployment.d.ts +0 -16
  582. package/dist/tooling/cli/development/deployment.js +0 -39
  583. package/dist/tooling/cli/development/develop.d.ts +0 -11
  584. package/dist/tooling/cli/development/develop.js +0 -243
  585. package/dist/tooling/cli/development/lease.d.ts +0 -18
  586. package/dist/tooling/cli/development/lease.js +0 -163
  587. package/dist/tooling/cli/development/lifecycle.d.ts +0 -9
  588. package/dist/tooling/cli/development/lifecycle.js +0 -43
  589. package/dist/tooling/cli/development/project-imports.d.ts +0 -22
  590. package/dist/tooling/cli/development/project-imports.js +0 -39
  591. package/dist/tooling/cli/development/project-lock.d.ts +0 -16
  592. package/dist/tooling/cli/development/project-lock.js +0 -41
  593. package/dist/tooling/cli/development/rebuild.d.ts +0 -13
  594. package/dist/tooling/cli/development/rebuild.js +0 -58
  595. package/dist/tooling/cli/development/release-evidence.d.ts +0 -4
  596. package/dist/tooling/cli/development/release-evidence.js +0 -10
  597. package/dist/tooling/cli/development/report.d.ts +0 -6
  598. package/dist/tooling/cli/development/report.js +0 -14
  599. package/dist/tooling/cli/development/session-file.d.ts +0 -53
  600. package/dist/tooling/cli/development/session-file.js +0 -337
  601. package/dist/tooling/cli/development/source-watch.d.ts +0 -14
  602. package/dist/tooling/cli/development/source-watch.js +0 -140
  603. package/dist/tooling/cli/development/sources.d.ts +0 -7
  604. package/dist/tooling/cli/development/sources.js +0 -48
  605. package/dist/tooling/cli/development/target-lock.d.ts +0 -16
  606. package/dist/tooling/cli/development/target-lock.js +0 -68
  607. package/dist/tooling/cli/development/view.d.ts +0 -28
  608. package/dist/tooling/cli/development/view.js +0 -151
  609. package/dist/tooling/cli/environment-release.d.ts +0 -21
  610. package/dist/tooling/cli/environment-release.js +0 -46
  611. package/dist/tooling/cli/evidence.d.ts +0 -11
  612. package/dist/tooling/cli/evidence.js +0 -53
  613. package/dist/tooling/cli/installation/index.d.ts +0 -2
  614. package/dist/tooling/cli/installation/index.js +0 -1
  615. package/dist/tooling/cli/installation/observation.d.ts +0 -10
  616. package/dist/tooling/cli/installation/observation.js +0 -44
  617. package/dist/tooling/cli/installation/reconcile.d.ts +0 -32
  618. package/dist/tooling/cli/installation/reconcile.js +0 -122
  619. package/dist/tooling/linter/implementations/source/migrations.d.ts +0 -2
  620. package/dist/tooling/linter/implementations/source/migrations.js +0 -113
  621. package/dist/tooling/linter/qualification/index.d.ts +0 -10
  622. package/dist/tooling/linter/qualification/index.js +0 -2
  623. package/dist/tooling/linter/qualification/query-fixtures.d.ts +0 -2
  624. package/dist/tooling/linter/qualification/query-fixtures.js +0 -68
  625. package/dist/tooling/linter/qualification/runner.d.ts +0 -3
  626. package/dist/tooling/linter/qualification/runner.js +0 -6
  627. /package/dist/application/{application.js → domain.js} +0 -0
  628. /package/dist/application/{query/single/query.js → mutation/legacy/v6/builder.js} +0 -0
  629. /package/dist/{deployment/adapter/deploy/context.js → application/mutation/legacy/v6/mutation.js} +0 -0
  630. /package/dist/application/mutation/{authoring → legacy/v6}/precondition.js +0 -0
  631. /package/dist/{deployment/adapter/deploy/index.js → application/query/answer/answer.js} +0 -0
  632. /package/dist/{deployment/adapter/deploy/result.js → application/query/defined/query.js} +0 -0
  633. /package/dist/{deployment/adapter/prepare/artifact.js → application/query/execution/client.js} +0 -0
  634. /package/dist/{deployment/adapter/prepare/context.js → application/query/handles/conditions.js} +0 -0
  635. /package/dist/{deployment/adapter/prepare/index.js → application/query/handles/domain.js} +0 -0
  636. /package/dist/application/query/{collection → legacy/v6/collection}/identity.js +0 -0
  637. /package/dist/application/query/{collection → legacy/v6/collection}/limits.d.ts +0 -0
  638. /package/dist/application/query/{collection → legacy/v6/collection}/limits.js +0 -0
  639. /package/dist/application/query/{collection → legacy/v6/collection}/metadata.js +0 -0
  640. /package/dist/application/query/{execution → legacy/v6/execution}/pages.d.ts +0 -0
  641. /package/dist/application/query/{execution → legacy/v6/execution}/pages.js +0 -0
  642. /package/dist/application/query/{single → legacy/v6/single}/index.d.ts +0 -0
  643. /package/dist/application/query/{single → legacy/v6/single}/index.js +0 -0
  644. /package/dist/application/query/{single → legacy/v6/single}/node.d.ts +0 -0
  645. /package/dist/application/query/{single → legacy/v6/single}/node.js +0 -0
  646. /package/dist/application/query/{single → legacy/v6/single}/pagination.d.ts +0 -0
  647. /package/dist/application/query/{single → legacy/v6/single}/selection.d.ts +0 -0
  648. /package/dist/application/query/{single → legacy/v6/single}/selection.js +0 -0
  649. /package/dist/deployment/release/{publication → served}/routes.d.ts +0 -0
  650. /package/dist/deployment/release/{publication → served}/routes.js +0 -0
  651. /package/dist/execution/service/{publication → serving}/index.js +0 -0
@@ -0,0 +1,36 @@
1
+ # Domain name and entrypoint in the root Schema
2
+
3
+ ```ts
4
+ const Schema = defineSchema('tasks.example.dev', {
5
+ name: 'Tasks',
6
+ views: { application: view({}) },
7
+ entrypoint: 'application',
8
+ })
9
+
10
+ const frontend = defineFrontend({
11
+ schema: Schema,
12
+ source: vite(),
13
+ routes: { application: '/' },
14
+ })
15
+ ```
16
+
17
+ The root owns the display name and its optional own View entrypoint. A frontend supplies source
18
+ and route placement; it does not select the Domain's entrypoint. A release authors neither field.
19
+ Schemas without a frontend can still declare a name. Removing an entrypoint is an explicit Schema
20
+ revision, rather than an accidental change to frontend placement. A dependency View cannot become
21
+ the root's entrypoint.
22
+
23
+ Migration changes:
24
+
25
+ - Add `name` to every newly authored root Schema. The canonical Kernel builder owns validation;
26
+ the SDK must not emulate it with a structurally compatible wrapper.
27
+ - Move `defineFrontend({ entrypoint })` to `defineSchema(origin, { entrypoint })`. A single View
28
+ no longer implicitly selects a frontend entrypoint. Omitting the root field means no entrypoint.
29
+ - Scaffold variants stamp the package's own final name into the root Schema and declare an
30
+ entrypoint only for variants with an authored View.
31
+ - Frontend routes and files remain deployment material. The Schema revision carries the Domain
32
+ name / entrypoint; the frontend digest and release manifest do not duplicate those fields.
33
+ A coherent SDK and Kernel package cohort owns this contract end to end. Authoring, portable
34
+ declarations, compiled Schema restoration, Release4 serving and installed Domain inspection must
35
+ agree on the same name and entrypoint. There is no compatibility path for unnamed Schema documents
36
+ or legacy Release projections.
@@ -0,0 +1,473 @@
1
+ # Durable Workflows
2
+
3
+ A callable whose Schema declares `execution: { durable: true }` runs on the Kernel's workflow
4
+ engine. A call returns at once with the `K.Execution` it recorded; the engine journals the run,
5
+ keeps its timers and promises, retries it and survives restarts of the Domain, the Kernel and the
6
+ engine itself.
7
+
8
+ ```ts
9
+ // schema/schema.ts, in the Invoice Class
10
+ remind: method({
11
+ auth: 'authenticated',
12
+ input: z.object({ note: z.string() }),
13
+ output: z.object({ reminder: z.string() }),
14
+ execution: { durable: true },
15
+ })
16
+ ```
17
+
18
+ A durable callable needs `authenticated` or `authorized` auth, a value input and output, and a
19
+ remote binding. Implement it with `defineWorkflow`; `defineAction` refuses a durable callable.
20
+
21
+ ```ts
22
+ export const remind = defineWorkflow<typeof schema>()(
23
+ 'Invoice.remind',
24
+ async ({ input, self, execution, step, sleep, awaitSignal }) => {
25
+ const sent = await step.query(
26
+ 'count-reminders',
27
+ remindersOf,
28
+ { invoice: self },
29
+ { as: 'executor' },
30
+ )
31
+ const reminder = await step.mutate(
32
+ 'record',
33
+ recordReminder,
34
+ { invoice: self, rank: sent.length + 1, note: input.note, execution: execution.id },
35
+ { as: 'executor' },
36
+ )
37
+ await sleep(24 * 60 * 60_000)
38
+ const approval = await awaitSignal<{ readonly by: string }>('approval')
39
+ return { reminder: `${reminder}:${approval.by}` }
40
+ },
41
+ )
42
+ ```
43
+
44
+ ## Context
45
+
46
+ | Member | Meaning |
47
+ | --- | --- |
48
+ | `input`, `self`, `domain` | As for any Workflow; `self` is the receiver of an instance Method. |
49
+ | `execution` | Attested facts: `id`, `function {id, version}`, `kernel`, `initiator {principal, caller}`, `receiver`. Data, never authority. |
50
+ | `step.run(step, execute)` | Runs `execute` once and journals its portable output; a replay returns the journaled output. `execute` receives the capabilities of an Action, acting as the executor alone: `kernel`, `graph`, `query`, `mutate`, `dependencies` and `integrations`. `step` is the Step's id, or `{ id, retry, timeoutMs }` (see [Retry budgets and timeouts](#retry-budgets-and-timeouts)). |
51
+ | `step.query(step, query, input, { as: 'executor' })` | One journaled [Query](queries.md), read as the executor; a replay returns the result of its first run. A Query V6 definition takes `step.query(step, query, input?)`. |
52
+ | `step.mutate(step, mutation, input, { as: 'executor' })` | One journaled [defined Mutation](queries.md#defining-a-mutation), written as the executor; a replay returns the result of its first commit. A Mutation of the closure form takes `step.mutate(step, mutation, input)`. |
53
+ | `step.parallel(declare)` | Runs the Steps `declare` declares together, in one round trip to the engine; see [Parallel Steps](#parallel-steps). |
54
+ | `sleep(ms)` | Durable timer, kept by the engine even while the Domain is down. |
55
+ | `awaitSignal(name)` | Waits for the value `Execution.signal({ name, value })` delivers once under `name`, sent before or during the wait. |
56
+ | `awaitSignal(name, { timeoutMs })` | Waits at most `timeoutMs`: `{ kind: 'signal', value }` or `{ kind: 'timeout' }`. |
57
+ | `cancelled(error)` | Whether `error` is the engine's cooperative cancellation; catch it to compensate. |
58
+ | `exhausted(error)` | Whether `error` is a Step that spent its retry budget, or that the Kernel refused for good; catch it to take another path. |
59
+ | `retryAfter(ms, cause?)` | The failure to throw inside a Step whose next attempt must wait `ms` (at most one hour), as an HTTP `Retry-After` asks. It spends an attempt. |
60
+ | `error(code, details)` | Declared business errors, as for any Workflow; they become the `failed` outcome. |
61
+
62
+ A durable run acts as its Domain, never as its caller: the Workflow and its Steps have no `caller`,
63
+ and `kernel`, `graph` and `dependencies` offer only `self`. The Kernel is reachable only inside a
64
+ Step, so every Kernel call is journaled and a replay never repeats it. A Step whose outcome was not
65
+ journaled runs again. What a retried Step repeats depends on the call:
66
+
67
+ | Call inside a Step | On a retry of the Step |
68
+ | --- | --- |
69
+ | Mutation (`step.mutate`, `mutate`, `graph.self.mutate`, `kernel.mutate`) | Carries a key derived from the Execution, the Step and its position. The Kernel commits a receipt with the write and answers with the first result, without writing again. |
70
+ | `kernel.invoke` or `dependencies.<alias>.self.invoke` of a durable callable | Carries such a key too, so it reaches the same child Execution. The call answers with that Execution's `ExecutionRef`. |
71
+ | `kernel.invoke` or `dependencies.<alias>.self.invoke` of any other callable | Carries no key, because the Kernel accepts one only for a durable Function. The call runs again, so its effects must be idempotent: declare the callee durable, or give it an identity in its input. |
72
+ | Integration operation, `keyed` with source `execution` | Its call id is the next key of the same sequence, and the Provider receives it as `idempotencyKey`: every attempt sends the same key. |
73
+ | Integration operation, `keyed` with source `input` | The Provider receives the key the decision takes from the input. |
74
+ | Integration operation, `safe` | Runs again. |
75
+ | Integration operation that may be `unsafe` | Absent from `integrations`: a retry would repeat it. An operation whose decision turns out `unsafe` is refused before its Provider runs. |
76
+
77
+ A Provider called from a Step receives no `invoke`, since no caller exists, and its `auth.mint` and
78
+ deadline are bounded by the Step's deadline. An operation whose replay is a function counts as
79
+ replayable only when that function never answers `unsafe`.
80
+
81
+ The Host keeps receipts longer than the engine keeps a run, so a Step is never retried after its
82
+ receipt is gone. A callable is known durable from the Schema closure of the Domain: an untyped Path,
83
+ or a callable outside that closure, is keyed only when the call passes its own `idempotencyKey`.
84
+
85
+ This requires a Kernel that keeps Mutation receipts. An older Kernel refuses the Mutation key.
86
+
87
+ Step ids are unique within a run. Steps and waits run one after another: the engine follows one
88
+ awaited operation at a time, and loses track of a run that awaits several together through
89
+ `Promise.all`, `allSettled`, `race` or `any`. A Step, `sleep` or `awaitSignal` started while
90
+ another runs is therefore refused with a `TypeError`, which pauses the run as any error between
91
+ Steps does. Independent reads may share one Step, whose Kernel calls are ordinary calls that
92
+ `Promise.all` may combine:
93
+
94
+ ```ts
95
+ const [invoice, reminders] = await step.run('read-invoice', ({ query }) =>
96
+ Promise.all([
97
+ query(invoiceOf, { invoice: self }, { as: 'executor' }),
98
+ query(remindersOf, { invoice: self }, { as: 'executor' }),
99
+ ]),
100
+ )
101
+ ```
102
+
103
+ Code between Steps must be deterministic.
104
+
105
+ ### Parallel Steps
106
+
107
+ Each Step awaited alone costs one round trip to the engine. `step.parallel` is the one way to run
108
+ several Steps together: the engine follows them as one operation, through its own combinator, and
109
+ they cost one round trip together.
110
+
111
+ ```ts
112
+ const [invoice, sent, receipt] = await step.parallel((s) => [
113
+ s.query('read-invoice', invoiceOf, { invoice: self }, { as: 'executor' }),
114
+ s.query(
115
+ { id: 'count-reminders', retry: { maxAttempts: 5 } },
116
+ remindersOf,
117
+ { invoice: self },
118
+ { as: 'executor' },
119
+ ),
120
+ s.run('charge', ({ integrations }) => integrations.ledger.charge({ amount: 12 })),
121
+ ])
122
+ ```
123
+
124
+ `s` declares Steps with the arguments of `step.run`, `step.query` and `step.mutate`, and starts
125
+ nothing; `declare` returns exactly the Steps it declares, as an array. Each Step keeps its id,
126
+ retry budget, timeout and keys, as if it ran alone. Once every Step has settled, `step.parallel`
127
+ resolves with their outputs in declaration order, or throws the failure of the first failed Step in
128
+ that order, as that Step alone would throw it: a declared error, a `STEP_EXHAUSTED` that `exhausted`
129
+ recognizes, or a cancellation. The other Steps have run by then, and their effects stand. An empty
130
+ list resolves with `[]`. Parallel Steps do not nest, and a Step that depends on another's output
131
+ runs after it.
132
+
133
+ Run reads and independent effects together. Keep in sequence the effects a failure would make you
134
+ compensate, so the Workflow knows which ones committed.
135
+
136
+ ## From an inline Workflow
137
+
138
+ The same `defineWorkflow` implements an inline and a durable Workflow; the Schema decides which.
139
+ Declaring `execution: { durable: true }` on a callable changes the context its Workflow receives:
140
+
141
+ | Inline Workflow | Durable Workflow |
142
+ | --- | --- |
143
+ | `query` and `mutate` in the context, under the authority `as` names (a V6 Query, and a Mutation without `as`, as the executor); `kernel`, `graph` and `dependencies`, as the executor or the caller | Only inside a Step, as the executor alone: `step.query`, `step.mutate`, or `step.run(id, ({ query, mutate, kernel, graph, dependencies }) => …)` |
144
+ | `integrations` in the context, with every operation | Inside `step.run` only, without the operations that may be `unsafe` |
145
+ | `caller` | Absent; `execution.initiator` records who started the run, as data |
146
+ | `execution`: `signal`, `deadline`, `idempotencyKey`, `background`, `sleep`, `request` | `execution`: `id`, `function`, `kernel`, `initiator`, `receiver`; `sleep` is a member of the context |
147
+ | `step.run(id, () => …)`, not journaled | `step.run`, `step.query`, `step.mutate` and `step.parallel`, journaled, each Step under its retry budget |
148
+ | A failing Step throws into the Workflow at once | A failing Step is attempted again within its budget, then throws `STEP_EXHAUSTED` into the Workflow |
149
+ | Callers receive the output | Callers receive `ExecutionRef<Output>`; the Workflow still returns the output |
150
+
151
+ The type checker reports every use of a member the durable context lacks, and every caller that
152
+ reads the output. Three changes it cannot see:
153
+
154
+ - A business refusal a Step throws as anything but `error(...)` is attempted again until the Step
155
+ spends its budget, and the Execution ends `STEP_EXHAUSTED` instead of the refusal. Turn a refusal
156
+ into its declared error inside the Step that detects it, not around the Step.
157
+ - Code between Steps runs again on every replay. A value it reads from the clock or randomness
158
+ differs on the next attempt; read it in a Step. `FNC-REPLAY-VALUES` warns on such a read.
159
+ - A caller that ignores the output, such as a View that refreshes after the call, compiles unchanged
160
+ but refreshes before the Execution ends. Follow the Execution, and refresh when it ends.
161
+
162
+ `createTestWorkflowEngine` (see [Testing](#testing)) shows the first two: a refusal path ends
163
+ `STEP_EXHAUSTED`, with what the last attempt threw in `failure`, and code whose path differs on
164
+ replay fails with `JournalMismatch`.
165
+
166
+ ## Reads and effects
167
+
168
+ The engine retries a Step as a whole, so running it again must be safe. A Step may make several
169
+ reads, and the keys of the table above make its effects safe to repeat. What a Step must not do is
170
+ read before its effect: an effect Step builds its request only from the Workflow input and the
171
+ results of earlier Steps, so it reads what it needs with `step.query` first:
172
+
173
+ ```ts
174
+ const sent = await step.query('count-reminders', remindersOf, { invoice: self }, { as: 'executor' })
175
+ await step.mutate('record', recordReminder, { invoice: self, rank: sent.length + 1 }, { as: 'executor' })
176
+ ```
177
+
178
+ A Step can commit its effect and lose its journal entry; the engine then runs it again with the same
179
+ keys. The Kernel answers a Mutation from its receipt only when the request is the same. Rebuilt from a
180
+ read made earlier in the same Step, the request can differ, since that read now sees the Step's own
181
+ write: the Kernel refuses it with `MUTATION_IDEMPOTENCY_CONFLICT` on every attempt until the Step
182
+ spends its budget and the Execution fails, or a guard on the read takes the other branch and the
183
+ Execution fails although its effect committed. A read from an earlier Step replays unchanged, so the retried request is
184
+ identical. A read after the effect sees the same write on every attempt.
185
+
186
+ Two effects in one Step replay safely, each under its own key, but when the second fails after the
187
+ first committed, the Step reports only its failure and the Workflow cannot tell what to compensate.
188
+ Give each effect its own Step; two Mutations that can commit together are one Mutation.
189
+
190
+ The Domain linter checks these rules in a durable Workflow. `FNC-STEP-READS` reports a Step
191
+ that reads before its effect, unless the two take exclusive branches. `FNC-EFFECT-STEP` warns on a
192
+ Step where one run can make two effects, or repeat one in a loop. `FNC-STEP-RETRY` warns on a call a retried
193
+ Step repeats with no key: a callable the types prove not durable, an untyped Path, or `fetch`. A call
194
+ whose kind the source does not prove is not reported. `FNC-REPLAY-VALUES` warns on a read of the clock
195
+ or randomness (`Date.now()`, `new Date()`, `Math.random()`, `crypto.randomUUID()`) in the code a replay
196
+ runs again: the Workflow's body outside its Steps, the arguments of a Step call included.
197
+
198
+ A journaled read is the value at the moment its Step ran; a Step that runs later, after retries or a
199
+ pause, does not read it again. A fact that must still hold when the effect commits is a precondition
200
+ of the Mutation (`mutation.expect`). Map `MUTATION_PRECONDITION_FAILED` in the Mutation's `reject` to
201
+ a result the Workflow handles, such as a declared error; unmapped, the engine retries it until the
202
+ Step spends its budget. A retried Step whose Mutation already committed still receives that commit's
203
+ receipt, even though its precondition no longer holds.
204
+
205
+ ## Testing
206
+
207
+ `createTestWorkflowEngine` from `@astrale-os/sdk/testing` runs a durable Workflow in memory with
208
+ the receiver a Host serves; only the engine is simulated. Each Step journals its result, every
209
+ attempt replays the journal, timers follow a virtual clock, signals are buffered, a failing Step is
210
+ retried within its budget and then fails into the Workflow, a run failing outside any Step is
211
+ retried until it pauses, and cancellation is cooperative.
212
+
213
+ ```ts
214
+ import { createTestWorkflowEngine } from '@astrale-os/sdk/testing'
215
+
216
+ const engine = createTestWorkflowEngine()
217
+ const execution = await engine.start(remind, {
218
+ schema: Billing, // the resolved Schema
219
+ input: { note: 'soon' },
220
+ self: invoice, // receiver of an instance Method
221
+ capabilities: {
222
+ query: (query, input) => 2,
223
+ mutate: (mutation, input, { idempotencyKey }) => 'reminder-3',
224
+ kernel: { invoke: async (reference, input, options) => ({ id: 'execution-child' }) },
225
+ },
226
+ providers: { ledger: testLedger }, // Providers of the Workflow's Integrations
227
+ })
228
+ await engine.advance(24 * 60 * 60_000) // wake the sleeping run
229
+ await execution.signal('approval', { by: 'alice' })
230
+ expect(execution.outcome).toEqual({ kind: 'completed', value: { reminder: 'reminder-3' } })
231
+ await execution.replay() // the journal alone reaches the same outcome
232
+ ```
233
+
234
+ | Member | Meaning |
235
+ | --- | --- |
236
+ | `capabilities` | What a Step reaches instead of a Kernel. `query` and `mutate` answer the Step's Queries and Mutations; `mutate` receives the key a Host sends. `kernel` is the Step's Session: `kernel.invoke` and every `dependencies` call reach its `invoke`, keyed for a durable callee. |
237
+ | `providers` | Providers bound through the Steps' key sequence, as on a Host. |
238
+ | `retry` option | The deployment's `durable.retry`: the budget of every Step that declares none, and with `maxAttempts` the attempts of a run failing outside any Step. |
239
+ | `state`, `outcome`, `failure` | `running`, `waiting`, `paused`, `completed`, `failed` or `cancelled`; the outcome as `Execution.result` answers it; what the last failed attempt threw, which a `STEP_EXHAUSTED` outcome does not carry. |
240
+ | `signal`, `cancel`, `resume` | As the `K.Execution` Methods; each settles the run again. |
241
+ | `advance(ms)` | Moves the virtual clock and settles every waiting run. |
242
+ | `replay()` | Runs the Workflow from its journal alone and fails if it runs a Step again, diverges or ends differently. |
243
+ | `interruptAfter(id)`, or the `interruptAfter` option | Loses Step `id`'s first result before the journal records it, as a crash after its effect: the engine retries the Step, which presents the same keys. |
244
+ | `journal`, `attempts` | The recorded entries, each Step with the times it ran, and the attempts of the run. |
245
+
246
+ A Workflow whose code between Steps is not deterministic fails its next attempt with
247
+ `JournalMismatch` and pauses. A retry after an attempt that spent the Step's budget does not wait
248
+ out its backoff, but the backoff it skips, or the delay its `retryAfter` asks for, counts toward the
249
+ Step's `maxDurationMs`. A wait for the platform, after a Kernel refusal that prescribes a delay or an
250
+ unreachable Kernel, is a timer: the run is `waiting` until `advance` reaches it. Code should await only
251
+ Steps and the context's own operations; the engine counts a run as waiting once it waits on a timer or
252
+ a signal and nothing else runs.
253
+
254
+ ## Signals
255
+
256
+ A signal is delivered once per name: `Execution.signal` resolves it, a second signal of the same name
257
+ is refused, and a signal sent before the wait is kept for it. A bounded wait races the signal against
258
+ a durable timer:
259
+
260
+ ```ts
261
+ const consent = await awaitSignal<{ readonly code: string }>('consent', { timeoutMs: 15 * 60_000 })
262
+ if (consent.kind === 'timeout') throw error('CONSENT_EXPIRED', {})
263
+ ```
264
+
265
+ The engine journals which came first, so a replay answers the same even when the signal arrived
266
+ after the timeout; such a signal is kept for a later wait under the same name. Race durable waits
267
+ only through `awaitSignal`: `Promise.race` over `sleep` and `awaitSignal` is not journaled and does
268
+ not settle on the engine.
269
+
270
+ ## Retry budgets and timeouts
271
+
272
+ A declared business error ends the Execution as `failed { family, code, message, details }`, with no
273
+ retry. Any other error a Step throws fails that attempt. What follows depends on what the attempt
274
+ failed on, read from the Kernel answer or the transport failure the error is, or carries as a `cause`:
275
+
276
+ | The attempt failed on | The Step |
277
+ | --- | --- |
278
+ | The platform: a Kernel refusal that prescribes a delay (`CAPACITY_EXHAUSTED`, `SERVER_DRAINING`, `INSTANCE_MAINTENANCE`) or a stale snapshot; a Kernel or Release discovery that does not answer (a network failure, HTTP `429`, `502` or `503`) to a request that did not leave, or to a Query or a keyed call; `OUTCOME_UNKNOWN` to a Query or a keyed call | Waits, and is attempted again without spending its budget, for as long as the platform stays unavailable within its `maxDurationMs`. |
279
+ | A request the Kernel never accepts as sent: `PARSE_ERROR`, `INVALID_REQUEST`, `METHOD_NOT_ALLOWED`, `UNSUPPORTED`, an expectation or a callable fingerprint that no longer matches, a stale maintenance session | Fails at once. |
280
+ | Anything else: the Step's code, a Provider, `retryAfter`, a deadline, any other Kernel refusal, an unkeyed call whose outcome is unknown | Spends an attempt, and is attempted again within its budget. |
281
+
282
+ A Query, a Mutation and an `invoke` of a durable callable repeat no effect when sent again, the last
283
+ two by their key, so the Step waits out their unavailability. An unkeyed `invoke` that may have
284
+ reached the Kernel may have run: sending it again is the Step's own risk, and spends an attempt. So
285
+ does any failure of an attempt that sent one, since the next attempt sends it again: an outage never
286
+ repeats an unkeyed `invoke` beyond the Step's budget.
287
+
288
+ A Step that spends its budget, or fails at once, throws into the Workflow; uncaught, the Execution
289
+ ends `failed` with code `STEP_EXHAUSTED`:
290
+
291
+ ```ts
292
+ { kind: 'failed', error: { code: 'STEP_EXHAUSTED', message: 'Workflow Step notify exhausted its retries.', details: { step: 'notify' } } }
293
+ ```
294
+
295
+ The outcome never carries what the last attempt threw. When the Kernel refused that attempt, the
296
+ outcome names the refusal by its codes alone, never its message:
297
+
298
+ ```ts
299
+ details: { step: 'archive', refusal: { code: 2002, reason: 'AUTH_INVALID' } }
300
+ ```
301
+
302
+ `code` is the Kernel error code; `reason`, when the Kernel gave one, its reason code. A refusal
303
+ behind another error, as its `cause`, counts as well; any other failure leaves `refusal` out.
304
+
305
+ A Query read that fails in `step.query` throws its `QueryError` into the Workflow at once, from the
306
+ journal on a replay: what it met will not change on a retry. A read the Kernel refused is the
307
+ exception, a failed attempt like any refusal. Uncaught, the outcome names the `QueryError`'s code
308
+ and the Query's id, never its details:
309
+
310
+ ```ts
311
+ details: { step: 'invoice', query: { code: 'NOT_FOUND', id: 'billing.invoice.find' } }
312
+ ```
313
+
314
+ A Query whose relation crosses a dependency's Class the Domain does not require fails its Step
315
+ the same way, with the `TypeError` that names the requirement it needs. Uncaught, the outcome's
316
+ message carries that requirement, and `query` names the Query's id alone.
317
+
318
+ A failed Execution is never resumed: a new attempt is a new Execution, under a new key, so its Steps
319
+ run their effects again under new keys.
320
+
321
+ Each Step runs under the deployment's budget and timeout, or under the ones it declares:
322
+
323
+ ```ts
324
+ await step.mutate('record', recordReminder, input, { as: 'executor' }) // the deployment's budget and timeout
325
+
326
+ try {
327
+ await step.run({ id: 'notify', retry: { maxAttempts: 5 }, timeoutMs: 120_000 }, ({ integrations }) =>
328
+ integrations.mailer.send(reminder),
329
+ )
330
+ } catch (cause) {
331
+ if (!exhausted(cause)) throw cause
332
+ await step.mutate('follow-up', recordManualFollowUp, { invoice: self }, { as: 'executor' })
333
+ }
334
+ ```
335
+
336
+ | `retry` field | Meaning | Bounds |
337
+ | --- | --- | --- |
338
+ | `maxAttempts` | Attempts that may fail on the Step's own account, the first one included. A wait for the platform spends none. | 1 to 1,000 |
339
+ | `maxDurationMs` | Time from the first attempt after which a failed attempt is not retried, whatever it failed on; an attempt already scheduled still runs. The only bound on waiting for the platform. | 1 ms to 365 days |
340
+ | `initialIntervalMs` | Delay before the first retry, doubled on each failure. | 1 ms to one hour |
341
+ | `maxIntervalMs` | Longest backoff between two attempts. | `initialIntervalMs` to one day |
342
+
343
+ The limits, `maxAttempts` and `maxDurationMs`, go together: a Step that declares either replaces both
344
+ limits of the deployment, and the one it omits does not bound it. The budget is spent at the first
345
+ limit reached; a Step without `maxDurationMs` waits for the platform until it answers or the run is
346
+ cancelled. An interval the Step leaves out is the deployment's. `timeoutMs` bounds one attempt, its
347
+ Kernel calls included, from one second to ten minutes: past it, the attempt fails, what it holds is
348
+ aborted, and the failure spends an attempt. Each Workflow service declares to the engine an abort
349
+ timeout of fifteen minutes, so a Step's own timeout always ends its attempt before the engine would
350
+ cut it.
351
+
352
+ An attempt after a failure of the Step's own waits its backoff, which doubles with each such
353
+ failure. An attempt after a platform failure waits the longer of the delay the Kernel prescribes and a
354
+ backoff that doubles with each platform failure since the Step's last own failure. Under the default
355
+ intervals, a Step reaches an unavailable Kernel at most once a minute after its first minute: an hour
356
+ of outage costs about 65 attempts and 260 journal entries, and none of its budget. Throw
357
+ `retryAfter(ms, cause)` inside a Step to wait exactly `ms`, for instance on an HTTP `429` with
358
+ `Retry-After`; that attempt spends the budget, since only the Step knows whether its cause clears.
359
+
360
+ A run that fails outside any Step keeps the engine's pause. An input or receiver the code cannot
361
+ read, an output the Schema refuses, a journal whose Steps the code no longer takes, or an error
362
+ thrown between two Steps fails every attempt; after the deployment's `maxAttempts` the Execution is
363
+ `paused` until `Execution.resume()` or `Execution.cancel()`. A deployment the engine cannot reach
364
+ counts the same way, inside a Step or not, since its attempt of the run fails before any Workflow code
365
+ runs: with the default intervals, the run pauses after about fourteen minutes. `resume` attempts the
366
+ run again with the code served at its URL: it helps only once that code answers and can replay the
367
+ journal. A cooperative `cancel` attempts the run again, under the same `maxAttempts`: a run that
368
+ reaches an await sees the cancellation and may compensate (`cancelled(error)`); a run that fails again
369
+ before it awaits anything pauses again, and the Kernel then ends it `cancelled`, without compensation.
370
+ `cancel({ force: true })`, which the owner Domain holds, ends a run at once, without compensation.
371
+
372
+ ## Redeployments
373
+
374
+ A new Release gives new calls a new engine service; running Executions keep theirs, with its URL,
375
+ and every attempt of a run is served by the code at that URL. A run started on one Release ends on
376
+ it, under the following rules.
377
+
378
+ **Serve each Release at its own URL.** `adapter-cloudflare` and `adapter-astrale` deploy each
379
+ Release at an immutable URL, so a run keeps the code that started it, whatever is deployed after.
380
+ Code redeployed in place at the same URL replays the journals of the runs in flight: the engine
381
+ refuses a journal whose Steps no longer match, in order and by id, and pauses the run; code with the
382
+ same Steps continues the run. Renaming, reordering or removing a Step that runs have journaled is
383
+ therefore an incompatible change in place, and no option of the Workflow declares it.
384
+
385
+ **Keep the Schema additive while runs are in flight.** A Step calls the Kernel as installed when it
386
+ calls, not when its run started: a Class, Function or Edge the run uses and a later install removed or
387
+ narrowed refuses its calls, and the Step ends `STEP_EXHAUSTED`, at once when the Kernel can never
388
+ accept the request, such as a callable whose fingerprint changed, otherwise once it spends its budget.
389
+ The install itself only delays the Step, which waits out its maintenance without spending its budget.
390
+ Remove them once the runs that use them have ended.
391
+
392
+ **Do not retire a Release, or remove a durable callable, while runs are in flight.** A retired
393
+ Release no longer answers its URL: its runs no longer progress, a signal to them times out, and a
394
+ cooperative `cancel` ends them `cancelled`, without compensation, once the engine has spent their
395
+ attempts; `cancel({ force: true })` ends them at once. A durable
396
+ callable a new install no longer declares has its runs cancelled by the Kernel, without
397
+ compensation, within minutes.
398
+
399
+ **Keep runs that call the Kernel shorter than the drain bound.** After an issuer change, the
400
+ replaced issuer remains accepted for the runs in flight at the change for at most the Host drain
401
+ bound (7 days by default), described below; a Step of such a run calling the Kernel later is
402
+ refused until it spends its budget, with `STEP_EXHAUSTED`. A run that only waits and journals is
403
+ not bounded.
404
+
405
+ A Step's credential names its Execution (the `execution` claim, `EXECUTION_CLAIM` of
406
+ `@astrale-os/kernel-protocol/issuer/claims`). After a consented issuer change, the Kernel keeps
407
+ accepting the replaced issuer for any call during the Host window (300 s by default), then only for
408
+ the Steps of runs that were in flight at the change and that the engine still holds, for at most
409
+ the Host drain bound (7 days by default). While the engine is unreachable those Steps are refused
410
+ as unavailable and retried. A run started after the change is never accepted on the replaced
411
+ issuer. The replaced deployment signs this claim itself, so it can keep calling for its in-flight
412
+ runs until they end or the drain bound passes; consent with `previous: 'revoke'` to cut it at once.
413
+
414
+ ## Serving
415
+
416
+ `serve({ durable })` serves the engine at
417
+ `<public URL>/invoke/restate/<encoded Kernel issuer>/<declaration>/<service>`. Retained engine
418
+ services registered before issuer-prefixed paths keep their `<declaration>/<service>` callbacks.
419
+ Canonical requests discover their engine's signing keys at
420
+ `<Kernel issuer>/.well-known/astrale/workflow-engine.json` over HTTPS. The discovered document must
421
+ name that issuer, and the signed run must name the same Kernel before any Workflow code runs.
422
+ Discovery follows no redirects, has a ten-second deadline and a 16 KiB document limit, and retains
423
+ at most 64 issuer documents for one minute. An authentication refusal expires its cached authority
424
+ for the next request, at most once per minute; the receiver never replays a consumed request.
425
+ Invalid or unavailable discovery fails the canonical request without falling back to static keys.
426
+ Provide the Restate SDK Fetch build of the platform; every engine request requires its signature.
427
+
428
+ ```ts
429
+ serve({
430
+ // runtime, load, identity, server…
431
+ durable: async () => ({
432
+ engine: await import('@restatedev/restate-sdk/fetch'),
433
+ }),
434
+ })
435
+ ```
436
+
437
+ The provider runs only on the first engine request. Concurrent requests share initialization;
438
+ a successful receiver is reused, and a failed or unconfigured provider can be retried by a later
439
+ request. Health, release and ordinary invocation requests do not load the engine. An already
440
+ loaded engine can still be supplied synchronously.
441
+
442
+ | Option | Default |
443
+ | --- | --- |
444
+ | `retentionMs` | 7 days; at least the Host minimum (one day by default). |
445
+ | `retry` | The budget of every Step that declares none: 10 attempts from 1 s to 60 s, and no duration limit. `maxAttempts` also bounds a run failing outside any Step, which then pauses: 20 attempts when `retry` declares none. The Host caps them. |
446
+ | `stepTimeoutMs` | 60 s per Step attempt that declares no `timeoutMs`, including its Kernel calls; ten minutes at most. |
447
+
448
+ The provider receives the durable `Request`. Its route identifies the HTTPS Kernel whose
449
+ workflow-engine discovery document supplies signing authority. `DurableServing.fetch` supplies
450
+ that discovery capability and is captured when the receiver initializes. Static signing keys and
451
+ routes without a Kernel issuer are refused; they do not initialize the engine.
452
+
453
+ Without `durable`, the Domain refuses the engine and only durable calls fail. An ordinary
454
+ invocation of a durable callable is refused: it never runs inline.
455
+
456
+ ### Cloudflare Workers
457
+
458
+ The Cloudflare adapter serves the engine itself when the Schema declares a durable callable: it
459
+ retains the Restate Workers build and its WebAssembly core in a separate deployed module. The
460
+ module is imported only on the first engine request, so frontend, health, release and ordinary
461
+ invocations do not initialize Restate. Callbacks discover signing authority from their Kernel issuer. Cloudflare owns
462
+ compilation of declared WebAssembly modules; this separation defers their instantiation and the
463
+ JavaScript engine's evaluation. The options above go in the adapter's `durable` parameter.
464
+
465
+ ```ts
466
+ cloudflare({
467
+ namespace: { name: 'deployments', routingDomain: 'deployments.example.com' },
468
+ durable: { retry: { maxAttempts: 10 } },
469
+ })
470
+ ```
471
+
472
+ Each Release is an immutable deployment with its own URL: a new Release gives new calls a new engine
473
+ service, and running Executions keep being served by the deployment that started them.