@atolis-hq/wake 0.4.2 → 0.4.7

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 (702) hide show
  1. package/README.md +9 -0
  2. package/dist/src/activities/agent/agent-activity-definition.d.ts +9 -0
  3. package/dist/src/activities/agent/agent-activity.d.ts +51 -0
  4. package/dist/src/activities/agent/agent-result.d.ts +43 -0
  5. package/dist/src/activities/contracts/activity.d.ts +184 -0
  6. package/dist/src/activities/contracts/config.d.ts +3 -0
  7. package/dist/src/activities/contracts/decision-claim-schema.d.ts +35 -0
  8. package/dist/src/activities/contracts/decision-claim-schema.js +42 -0
  9. package/dist/src/activities/contracts/event-factory.d.ts +6 -0
  10. package/dist/src/activities/contracts/event-factory.js +40 -0
  11. package/dist/src/activities/contracts/event-integrity.d.ts +61 -0
  12. package/dist/src/activities/contracts/event-integrity.js +50 -0
  13. package/dist/src/activities/contracts/event-schema.d.ts +2803 -0
  14. package/dist/src/activities/contracts/event-schema.js +67 -121
  15. package/dist/src/activities/contracts/events.d.ts +153 -0
  16. package/dist/src/activities/contracts/events.js +4 -4
  17. package/dist/src/activities/contracts/identifiers.d.ts +5 -0
  18. package/dist/src/activities/contracts/registry.d.ts +19 -0
  19. package/dist/src/activities/contracts/streams.d.ts +13 -0
  20. package/dist/src/activities/contracts/vocabulary.d.ts +69 -0
  21. package/dist/src/activities/index.d.ts +23 -0
  22. package/dist/src/activities/index.js +1 -0
  23. package/dist/src/activities/issue/complete.d.ts +26 -0
  24. package/dist/src/activities/issue/complete.js +5 -5
  25. package/dist/src/activities/pr/activity-support.d.ts +38 -0
  26. package/dist/src/activities/pr/activity-support.js +1 -1
  27. package/dist/src/activities/pr/application.d.ts +17 -0
  28. package/dist/src/activities/pr/application.js +6 -6
  29. package/dist/src/activities/pr/approve.d.ts +7 -0
  30. package/dist/src/activities/pr/approve.js +8 -3
  31. package/dist/src/activities/pr/capability.d.ts +2 -0
  32. package/dist/src/activities/pr/contracts.d.ts +133 -0
  33. package/dist/src/activities/pr/decision-claim.d.ts +26 -0
  34. package/dist/src/activities/pr/decision-claim.js +50 -30
  35. package/dist/src/activities/pr/event-data.d.ts +21 -0
  36. package/dist/src/activities/pr/event-data.js +101 -0
  37. package/dist/src/activities/pr/intent.d.ts +12 -0
  38. package/dist/src/activities/pr/intent.js +5 -5
  39. package/dist/src/activities/pr/merge-authority-gate.d.ts +13 -0
  40. package/dist/src/activities/pr/merge-authority-gate.js +1 -1
  41. package/dist/src/activities/pr/merge.d.ts +7 -0
  42. package/dist/src/activities/pr/merge.js +8 -3
  43. package/dist/src/activities/pr/policy.d.ts +13 -0
  44. package/dist/src/activities/pr/projection.d.ts +5 -0
  45. package/dist/src/activities/pr/projection.js +18 -17
  46. package/dist/src/activities/pr/vocabulary.d.ts +34 -0
  47. package/dist/src/activities/review/authorization.d.ts +9 -0
  48. package/dist/src/activities/review/contracts.d.ts +46 -0
  49. package/dist/src/activities/review/signals.d.ts +2 -0
  50. package/dist/src/bootstrap/activation-scheduler-serialiser.d.ts +3 -0
  51. package/dist/src/bootstrap/activation-scheduler-serialiser.js +8 -0
  52. package/dist/src/bootstrap/activity-registry.d.ts +4 -0
  53. package/dist/src/bootstrap/analytics-projection.d.ts +12 -0
  54. package/dist/src/bootstrap/analytics-projection.js +3 -3
  55. package/dist/src/bootstrap/board-projection.d.ts +56 -0
  56. package/dist/src/bootstrap/board-projection.js +156 -71
  57. package/dist/src/bootstrap/composition-root.d.ts +76 -0
  58. package/dist/src/bootstrap/composition-root.js +20 -13
  59. package/dist/src/bootstrap/config/load-config.d.ts +6 -0
  60. package/dist/src/bootstrap/config/root-schema.d.ts +443 -0
  61. package/dist/src/bootstrap/event-processor-runtime.d.ts +22 -0
  62. package/dist/src/bootstrap/event-processor-runtime.js +88 -0
  63. package/dist/src/bootstrap/external-ref.d.ts +3 -0
  64. package/dist/src/bootstrap/fake-provider-files.d.ts +3 -0
  65. package/dist/src/bootstrap/fake-scenarios.d.ts +3 -0
  66. package/dist/src/bootstrap/index.d.ts +27 -0
  67. package/dist/src/bootstrap/index.js +2 -28
  68. package/dist/src/bootstrap/initialise.d.ts +4 -0
  69. package/dist/src/bootstrap/initialise.js +8 -16
  70. package/dist/src/bootstrap/integration-runtime.d.ts +48 -0
  71. package/dist/src/bootstrap/integration-runtime.js +36 -54
  72. package/dist/src/bootstrap/paths.d.ts +12 -0
  73. package/dist/src/bootstrap/persistence-composition.d.ts +21 -0
  74. package/dist/src/bootstrap/persistence-composition.js +12 -4
  75. package/dist/src/bootstrap/projection-runtime.d.ts +16 -0
  76. package/dist/src/bootstrap/projection-runtime.js +50 -23
  77. package/dist/src/bootstrap/resource-transition-evidence.d.ts +11 -0
  78. package/dist/src/bootstrap/runner-quota-reporter.d.ts +6 -0
  79. package/dist/src/bootstrap/runner-quota-reporter.js +16 -11
  80. package/dist/src/bootstrap/runner-registry.d.ts +3 -0
  81. package/dist/src/bootstrap/runner-tick-adapter.d.ts +16 -0
  82. package/dist/src/bootstrap/runner-tick-adapter.js +57 -0
  83. package/dist/src/bootstrap/schedule-checkpoint-store.d.ts +9 -0
  84. package/dist/src/bootstrap/self-update-application.d.ts +54 -0
  85. package/dist/src/bootstrap/self-update-failure-log.d.ts +17 -0
  86. package/dist/src/bootstrap/source-update-port.d.ts +8 -0
  87. package/dist/src/bootstrap/status-publish-activity.d.ts +7 -0
  88. package/dist/src/bootstrap/status-publish-activity.js +4 -5
  89. package/dist/src/bootstrap/surface-api-applications.d.ts +18 -0
  90. package/dist/src/bootstrap/surface-api-applications.js +104 -57
  91. package/dist/src/bootstrap/surface-api-execution-applications.d.ts +3 -0
  92. package/dist/src/bootstrap/surface-api-execution-applications.js +3 -3
  93. package/dist/src/bootstrap/surface-api-metadata.d.ts +4 -0
  94. package/dist/src/bootstrap/surface-api-metadata.js +1 -1
  95. package/dist/src/bootstrap/surface-api-projection-pages.d.ts +12 -0
  96. package/dist/src/bootstrap/surface-api-run-context.d.ts +12 -0
  97. package/dist/src/bootstrap/surface-api-transcripts.d.ts +10 -0
  98. package/dist/src/bootstrap/surface-api-work-applications.d.ts +3 -0
  99. package/dist/src/bootstrap/surface-api-work-applications.js +3 -3
  100. package/dist/src/bootstrap/surface-api-workflow-diagrams.d.ts +11 -0
  101. package/dist/src/bootstrap/surface-api-workflow-diagrams.js +2 -2
  102. package/dist/src/bootstrap/surface-applications.d.ts +10 -0
  103. package/dist/src/bootstrap/surface-cli-applications.d.ts +33 -0
  104. package/dist/src/bootstrap/surface-cli-applications.js +151 -65
  105. package/dist/src/bootstrap/transcript-retention.d.ts +11 -0
  106. package/dist/src/bootstrap/update-ledger.d.ts +9 -0
  107. package/dist/src/bootstrap/update-maintenance-lease.d.ts +24 -0
  108. package/dist/src/bootstrap/update-maintenance-lease.js +1 -1
  109. package/dist/src/bootstrap/version.d.ts +13 -0
  110. package/dist/src/bootstrap/version.js +1 -1
  111. package/dist/src/control-plane/application/activation-scheduler-ports.d.ts +71 -0
  112. package/dist/src/control-plane/application/activation-scheduler-subscriber.d.ts +42 -0
  113. package/dist/src/control-plane/application/activation-scheduler-subscriber.js +111 -0
  114. package/dist/src/control-plane/application/activation-scheduler.d.ts +8 -0
  115. package/dist/src/control-plane/application/activation-scheduler.js +165 -0
  116. package/dist/src/control-plane/application/advance-once-dispatch.d.ts +46 -0
  117. package/dist/src/control-plane/application/advance-once-dispatch.js +6 -7
  118. package/dist/src/control-plane/application/advance-once.d.ts +5 -0
  119. package/dist/src/control-plane/application/advance-once.js +4 -158
  120. package/dist/src/control-plane/application/control-plane-projection.d.ts +21 -0
  121. package/dist/src/control-plane/application/control-plane-projection.js +27 -5
  122. package/dist/src/control-plane/application/control-plane-service.d.ts +12 -0
  123. package/dist/src/control-plane/application/control-plane-service.js +28 -9
  124. package/dist/src/control-plane/application/execution-reconciliation.d.ts +21 -0
  125. package/dist/src/control-plane/application/intake-pipeline.d.ts +18 -0
  126. package/dist/src/control-plane/application/intake-pipeline.js +8 -18
  127. package/dist/src/control-plane/application/runner-control-service.d.ts +12 -0
  128. package/dist/src/control-plane/application/runner-control-service.js +35 -13
  129. package/dist/src/control-plane/application/runner-pipeline.d.ts +24 -0
  130. package/dist/src/control-plane/application/runner-pipeline.js +23 -41
  131. package/dist/src/control-plane/application/schedule-service.d.ts +31 -0
  132. package/dist/src/control-plane/application/schedule-service.js +1 -1
  133. package/dist/src/control-plane/application/work-cancellation-policy.d.ts +20 -0
  134. package/dist/src/control-plane/application/work-cancellation-policy.js +1 -1
  135. package/dist/src/control-plane/contracts/commands.d.ts +20 -0
  136. package/dist/src/control-plane/contracts/config.d.ts +30 -0
  137. package/dist/src/control-plane/contracts/config.js +7 -1
  138. package/dist/src/control-plane/contracts/event-factory.d.ts +6 -0
  139. package/dist/src/control-plane/contracts/event-factory.js +14 -0
  140. package/dist/src/control-plane/contracts/events.d.ts +36 -0
  141. package/dist/src/control-plane/contracts/events.js +42 -47
  142. package/dist/src/control-plane/contracts/streams.d.ts +6 -0
  143. package/dist/src/control-plane/contracts/views.d.ts +28 -0
  144. package/dist/src/control-plane/domain/dispatch-policy.d.ts +18 -0
  145. package/dist/src/control-plane/domain/quota-policy.d.ts +21 -0
  146. package/dist/src/control-plane/domain/runner-quota.d.ts +2 -0
  147. package/dist/src/control-plane/domain/schedule-policy.d.ts +8 -0
  148. package/dist/src/control-plane/index.d.ts +24 -0
  149. package/dist/src/control-plane/index.js +3 -0
  150. package/dist/src/control-plane/infrastructure/intake-host.d.ts +19 -0
  151. package/dist/src/control-plane/infrastructure/intake-host.js +2 -3
  152. package/dist/src/control-plane/infrastructure/resident-host.d.ts +16 -0
  153. package/dist/src/control-plane/infrastructure/resident-host.js +3 -1
  154. package/dist/src/control-plane/infrastructure/tick-host.d.ts +6 -0
  155. package/dist/src/control-plane/infrastructure/tick-host.js +2 -2
  156. package/dist/src/conversations/application/conversation-projection.d.ts +3 -0
  157. package/dist/src/conversations/application/conversation-repository.d.ts +13 -0
  158. package/dist/src/conversations/application/conversation-repository.js +1 -1
  159. package/dist/src/conversations/application/conversation-service.d.ts +16 -0
  160. package/dist/src/conversations/application/conversation-service.js +32 -27
  161. package/dist/src/conversations/contracts/commands.d.ts +33 -0
  162. package/dist/src/conversations/contracts/event-factory.d.ts +6 -0
  163. package/dist/src/conversations/contracts/event-factory.js +18 -0
  164. package/dist/src/conversations/contracts/events.d.ts +42 -0
  165. package/dist/src/conversations/contracts/events.js +37 -24
  166. package/dist/src/conversations/contracts/identifiers.d.ts +5 -0
  167. package/dist/src/conversations/contracts/streams.d.ts +7 -0
  168. package/dist/src/conversations/contracts/views.d.ts +49 -0
  169. package/dist/src/conversations/contracts/vocabulary.d.ts +5 -0
  170. package/dist/src/conversations/domain/conversation.d.ts +4 -0
  171. package/dist/src/conversations/domain/conversation.js +8 -7
  172. package/dist/src/conversations/index.d.ts +9 -0
  173. package/dist/src/conversations/index.js +1 -0
  174. package/dist/src/execution/application/activation-claim.d.ts +23 -0
  175. package/dist/src/execution/application/activation-claim.js +8 -9
  176. package/dist/src/execution/application/active-run-cancellation.d.ts +4 -0
  177. package/dist/src/execution/application/active-run-cancellation.js +2 -2
  178. package/dist/src/execution/application/execution-activity.d.ts +61 -0
  179. package/dist/src/execution/application/execution-activity.js +4 -1
  180. package/dist/src/execution/application/execution-projection.d.ts +11 -0
  181. package/dist/src/execution/application/execution-projection.js +8 -4
  182. package/dist/src/execution/application/execution-service.d.ts +33 -0
  183. package/dist/src/execution/application/execution-service.js +288 -59
  184. package/dist/src/execution/application/execution-validation.d.ts +8 -0
  185. package/dist/src/execution/application/execution-validation.js +3 -2
  186. package/dist/src/execution/application/recovery-service.d.ts +52 -0
  187. package/dist/src/execution/application/recovery-service.js +32 -17
  188. package/dist/src/execution/application/run-lifecycle.d.ts +75 -0
  189. package/dist/src/execution/application/run-lifecycle.js +130 -62
  190. package/dist/src/execution/application/run-liveness-service.d.ts +14 -0
  191. package/dist/src/execution/application/run-liveness-service.js +68 -30
  192. package/dist/src/execution/application/run-repository.d.ts +18 -0
  193. package/dist/src/execution/application/run-repository.js +2 -2
  194. package/dist/src/execution/contracts/commands.d.ts +30 -0
  195. package/dist/src/execution/contracts/config.d.ts +94 -0
  196. package/dist/src/execution/contracts/control-plane.d.ts +10 -0
  197. package/dist/src/execution/contracts/event-factory.d.ts +10 -0
  198. package/dist/src/execution/contracts/event-factory.js +20 -31
  199. package/dist/src/execution/contracts/events.d.ts +198 -0
  200. package/dist/src/execution/contracts/events.js +152 -129
  201. package/dist/src/execution/contracts/identifiers.d.ts +3 -0
  202. package/dist/src/execution/contracts/liveness.d.ts +17 -0
  203. package/dist/src/execution/contracts/results.d.ts +23 -0
  204. package/dist/src/execution/contracts/runner.d.ts +78 -0
  205. package/dist/src/execution/contracts/streams.d.ts +12 -0
  206. package/dist/src/execution/contracts/views.d.ts +42 -0
  207. package/dist/src/execution/contracts/vocabulary.d.ts +50 -0
  208. package/dist/src/execution/contracts/vocabulary.js +4 -0
  209. package/dist/src/execution/contracts/workspace.d.ts +48 -0
  210. package/dist/src/execution/domain/run-result.d.ts +2 -0
  211. package/dist/src/execution/domain/run.d.ts +3 -0
  212. package/dist/src/execution/domain/run.js +72 -22
  213. package/dist/src/execution/index.d.ts +34 -0
  214. package/dist/src/execution/infrastructure/agent-runner-adapter.d.ts +2 -0
  215. package/dist/src/execution/infrastructure/codex-stop-hook.d.ts +13 -0
  216. package/dist/src/execution/infrastructure/process-execution.d.ts +23 -0
  217. package/dist/src/execution/infrastructure/prompt-templates.d.ts +15 -0
  218. package/dist/src/execution/infrastructure/runner-memory-profile.d.ts +11 -0
  219. package/dist/src/execution/infrastructure/runners/claude.d.ts +34 -0
  220. package/dist/src/execution/infrastructure/runners/codex.d.ts +13 -0
  221. package/dist/src/execution/infrastructure/runners/command.d.ts +3 -0
  222. package/dist/src/execution/infrastructure/runners/cursor.d.ts +12 -0
  223. package/dist/src/execution/infrastructure/runners/fake-scenarios.d.ts +35 -0
  224. package/dist/src/execution/infrastructure/runners/fake.d.ts +8 -0
  225. package/dist/src/execution/infrastructure/runners/registry.d.ts +14 -0
  226. package/dist/src/execution/infrastructure/transcript-store.d.ts +48 -0
  227. package/dist/src/execution/infrastructure/transcripts.d.ts +1 -0
  228. package/dist/src/execution/infrastructure/workspace/fake-workspace.d.ts +36 -0
  229. package/dist/src/execution/infrastructure/workspace/fake-workspace.js +2 -0
  230. package/dist/src/execution/infrastructure/workspace/git-workspace.d.ts +29 -0
  231. package/dist/src/execution/infrastructure/workspace/git-workspace.js +21 -11
  232. package/dist/src/execution/infrastructure/workspace/prepare-workspace.d.ts +3 -0
  233. package/dist/src/execution/infrastructure/workspace/prepare-workspace.js +4 -2
  234. package/dist/src/integrations/application/adapter-health-tracker.d.ts +17 -0
  235. package/dist/src/integrations/application/agent-run-publication-reactor.d.ts +25 -0
  236. package/dist/src/integrations/application/agent-run-publication-reactor.js +36 -20
  237. package/dist/src/integrations/application/artifact-registration-reactor.d.ts +32 -0
  238. package/dist/src/integrations/application/artifact-registration-reactor.js +43 -35
  239. package/dist/src/integrations/application/poll-service.d.ts +13 -0
  240. package/dist/src/integrations/application/poll-service.js +2 -2
  241. package/dist/src/integrations/application/terminal-agent-run-report.d.ts +33 -0
  242. package/dist/src/integrations/application/work-admission.d.ts +30 -0
  243. package/dist/src/integrations/application/work-conclusion.d.ts +13 -0
  244. package/dist/src/integrations/contracts/artifact-event-factory.d.ts +6 -0
  245. package/dist/src/integrations/contracts/artifact-event-factory.js +8 -0
  246. package/dist/src/integrations/contracts/artifact-events.d.ts +31 -0
  247. package/dist/src/integrations/contracts/artifact-events.js +24 -24
  248. package/dist/src/integrations/contracts/artifact-vocabulary.d.ts +11 -0
  249. package/dist/src/integrations/contracts/config.d.ts +13 -0
  250. package/dist/src/integrations/contracts/identifiers.d.ts +3 -0
  251. package/dist/src/integrations/contracts/intake-rules.d.ts +15 -0
  252. package/dist/src/integrations/contracts/intake.d.ts +15 -0
  253. package/dist/src/integrations/contracts/outcome-vocabulary.d.ts +6 -0
  254. package/dist/src/integrations/contracts/provider.d.ts +105 -0
  255. package/dist/src/integrations/contracts/reply-routing.d.ts +31 -0
  256. package/dist/src/integrations/contracts/streams.d.ts +12 -0
  257. package/dist/src/integrations/delivery/application/delivery-outcome-reactor.d.ts +24 -0
  258. package/dist/src/integrations/delivery/application/delivery-outcome-reactor.js +151 -73
  259. package/dist/src/integrations/delivery/application/delivery-projector.d.ts +5 -0
  260. package/dist/src/integrations/delivery/application/delivery-projector.js +52 -52
  261. package/dist/src/integrations/delivery/application/delivery-service.d.ts +40 -0
  262. package/dist/src/integrations/delivery/application/delivery-service.js +15 -16
  263. package/dist/src/integrations/delivery/contracts/commands.d.ts +7 -0
  264. package/dist/src/integrations/delivery/contracts/config.d.ts +25 -0
  265. package/dist/src/integrations/delivery/contracts/event-factory.d.ts +11 -0
  266. package/dist/src/integrations/delivery/contracts/event-factory.js +20 -9
  267. package/dist/src/integrations/delivery/contracts/events.d.ts +46 -0
  268. package/dist/src/integrations/delivery/contracts/events.js +33 -18
  269. package/dist/src/integrations/delivery/contracts/intents.d.ts +54 -0
  270. package/dist/src/integrations/delivery/contracts/intents.js +21 -14
  271. package/dist/src/integrations/delivery/contracts/views.d.ts +47 -0
  272. package/dist/src/integrations/delivery/contracts/vocabulary.d.ts +25 -0
  273. package/dist/src/integrations/fake/durable-delivery-provider.d.ts +29 -0
  274. package/dist/src/integrations/fake/external-sink.d.ts +5 -0
  275. package/dist/src/integrations/fake/external-source.d.ts +30 -0
  276. package/dist/src/integrations/fake/external-source.js +1 -3
  277. package/dist/src/integrations/fake/inbound-translator.d.ts +16 -0
  278. package/dist/src/integrations/fake/inbound-translator.js +22 -10
  279. package/dist/src/integrations/fake/provider.d.ts +38 -0
  280. package/dist/src/integrations/fake/provider.js +3 -1
  281. package/dist/src/integrations/github/application/agent-context-reader.d.ts +6 -0
  282. package/dist/src/integrations/github/application/agent-context-reader.js +10 -7
  283. package/dist/src/integrations/github/application/agent-run-comment.d.ts +22 -0
  284. package/dist/src/integrations/github/application/comment-history-reader.d.ts +25 -0
  285. package/dist/src/integrations/github/application/comment-history-reader.js +36 -32
  286. package/dist/src/integrations/github/application/delivery-marker.d.ts +2 -0
  287. package/dist/src/integrations/github/application/inbound-comment-syntax.d.ts +8 -0
  288. package/dist/src/integrations/github/application/inbound-context.d.ts +3 -0
  289. package/dist/src/integrations/github/application/inbound-context.js +4 -4
  290. package/dist/src/integrations/github/application/inbound-review-signals.d.ts +21 -0
  291. package/dist/src/integrations/github/application/inbound-review-signals.js +30 -25
  292. package/dist/src/integrations/github/application/inbound-translator.d.ts +103 -0
  293. package/dist/src/integrations/github/application/inbound-translator.js +149 -160
  294. package/dist/src/integrations/github/application/inbound-watch-gate-signals.d.ts +10 -0
  295. package/dist/src/integrations/github/application/inbound-watch-gate-signals.js +4 -4
  296. package/dist/src/integrations/github/application/intake-policy.d.ts +7 -0
  297. package/dist/src/integrations/github/application/operator-retry-command.d.ts +1 -0
  298. package/dist/src/integrations/github/application/outbound-translator.d.ts +19 -0
  299. package/dist/src/integrations/github/application/poll-service.d.ts +11 -0
  300. package/dist/src/integrations/github/application/poll-service.js +11 -2
  301. package/dist/src/integrations/github/application/pull-request-translation.d.ts +5 -0
  302. package/dist/src/integrations/github/application/reply-target-selector.d.ts +8 -0
  303. package/dist/src/integrations/github/application/resource-links.d.ts +2 -0
  304. package/dist/src/integrations/github/application/review-command-translator.d.ts +14 -0
  305. package/dist/src/integrations/github/application/wake-labels.d.ts +29 -0
  306. package/dist/src/integrations/github/contracts/check-evidence.d.ts +1 -0
  307. package/dist/src/integrations/github/contracts/config.d.ts +81 -0
  308. package/dist/src/integrations/github/contracts/event-factory.d.ts +6 -0
  309. package/dist/src/integrations/github/contracts/event-factory.js +26 -0
  310. package/dist/src/integrations/github/contracts/events.d.ts +135 -0
  311. package/dist/src/integrations/github/contracts/events.js +118 -132
  312. package/dist/src/integrations/github/contracts/external-key.d.ts +8 -0
  313. package/dist/src/integrations/github/contracts/issue-query.d.ts +5 -0
  314. package/dist/src/integrations/github/contracts/payloads.d.ts +74 -0
  315. package/dist/src/integrations/github/contracts/vocabulary.d.ts +64 -0
  316. package/dist/src/integrations/github/index.d.ts +34 -0
  317. package/dist/src/integrations/github/index.js +1 -0
  318. package/dist/src/integrations/github/infrastructure/adapter-health-registry.d.ts +11 -0
  319. package/dist/src/integrations/github/infrastructure/bounded-fetch.d.ts +10 -0
  320. package/dist/src/integrations/github/infrastructure/client-reads.d.ts +255 -0
  321. package/dist/src/integrations/github/infrastructure/client.d.ts +263 -0
  322. package/dist/src/integrations/github/infrastructure/comment-source.d.ts +7 -0
  323. package/dist/src/integrations/github/infrastructure/content-fingerprint.d.ts +2 -0
  324. package/dist/src/integrations/github/infrastructure/delivery.d.ts +6 -0
  325. package/dist/src/integrations/github/infrastructure/etag-cache.d.ts +29 -0
  326. package/dist/src/integrations/github/infrastructure/gh-auth.d.ts +4 -0
  327. package/dist/src/integrations/github/infrastructure/issue-source.d.ts +20 -0
  328. package/dist/src/integrations/github/infrastructure/issue-source.js +10 -6
  329. package/dist/src/integrations/github/infrastructure/poll-watermark.d.ts +12 -0
  330. package/dist/src/integrations/github/infrastructure/pr-source.d.ts +16 -0
  331. package/dist/src/integrations/github/infrastructure/pr-source.js +6 -4
  332. package/dist/src/integrations/github/infrastructure/request-coordinator.d.ts +13 -0
  333. package/dist/src/integrations/github/infrastructure/review-source.d.ts +10 -0
  334. package/dist/src/integrations/github/infrastructure/review-source.js +29 -25
  335. package/dist/src/integrations/github/infrastructure/source-contracts.d.ts +22 -0
  336. package/dist/src/integrations/github/infrastructure/source.d.ts +12 -0
  337. package/dist/src/integrations/github/infrastructure/source.js +3 -5
  338. package/dist/src/integrations/github/provider.d.ts +3 -0
  339. package/dist/src/integrations/github/provider.js +14 -12
  340. package/dist/src/integrations/index.d.ts +32 -0
  341. package/dist/src/integrations/index.js +1 -0
  342. package/dist/src/kernel/contracts/clock.d.ts +3 -0
  343. package/dist/src/kernel/contracts/id-generator.d.ts +3 -0
  344. package/dist/src/kernel/contracts/identifiers.d.ts +7 -0
  345. package/dist/src/kernel/contracts/identifiers.js +1 -8
  346. package/dist/src/kernel/contracts/relations.d.ts +14 -0
  347. package/dist/src/kernel/contracts/schema.d.ts +3 -0
  348. package/dist/src/kernel/contracts/vocabulary.d.ts +7 -0
  349. package/dist/src/kernel/domain/match-mode.d.ts +2 -0
  350. package/dist/src/kernel/domain/relation.d.ts +9 -0
  351. package/dist/src/kernel/index.d.ts +10 -0
  352. package/dist/src/kernel/index.js +0 -11
  353. package/dist/src/kernel/infrastructure/system-clock.d.ts +4 -0
  354. package/dist/src/kernel/infrastructure/ulid-id-generator.d.ts +4 -0
  355. package/dist/src/main.d.ts +14 -0
  356. package/dist/src/node_modules/@atolis-hq/eventing/LICENSE +201 -0
  357. package/dist/src/node_modules/@atolis-hq/eventing/README.md +41 -0
  358. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/commands.d.ts +9 -0
  359. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/commands.d.ts.map +1 -0
  360. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/event-envelope.d.ts +13 -0
  361. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/event-envelope.d.ts.map +1 -0
  362. package/dist/src/{kernel/domain → node_modules/@atolis-hq/eventing/dist/contracts}/event-envelope.js +4 -4
  363. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/event-schema.d.ts +83 -0
  364. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/event-schema.d.ts.map +1 -0
  365. package/dist/src/{kernel → node_modules/@atolis-hq/eventing/dist}/contracts/event-schema.js +21 -5
  366. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/events.d.ts +46 -0
  367. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/events.d.ts.map +1 -0
  368. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/events.js +10 -0
  369. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/identifiers.d.ts +11 -0
  370. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/identifiers.d.ts.map +1 -0
  371. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/identifiers.js +8 -0
  372. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/processor-state-store.d.ts +11 -0
  373. package/dist/src/node_modules/@atolis-hq/eventing/dist/contracts/processor-state-store.d.ts.map +1 -0
  374. package/dist/src/node_modules/@atolis-hq/eventing/dist/index.d.ts +19 -0
  375. package/dist/src/node_modules/@atolis-hq/eventing/dist/index.d.ts.map +1 -0
  376. package/dist/src/node_modules/@atolis-hq/eventing/dist/index.js +17 -0
  377. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-checkpoint-store.d.ts +8 -0
  378. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-checkpoint-store.d.ts.map +1 -0
  379. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-event-journal.d.ts +19 -0
  380. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-event-journal.d.ts.map +1 -0
  381. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-event-journal.js +82 -0
  382. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-processor-run-serialiser.d.ts +6 -0
  383. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-processor-run-serialiser.d.ts.map +1 -0
  384. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-processor-run-serialiser.js +26 -0
  385. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-processor-state-store.d.ts +8 -0
  386. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-processor-state-store.d.ts.map +1 -0
  387. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-processor-state-store.js +20 -0
  388. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-projection-store.d.ts +9 -0
  389. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-memory-projection-store.d.ts.map +1 -0
  390. package/dist/src/{persistence → node_modules/@atolis-hq/eventing/dist}/memory/in-memory-projection-store.js +2 -1
  391. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-process-journal-change-signal.d.ts +10 -0
  392. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory/in-process-journal-change-signal.d.ts.map +1 -0
  393. package/dist/src/{kernel/infrastructure/journal-change-signal.js → node_modules/@atolis-hq/eventing/dist/memory/in-process-journal-change-signal.js} +5 -2
  394. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory.d.ts +7 -0
  395. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory.d.ts.map +1 -0
  396. package/dist/src/node_modules/@atolis-hq/eventing/dist/memory.js +6 -0
  397. package/dist/src/node_modules/@atolis-hq/eventing/dist/projections/projection-processor.d.ts +20 -0
  398. package/dist/src/node_modules/@atolis-hq/eventing/dist/projections/projection-processor.d.ts.map +1 -0
  399. package/dist/src/node_modules/@atolis-hq/eventing/dist/projections/projection-processor.js +83 -0
  400. package/dist/src/node_modules/@atolis-hq/eventing/dist/projections/projection-store.d.ts +22 -0
  401. package/dist/src/node_modules/@atolis-hq/eventing/dist/projections/projection-store.d.ts.map +1 -0
  402. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/cached-journal-view.d.ts +8 -0
  403. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/cached-journal-view.d.ts.map +1 -0
  404. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/cached-journal-view.js +24 -0
  405. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/clock.d.ts +4 -0
  406. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/clock.d.ts.map +1 -0
  407. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/event-processor-host.d.ts +39 -0
  408. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/event-processor-host.d.ts.map +1 -0
  409. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/event-processor-host.js +168 -0
  410. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/processor-health.d.ts +43 -0
  411. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/processor-health.d.ts.map +1 -0
  412. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/processor-health.js +66 -0
  413. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/processor-run-serialiser.d.ts +2 -0
  414. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/processor-run-serialiser.d.ts.map +1 -0
  415. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/processor-run-serialiser.js +1 -0
  416. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/processor-validation.d.ts +7 -0
  417. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/processor-validation.d.ts.map +1 -0
  418. package/dist/src/node_modules/@atolis-hq/eventing/dist/runtime/processor-validation.js +43 -0
  419. package/dist/src/node_modules/@atolis-hq/eventing/dist/store/checkpoint-store.d.ts +6 -0
  420. package/dist/src/node_modules/@atolis-hq/eventing/dist/store/checkpoint-store.d.ts.map +1 -0
  421. package/dist/src/node_modules/@atolis-hq/eventing/dist/store/checkpoint-store.js +1 -0
  422. package/dist/src/node_modules/@atolis-hq/eventing/dist/store/event-journal.d.ts +14 -0
  423. package/dist/src/node_modules/@atolis-hq/eventing/dist/store/event-journal.d.ts.map +1 -0
  424. package/dist/src/node_modules/@atolis-hq/eventing/dist/subscriptions/event-processor.d.ts +49 -0
  425. package/dist/src/node_modules/@atolis-hq/eventing/dist/subscriptions/event-processor.d.ts.map +1 -0
  426. package/dist/src/node_modules/@atolis-hq/eventing/dist/subscriptions/event-processor.js +17 -0
  427. package/dist/src/node_modules/@atolis-hq/eventing/dist/subscriptions/journal-change-signal.d.ts +6 -0
  428. package/dist/src/node_modules/@atolis-hq/eventing/dist/subscriptions/journal-change-signal.d.ts.map +1 -0
  429. package/dist/src/node_modules/@atolis-hq/eventing/dist/subscriptions/journal-change-signal.js +1 -0
  430. package/dist/src/node_modules/@atolis-hq/eventing/package.json +42 -0
  431. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/LICENSE +201 -0
  432. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/README.md +40 -0
  433. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/atomic-write.d.ts +23 -0
  434. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/atomic-write.d.ts.map +1 -0
  435. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/atomic-write.js +54 -0
  436. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/event-record-codec.d.ts +4 -0
  437. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/event-record-codec.d.ts.map +1 -0
  438. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/event-record-codec.js +50 -0
  439. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-checkpoint-store.d.ts +17 -0
  440. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-checkpoint-store.d.ts.map +1 -0
  441. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-checkpoint-store.js +99 -0
  442. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-event-journal.d.ts +51 -0
  443. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-event-journal.d.ts.map +1 -0
  444. package/dist/src/{persistence/filesystem → node_modules/@atolis-hq/eventing-filesystem/dist}/file-event-journal.js +185 -103
  445. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-lock.d.ts +34 -0
  446. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-lock.d.ts.map +1 -0
  447. package/dist/src/{persistence/filesystem → node_modules/@atolis-hq/eventing-filesystem/dist}/file-lock.js +10 -1
  448. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-processor-run-serialiser.d.ts +9 -0
  449. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-processor-run-serialiser.d.ts.map +1 -0
  450. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-processor-run-serialiser.js +82 -0
  451. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-processor-state-store.d.ts +12 -0
  452. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-processor-state-store.d.ts.map +1 -0
  453. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-processor-state-store.js +127 -0
  454. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-projection-store.d.ts +19 -0
  455. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-projection-store.d.ts.map +1 -0
  456. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/file-projection-store.js +219 -0
  457. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/index.d.ts +7 -0
  458. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/index.d.ts.map +1 -0
  459. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/index.js +6 -0
  460. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/processor-state-paths.d.ts +10 -0
  461. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/processor-state-paths.d.ts.map +1 -0
  462. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/processor-state-paths.js +27 -0
  463. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/processor-state-record.d.ts +8 -0
  464. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/processor-state-record.d.ts.map +1 -0
  465. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/processor-state-record.js +28 -0
  466. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/storage-name.d.ts +6 -0
  467. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/storage-name.d.ts.map +1 -0
  468. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/dist/storage-name.js +34 -0
  469. package/dist/src/node_modules/@atolis-hq/eventing-filesystem/package.json +38 -0
  470. package/dist/src/orchestration/application/accept-activity-outcome.d.ts +18 -0
  471. package/dist/src/orchestration/application/accept-signal.d.ts +14 -0
  472. package/dist/src/orchestration/application/advance-workflow.d.ts +50 -0
  473. package/dist/src/orchestration/application/advance-workflow.js +7 -12
  474. package/dist/src/orchestration/application/coordination-claims.d.ts +17 -0
  475. package/dist/src/orchestration/application/coordination-claims.js +17 -20
  476. package/dist/src/orchestration/application/durable-append.d.ts +17 -0
  477. package/dist/src/orchestration/application/durable-append.js +1 -1
  478. package/dist/src/orchestration/application/group-budget-recorder.d.ts +9 -0
  479. package/dist/src/orchestration/application/group-budget-recorder.js +9 -6
  480. package/dist/src/orchestration/application/orchestration-projection.d.ts +6 -0
  481. package/dist/src/orchestration/application/orchestration-projection.js +6 -7
  482. package/dist/src/orchestration/application/orchestration-repository.d.ts +23 -0
  483. package/dist/src/orchestration/application/orchestration-repository.js +2 -2
  484. package/dist/src/orchestration/application/orchestration-service.d.ts +93 -0
  485. package/dist/src/orchestration/application/orchestration-service.js +10 -1
  486. package/dist/src/orchestration/application/pull-request-transition-evidence.d.ts +3 -0
  487. package/dist/src/orchestration/application/pull-request-transition-evidence.js +10 -10
  488. package/dist/src/orchestration/application/reactor-command-context.d.ts +5 -0
  489. package/dist/src/orchestration/application/reactor-command-context.js +9 -0
  490. package/dist/src/orchestration/application/request-child.d.ts +29 -0
  491. package/dist/src/orchestration/application/request-child.js +26 -10
  492. package/dist/src/orchestration/application/resource-transition-evidence.d.ts +18 -0
  493. package/dist/src/orchestration/application/resource-transition-matching.d.ts +19 -0
  494. package/dist/src/orchestration/application/resource-transition-matching.js +9 -3
  495. package/dist/src/orchestration/application/resource-transition-reactor.d.ts +16 -0
  496. package/dist/src/orchestration/application/resource-transition-reactor.js +21 -42
  497. package/dist/src/orchestration/application/signal-reactor.d.ts +11 -0
  498. package/dist/src/orchestration/application/start-workflow.d.ts +18 -0
  499. package/dist/src/orchestration/application/start-workflow.js +3 -4
  500. package/dist/src/orchestration/application/trigger-workflow-instance.d.ts +12 -0
  501. package/dist/src/orchestration/application/trigger-workflow-instance.js +1 -1
  502. package/dist/src/orchestration/application/watch-child-transitions.d.ts +2 -0
  503. package/dist/src/orchestration/application/watch-matching.d.ts +13 -0
  504. package/dist/src/orchestration/application/watch-matching.js +3 -3
  505. package/dist/src/orchestration/application/watch-reactor.d.ts +42 -0
  506. package/dist/src/orchestration/application/watch-reactor.js +36 -35
  507. package/dist/src/orchestration/application/workflow-definition-registry.d.ts +32 -0
  508. package/dist/src/orchestration/application/workflow-definition-registry.js +13 -11
  509. package/dist/src/orchestration/contracts/activity-outcome.d.ts +15 -0
  510. package/dist/src/orchestration/contracts/commands.d.ts +30 -0
  511. package/dist/src/orchestration/contracts/config.d.ts +356 -0
  512. package/dist/src/orchestration/contracts/event-decoder.d.ts +262 -0
  513. package/dist/src/orchestration/contracts/event-decoder.js +88 -64
  514. package/dist/src/orchestration/contracts/event-factory.d.ts +6 -0
  515. package/dist/src/orchestration/contracts/event-factory.js +64 -0
  516. package/dist/src/orchestration/contracts/events.d.ts +233 -0
  517. package/dist/src/orchestration/contracts/identifiers.d.ts +15 -0
  518. package/dist/src/orchestration/contracts/streams.d.ts +28 -0
  519. package/dist/src/orchestration/contracts/views.d.ts +68 -0
  520. package/dist/src/orchestration/contracts/vocabulary.d.ts +34 -0
  521. package/dist/src/orchestration/domain/activation-policy.d.ts +60 -0
  522. package/dist/src/orchestration/domain/activation-policy.js +34 -19
  523. package/dist/src/orchestration/domain/approval-defaults.d.ts +8 -0
  524. package/dist/src/orchestration/domain/child-policy.d.ts +20 -0
  525. package/dist/src/orchestration/domain/compiler.d.ts +3 -0
  526. package/dist/src/orchestration/domain/coordination-events.d.ts +18 -0
  527. package/dist/src/orchestration/domain/coordination-events.js +25 -11
  528. package/dist/src/orchestration/domain/decision-events.d.ts +33 -0
  529. package/dist/src/orchestration/domain/decision-events.js +26 -15
  530. package/dist/src/orchestration/domain/interpreter.d.ts +14 -0
  531. package/dist/src/orchestration/domain/interpreter.js +4 -1
  532. package/dist/src/orchestration/domain/operator-retry-policy.d.ts +14 -0
  533. package/dist/src/orchestration/domain/operator-retry-policy.js +29 -11
  534. package/dist/src/orchestration/domain/resource-transition-compiler.d.ts +8 -0
  535. package/dist/src/orchestration/domain/retry-policy.d.ts +7 -0
  536. package/dist/src/orchestration/domain/retry-policy.js +7 -4
  537. package/dist/src/orchestration/domain/runner-quota-retry-policy.d.ts +10 -0
  538. package/dist/src/orchestration/domain/runner-quota-retry-policy.js +21 -15
  539. package/dist/src/orchestration/domain/signal-policy.d.ts +11 -0
  540. package/dist/src/orchestration/domain/signal-policy.js +18 -7
  541. package/dist/src/orchestration/domain/supplemental-policy.d.ts +11 -0
  542. package/dist/src/orchestration/domain/supplemental-policy.js +29 -14
  543. package/dist/src/orchestration/domain/transition.d.ts +16 -0
  544. package/dist/src/orchestration/domain/transition.js +46 -28
  545. package/dist/src/orchestration/domain/workflow-graph.d.ts +4 -0
  546. package/dist/src/orchestration/domain/workflow-instance-events.d.ts +44 -0
  547. package/dist/src/orchestration/domain/workflow-instance.d.ts +7 -0
  548. package/dist/src/orchestration/domain/workflow-instance.js +29 -9
  549. package/dist/src/orchestration/domain/workflow-selector.d.ts +15 -0
  550. package/dist/src/orchestration/index.d.ts +27 -0
  551. package/dist/src/orchestration/index.js +1 -0
  552. package/dist/src/resources/application/lookup-projections.d.ts +6 -0
  553. package/dist/src/resources/application/lookup-projections.js +15 -15
  554. package/dist/src/resources/application/resource-correlation-retry.d.ts +16 -0
  555. package/dist/src/resources/application/resource-correlation-retry.js +39 -44
  556. package/dist/src/resources/application/resource-event-support.d.ts +12 -0
  557. package/dist/src/resources/application/resource-event-support.js +17 -0
  558. package/dist/src/resources/application/resource-lookup.d.ts +17 -0
  559. package/dist/src/resources/application/resource-lookup.js +9 -9
  560. package/dist/src/resources/application/resource-projections.d.ts +4 -0
  561. package/dist/src/resources/application/resource-projections.js +32 -24
  562. package/dist/src/resources/application/resource-repository.d.ts +16 -0
  563. package/dist/src/resources/application/resource-repository.js +3 -3
  564. package/dist/src/resources/application/resource-service.d.ts +34 -0
  565. package/dist/src/resources/application/resource-service.js +73 -52
  566. package/dist/src/resources/contracts/commands.d.ts +23 -0
  567. package/dist/src/resources/contracts/config.d.ts +3 -0
  568. package/dist/src/resources/contracts/event-factory.d.ts +6 -0
  569. package/dist/src/resources/contracts/event-factory.js +32 -0
  570. package/dist/src/resources/contracts/events.d.ts +79 -0
  571. package/dist/src/resources/contracts/events.js +94 -102
  572. package/dist/src/resources/contracts/identifiers.d.ts +7 -0
  573. package/dist/src/resources/contracts/streams.d.ts +8 -0
  574. package/dist/src/resources/contracts/views.d.ts +35 -0
  575. package/dist/src/resources/contracts/vocabulary.d.ts +50 -0
  576. package/dist/src/resources/domain/correlation.d.ts +6 -0
  577. package/dist/src/resources/domain/resource.d.ts +8 -0
  578. package/dist/src/resources/domain/resource.js +24 -21
  579. package/dist/src/resources/index.d.ts +15 -0
  580. package/dist/src/resources/index.js +1 -0
  581. package/dist/src/surfaces/api/contracts/activities.d.ts +1 -0
  582. package/dist/src/surfaces/api/contracts/board.d.ts +46 -0
  583. package/dist/src/surfaces/api/contracts/board.js +1 -1
  584. package/dist/src/surfaces/api/contracts/common.d.ts +43 -0
  585. package/dist/src/surfaces/api/contracts/control-plane.d.ts +37 -0
  586. package/dist/src/surfaces/api/contracts/events.d.ts +13 -0
  587. package/dist/src/surfaces/api/contracts/execution.d.ts +67 -0
  588. package/dist/src/surfaces/api/contracts/index.d.ts +14 -0
  589. package/dist/src/surfaces/api/contracts/observability.d.ts +10 -0
  590. package/dist/src/surfaces/api/contracts/orchestration.d.ts +16 -0
  591. package/dist/src/surfaces/api/contracts/resources.d.ts +10 -0
  592. package/dist/src/surfaces/api/contracts/status.d.ts +4 -0
  593. package/dist/src/surfaces/api/contracts/system.d.ts +32 -0
  594. package/dist/src/surfaces/api/contracts/transport-values.d.ts +50 -0
  595. package/dist/src/surfaces/api/contracts/transport-values.js +6 -0
  596. package/dist/src/surfaces/api/contracts/work.d.ts +74 -0
  597. package/dist/src/surfaces/api/contracts/workflow-diagram.d.ts +64 -0
  598. package/dist/src/surfaces/api/http-server.d.ts +33 -0
  599. package/dist/src/surfaces/api/http-server.js +2 -2
  600. package/dist/src/surfaces/api/presenters/activities.d.ts +1 -0
  601. package/dist/src/surfaces/api/presenters/board.d.ts +2 -0
  602. package/dist/src/surfaces/api/presenters/control-plane.d.ts +1 -0
  603. package/dist/src/surfaces/api/presenters/events.d.ts +1 -0
  604. package/dist/src/surfaces/api/presenters/execution.d.ts +3 -0
  605. package/dist/src/surfaces/api/presenters/execution.js +5 -2
  606. package/dist/src/surfaces/api/presenters/observability.d.ts +1 -0
  607. package/dist/src/surfaces/api/presenters/orchestration.d.ts +3 -0
  608. package/dist/src/surfaces/api/presenters/resources.d.ts +3 -0
  609. package/dist/src/surfaces/api/presenters/status.d.ts +2 -0
  610. package/dist/src/surfaces/api/presenters/system.d.ts +2 -0
  611. package/dist/src/surfaces/api/presenters/work.d.ts +4 -0
  612. package/dist/src/surfaces/api/problem-details.d.ts +2 -0
  613. package/dist/src/surfaces/api/router.d.ts +8 -0
  614. package/dist/src/surfaces/api/routes/activities.d.ts +1 -0
  615. package/dist/src/surfaces/api/routes/applications.d.ts +88 -0
  616. package/dist/src/surfaces/api/routes/commands.d.ts +3 -0
  617. package/dist/src/surfaces/api/routes/commands.js +1 -3
  618. package/dist/src/surfaces/api/routes/control-plane.d.ts +1 -0
  619. package/dist/src/surfaces/api/routes/control-plane.js +0 -1
  620. package/dist/src/surfaces/api/routes/events.d.ts +1 -0
  621. package/dist/src/surfaces/api/routes/execution.d.ts +1 -0
  622. package/dist/src/surfaces/api/routes/index.d.ts +4 -0
  623. package/dist/src/surfaces/api/routes/observability.d.ts +1 -0
  624. package/dist/src/surfaces/api/routes/orchestration.d.ts +1 -0
  625. package/dist/src/surfaces/api/routes/pagination.d.ts +5 -0
  626. package/dist/src/surfaces/api/routes/read.d.ts +3 -0
  627. package/dist/src/surfaces/api/routes/resources.d.ts +1 -0
  628. package/dist/src/surfaces/api/routes/responses.d.ts +15 -0
  629. package/dist/src/surfaces/api/routes/system.d.ts +1 -0
  630. package/dist/src/surfaces/api/routes/work.d.ts +1 -0
  631. package/dist/src/surfaces/auth/credentials.d.ts +22 -0
  632. package/dist/src/surfaces/auth/credentials.js +8 -12
  633. package/dist/src/surfaces/auth/vocabulary.d.ts +9 -0
  634. package/dist/src/surfaces/cli/commands/api.d.ts +4 -0
  635. package/dist/src/surfaces/cli/commands/audit.d.ts +16 -0
  636. package/dist/src/surfaces/cli/commands/audit.js +11 -2
  637. package/dist/src/surfaces/cli/commands/correlate.d.ts +7 -0
  638. package/dist/src/surfaces/cli/commands/doctor.d.ts +24 -0
  639. package/dist/src/surfaces/cli/commands/init.d.ts +2 -0
  640. package/dist/src/surfaces/cli/commands/sandbox-entrypoint.d.ts +43 -0
  641. package/dist/src/surfaces/cli/commands/sandbox-setup.d.ts +9 -0
  642. package/dist/src/surfaces/cli/commands/sandbox.d.ts +16 -0
  643. package/dist/src/surfaces/cli/commands/self-update.d.ts +15 -0
  644. package/dist/src/surfaces/cli/commands/smoke.d.ts +14 -0
  645. package/dist/src/surfaces/cli/commands/start.d.ts +5 -0
  646. package/dist/src/surfaces/cli/commands/stop.d.ts +11 -0
  647. package/dist/src/surfaces/cli/commands/tick.d.ts +5 -0
  648. package/dist/src/surfaces/cli/commands/ui.d.ts +5 -0
  649. package/dist/src/surfaces/cli/commands/validate-state.d.ts +13 -0
  650. package/dist/src/surfaces/cli/infrastructure/docker-cli.d.ts +66 -0
  651. package/dist/src/surfaces/cli/infrastructure/docker-invocation.d.ts +14 -0
  652. package/dist/src/surfaces/cli/infrastructure/process-log.d.ts +35 -0
  653. package/dist/src/surfaces/cli/infrastructure/resident-start.d.ts +10 -0
  654. package/dist/src/surfaces/cli/main.d.ts +115 -0
  655. package/dist/src/surfaces/cli/usage.d.ts +1 -0
  656. package/dist/src/surfaces/contracts/config.d.ts +51 -0
  657. package/dist/src/surfaces/index.d.ts +49 -0
  658. package/dist/src/surfaces/web-assets/assets/index-D9xGa5tD.css +1 -0
  659. package/dist/src/surfaces/web-assets/assets/index-qai1Ymhv.js +1179 -0
  660. package/dist/src/surfaces/web-assets/index.html +2 -2
  661. package/dist/src/surfaces/web-host/asset-source.d.ts +9 -0
  662. package/dist/src/surfaces/web-host/packaged-assets.d.ts +8 -0
  663. package/dist/src/work/application/work-projection.d.ts +3 -0
  664. package/dist/src/work/application/work-projection.js +4 -4
  665. package/dist/src/work/application/work-repository.d.ts +15 -0
  666. package/dist/src/work/application/work-repository.js +2 -2
  667. package/dist/src/work/application/work-service.d.ts +18 -0
  668. package/dist/src/work/application/work-service.js +70 -31
  669. package/dist/src/work/contracts/commands.d.ts +15 -0
  670. package/dist/src/work/contracts/config.d.ts +3 -0
  671. package/dist/src/work/contracts/event-factory.d.ts +6 -0
  672. package/dist/src/work/contracts/event-factory.js +26 -0
  673. package/dist/src/work/contracts/events.d.ts +46 -0
  674. package/dist/src/work/contracts/events.js +54 -60
  675. package/dist/src/work/contracts/identifiers.d.ts +3 -0
  676. package/dist/src/work/contracts/streams.d.ts +8 -0
  677. package/dist/src/work/contracts/views.d.ts +18 -0
  678. package/dist/src/work/contracts/vocabulary.d.ts +7 -0
  679. package/dist/src/work/domain/work-item.d.ts +3 -0
  680. package/dist/src/work/domain/work-item.js +10 -7
  681. package/dist/src/work/index.d.ts +12 -0
  682. package/dist/src/work/index.js +1 -0
  683. package/docker/Dockerfile +9 -7
  684. package/docker/Dockerfile.packaged +4 -6
  685. package/package.json +24 -24
  686. package/dist/src/activities/pr/event-drafts.js +0 -66
  687. package/dist/src/kernel/contracts/events.js +0 -11
  688. package/dist/src/kernel/infrastructure/cached-journal-view.js +0 -27
  689. package/dist/src/persistence/application/projection-runner.js +0 -128
  690. package/dist/src/persistence/filesystem/file-checkpoint-store.js +0 -50
  691. package/dist/src/persistence/filesystem/file-projection-store.js +0 -137
  692. package/dist/src/persistence/index.js +0 -8
  693. package/dist/src/persistence/memory/in-memory-event-journal.js +0 -99
  694. package/dist/src/surfaces/web-assets/assets/index-B0ofn_L5.css +0 -1
  695. package/dist/src/surfaces/web-assets/assets/index-DFBhpSSX.js +0 -1179
  696. /package/dist/src/control-plane/application/{advance-once-ports.js → activation-scheduler-ports.js} +0 -0
  697. /package/dist/src/{kernel → node_modules/@atolis-hq/eventing/dist}/contracts/commands.js +0 -0
  698. /package/dist/src/{kernel/contracts/checkpoint-store.js → node_modules/@atolis-hq/eventing/dist/contracts/processor-state-store.js} +0 -0
  699. /package/dist/src/{persistence → node_modules/@atolis-hq/eventing/dist}/memory/in-memory-checkpoint-store.js +0 -0
  700. /package/dist/src/{kernel/contracts → node_modules/@atolis-hq/eventing/dist/projections}/projection-store.js +0 -0
  701. /package/dist/src/{kernel/contracts/journal-change-signal.js → node_modules/@atolis-hq/eventing/dist/runtime/clock.js} +0 -0
  702. /package/dist/src/{kernel/contracts → node_modules/@atolis-hq/eventing/dist/store}/event-journal.js +0 -0
