@sema-agent/core 7.59.0 → 7.61.0

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 (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -2,7 +2,10 @@ import { createPeerInboundChainRef, createPeerSelfRef } from "../../agents/peer-
2
2
  import { boundInputHashOf } from "../canonical-json.js";
3
3
  import { readPendingSteerQueue } from "../checkpoint-store.js";
4
4
  import { wakeOpening } from "../run-origin.js";
5
- import { createLiveNotificationLane, DurableAppendObligations, injectionLaneOf, isDelegatedAgentTerminal, isTerminalTaskNotification, renderTaskNotificationXml, routeOrParkNotification, SystemInjectionQueue, taskNotificationDedupKey } from "../task-notification.js";
5
+ import { bindDeliveryObligations, createLiveNotificationLane, DeliveryObligations, DurableAppendObligations, injectionLaneOf, isDelegatedAgentTerminal, isTerminalTaskNotification, renderTaskNotificationXml, routeOrParkNotification, SystemInjectionQueue, taskNotificationDedupKey } from "../task-notification.js";
6
+ import { settleConsumedFrame } from "../frame-settlement.js";
7
+ import { createReceivingChain } from "../mods/session-receive.js";
8
+ import { asThrownError } from "../thrown-value.js";
6
9
  import { ToolDetachHub } from "../tool-detach.js";
7
10
  import { pendingContentAskCallId } from "./decide-continuation.js";
8
11
  export function runNotificationLane(input) {
@@ -14,6 +17,7 @@ async function runNotificationLaneAs(input, obligations) {
14
17
  const prepareResume = resume
15
18
  ? {
16
19
  leafId: resume.cp.leafId,
20
+ ...(resume.cp.heldRows !== undefined ? { heldRows: [...resume.cp.heldRows] } : {}),
17
21
  suspendedBatch: new Set(resume.cp.pendingAction.kind === "tool_approval" ? resume.cp.pendingAction.batchToolCallIds : []),
18
22
  seed: resume.cp.state,
19
23
  outcome: resume.outcome,
@@ -70,10 +74,21 @@ async function runNotificationLaneAs(input, obligations) {
70
74
  runner.deps.onError?.(new Error(`background-agent terminal ${payload.task_id} stayed on this run's own session — the delegation tree's root session is not reachable from this run (no uplink, no root anchor)`), { phase: "degraded", sessionId: notificationSessionId ?? "", classification: "descendant-terminal-unrouted" });
71
75
  }
72
76
  };
77
+ const receiving = createReceivingChain(() => prepared.receiveSeat);
73
78
  const unsubscribeTaskNotifications = taskNotificationQueue.subscribe((item) => {
74
79
  queue.push({ type: "task_notification", notification: item.payload, priority: item.priority, ...notificationIdent() });
80
+ receiving.pass(item.payload, {
81
+ handOver: (shown) => handOver(item, shown),
82
+ consumed: (verdict) => {
83
+ settleConsumedFrame(prepared.frameSettlement, taskNotificationDedupKey(item.payload), verdict.by, verdict.reason);
84
+ item.onDisposition?.("refused");
85
+ },
86
+ fault: (e) => runner.deps.onError?.(asThrownError(e), { phase: "degraded", sessionId: notificationSessionId ?? "", classification: "receive-hand-over" }),
87
+ });
88
+ });
89
+ function handOver(item, shown) {
75
90
  if (notificationHarness && prepared.batchHaltRef.current === undefined) {
76
- const xml = renderTaskNotificationXml(item.payload);
91
+ const xml = renderTaskNotificationXml(shown);
77
92
  const noteOptions = {
78
93
  provenance: "engine-note",
79
94
  enginePayload: item.payload,
@@ -90,7 +105,7 @@ async function runNotificationLaneAs(input, obligations) {
90
105
  else {
91
106
  parkTaskNotification(item.payload, item.priority, item.onDisposition);
92
107
  }
93
- });
108
+ }
94
109
  const upstreamTaskNotification = internals?.onTaskNotification;
95
110
  const deliveredAtTurnOpen = new Set();
96
111
  const laneSeat = createLiveNotificationLane({
@@ -116,6 +131,19 @@ async function runNotificationLaneAs(input, obligations) {
116
131
  const peerSelfRef = internals?.peerSelfRef ?? createPeerSelfRef(internals?.registryScope ?? spec.principal ?? "default");
117
132
  const peerInboundChainRef = internals?.peerInboundChainRef ?? createPeerInboundChainRef();
118
133
  const modelCatalog = runner.deps.models;
134
+ const deliveryObligations = new DeliveryObligations();
135
+ const laneSink = (notification, opts) => {
136
+ try {
137
+ upstreamTaskNotification?.(notification, opts);
138
+ }
139
+ catch {
140
+ }
141
+ const outcome = injectTaskNotification(notification, opts);
142
+ if (isTerminalTaskNotification(notification))
143
+ deliveryObligations.discharge(notification);
144
+ return outcome;
145
+ };
146
+ bindDeliveryObligations(laneSink, deliveryObligations);
119
147
  const prepared = await prepareTask(spec, runner.deps, sessions, prepareResume, {
120
148
  ...(internals ?? {}),
121
149
  peerSelfRef,
@@ -123,16 +151,12 @@ async function runNotificationLaneAs(input, obligations) {
123
151
  detachHub,
124
152
  sessionReadStates,
125
153
  sessionModeSeats,
126
- onTaskNotification: (notification, opts) => {
127
- try {
128
- upstreamTaskNotification?.(notification, opts);
129
- }
130
- catch {
131
- }
132
- return injectTaskNotification(notification, opts);
133
- },
154
+ onTaskNotification: laneSink,
134
155
  }, self, taskIdRef, holdSessionLock, legWrites);
135
156
  pendingSessionNotifications.bindSessionBox(prepared.sessionId, prepared.sessionBox);
157
+ const settling = pendingSessionNotifications.settleBoxDebts(prepared.sessionId, prepared.abortController.signal);
158
+ if (settling !== undefined)
159
+ await settling;
136
160
  const notificationLane = {
137
161
  get harness() { return notificationHarness; }, set harness(h) { notificationHarness = h; },
138
162
  get sessionId() { return notificationSessionId; },
@@ -159,7 +183,7 @@ async function runNotificationLaneAs(input, obligations) {
159
183
  },
160
184
  };
161
185
  try {
162
- return await next({ prepared, injectTaskNotification, deliveredAtTurnOpen, peerInboundChainRef, modelCatalog, notificationLane, unsubscribeTaskNotifications });
186
+ return await next({ prepared, injectTaskNotification, deliveredAtTurnOpen, peerInboundChainRef, modelCatalog, notificationLane, unsubscribeTaskNotifications, deliveryObligations });
163
187
  }
164
188
  finally {
165
189
  if (notificationSessionId !== undefined)
@@ -24,8 +24,9 @@ export function runRecoveryLanes(input) {
24
24
  const passSignal = AbortSignal.any([prepared.abortController.signal, callerStop.signal, ...(turnSignal !== undefined ? [turnSignal] : [])]);
25
25
  const passReport = compactionPassReport(queue, ident);
26
26
  try {
27
- const comp = await maybeCompact({
27
+ const comp = await prepared.compactStation.compact({
28
28
  session: prepared.session,
29
+ admitRows: prepared.admitRows,
29
30
  promptIdentity: prepared.promptIdentity,
30
31
  ...centerAdoptionOption(prepared),
31
32
  model: prepared.harness.getModel(),
@@ -52,7 +53,7 @@ export function runRecoveryLanes(input) {
52
53
  ...windowSafetyOptions(prepared.harness.getModel()),
53
54
  ...compactionHookOptions(runner, prepared, "forced", passSignal),
54
55
  onStarted: passReport.onStarted,
55
- });
56
+ }, maybeCompact);
56
57
  if (comp.compacted) {
57
58
  compactionBreaker.failures = 0;
58
59
  recordCompactionReuse(runner, prepared, comp);
@@ -6,7 +6,8 @@ import { isDegenerateCutMessage } from "../../brain/terminal-cause.js";
6
6
  import { hasBackgroundShell, sweepRunBoundaryBackgroundShells } from "../background-shell.js";
7
7
  import { resolveCheckpointStore } from "../checkpoint-store.js";
8
8
  import { compensateUnstarted, reopenReasonOf, resumeStartupCauseOf, unstartedRowSentence } from "../resume-startup-cause.js";
9
- import { classicEventBase, observeClassic } from "../mods/stations.js";
9
+ import { classicEventBase, legNoticeTaskId, observeClassic } from "../mods/stations.js";
10
+ import { raiseCompletedTurn, raiseSessionEnd } from "../mods/lifecycle-stations.js";
10
11
  import { modelCostToPricing } from "../pricing.js";
11
12
  import { hasDestroy, isIsolated } from "../remote-env.js";
12
13
  import { resolveTaskModel } from "../roles.js";
@@ -77,7 +78,6 @@ export async function runSettleAndTeardown(input) {
77
78
  const reminderDisclosuresActive = Object.keys(prepared.reminderDisclosureCounts).length > 0;
78
79
  if (rs.counters.finalVerifyInjections > 0 || rs.attach.attachmentsInjected > 0 || rs.counters.repetitionCuts > 0 || rs.counters.repetitionSpared > 0 || rs.counters.approachNoticesSent > 0 || reminderDisclosuresActive) {
79
80
  stats.mechanisms = {
80
- ...(rs.counters.finalVerifyInjections > 0 ? { finalVerifyInjected: true } : {}),
81
81
  ...(rs.counters.finalVerifyInjections > 0 ? { finalVerifyInjections: rs.counters.finalVerifyInjections } : {}),
82
82
  ...(rs.attach.attachmentsInjected > 0 ? { attachmentsInjected: rs.attach.attachmentsInjected } : {}),
83
83
  ...(rs.counters.approachNoticesSent > 0 ? { approachNoticesSent: rs.counters.approachNoticesSent } : {}),
@@ -87,7 +87,7 @@ export async function runSettleAndTeardown(input) {
87
87
  ...(reminderDisclosuresActive ? { reminderDisclosures: { ...prepared.reminderDisclosureCounts } } : {}),
88
88
  };
89
89
  }
90
- const result = assembleResult(spec, prepared.sessionId, final, stats, {
90
+ const result = assembleResult(prepared, final, stats, {
91
91
  threw,
92
92
  runId: prepared.runId,
93
93
  model: prepared.model.id,
@@ -103,6 +103,7 @@ export async function runSettleAndTeardown(input) {
103
103
  effectiveWriteFace: prepared.effectiveWriteFace,
104
104
  effectiveReadDenyPatterns: prepared.effectiveReadDenyPatterns,
105
105
  effectiveMemoryScopes: prepared.effectiveMemoryScopes,
106
+ placementRoot: prepared.placementRoot,
106
107
  effectiveReasoning: reasoningResolution.current,
107
108
  ...(rs.counters.compactionPasses > 0 || compactionBreaker.failures >= MAX_CONSECUTIVE_COMPACTION_FAILURES ? { compaction: { passes: rs.counters.compactionPasses, breakerOpen: compactionBreaker.failures >= MAX_CONSECUTIVE_COMPACTION_FAILURES, ...(rs.counters.compactionKind !== undefined ? { kind: rs.counters.compactionKind } : {}) } } : {}),
108
109
  retryAfterMs: rs.limits.platformTerminal?.retryAfterMs,
@@ -117,6 +118,7 @@ export async function runSettleAndTeardown(input) {
117
118
  conflict: prepared.conflictRef.hit,
118
119
  gitCoreOverBudget: prepared.gitStatusRef.terminalCode === "irreducible_core_over_budget",
119
120
  outputInvalid: rs.degrade.outputInvalid,
121
+ loopTerminal: prepared.loopTerminalRef.reason,
120
122
  suspendLoop: prepared.suspendLoopRef.hit,
121
123
  ...(prepared.pausedRef.current !== undefined ? { paused: prepared.pausedRef.current.cause } : {}),
122
124
  });
@@ -128,12 +130,12 @@ export async function runSettleAndTeardown(input) {
128
130
  detail: {
129
131
  sessionId: prepared.sessionId,
130
132
  runId: rs.telemetry.runId,
131
- ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}),
133
+ ...legNoticeTaskId(prepared),
132
134
  origin: userInterruptedLive ? "interrupt" : timeout.fired ? "walltime" : rs.limits.turnsExceeded ? "turns" : "signal",
133
135
  },
134
136
  });
135
137
  }
136
- discloseUnconsumedHalt({ accepted: loopLatch.userHalted, consumption: prepared.harness.haltConsumption(), onNotice: runner.deps.onNotice, sessionId: prepared.sessionId, runId: rs.telemetry.runId, taskId: spec.taskId });
138
+ discloseUnconsumedHalt({ accepted: loopLatch.userHalted, consumption: prepared.harness.haltConsumption(), onNotice: runner.deps.onNotice, sessionId: prepared.sessionId, runId: rs.telemetry.runId, taskId: prepared.taskId });
137
139
  let rowReturned = false;
138
140
  if (resume !== undefined &&
139
141
  resume.pendingActionStarted !== true &&
@@ -143,9 +145,9 @@ export async function runSettleAndTeardown(input) {
143
145
  const reopenReason = reopenReasonOf(resumeStartupCauseOf(result.terminal.kind === "failed" ? result.terminal.code : undefined));
144
146
  const row = await compensateUnstarted(resume.reopenUnstarted, reopenReason);
145
147
  rowReturned = row.kind === "reopened";
146
- amendTerminal(result, rowReturned ? "resume.reopened_unstarted" : "resume.reopen_failed_unstarted", (m) => `${m ?? "the resume leg did not complete"} — ${unstartedRowSentence(row)}`);
148
+ amendTerminal(result, rowReturned ? "resume.reopened_unstarted" : "resume.reopen_failed_unstarted", row.kind, (m) => `${m ?? "the resume leg did not complete"} — ${unstartedRowSentence(row)}`);
147
149
  }
148
- settleOwedUserInput(owedUserInput, rowReturned, { taskId: spec.taskId ?? prepared.sessionId, sessionId: prepared.sessionId, runId: prepared.runId, parent: parentLegIds(internals) }, runner.deps.onNotice);
150
+ settleOwedUserInput(owedUserInput, rowReturned, { taskId: prepared.taskId, sessionId: prepared.sessionId, runId: prepared.runId, parent: parentLegIds(internals) }, runner.deps.onNotice);
149
151
  prepared.sealReadStateSeat?.(ownCommittedTailRef.current);
150
152
  {
151
153
  const wss = prepared.workspaceStateSettle;
@@ -190,6 +192,10 @@ export async function runSettleAndTeardown(input) {
190
192
  });
191
193
  if (taskIdRef !== undefined)
192
194
  taskIdRef.delegationTerminalOwed = undefined;
195
+ if (rs.turn.completed !== undefined)
196
+ await raiseCompletedTurn(prepared.modBus, rs.turn, prepared.hookIdentity, undefined);
197
+ if (prepared.modBus.hasHandlers("session.end"))
198
+ await raiseSessionEnd(prepared.modBus, prepared.hookIdentity, { reason: terminalFace.status, sessionId: prepared.sessionId });
193
199
  if (rs.degrade.degraded)
194
200
  result.degraded = rs.degrade.degraded;
195
201
  if (prepared.outputRef.set)
@@ -273,7 +279,7 @@ export async function runSettleAndTeardown(input) {
273
279
  }
274
280
  }
275
281
  finally {
276
- settleOwedUserInput(owedUserInput, !prepared.suspendProgressRef.executedApproved, { taskId: spec.taskId ?? prepared.sessionId, sessionId: prepared.sessionId, runId: prepared.runId, parent: parentLegIds(internals) }, runner.deps.onNotice);
282
+ settleOwedUserInput(owedUserInput, !prepared.suspendProgressRef.executedApproved, { taskId: prepared.taskId, sessionId: prepared.sessionId, runId: prepared.runId, parent: parentLegIds(internals) }, runner.deps.onNotice);
277
283
  const writeDateAnchor = owedDateAnchor(prepared.session, prepared.dateChange, rs.attach.dateState);
278
284
  if (writeDateAnchor !== undefined)
279
285
  await settleTeardownLeg(writeDateAnchor, "date anchor (settle leg)", (e) => runner.deps.onError?.(e, { phase: "degraded", sessionId: prepared.sessionId }));
@@ -1,4 +1,5 @@
1
1
  import type { PushQueue } from "../push-queue.js";
2
+ import type { DeliveryObligations } from "../task-notification.js";
2
3
  import type { TaskEvent, TaskSpec } from "../types.js";
3
4
  import type { Stats } from "./assemble-result.js";
4
5
  import type { InstallingPhaseResult, Prepared, RunnerDepsSeat, RunState } from "./contracts.js";
@@ -23,6 +24,9 @@ export interface RunStopAndFinalVerifyInput {
23
24
  };
24
25
  /** borrowed-readonly — the monotonic walltime deadline (the clock lane's), read by the budget fill. */
25
26
  walltimeMonotonicDeadline: number | undefined;
27
+ /** borrowed-readonly — the terminal frames this leg's lane is still owed (the notification lane's book): a one-shot
28
+ * submission's ending waits on it. */
29
+ deliveryObligations: DeliveryObligations;
26
30
  /** borrowed-readonly — the Runner's deployment deps, read LIVE (`hooks` at resolution, `onError` in the gate). */
27
31
  runner: RunnerDepsSeat;
28
32
  }
@@ -4,7 +4,7 @@ import { classicEventBase, dispatchClassic, legEventsOf, stringMembersAnswer, st
4
4
  import { asThrownError } from "../thrown-value.js";
5
5
  const STOP_HOOK_BLOCK_CAP = 8;
6
6
  export function runStopAndFinalVerify(input) {
7
- const { spec, prepared, queue, rs, stats, ident, walltimeMonotonicDeadline, runner } = input;
7
+ const { spec, prepared, queue, rs, stats, ident, walltimeMonotonicDeadline, deliveryObligations, runner } = input;
8
8
  const stopEvent = legEventsOf(prepared.hookIdentity).stop;
9
9
  const stopArmed = prepared.modBus.hasHandlers(stopEvent);
10
10
  const finalVerificationOn = spec.finalVerification === true;
@@ -24,11 +24,19 @@ export function runStopAndFinalVerify(input) {
24
24
  const emitFinalVerifyEcho = (body) => {
25
25
  queue.push({ type: "steering_injected", source: "final_verification", preview: body.slice(0, 220), ...ident() });
26
26
  };
27
- if (stopArmed || finalVerificationOn) {
27
+ const owed = spec.oneShot === true ? deliveryObligations : undefined;
28
+ if (stopArmed || finalVerificationOn || owed !== undefined) {
28
29
  let consecutiveBlocks = 0;
30
+ const ending = () => prepared.abortController.signal.aborted || prepared.pausedRef.current !== undefined || prepared.batchHaltRef.current !== undefined;
29
31
  prepared.harness.setStopGate(async () => {
30
- if (prepared.abortController.signal.aborted || prepared.pausedRef.current !== undefined || prepared.batchHaltRef.current !== undefined)
32
+ if (ending())
31
33
  return [];
34
+ const pushedBack = stopArmed || finalVerificationOn ? await pushBack() : [];
35
+ if (pushedBack.length === 0)
36
+ await owed?.waitOut(prepared.abortController.signal, () => !ending() && prepared.harness.pendingInjectionCount() === 0, (wake) => prepared.harness.subscribe((e) => void (e.type === "queue_update" && wake())));
37
+ return pushedBack;
38
+ });
39
+ async function pushBack() {
32
40
  if (finalVerificationOn &&
33
41
  (rs.counters.finalVerifyInjections === 0 || (rs.counters.finalVerifyInjections === 1 && rs.counters.groundingSignalPreR9 && !rs.counters.groundingSignalPostR9)) &&
34
42
  rs.counters.wroteThisRun &&
@@ -149,7 +157,7 @@ export function runStopAndFinalVerify(input) {
149
157
  });
150
158
  }
151
159
  return messages;
152
- });
160
+ }
153
161
  }
154
162
  return {};
155
163
  }
@@ -21,7 +21,7 @@ export interface RunTelemetryAndBudgetSeatsInput {
21
21
  } | undefined;
22
22
  /** borrowed-readonly — the model catalog generation this task resolved against (pinned before prepare for swapDeps). */
23
23
  modelCatalog: RunnerDeps["models"];
24
- /** borrowed-readonly — the run's canonical task id (`spec.taskId ?? sessionId`), shared with the identity mint. */
24
+ /** borrowed-readonly — the leg's task id (`Prepared.taskId`), shared with the identity mint. */
25
25
  runSourceTaskId: string;
26
26
  /** borrowed-mutable — the run's mutable state: this lane is the WRITER of the `telemetry`, `degrade`, `limits` and
27
27
  * `budget` groups' initial values and function members. */
@@ -78,7 +78,7 @@ export interface RunTerminalAdoptionInput<R> {
78
78
  userInterruptedLive: boolean;
79
79
  /** borrowed-readonly — the run's caller-stop gate: the end-of-task pass admits on it and carries it (read LIVE, never snapshot). */
80
80
  callerStop: CallerStopGate;
81
- /** borrowed-readonly — the Runner's deployment deps, read LIVE (`onError`, `checkpointStore`, `onNotice`, `mediaByteCapBytes`); the one home of why it is
81
+ /** borrowed-readonly — the Runner's deployment deps, read LIVE (`onError`, `checkpointStore`, `onNotice`, `mediaBudgetBase64Chars`); the one home of why it is
82
82
  * a seat and not a captured object is {@link RunnerDepsSeat}. */
83
83
  runner: RunnerDepsSeat;
84
84
  /** borrowed-readonly — the session store: the end-of-task pass touches the leg's session through it (`finish`'s teardown legs). */
@@ -42,10 +42,10 @@ export async function runTerminalAdoption(input) {
42
42
  let reconcileComplete = false;
43
43
  if (interrupted) {
44
44
  try {
45
- const report = await reconcileInterruptedSession(prepared.session, prepared.toolEffects, undefined, startedToolCallIds);
45
+ const report = await reconcileInterruptedSession(prepared.session, prepared.toolEffects, undefined, startedToolCallIds, prepared.admitRows);
46
46
  orphansClosed = report.recovered.length;
47
47
  for (const orphan of report.recovered) {
48
- emitSettled(prepared.toolOccurrences, { toolCallId: orphan.toolCallId, spelledName: orphan.toolName, ...(toolLabels.has(orphan.toolName) ? { label: toolLabels.get(orphan.toolName) } : {}), args: orphan.args }, reconciledEnd(orphan), { push: (f) => queue.push({ ...f, ...ident() }), structured: prepared.structuredProjector, mediaByteCapBytes: runner.deps.mediaByteCapBytes });
48
+ emitSettled(prepared.toolOccurrences, { toolCallId: orphan.toolCallId, spelledName: orphan.toolName, ...(toolLabels.has(orphan.toolName) ? { label: toolLabels.get(orphan.toolName) } : {}), args: orphan.args }, reconciledEnd(orphan), { push: (f) => queue.push({ ...f, ...ident() }), structured: prepared.structuredProjector, mediaBudgetBase64Chars: runner.deps.mediaBudgetBase64Chars });
49
49
  emitCommitted(orphan.entryId, "toolResult", orphan.toolCallId);
50
50
  }
51
51
  reconcileComplete = true;
@@ -56,19 +56,27 @@ export async function runTerminalAdoption(input) {
56
56
  sessionId: prepared.sessionId,
57
57
  });
58
58
  }
59
- try {
60
- await prepared.harness.flushQueuedSessionWrites();
59
+ if (reconcileComplete) {
60
+ try {
61
+ await prepared.harness.flushQueuedSessionWrites();
62
+ }
63
+ catch (flushErr) {
64
+ runner.deps.onError?.(asThrownError(flushErr), {
65
+ phase: "interrupt-reconcile",
66
+ sessionId: prepared.sessionId,
67
+ });
68
+ }
61
69
  }
62
- catch (flushErr) {
63
- runner.deps.onError?.(asThrownError(flushErr), {
64
- phase: "interrupt-reconcile",
65
- sessionId: prepared.sessionId,
66
- });
70
+ else {
71
+ for (const write of prepared.harness.heldSessionWrites()) {
72
+ const what = write.type === "message" ? `a ${write.message.role} row` : `a ${write.type} write`;
73
+ runner.deps.onError?.(new Error(`held session write not stored: ${what} queued while the turn ran — the interrupted batch was not closed, and a write after an open batch breaks the transcript`), { phase: "interrupt-reconcile", sessionId: prepared.sessionId });
74
+ }
67
75
  }
68
76
  }
69
77
  if (interrupted && userInterruptedLive && reconcileComplete && !settled) {
70
78
  try {
71
- const entryId = await appendInterruptionMarker(prepared.session, { toolUseInFlight: orphansClosed > 0 });
79
+ const entryId = await appendInterruptionMarker(prepared.session, { toolUseInFlight: orphansClosed > 0, admitRows: prepared.admitRows });
72
80
  emitCommitted(entryId, "user");
73
81
  }
74
82
  catch (markerErr) {
@@ -131,7 +139,7 @@ export async function runTerminalAdoption(input) {
131
139
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.announce_dropped", version: 1, taskId: rs.telemetry.taskId, ts: Date.now() }));
132
140
  }
133
141
  const comp = await finish(spec, prepared, {
134
- telemetry: { tracer: rs.telemetry.tracer, taskId: rs.telemetry.taskId },
142
+ telemetry: { tracer: rs.telemetry.tracer },
135
143
  skipCompaction: durablyPaused || (abortedLive && settled) || callerStop.signal.aborted || compactionBreaker.failures >= MAX_CONSECUTIVE_COMPACTION_FAILURES,
136
144
  callerStop,
137
145
  minTokens: rs.counters.compactionFloor,
@@ -146,8 +154,9 @@ async function finish(spec, prepared, opts, runner, sessions) {
146
154
  let comp;
147
155
  if (!opts?.skipCompaction) {
148
156
  try {
149
- const finishComp = await maybeCompact({
157
+ const finishComp = await prepared.compactStation.compact({
150
158
  session: prepared.session,
159
+ admitRows: prepared.admitRows,
151
160
  promptIdentity: prepared.promptIdentity,
152
161
  ...centerAdoptionOption(prepared),
153
162
  model: prepared.harness.getModel(),
@@ -164,7 +173,7 @@ async function finish(spec, prepared, opts, runner, sessions) {
164
173
  minTokens: opts?.minTokens,
165
174
  overheadTokens: prepared.promptOverheadTokens,
166
175
  ...(prepared.activeTools.size > 0 ? { activeTools: [...prepared.activeTools] } : {}),
167
- onInputTruncated: emitInputTruncated(opts?.telemetry?.tracer ?? spec.tracer ?? runner.deps.tracer, opts?.telemetry?.taskId ?? spec.taskId ?? prepared.sessionId),
176
+ onInputTruncated: emitInputTruncated(opts?.telemetry?.tracer ?? spec.tracer ?? runner.deps.tracer, prepared.taskId),
168
177
  ...(opts?.windowSafety ?? {}),
169
178
  workingFileAttachments: buildWorkingFileAttachments(spec, prepared),
170
179
  ...contextInstructionFilesOption(prepared),
@@ -172,10 +181,10 @@ async function finish(spec, prepared, opts, runner, sessions) {
172
181
  ...seamCCompactionOptions(runner, prepared),
173
182
  ...compactionRestateOptions(prepared),
174
183
  ...compactionHookOptions(runner, prepared, "auto", opts.callerStop.signal), onStarted: opts.passReport.onStarted,
175
- });
184
+ }, maybeCompact);
176
185
  recordCompactionReuse(runner, prepared, finishComp);
177
186
  if (finishComp.unevaluableWindow) {
178
- discloseUnevaluableWindow(finishComp.unevaluableWindow, prepared, opts?.telemetry?.tracer ?? spec.tracer ?? runner.deps.tracer, opts?.telemetry?.taskId ?? spec.taskId ?? prepared.sessionId, runner.deps.onError);
187
+ discloseUnevaluableWindow(finishComp.unevaluableWindow, prepared, opts?.telemetry?.tracer ?? spec.tracer ?? runner.deps.tracer, prepared.taskId, runner.deps.onError);
179
188
  }
180
189
  comp = finishComp;
181
190
  }
@@ -184,7 +193,7 @@ async function finish(spec, prepared, opts, runner, sessions) {
184
193
  emitTrace(opts?.telemetry?.tracer ?? spec.tracer ?? runner.deps.tracer, () => ({
185
194
  kind: "compaction.mooted",
186
195
  version: 1,
187
- taskId: opts?.telemetry?.taskId ?? spec.taskId ?? prepared.sessionId,
196
+ taskId: prepared.taskId,
188
197
  reason: "cancelled",
189
198
  ts: Date.now(),
190
199
  }));
@@ -195,7 +204,7 @@ async function finish(spec, prepared, opts, runner, sessions) {
195
204
  emitTrace(opts?.telemetry?.tracer ?? spec.tracer ?? runner.deps.tracer, () => ({
196
205
  kind: "compaction.failed",
197
206
  version: 1,
198
- taskId: opts?.telemetry?.taskId ?? spec.taskId ?? prepared.sessionId,
207
+ taskId: prepared.taskId,
199
208
  trigger: "auto",
200
209
  reason: failReason,
201
210
  ts: Date.now(),
@@ -7,11 +7,14 @@ import { redactThenCut } from "../../agents/subagent-steps.js";
7
7
  import { ATTACHMENT_BYTE_CAP, CHANGED_FILES_MAX, TOTAL_TOKENS_REMINDER_DEFAULT_MODE, attachmentEnvelopeTags, clipToBytes, collectDateChange, collectDueAttachments, collectInstructionsChange, commitAgentListing, commitInstructionsChange, commitSkillsListing, isIntactSource, rebaseCadenceWindows, renderAgentListingFrame, renderMcpInstructionsDelta, selectMcpDroppedBatch, renderSkillsListingFrame } from "./turn-attachments.js";
8
8
  import { announceListingTruncation } from "../skill-listing-budget.js";
9
9
  import { buildWorkingFileAttachments, centerAdoptionOption, contextInstructionFilesOption, emitInputTruncated, forkContextOption, legCompactionSettings, legContextOverlayOption } from "./compaction-call-options.js";
10
- import { classicEventBase, dispatchClassic, stringMembersAnswer, stringMembersOf } from "../mods/stations.js";
10
+ import { classicEventBase, dispatchClassic, seatHears, stringMembersAnswer, stringMembersOf } from "../mods/stations.js";
11
+ import { offeredAgentListing } from "../mods/agent-stations.js";
12
+ import { raiseCompletedTurn } from "../mods/lifecycle-stations.js";
11
13
  import { sanitizeUntrustedText, SHELLED_BODY_ENVELOPE_TAGS } from "../untrusted-text.js";
12
14
  import { droppedToolDigest, withAnnounceDigests } from "./announce-once-ledger.js";
13
15
  import { formatDiagnosticsBlock, withholdListedDiagnostics } from "../lsp-diagnostics.js";
14
16
  import { workflowSizeGuidelineChangeNotice } from "../../orchestration/workflow-size-guideline.js";
17
+ import { requesterOf } from "../mods/session-compact.js";
15
18
  import { awaitChargeWithSlowDisclosure, discloseUnevaluableWindow, ENV_DUE_GOVERNANCE_READ_BUDGET_MS, GOVERNANCE_READ_STALLED, LIMIT_APPROACH_DEFAULT_THRESHOLDS, limitApproachFrames, platformLimitTerminal, raceUntilDeadline } from "./clock-and-limits.js";
16
19
  import { appendBoundaryFrames, compactionRestateOptions, frameCarried } from "./compaction-restate.js";
17
20
  import { COMPACTION_FREED_EPSILON, COMPACTION_REGROWTH_FACTOR, MAX_CONSECUTIVE_COMPACTION_FAILURES } from "./compaction-knobs.js";
@@ -33,6 +36,8 @@ export function createTurnBoundary(input) {
33
36
  let finalVerifySeenAtLastBoundary = 0;
34
37
  let legContinues = true;
35
38
  const boundaryPass = async (event) => {
39
+ if (rs.turn.completed !== undefined)
40
+ await prepared.compactStation.window((request) => compactInPlace(event.model, request), () => raiseCompletedTurn(prepared.modBus, rs.turn, prepared.hookIdentity, prepared.abortController.signal));
36
41
  const turnOwesRequest = event.continues;
37
42
  let boundarySteered = false;
38
43
  const noNextRequest = () => prepared.stopRequestedRef.current || deps.loopLatch.userHalted;
@@ -295,7 +300,8 @@ export function createTurnBoundary(input) {
295
300
  const undiscoveredTools = toolSearchReminderOn
296
301
  ? [...prepared.deferredToolNames].filter((n) => !prepared.activeTools.has(n)).sort()
297
302
  : undefined;
298
- const agentListingDue = rs.attach.agentListingOn && prepared.agentListing !== undefined && !frameCarried(prepared.frameReceipts, "agent_listing");
303
+ const agentListingOwed = rs.attach.agentListingOn && prepared.agentListing !== undefined && !frameCarried(prepared.frameReceipts, "agent_listing");
304
+ const offeredListing = !agentListingOwed ? undefined : seatHears({ bus: prepared.modBus }, "agent.offer") ? await offeredAgentListing({ bus: prepared.modBus }, prepared.agentListing, prepared.abortController.signal) : prepared.agentListing;
299
305
  const skillsListingDue = rs.attach.skillsListingOn && prepared.skillsListing !== undefined && !frameCarried(prepared.frameReceipts, "skills_listing");
300
306
  const listingBudget = prepared.skillsListing?.budget ?? prepared.agentListing?.budget;
301
307
  due.push(...collectDueAttachments(rs.attach.attachState, {
@@ -340,11 +346,11 @@ export function createTurnBoundary(input) {
340
346
  ? { readdedToolsSwappedUnderStatic: pendingReaddedTools.filter((n) => prepared.staticFaceFor?.(n) !== true) }
341
347
  : {}),
342
348
  ...(mcpToolsDelta !== undefined ? { mcpToolsDelta } : {}),
343
- ...(agentListingDue
349
+ ...(offeredListing !== undefined
344
350
  ? {
345
- agentListing: prepared.agentListing.entries,
346
- agentToolName: prepared.agentListing.toolName,
347
- ...(prepared.agentListing.models !== undefined ? { agentModels: prepared.agentListing.models } : {}),
351
+ agentListing: offeredListing.entries,
352
+ agentToolName: offeredListing.toolName,
353
+ ...(offeredListing.models !== undefined ? { agentModels: offeredListing.models } : {}),
348
354
  }
349
355
  : {}),
350
356
  ...(skillsListingDue ? { skillsListing: prepared.skillsListing.entries } : {}),
@@ -379,8 +385,8 @@ export function createTurnBoundary(input) {
379
385
  prepared.frameReceipts.listingSnapshotOwed = true;
380
386
  });
381
387
  }
382
- if (agentListingDue && due.some((a) => a.source === "agent_listing")) {
383
- const listing = prepared.agentListing;
388
+ if (offeredListing !== undefined && due.some((a) => a.source === "agent_listing")) {
389
+ const listing = offeredListing;
384
390
  const frame = renderAgentListingFrame(attachState, listing.entries, listing.toolName, listing.models, listing.budget);
385
391
  recordSteps.set("agent_listing", () => {
386
392
  commitAgentListing(attachState, listing.entries, listing.models);
@@ -498,6 +504,16 @@ export function createTurnBoundary(input) {
498
504
  prepared.frameReceipts.pending = prepared.frameReceipts.pending.filter((r) => r.text !== payload);
499
505
  });
500
506
  }
507
+ return await compactionPass(event.model);
508
+ };
509
+ const compactInPlace = async (model, request) => {
510
+ let outcome = "mooted";
511
+ manualCompactRef.waiters.push({ resolve: (o) => (outcome = o), ...(request.instructions !== undefined ? { instructions: request.instructions } : {}), requestedBy: request.requestedBy });
512
+ manualCompactRef.requested = true;
513
+ await compactionPass(model, request.call);
514
+ return outcome;
515
+ };
516
+ const compactionPass = async (model, call) => {
501
517
  const forceManual = manualCompactRef.requested;
502
518
  if ((!withinTaskCompaction() && !forceManual) ||
503
519
  prepared.abortController.signal.aborted ||
@@ -505,7 +521,7 @@ export function createTurnBoundary(input) {
505
521
  prepared.pausedRef.current !== undefined) {
506
522
  if (forceManual) {
507
523
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.mooted", version: 1, taskId: rs.telemetry.taskId, reason: "task_ending", ts: Date.now() }));
508
- queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: "manual", reason: "task_ending", ...ident() });
524
+ queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: "manual", reason: "task_ending", ...requesterOf(manualCompactRef.waiters), ...ident() });
509
525
  drainManualCompact("mooted");
510
526
  }
511
527
  legContinues = !prepared.abortController.signal.aborted && prepared.pausedRef.current === undefined;
@@ -521,7 +537,7 @@ export function createTurnBoundary(input) {
521
537
  reason: "compaction circuit breaker open (3 consecutive failures this task) — manual request drained without an attempt",
522
538
  ts: Date.now(),
523
539
  }));
524
- queue.push({ type: "compaction_outcome", outcome: "failed", trigger: "manual", reason: "compaction circuit breaker open (3 consecutive failures this task) — manual request drained without an attempt", ...ident() });
540
+ queue.push({ type: "compaction_outcome", outcome: "failed", trigger: "manual", reason: "compaction circuit breaker open (3 consecutive failures this task) — manual request drained without an attempt", ...requesterOf(manualCompactRef.waiters), ...ident() });
525
541
  drainManualCompact("failed");
526
542
  }
527
543
  return undefined;
@@ -542,6 +558,7 @@ export function createTurnBoundary(input) {
542
558
  if (forceManual) {
543
559
  manualCompactRef.requested = false;
544
560
  }
561
+ const requester = requesterOf(claimedManual?.waiters ?? []);
545
562
  const resolveClaimedWaiters = (outcome) => {
546
563
  if (claimedManual !== undefined)
547
564
  for (const w of claimedManual.waiters.splice(0))
@@ -559,11 +576,12 @@ export function createTurnBoundary(input) {
559
576
  const manualInstructions = claimedManual?.instructions;
560
577
  const passReport = compactionPassReport(queue, ident);
561
578
  try {
562
- const comp = await maybeCompact({
579
+ const comp = await prepared.compactStation.compact({
563
580
  session: prepared.session,
581
+ admitRows: prepared.admitRows,
564
582
  promptIdentity: prepared.promptIdentity,
565
583
  ...centerAdoptionOption(prepared),
566
- model: event.model,
584
+ model,
567
585
  ...legContextOverlayOption(prepared, runner),
568
586
  compactionModel: prepared.compModel,
569
587
  ...forkContextOption(prepared, false),
@@ -585,10 +603,10 @@ export function createTurnBoundary(input) {
585
603
  ...(prepared.onCompactionApplied ? { onApplied: prepared.onCompactionApplied } : {}),
586
604
  ...seamCCompactionOptions(runner, prepared),
587
605
  ...compactionRestateOptions(prepared),
588
- ...windowSafetyOptions(event.model),
606
+ ...windowSafetyOptions(model),
589
607
  ...compactionHookOptions(runner, prepared, passTrigger, compactionPassSignal),
590
608
  onStarted: passReport.onStarted,
591
- });
609
+ }, maybeCompact, { ...(manualInstructions !== undefined ? { instructions: manualInstructions } : {}), ...(call !== undefined ? { call } : {}) });
592
610
  if (comp.blocked) {
593
611
  emitTrace(rs.telemetry.tracer, () => ({
594
612
  kind: "compaction.blocked",
@@ -640,12 +658,12 @@ export function createTurnBoundary(input) {
640
658
  ? "noop"
641
659
  : undefined;
642
660
  if (outcome !== undefined) {
643
- queue.push({ type: "compaction_outcome", outcome, trigger: passTrigger, ...ident() });
661
+ queue.push({ type: "compaction_outcome", outcome, trigger: passTrigger, ...requester, ...ident() });
644
662
  }
645
663
  }
646
664
  recordCompactionReuse(runner, prepared, comp);
647
665
  if (comp.compacted) {
648
- queue.push(mintCompactedEvent(comp, passTrigger, ident()));
666
+ queue.push({ ...mintCompactedEvent(comp, passTrigger, ident()), ...requester });
649
667
  rs.counters.compactionPasses += 1;
650
668
  rs.counters.compactionKind = compactionKindOf(passTrigger);
651
669
  if (!forceManual && recordCompactionAndCheckRapidRefill(rapidRefill, stats.turns)) {
@@ -671,7 +689,7 @@ export function createTurnBoundary(input) {
671
689
  catch (err) {
672
690
  if (isCompactionManualCancel(err)) {
673
691
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.mooted", version: 1, taskId: rs.telemetry.taskId, reason: "cancelled", ts: Date.now() }));
674
- queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "cancelled", ...passReport.end, ...ident() });
692
+ queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "cancelled", ...passReport.end, ...requester, ...ident() });
675
693
  manualOutcome = "mooted";
676
694
  }
677
695
  else if (!prepared.abortController.signal.aborted) {
@@ -686,14 +704,14 @@ export function createTurnBoundary(input) {
686
704
  reason: failReason,
687
705
  ts: Date.now(),
688
706
  }));
689
- queue.push({ type: "compaction_outcome", outcome: "failed", trigger: passTrigger, reason: failReason, ...passReport.end, ...ident() });
707
+ queue.push({ type: "compaction_outcome", outcome: "failed", trigger: passTrigger, reason: failReason, ...passReport.end, ...requester, ...ident() });
690
708
  manualOutcome = "failed";
691
709
  }
692
710
  else {
693
711
  manualOutcome = "mooted";
694
712
  if (passReport.pass !== undefined) {
695
713
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.mooted", version: 1, taskId: rs.telemetry.taskId, reason: "task_ending", ts: Date.now() }));
696
- queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "task_ending", ...passReport.end, ...ident() });
714
+ queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "task_ending", ...passReport.end, ...requester, ...ident() });
697
715
  }
698
716
  }
699
717
  }