@opengeni/worker-bundle 2.0.1 → 2.0.2-canary.38789554071001

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 (379) hide show
  1. package/dist/activities/agent-run-admission.d.ts +1 -12
  2. package/dist/activities/agent-turn/admission.d.ts +88 -10
  3. package/dist/activities/agent-turn/agent-build.d.ts +14 -3
  4. package/dist/activities/agent-turn/claim.d.ts +4 -1
  5. package/dist/activities/agent-turn/claude-core.d.ts +195 -0
  6. package/dist/activities/agent-turn/code-search.d.ts +60 -0
  7. package/dist/activities/agent-turn/codex-capacity.d.ts +3 -0
  8. package/dist/activities/agent-turn/codex-core-capacity.d.ts +37 -0
  9. package/dist/activities/agent-turn/codex-core-claim.d.ts +40 -0
  10. package/dist/activities/agent-turn/codex-core-errors.d.ts +102 -0
  11. package/dist/activities/agent-turn/codex-core-failover.d.ts +15 -0
  12. package/dist/activities/agent-turn/codex-core-requests.d.ts +28 -0
  13. package/dist/activities/agent-turn/codex-core-settlement.d.ts +77 -0
  14. package/dist/activities/agent-turn/codex-credit-policy.d.ts +30 -0
  15. package/dist/activities/agent-turn/codex-plan-entitlement.d.ts +105 -0
  16. package/dist/activities/agent-turn/codex-usage-policy.d.ts +2 -0
  17. package/dist/activities/agent-turn/codex.d.ts +2 -19
  18. package/dist/activities/agent-turn/compaction-interruption.d.ts +32 -0
  19. package/dist/activities/agent-turn/compaction-prep.d.ts +30 -1
  20. package/dist/activities/agent-turn/credential-leases.d.ts +64 -37
  21. package/dist/activities/agent-turn/credential-restriction.d.ts +3 -0
  22. package/dist/activities/agent-turn/errors.d.ts +185 -26
  23. package/dist/activities/agent-turn/failure-settlement.d.ts +10 -43
  24. package/dist/activities/agent-turn/final-reply.d.ts +18 -0
  25. package/dist/activities/agent-turn/finalization-monitor.d.ts +7 -2
  26. package/dist/activities/agent-turn/finalization.d.ts +2 -0
  27. package/dist/activities/agent-turn/github-repository-bindings.d.ts +2 -0
  28. package/dist/activities/agent-turn/governance-model.d.ts +13 -1
  29. package/dist/activities/agent-turn/history-sink.d.ts +4 -1
  30. package/dist/activities/agent-turn/history.d.ts +2 -0
  31. package/dist/activities/agent-turn/input-wait-reply.d.ts +76 -0
  32. package/dist/activities/agent-turn/meaningful-output.d.ts +9 -0
  33. package/dist/activities/agent-turn/media-artifacts.d.ts +5 -3
  34. package/dist/activities/agent-turn/model-call-admission.d.ts +15 -0
  35. package/dist/activities/agent-turn/model-usage.d.ts +56 -14
  36. package/dist/activities/agent-turn/model-wire-dispatch.d.ts +15 -0
  37. package/dist/activities/agent-turn/optional-repositories.d.ts +59 -0
  38. package/dist/activities/agent-turn/prompt-tool-availability.d.ts +17 -0
  39. package/dist/activities/agent-turn/provider-dispatch-barrier.d.ts +12 -1
  40. package/dist/activities/agent-turn/provider-recovery-copy.d.ts +24 -0
  41. package/dist/activities/agent-turn/provider-recovery-metrics.d.ts +18 -0
  42. package/dist/activities/agent-turn/provider-recovery-policy.d.ts +6 -0
  43. package/dist/activities/agent-turn/quiescence.d.ts +6 -7
  44. package/dist/activities/agent-turn/recovery-warning.d.ts +6 -5
  45. package/dist/activities/agent-turn/refresh-credentials.d.ts +6 -0
  46. package/dist/activities/agent-turn/run-credentials.d.ts +9 -5
  47. package/dist/activities/agent-turn/run.d.ts +27 -2
  48. package/dist/activities/agent-turn/sandbox-establish.d.ts +1 -0
  49. package/dist/activities/agent-turn/sandbox-provision.d.ts +25 -1
  50. package/dist/activities/agent-turn/sandbox-route.d.ts +3 -0
  51. package/dist/activities/agent-turn/sandbox-runtime.d.ts +1 -1
  52. package/dist/activities/agent-turn/secret-resolver.d.ts +64 -0
  53. package/dist/activities/agent-turn/session-title.d.ts +60 -3
  54. package/dist/activities/agent-turn/session-usage-custody.d.ts +66 -0
  55. package/dist/activities/agent-turn/skill-checkout.d.ts +25 -6
  56. package/dist/activities/agent-turn/skill-read.d.ts +70 -2
  57. package/dist/activities/agent-turn/skill-search.d.ts +2 -0
  58. package/dist/activities/agent-turn/skill-tools.d.ts +41 -4
  59. package/dist/activities/agent-turn/skill-transfer.d.ts +18 -6
  60. package/dist/activities/agent-turn/stream-attempt.d.ts +6 -3
  61. package/dist/activities/agent-turn/subscription-capacity-arming.d.ts +41 -0
  62. package/dist/activities/agent-turn/subscription-core-capacity.d.ts +86 -0
  63. package/dist/activities/agent-turn/subscription-core-failover.d.ts +69 -0
  64. package/dist/activities/agent-turn/subscription-core-placed.d.ts +14 -0
  65. package/dist/activities/agent-turn/subscription-core-requests.d.ts +109 -0
  66. package/dist/activities/agent-turn/subscription-core-settlement.d.ts +112 -0
  67. package/dist/activities/agent-turn/subscription-lease.d.ts +44 -0
  68. package/dist/activities/agent-turn/subscription-serving-capacity.d.ts +6 -0
  69. package/dist/activities/agent-turn/subscription-serving-catalog.d.ts +13 -0
  70. package/dist/activities/agent-turn/subscription-serving-claim.d.ts +30 -0
  71. package/dist/activities/agent-turn/subscription-serving-providers.d.ts +2 -0
  72. package/dist/activities/agent-turn/tool-environment.d.ts +31 -6
  73. package/dist/activities/agent-turn/tool-policy.d.ts +55 -3
  74. package/dist/activities/agent-turn/turn-context.d.ts +104 -5
  75. package/dist/activities/agent-turn/web-search.d.ts +57 -0
  76. package/dist/activities/agent-turn/xai-core.d.ts +96 -0
  77. package/dist/activities/automations.d.ts +3 -1
  78. package/dist/activities/browser-deadline-checkpoint.d.ts +34 -0
  79. package/dist/activities/capabilities.d.ts +8 -20
  80. package/dist/activities/codemode-dispatcher.d.ts +20 -3
  81. package/dist/activities/codex-capacity.d.ts +1 -56
  82. package/dist/activities/codex-image-generation.d.ts +49 -3
  83. package/dist/activities/common.d.ts +3 -1
  84. package/dist/activities/context-compaction.d.ts +41 -2
  85. package/dist/activities/environment.d.ts +1 -19
  86. package/dist/activities/gmail-files.d.ts +50 -0
  87. package/dist/activities/goals.d.ts +1 -9
  88. package/dist/activities/incident-telemetry-authority.d.ts +5 -2
  89. package/dist/activities/incident-telemetry-preflight.d.ts +10 -3
  90. package/dist/activities/knowledge-indexing.d.ts +19 -0
  91. package/dist/activities/mcp-account-routes.d.ts +2 -21
  92. package/dist/activities/model-call-fact-reconciler.d.ts +34 -0
  93. package/dist/activities/open-suffix-resume.d.ts +15 -0
  94. package/dist/activities/parent-wake.d.ts +17 -12
  95. package/dist/activities/programmatic-approvals.d.ts +10 -0
  96. package/dist/activities/requester-unavailable-receipt.d.ts +8 -0
  97. package/dist/activities/retained-screenshots.d.ts +7 -2
  98. package/dist/activities/run-credential-renewal.d.ts +1 -0
  99. package/dist/activities/run-credentials.d.ts +16 -4
  100. package/dist/activities/run-input.d.ts +17 -0
  101. package/dist/activities/sandbox-lease.d.ts +132 -12
  102. package/dist/activities/scheduled-tasks.d.ts +4 -35
  103. package/dist/activities/session-archive.d.ts +58 -0
  104. package/dist/activities/session-state.d.ts +15 -3
  105. package/dist/activities/session-storage.d.ts +44 -0
  106. package/dist/activities/subscription-core-claude-waits.d.ts +2 -0
  107. package/dist/activities/subscription-core-codex-quota.d.ts +25 -0
  108. package/dist/activities/subscription-core-codex-waits.d.ts +153 -0
  109. package/dist/activities/subscription-core-image-operation.d.ts +29 -0
  110. package/dist/activities/subscription-core-usage-recheck.d.ts +49 -0
  111. package/dist/activities/subscription-core-wait-bindings.d.ts +3 -0
  112. package/dist/activities/subscription-core-xai-quota.d.ts +30 -0
  113. package/dist/activities/subscription-core-xai-waits.d.ts +2 -0
  114. package/dist/activities/types.d.ts +68 -5
  115. package/dist/activities/video-generation-admission.d.ts +2 -8
  116. package/dist/activities/video-generation-credential.d.ts +15 -12
  117. package/dist/activities/video-generation-subscription-core.d.ts +70 -0
  118. package/dist/activities/workspace-capture.d.ts +2 -0
  119. package/dist/activities/workspace-credential-provider.d.ts +47 -0
  120. package/dist/activities/xai-auth.d.ts +6 -18
  121. package/dist/activities/xai-image-generation.d.ts +22 -6
  122. package/dist/{activities-control-QA6OLRQY.js → activities-control-5IIVRXLA.js} +1569 -2883
  123. package/dist/activities-control-5IIVRXLA.js.map +1 -0
  124. package/dist/activities-control.d.ts +64 -4
  125. package/dist/{activities-turn-YVVKCGAK.js → activities-turn-FLYJOM54.js} +9300 -4403
  126. package/dist/activities-turn-FLYJOM54.js.map +1 -0
  127. package/dist/activities.d.ts +64 -4
  128. package/dist/artifact-materializer-entry.js +107 -36
  129. package/dist/artifact-materializer-entry.js.map +1 -1
  130. package/dist/artifact-outbox-entry.js +132 -61
  131. package/dist/artifact-outbox-entry.js.map +1 -1
  132. package/dist/browser-deadline-checkpoint-contract.d.ts +2 -0
  133. package/dist/{chunk-GDCLDKSH.js → chunk-24GP3BX5.js} +79 -72
  134. package/dist/chunk-24GP3BX5.js.map +1 -0
  135. package/dist/{chunk-RAMNYSAW.js → chunk-4ER3YXOT.js} +22 -4
  136. package/dist/chunk-4ER3YXOT.js.map +1 -0
  137. package/dist/{chunk-I7HKKMUJ.js → chunk-5NNS4327.js} +734 -58
  138. package/dist/chunk-5NNS4327.js.map +1 -0
  139. package/dist/chunk-MVESOYFC.js +3746 -0
  140. package/dist/chunk-MVESOYFC.js.map +1 -0
  141. package/dist/{chunk-M3NVMF2V.js → chunk-N57B3PJ5.js} +2307 -3951
  142. package/dist/chunk-N57B3PJ5.js.map +1 -0
  143. package/dist/chunk-NQDVJ6RI.js +2823 -0
  144. package/dist/chunk-NQDVJ6RI.js.map +1 -0
  145. package/dist/chunk-O7UPBWXK.js +79 -0
  146. package/dist/chunk-O7UPBWXK.js.map +1 -0
  147. package/dist/chunk-W2QSM5HR.js +414 -0
  148. package/dist/chunk-W2QSM5HR.js.map +1 -0
  149. package/dist/chunk-ZN3XJR33.js +227 -0
  150. package/dist/chunk-ZN3XJR33.js.map +1 -0
  151. package/dist/editable-artifact-outbox-dispatcher.d.ts +12 -1
  152. package/dist/editable-artifact-outbox-service.d.ts +3 -1
  153. package/dist/host-export-pump.d.ts +3 -1
  154. package/dist/host-export.d.ts +2 -2
  155. package/dist/host-export.js +1 -1
  156. package/dist/http.d.ts +1 -1
  157. package/dist/index.d.ts +49 -48
  158. package/dist/index.js +835 -256
  159. package/dist/index.js.map +1 -1
  160. package/dist/internal-maintenance.d.ts +63 -0
  161. package/dist/maintenance-cadence.d.ts +43 -0
  162. package/dist/observability-metrics.d.ts +293 -24
  163. package/dist/onepassword-vault-provider.d.ts +7 -0
  164. package/dist/parent-wake-PCLH7A3Y.js +24 -0
  165. package/dist/parent-wake-PCLH7A3Y.js.map +1 -0
  166. package/dist/personal-github-git-credentials.d.ts +1 -1
  167. package/dist/readiness-checks.d.ts +39 -0
  168. package/dist/retained-process-retry.d.ts +7 -0
  169. package/dist/sandbox-lease-BJYU72N3.js +84 -0
  170. package/dist/sandbox-lease-BJYU72N3.js.map +1 -0
  171. package/dist/sandbox-reaper-contract.d.ts +25 -0
  172. package/dist/sandbox-resume.d.ts +72 -4
  173. package/dist/sandbox-routing.d.ts +4 -2
  174. package/dist/session-event-fanout.d.ts +6 -0
  175. package/dist/site-auth-maintenance-WK3MR2PV.js +12 -0
  176. package/dist/site-auth-maintenance-WK3MR2PV.js.map +1 -0
  177. package/dist/telemetry-scheduler.d.ts +14 -0
  178. package/dist/temporal-runtime-logger.d.ts +22 -0
  179. package/dist/turn-task-queue-reader.d.ts +18 -0
  180. package/dist/turn-worker-activity-telemetry.d.ts +47 -0
  181. package/dist/worker-service-lifecycle.d.ts +12 -0
  182. package/dist/workflow-bundle.js +468 -71
  183. package/dist/workflows/activities.d.ts +1 -1
  184. package/dist/workflows/browser-deadline-checkpoint.d.ts +10 -0
  185. package/dist/workflows/sandbox-reaper.d.ts +10 -1
  186. package/dist/workflows/scheduled-tasks.d.ts +4 -0
  187. package/dist/workflows/session-storage.d.ts +2 -0
  188. package/dist/workflows/session.d.ts +36 -0
  189. package/dist/workflows/site-auth-maintenance.d.ts +2 -1
  190. package/dist/workflows/workflow-wake.d.ts +14 -3
  191. package/dist/workflows.d.ts +3 -1
  192. package/package.json +26 -20
  193. package/src/activities/agent-run-admission.ts +1 -82
  194. package/src/activities/agent-turn/admission.ts +175 -24
  195. package/src/activities/agent-turn/agent-build.ts +226 -145
  196. package/src/activities/agent-turn/claim.ts +363 -64
  197. package/src/activities/agent-turn/claude-core.ts +587 -0
  198. package/src/activities/agent-turn/code-search.ts +275 -0
  199. package/src/activities/agent-turn/codex-capacity.ts +30 -757
  200. package/src/activities/agent-turn/codex-core-capacity.ts +190 -0
  201. package/src/activities/agent-turn/codex-core-claim.ts +83 -0
  202. package/src/activities/agent-turn/codex-core-errors.ts +308 -0
  203. package/src/activities/agent-turn/codex-core-failover.ts +73 -0
  204. package/src/activities/agent-turn/codex-core-requests.ts +86 -0
  205. package/src/activities/agent-turn/codex-core-settlement.ts +263 -0
  206. package/src/activities/agent-turn/codex-credit-policy.ts +247 -0
  207. package/src/activities/agent-turn/codex-plan-entitlement.ts +254 -0
  208. package/src/activities/agent-turn/codex-usage-policy.ts +2 -0
  209. package/src/activities/agent-turn/codex.ts +8 -76
  210. package/src/activities/agent-turn/compaction-interruption.ts +56 -0
  211. package/src/activities/agent-turn/compaction-prep.ts +249 -36
  212. package/src/activities/agent-turn/credential-leases.ts +269 -214
  213. package/src/activities/agent-turn/credential-restriction.ts +14 -0
  214. package/src/activities/agent-turn/errors.ts +1152 -82
  215. package/src/activities/agent-turn/failure-settlement.ts +879 -886
  216. package/src/activities/agent-turn/final-reply.ts +46 -0
  217. package/src/activities/agent-turn/finalization-monitor.ts +17 -5
  218. package/src/activities/agent-turn/finalization.ts +107 -88
  219. package/src/activities/agent-turn/github-repository-bindings.ts +3 -1
  220. package/src/activities/agent-turn/governance-model.ts +90 -22
  221. package/src/activities/agent-turn/history-sink.ts +42 -12
  222. package/src/activities/agent-turn/history.ts +25 -5
  223. package/src/activities/agent-turn/input-wait-reply.ts +139 -0
  224. package/src/activities/agent-turn/knowledge-source-tools.ts +2 -0
  225. package/src/activities/agent-turn/meaningful-output.ts +44 -0
  226. package/src/activities/agent-turn/media-artifacts.ts +3 -1
  227. package/src/activities/agent-turn/model-call-admission.ts +114 -0
  228. package/src/activities/agent-turn/model-usage.ts +299 -233
  229. package/src/activities/agent-turn/model-wire-dispatch.ts +27 -0
  230. package/src/activities/agent-turn/optional-repositories.ts +224 -0
  231. package/src/activities/agent-turn/prompt-tool-availability.ts +27 -0
  232. package/src/activities/agent-turn/provider-dispatch-barrier.ts +22 -0
  233. package/src/activities/agent-turn/provider-recovery-copy.ts +76 -0
  234. package/src/activities/agent-turn/provider-recovery-metrics.ts +64 -0
  235. package/src/activities/agent-turn/provider-recovery-policy.ts +25 -0
  236. package/src/activities/agent-turn/quiescence.ts +7 -7
  237. package/src/activities/agent-turn/recovery-warning.ts +6 -8
  238. package/src/activities/agent-turn/refresh-credentials.ts +44 -0
  239. package/src/activities/agent-turn/run-credentials.ts +124 -76
  240. package/src/activities/agent-turn/run.ts +501 -112
  241. package/src/activities/agent-turn/sandbox-establish.ts +152 -75
  242. package/src/activities/agent-turn/sandbox-provision.ts +54 -1
  243. package/src/activities/agent-turn/sandbox-route.ts +4 -1
  244. package/src/activities/agent-turn/sandbox-runtime.ts +319 -11
  245. package/src/activities/agent-turn/secret-resolver.ts +155 -0
  246. package/src/activities/agent-turn/session-title.ts +177 -12
  247. package/src/activities/agent-turn/session-usage-custody.ts +170 -0
  248. package/src/activities/agent-turn/skill-checkout.ts +111 -24
  249. package/src/activities/agent-turn/skill-install.ts +1 -1
  250. package/src/activities/agent-turn/skill-read.ts +374 -28
  251. package/src/activities/agent-turn/skill-save.ts +35 -7
  252. package/src/activities/agent-turn/skill-search.ts +9 -0
  253. package/src/activities/agent-turn/skill-selection.ts +4 -0
  254. package/src/activities/agent-turn/skill-tools.ts +208 -21
  255. package/src/activities/agent-turn/skill-transfer.ts +68 -23
  256. package/src/activities/agent-turn/stream-attempt.ts +634 -111
  257. package/src/activities/agent-turn/subscription-capacity-arming.ts +81 -0
  258. package/src/activities/agent-turn/subscription-core-capacity.ts +439 -0
  259. package/src/activities/agent-turn/subscription-core-failover.ts +229 -0
  260. package/src/activities/agent-turn/subscription-core-placed.ts +37 -0
  261. package/src/activities/agent-turn/subscription-core-requests.ts +271 -0
  262. package/src/activities/agent-turn/subscription-core-settlement.ts +234 -0
  263. package/src/activities/agent-turn/subscription-lease.ts +140 -0
  264. package/src/activities/agent-turn/subscription-serving-capacity.ts +195 -0
  265. package/src/activities/agent-turn/subscription-serving-catalog.ts +71 -0
  266. package/src/activities/agent-turn/subscription-serving-claim.ts +178 -0
  267. package/src/activities/agent-turn/subscription-serving-providers.ts +15 -0
  268. package/src/activities/agent-turn/tool-environment.ts +384 -292
  269. package/src/activities/agent-turn/tool-policy.ts +104 -4
  270. package/src/activities/agent-turn/tool-result-spill.ts +1 -0
  271. package/src/activities/agent-turn/turn-context.ts +124 -8
  272. package/src/activities/agent-turn/web-search.ts +431 -0
  273. package/src/activities/agent-turn/xai-core.ts +301 -0
  274. package/src/activities/automations.ts +81 -6
  275. package/src/activities/browser-deadline-checkpoint.ts +297 -0
  276. package/src/activities/capabilities.ts +53 -213
  277. package/src/activities/codemode-dispatcher.ts +236 -14
  278. package/src/activities/codex-capacity.ts +27 -380
  279. package/src/activities/codex-image-generation.ts +252 -42
  280. package/src/activities/common.ts +12 -0
  281. package/src/activities/connector-attachments.ts +3 -1
  282. package/src/activities/context-compaction.ts +182 -21
  283. package/src/activities/environment.ts +18 -106
  284. package/src/activities/gmail-files.ts +108 -0
  285. package/src/activities/goals.ts +120 -204
  286. package/src/activities/image-generation-operation.ts +1 -1
  287. package/src/activities/incident-telemetry-authority.ts +80 -50
  288. package/src/activities/incident-telemetry-preflight.ts +27 -15
  289. package/src/activities/knowledge-indexing.ts +287 -17
  290. package/src/activities/knowledge-source-sync.ts +10 -0
  291. package/src/activities/mcp-account-routes.ts +2 -124
  292. package/src/activities/model-call-fact-reconciler.ts +112 -0
  293. package/src/activities/open-suffix-resume.ts +122 -88
  294. package/src/activities/parent-wake.ts +89 -21
  295. package/src/activities/programmatic-approvals.ts +26 -0
  296. package/src/activities/requester-unavailable-receipt.ts +14 -0
  297. package/src/activities/retained-screenshots.ts +135 -24
  298. package/src/activities/run-credential-renewal.ts +13 -1
  299. package/src/activities/run-credentials.ts +61 -19
  300. package/src/activities/run-input.ts +124 -9
  301. package/src/activities/sandbox-lease.ts +1615 -73
  302. package/src/activities/scheduled-tasks.ts +780 -147
  303. package/src/activities/session-archive.ts +382 -0
  304. package/src/activities/session-state.ts +219 -10
  305. package/src/activities/session-storage.ts +124 -0
  306. package/src/activities/site-auth-maintenance.ts +5 -2
  307. package/src/activities/subscription-core-claude-waits.ts +49 -0
  308. package/src/activities/subscription-core-codex-quota.ts +46 -0
  309. package/src/activities/subscription-core-codex-waits.ts +488 -0
  310. package/src/activities/subscription-core-image-operation.ts +126 -0
  311. package/src/activities/subscription-core-usage-recheck.ts +146 -0
  312. package/src/activities/subscription-core-wait-bindings.ts +12 -0
  313. package/src/activities/subscription-core-xai-quota.ts +85 -0
  314. package/src/activities/subscription-core-xai-waits.ts +48 -0
  315. package/src/activities/types.ts +85 -9
  316. package/src/activities/video-generation-admission.ts +1 -36
  317. package/src/activities/video-generation-credential.ts +38 -56
  318. package/src/activities/video-generation-reconciliation.ts +150 -131
  319. package/src/activities/video-generation-subscription-core.ts +180 -0
  320. package/src/activities/workspace-capture.ts +13 -2
  321. package/src/activities/workspace-credential-provider.ts +302 -0
  322. package/src/activities/xai-auth.ts +34 -112
  323. package/src/activities/xai-image-generation.ts +84 -36
  324. package/src/activities-control.ts +8 -0
  325. package/src/activities-turn.ts +5 -0
  326. package/src/activities.ts +17 -0
  327. package/src/activity-services.ts +29 -4
  328. package/src/browser-deadline-checkpoint-contract.ts +5 -0
  329. package/src/editable-artifact-hint-broker.ts +3 -0
  330. package/src/editable-artifact-materializer-service.ts +85 -39
  331. package/src/editable-artifact-materializer-subprocess.ts +47 -2
  332. package/src/editable-artifact-outbox-dispatcher.ts +107 -46
  333. package/src/editable-artifact-outbox-service.ts +55 -25
  334. package/src/github-rest-mcp.ts +1 -1
  335. package/src/host-export-pump.ts +26 -4
  336. package/src/host-export.ts +4 -1
  337. package/src/http.ts +4 -2
  338. package/src/index.ts +222 -282
  339. package/src/internal-maintenance.ts +347 -0
  340. package/src/maintenance-cadence.ts +156 -0
  341. package/src/observability-metrics.ts +1173 -73
  342. package/src/onepassword-vault-provider.ts +11 -0
  343. package/src/personal-github-git-credentials.ts +3 -1
  344. package/src/pr-review-credentials.ts +1 -1
  345. package/src/readiness-checks.ts +113 -0
  346. package/src/retained-process-retry.ts +36 -0
  347. package/src/sandbox-reaper-contract.ts +33 -0
  348. package/src/sandbox-resume.ts +444 -73
  349. package/src/sandbox-routing.ts +230 -75
  350. package/src/session-event-fanout.ts +23 -0
  351. package/src/telemetry-scheduler.ts +53 -0
  352. package/src/temporal-runtime-logger.ts +44 -0
  353. package/src/turn-task-queue-reader.ts +110 -0
  354. package/src/turn-worker-activity-telemetry.ts +209 -0
  355. package/src/worker-service-lifecycle.ts +54 -1
  356. package/src/workflows/activities.ts +16 -1
  357. package/src/workflows/browser-deadline-checkpoint.ts +55 -0
  358. package/src/workflows/file-upload-reaper.ts +2 -0
  359. package/src/workflows/sandbox-reaper.ts +88 -0
  360. package/src/workflows/scheduled-tasks.ts +26 -13
  361. package/src/workflows/session-storage.ts +19 -0
  362. package/src/workflows/session.ts +238 -33
  363. package/src/workflows/site-auth-maintenance.ts +2 -1
  364. package/src/workflows/workflow-wake.ts +26 -4
  365. package/src/workflows.ts +7 -0
  366. package/dist/activities/agent-turn/xai-capacity.d.ts +0 -2
  367. package/dist/activities/codex-fleet-shadow.d.ts +0 -74
  368. package/dist/activities/codex-rotation.d.ts +0 -200
  369. package/dist/activities/xai-quota.d.ts +0 -3
  370. package/dist/activities-control-QA6OLRQY.js.map +0 -1
  371. package/dist/activities-turn-YVVKCGAK.js.map +0 -1
  372. package/dist/chunk-GDCLDKSH.js.map +0 -1
  373. package/dist/chunk-I7HKKMUJ.js.map +0 -1
  374. package/dist/chunk-M3NVMF2V.js.map +0 -1
  375. package/dist/chunk-RAMNYSAW.js.map +0 -1
  376. package/src/activities/agent-turn/xai-capacity.ts +0 -257
  377. package/src/activities/codex-fleet-shadow.ts +0 -306
  378. package/src/activities/codex-rotation.ts +0 -685
  379. package/src/activities/xai-quota.ts +0 -35