@@ -2,29 +2,85 @@
2
2
  import { ActivityExecutionKind, } from '../../activities/index.js';
3
3
  import { runId } from '../contracts/identifiers.js';
4
4
  import { ExecutionStreamKind } from '../contracts/streams.js';
5
- import { RunStatus, WorkspaceMode } from '../contracts/vocabulary.js';
5
+ import { ExecutionCancellationReason, isActiveRunStatus, RunStatus, WorkspaceMode, } from '../contracts/vocabulary.js';
6
6
  import { claimActivation, releaseActivation } from './activation-claim.js';
7
7
  import { cancelActiveRuns } from './active-run-cancellation.js';
8
8
  import { executeActivity, } from './execution-activity.js';
9
9
  import { acquireWorkspace, validateResourceRequirements } from './execution-validation.js';
10
- import { recordRunFailure, recordRunSuccess, recordWorkspaceCleanupFailure, startRun, } from './run-lifecycle.js';
10
+ import { prepareRun, recordRunFailure, recordRunSuccess, recordWorkspaceCleanupFailure, startRun, } from './run-lifecycle.js';
11
11
  import { claimRun, confirmCancellation, renewLease, requestCancellation, } from './run-liveness-service.js';
12
12
  import { RunRepository } from './run-repository.js';
13
13
  export function createExecutionService(journal, activities, config, dependencies) {
14
14
  const repository = new RunRepository(journal);
15
15
  const active = new Map();
16
+ const localAttempts = new Set();
17
+ const lifecycle = {
18
+ closed: false,
19
+ shutdown: undefined,
20
+ attempts: new Set(),
21
+ cancellations: new Map(),
22
+ workers: new Map(),
23
+ };
24
+ const runtime = {
25
+ activities,
26
+ config,
27
+ dependencies,
28
+ repository,
29
+ active,
30
+ localAttempts,
31
+ lifecycle,
32
+ journal,
33
+ };
16
34
  return {
17
- attempt: (activation, context) => attemptExecution({ activities, config, dependencies, repository, active, journal }, activation, context),
35
+ attempt: (activation, context) => startAttempt(runtime, activation, context),
18
36
  list: (activationId) => repository.list(activationId),
19
- isLocallyActive: (id) => active.has(runId(id)),
37
+ isLocallyActive: (id) => localAttempts.has(runId(id)),
20
38
  claim: (id, owner) => claimRun(repository, dependencies.clock, config, runId(id), owner),
21
39
  renewLease: (id, owner) => renewLease(repository, dependencies.clock, config, runId(id), owner),
22
40
  requestCancellation: (id, reason) => requestCancellation(repository, dependencies.clock, runId(id), reason, active),
23
41
  confirmCancellation: (id) => confirmCancellation(repository, dependencies.clock, runId(id)),
24
42
  cancelActive: (workflowInstanceIds, reason) => cancelActiveRuns(repository, dependencies.clock, workflowInstanceIds, reason, active),
43
+ shutdown: () => (lifecycle.shutdown ??= shutdownExecution(runtime)),
25
44
  };
26
45
  }
