@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
@@ -12,6 +12,9 @@ function createTurnActivityServices(
12
12
  let servicesPromise: Promise<TurnActivityServices> | null = null;
13
13
  return async () => {
14
14
  servicesPromise ??= (async () => {
15
+ if (!dependencies.requestWorkerDrain) {
16
+ throw new Error("Turn activities require a host requestWorkerDrain lifecycle edge");
17
+ }
15
18
  const services = await shared();
16
19
  return {
17
20
  ...services,
@@ -20,6 +23,8 @@ function createTurnActivityServices(
20
23
  createProductionAgentRuntime({
21
24
  metrics: runtimeMetricsHooksForObservability(services.observability),
22
25
  }),
26
+ requestWorkerDrain: dependencies.requestWorkerDrain,
27
+ turnFinalizationTimeoutMs: dependencies.turnFinalizationTimeoutMs,
23
28
  summarizeContextForCompaction:
24
29
  dependencies.summarizeContextForCompaction ?? summarizeForCompaction,
25
30
  };
package/src/activities.ts CHANGED
@@ -69,6 +69,12 @@ export function createActivityTestHarness(dependencies: ActivityDependencies = {
69
69
  createProductionAgentRuntime({
70
70
  metrics: runtimeMetricsHooksForObservability(common.observability),
71
71
  }),
72
+ requestWorkerDrain:
73
+ dependencies.requestWorkerDrain ??
74
+ (() => {
75
+ throw new Error("Test host must provide requestWorkerDrain for stalled cleanup");
76
+ }),
77
+ turnFinalizationTimeoutMs: dependencies.turnFinalizationTimeoutMs,
72
78
  summarizeContextForCompaction:
73
79
  dependencies.summarizeContextForCompaction ?? summarizeForCompaction,
74
80
  documentServices: dependencies.documentServices ?? createDocumentServices(common.settings),
@@ -99,6 +105,8 @@ export const persistSessionAttemptQuiescence =
99
105
  defaultControlActivities.persistSessionAttemptQuiescence;
100
106
  export const reconcileSessionAttemptQuiescence =
101
107
  defaultControlActivities.reconcileSessionAttemptQuiescence;
108
+ export const reconcileSettledSessionAttempt =
109
+ defaultControlActivities.reconcileSettledSessionAttempt;
102
110
  export const recoverDispatch = defaultControlActivities.recoverDispatch;
103
111
  export const recoverEscapedMcpTimeout = defaultControlActivities.recoverEscapedMcpTimeout;
104
112
  export const peekSessionWork = defaultControlActivities.peekSessionWork;
@@ -106,6 +114,7 @@ export const settleSessionInputWait = defaultControlActivities.settleSessionInpu
106
114
  export const expireSessionHumanInput = defaultControlActivities.expireSessionHumanInput;
107
115
  export const expireSessionInteractionIntervention =
108
116
  defaultControlActivities.expireSessionInteractionIntervention;
117
+ export const expireScheduledRunHumanWait = defaultControlActivities.expireScheduledRunHumanWait;
109
118
  export const markSessionIdle = defaultControlActivities.markSessionIdle;
110
119
  export const dispatchScheduledTaskRun = defaultControlActivities.dispatchScheduledTaskRun;
111
120
  export const dispatchAutomationRun = defaultControlActivities.dispatchAutomationRun;
@@ -116,14 +125,22 @@ export const maybeContinueGoal = defaultControlActivities.maybeContinueGoal;
116
125
  export const getCodexCapacityWait = defaultControlActivities.getCodexCapacityWait;
117
126
  export const reconcileCodexCapacityWait = defaultControlActivities.reconcileCodexCapacityWait;
118
127
  export const prepareSandboxLeaseSweep = defaultControlActivities.prepareSandboxLeaseSweep;
128
+ export const listDueBrowserCheckpoints = defaultControlActivities.listDueBrowserCheckpoints;
129
+ export const checkpointBrowserBeforeDeadline =
130
+ defaultControlActivities.checkpointBrowserBeforeDeadline;
119
131
  export const drainSandboxLease = defaultControlActivities.drainSandboxLease;
132
+ export const listIdleSandboxCheckpoints = defaultControlActivities.listIdleSandboxCheckpoints;
133
+ export const checkpointIdleSandboxLease = defaultControlActivities.checkpointIdleSandboxLease;
120
134
  export const maintainSandboxLeaseSweep = defaultControlActivities.maintainSandboxLeaseSweep;
121
135
  export const reapSandboxLeases = defaultControlActivities.reapSandboxLeases;
122
136
  export const reapExpiredFileUploads = defaultControlActivities.reapExpiredFileUploads;
137
+ export const maintainSessionStorage = defaultControlActivities.maintainSessionStorage;
138
+ export const archiveIdleSessions = defaultControlActivities.archiveIdleSessions;
123
139
  export const recoverVideoGenerationWorkflows =
124
140
  defaultControlActivities.recoverVideoGenerationWorkflows;
125
141
  export const maintainRetainedScreenshots = defaultControlActivities.maintainRetainedScreenshots;
126
142
  export const maintainBrowserStateArtifacts = defaultControlActivities.maintainBrowserStateArtifacts;
143
+ export const reconcileRecentModelCallFacts = defaultControlActivities.reconcileRecentModelCallFacts;
127
144
  export const maintainSiteAuthConnections = defaultControlActivities.maintainSiteAuthConnections;
128
145
  export const dispatchSessionWorkflowWakes = defaultControlActivities.dispatchSessionWorkflowWakes;
129
146
  export const verifyRigChange = defaultControlActivities.verifyRigChange;
@@ -1,13 +1,24 @@
1
- import { dbSearchPath, getSettings, resolveNatsControlPlaneAuth } from "@opengeni/config";
2
- import { configureChildLifecycleNotices, createDb } from "@opengeni/db";
1
+ import {
2
+ codeSearchDeploymentPolicy,
3
+ resolveWebSearchProvider,
4
+ dbSearchPath,
5
+ getSettings,
6
+ resolveNatsControlPlaneAuth,
7
+ } from "@opengeni/config";
8
+ import {
9
+ configureChildLifecycleNotices,
10
+ configureCodeSearchDeploymentPolicy,
11
+ createDb,
12
+ } from "@opengeni/db";
3
13
  import { createNatsEventBus } from "@opengeni/events";
4
14
  import { createObservability } from "@opengeni/observability";
5
15
  import { resolveCatalogSettings } from "@opengeni/core";
6
16
  import { createObjectStorage } from "@opengeni/storage";
7
17
  import type { ActivityDependencies, SharedActivityServices } from "./activities/types";
8
- import { observabilityEventLogger } from "./observability-metrics";
18
+ import { observabilityEventBusOptions } from "./observability-metrics";
9
19
  import { buildPersonalGitHubGitCredentials } from "./personal-github-git-credentials";
10
20
  import { createStandaloneConnectionCredentialsPort } from "./pr-review-credentials";
21
+ import { loadOnePasswordVaultProvider } from "./onepassword-vault-provider";
11
22
 
12
23
  /**
13
24
  * Build the dependency graph common to both worker roles exactly once.
@@ -40,6 +51,16 @@ export function createSharedActivityServices(
40
51
  // Child lifecycle notice producers are process-global in @opengeni/db;
41
52
  // install the boot-validated rollout flag once for this worker.
42
53
  configureChildLifecycleNotices({ enabled: settings.childLifecycleNoticesEnabled });
54
+ // Child, scheduled and automation sessions created here freeze their
55
+ // code_search decision from the same deployment policy as the API.
56
+ configureCodeSearchDeploymentPolicy(codeSearchDeploymentPolicy(settings));
57
+ // A named but unusable web search provider withholds the tools; say why.
58
+ const webSearchProvider = resolveWebSearchProvider(settings);
59
+ if (webSearchProvider.status === "invalid") {
60
+ observability.warn("web search provider is misconfigured; web_search stays off", {
61
+ reason: webSearchProvider.reason,
62
+ });
63
+ }
43
64
  return {
44
65
  settings: resolvedSettings,
45
66
  catalogSourceSettings: settings,
@@ -51,7 +72,7 @@ export function createSharedActivityServices(
51
72
  controlPlaneAuth
52
73
  ? { user: controlPlaneAuth.user, pass: controlPlaneAuth.password }
53
74
  : undefined,
54
- { logger: observabilityEventLogger(observability) },
75
+ observabilityEventBusOptions(observability),
55
76
  )),
56
77
  objectStorage: dependencies.objectStorage ?? createObjectStorage(settings),
57
78
  observability,
@@ -67,6 +88,10 @@ export function createSharedActivityServices(
67
88
  createStandaloneConnectionCredentialsPort(settings, db),
68
89
  personalGitHubCredentials:
69
90
  dependencies.personalGitHubCredentials ?? buildPersonalGitHubGitCredentials(db, settings),
91
+ onePasswordVaultProvider:
92
+ dependencies.onePasswordVaultProvider === undefined
93
+ ? loadOnePasswordVaultProvider
94
+ : dependencies.onePasswordVaultProvider,
70
95
  };
71
96
  })();
72
97
  return await servicesPromise;
@@ -0,0 +1,5 @@
1
+ export const BROWSER_DEADLINE_CHECKPOINT_SWEEP_ID = "opengeni-browser-deadline-checkpoints-v1";
2
+ const QUEUE_SUFFIX = "-browser-checkpoint-v1";
3
+ export function browserDeadlineCheckpointTaskQueue(base: string): string {
4
+ return base.endsWith(QUEUE_SUFFIX) ? base : `${base}${QUEUE_SUFFIX}`;
5
+ }
@@ -161,6 +161,9 @@ export async function connectEditableArtifactHintBroker(
161
161
  name,
162
162
  reconnect: true,
163
163
  maxReconnectAttempts: -1,
164
+ // Same policy as the event bus: a broker or auth-callout restart must not
165
+ // permanently close this connection after two identical auth errors.
166
+ ignoreAuthErrorAbort: true,
164
167
  reconnectTimeWait: 2_000,
165
168
  reconnectJitter: 1_000,
166
169
  reconnectJitterTLS: 1_000,
@@ -13,6 +13,16 @@ import { createObservability, type Observability } from "@opengeni/observability
13
13
  import { createObjectStorage, type ObjectStorage } from "@opengeni/storage";
14
14
  import { dirname } from "node:path";
15
15
 
16
+ import {
17
+ ReadinessCheckFailedError,
18
+ UnsafeDatabaseRolePostureError,
19
+ createReadinessTransitionRecorder,
20
+ notCheckedReadiness,
21
+ readinessChecksOk,
22
+ settleReadinessCheck,
23
+ type ReadinessChecks,
24
+ } from "./readiness-checks";
25
+
16
26
  import {
17
27
  EDITABLE_ARTIFACT_MATERIALIZER_DATABASE_ROLE,
18
28
  EDITABLE_ARTIFACT_MATERIALIZER_MAX_OUTPUT_BYTES,
@@ -305,8 +315,33 @@ export function createEditableArtifactMaterializerService(
305
315
  const abort = new AbortController();
306
316
  const readinessTimeoutMs = input.readinessTimeoutMs ?? 2_000;
307
317
 
308
- const ready = async (): Promise<void> => {
309
- await withTimeout(assertDedicatedMaterializerDatabaseRole(input.db), readinessTimeoutMs);
318
+ let lastReadiness: ReadinessChecks | null = null;
319
+ const recordReadiness = createReadinessTransitionRecorder("Artifact materializer", {
320
+ warn: (message) =>
321
+ input.observability.warn(message, {
322
+ errorClass: "WorkerOperationError",
323
+ errorCode: "worker_operation_failed",
324
+ origin: "worker",
325
+ }),
326
+ info: (message) => input.observability.info(message),
327
+ });
328
+
329
+ const ready = async (): Promise<ReadinessChecks> => {
330
+ const timeout = new AbortController();
331
+ const timer = setTimeout(() => timeout.abort(), readinessTimeoutMs);
332
+ try {
333
+ const checks: ReadinessChecks = {
334
+ databaseRole: await settleReadinessCheck(
335
+ () => assertDedicatedMaterializerDatabaseRole(input.db),
336
+ timeout.signal,
337
+ ),
338
+ };
339
+ lastReadiness = checks;
340
+ recordReadiness(checks);
341
+ return checks;
342
+ } finally {
343
+ clearTimeout(timer);
344
+ }
310
345
  };
311
346
 
312
347
  const run = (): Promise<void> => {
@@ -316,7 +351,10 @@ export function createEditableArtifactMaterializerService(
316
351
  }
317
352
  runPromise = (async () => {
318
353
  try {
319
- await ready();
354
+ const checks = await ready();
355
+ if (!readinessChecksOk(checks)) {
356
+ throw new ReadinessCheckFailedError("Artifact materializer", checks);
357
+ }
320
358
  if (abort.signal.aborted) {
321
359
  state = "stopped";
322
360
  return;
@@ -385,27 +423,23 @@ export function createEditableArtifactMaterializerService(
385
423
  if (url.pathname === "/readyz") {
386
424
  if (state !== "ready") {
387
425
  return Response.json(
388
- { ok: false, state, checks: { databaseRole: { ok: false } } },
426
+ { ok: false, state, checks: lastReadiness ?? notCheckedReadiness(["databaseRole"]) },
389
427
  { status: 503 },
390
428
  );
391
429
  }
392
- try {
393
- await ready();
394
- return Response.json({
395
- ok: true,
396
- state,
397
- runtime: input.runtimeCapability ?? {
398
- mode: "production",
399
- sandboxEnforced: true,
400
- },
401
- checks: { databaseRole: { ok: true } },
402
- });
403
- } catch {
404
- return Response.json(
405
- { ok: false, state, checks: { databaseRole: { ok: false } } },
406
- { status: 503 },
407
- );
430
+ const checks = await ready();
431
+ if (!readinessChecksOk(checks)) {
432
+ return Response.json({ ok: false, state, checks }, { status: 503 });
408
433
  }
434
+ return Response.json({
435
+ ok: true,
436
+ state,
437
+ runtime: input.runtimeCapability ?? {
438
+ mode: "production",
439
+ sandboxEnforced: true,
440
+ },
441
+ checks,
442
+ });
409
443
  }
410
444
  if (url.pathname === "/metrics") {
411
445
  return new Response(await input.observability.prometheusMetrics(), {
@@ -470,15 +504,32 @@ export async function assertDedicatedMaterializerDatabaseRole(db: Database): Pro
470
504
  can_delete_jobs?: unknown;
471
505
  }
472
506
  | undefined;
507
+ const violations: string[] = [];
473
508
  if (
474
509
  row?.current_role !== EDITABLE_ARTIFACT_MATERIALIZER_DATABASE_ROLE ||
475
- row.session_role !== EDITABLE_ARTIFACT_MATERIALIZER_DATABASE_ROLE ||
476
- row.can_select_jobs !== false ||
477
- row.can_insert_jobs !== false ||
478
- row.can_update_jobs !== false ||
479
- row.can_delete_jobs !== false
510
+ row.session_role !== EDITABLE_ARTIFACT_MATERIALIZER_DATABASE_ROLE
480
511
  ) {
481
- throw new Error("Artifact materializer database connection has an unsafe role posture");
512
+ violations.push(
513
+ `connected as role ${describeRole(row?.current_role)} (session role ${describeRole(row?.session_role)}), expected ${EDITABLE_ARTIFACT_MATERIALIZER_DATABASE_ROLE}`,
514
+ );
515
+ }
516
+ const jobPrivileges = (
517
+ [
518
+ ["SELECT", row?.can_select_jobs],
519
+ ["INSERT", row?.can_insert_jobs],
520
+ ["UPDATE", row?.can_update_jobs],
521
+ ["DELETE", row?.can_delete_jobs],
522
+ ] as const
523
+ )
524
+ .filter(([, granted]) => granted !== false)
525
+ .map(([privilege]) => privilege);
526
+ if (jobPrivileges.length > 0) {
527
+ violations.push(
528
+ `it has direct ${jobPrivileges.join(", ")} on editable_artifact_materialization_jobs; revoke those privileges (including grants to PUBLIC)`,
529
+ );
530
+ }
531
+ if (violations.length > 0) {
532
+ throw new UnsafeDatabaseRolePostureError("Artifact materializer", violations);
482
533
  }
483
534
  }
484
535
 
@@ -552,7 +603,12 @@ export function readEditableArtifactMaterializerSidecarEnvironment(
552
603
  );
553
604
  }
554
605
  assertLoopbackDatabaseUrl(databaseUrl);
555
- assertLoopbackObjectStorageUrl(required(environment, "OPENGENI_OBJECT_STORAGE_ENDPOINT"));
606
+ // Materialization uses authenticated server-side storage requests, whose
607
+ // endpoint can differ from the browser-facing presigned URL origin.
608
+ assertLoopbackObjectStorageUrl(
609
+ optional(environment, "OPENGENI_OBJECT_STORAGE_INTERNAL_ENDPOINT") ??
610
+ required(environment, "OPENGENI_OBJECT_STORAGE_ENDPOINT"),
611
+ );
556
612
  }
557
613
  const httpHostname =
558
614
  optional(environment, "OPENGENI_ARTIFACT_MATERIALIZER_HTTP_HOST") ?? "0.0.0.0";
@@ -710,18 +766,8 @@ export async function createMaterializerSidecarFromEnvironment(
710
766
  });
711
767
  }
712
768
 
713
- async function withTimeout<T>(promise: Promise<T>, milliseconds: number): Promise<T> {
714
- let timer: ReturnType<typeof setTimeout> | undefined;
715
- try {
716
- return await Promise.race([
717
- promise,
718
- new Promise<never>((_resolve, reject) => {
719
- timer = setTimeout(() => reject(new Error("readiness check timed out")), milliseconds);
720
- }),
721
- ]);
722
- } finally {
723
- if (timer) clearTimeout(timer);
724
- }
769
+ function describeRole(value: unknown): string {
770
+ return typeof value === "string" && value.length > 0 ? value : "unknown";
725
771
  }
726
772
 
727
773
  function required(environment: NodeJS.ProcessEnv, name: string): string {
@@ -361,18 +361,63 @@ function nativeFailureDiagnostic(
361
361
  return undefined;
362
362
  }
363
363
 
364
+ /** Budget multipliers for successive identity probes. Only a probe that our
365
+ * own timer terminated is retried: a slow start on a loaded host (a cold
366
+ * executable page-in, swap) is transient, while a failing or malformed
367
+ * identity is not. */
368
+ const IDENTITY_PROBE_BUDGET_MULTIPLIERS = [1, 3, 9] as const;
369
+
370
+ class IdentityProbeTimeoutError extends Error {
371
+ constructor(timeoutMs: number) {
372
+ super(`native materializer identity probe timed out after ${timeoutMs}ms`);
373
+ this.name = "IdentityProbeTimeoutError";
374
+ }
375
+ }
376
+
364
377
  async function probeIdentity(
365
378
  options: NativeEditableArtifactSubprocessOptions,
379
+ ): Promise<IdentityEnvelope> {
380
+ const baseTimeoutMs = options.probeTimeoutMs ?? 5_000;
381
+ for (let attempt = 0; ; attempt++) {
382
+ try {
383
+ return await probeIdentityOnce(
384
+ options,
385
+ baseTimeoutMs * IDENTITY_PROBE_BUDGET_MULTIPLIERS[attempt]!,
386
+ );
387
+ } catch (error) {
388
+ if (
389
+ !(error instanceof IdentityProbeTimeoutError) ||
390
+ attempt + 1 >= IDENTITY_PROBE_BUDGET_MULTIPLIERS.length
391
+ ) {
392
+ throw error;
393
+ }
394
+ }
395
+ }
396
+ }
397
+
398
+ async function probeIdentityOnce(
399
+ options: NativeEditableArtifactSubprocessOptions,
400
+ timeoutMs: number,
366
401
  ): Promise<IdentityEnvelope> {
367
402
  const child = spawnNative(options, [IDENTITY_ARGUMENT]);
368
403
  const terminate = () => terminateChild(child);
369
- const timeout = setTimeout(terminate, options.probeTimeoutMs ?? 5_000);
404
+ let timedOut = false;
405
+ const timeout = setTimeout(() => {
406
+ timedOut = true;
407
+ terminate();
408
+ }, timeoutMs);
370
409
  timeout.unref?.();
371
410
  const stdout = collectBounded(child.stdout, MAX_IDENTITY_BYTES, terminate);
372
411
  const stderr = drainStderr(child, terminate);
373
412
  try {
374
- const [bytes, , status] = await Promise.all([stdout, stderr, waitForExit(child)]);
413
+ const [bytes, , status] = await Promise.all([stdout, stderr, waitForExit(child)]).catch(
414
+ (error: unknown) => {
415
+ if (timedOut) throw new IdentityProbeTimeoutError(timeoutMs);
416
+ throw error;
417
+ },
418
+ );
375
419
  if (status.code !== 0 || status.signal !== null) {
420
+ if (timedOut) throw new IdentityProbeTimeoutError(timeoutMs);
376
421
  throw new Error("native materializer identity probe failed");
377
422
  }
378
423
  const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
@@ -22,11 +22,22 @@ import {
22
22
  type ConfirmedNatsEditableArtifactHintBroker,
23
23
  type EditableArtifactHintNatsAuth,
24
24
  } from "./editable-artifact-hint-broker";
25
+ import {
26
+ UnsafeDatabaseRolePostureError,
27
+ settleReadinessCheck,
28
+ type ReadinessCheckResult,
29
+ } from "./readiness-checks";
25
30
 
26
31
  export const EDITABLE_ARTIFACT_OUTBOX_DISPATCHER_DATABASE_ROLE =
27
32
  "opengeni_artifact_outbox_dispatcher";
28
33
  export const EDITABLE_ARTIFACT_OUTBOX_DATABASE_URL_ENV = "OPENGENI_ARTIFACT_OUTBOX_DATABASE_URL";
29
34
 
35
+ /** Independent readiness probes; each names its own failure. */
36
+ export type EditableArtifactOutboxReadinessChecks = Readonly<{
37
+ databaseRole: ReadinessCheckResult;
38
+ nats: ReadinessCheckResult;
39
+ }>;
40
+
30
41
  export type EditableArtifactOutboxWorkerOptions = Readonly<{
31
42
  /** Must authenticate as the dedicated dispatcher role, never the generic app role. */
32
43
  dispatcherDatabaseUrl: string;
@@ -64,14 +75,18 @@ export class EditableArtifactOutboxWorkerRuntime {
64
75
  return true;
65
76
  }
66
77
 
67
- async check(signal?: AbortSignal): Promise<void> {
78
+ async check(signal?: AbortSignal): Promise<EditableArtifactOutboxReadinessChecks> {
68
79
  if (this.abort.signal.aborted || this.closing) {
69
80
  throw new Error("Artifact outbox worker is stopping");
70
81
  }
71
- await Promise.all([
72
- assertDedicatedOutboxDispatcherDatabaseRole(this.database.db),
73
- this.broker.check(signal),
82
+ const [databaseRole, nats] = await Promise.all([
83
+ settleReadinessCheck(
84
+ () => assertDedicatedOutboxDispatcherDatabaseRole(this.database.db),
85
+ signal,
86
+ ),
87
+ settleReadinessCheck(() => this.broker.check(signal), signal),
74
88
  ]);
89
+ return { databaseRole, nats };
75
90
  }
76
91
 
77
92
  stop(): Promise<void> {
@@ -142,69 +157,115 @@ export async function createEditableArtifactOutboxWorker(
142
157
  * Verify the database identity and its negative capability at runtime. A DSN
143
158
  * username check alone is insufficient because PostgreSQL role inheritance,
144
159
  * SET ROLE, or a mis-provisioned grant could otherwise widen this worker.
160
+ *
161
+ * Relations owned by an installed extension (for example the PUBLIC-readable
162
+ * pg_stat_statements views) are not Opengeni data and do not count; any other
163
+ * accessible relation or sequence is named in the error so an operator can
164
+ * revoke the grant without guessing.
145
165
  */
146
166
  export async function assertDedicatedOutboxDispatcherDatabaseRole(db: Database): Promise<void> {
147
167
  const raw = await db.execute<{
148
168
  current_role: string;
149
169
  session_role: string;
150
- can_access_any_relation: boolean;
151
- can_access_any_sequence: boolean;
170
+ accessible_relations: string[];
152
171
  }>(dbSql`
153
172
  select
154
173
  current_user::text as current_role,
155
174
  session_user::text as session_role,
156
- exists (
157
- select 1
158
- from pg_catalog.pg_class relation_row
159
- join pg_catalog.pg_namespace namespace_row
160
- on namespace_row.oid = relation_row.relnamespace
161
- where namespace_row.nspname = current_schema()
162
- and relation_row.relkind in ('r', 'p', 'v', 'm', 'f')
163
- and (
164
- has_table_privilege(current_user, relation_row.oid, 'SELECT')
165
- or has_table_privilege(current_user, relation_row.oid, 'INSERT')
166
- or has_table_privilege(current_user, relation_row.oid, 'UPDATE')
167
- or has_table_privilege(current_user, relation_row.oid, 'DELETE')
168
- or has_table_privilege(current_user, relation_row.oid, 'TRUNCATE')
169
- or has_table_privilege(current_user, relation_row.oid, 'REFERENCES')
170
- or has_table_privilege(current_user, relation_row.oid, 'TRIGGER')
171
- or has_any_column_privilege(current_user, relation_row.oid, 'SELECT')
172
- or has_any_column_privilege(current_user, relation_row.oid, 'INSERT')
173
- or has_any_column_privilege(current_user, relation_row.oid, 'UPDATE')
174
- or has_any_column_privilege(current_user, relation_row.oid, 'REFERENCES')
175
- )
176
- ) as can_access_any_relation,
177
- exists (
178
- select 1
179
- from pg_catalog.pg_class sequence_row
180
- join pg_catalog.pg_namespace namespace_row
181
- on namespace_row.oid = sequence_row.relnamespace
182
- where namespace_row.nspname = current_schema()
183
- and sequence_row.relkind = 'S'
184
- and (
185
- has_sequence_privilege(current_user, sequence_row.oid, 'USAGE')
186
- or has_sequence_privilege(current_user, sequence_row.oid, 'SELECT')
187
- or has_sequence_privilege(current_user, sequence_row.oid, 'UPDATE')
188
- )
189
- ) as can_access_any_sequence
175
+ coalesce(
176
+ (
177
+ select array_agg(accessible.name order by accessible.name)
178
+ from (
179
+ select format('%I.%I', namespace_row.nspname, relation_row.relname) as name
180
+ from pg_catalog.pg_class relation_row
181
+ join pg_catalog.pg_namespace namespace_row
182
+ on namespace_row.oid = relation_row.relnamespace
183
+ where namespace_row.nspname = current_schema()
184
+ and relation_row.relkind in ('r', 'p', 'v', 'm', 'f', 'S')
185
+ and not exists (
186
+ select 1
187
+ from pg_catalog.pg_depend extension_member
188
+ where extension_member.classid = 'pg_catalog.pg_class'::regclass
189
+ and extension_member.objid = relation_row.oid
190
+ and extension_member.refclassid = 'pg_catalog.pg_extension'::regclass
191
+ and extension_member.deptype = 'e'
192
+ )
193
+ and (
194
+ (
195
+ relation_row.relkind <> 'S'
196
+ and (
197
+ has_table_privilege(current_user, relation_row.oid, 'SELECT')
198
+ or has_table_privilege(current_user, relation_row.oid, 'INSERT')
199
+ or has_table_privilege(current_user, relation_row.oid, 'UPDATE')
200
+ or has_table_privilege(current_user, relation_row.oid, 'DELETE')
201
+ or has_table_privilege(current_user, relation_row.oid, 'TRUNCATE')
202
+ or has_table_privilege(current_user, relation_row.oid, 'REFERENCES')
203
+ or has_table_privilege(current_user, relation_row.oid, 'TRIGGER')
204
+ or has_any_column_privilege(current_user, relation_row.oid, 'SELECT')
205
+ or has_any_column_privilege(current_user, relation_row.oid, 'INSERT')
206
+ or has_any_column_privilege(current_user, relation_row.oid, 'UPDATE')
207
+ or has_any_column_privilege(current_user, relation_row.oid, 'REFERENCES')
208
+ )
209
+ )
210
+ or (
211
+ relation_row.relkind = 'S'
212
+ and (
213
+ has_sequence_privilege(current_user, relation_row.oid, 'USAGE')
214
+ or has_sequence_privilege(current_user, relation_row.oid, 'SELECT')
215
+ or has_sequence_privilege(current_user, relation_row.oid, 'UPDATE')
216
+ )
217
+ )
218
+ )
219
+ order by 1
220
+ limit ${MAX_REPORTED_RELATIONS + 1}
221
+ ) accessible
222
+ ),
223
+ '{}'::text[]
224
+ ) as accessible_relations
190
225
  `);
191
226
  const rows = Array.isArray(raw) ? raw : ((raw as unknown as { rows?: unknown[] }).rows ?? []);
192
227
  const row = rows[0] as
193
228
  | {
194
229
  current_role?: unknown;
195
230
  session_role?: unknown;
196
- can_access_any_relation?: unknown;
197
- can_access_any_sequence?: unknown;
231
+ accessible_relations?: unknown;
198
232
  }
199
233
  | undefined;
234
+ const violations: string[] = [];
200
235
  if (
201
236
  row?.current_role !== EDITABLE_ARTIFACT_OUTBOX_DISPATCHER_DATABASE_ROLE ||
202
- row.session_role !== EDITABLE_ARTIFACT_OUTBOX_DISPATCHER_DATABASE_ROLE ||
203
- row.can_access_any_relation !== false ||
204
- row.can_access_any_sequence !== false
237
+ row.session_role !== EDITABLE_ARTIFACT_OUTBOX_DISPATCHER_DATABASE_ROLE
205
238
  ) {
206
- throw new Error("Artifact outbox dispatcher database connection has an unsafe role posture");
239
+ violations.push(
240
+ `connected as role ${describeRole(row?.current_role)} (session role ${describeRole(row?.session_role)}), expected ${EDITABLE_ARTIFACT_OUTBOX_DISPATCHER_DATABASE_ROLE}`,
241
+ );
242
+ }
243
+ const accessible = textArray(row?.accessible_relations);
244
+ if (accessible === null) {
245
+ violations.push("relation access could not be verified");
246
+ } else if (accessible.length > 0) {
247
+ const named = accessible.slice(0, MAX_REPORTED_RELATIONS).join(", ");
248
+ const more = accessible.length > MAX_REPORTED_RELATIONS ? " and more" : "";
249
+ violations.push(
250
+ `it can directly access ${named}${more}; revoke those privileges (including grants to PUBLIC) or move the relations out of the dispatcher's schema`,
251
+ );
207
252
  }
253
+ if (violations.length > 0) {
254
+ throw new UnsafeDatabaseRolePostureError("Artifact outbox dispatcher", violations);
255
+ }
256
+ }
257
+
258
+ const MAX_REPORTED_RELATIONS = 5;
259
+
260
+ function describeRole(value: unknown): string {
261
+ return typeof value === "string" && value.length > 0 ? value : "unknown";
262
+ }
263
+
264
+ function textArray(value: unknown): string[] | null {
265
+ // Anything other than a decoded text[] fails closed as "could not be verified".
266
+ return Array.isArray(value) && value.every((item) => typeof item === "string")
267
+ ? (value as string[])
268
+ : null;
208
269
  }
209
270
 
210
271
  function dispatcherStore(