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

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 +172 -28
  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 +3 -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 +30 -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-NTXZHYET.js} +1552 -2876
  123. package/dist/activities-control-NTXZHYET.js.map +1 -0
  124. package/dist/activities-control.d.ts +64 -4
  125. package/dist/{activities-turn-YVVKCGAK.js → activities-turn-RKRI5GY4.js} +9238 -4392
  126. package/dist/activities-turn-RKRI5GY4.js.map +1 -0
  127. package/dist/activities.d.ts +64 -4
  128. package/dist/artifact-materializer-entry.js +104 -35
  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-M3NVMF2V.js → chunk-7BIHFUGB.js} +2293 -3956
  140. package/dist/chunk-7BIHFUGB.js.map +1 -0
  141. package/dist/chunk-MVESOYFC.js +3746 -0
  142. package/dist/chunk-MVESOYFC.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 +1134 -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 +26 -4
  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 +94 -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 +599 -110
  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 +162 -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 +116 -9
  301. package/src/activities/sandbox-lease.ts +1615 -73
  302. package/src/activities/scheduled-tasks.ts +758 -141
  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 +79 -38
  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,7 @@
1
+ import type { LeaseSnapshot, SandboxRetainedProcess } from "@opengeni/db";
2
+ /** Observation backoff must leave the exact provider's rotation window usable.
3
+ * This changes only the next probe time, never cancellation or settlement proof. */
4
+ export declare function retainedProcessDeadlineRetryMs(process: Pick<SandboxRetainedProcess, "leaseId" | "leaseEpoch" | "providerBackend" | "providerInstanceId" | "routeTargetId">, lease: Pick<LeaseSnapshot, "id" | "leaseEpoch" | "backend" | "instanceId" | "providerDeadlineAt"> | null, settings: {
5
+ sandboxRotationLeadMs: number;
6
+ sandboxLeaseReaperPeriodMs: number;
7
+ }, retryAfterMs: number, now?: number): number;
@@ -0,0 +1,84 @@
1
+ import {
2
+ CONNECTED_COMMAND_RECONCILIATION_CLAIM_TTL_MS,
3
+ CONNECTED_COMMAND_RECONCILIATION_LIMIT,
4
+ RETAINED_PROCESS_BINDING_QUARANTINE_AFTER_ATTEMPTS,
5
+ RETAINED_PROCESS_BINDING_QUARANTINE_RETRY_MS,
6
+ RETAINED_PROCESS_OUTPUT_BACKLOG_BYTES,
7
+ RETAINED_PROCESS_OUTPUT_DRAIN_BUDGET_MS,
8
+ RETAINED_PROCESS_OUTPUT_DRAIN_MAX_READS,
9
+ RETAINED_PROCESS_OUTPUT_DRAIN_SWEEP_BUDGET_MS,
10
+ RETAINED_PROCESS_PROVIDER_PROBE_TIMEOUT_MS,
11
+ RETAINED_PROCESS_RECONCILIATION_CLAIM_TTL_MS,
12
+ RETAINED_PROCESS_RECONCILIATION_LIMIT,
13
+ SANDBOX_CHECKPOINT_GC_CLAIM_TTL_MS,
14
+ SandboxProviderCaptureTimeoutError,
15
+ awaitProviderCaptureWithLatePublication,
16
+ captureRetainedProbeOutput,
17
+ classifyRetainedProcessPollResult,
18
+ connectedCommandProofFromStatus,
19
+ countWarmModalLeasesMissingInstance,
20
+ createSandboxLeaseActivities,
21
+ drainRetainedCommandBacklog,
22
+ modalOrphanCandidateStillUnowned,
23
+ modalOrphanSweepMayHaveWork,
24
+ modalOrphanTerminationStillEligible,
25
+ probeConnectedMachineBackgroundCommand,
26
+ probeRetainedProcessAtProvider,
27
+ reconcileConnectedCommandOutputReleases,
28
+ reconcileConnectedMachineBackgroundCommands,
29
+ reconcileModalProviderCreates,
30
+ refreshIdleSandboxReaperProjections,
31
+ replayConnectedCommandOutput,
32
+ resumeIdleCheckpointSessionAtProvider,
33
+ retainedProcessReconciliationDeferral,
34
+ sandboxDrainCaptureId,
35
+ sandboxDrainReason,
36
+ sandboxLeaseTelemetryKey,
37
+ terminateProviderBox,
38
+ verifyDockerDrainCaptureFence
39
+ } from "./chunk-MVESOYFC.js";
40
+ import "./chunk-NQDVJ6RI.js";
41
+ import "./chunk-24GP3BX5.js";
42
+ import "./chunk-5NNS4327.js";
43
+ import "./chunk-W2QSM5HR.js";
44
+ import "./chunk-PZ5AY32C.js";
45
+ export {
46
+ CONNECTED_COMMAND_RECONCILIATION_CLAIM_TTL_MS,
47
+ CONNECTED_COMMAND_RECONCILIATION_LIMIT,
48
+ RETAINED_PROCESS_BINDING_QUARANTINE_AFTER_ATTEMPTS,
49
+ RETAINED_PROCESS_BINDING_QUARANTINE_RETRY_MS,
50
+ RETAINED_PROCESS_OUTPUT_BACKLOG_BYTES,
51
+ RETAINED_PROCESS_OUTPUT_DRAIN_BUDGET_MS,
52
+ RETAINED_PROCESS_OUTPUT_DRAIN_MAX_READS,
53
+ RETAINED_PROCESS_OUTPUT_DRAIN_SWEEP_BUDGET_MS,
54
+ RETAINED_PROCESS_PROVIDER_PROBE_TIMEOUT_MS,
55
+ RETAINED_PROCESS_RECONCILIATION_CLAIM_TTL_MS,
56
+ RETAINED_PROCESS_RECONCILIATION_LIMIT,
57
+ SANDBOX_CHECKPOINT_GC_CLAIM_TTL_MS,
58
+ SandboxProviderCaptureTimeoutError,
59
+ awaitProviderCaptureWithLatePublication,
60
+ captureRetainedProbeOutput,
61
+ classifyRetainedProcessPollResult,
62
+ connectedCommandProofFromStatus,
63
+ countWarmModalLeasesMissingInstance,
64
+ createSandboxLeaseActivities,
65
+ drainRetainedCommandBacklog,
66
+ modalOrphanCandidateStillUnowned,
67
+ modalOrphanSweepMayHaveWork,
68
+ modalOrphanTerminationStillEligible,
69
+ probeConnectedMachineBackgroundCommand,
70
+ probeRetainedProcessAtProvider,
71
+ reconcileConnectedCommandOutputReleases,
72
+ reconcileConnectedMachineBackgroundCommands,
73
+ reconcileModalProviderCreates,
74
+ refreshIdleSandboxReaperProjections,
75
+ replayConnectedCommandOutput,
76
+ resumeIdleCheckpointSessionAtProvider,
77
+ retainedProcessReconciliationDeferral,
78
+ sandboxDrainCaptureId,
79
+ sandboxDrainReason,
80
+ sandboxLeaseTelemetryKey,
81
+ terminateProviderBox,
82
+ verifyDockerDrainCaptureFence
83
+ };
84
+ //# sourceMappingURL=sandbox-lease-BJYU72N3.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -35,6 +35,31 @@ export type SandboxLeaseSweepMaintenanceInput = {
35
35
  startFailed: number;