27
- // Starts the durable Run and hands agent invocation ownership to the detached worker.
46
+ function startAttempt(runtime, activation, context) {
47
+ if (runtime.lifecycle.closed)
48
+ return Promise.reject(new Error('Execution service is shut down'));
49
+ const attempt = attemptExecution(runtime, activation, context);
50
+ runtime.lifecycle.attempts.add(attempt);
51
+ void attempt.finally(() => runtime.lifecycle.attempts.delete(attempt)).catch(() => undefined);
52
+ return attempt;
53
+ }
54
+ async function shutdownExecution(runtime) {
55
+ runtime.lifecycle.closed = true;
56
+ while (runtime.lifecycle.attempts.size > 0 ||
57
+ runtime.lifecycle.cancellations.size > 0 ||
58
+ runtime.lifecycle.workers.size > 0) {
59
+ const attempts = [...runtime.lifecycle.attempts];
60
+ const pendingCancellations = [...runtime.lifecycle.cancellations.values()];
61
+ const workers = [...runtime.lifecycle.workers.values()];
62
+ const controllers = [...runtime.active.entries()];
63
+ const cancellations = controllers.map(([currentRunId]) => beginShutdownCancellation(runtime, runId(currentRunId)));
64
+ for (const [, controller] of controllers)
65
+ if (!controller.signal.aborted)
66
+ controller.abort(ExecutionCancellationReason.Shutdown);
67
+ await Promise.allSettled([
68
+ ...attempts,
69
+ ...workers.map(({ completion }) => completion),
70
+ ...pendingCancellations,
71
+ ...cancellations,
72
+ ]);
73
+ }
74
+ }
75
+ function beginShutdownCancellation(runtime, currentRunId) {
76
+ const existing = runtime.lifecycle.cancellations.get(currentRunId);
77
+ if (existing !== undefined)
78
+ return existing;
79
+ const pending = requestCancellation(runtime.repository, runtime.dependencies.clock, currentRunId, ExecutionCancellationReason.Shutdown, runtime.active).then(() => true, () => false);
80
+ runtime.lifecycle.cancellations.set(currentRunId, pending);
81
+ return pending;
82
+ }
83
+ // Prepares the durable Run before workspace acquisition, then hands invocation to the detached worker.
28
84
  // eslint-disable-next-line max-lines-per-function
