@sema-agent/core 7.60.0 → 7.62.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 (560) hide show
  1. package/CHANGELOG.md +917 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +71 -12
  6. package/dist/agents/cascade.js +61 -21
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-held-queue.d.ts +27 -4
  17. package/dist/agents/peer-held-queue.js +81 -36
  18. package/dist/agents/peer-notice-route.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.js +4 -3
  20. package/dist/agents/peer-notices.d.ts +4 -4
  21. package/dist/agents/peer-notices.js +8 -4
  22. package/dist/agents/peer-session-drain.d.ts +8 -1
  23. package/dist/agents/peer-session-drain.js +49 -10
  24. package/dist/agents/repair-loop.js +16 -6
  25. package/dist/agents/retain-ledger.js +3 -1
  26. package/dist/agents/roster-store.d.ts +1 -1
  27. package/dist/agents/roster-store.js +7 -4
  28. package/dist/agents/send-message-tool.d.ts +8 -10
  29. package/dist/agents/send-message-tool.js +43 -23
  30. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  31. package/dist/agents/subagent-completion-gate.js +62 -0
  32. package/dist/agents/subagent-steps.d.ts +7 -6
  33. package/dist/agents/subagent.d.ts +36 -41
  34. package/dist/agents/subagent.js +245 -200
  35. package/dist/agents/suspend-guard.d.ts +47 -16
  36. package/dist/agents/suspend-guard.js +13 -4
  37. package/dist/agents/verify.d.ts +41 -14
  38. package/dist/agents/verify.js +41 -30
  39. package/dist/brain/anthropic.js +1 -0
  40. package/dist/brain/errors.d.ts +7 -1
  41. package/dist/brain/errors.js +6 -0
  42. package/dist/brain/failover.js +2 -1
  43. package/dist/brain/open-responses.js +1 -0
  44. package/dist/brain/openai.js +1 -0
  45. package/dist/brain/provider-dialect.d.ts +10 -0
  46. package/dist/brain/provider-dialect.js +13 -2
  47. package/dist/brain/stream-engine.d.ts +3 -0
  48. package/dist/brain/stream-engine.js +4 -0
  49. package/dist/core/agent-state.d.ts +1 -1
  50. package/dist/core/allow-entry.d.ts +59 -23
  51. package/dist/core/allow-entry.js +131 -38
  52. package/dist/core/ask-origin.d.ts +79 -0
  53. package/dist/core/ask-origin.js +76 -0
  54. package/dist/core/ask-question.d.ts +19 -13
  55. package/dist/core/ask-question.js +8 -2
  56. package/dist/core/auto-compaction.d.ts +2 -0
  57. package/dist/core/auto-compaction.js +2 -1
  58. package/dist/core/auto-mode.js +3 -5
  59. package/dist/core/background-agent-store.d.ts +7 -5
  60. package/dist/core/background-agent-store.js +12 -11
  61. package/dist/core/checkpoint-features.d.ts +722 -0
  62. package/dist/core/checkpoint-features.js +98 -0
  63. package/dist/core/checkpoint-requirements.d.ts +33 -5
  64. package/dist/core/checkpoint-requirements.js +18 -5
  65. package/dist/core/checkpoint-row-verdict.d.ts +99 -0
  66. package/dist/core/checkpoint-row-verdict.js +225 -0
  67. package/dist/core/checkpoint-store.d.ts +107 -738
  68. package/dist/core/checkpoint-store.js +45 -143
  69. package/dist/core/child-clamp-seats.d.ts +3 -2
  70. package/dist/core/child-clamp-seats.js +4 -3
  71. package/dist/core/closest-name.d.ts +13 -0
  72. package/dist/core/closest-name.js +35 -0
  73. package/dist/core/context-settings.js +3 -5
  74. package/dist/core/cross-boundary-taint.d.ts +1 -1
  75. package/dist/core/decision-receipt.d.ts +14 -1
  76. package/dist/core/decision-receipt.js +6 -3
  77. package/dist/core/delegation-frames.d.ts +13 -9
  78. package/dist/core/effective-path-target.js +2 -3
  79. package/dist/core/engine-attestation.d.ts +11 -1
  80. package/dist/core/engine-attestation.js +2 -0
  81. package/dist/core/engine-notice.d.ts +68 -21
  82. package/dist/core/engine-notice.js +9 -2
  83. package/dist/core/file-history-retention.d.ts +8 -0
  84. package/dist/core/file-history-retention.js +14 -11
  85. package/dist/core/file-history-store.d.ts +31 -1
  86. package/dist/core/file-history-store.js +31 -2
  87. package/dist/core/frame-settlement.d.ts +10 -0
  88. package/dist/core/frame-settlement.js +6 -1
  89. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  90. package/dist/core/fs-write-gate-policy.js +8 -7
  91. package/dist/core/gate-fold.js +4 -3
  92. package/dist/core/gate-lanes.js +7 -4
  93. package/dist/core/gate-outcome.d.ts +40 -1
  94. package/dist/core/gate-outcome.js +10 -0
  95. package/dist/core/git-worktree-env.d.ts +7 -3
  96. package/dist/core/git-worktree-env.js +16 -13
  97. package/dist/core/governance-codes.d.ts +14 -4
  98. package/dist/core/governance-codes.js +19 -4
  99. package/dist/core/hooks.d.ts +25 -4
  100. package/dist/core/hooks.js +11 -4
  101. package/dist/core/host-floor.js +3 -5
  102. package/dist/core/human-input-projection.d.ts +1 -0
  103. package/dist/core/human-input-projection.js +3 -0
  104. package/dist/core/image-admission.d.ts +47 -7
  105. package/dist/core/image-admission.js +35 -4
  106. package/dist/core/input-author.d.ts +36 -0
  107. package/dist/core/input-author.js +39 -0
  108. package/dist/core/leg-identity.d.ts +62 -0
  109. package/dist/core/leg-identity.js +18 -0
  110. package/dist/core/locked-config.d.ts +4 -3
  111. package/dist/core/locked-config.js +5 -3
  112. package/dist/core/lsp.d.ts +5 -3
  113. package/dist/core/lsp.js +3 -2
  114. package/dist/core/mailbox-store.d.ts +85 -10
  115. package/dist/core/mailbox-store.js +31 -10
  116. package/dist/core/mcp-connection-pool.d.ts +6 -20
  117. package/dist/core/mcp-connection-pool.js +10 -28
  118. package/dist/core/mcp-failure.d.ts +76 -15
  119. package/dist/core/mcp-failure.js +60 -33
  120. package/dist/core/mcp-host-seat.d.ts +92 -53
  121. package/dist/core/mcp-host-seat.js +225 -46
  122. package/dist/core/mcp-probe.js +2 -2
  123. package/dist/core/mcp-server-link.d.ts +18 -6
  124. package/dist/core/mcp-server-link.js +19 -4
  125. package/dist/core/mcp-server-spec.d.ts +2 -1
  126. package/dist/core/mcp-session-end.d.ts +1 -2
  127. package/dist/core/mcp-session-end.js +1 -1
  128. package/dist/core/mcp.d.ts +6 -49
  129. package/dist/core/mcp.js +115 -111
  130. package/dist/core/media-byte-cap.d.ts +21 -46
  131. package/dist/core/media-byte-cap.js +55 -55
  132. package/dist/core/member-group.d.ts +7 -0
  133. package/dist/core/member-group.js +35 -0
  134. package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
  135. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  136. package/dist/core/memory-engine/consolidation.js +7 -1
  137. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  138. package/dist/core/memory-engine/dual-root.js +59 -11
  139. package/dist/core/memory-engine/engine.js +27 -24
  140. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  141. package/dist/core/memory-engine/file-backend.js +35 -15
  142. package/dist/core/memory-engine/layout.d.ts +3 -0
  143. package/dist/core/memory-engine/layout.js +13 -3
  144. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  145. package/dist/core/memory-engine/memory-deployment.js +182 -0
  146. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  147. package/dist/core/memory-engine/sync-client.js +72 -14
  148. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  149. package/dist/core/memory-engine/sync.d.ts +9 -1
  150. package/dist/core/memory-vector.d.ts +1 -1
  151. package/dist/core/memory.d.ts +10 -10
  152. package/dist/core/mode-policy.d.ts +8 -8
  153. package/dist/core/mode-policy.js +8 -6
  154. package/dist/core/mods/agent-stations.d.ts +39 -4
  155. package/dist/core/mods/agent-stations.js +59 -10
  156. package/dist/core/mods/classic-events.d.ts +9 -1
  157. package/dist/core/mods/dollar.d.ts +94 -1
  158. package/dist/core/mods/dollar.js +13 -1
  159. package/dist/core/mods/extension-call.d.ts +15 -1
  160. package/dist/core/mods/extension-call.js +7 -2
  161. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  162. package/dist/core/mods/kernel/dispatch.js +4 -4
  163. package/dist/core/mods/kernel/events.d.ts +14 -3
  164. package/dist/core/mods/kernel/events.js +18 -15
  165. package/dist/core/mods/kernel/registration.d.ts +3 -0
  166. package/dist/core/mods/kernel/registration.js +5 -0
  167. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  168. package/dist/core/mods/kernel/site-rules.js +10 -2
  169. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  170. package/dist/core/mods/lifecycle-stations.js +44 -9
  171. package/dist/core/mods/session-append.d.ts +118 -0
  172. package/dist/core/mods/session-append.js +318 -0
  173. package/dist/core/mods/session-compact.d.ts +48 -0
  174. package/dist/core/mods/session-compact.js +194 -0
  175. package/dist/core/mods/session-receive.d.ts +93 -0
  176. package/dist/core/mods/session-receive.js +138 -0
  177. package/dist/core/mods/session-send.d.ts +72 -0
  178. package/dist/core/mods/session-send.js +88 -0
  179. package/dist/core/mods/stations.d.ts +88 -21
  180. package/dist/core/mods/stations.js +149 -11
  181. package/dist/core/mods/tool-call.d.ts +2 -0
  182. package/dist/core/mods/tool-call.js +4 -4
  183. package/dist/core/output-style.js +3 -4
  184. package/dist/core/own-property-receipt.d.ts +68 -2
  185. package/dist/core/own-property-receipt.js +45 -2
  186. package/dist/core/park-selfcheck.js +4 -2
  187. package/dist/core/path-identity.d.ts +11 -0
  188. package/dist/core/path-identity.js +4 -0
  189. package/dist/core/path-rule-binding.d.ts +3 -1
  190. package/dist/core/path-rule-binding.js +3 -1
  191. package/dist/core/peer-seat.d.ts +3 -3
  192. package/dist/core/peer-seat.js +20 -8
  193. package/dist/core/permission-rule-consent.d.ts +21 -5
  194. package/dist/core/permission-rule-consent.js +21 -1
  195. package/dist/core/permission-rule-model.d.ts +34 -11
  196. package/dist/core/permission-rule-model.js +47 -10
  197. package/dist/core/permission-rule-org.d.ts +1 -1
  198. package/dist/core/permission-rule-provider.js +4 -1
  199. package/dist/core/permission-rules.d.ts +4 -0
  200. package/dist/core/permission-rules.js +11 -16
  201. package/dist/core/read-root-candidate.js +1 -1
  202. package/dist/core/remote-env.d.ts +74 -26
  203. package/dist/core/remote-env.js +20 -0
  204. package/dist/core/resume-startup-cause.d.ts +5 -4
  205. package/dist/core/retention-policy.d.ts +24 -23
  206. package/dist/core/retention-policy.js +36 -2
  207. package/dist/core/retention.d.ts +4 -1
  208. package/dist/core/retired-keys.d.ts +4 -4
  209. package/dist/core/row-admission.d.ts +10 -0
  210. package/dist/core/row-admission.js +5 -0
  211. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  212. package/dist/core/runner/advisor-instructions.js +2 -1
  213. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  214. package/dist/core/runner/assemble-result.d.ts +13 -3
  215. package/dist/core/runner/assemble-result.js +12 -7
  216. package/dist/core/runner/caller-roster.d.ts +12 -9
  217. package/dist/core/runner/caller-roster.js +5 -2
  218. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  219. package/dist/core/runner/checkpoint-scope.js +21 -0
  220. package/dist/core/runner/compact-session.js +18 -3
  221. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  222. package/dist/core/runner/compaction-restate.d.ts +2 -2
  223. package/dist/core/runner/compaction-restate.js +4 -3
  224. package/dist/core/runner/construction-doors.d.ts +2 -2
  225. package/dist/core/runner/construction-doors.js +2 -2
  226. package/dist/core/runner/contracts.d.ts +116 -34
  227. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  228. package/dist/core/runner/decide-continuation.d.ts +4 -2
  229. package/dist/core/runner/decide-continuation.js +7 -4
  230. package/dist/core/runner/delegation-owner.d.ts +43 -0
  231. package/dist/core/runner/delegation-owner.js +59 -0
  232. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  233. package/dist/core/runner/denial-limit-arms.js +17 -10
  234. package/dist/core/runner/expire-settle.d.ts +44 -0
  235. package/dist/core/runner/expire-settle.js +55 -0
  236. package/dist/core/runner/git-status-frame.d.ts +3 -3
  237. package/dist/core/runner/git-status-frame.js +2 -1
  238. package/dist/core/runner/halt-attribution.d.ts +2 -1
  239. package/dist/core/runner/halt-attribution.js +2 -1
  240. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  241. package/dist/core/runner/lineage-reroot-view.js +108 -0
  242. package/dist/core/runner/local-claims.d.ts +17 -0
  243. package/dist/core/runner/local-claims.js +18 -0
  244. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  245. package/dist/core/runner/media-removed-seat.js +88 -0
  246. package/dist/core/runner/park-commit.d.ts +2 -2
  247. package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
  248. package/dist/core/runner/permission-rule-lanes.js +28 -9
  249. package/dist/core/runner/person-path-rows.d.ts +15 -0
  250. package/dist/core/runner/person-path-rows.js +27 -4
  251. package/dist/core/runner/placement-fence.d.ts +26 -0
  252. package/dist/core/runner/placement-fence.js +38 -0
  253. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  254. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  255. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  256. package/dist/core/runner/prepare-ask-lane.js +4 -4
  257. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  258. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  259. package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
  260. package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
  261. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  262. package/dist/core/runner/prepare-config-doors.js +19 -21
  263. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  264. package/dist/core/runner/prepare-context-lane.js +13 -13
  265. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  266. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  267. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  268. package/dist/core/runner/prepare-execution-env.js +7 -4
  269. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  270. package/dist/core/runner/prepare-gate-stations.js +6 -4
  271. package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
  272. package/dist/core/runner/prepare-hands-readface.js +32 -11
  273. package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
  274. package/dist/core/runner/prepare-inherited-gate.js +10 -3
  275. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  276. package/dist/core/runner/prepare-lsp.js +2 -2
  277. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  278. package/dist/core/runner/prepare-park-ask.js +4 -5
  279. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  280. package/dist/core/runner/prepare-policy-chain.js +16 -25
  281. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  282. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  283. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  284. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  285. package/dist/core/runner/prepare-question-face.js +2 -2
  286. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  287. package/dist/core/runner/prepare-run-refs.js +2 -2
  288. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  289. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  290. package/dist/core/runner/prepare-task.d.ts +1 -1
  291. package/dist/core/runner/prepare-task.js +61 -30
  292. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  293. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  294. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  295. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  296. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  297. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  298. package/dist/core/runner/read-root-grant.d.ts +1 -1
  299. package/dist/core/runner/read-root-grant.js +2 -1
  300. package/dist/core/runner/resume-admission.d.ts +8 -6
  301. package/dist/core/runner/resume-admission.js +23 -6
  302. package/dist/core/runner/resume-apply.d.ts +4 -0
  303. package/dist/core/runner/resume-apply.js +14 -5
  304. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  305. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  306. package/dist/core/runner/resume-claim.d.ts +8 -3
  307. package/dist/core/runner/resume-claim.js +28 -12
  308. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  309. package/dist/core/runner/resume-internals-and-config.js +10 -1
  310. package/dist/core/runner/resume-preflight.d.ts +3 -2
  311. package/dist/core/runner/resume-preflight.js +13 -26
  312. package/dist/core/runner/retired-runner-deps.js +2 -0
  313. package/dist/core/runner/run-git-lane.d.ts +2 -0
  314. package/dist/core/runner/run-git-lane.js +6 -2
  315. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  316. package/dist/core/runner/run-harness-handlers.js +5 -4
  317. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  318. package/dist/core/runner/run-identity-wiring.js +14 -5
  319. package/dist/core/runner/run-leg.d.ts +3 -3
  320. package/dist/core/runner/run-leg.js +64 -36
  321. package/dist/core/runner/run-notification-lane.js +20 -2
  322. package/dist/core/runner/run-recovery-lanes.js +3 -2
  323. package/dist/core/runner/run-settle-and-teardown.js +12 -9
  324. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  325. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  326. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  327. package/dist/core/runner/run-terminal-adoption.js +26 -17
  328. package/dist/core/runner/run-turn-boundary.js +34 -18
  329. package/dist/core/runner/runtask.d.ts +18 -3
  330. package/dist/core/runner/runtask.js +33 -17
  331. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  332. package/dist/core/runner/session-rule-policy.js +6 -1
  333. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  334. package/dist/core/runner/steering-preview.d.ts +9 -0
  335. package/dist/core/runner/steering-preview.js +5 -0
  336. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  337. package/dist/core/runner/stream-halt-verbs.js +4 -3
  338. package/dist/core/runner/stream-reap.d.ts +7 -6
  339. package/dist/core/runner/stream-reap.js +13 -16
  340. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  341. package/dist/core/runner/stream-settle-backstop.js +5 -3
  342. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  343. package/dist/core/runner/stream-steer-verb.js +16 -7
  344. package/dist/core/runner/terminal-account.d.ts +11 -1
  345. package/dist/core/runner/terminal-account.js +20 -0
  346. package/dist/core/runner/terminal-projection.d.ts +8 -2
  347. package/dist/core/runner/terminal-projection.js +2 -2
  348. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  349. package/dist/core/runner/tool-disclosure.js +5 -2
  350. package/dist/core/runner/tool-end-body.d.ts +3 -3
  351. package/dist/core/runner/tool-end-body.js +1 -1
  352. package/dist/core/runner/tool-face-overlay.js +2 -0
  353. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  354. package/dist/core/runner/tool-output-projection.js +7 -6
  355. package/dist/core/runner/tool-table-view.d.ts +56 -0
  356. package/dist/core/runner/tool-table-view.js +51 -0
  357. package/dist/core/runner/turn-attachments.d.ts +8 -2
  358. package/dist/core/runner/turn-attachments.js +2 -2
  359. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  360. package/dist/core/runner/void-verifier-pause.js +41 -0
  361. package/dist/core/runner-deps.d.ts +26 -27
  362. package/dist/core/secret-env.d.ts +19 -16
  363. package/dist/core/secret-env.js +45 -27
  364. package/dist/core/session-log-transfer.js +9 -10
  365. package/dist/core/session-policy-store.d.ts +1 -1
  366. package/dist/core/session-policy-store.js +5 -2
  367. package/dist/core/session-reconcile.d.ts +3 -2
  368. package/dist/core/session-reconcile.js +7 -4
  369. package/dist/core/session-store.d.ts +3 -1
  370. package/dist/core/session-store.js +10 -8
  371. package/dist/core/session.d.ts +16 -5
  372. package/dist/core/shell-confinement.d.ts +37 -0
  373. package/dist/core/shell-confinement.js +56 -0
  374. package/dist/core/skill-grant.js +1 -1
  375. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
  376. package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
  377. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  378. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  379. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  380. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  381. package/dist/core/store-contracts/session-store-contract.js +22 -8
  382. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  383. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  384. package/dist/core/task-event.d.ts +24 -9
  385. package/dist/core/task-limits.d.ts +5 -0
  386. package/dist/core/task-notification.d.ts +89 -12
  387. package/dist/core/task-notification.js +89 -14
  388. package/dist/core/task-registry-agent.d.ts +32 -50
  389. package/dist/core/task-registry-agent.js +36 -56
  390. package/dist/core/task-registry-monitor.d.ts +1 -1
  391. package/dist/core/task-registry-monitor.js +15 -60
  392. package/dist/core/task-registry-shared.d.ts +22 -112
  393. package/dist/core/task-registry-shared.js +3 -41
  394. package/dist/core/task-registry-workflow.js +5 -21
  395. package/dist/core/task-registry.d.ts +32 -62
  396. package/dist/core/task-registry.js +30 -110
  397. package/dist/core/task-result.d.ts +29 -12
  398. package/dist/core/task-spec-members.d.ts +39 -0
  399. package/dist/core/task-spec-members.js +92 -0
  400. package/dist/core/task-spec.d.ts +11 -11
  401. package/dist/core/task-tool-shape.d.ts +7 -57
  402. package/dist/core/task-tool-shape.js +7 -66
  403. package/dist/core/terminal-cause.d.ts +36 -6
  404. package/dist/core/terminal-cause.js +1 -0
  405. package/dist/core/tool-catalog-entries.js +2 -5
  406. package/dist/core/tool-check-reading.js +16 -10
  407. package/dist/core/tool-conformance.js +1 -2
  408. package/dist/core/tool-errors.d.ts +6 -3
  409. package/dist/core/tool-errors.js +2 -0
  410. package/dist/core/tool-face-reader.js +3 -2
  411. package/dist/core/tool-face.d.ts +8 -5
  412. package/dist/core/tool-face.js +1 -1
  413. package/dist/core/tool-name-aliases.d.ts +5 -29
  414. package/dist/core/tool-name-aliases.js +9 -5
  415. package/dist/core/tool-name-readings.d.ts +14 -3
  416. package/dist/core/tool-name-readings.js +2 -0
  417. package/dist/core/tool-policy.d.ts +109 -18
  418. package/dist/core/tool-policy.js +84 -14
  419. package/dist/core/tool-result-store.d.ts +23 -0
  420. package/dist/core/tool-result-store.js +3 -2
  421. package/dist/core/tool-roster.d.ts +4 -4
  422. package/dist/core/tool-spec.d.ts +23 -6
  423. package/dist/core/trace.d.ts +18 -1
  424. package/dist/core/types.d.ts +1 -1
  425. package/dist/core/types.js +1 -1
  426. package/dist/core/user-attachment.js +26 -21
  427. package/dist/core/workflow-journal-store.d.ts +1 -1
  428. package/dist/core/workflow-run-store.d.ts +2 -0
  429. package/dist/core/workflow-run-store.js +6 -5
  430. package/dist/core/workflow-settled-run.d.ts +5 -0
  431. package/dist/core/workflow-settled-run.js +7 -0
  432. package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
  433. package/dist/engine/execution-env/node-execution-env.js +221 -22
  434. package/dist/engine/harness/agent-harness.d.ts +65 -18
  435. package/dist/engine/harness/agent-harness.js +90 -23
  436. package/dist/engine/harness/messages.d.ts +4 -3
  437. package/dist/engine/harness/messages.js +2 -2
  438. package/dist/engine/harness/types.d.ts +52 -7
  439. package/dist/engine/llm/media-removed.d.ts +14 -0
  440. package/dist/engine/llm/media-removed.js +9 -0
  441. package/dist/engine/llm/rejected-images.d.ts +35 -25
  442. package/dist/engine/llm/rejected-images.js +59 -10
  443. package/dist/engine/llm/types.d.ts +24 -3
  444. package/dist/engine/llm/types.js +7 -3
  445. package/dist/engine/loop/agent-loop.d.ts +6 -1
  446. package/dist/engine/loop/agent-loop.js +20 -11
  447. package/dist/engine/loop/types.d.ts +12 -3
  448. package/dist/engine/session/import-validate.js +7 -0
  449. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  450. package/dist/engine/session/parent-chain-guard.js +1 -1
  451. package/dist/engine/session/path-to-root.d.ts +18 -3
  452. package/dist/engine/session/path-to-root.js +15 -1
  453. package/dist/engine/session/repo-utils.d.ts +12 -1
  454. package/dist/engine/session/repo-utils.js +41 -0
  455. package/dist/engine/session/session.js +1 -1
  456. package/dist/engine/session/storage-base.d.ts +20 -0
  457. package/dist/engine/session/storage-base.js +28 -9
  458. package/dist/fixtures/index.d.ts +7 -5
  459. package/dist/fixtures/index.js +5 -3
  460. package/dist/index.d.ts +29 -18
  461. package/dist/index.js +19 -11
  462. package/dist/internal/harness-types.d.ts +2 -0
  463. package/dist/internal/harness.d.ts +4 -3
  464. package/dist/internal/harness.js +3 -2
  465. package/dist/internal/llm.d.ts +2 -1
  466. package/dist/internal/llm.js +1 -0
  467. package/dist/orchestration/goal.d.ts +6 -2
  468. package/dist/orchestration/goal.js +6 -3
  469. package/dist/orchestration/run-workflow-tool.d.ts +14 -17
  470. package/dist/orchestration/run-workflow-tool.js +43 -50
  471. package/dist/orchestration/workflow-types.d.ts +2 -2
  472. package/dist/orchestration/workflow.d.ts +7 -0
  473. package/dist/orchestration/workflow.js +10 -12
  474. package/dist/stores/file/background-agent-store.js +18 -15
  475. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  476. package/dist/stores/file/checkpoint-store.js +13 -9
  477. package/dist/stores/file/file-history-store.js +3 -2
  478. package/dist/stores/file/fs-atomic.d.ts +0 -22
  479. package/dist/stores/file/fs-atomic.js +0 -17
  480. package/dist/stores/file/index.d.ts +7 -12
  481. package/dist/stores/file/index.js +25 -12
  482. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  483. package/dist/stores/file/ledger-tuning.js +21 -0
  484. package/dist/stores/file/mailbox-store.js +42 -22
  485. package/dist/stores/file/memory-store.js +3 -2
  486. package/dist/stores/file/permission-rule-adopt.js +24 -21
  487. package/dist/stores/file/permission-rule-store.js +6 -3
  488. package/dist/stores/file/session-policy-store.js +3 -2
  489. package/dist/stores/file/session-store.d.ts +26 -7
  490. package/dist/stores/file/session-store.js +59 -35
  491. package/dist/stores/file/tool-result-store.d.ts +11 -0
  492. package/dist/stores/file/tool-result-store.js +57 -3
  493. package/dist/stores/file/usage-window-store.js +3 -2
  494. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  495. package/dist/stores/file/workflow-journal-store.js +3 -18
  496. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  497. package/dist/stores/file/workflow-run-store.js +15 -10
  498. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  499. package/dist/tools/fs/bash-program-position.js +7 -7
  500. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  501. package/dist/tools/fs/dead-cwd.js +4 -11
  502. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  503. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  504. package/dist/tools/fs/fs-bash.d.ts +3 -18
  505. package/dist/tools/fs/fs-bash.js +37 -124
  506. package/dist/tools/fs/fs-pdf.js +8 -6
  507. package/dist/tools/fs/fs-read.js +2 -2
  508. package/dist/tools/fs/fs-shared.d.ts +28 -3
  509. package/dist/tools/fs/fs-shared.js +15 -0
  510. package/dist/tools/fs/index.d.ts +1 -1
  511. package/dist/tools/fs/index.js +4 -14
  512. package/dist/tools/fs/pdf.d.ts +4 -4
  513. package/dist/tools/fs/pdf.js +6 -6
  514. package/dist/tools/fs/read-deny-home.js +8 -1
  515. package/dist/tools/fs/read-deny.d.ts +26 -2
  516. package/dist/tools/fs/read-deny.js +9 -2
  517. package/dist/tools/fs/read-floor.d.ts +13 -5
  518. package/dist/tools/fs/read-floor.js +206 -2
  519. package/dist/tools/fs/removal-targets.js +2 -2
  520. package/dist/tools/fs/search.d.ts +3 -2
  521. package/dist/tools/fs/search.js +6 -6
  522. package/dist/tools/fs/shell-read-argv.d.ts +4 -2
  523. package/dist/tools/fs/shell-read-argv.js +14 -3
  524. package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
  525. package/dist/tools/fs/shell-read-bindings.js +148 -68
  526. package/dist/tools/fs/shell-read-check.js +20 -4
  527. package/dist/tools/fs/shell-read-establish.js +25 -9
  528. package/dist/tools/fs/shell-read-functions.js +2 -2
  529. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  530. package/dist/tools/fs/shell-read-identity.js +4 -2
  531. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  532. package/dist/tools/fs/shell-read-judge.js +1 -1
  533. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  534. package/dist/tools/fs/shell-read-object-path.js +119 -0
  535. package/dist/tools/fs/shell-read-plan.d.ts +8 -0
  536. package/dist/tools/fs/shell-read-plan.js +47 -30
  537. package/dist/tools/fs/shell-read-start.d.ts +66 -13
  538. package/dist/tools/fs/shell-read-start.js +89 -17
  539. package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
  540. package/dist/tools/fs/shell-read-workdir.js +31 -8
  541. package/dist/tools/monitor.d.ts +8 -7
  542. package/dist/tools/monitor.js +12 -10
  543. package/dist/tools/worktree.d.ts +5 -1
  544. package/dist/tools/worktree.js +20 -17
  545. package/package.json +6 -3
  546. package/test/export-surface.snapshot.json +112 -42
  547. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  548. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  549. package/wire-changes/core@7.61.0.json +4405 -0
  550. package/wire-changes/core@7.62.0.json +2181 -0
  551. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  552. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  553. package/wire-changes/primitives@7.61.0.json +30 -0
  554. package/wire-changes/primitives@7.62.0.json +30 -0
  555. package/dist/core/consolidate-scope.d.ts +0 -93
  556. package/dist/core/consolidate-scope.js +0 -98
  557. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  558. package/dist/core/runner/image-removed-seat.js +0 -19
  559. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  560. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -6,7 +6,7 @@ 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