36
36
  rotationsRequested: number;
37
37
  };
38
+ /** One warm box an idle checkpoint child captures. */
39
+ export type SandboxIdleCheckpointTarget = {
40
+ workspaceId: string;
41
+ sandboxGroupId: string;
42
+ instanceId: string;
43
+ leaseEpoch: number;
44
+ };
45
+ export type SandboxIdleCheckpointActivityInput = {
46
+ target: SandboxIdleCheckpointTarget;
47
+ /** Frozen with the child, like a drain's, so the activity outlives its
48
+ * own provider capture budget. */
49
+ timeoutClass: SandboxDrainTimeoutClass;
50
+ };
51
+ export type SandboxIdleCheckpointWorkflowInput = SandboxIdleCheckpointActivityInput;
52
+ /** Inventory result of one idle checkpoint sweep. */
53
+ export type SandboxIdleCheckpointPlan = {
54
+ targets: SandboxIdleCheckpointTarget[];
55
+ timeoutClass: SandboxDrainTimeoutClass;
56
+ };
57
+ /** Fixed id of the idle checkpoint sweep: one inventory at a time, started
58
+ * from the same tick as the drain inventory. */
59
+ export declare const SANDBOX_IDLE_CHECKPOINT_SWEEP_WORKFLOW_ID = "opengeni-sandbox-idle-checkpoints-v1";
60
+ /** One child per exact lease epoch: a sweep that finds the previous child
61
+ * still running coalesces into it instead of starting a second capture. */
62
+ export declare function sandboxIdleCheckpointWorkflowId(target: SandboxIdleCheckpointTarget): string;
38
63
  export declare function sandboxDrainTimeoutClass(captureTimeoutMs: number): SandboxDrainTimeoutClass;