@@ -0,0 +1,488 @@
1
+ /**
2
+ * Durable capacity waits and wakes for Codex chat turns on the shared
3
+ * subscription core (M3 PR 2a, inventory EP-T09/T10). Reached only for an
4
+ * account whose Codex cutover row is enabled; the legacy Codex waiter path is
5
+ * untouched. Workflow activity names, signal names and argument shapes stay
6
+ * those of the legacy Codex wait: the activities look a waiter id up in the
7
+ * core table first and fall back to the legacy table.
8
+ *
9
+ * The wait, wake and reconcile steps are provider-neutral (SuperGrok track
10
+ * X1b): a `CoreWaitBinding` supplies one provider's database entry points.
11
+ * The Codex-named functions are Codex's bindings and are unchanged.
12
+ */
13
+ import {
14
+ abandonSubscriptionCapacityWakeDelivery,
15
+ armSubscriptionCoreCodexCapacityWait,
16
+ claimSubscriptionCapacityWakeDeliveries,
17
+ evaluateSubscriptionCoreCodexPlacement,
18
+ evaluateSubscriptionCorePlacementWithFailover,
19
+ getSession,
20
+ getSessionTurn,
21
+ getSubscriptionCoreCodexCapacityWaitById,
22
+ markSubscriptionCapacityWakeDelivered,
23
+ readSubscriptionCoreCodexTurnModel,
24
+ readSubscriptionCoreTurnIdentity,
25
+ reconcileSubscriptionCoreCodexCapacityWait,
26
+ recoverSubscriptionCoreCodexConnectionHealth,
27
+ retrySubscriptionCapacityWakeDelivery,
28
+ subscriptionCoreCodexCapacityWaitRef,
29
+ subscriptionCoreProvider,
30
+ wakeSubscriptionCoreCodexCapacityWaiters,
31
+ withSubscriptionCapacityWakeOutboxScope,
32
+ withSubscriptionCoreAcceptedTurn,
33
+ type Database,
34
+ type SubscriptionCoreCodexCapacityWait,
35
+ type SubscriptionCoreCodexWaitEvaluation,
36
+ type SubscriptionCoreCodexWakeScope,
37
+ type SubscriptionCoreCodexPlacementEvaluation,
38
+ type SubscriptionCoreTurnIdentity,
39
+ type SubscriptionCoreWaiterProvider,
40
+ } from "@opengeni/db";
41
+ import { publishDurableSessionEvents, type EventBus } from "@opengeni/events";
42
+ import type { Settings } from "@opengeni/config";
43
+ import { readTurnExecutionPolicyV1 } from "@opengeni/contracts";
44
+ import { servingCatalogForBlockedTurn } from "./agent-turn/subscription-serving-catalog";
45
+ import { refreshExhaustedCodexCoreQuota } from "./subscription-core-codex-quota";
46
+ import { subscriptionCoreWaitBindings } from "./subscription-core-wait-bindings";
47
+ import type { CodexCapacityWaitRef, SignalCodexCapacityWorkflow } from "./types";
48
+ import { workflowIdForSession } from "./common";
49
+
50
+ /** Typed wake signal attempts before the outbox gives the fast path up. */
51
+ export const CORE_CODEX_WAKE_DELIVERY_MAX_ATTEMPTS = 8;
52
+ const CORE_CODEX_WAKE_DELIVERY_BATCH = 100;
53
+ const CORE_CODEX_WAKE_CLAIM_TTL_MS = 60_000;
54
+
55
+ /** Exponential retry for one typed wake signal: 1 s doubling to 5 minutes. */
56
+ export function coreCodexWakeRetryDelayMs(attemptCount: number): number {
57
+ const exponent = Math.max(0, Math.min(attemptCount - 1, 16));
58
+ return Math.min(1_000 * 2 ** exponent, 5 * 60_000);
59
+ }
60
+
61
+ export type CoreCodexWakeServices = {
62
+ db: Database;
63
+ settings?: Settings;
64
+ signalCodexCapacityWorkflow?: SignalCodexCapacityWorkflow | null | undefined;
65
+ };
66
+
67
+ /** One provider's database entry points for its core waiters. */
68
+ export type CoreWaitBinding = {
69
+ provider: SubscriptionCoreWaiterProvider;
70
+ arm: typeof armSubscriptionCoreCodexCapacityWait;
71
+ getWaiterById: (
72
+ db: Database,
73
+ input: { workspaceId: string; sessionId: string; waiterId: string },
74
+ ) => Promise<SubscriptionCoreCodexCapacityWait | null>;
75
+ readTurnModel: typeof readSubscriptionCoreCodexTurnModel;
76
+ recoverHealth: (db: Database, identity: SubscriptionCoreTurnIdentity) => Promise<number>;
77
+ evaluatePlacement: (
78
+ db: Database,
79
+ request: {
80
+ identity: SubscriptionCoreTurnIdentity;
81
+ productModelId: string;
82
+ reasoningLevel: string;
83
+ },
84
+ ) => Promise<SubscriptionCoreCodexPlacementEvaluation>;
85
+ wakeWaiters: (
86
+ db: Database,
87
+ input: { accountId: string; reason: string; workspaceIds?: readonly string[] },
88
+ ) => Promise<SubscriptionCoreCodexWakeScope[]>;
89
+ reconcileWaiter: typeof reconcileSubscriptionCoreCodexCapacityWait;
90
+ /**
91
+ * Re-read the provider's usage before a timed or woken reconcile evaluates
92
+ * placement, for a provider whose usage read can end an exhaustion before
93
+ * its stored reset (its waiters then recheck on a bounded backoff), under
94
+ * the parked turn's exact accepted identity (the same read placement
95
+ * evaluation uses; never called without one). Best effort: a failure
96
+ * leaves the stored state, and placement decides.
97
+ */
98
+ refreshBeforeReconcile?: (
99
+ services: { db: Database; settings: Settings },
100
+ turn: SubscriptionCoreTurnIdentity,
101
+ ) => Promise<void>;
102
+ };
103
+
104
+ /** Codex's binding (each call resolves the Codex-named entry point at call time). */
105
+ export const CODEX_CORE_WAIT_BINDING: CoreWaitBinding = {
106
+ provider: "codex",
107
+ arm: (db, input) => armSubscriptionCoreCodexCapacityWait(db, input),
108
+ getWaiterById: (db, input) => getSubscriptionCoreCodexCapacityWaitById(db, input),
109
+ readTurnModel: (db, input) => readSubscriptionCoreCodexTurnModel(db, input),
110
+ recoverHealth: (db, identity) => recoverSubscriptionCoreCodexConnectionHealth(db, identity),
111
+ evaluatePlacement: (db, request) => evaluateSubscriptionCoreCodexPlacement(db, request),
112
+ wakeWaiters: (db, input) => wakeSubscriptionCoreCodexCapacityWaiters(db, input),
113
+ reconcileWaiter: (db, input) => reconcileSubscriptionCoreCodexCapacityWait(db, input),
114
+ // OpenAI can reset a Codex limit before the reset it reported, so a parked
115
+ // turn re-reads `/wham/usage` (rate-limited per connection) at each bounded
116
+ // recheck instead of sleeping until a stale reset.
117
+ refreshBeforeReconcile: ({ db, settings }, turn) =>
118
+ refreshExhaustedCodexCoreQuota({
119
+ db,
120
+ settings,
121
+ accountId: turn.accountId,
122
+ workspaceId: turn.workspaceId,
123
+ personalTurn: turn,
124
+ }),
125
+ };
126
+
127
+ export type CoreCodexWakeDeliveryResult = {
128
+ claimed: number;
129
+ delivered: number;
130
+ retried: number;
131
+ abandoned: number;
132
+ };
133
+
134
+ /**
135
+ * Drain one workspace's due typed wake obligations: claim (fenced by claim
136
+ * generation), signal `codexCapacityChanged` with the waiter's wake revision,
137
+ * then mark delivered; a failed signal is retried with bounded backoff and
138
+ * given up after a fixed number of attempts. Idempotent across a crash
139
+ * between the database wake and the signal: an unacknowledged claim becomes
140
+ * due again when its claim expires, and the generic session workflow wake
141
+ * committed with the same database wake still reaches the workflow.
142
+ */
143
+ export async function deliverSubscriptionCoreCodexWakes(
144
+ services: CoreCodexWakeServices,
145
+ scope: SubscriptionCoreCodexWakeScope,
146
+ ): Promise<CoreCodexWakeDeliveryResult> {
147
+ const result: CoreCodexWakeDeliveryResult = {
148
+ claimed: 0,
149
+ delivered: 0,
150
+ retried: 0,
151
+ abandoned: 0,
152
+ };
153
+ const signal = services.signalCodexCapacityWorkflow;
154
+ // A host without a typed signaler claims nothing: the rows stay pending for
155
+ // a worker that can signal (the generic durable wake committed with each
156
+ // row still reaches the workflow meanwhile).
157
+ if (!signal) return result;
158
+ const deliveries = await withSubscriptionCapacityWakeOutboxScope(services.db, scope, (tx) =>
159
+ claimSubscriptionCapacityWakeDeliveries(tx, {
160
+ limit: CORE_CODEX_WAKE_DELIVERY_BATCH,
161
+ claimTtlMs: CORE_CODEX_WAKE_CLAIM_TTL_MS,
162
+ }),
163
+ );
164
+ result.claimed = deliveries.length;
165
+ for (const delivery of deliveries) {
166
+ try {
167
+ await signal({
168
+ accountId: delivery.accountId,
169
+ workspaceId: delivery.workspaceId,
170
+ sessionId: delivery.sessionId,
171
+ workflowId: workflowIdForSession(delivery.sessionId),
172
+ wakeRevision: delivery.wakeRevision,
173
+ });
174
+ await withSubscriptionCapacityWakeOutboxScope(services.db, scope, (tx) =>
175
+ markSubscriptionCapacityWakeDelivered(tx, delivery),
176
+ );
177
+ result.delivered += 1;
178
+ } catch {
179
+ const exhausted = delivery.attemptCount >= CORE_CODEX_WAKE_DELIVERY_MAX_ATTEMPTS;
180
+ await withSubscriptionCapacityWakeOutboxScope(services.db, scope, (tx) =>
181
+ exhausted
182
+ ? abandonSubscriptionCapacityWakeDelivery(tx, {
183
+ id: delivery.id,
184
+ claimGeneration: delivery.claimGeneration,
185
+ failureCode: "signal_attempts_exhausted",
186
+ })
187
+ : retrySubscriptionCapacityWakeDelivery(tx, {
188
+ id: delivery.id,
189
+ claimGeneration: delivery.claimGeneration,
190
+ retryInMs: coreCodexWakeRetryDelayMs(delivery.attemptCount),
191
+ failureCode: "signal_failed",
192
+ }),
193
+ ).catch(() => false);
194
+ if (exhausted) result.abandoned += 1;
195
+ else result.retried += 1;
196
+ }
197
+ }
198
+ return result;
199
+ }
200
+
201
+ /**
202
+ * A capacity change for the account's Codex pool: wake every waiting core
203
+ * waiter (database first, outbox and generic wake in the same commit), then
204
+ * deliver the typed signals. Best effort after the commit; never throws.
205
+ */
206
+ export async function wakeSubscriptionCoreCodexWaitersAndDeliver(
207
+ services: CoreCodexWakeServices,
208
+ input: { accountId: string; reason: string; workspaceIds?: readonly string[] },
209
+ ): Promise<SubscriptionCoreCodexWakeScope[]> {
210
+ return await wakeSubscriptionCoreWaitersAndDeliver(services, CODEX_CORE_WAIT_BINDING, input);
211
+ }
212
+
213
+ /** The same wake for any provider's core waiters. */
214
+ export async function wakeSubscriptionCoreWaitersAndDeliver(
215
+ services: CoreCodexWakeServices,
216
+ binding: Pick<CoreWaitBinding, "wakeWaiters">,
217
+ input: { accountId: string; reason: string; workspaceIds?: readonly string[] },
218
+ ): Promise<SubscriptionCoreCodexWakeScope[]> {
219
+ let scopes: SubscriptionCoreCodexWakeScope[] = [];
220
+ try {
221
+ scopes = await binding.wakeWaiters(services.db, input);
222
+ } catch {
223
+ return [];
224
+ }
225
+ await Promise.allSettled(
226
+ scopes.map((scope) => deliverSubscriptionCoreCodexWakes(services, scope)),
227
+ );
228
+ return scopes;
229
+ }
230
+
231
+ /**
232
+ * What core placement says about a blocked turn now: run, wait (with its
233
+ * reason, earliest reset and quarantine end), revoked (the exact accepted
234
+ * turn no longer authorizes core use) or paused (the cutover is switched off;
235
+ * the work stays parked). Due quarantines are returned to service first, and
236
+ * a recovery wakes the account's other waiters.
237
+ */
238
+ export async function evaluateCoreCodexBlockedTurn(
239
+ services: CoreCodexWakeServices,
240
+ input: { accountId: string; workspaceId: string; sessionId: string; turnId: string },
241
+ ): Promise<SubscriptionCoreCodexWaitEvaluation> {
242
+ return await evaluateCoreBlockedTurn(services, CODEX_CORE_WAIT_BINDING, input);
243
+ }
244
+
245
+ /** The same evaluation for any provider's blocked turn. */
246
+ export async function evaluateCoreBlockedTurn(
247
+ services: CoreCodexWakeServices,
248
+ binding: CoreWaitBinding,
249
+ input: { accountId: string; workspaceId: string; sessionId: string; turnId: string },
250
+ ): Promise<SubscriptionCoreCodexWaitEvaluation> {
251
+ const identity = await readSubscriptionCoreTurnIdentity(services.db, input);
252
+ if (!identity) return { kind: "revoked" };
253
+ const model = await binding.readTurnModel(services.db, input);
254
+ if (!model) return { kind: "revoked" };
255
+ await recoverCoreHealthAndWake(services, binding, identity);
256
+ const failover = await evaluateFailoverBlockedTurn(services, binding, identity, model);
257
+ if (failover) return failover;
258
+ const evaluation = await binding.evaluatePlacement(services.db, {
259
+ identity,
260
+ productModelId: model.productModelId,
261
+ reasoningLevel: model.reasoningLevel,
262
+ });
263
+ switch (evaluation.kind) {
264
+ case "not_visible":
265
+ return { kind: "revoked" };
266
+ case "cutover_not_enabled":
267
+ return { kind: "paused" };
268
+ case "run":
269
+ return { kind: "run" };
270
+ case "wait":
271
+ return {
272
+ kind: "wait",
273
+ waitReason: evaluation.reason,
274
+ earliestResetAt: evaluation.earliestResetAt,
275
+ healthRetryAt: evaluation.healthRetryAt,
276
+ };
277
+ }
278
+ }
279
+
280
+ /** Fresh accepted policy + current readiness/settings decide the whole pool.
281
+ * Stored waiter candidates are deliberately not an input to this evaluator.
282
+ * A wake grants no credentials: the resumed attempt still claims and leases.
283
+ */
284
+ async function evaluateFailoverBlockedTurn(
285
+ services: CoreCodexWakeServices,
286
+ home: CoreWaitBinding,
287
+ identity: SubscriptionCoreTurnIdentity,
288
+ model: { productModelId: string; reasoningLevel: string },
289
+ ): Promise<SubscriptionCoreCodexWaitEvaluation | null> {
290
+ const settings = services.settings;
291
+ if (!settings?.subscriptionCrossProviderFailoverEnabled) return null;
292
+ const context = await withSubscriptionCoreAcceptedTurn(services.db, identity, async (tx) => {
293
+ const session = await getSession(tx, identity.workspaceId, identity.sessionId);
294
+ const turn = await getSessionTurn(tx, identity.workspaceId, identity.turnId);
295
+ if (!session || !turn || turn.sessionId !== identity.sessionId) return null;
296
+ const accepted = readTurnExecutionPolicyV1(turn.metadata);
297
+ return (
298
+ session.codexCompactionMode === "portable" &&
299
+ turn.source !== "compaction" &&
300
+ accepted.kind === "valid" &&
301
+ accepted.policy.credentialRestriction === undefined &&
302
+ accepted.policy.productModelId === model.productModelId
303
+ );
304
+ });
305
+ if (context.status !== "completed" || context.value === null) return { kind: "revoked" };
306
+ if (!context.value) return null;
307
+ const bindings = subscriptionCoreWaitBindings();
308
+ const models = await servingCatalogForBlockedTurn(
309
+ services.db,
310
+ settings,
311
+ identity,
312
+ model.productModelId,
313
+ bindings.map((binding) => binding.provider),
314
+ );
315
+ if (
316
+ !models.some(
317
+ (candidate) => candidate.id === model.productModelId && candidate.provider === home.provider,
318
+ )
319
+ )
320
+ return null;
321
+ const request = { identity, ...model, models, crossProviderFailoverEnabled: true };
322
+ let evaluation = await evaluateSubscriptionCorePlacementWithFailover(
323
+ services.db,
324
+ subscriptionCoreProvider(home.provider),
325
+ request,
326
+ );
327
+ // Only candidates derived by the live authority/policy evaluator can have
328
+ // their health or usage refreshed. Personal billing keeps the same accepted
329
+ // identity, including shared-session and frozen-background restrictions.
330
+ const candidates = new Set(evaluation.candidateProviders ?? []);
331
+ for (const binding of bindings) {
332
+ if (binding.provider === home.provider || !candidates.has(binding.provider)) continue;
333
+ await recoverCoreHealthAndWake(services, binding, identity);
334
+ await binding
335
+ .refreshBeforeReconcile?.({ db: services.db, settings }, identity)
336
+ .catch(() => undefined);
337
+ }
338
+ if ([...candidates].some((provider) => provider !== home.provider)) {
339
+ evaluation = await evaluateSubscriptionCorePlacementWithFailover(
340
+ services.db,
341
+ subscriptionCoreProvider(home.provider),
342
+ request,
343
+ );
344
+ }
345
+ switch (evaluation.kind) {
346
+ case "not_visible":
347
+ return { kind: "revoked" };
348
+ case "cutover_not_enabled":
349
+ return { kind: "paused" };
350
+ case "run":
351
+ return { kind: "run", candidateProviders: evaluation.candidateProviders ?? [] };
352
+ case "wait":
353
+ // Leave the capacity wait once to surface the actionable configuration
354
+ // failure at claim. This is not a capacity/authority grant, and does not
355
+ // fabricate a provider or strand work behind an unrelated quota reset.
356
+ if (evaluation.reason === "failover_no_model_mapping")
357
+ return { kind: "run", candidateProviders: [] };
358
+ return {
359
+ kind: "wait",
360
+ waitReason: evaluation.reason,
361
+ earliestResetAt: evaluation.earliestResetAt,
362
+ healthRetryAt: evaluation.healthRetryAt,
363
+ candidateProviders: evaluation.candidateProviders ?? [],
364
+ };
365
+ }
366
+ }
367
+
368
+ /** Return due quarantines to service under this accepted turn; wake others if any recovered. */
369
+ export async function recoverCoreCodexHealthAndWake(
370
+ services: CoreCodexWakeServices,
371
+ identity: SubscriptionCoreTurnIdentity,
372
+ ): Promise<number> {
373
+ return await recoverCoreHealthAndWake(services, CODEX_CORE_WAIT_BINDING, identity);
374
+ }
375
+
376
+ /** The same recovery for any provider's connections. */
377
+ export async function recoverCoreHealthAndWake(
378
+ services: CoreCodexWakeServices,
379
+ binding: Pick<CoreWaitBinding, "recoverHealth" | "wakeWaiters">,
380
+ identity: SubscriptionCoreTurnIdentity,
381
+ ): Promise<number> {
382
+ const recovered = await binding.recoverHealth(services.db, identity).catch(() => 0);
383
+ if (recovered > 0) {
384
+ await wakeSubscriptionCoreWaitersAndDeliver(services, binding, {
385
+ accountId: identity.accountId,
386
+ reason: "connection_health_recovered",
387
+ });
388
+ }
389
+ return recovered;
390
+ }
391
+
392
+ export type CoreCodexReconcileResult =
393
+ | ({ action: "waiting" } & CodexCapacityWaitRef)
394
+ | { action: "resumed" | "paused" | "superseded" | "stale" };
395
+
396
+ /**
397
+ * Reconcile one core waiter for the workflow (timer, signal, queue wake or
398
+ * recovery). Returns null when the waiter id is not a core waiter, so the
399
+ * caller falls back to the legacy Codex waiter with the same reference.
400
+ */
401
+ export async function reconcileCoreCodexCapacityWait(
402
+ services: CoreCodexWakeServices & { bus: EventBus },
403
+ input: {
404
+ accountId: string;
405
+ workspaceId: string;
406
+ sessionId: string;
407
+ waiterId: string;
408
+ generation: number;
409
+ },
410
+ ): Promise<CoreCodexReconcileResult | null> {
411
+ return await reconcileCoreCapacityWait(services, CODEX_CORE_WAIT_BINDING, input);
412
+ }
413
+
414
+ /**
415
+ * The same reconcile for any provider: the waiter is looked up by the exact
416
+ * id and generation the workflow recorded. Null when the id names no core
417
+ * waiter of the binding's provider.
418
+ */
419
+ export async function reconcileCoreCapacityWait(
420
+ services: CoreCodexWakeServices & {
421
+ bus: EventBus;
422
+ /** Present on the workflow's reconcile; the in-turn arm has just placed. */
423
+ settings?: Settings;
424
+ },
425
+ binding: CoreWaitBinding,
426
+ input: {
427
+ accountId: string;
428
+ workspaceId: string;
429
+ sessionId: string;
430
+ waiterId: string;
431
+ generation: number;
432
+ },
433
+ ): Promise<CoreCodexReconcileResult | null> {
434
+ let waiter = await binding.getWaiterById(services.db, input);
435
+ if (!waiter) return null;
436
+ // Repair: drain this workspace's typed wakes that a crash left behind.
437
+ await deliverSubscriptionCoreCodexWakes(services, {
438
+ accountId: input.accountId,
439
+ workspaceId: input.workspaceId,
440
+ }).catch(() => undefined);
441
+ if (waiter.accountId !== input.accountId || waiter.generation !== input.generation) {
442
+ return { action: "stale" };
443
+ }
444
+ if (binding.refreshBeforeReconcile && services.settings && waiter.blockedTurnLive !== false) {
445
+ const turn = await readSubscriptionCoreTurnIdentity(services.db, {
446
+ accountId: input.accountId,
447
+ workspaceId: input.workspaceId,
448
+ sessionId: input.sessionId,
449
+ turnId: waiter.blockedTurnId,
450
+ });
451
+ // Without the exact accepted identity the evaluation below revokes.
452
+ if (turn) {
453
+ await binding
454
+ .refreshBeforeReconcile({ db: services.db, settings: services.settings }, turn)
455
+ .catch(() => undefined);
456
+ }
457
+ // A recovery the re-read found woke this waiter: evaluate at that revision.
458
+ waiter = await binding.getWaiterById(services.db, input);
459
+ if (!waiter || waiter.accountId !== input.accountId || waiter.generation !== input.generation)
460
+ return { action: "stale" };
461
+ }
462
+ // A row left behind by a Steer, Cancel or other transition is superseded by
463
+ // the reconcile without placing (a non-run evaluation never resumes).
464
+ const evaluation: SubscriptionCoreCodexWaitEvaluation =
465
+ waiter.blockedTurnLive === false
466
+ ? { kind: "paused" }
467
+ : await evaluateCoreBlockedTurn(services, binding, {
468
+ accountId: input.accountId,
469
+ workspaceId: input.workspaceId,
470
+ sessionId: input.sessionId,
471
+ turnId: waiter.blockedTurnId,
472
+ });
473
+ const result = await binding.reconcileWaiter(services.db, {
474
+ ...input,
475
+ evaluatedWakeRevision: waiter.wakeRevision,
476
+ evaluation,
477
+ });
478
+ await publishDurableSessionEvents(
479
+ services.bus,
480
+ input.workspaceId,
481
+ input.sessionId,
482
+ result.events,
483
+ );
484
+ if (result.action === "waiting") {
485
+ return { action: "waiting", ...subscriptionCoreCodexCapacityWaitRef(result.waiter) };
486
+ }
487
+ return { action: result.action };
488
+ }
@@ -0,0 +1,126 @@
1
+ /**
2
+ * A turn's image operation on the shared subscription core, for any
3
+ * provider whose image client takes a custody fetch (design 5.3, EP-N09 and
4
+ * EP-N10; the Codex image path, M3 PR 2c, keeps its own dispatch hooks).
5
+ *
6
+ * It runs on the turn's own placed connection under the accepted turn's
7
+ * authority, with its own `image` operation lease keyed by the ledger's
8
+ * operation id, the bearer from the core connection seam (refresh only
9
+ * under the core lock) and every physical request through the core's
10
+ * request custody. The chat-turn lease is checked, never taken, and the
11
+ * session binding is never read or written.
12
+ *
13
+ * Anything that stops the operation before its first request reached the
14
+ * provider (the chat lease or the operation lease is gone, the bearer
15
+ * cannot be read or mapped to the provider client's bearer) is a
16
+ * `SubscriptionCoreImageDispatchRejected`: the ledger returns the operation
17
+ * to `prepared` instead of `outcome_unknown`.
18
+ */
19
+ import { createHash } from "node:crypto";
20
+ import type { Settings } from "@opengeni/config";
21
+ import {
22
+ subscriptionCoreOperationConnections,
23
+ type Database,
24
+ type SubscriptionCoreConnectionToken,
25
+ type SubscriptionCoreFetch,
26
+ type SubscriptionCoreProvider,
27
+ type SubscriptionCoreTurnIdentity,
28
+ } from "@opengeni/db";
29
+
30
+ /** Verified: nothing reached the provider. */
31
+ export class SubscriptionCoreImageDispatchRejected extends Error {
32
+ constructor() {
33
+ super("The image operation could not start on its subscription connection");
34
+ this.name = "SubscriptionCoreImageDispatchRejected";
35
+ }
36
+ }
37
+
38
+ export async function runSubscriptionCoreImageOperation<T, Bearer>(
39
+ input: {
40
+ db: Database;
41
+ settings: Settings;
42
+ provider: SubscriptionCoreProvider;
43
+ identity: SubscriptionCoreTurnIdentity;
44
+ connectionId: string;
45
+ attemptId: string;
46
+ executionGeneration: number;
47
+ /** The image ledger's operation id (keys the operation lease). */
48
+ operationId: string;
49
+ toolCallId: string;
50
+ /** The turn's chat-lease dispatch fence: the live attempt still holds the chat lease. */
51
+ assertChatLease: () => Promise<void>;
52
+ /** Maps the core token to the provider client's bearer (inside the pre-dispatch guard). */
53
+ bearer: (token: SubscriptionCoreConnectionToken) => Bearer;
54
+ fetchImpl?: SubscriptionCoreFetch;
55
+ },
56
+ generate: (operation: {
57
+ auth: { getToken: () => Promise<Bearer>; refresh: () => Promise<Bearer> };
58
+ fetch: SubscriptionCoreFetch;
59
+ }) => Promise<T>,
60
+ ): Promise<T> {
61
+ // Requests that reached the transport, after the core's custody reservation
62
+ // committed (a 401 generated nothing). Until one did, every failure is a
63
+ // verified pre-dispatch rejection.
64
+ let dispatched = 0;
65
+ const transport = input.fetchImpl ?? fetch;
66
+ const countedTransport: SubscriptionCoreFetch = async (url, init) => {
67
+ dispatched += 1;
68
+ const response = await transport(url, init);
69
+ if (response.status === 401) dispatched -= 1;
70
+ return response;
71
+ };
72
+ const beforeDispatch = async <R>(step: () => Promise<R>): Promise<R> => {
73
+ let result: R;
74
+ try {
75
+ result = await step();
76
+ } catch {
77
+ if (dispatched === 0) throw new SubscriptionCoreImageDispatchRejected();
78
+ throw new Error("The image operation lost its subscription lease");
79
+ }
80
+ if (result === false) {
81
+ if (dispatched === 0) throw new SubscriptionCoreImageDispatchRejected();
82
+ throw new Error("The image operation lost its subscription lease");
83
+ }
84
+ return result;
85
+ };
86
+ await beforeDispatch(input.assertChatLease);
87
+ let ran: { kind: "ran"; value: T } | { kind: "unavailable" };
88
+ try {
89
+ ran = await subscriptionCoreOperationConnections(input.provider).runSubscriptionCoreOperation(
90
+ input.db,
91
+ input.settings,
92
+ { kind: "turn", identity: input.identity },
93
+ {
94
+ candidates: [input.connectionId],
95
+ operationKind: "image",
96
+ operationId: input.operationId,
97
+ attemptId: input.attemptId,
98
+ generation: input.executionGeneration,
99
+ // Bounded (the column allows 256 characters): tool-call ids are provider-supplied.
100
+ holderId: `image:${createHash("sha256").update(`${input.attemptId}\0${input.toolCallId}`).digest("hex")}`,
101
+ fetchImpl: countedTransport,
102
+ },
103
+ async ({ resolver, fetch: custody, fence }) =>
104
+ await generate({
105
+ auth: {
106
+ getToken: () => beforeDispatch(async () => input.bearer(await resolver.getToken())),
107
+ refresh: () => beforeDispatch(async () => input.bearer(await resolver.refresh())),
108
+ },
109
+ fetch: async (url, init) => {
110
+ await beforeDispatch(input.assertChatLease);
111
+ await beforeDispatch(fence);
112
+ return await custody(url, init);
113
+ },
114
+ }),
115
+ );
116
+ } catch (error) {
117
+ // Lease acquisition, a refused custody reservation, or anything else
118
+ // before the first request reached the transport: nothing was sent.
119
+ if (dispatched === 0 && !(error instanceof SubscriptionCoreImageDispatchRejected)) {
120
+ throw new SubscriptionCoreImageDispatchRejected();
121
+ }
122
+ throw error;
123
+ }
124
+ if (ran.kind === "unavailable") throw new SubscriptionCoreImageDispatchRejected();
125
+ return ran.value;
126
+ }