10
  import { raiseCompletedTurn, raiseSessionEnd } from "../mods/lifecycle-stations.js";
11
11
  import { modelCostToPricing } from "../pricing.js";
12
12
  import { hasDestroy, isIsolated } from "../remote-env.js";
@@ -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;
@@ -192,8 +194,9 @@ export async function runSettleAndTeardown(input) {
192
194
  taskIdRef.delegationTerminalOwed = undefined;
193
195
  if (rs.turn.completed !== undefined)
194
196
  await raiseCompletedTurn(prepared.modBus, rs.turn, prepared.hookIdentity, undefined);
195
- if (prepared.modBus.hasHandlers("session.end"))
196
- await raiseSessionEnd(prepared.modBus, prepared.hookIdentity, { reason: terminalFace.status, sessionId: prepared.sessionId });
197
+ const ending = raiseSessionEnd(prepared.modBus, prepared.hookIdentity, { reason: terminalFace.status, sessionId: prepared.sessionId });
198
+ if (ending !== undefined)
199
+ await ending;
197
200
  if (rs.degrade.degraded)
198
201
  result.degraded = rs.degrade.degraded;
199
202
  if (prepared.outputRef.set)
@@ -277,7 +280,7 @@ export async function runSettleAndTeardown(input) {
277
280
  }
278
281
  }