39
64
  export declare function sandboxDrainActivityTimeoutMs(timeoutClass: SandboxDrainTimeoutClass): number;
40
65
  export declare function sandboxDrainWorkflowId(target: SandboxDrainTarget): string;
@@ -1,3 +1,4 @@
1
+ import type { EventBus } from "@opengeni/events";
1
2
  import { type Settings } from "@opengeni/config";
2
3
  import { readLease, reinstateTurnLeaseHolder, SandboxLeaseSupersededError, type Database, type LeaseHolderKind } from "@opengeni/db";
3
4
  import { establishSandboxSessionFromEnvelope, type EstablishedSandboxSession, type RuntimeMetricsHooks } from "@opengeni/runtime";
@@ -43,6 +44,28 @@ export type SandboxResumeServices = {
43
44
  /** Test seam for the bounded command-readiness proof performed before an
44
45
  * attached provider box is handed to the agent. */
45
46
  verifyAttachedSandboxReadiness?: (established: EstablishedSandboxSession) => Promise<void>;
47
+ /** Test seam for the bounded command-readiness proof the elected spawner runs
48
+ * on its freshly created box before publishing the lease warm. Production
49
+ * uses {@link waitForSandboxExecReadiness} with the shared 60 s budget. */
50
+ verifySpawnedSandboxReadiness?: (established: EstablishedSandboxSession, identity: {
51
+ sandboxGroupId: string;
52
+ }) => Promise<void>;
53
+ /** Test seam for the jittered pause before the single fresh-box readiness
54
+ * replacement. Production uses {@link freshSandboxReadinessReplacementDelayMs}.
55
+ * It may be async so a test can observe the rolled-back lease in between. */
56
+ freshSandboxReadinessReplacementDelayMs?: () => number | Promise<number>;
57
+ /** Test seam: runs immediately after the elected spawner published its box
58
+ * warm, before the final cancellation check. */
59
+ onSpawnedSandboxPublished?: () => void | Promise<void>;
60
+ /**
61
+ * The turn attempt's fresh-box readiness replacement budget. The lazy
62
+ * provisioner may call resumeBoxForTurn again after a typed lease
63
+ * supersession, so the turn creates the budget once and shares it with every
64
+ * call. Absent, the call gets its own single replacement.
65
+ */
66
+ freshSandboxReadinessReplacementBudget?: FreshSandboxReadinessReplacementBudget;
67
+ /** Live fanout for background commands a provider loss settled. */
68
+ bus?: EventBus | null;
46
69
  /** Called only by the observer that wins the exact warm->cold loss CAS. */
47
70
  onSandboxLost?: (input: {
48
71
  sandboxGroupId: string;
@@ -81,6 +104,9 @@ export type ResumeBoxIds = {
81
104
  * never conflicts).
82
105
  */
83
106
  image?: string;
107
+ /** Deployment/workspace image pins apply only to new creates; an existing
108
+ * group keeps its image. Omission preserves explicit image matching (B3). */
109
+ imagePolicy?: "require_match" | "new_creates_only";
84
110
  /**
85
111
  * RIG IS SHARED STATE (M3): the frozen rig version this run rides. Threaded to
86
112
  * acquireLease, which stamps it on the cold-create and conflicts on a live box
@@ -145,6 +171,23 @@ export declare class SandboxSiblingWarmingTimeoutError extends SandboxWarmingTim
145
171
  instanceId?: string | null;
146
172
  });
147
173
  }
174
+ /** True only for a spawner readiness timeout whose unready fresh box is proven gone. */
175
+ export declare function isReplaceableFreshSandboxReadinessTimeout(error: unknown): boolean;
176
+ /**
177
+ * A burst of simultaneous turn starts can leave many freshly created provider
178
+ * boxes command-unready at once. The single replacement re-enters admission
179
+ * after a jittered pause so the replacement creates do not re-synchronize into
180
+ * the same burst. Bounded to [2 s, 10 s).
181
+ */
182
+ export declare const FRESH_SANDBOX_READINESS_REPLACEMENT_BASE_DELAY_MS = 2000;
183
+ export declare const FRESH_SANDBOX_READINESS_REPLACEMENT_JITTER_MS = 8000;
184
+ export declare function freshSandboxReadinessReplacementDelayMs(random?: () => number): number;
185
+ /** Replacements allowed per turn attempt, across every resumeBoxForTurn call. */
186
+ export declare const FRESH_SANDBOX_READINESS_REPLACEMENTS_PER_TURN_ATTEMPT = 1;
187
+ export type FreshSandboxReadinessReplacementBudget = {
188
+ remaining: number;
189
+ };
190
+ export declare function createFreshSandboxReadinessReplacementBudget(): FreshSandboxReadinessReplacementBudget;
148
191
  /** The exact attached caller that won warm->cold after proving the provider
149
192
  * instance gone. It is a lease supersession (the same logical turn recovers),
150
193
  * plus the lost id needed for one durable observability event. */
@@ -160,7 +203,7 @@ export declare class SandboxLeaseInstanceLostError extends SandboxLeaseSupersede
160
203
  */
161
204
  export declare function waitForSandboxExecReadiness(established: EstablishedSandboxSession, timeoutMs?: number, identity?: {
162
205
  sandboxGroupId?: string | null;
163
- }): Promise<void>;
206
+ }, signal?: AbortSignal): Promise<void>;
164
207
  export declare function waitForWarmSnapshot(snapshot: Promise<unknown>, timeoutMs: number, signal?: AbortSignal): Promise<boolean>;
165
208
  export type SandboxDeadlineRotationCheckpointResult = {
166
209
  /** The exact established epoch still carries a requested rotation and a
@@ -218,14 +261,27 @@ export type WarmWorkspaceSnapshotPromise = Promise<boolean> & {
218
261
  * failed and released its exact workspace-capture admission. */
219
262
  readonly settled: Promise<void>;
220
263
  };
221
- export declare function maybePersistWarmWorkspaceSnapshot(services: SandboxResumeServices, ids: {
264
+ /** Who owns a warm checkpoint: the exact turn attempt holding the box, or
265
+ * (`idleCheckpoint`) the reaper checkpointing a box that no turn holds and
266
+ * viewers, interactions or running background commands keep warm. The idle
267
+ * owner is fenced by its exact capture claim alone and is limited to
268
+ * point-in-time Modal captures. */
269
+ export type WarmWorkspaceSnapshotOwner = {
222
270
  accountId: string;
223
271
  workspaceId: string;
272
+ sandboxGroupId: string;
273
+ } & ({
224
274
  sessionId: string;
225
275
  turnId: string;
226
276
  attemptId: string;
227
- sandboxGroupId: string;
228
- }, session: unknown, leaseEpoch: number, signal?: AbortSignal, force?: boolean): WarmWorkspaceSnapshotPromise;
277
+ idleCheckpoint?: never;
278
+ } | {
279
+ idleCheckpoint: true;
280
+ sessionId?: never;
281
+ turnId?: never;
282
+ attemptId?: never;
283
+ });
284
+ export declare function maybePersistWarmWorkspaceSnapshot(services: SandboxResumeServices, ids: WarmWorkspaceSnapshotOwner, session: unknown, leaseEpoch: number, signal?: AbortSignal, force?: boolean): WarmWorkspaceSnapshotPromise;
229
285
  /**
230
286
  * Resume the one box for a single turn (or any worker-side resume op). Returns
231
287
  * the live non-owned session + the fence epoch + a release fn. The CALLER owns
@@ -235,5 +291,17 @@ export declare function maybePersistWarmWorkspaceSnapshot(services: SandboxResum
235
291
  * holderId is the globally unique durable turn-attempt id. It must not be a
236
292
  * Temporal activity id, because activity ids are only workflow-local and
237
293
  * collide when sibling sessions share one sandbox group.
294
+ *
295
+ * A freshly created box that misses its bounded command-readiness budget is
296
+ * replaced at most once per turn attempt (the budget is shared by every call
297
+ * the turn's provisioner makes). The first establish has already terminated that exact
298
+ * unpublished box, rolled its exact warming epoch back to cold (advancing the
299
+ * epoch), and released its holder, so the replacement is an ordinary new
300
+ * admission: it re-runs the cold->warming CAS, persists its own provider
301
+ * instance before readiness, and may instead attach to a sibling that won the
302
+ * CAS first. Nothing model- or tool-visible ran on the discarded box, so no
303
+ * side effect is replayed. A second readiness timeout fails the turn exactly
304
+ * as before; attached/resumed boxes and unconfirmed terminations never
305
+ * replace.
238
306
  */
239
307
  export declare function resumeBoxForTurn(services: SandboxResumeServices, ids: ResumeBoxIds, kind: "turn", holderId: TurnSandboxLeaseHolderId): Promise<ResumedTurnSandbox>;
@@ -195,8 +195,10 @@ export type SelfhostedTurnSessionArgs = {
195
195
  workingDir: string | null;
196
196
  /** Effective absolute host-native root frozen for this attempt. */
197
197
  workspaceRoot: string;
198
- /** Present only for a user-owned machine. Every provider operation rechecks
199
- * this frozen accepted-attempt authority immediately before dispatch. */
198
+ /** Present whenever the turn has an initiating human. A machine can become
199
+ * Only me during the turn, so every provider operation reads the current
200
+ * scope and rechecks this frozen accepted-attempt authority immediately
201
+ * before dispatch while the machine is user-owned. */
200
202
  personalMachineAttempt?: NonNullable<RoutingWiringIds["personalMachineAttempt"]> & {
201
203
  sessionId: string;
202
204
  };
@@ -0,0 +1,6 @@
1
+ import type { SessionEvent } from "@opengeni/contracts";
2
+ import type { EventBus } from "@opengeni/events";
3
+ /** Best-effort live fanout of events that are already durable, grouped by
4
+ * session. Durable catch-up remains the source of truth, so failures are only
5
+ * reported. */
6
+ export declare function publishDurableSessionEvents(bus: EventBus | null | undefined, workspaceId: string, events: readonly SessionEvent[] | undefined, onError?: (error: unknown) => void): Promise<void>;
@@ -0,0 +1,12 @@
1
+ import {
2
+ SITE_AUTH_MAINTENANCE_BATCH_SIZE,
3
+ SITE_AUTH_MAINTENANCE_CLAIM_TIMEOUT_MS,
4
+ createSiteAuthMaintenanceActivities
5
+ } from "./chunk-ZN3XJR33.js";
6
+ import "./chunk-PZ5AY32C.js";
7
+ export {
8
+ SITE_AUTH_MAINTENANCE_BATCH_SIZE,
9
+ SITE_AUTH_MAINTENANCE_CLAIM_TIMEOUT_MS,
10
+ createSiteAuthMaintenanceActivities
11
+ };
12
+ //# sourceMappingURL=site-auth-maintenance-WK3MR2PV.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,14 @@
1
+ /** Small injectable clock edges for deterministic telemetry lifecycle tests. */
2
+ export type TelemetryScheduler = {
3
+ timeout(callback: () => void, delayMs: number): () => void;
4
+ interval(callback: () => void, intervalMs: number): () => void;
5
+ defer(callback: () => void): void;
6
+ };
7
+ export declare const telemetryScheduler: TelemetryScheduler;
8
+ export declare function telemetryInterval(value: number, name: string): number;
9
+ /** Bad/regressing clocks are unknown, not a new timestamp or a zero age.
10
+ * Retain the last valid high-water observation for diagnostic age reporting. */
11
+ export declare function createTelemetryClock(now: () => number): {
12
+ read(): number | null;
13
+ latest: () => number | null;
14
+ };
@@ -0,0 +1,22 @@
1
+ import { type Observability } from "@opengeni/observability";
2
+ import { type RuntimeOptions } from "@temporalio/worker";
3
+ /**
4
+ * Runtime options that send every Temporal SDK log record, including records
5
+ * forwarded from the Rust core, through the structured Opengeni logger.
6
+ * Without this the SDK's DefaultLogger prints multi-line objects (with task
7
+ * tokens, raw errors and stacks) and core prints plain text, both outside the
8
+ * public log projection and the one-JSON-object-per-line contract.
9
+ */
10
+ export declare function temporalRuntimeLoggingOptions(observability: Pick<Observability, "log">): RuntimeOptions;
11
+ type RuntimeInstaller = {
12
+ readonly _instance?: unknown;
13
+ install(options: RuntimeOptions): unknown;
14
+ };
15
+ /**
16
+ * Install the process-wide Temporal Runtime with the structured logger. Must
17
+ * run before the first NativeConnection or Worker is created. Returns false
18
+ * when an embedding host already installed its own Runtime, which is left
19
+ * untouched.
20
+ */
21
+ export declare function installTemporalRuntimeLogging(observability: Pick<Observability, "log">, runtime?: RuntimeInstaller): boolean;
22
+ export {};
@@ -0,0 +1,18 @@
1
+ import { Connection, type ConnectionOptions } from "@temporalio/client";
2
+ import { type TurnTaskQueueIdentity, type TurnTaskQueueReadOptions, type TurnTaskQueueStats } from "./observability-metrics.js";
3
+ import { type TelemetryScheduler } from "./telemetry-scheduler.js";
4
+ /** Own diagnostic traffic separately from admission/signaling. SDK1.22's retry
5
+ * interceptor does not cancel backoff or replacement calls, so each diagnostic
6
+ * RPC is one native attempt; the monitor schedules any later observation.
7
+ * Lazy construction avoids another startup/connect retry or an unbounded probe. */
8
+ export declare function createTurnTaskQueueStatsClient(connectionOptions: ConnectionOptions, input?: {
9
+ scheduler?: TelemetryScheduler;
10
+ closeTimeoutMs?: number;
11
+ }): {
12
+ read(options: TurnTaskQueueReadOptions, identity: TurnTaskQueueIdentity): Promise<TurnTaskQueueStats>;
13
+ close(): Promise<void>;
14
+ };
15
+ /** Scope only this diagnostic RPC, never signal/start/admission traffic. Both
16
+ * call-context APIs are public in the pinned Temporal TS SDK 1.22. The caller
17
+ * must supply a retry-disabled connection (the owned client above does so). */
18
+ export declare function createTurnTaskQueueStatsReader(connection: Pick<Connection, "workflowService" | "withDeadline" | "withAbortSignal">, identity: TurnTaskQueueIdentity): (options: TurnTaskQueueReadOptions) => Promise<TurnTaskQueueStats>;
@@ -0,0 +1,47 @@
1
+ import type { Observability } from "@opengeni/observability";
2
+ import type { Worker, WorkerStatus } from "@temporalio/worker";
3
+ import { type TurnTaskQueueIdentity } from "./observability-metrics.js";
4
+ import { type TelemetryScheduler } from "./telemetry-scheduler.js";
5
+ import type { WorkerRunTarget } from "./worker-service-lifecycle.js";
6
+ export declare const TURN_WORKER_ACTIVITY_METRICS: {
7
+ readonly inflight: "opengeni_turn_worker_activities_inflight";
8
+ readonly timestamp: "opengeni_turn_worker_activities_last_observed_timestamp_seconds";
9
+ readonly valid: "opengeni_turn_worker_activities_last_read_success";
10
+ };
11
+ export type TurnWorkerActivityTelemetry = {
12
+ /** Settles only when Worker.run AND all SDK activity execution have settled. */
13
+ settled: Promise<void>;
14
+ isSettled(): boolean;
15
+ closeIfNeverRun(): void;
16
+ };
17
+ /** Preserve scraping after an SDK force-failure without blocking resource close
18
+ * or extending the host shutdown/containment budgets. */
19
+ export declare function closeWorkerHttpAfterActivityExecution(telemetry: TurnWorkerActivityTelemetry | undefined, close: () => void | Promise<void>): void;
20
+ type SdkActivityWorker = Pick<Worker, "run" | "shutdown"> & {
21
+ getStatus(): Pick<WorkerStatus, "numInFlightNonLocalActivities" | "numInFlightLocalActivities" | "numInFlightActivities">;
22
+ numInFlightActivities$: {
23
+ subscribe(observer: {
24
+ next(value: number): void;
25
+ error(error: unknown): void;
26
+ }): {
27
+ unsubscribe(): void;
28
+ };
29
+ };
30
+ };
31
+ /** Only public SDK1.22 hooks. Never count agent claims/slots, poll reservations,
32
+ * heartbeat activity counts, or cancellation intent as executing occupancy.
33
+ * Requires a fresh metric registry/schema and one SDK turn-worker owner per
34
+ * registry + namespace + queue + physical UID. This bridge does not aggregate
35
+ * multiple workers or migrate legacy pre-registered unlabelled gauges. */
36
+ export declare function withTurnWorkerActivityTelemetry(sdkWorker: SdkActivityWorker, input: {
37
+ observability: Observability;
38
+ identity: TurnTaskQueueIdentity;
39
+ podUid: string;
40
+ intervalMs?: number;
41
+ now?: () => number;
42
+ scheduler?: TelemetryScheduler;
43
+ }): {
44
+ worker: WorkerRunTarget;
45
+ activityTelemetry: TurnWorkerActivityTelemetry;
46
+ };
47
+ export {};
@@ -22,3 +22,15 @@ export declare function createWorkerServiceLifecycle(input: {
22
22
  closeOwnedResources: () => Promise<void>;
23
23
  onReady?: () => void;
24
24
  }): WorkerServiceLifecycle;
25
+ /** A cleanup stall first drains peers through WORKER_SHUTDOWN. The standalone
26
+ * process owns the final exit, because Temporal cannot kill JavaScript writers.
27
+ * Embedded hosts may supply their own termination policy at this same edge. */
28
+ export declare function createWorkerCleanupContainment(input: {
29
+ drain: () => boolean;
30
+ terminate?: () => void;
31
+ observability: Observability;
32
+ timeoutMs?: number;
33
+ }): {
34
+ request(): void;
35
+ finished(): void;
36
+ };