29
85
  async function attemptExecution(runtime, activation, context) {
30
86
  const definition = runtime.activities.describe(activation.activity);
@@ -45,17 +101,14 @@ async function attemptExecution(runtime, activation, context) {
45
101
  return existing;
46
102
  const currentRunId = runId(runtime.dependencies.ids.next(ExecutionStreamKind.Run));
47
103
  const startedAt = runtime.dependencies.clock.now().toISOString();
48
- let reportRunnerStarted = () => { };
49
- const runnerStarted = new Promise((resolve) => {
50
- reportRunnerStarted = resolve;
51
- });
104
+ const reportRunnerStarted = () => undefined;
52
105
  let lease;
106
+ let renewal;
53
107
  let claimed = false;
54
108
  try {
55
109
  await claimActivationForAttempt(runtime, activation, currentRunId, owner, startedAt);
56
110
  claimed = true;
57
- lease = await acquireAttemptWorkspace(runtime, activation, context, currentRunId);
58
- await startRun({
111
+ await prepareRun({
59
112
  dependencies: runLifecycleDependencies(runtime),
60
113
  runId: currentRunId,
61
114
  activation,
@@ -63,41 +116,174 @@ async function attemptExecution(runtime, activation, context) {
63
116
  attempt: prior.length + 1,
64
117
  startedAt,
65
118
  runner,
119
+ });
120
+ runtime.localAttempts.add(currentRunId);
121
+ renewal = renewWhileActive(runtime, currentRunId, owner);
122
+ const controller = createExecutionController(runtime, currentRunId);
123
+ if (definition.executionKind !== ActivityExecutionKind.Deterministic) {
124
+ const prepared = (await runtime.repository.load(currentRunId)).view;
125
+ const detachedAttempt = {
126
+ activation,
127
+ context,
128
+ currentRunId,
129
+ attempt: prior.length + 1,
130
+ runner,
131
+ resume,
132
+ renewal,
133
+ reportRunnerStarted,
134
+ controller,
135
+ };
136
+ const worker = trackExecutionWorker(runtime, currentRunId, controller, continueDetachedAttemptOnNextTurn(runtime, detachedAttempt));
137
+ void worker.catch(() => {
138
+ reportRunnerStarted();
139
+ // The worker has already attempted durable settlement; never leak its rejection.
140
+ });
141
+ return prepared;
142
+ }
143
+ lease = await acquireAttemptWorkspace(runtime, activation, context, currentRunId, controller.signal);
144
+ const executionStartedAt = await startRun({
145
+ dependencies: runLifecycleDependencies(runtime),
146
+ runId: currentRunId,
147
+ activation,
148
+ context,
149
+ attempt: prior.length + 1,
150
+ runner,
151
+ lease,
152
+ });
153
+ if (executionStartedAt === undefined) {
154
+ await confirmCancellation(runtime.repository, runtime.dependencies.clock, currentRunId);
155
+ await renewal.stop();
156
+ await cleanupRun(runtime, currentRunId, activation, context, { lease });
157
+ return (await runtime.repository.load(currentRunId)).view;
158
+ }
159
+ const completion = trackExecutionWorker(runtime, currentRunId, controller, completeRun(runtime, currentRunId, activation, context, executionStartedAt, runner, resume.sessionId, resume.startedAt, resume.usageBaseline, lease, renewal, reportRunnerStarted));
160
+ void completion.catch(() => {
161
+ reportRunnerStarted();
162
+ // A detached worker must never create an unhandled rejection for its caller.
163
+ });
164
+ }
165
+ catch (error) {
166
+ return recoverFailedAttempt(runtime, { activation, context, currentRunId, renewal, lease, claimed }, error);
167
+ }
168
+ await yieldToRunStart(context.awaitImmediateCompletion ? undefined : Promise.resolve());
169
+ return (await runtime.repository.load(currentRunId)).view;
170
+ }
171
+ function continueDetachedAttemptOnNextTurn(runtime, attempt) {
172
+ return new Promise((resolve) => setImmediate(resolve))
173
+ .then(() => continueDetachedAttempt(runtime, attempt))
174
+ .finally(async () => {
175
+ try {
176
+ await attempt.renewal.stop();
177
+ }
178
+ finally {
179
+ runtime.active.delete(attempt.currentRunId);
180
+ runtime.localAttempts.delete(attempt.currentRunId);
181
+ }
182
+ });
183
+ }
184
+ function createExecutionController(runtime, currentRunId) {
185
+ const controller = new AbortController();
186
+ runtime.active.set(currentRunId, controller);
187
+ if (runtime.lifecycle.closed) {
188
+ void beginShutdownCancellation(runtime, currentRunId);
189
+ controller.abort(ExecutionCancellationReason.Shutdown);
190
+ }
191
+ return controller;
192
+ }
193
+ function trackExecutionWorker(runtime, currentRunId, controller, completion) {
194
+ const tracked = completion.finally(() => {
195
+ if (runtime.lifecycle.workers.get(currentRunId)?.completion === tracked)
196
+ runtime.lifecycle.workers.delete(currentRunId);
197
+ runtime.lifecycle.cancellations.delete(currentRunId);
198
+ });
199
+ runtime.lifecycle.workers.set(currentRunId, { controller, completion: tracked });
200
+ return tracked;
201
+ }
202
+ async function continueDetachedAttempt(runtime, attempt) {
203
+ const { activation, context, currentRunId, attempt: attemptNumber, runner, resume, renewal, reportRunnerStarted, controller, } = attempt;
204
+ let lease;
205
+ try {
206
+ lease = await acquireAttemptWorkspace(runtime, activation, context, currentRunId, controller.signal);
207
+ const executionStartedAt = await startRun({
208
+ dependencies: runLifecycleDependencies(runtime),
209
+ runId: currentRunId,
210
+ activation,
211
+ context,
212
+ attempt: attemptNumber,
213
+ runner,
66
214
  lease,
67
215
  });
216
+ if (executionStartedAt === undefined) {
217
+ await confirmCancellation(runtime.repository, runtime.dependencies.clock, currentRunId);
218
+ await renewal.stop();
219
+ await cleanupRun(runtime, currentRunId, activation, context, {
220
+ lease,
221
+ preserveLocalAttempt: true,
222
+ });
223
+ return (await runtime.repository.load(currentRunId)).view;
224
+ }
225
+ const completion = completeRun(runtime, currentRunId, activation, context, executionStartedAt, runner, resume.sessionId, resume.startedAt, resume.usageBaseline, lease, renewal, reportRunnerStarted, true);
226
+ await completion;
227
+ return (await runtime.repository.load(currentRunId)).view;
68
228
  }
69
229
  catch (error) {
230
+ return recoverFailedAttempt(runtime, {
231
+ activation,
232
+ context,
233
+ currentRunId,
234
+ renewal,
235
+ lease,
236
+ claimed: true,
237
+ preserveLocalAttempt: true,
238
+ }, error);
239
+ }
240
+ }
241
+ async function recoverFailedAttempt(runtime, attempt, error) {
242
+ const { activation, context, currentRunId, renewal, lease, claimed } = attempt;
243
+ try {
70
244
  const persisted = await runtime.repository.load(currentRunId);
71
- if (persisted.view?.status === RunStatus.Started) {
72
- try {
73
- await recordRunFailure({
74
- dependencies: runLifecycleDependencies(runtime),
75
- runId: currentRunId,
76
- activation,
77
- context,
78
- error,
245
+ if (persisted.view !== null) {
246
+ await renewal?.stop();
247
+ const settled = await runtime.repository.load(currentRunId);
248
+ if (settled.view !== null && !isActiveRunStatus(settled.view.status)) {
249
+ await cleanupRun(runtime, currentRunId, activation, context, {
250
+ lease,
251
+ preserveLocalAttempt: attempt.preserveLocalAttempt,
252
+ });
253
+ return settled.view;
254
+ }
255
+ if (settled.view === null) {
256
+ await releasePreStartResources(runtime, activation, currentRunId, {
257
+ lease,
258
+ claimed,
259
+ preserveLocalAttempt: attempt.preserveLocalAttempt,
79
260
  });
261
+ throw error;
262
+ }
263
+ try {
264
+ await settleRunFailure(runtime, currentRunId, activation, context, error);
80
265
  }
81
266
  finally {
82
- await cleanupRun(runtime, currentRunId, activation, context, lease);
267
+ await cleanupRun(runtime, currentRunId, activation, context, {
268
+ lease,
269
+ preserveLocalAttempt: attempt.preserveLocalAttempt,
270
+ });
83
271
  }
84
272
  return (await runtime.repository.load(currentRunId)).view;
85
273
  }
86
- await releasePreStartResources(runtime, activation, currentRunId, lease, claimed);
274
+ await renewal?.stop();
275
+ await releasePreStartResources(runtime, activation, currentRunId, {
276
+ lease,
277
+ claimed,
278
+ preserveLocalAttempt: attempt.preserveLocalAttempt,
279
+ });
87
280
  throw error;
88
281
  }
89
- const completion = completeRun(runtime, currentRunId, activation, context, startedAt, runner, resume.sessionId, resume.startedAt, resume.usageBaseline, lease, reportRunnerStarted);
90
- void completion.catch(() => {
91
- reportRunnerStarted();
92
- // A detached worker must never create an unhandled rejection for its caller.
93
- });
94
- await yieldToRunStart(definition.executionKind === ActivityExecutionKind.Deterministic &&
95
- context.awaitImmediateCompletion
96
- ? undefined
97
- : definition.executionKind === ActivityExecutionKind.Deterministic
98
- ? Promise.resolve()
99
- : runnerStarted);
100
- return (await runtime.repository.load(currentRunId)).view;
282
+ finally {
283
+ await renewal?.stop();
284
+ await runtime.lifecycle.cancellations.get(currentRunId);
285
+ runtime.lifecycle.cancellations.delete(currentRunId);
286
+ }
101
287
  }
102
288
  async function yieldToRunStart(runnerStarted) {
103
289
  if (runnerStarted !== undefined)
@@ -106,8 +292,14 @@ async function yieldToRunStart(runnerStarted) {
106
292
  }
107
293
  // A Run completion atomically carries the full execution lease context.
108
294
  // eslint-disable-next-line max-params
109
- async function completeRun(runtime, currentRunId, activation, context, startedAt, runner, resumeSessionId, resumeStartedAt, usageBaseline, lease, reportRunnerStarted) {
110
- const renewal = renewWhileRunning(runtime, currentRunId, context.owner ?? 'execution');
295
+ async function completeRun(runtime, currentRunId, activation, context, startedAt, runner, resumeSessionId, resumeStartedAt, usageBaseline, lease, renewal, reportRunnerStarted, preserveLocalAttempt = false) {
296
+ let renewalStopped = false;
297
+ const stopRenewal = async () => {
298
+ if (renewalStopped)
299
+ return;
300
+ renewalStopped = true;
301
+ await renewal.stop();
302
+ };
111
303
  try {
112
304
  const outcome = await executeActivity(runtime, currentRunId, {
113
305
  activation,
@@ -124,25 +316,13 @@ async function completeRun(runtime, currentRunId, activation, context, startedAt
124
316
  ...(lease === undefined ? {} : { workspace: { path: lease.path, mode: lease.mode } }),
125
317
  reportRunnerStarted,
126
318
  });
127
- await renewal.stop();
128
- await recordRunSuccess({
129
- dependencies: runLifecycleDependencies(runtime),
130
- runId: currentRunId,
131
- activation,
132
- context,
133
- outcome,
134
- });
319
+ await stopRenewal();
320
+ await settleRunSuccess(runtime, currentRunId, activation, context, outcome);
135
321
  }
136
322
  catch (error) {
137
323
  try {
138
- await renewal.stop();
139
- await recordRunFailure({
140
- dependencies: runLifecycleDependencies(runtime),
141
- runId: currentRunId,
142
- activation,
143
- context,
144
- error,
145
- });
324
+ await stopRenewal();
325
+ await settleRunFailure(runtime, currentRunId, activation, context, error);
146
326
  }
147
327
  catch {
148
328
  // The caller already has a durable started Run; cleanup must still run.
@@ -150,11 +330,48 @@ async function completeRun(runtime, currentRunId, activation, context, startedAt
150
330
  }
151
331
  finally {
152
332
  reportRunnerStarted();
153
- await renewal.stop();
154
- await cleanupRun(runtime, currentRunId, activation, context, lease);
333
+ await stopRenewal();
334
+ await cleanupRun(runtime, currentRunId, activation, context, {
335
+ lease,
336
+ preserveLocalAttempt,
337
+ });
155
338
  }
156
339
  }
157
- function renewWhileRunning(runtime, currentRunId, owner) {
340
+ async function settleRunSuccess(runtime, currentRunId, activation, context, outcome) {
341
+ if (await shutdownCancellationSucceeded(runtime, currentRunId)) {
342
+ await confirmCancellation(runtime.repository, runtime.dependencies.clock, currentRunId);
343
+ return;
344
+ }
345
+ await recordRunSuccess({
346
+ dependencies: runLifecycleDependencies(runtime),
347
+ runId: currentRunId,
348
+ activation,
349
+ context,
350
+ outcome,
351
+ });
352
+ }
353
+ async function settleRunFailure(runtime, currentRunId, activation, context, error) {
354
+ if (await shutdownCancellationSucceeded(runtime, currentRunId)) {
355
+ await confirmCancellation(runtime.repository, runtime.dependencies.clock, currentRunId);
356
+ return;
357
+ }
358
+ const run = await recordRunFailure({
359
+ dependencies: runLifecycleDependencies(runtime),
360
+ runId: currentRunId,
361
+ activation,
362
+ context,
363
+ error,
364
+ });
365
+ if (run !== null &&
366
+ run !== undefined &&
367
+ isActiveRunStatus(run.status) &&
368
+ run.cancellation !== undefined)
369
+ await confirmCancellation(runtime.repository, runtime.dependencies.clock, currentRunId);
370
+ }
371
+ async function shutdownCancellationSucceeded(runtime, currentRunId) {
372
+ return (await runtime.lifecycle.cancellations.get(currentRunId)) === true;
373
+ }
374
+ function renewWhileActive(runtime, currentRunId, owner) {
158
375
  const leaseDurationMs = runtime.config.leaseDurationMs ?? 60_000;
159
376
  const intervalMs = runtime.config.leaseRenewalIntervalMs ?? Math.max(1, Math.floor(leaseDurationMs / 2));
160
377
  let inFlight;
@@ -179,7 +396,8 @@ function renewWhileRunning(runtime, currentRunId, owner) {
179
396
  },
180
397
  };
181
398
  }
182
- async function cleanupRun(runtime, currentRunId, activation, context, lease) {
399
+ async function cleanupRun(runtime, currentRunId, activation, context, options) {
400
+ const { lease } = options;
183
401
  try {
184
402
  await releaseActivation({
185
403
  journal: runtime.journal,
@@ -188,6 +406,9 @@ async function cleanupRun(runtime, currentRunId, activation, context, lease) {
188
406
  runId: currentRunId,
189
407
  });
190
408
  }
409
+ catch {
410
+ // An activation release can be retried after its claim expires; it must not mask the Run result.
411
+ }
191
412
  finally {
192
413
  runtime.active.delete(currentRunId);
193
414
  try {
@@ -207,9 +428,17 @@ async function cleanupRun(runtime, currentRunId, activation, context, lease) {
207
428
  // A cleanup diagnostic must not make an already-finished run fatal.
208
429
  }
209
430
  }
431
+ finally {
432
+ runtime.lifecycle.cancellations.delete(currentRunId);
433
+ if (options.preserveLocalAttempt !== true)
434
+ runtime.localAttempts.delete(currentRunId);
435
+ }
210
436
  }
211
437
  }
212
- async function releasePreStartResources(runtime, activation, currentRunId, lease, claimed) {
438
+ async function releasePreStartResources(runtime, activation, currentRunId, options) {
439
+ const { lease, claimed } = options;
440
+ if (options.preserveLocalAttempt !== true)
441
+ runtime.localAttempts.delete(currentRunId);
213
442
  if (claimed) {
214
443
  try {
215
444
  await releaseActivation({
@@ -368,8 +597,8 @@ async function claimActivationForAttempt(runtime, activation, currentRunId, owne
368
597
  occurredAt,
369
598
  });
370
599
  }
371
- function acquireAttemptWorkspace(runtime, activation, context, currentRunId) {
372
- return acquireWorkspace(currentRunId, activation.execution?.workspace ?? WorkspaceMode.None, context.workItemId, context.resources, runtime.dependencies.workspaces);
600
+ function acquireAttemptWorkspace(runtime, activation, context, currentRunId, signal) {
601
+ return acquireWorkspace(currentRunId, activation.execution?.workspace ?? WorkspaceMode.None, context.workItemId, context.resources, runtime.dependencies.workspaces, signal);
373
602
  }
374
603
  function existingRun(runs, clock, owner) {
375
604
  const completed = runs.find((run) => run.status === RunStatus.Succeeded);
@@ -378,7 +607,7 @@ function existingRun(runs, clock, owner) {
378
607
  const ambiguous = runs.find((run) => run.status === RunStatus.Ambiguous);
379
608
  if (ambiguous !== undefined)
380
609
  return ambiguous;
381
- const active = runs.find((run) => run.status === RunStatus.Started);
610
+ const active = runs.find((run) => isActiveRunStatus(run.status));
382
611
  if (active === undefined)
383
612
  return undefined;
384
613
  if (active.lease !== undefined &&
@@ -0,0 +1,8 @@
1
+ import { type ResourceRequirement } from '../../activities/index.js';
2
+ import { type ResourceView } from '../../resources/index.js';
3
+ import type { WorkItemId } from '../../work/index.js';
4
+ import type { RunId } from '../contracts/identifiers.js';
5
+ import { WorkspaceMode } from '../contracts/vocabulary.js';
6
+ import type { WorkspaceLease, WorkspaceProvider } from '../contracts/workspace.js';
7
+ export declare function acquireWorkspace(runId: RunId, mode: typeof WorkspaceMode.None | typeof WorkspaceMode.ReadOnly | typeof WorkspaceMode.Branch, workItemId: WorkItemId, resources: readonly ResourceView[], provider?: WorkspaceProvider, signal?: AbortSignal): Promise<WorkspaceLease | undefined>;
8
+ export declare function validateResourceRequirements(requirements: readonly ResourceRequirement[], resources: readonly ResourceView[]): void;
@@ -1,7 +1,7 @@
1
1
  import { ActivityResourceCardinality } from '../../activities/index.js';
2
2
  import { BuiltInResourceKind } from '../../resources/index.js';
3
3
  import { WorkspaceMode } from '../contracts/vocabulary.js';
4
- export async function acquireWorkspace(runId, mode, workItemId, resources, provider) {
4
+ export async function acquireWorkspace(runId, mode, workItemId, resources, provider, signal = new AbortController().signal) {
5
5
  if (mode === WorkspaceMode.None)
6
6
  return undefined;
7
7
  if (provider === undefined)
@@ -11,7 +11,8 @@ export async function acquireWorkspace(runId, mode, workItemId, resources, provi
11
11
  resource.kind === BuiltInResourceKind.PullRequest);
12
12
  if (repositoryResource === undefined)
13
13
  throw new Error('Repository Resource is required');
14
- return provider.acquire({ runId, mode, workItemId, repositoryResource });
14
+ signal.throwIfAborted();
15
+ return provider.acquire({ runId, signal, mode, workItemId, repositoryResource });
15
16
  }
16
17
  export function validateResourceRequirements(requirements, resources) {
17
18
  for (const requirement of requirements) {
@@ -0,0 +1,52 @@
1
+ import type { CommandContext, EventJournal } from '@atolis-hq/eventing';
2
+ import type { ActivityRegistry } from '../../activities/index.js';
3
+ import type { Clock } from '../../kernel/index.js';
4
+ import type { ExecutionConfig } from '../contracts/config.js';
5
+ import type { RecoveryCoordinator } from '../contracts/control-plane.js';
6
+ import type { AgentRunnerResult } from '../contracts/runner.js';
7
+ import type { RunView } from '../contracts/views.js';
8
+ import { ExecutionFailureCode, ExternalExecutionState, RunStatus } from '../contracts/vocabulary.js';
9
+ export interface ExternalExecutionInspector {
10
+ inspect(reference: NonNullable<RunView['externalExecution']>): Promise<{
11
+ readonly kind: typeof ExternalExecutionState.Running;
12
+ } | {
13
+ readonly kind: typeof ExternalExecutionState.Completed;
14
+ readonly result: AgentRunnerResult;
15
+ } | {
16
+ readonly kind: typeof ExternalExecutionState.Absent;
17
+ } | {
18
+ readonly kind: typeof ExternalExecutionState.Unknown;
19
+ readonly reason: string;
20
+ }>;
21
+ }
22
+ export type AmbiguityResolution = {
23
+ readonly kind: typeof RunStatus.Succeeded;
24
+ readonly outcome: unknown;
25
+ } | {
26
+ readonly kind: typeof RunStatus.Failed;
27
+ readonly failure: {
28
+ readonly kind: typeof ExecutionFailureCode.Unexpected;
29
+ readonly message: string;
30
+ };
31
+ };
32
+ export interface AmbiguityWorkflowBlocker {
33
+ block(workflowInstanceId: string, reason: string, context: CommandContext): Promise<unknown>;
34
+ }
35
+ export declare class RecoveryService {
36
+ private readonly clock;
37
+ private readonly inspector;
38
+ private readonly activities;
39
+ private readonly config;
40
+ private readonly blocker?;
41
+ private readonly repository;
42
+ constructor(journal: EventJournal, clock: Clock, inspector: ExternalExecutionInspector, activities: Pick<ActivityRegistry, 'validateOutcome'>, config?: Pick<ExecutionConfig, 'leaseDurationMs' | 'leaseRenewalIntervalMs' | 'maxAmbiguityReconciliationAttempts'>, blocker?: AmbiguityWorkflowBlocker | undefined);
43
+ recover(id: string, owner: string): Promise<RunView>;
44
+ resolve(id: string, resolution: AmbiguityResolution, context: CommandContext): Promise<RunView>;
45
+ recoverActive(owner: string, isLocallyActive?: (runId: string) => boolean): Promise<readonly RunView[]>;
46
+ private appendLease;
47
+ private appendRecovered;
48
+ private appendFailure;
49
+ private appendAmbiguity;
50
+ private append;
51
+ }
52
+ export declare function createRecoveryCoordinator(service: RecoveryService): RecoveryCoordinator;