279
282
  finally {
280
- settleOwedUserInput(owedUserInput, !prepared.suspendProgressRef.executedApproved, { taskId: spec.taskId ?? prepared.sessionId, sessionId: prepared.sessionId, runId: prepared.runId, parent: parentLegIds(internals) }, runner.deps.onNotice);
283
+ settleOwedUserInput(owedUserInput, !prepared.suspendProgressRef.executedApproved, { taskId: prepared.taskId, sessionId: prepared.sessionId, runId: prepared.runId, parent: parentLegIds(internals) }, runner.deps.onNotice);
281
284
  const writeDateAnchor = owedDateAnchor(prepared.session, prepared.dateChange, rs.attach.dateState);
282
285
  if (writeDateAnchor !== undefined)
283
286
  await settleTeardownLeg(writeDateAnchor, "date anchor (settle leg)", (e) => runner.deps.onError?.(e, { phase: "degraded", sessionId: prepared.sessionId }));
@@ -1,6 +1,7 @@
1
1
  import { openSystemReminder } from "../reminder-mint.js";
2
2
  import { formatHookFeedback } from "../hooks.js";
3
3
  import { classicEventBase, dispatchClassic, legEventsOf, stringMembersAnswer, stringMembersOf } from "../mods/stations.js";
4
+ import { steeringPreview } from "./steering-preview.js";
4
5
  import { asThrownError } from "../thrown-value.js";
5
6
  const STOP_HOOK_BLOCK_CAP = 8;
6
7
  export function runStopAndFinalVerify(input) {
@@ -22,7 +23,7 @@ export function runStopAndFinalVerify(input) {
22
23
  return worst;
23
24
  };
24
25
  const emitFinalVerifyEcho = (body) => {
25
- queue.push({ type: "steering_injected", source: "final_verification", preview: body.slice(0, 220), ...ident() });
26
+ queue.push({ type: "steering_injected", source: "final_verification", preview: steeringPreview(body), ...ident() });
26
27
  };
27
28
  const owed = spec.oneShot === true ? deliveryObligations : undefined;
28
29
  if (stopArmed || finalVerificationOn || owed !== undefined) {
@@ -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(),
@@ -3,17 +3,18 @@ import { mintSystemReminder } from "../reminder-mint.js";
3
3
  import { eventDefaultOn } from "../../prompt-assembly/event-registry.js";
4
4
  import { compactionFailureReason, compactionPassReport, DEFAULT_COMPACTION_INSTRUCTIONS, isCompactionManualCancel, manualCompactOutcomeOf, maybeCompact, mintCompactedEvent, nextTrimForceBackoff, recordCompactionAndCheckRapidRefill } from "../auto-compaction.js";
5
5
  import { emitTrace } from "../trace.js";
6
- import { redactThenCut } from "../../agents/subagent-steps.js";
6
+ import { steeringPreview } from "./steering-preview.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
11
  import { offeredAgentListing } from "../mods/agent-stations.js";
12
- import { raiseCompletedTurn } from "../mods/lifecycle-stations.js";
12
+ import { measureSession, raiseCompletedTurn } from "../mods/lifecycle-stations.js";
13
13
  import { sanitizeUntrustedText, SHELLED_BODY_ENVELOPE_TAGS } from "../untrusted-text.js";
14
14
  import { droppedToolDigest, withAnnounceDigests } from "./announce-once-ledger.js";
15
15
  import { formatDiagnosticsBlock, withholdListedDiagnostics } from "../lsp-diagnostics.js";
16
16
  import { workflowSizeGuidelineChangeNotice } from "../../orchestration/workflow-size-guideline.js";
17
+ import { requesterOf } from "../mods/session-compact.js";
17
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";
18
19
  import { appendBoundaryFrames, compactionRestateOptions, frameCarried } from "./compaction-restate.js";
19
20
  import { COMPACTION_FREED_EPSILON, COMPACTION_REGROWTH_FACTOR, MAX_CONSECUTIVE_COMPACTION_FAILURES } from "./compaction-knobs.js";
@@ -36,7 +37,7 @@ export function createTurnBoundary(input) {
36
37
  let legContinues = true;
37
38
  const boundaryPass = async (event) => {
38
39
  if (rs.turn.completed !== undefined)
39
- await raiseCompletedTurn(prepared.modBus, rs.turn, prepared.hookIdentity, prepared.abortController.signal);
40
+ await prepared.compactStation.window((request) => compactInPlace(event.model, request), () => raiseCompletedTurn(prepared.modBus, rs.turn, prepared.hookIdentity, prepared.abortController.signal));
40
41
  const turnOwesRequest = event.continues;
41
42
  let boundarySteered = false;
42
43
  const noNextRequest = () => prepared.stopRequestedRef.current || deps.loopLatch.userHalted;
@@ -191,7 +192,7 @@ export function createTurnBoundary(input) {
191
192
  if (tightest !== undefined && tightest.ratio >= thresholds[index]) {
192
193
  const percent = Math.min(100, Math.round(tightest.ratio * 100));
193
194
  const body = limitApproachFrames(index === 0 ? 0 : 1, tightest.axis, percent, prepared.reminderMark);
194
- const preview = body.slice(0, 220);
195
+ const preview = steeringPreview(body);
195
196
  prepared.frameReceipts.pending.push({
196
197
  source: "limit_approach",
197
198
  text: body,
@@ -300,7 +301,7 @@ export function createTurnBoundary(input) {
300
301
  ? [...prepared.deferredToolNames].filter((n) => !prepared.activeTools.has(n)).sort()
301
302
  : undefined;
302
303
  const agentListingOwed = rs.attach.agentListingOn && prepared.agentListing !== undefined && !frameCarried(prepared.frameReceipts, "agent_listing");
303
- const offeredListing = !agentListingOwed ? undefined : prepared.modBus.hasHandlers("agent.offer") ? await offeredAgentListing(prepared.modBus, prepared.agentListing, prepared.abortController.signal) : prepared.agentListing;
304
+ const offeredListing = !agentListingOwed ? undefined : seatHears({ bus: prepared.modBus }, "agent.offer") ? await offeredAgentListing({ bus: prepared.modBus }, prepared.agentListing, prepared.abortController.signal) : prepared.agentListing;
304
305
  const skillsListingDue = rs.attach.skillsListingOn && prepared.skillsListing !== undefined && !frameCarried(prepared.frameReceipts, "skills_listing");
305
306
  const listingBudget = prepared.skillsListing?.budget ?? prepared.agentListing?.budget;
306
307
  due.push(...collectDueAttachments(rs.attach.attachState, {
@@ -457,7 +458,7 @@ export function createTurnBoundary(input) {
457
458
  bundleReceipts.push({
458
459
  source: a.source,
459
460
  commit: () => {
460
- queue.push({ type: "steering_injected", source: a.source, preview: redactThenCut(a.body, 220), ...ident() });
461
+ queue.push({ type: "steering_injected", source: a.source, preview: steeringPreview(a.body, a.echoBound), ...ident() });
461
462
  rs.attach.attachmentsInjected += 1;
462
463
  record?.();
463
464
  },
@@ -503,6 +504,16 @@ export function createTurnBoundary(input) {
503
504
  prepared.frameReceipts.pending = prepared.frameReceipts.pending.filter((r) => r.text !== payload);
504
505
  });
505
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) => {
506
517
  const forceManual = manualCompactRef.requested;
507
518
  if ((!withinTaskCompaction() && !forceManual) ||
508
519
  prepared.abortController.signal.aborted ||
@@ -510,7 +521,7 @@ export function createTurnBoundary(input) {
510
521
  prepared.pausedRef.current !== undefined) {
511
522
  if (forceManual) {
512
523
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.mooted", version: 1, taskId: rs.telemetry.taskId, reason: "task_ending", ts: Date.now() }));
513
- 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() });
514
525
  drainManualCompact("mooted");
515
526
  }
516
527
  legContinues = !prepared.abortController.signal.aborted && prepared.pausedRef.current === undefined;
@@ -526,7 +537,7 @@ export function createTurnBoundary(input) {
526
537
  reason: "compaction circuit breaker open (3 consecutive failures this task) — manual request drained without an attempt",
527
538
  ts: Date.now(),
528
539
  }));
529
- 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() });
530
541
  drainManualCompact("failed");
531
542
  }
532
543
  return undefined;
@@ -547,6 +558,7 @@ export function createTurnBoundary(input) {
547
558
  if (forceManual) {
548
559
  manualCompactRef.requested = false;
549
560
  }
561
+ const requester = requesterOf(claimedManual?.waiters ?? []);
550
562
  const resolveClaimedWaiters = (outcome) => {
551
563
  if (claimedManual !== undefined)
552
564
  for (const w of claimedManual.waiters.splice(0))
@@ -564,11 +576,12 @@ export function createTurnBoundary(input) {
564
576
  const manualInstructions = claimedManual?.instructions;
565
577
  const passReport = compactionPassReport(queue, ident);
566
578
  try {
567
- const comp = await maybeCompact({
579
+ const comp = await prepared.compactStation.compact({
568
580
  session: prepared.session,
581
+ admitRows: prepared.admitRows,
569
582
  promptIdentity: prepared.promptIdentity,
570
583
  ...centerAdoptionOption(prepared),
571
- model: event.model,
584
+ model,
572
585
  ...legContextOverlayOption(prepared, runner),
573
586
  compactionModel: prepared.compModel,
574
587
  ...forkContextOption(prepared, false),
@@ -590,10 +603,10 @@ export function createTurnBoundary(input) {
590
603
  ...(prepared.onCompactionApplied ? { onApplied: prepared.onCompactionApplied } : {}),
591
604
  ...seamCCompactionOptions(runner, prepared),
592
605
  ...compactionRestateOptions(prepared),
593
- ...windowSafetyOptions(event.model),
606
+ ...windowSafetyOptions(model),
594
607
  ...compactionHookOptions(runner, prepared, passTrigger, compactionPassSignal),
595
608
  onStarted: passReport.onStarted,
596
- });
609
+ }, maybeCompact, { ...(manualInstructions !== undefined ? { instructions: manualInstructions } : {}), ...(call !== undefined ? { call } : {}) });
597
610
  if (comp.blocked) {
598
611
  emitTrace(rs.telemetry.tracer, () => ({
599
612
  kind: "compaction.blocked",
@@ -610,6 +623,9 @@ export function createTurnBoundary(input) {
610
623
  if (comp.contextUsage) {
611
624
  const sections = contextUsageSections(prepared.promptManifest.sections);
612
625
  queue.push({ type: "context_usage", ...comp.contextUsage, ...(sections !== undefined ? { sections } : {}), ...ident() });
626
+ const measured = measureSession(prepared.modBus, prepared.sessionMeasure, comp.contextUsage, prepared.hookIdentity, prepared.abortController.signal);
627
+ if (measured !== undefined)
628
+ await measured;
613
629
  }
614
630
  if (comp.unevaluableWindow) {
615
631
  discloseUnevaluableWindow(comp.unevaluableWindow, prepared, rs.telemetry.tracer, rs.telemetry.taskId, runnerHooks.onError);
@@ -645,12 +661,12 @@ export function createTurnBoundary(input) {
645
661
  ? "noop"
646
662
  : undefined;
647
663
  if (outcome !== undefined) {
648
- queue.push({ type: "compaction_outcome", outcome, trigger: passTrigger, ...ident() });
664
+ queue.push({ type: "compaction_outcome", outcome, trigger: passTrigger, ...requester, ...ident() });
649
665
  }
650
666
  }
651
667
  recordCompactionReuse(runner, prepared, comp);
652
668
  if (comp.compacted) {
653
- queue.push(mintCompactedEvent(comp, passTrigger, ident()));
669
+ queue.push({ ...mintCompactedEvent(comp, passTrigger, ident()), ...requester });
654
670
  rs.counters.compactionPasses += 1;
655
671
  rs.counters.compactionKind = compactionKindOf(passTrigger);
656
672
  if (!forceManual && recordCompactionAndCheckRapidRefill(rapidRefill, stats.turns)) {
@@ -676,7 +692,7 @@ export function createTurnBoundary(input) {
676
692
  catch (err) {
677
693
  if (isCompactionManualCancel(err)) {
678
694
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.mooted", version: 1, taskId: rs.telemetry.taskId, reason: "cancelled", ts: Date.now() }));
679
- queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "cancelled", ...passReport.end, ...ident() });
695
+ queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "cancelled", ...passReport.end, ...requester, ...ident() });
680
696
  manualOutcome = "mooted";
681
697
  }
682
698
  else if (!prepared.abortController.signal.aborted) {
@@ -691,14 +707,14 @@ export function createTurnBoundary(input) {
691
707
  reason: failReason,
692
708
  ts: Date.now(),
693
709
  }));
694
- queue.push({ type: "compaction_outcome", outcome: "failed", trigger: passTrigger, reason: failReason, ...passReport.end, ...ident() });
710
+ queue.push({ type: "compaction_outcome", outcome: "failed", trigger: passTrigger, reason: failReason, ...passReport.end, ...requester, ...ident() });
695
711
  manualOutcome = "failed";
696
712
  }
697
713
  else {
698
714
  manualOutcome = "mooted";
699
715
  if (passReport.pass !== undefined) {
700
716
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.mooted", version: 1, taskId: rs.telemetry.taskId, reason: "task_ending", ts: Date.now() }));
701
- queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "task_ending", ...passReport.end, ...ident() });
717
+ queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "task_ending", ...passReport.end, ...requester, ...ident() });
702
718
  }
703
719
  }
704
720
  }
@@ -56,9 +56,9 @@ export declare class Runner implements RunnerSelfSeat {
56
56
  * the ORIGINAL stream's closure as the reaping owner, deliberately), and when the terminal arm
57
57
  * wins. Bounded by live suspended streams (the closures hold the same handles). */
58
58
  private readonly suspendedEnvReaps;
59
- /** SAME-RUNNER claim marks for {@link suspendedEnvReaps}: a token appears
60
- * here from the moment an in-process actor ATTEMPTS its settling CAS (the terminal preflight's
61
- * expire; a resume's resolve) until that actor's duty decision is done. The losing stream-side
59
+ /** SAME-RUNNER claims for {@link suspendedEnvReaps}, one PER ATTEMPT: a token is held from the moment an
60
+ * in-process actor ATTEMPTS its settling CAS (the terminal preflight's or the void verb's expire; a resume's
61
+ * resolve) until that actor's duty decision closes its own claim (never another's). The losing stream-side
62
62
  * reap preserves a record ONLY while a local claim is in flight — a CROSS-Runner settlement
63
63
  * leaves no local claim, so the loser retires the record (drops the strong ref; physical cleanup
64
64
  * belongs to the winning owner, unprovable from here) instead of retaining env handles without
@@ -259,6 +259,21 @@ export declare class Runner implements RunnerSelfSeat {
259
259
  * authority, so constraint substitution here is outside the enforced threat model (the count check
260
260
  * catches shape MISTAKES, not a untrusted trusted caller). */
261
261
  internals?: RunInternals): Promise<TaskStream>;
262
+ /**
263
+ * Void a verification gate's VERIFIER card — the pause `VerificationOutcome.verifierPause` hands back — and unpin the verifier
264
+ * session it held: the cancel a host that will not decide the card takes, instead of leaving it to the reaper. The card is
265
+ * read first: only one whose `CheckpointState.compositionLeg` records a `verify` leg is voided (any other is refused,
266
+ * `resume.composition_mismatch`, nothing settled). Voiding is the single-shot expire CAS — the row ends `expired`, the same end
267
+ * an expiry gives it (a later resume of the token is refused as after one, `checkpoint.already_resolved`; the gate's result the
268
+ * caller holds is untouched), with the same duty (the paused env this process holds destroyed, the parked-constraint entry evicted) —
269
+ * and then the session is UNPINNED, the end state a resumed run's terminal leaves (not released: its transcript stays the
270
+ * session store's to evict). Resolves `true` when this call voided the card, `false` when another settler already had (a
271
+ * resume won, the reaper or an earlier void expired it) — its winner owns the unpin; an expired row's env this process holds is
272
+ * still destroyed (whoever expired it), and calling again answers `false`.
273
+ * @throws {@link CheckpointError} `not_found` (no store wired / unknown token), `resume.composition_mismatch` (not a verifier's card),
274
+ * `checkpoint.void_unpin_failed` (voided, but the session's unpin threw or wedged: still pinned).
275
+ */
276
+ voidVerifierPause(token: CheckpointToken): Promise<boolean>;
262
277
  /**
263
278
  * The resume decision ladder after admission (E3–E10), driving the eight `resume-*` lanes in
264
279
  * the order the one-function ladder had: the review / park twins, the approval twin and its bindings, the
@@ -1,3 +1,5 @@
1
+ import { legTaskIdOf } from "../leg-identity.js";
2
+ import { restoreRowTaskId } from "./checkpoint-scope.js";
1
3
  import { deliverEngineNotice } from "../types.js";
2
4
  import { withDeploymentAllowedTools } from "../allow-entry.js";
3
5
  import { uuidv7 } from "../../internal/harness.js";
@@ -38,9 +40,12 @@ import { resumeInternalsAndConfig } from "./resume-internals-and-config.js";
38
40
  import { resumeApply } from "./resume-apply.js";
39
41
  import { resumePreflight } from "./resume-preflight.js";
40
42
  import { resumeClaim } from "./resume-claim.js";
43
+ import { voidVerifierPause } from "./void-verifier-pause.js";
44
+ import { LocalClaims } from "./local-claims.js";
41
45
  import { streamSettleBackstop } from "./stream-settle-backstop.js";
42
46
  import { streamReap } from "./stream-reap.js";
43
47
  import { streamSteerVerb } from "./stream-steer-verb.js";
48
+ import { bindAuthoredSteer } from "../input-author.js";
44
49
  import { steeringError } from "./steer-admission.js";
45
50
  import { streamLifecycleVerbs } from "./stream-lifecycle-verbs.js";
46
51
  import { streamHaltVerbs } from "./stream-halt-verbs.js";
@@ -69,6 +74,7 @@ import { compactIdleSession } from "./compact-session.js";
69
74
  import { egressThrownText } from "../untrusted-egress.js";
70
75
  import { holdPeerDeclarations } from "../peer-seat.js";
71
76
  import { receivePeerDeclarations, receivedDeclarations } from "../locked-config.js";
77
+ import { readCallerSpec } from "../task-spec-members.js";
72
78
  export class Runner {
73
79
  deps;
74
80
  sessions;
@@ -80,7 +86,7 @@ export class Runner {
80
86
  pendingSessionNotifications = new PendingSessionNotifications();
81
87
  parentConstraintRegistry = new Map();
82
88
  suspendedEnvReaps = new Map();
83
- locallyClaimedTokens = new Set();
89
+ locallyClaimedTokens = new LocalClaims();
84
90
  static PARENT_CONSTRAINT_REGISTRY_CAP = 1024;
85
91
  depsSeat;
86
92
  constructor(deps) {
@@ -253,6 +259,7 @@ export class Runner {
253
259
  throw new TypeError("runTaskStream: `resume` must be a ResumeRun carrying `outcome` — got a value without one. " +
254
260
  "(Note the parameter order: runTaskStream(spec, resume?, internals?) — internals is the THIRD parameter.)");
255
261
  }
262
+ spec = readCallerSpec(spec).spec;
256
263
  const entryActor = spec.actor === undefined ? undefined : snapshotActorAssertion(spec.actor);
257
264
  const entryTracer = { tracer: spec.tracer ?? this.deps.tracer };
258
265
  const queue = new PushQueue();
@@ -284,7 +291,7 @@ export class Runner {
284
291
  w.resolve(outcome);
285
292
  };
286
293
  const runStartedAt = Date.now();
287
- const taskIdRef = { current: spec.taskId, sessionId: spec.sessionId };
294
+ const taskIdRef = { current: legTaskIdOf(spec, restoreRowTaskId(internals, resume?.cp.state.rowTaskId), undefined), sessionId: spec.sessionId };
288
295
  let held;
289
296
  let releaseLock;
290
297
  const holdSessionLock = (sessionId) => {
@@ -311,7 +318,7 @@ export class Runner {
311
318
  resultValue = r;
312
319
  const pcs = internals?.inheritedGate?.parentConstraints;
313
320
  if (resume !== undefined)
314
- this.locallyClaimedTokens.delete(resume.cp.token);
321
+ this.locallyClaimedTokens.close(resume.cp.token);
315
322
  const rToken = r.terminal.kind === "paused" ? r.terminal.token : undefined;
316
323
  if (resume !== undefined && rToken !== resume.cp.token) {
317
324
  this.parentConstraintRegistry.delete(resume.cp.token);
@@ -375,11 +382,11 @@ export class Runner {
375
382
  live, runner: this.depsSeat,
376
383
  locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
377
384
  });
378
- const { steer } = streamSteerVerb({ spec, internals, queue, acceptedSteerInputs, live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, steeringError, runner: this.depsSeat });
385
+ const { steer, authoredSteer } = streamSteerVerb({ spec, internals, queue, acceptedSteerInputs, live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, steeringError, runner: this.depsSeat });
379
386
  const { notify, optOutMemoryCapture, reconnectMcpServer, compact, detach, interrupt } = streamLifecycleVerbs({ live, ready, orTimeout, steeringError, notifyRef, captureOptOutRef, mcpRedialRef, manualCompactRef, detachHub });
380
- const { halt, destroy } = streamHaltVerbs({ spec, live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, run, reapSuspended, runner: this.depsSeat });
387
+ const { halt, destroy } = streamHaltVerbs({ live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, run, reapSuspended, runner: this.depsSeat });
381
388
  const { setPermissionMode } = streamModeVerb({ live, ready, orTimeout, steeringError });
382
- return {
389
+ const stream = {
383
390
  [Symbol.asyncIterator]: () => queue[Symbol.asyncIterator](),
384
391
  result: async () => {
385
392
  await settled;
@@ -400,6 +407,8 @@ export class Runner {
400
407
  halt,
401
408
  destroy,
402
409
  };
410
+ bindAuthoredSteer(stream, authoredSteer);
411
+ return stream;
403
412
  }
404
413
  runLocked(input) {
405
414
  const { spec, queue, setResult, onSuggestions, onReady, onSuspend, manualCompactRef, taskIdRef, holdSessionLock, legWrites, resume, internals, notifyRef, captureOptOutRef, mcpRedialRef, entryActor, entryTracer } = input;
@@ -425,16 +434,16 @@ export class Runner {
425
434
  const { withBrainSinks, withLegRequestSinks } = runBrainSinks({ queue, internals, rs, ident, observeReasoningWireFacts, notice: { onNotice: this.deps.onNotice, sessionId: prepared.sessionId, runId: prepared.runId }, announced: prepared });
426
435
  const toolLabels = new Map(prepared.tools.flatMap((t) => (t.label !== undefined && t.label !== t.name ? [[t.name, t.label]] : [])));
427
436
  for (const orphan of prepared.wakeRecovered) {
428
- 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: this.deps.mediaByteCapBytes });
437
+ 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: this.deps.mediaBudgetBase64Chars });
429
438
  emitCommitted(orphan.entryId, "toolResult", orphan.toolCallId);
430
439
  }
431
440
  const postToolBatchArmed = prepared.modBus.hasHandlers("classic.PostToolBatch");
432
441
  const batchArgs = postToolBatchArmed ? new Map() : undefined;
433
442
  rs.turn.toolBatch = [];
434
- const { onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, announceWorkspaceMove } = createHarnessHandlers({
443
+ const { onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, onTurnStart, announceWorkspaceMove } = createHarnessHandlers({
435
444
  prepared, stats, rs,
436
445
  deps: {
437
- spec, queue, internals, ident, mediaByteCapBytes: this.deps.mediaByteCapBytes,
446
+ spec, queue, internals, ident, mediaBudgetBase64Chars: this.deps.mediaBudgetBase64Chars,
438
447
  pushContent, emitCommitted, startedToolCallIds, toolStartAt, toolProgress, writeFamilyOf,
439
448
  toolLabels, postToolBatchArmed, batchArgs, internalsNotifier,
440
449
  runnerHooks: { onError: (e, info) => this.deps.onError?.(e, info), onNotice: this.deps.onNotice },
@@ -460,9 +469,9 @@ export class Runner {
460
469
  runner: this.depsSeat,
461
470
  },
462
471
  });
463
- const { flushGitMirror, unsubGitRetry, unsubBoundary, unsub } = runGitLane({ prepared, queue, rs, ident, onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, onTurnBoundary, runner: this.depsSeat });
472
+ const { flushGitMirror, unsubGitRetry, unsubBoundary, unsub } = runGitLane({ prepared, queue, rs, ident, onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, onTurnStart, onTurnBoundary, runner: this.depsSeat });
464
473
  return withLegRequestSinks(() => runLeg({
465
- spec, queue, prepared, resume, rs, entryActor, operatorObjective: internals?.operatorObjective === true, effectiveTimeoutMs, timeout, pushContent, ident, emitCommitted, writeFamilyOf, startedToolCallIds,
474
+ spec, queue, prepared, resume, rs, entryActor, objectiveAuthor: internals?.objectiveAuthor, effectiveTimeoutMs, timeout, pushContent, ident, emitCommitted, writeFamilyOf, startedToolCallIds,
466
475
  announceWorkspaceMove, withBrainSinks, flushGitMirror, loopLatch, notificationLane, unsubscribeTaskNotifications, unsubGitRetry, unsubBoundary, unsub,
467
476
  runner: this.depsSeat,
468
477
  next: ({ final, threw, abortedLive, userInterruptedLive, strandedHumanAnswers }) => runTerminalAdoption({
@@ -501,10 +510,16 @@ export class Runner {
501
510
  taskConfig,
502
511
  internals,
503
512
  runner: this.depsSeat, sessions: this.sessions,
504
- parentConstraintRegistry: this.parentConstraintRegistry,
513
+ parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
505
514
  next: (admitted) => this.resumeLadder(token, outcome, admitted),
506
515
  });
507
516
  }
517
+ async voidVerifierPause(token) {
518
+ return await voidVerifierPause({
519
+ token, runner: this.depsSeat, sessions: this.sessions,
520
+ locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
521
+ });
522
+ }
508
523
  async resumeLadder(token, outcome, admitted) {
509
524
  const { config, internals, store, cp, outcomeGate, resumeSignal, wakeMessage } = admitted;
510
525
  const { plainReviewOutcome, plainParkOutcome } = resumeReviewOutcome({ cp, outcome, outcomeGate, wakeMessage });
@@ -517,19 +532,20 @@ export class Runner {
517
532
  cp, config, internals, outcomeGate, wakeMessage, resumeSignal, recheckGovernanceWindow,
518
533
  plainPolicyOutcome: capturedPolicyOutcome, plainReviewOutcome, plainParkOutcome,
519
534
  runner: this.depsSeat, effectiveDelegationFacts,
520
- next: ({ wakeHookContext, legMods, plainPolicyOutcome, outcomeForStore }) => resumePreflight({
535
+ next: ({ wakeHookContext, wakeMessage: wakeDelivered, wakeRewrittenBy, legMods, plainPolicyOutcome, outcomeForStore }) => resumePreflight({
521
536
  token, cp, resumeSignal, recheckGovernanceWindow, store, runner: this.depsSeat,
522
537
  locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
523
538
  next: () => resumeClaim({
524
539
  token, cp, store, outcomeForStore, holder: internals?.holder,
525
- locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry,
526
- next: () => this.resumeHandoff({ token, cp, store, config, internals, resumeInternals, plainPolicyOutcome, redeemedAnswer, outcomeForStore, wakeMessage, wakeHookContext, legMods, resumeSignal }),
540
+ locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
541
+ onDestroyError: (err, sessionId) => this.depsSeat.deps.onError?.(err, { phase: "config", sessionId }),
542
+ next: () => this.resumeHandoff({ token, cp, store, config, internals, resumeInternals, plainPolicyOutcome, redeemedAnswer, outcomeForStore, wakeMessage: wakeDelivered, wakeRewrittenBy, wakeHookContext, legMods, resumeSignal }),
527
543
  }),
528
544
  }),
529
545
  });
530
546
  }
531
547
  async resumeHandoff(claimed) {
532
- const { token, cp, store, config, internals, resumeInternals, plainPolicyOutcome, redeemedAnswer, outcomeForStore, wakeMessage, wakeHookContext, legMods, resumeSignal } = claimed;
548
+ const { token, cp, store, config, internals, resumeInternals, plainPolicyOutcome, redeemedAnswer, outcomeForStore, wakeMessage, wakeRewrittenBy, wakeHookContext, legMods, resumeSignal } = claimed;
533
549
  let consumeFlipDone = false;
534
550
  if (internals?.afterCheckpointResolve !== undefined) {
535
551
  await internals.afterCheckpointResolve();
@@ -559,7 +575,7 @@ export class Runner {
559
575
  throw new CheckpointError("checkpoint.resume_aborted", said);
560
576
  throw new CheckpointError("checkpoint.reopen_failed", said);
561
577
  }
562
- return this.runTaskStream(spec, { cp, outcome: outcomeForStore, reopenUnstarted, recordExecutionOutcome, ...(wakeMessage !== undefined ? { wakeMessage } : {}), ...(wakeHookContext !== undefined ? { wakeMessageHookContext: wakeHookContext } : {}), ...(legMods !== undefined ? { legMods } : {}) }, resumeInternals);
578
+ return this.runTaskStream(spec, { cp, outcome: outcomeForStore, reopenUnstarted, recordExecutionOutcome, ...(wakeMessage !== undefined ? { wakeMessage } : {}), ...(wakeRewrittenBy !== undefined ? { wakeMessageRewrittenBy: wakeRewrittenBy } : {}), ...(wakeHookContext !== undefined ? { wakeMessageHookContext: wakeHookContext } : {}), ...(legMods !== undefined ? { legMods } : {}) }, resumeInternals);
563
579
  }
564
580
  }
565
581
  export function runTask(spec, deps) {
@@ -1,6 +1,6 @@
1
1
  import type { ExecutionEnv } from "../../internal/harness-types.js";
2
2
  import type { ToolEffect } from "../types.js";
3
- import type { NamedToolPolicy } from "../tool-policy.js";
3
+ import { type NamedToolPolicy } from "../tool-policy.js";
4
4
  import { type SessionPermissionRules, type SessionPolicyStore, type SessionRuleEntryField, type StoredSessionRules } from "../session-policy-store.js";
5
5
  import type { PathRuleBases } from "../permission-rule-model.js";
6
6
  /** The FULL path-confinable write-tool set: every catalog tool declaring a write path target — `Write` / `Edit`