@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
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * The resume ladder's ADMISSION rung (E1) and the wake's shaping (E2), verbatim from
3
3
  * `Runner.resumeStream`: the outcome container's domain, the one-read snapshots of the caller's config and
4
- * the trusted internals bag, the store resolution, the row read and its terminal-status confirm, the
5
- * same-process parent-constraint re-supply, then the wake pre-ladder (gate purity, pendingAction purity,
4
+ * the trusted internals bag, the store resolution, the row read and its terminal-status confirm, the row's own verdict,
5
+ * the same-process parent-constraint re-supply, then the wake pre-ladder (gate purity, pendingAction purity,
6
6
  * the message's persist-time validation) and the one read of the outcome discriminant and the signal slot.
7
7
  *
8
8
  * Async (two store reads); every refusal throws a typed `CheckpointError` pre-CAS. It ends by handing what it
@@ -11,7 +11,7 @@
11
11
  * The same seat shape the tool gate's fold uses to enter its lanes (gate-fold.ts `afterFold`).
12
12
  */
13
13
  import { type Checkpoint, type CheckpointStore, type CheckpointToken, type PendingSteerEntry, type ResumeOutcome } from "../checkpoint-store.js";
14
- import type { InheritedGate, ResumeTaskConfig, RunInternals, RunnerDepsSeat } from "./contracts.js";
14
+ import type { InheritedGate, ResumeTaskConfig, RunInternals, RunnerDepsSeat, SuspendReap } from "./contracts.js";
15
15
  import type { SessionStore } from "../session.js";
16
16
  /** What the admission rung was called with. */
17
17
  export interface ResumeAdmissionInput<R> {
@@ -31,14 +31,16 @@ export interface ResumeAdmissionInput<R> {
31
31
  runner: RunnerDepsSeat;
32
32
  /** borrowed-readonly — the Runner's session store, fixed at its construction (unlike its deps): the retention capability door judges it. */
33
33
  sessions: SessionStore;
34
- /** borrowed-readonly — the Runner's same-process parked-constraint registry; read for this token (never written here). */
35
- parentConstraintRegistry: ReadonlyMap<CheckpointToken, NonNullable<InheritedGate["parentConstraints"]>>;
34
+ /** borrowed-mutable — the Runner's same-process parked-constraint registry; read for this token, and evicted for it only by the expired-row duty. */
35
+ parentConstraintRegistry: Map<CheckpointToken, NonNullable<InheritedGate["parentConstraints"]>>;
36
+ /** borrowed-mutable — the Runner's suspended-env reap handles: a row the confirm reads `expired` has its duty run here (its record taken). */
37
+ suspendedEnvReaps: Map<CheckpointToken, SuspendReap>;
36
38
  /** borrowed-readonly — the rung after admission, entered in this rung's last continuation with what it admitted. */
37
39
  next: (admitted: ResumeAdmissionResult) => Promise<R>;
38
40
  }
39
41
  /** What admission established — the constants every later rung reads. */
40
42
  export interface ResumeAdmissionResult {
41
- /** The caller's config, snapshotted once (own enumerable fields), its MCP / A2A entries the frozen ones the doors judged. */
43
+ /** The caller's config, snapshotted once (own enumerable fields); its MCP / A2A lists are the doors' judged copies of THIS resume's (the row records none). */
42
44
  config: ResumeTaskConfig;
43
45
  /** The trusted internals snapshot, with the parked parent chain re-supplied when this Runner spawned the leg. */
44
46
  internals: RunInternals | undefined;
@@ -1,8 +1,12 @@
1
- import { CheckpointError, judgeParkedSteerRepeat, readPendingSteerQueue, refuseRetiredModeSeed, resolveCheckpointStore, validatePendingSteer } from "../checkpoint-store.js";
1
+ import { CheckpointError, judgeParkedSteerRepeat, readPendingSteerQueue, resolveCheckpointStore, validatePendingSteer } from "../checkpoint-store.js";
2
+ import { checkpointRowRefusal } from "../checkpoint-row-verdict.js";
2
3
  import { assertResumeConfigRecord, checkpointStoreSeat, refuseResumeDoors } from "./prepare-config-doors.js";
4
+ import { compositionLegRecord } from "./checkpoint-scope.js";
3
5
  import { asResumeConfigRefusal } from "../mode-policy.js";
6
+ import { runExpiredDuty } from "./expire-settle.js";
4
7
  import { describeSuppliedValue } from "./decide-continuation.js";
5
8
  import { detachSkillLists } from "../skill-grant.js";
9
+ import { readCallerSpec } from "../task-spec-members.js";
6
10
  import { isGateKind, PAUSE_REGISTRY } from "../pause-registry.js";
7
11
  const DECIDE_ENTRY_BY_RESUME_GATE = {
8
12
  policy_ask: "a `policy_ask` outcome (decision allow/deny bound to the pending tool call)",
@@ -12,14 +16,18 @@ const DECIDE_ENTRY_BY_RESUME_GATE = {
12
16
  task_done: undefined,
13
17
  };
14
18
  export async function resumeAdmission(input) {
15
- const { token, outcome, taskConfig, runner, sessions, parentConstraintRegistry } = input;
19
+ const { token, outcome, taskConfig, runner, sessions, parentConstraintRegistry, suspendedEnvReaps } = input;
16
20
  let internals = input.internals;
17
21
  if (outcome === null || typeof outcome !== "object") {
18
22
  throw new CheckpointError("checkpoint.invalid_outcome", `resume outcome must be an object naming its gate (got ${outcome === null ? "null" : typeof outcome})`, { field: "outcome" });
19
23
  }
20
24
  asResumeConfigRefusal("taskConfig", () => assertResumeConfigRecord(taskConfig));
21
- let config = { ...taskConfig, ...(Array.isArray(taskConfig.skills) ? { skills: detachSkillLists(taskConfig.skills) } : {}) };
22
- internals = internals !== undefined ? { ...internals } : undefined;
25
+ const configRead = readCallerSpec(taskConfig);
26
+ asResumeConfigRefusal("taskConfig", () => { if (configRead.refusal !== undefined)
27
+ throw configRead.refusal; });
28
+ let config = { ...configRead.spec, ...(Array.isArray(configRead.spec.skills) ? { skills: detachSkillLists(configRead.spec.skills) } : {}) };
29
+ const snapshot = internals !== undefined ? { ...internals } : undefined;
30
+ internals = snapshot?.compositionLeg !== undefined ? { ...snapshot, compositionLeg: compositionLegRecord(snapshot.compositionLeg) } : snapshot;
23
31
  const store = asResumeConfigRefusal(checkpointStoreSeat(config), () => resolveCheckpointStore(config, runner.deps));
24
32
  if (!store) {
25
33
  throw new CheckpointError("checkpoint.not_found", "no CheckpointStore wired — cannot resume (set RunnerDeps.checkpointStore or taskConfig.checkpointStore)");
@@ -33,8 +41,18 @@ export async function resumeAdmission(input) {
33
41
  if (live?.status === "pending") {
34
42
  throw new CheckpointError("checkpoint.reopened_concurrently", "checkpoint changed concurrently (a resolve/reopen cycle landed between this resume's read of the row and its state check) — nothing was validated or executed; re-resume against the current state");
35
43
  }
44
+ if (live?.status === "expired") {
45
+ await runExpiredDuty({
46
+ token, parentConstraintRegistry, suspendedEnvReaps,
47
+ destroyLabel: "expired-row env destroy (resume refused)",
48
+ onDestroyError: (err, sessionId) => runner.deps.onError?.(err, { phase: "config", sessionId }),
49
+ });
50
+ }
36
51
  throw new CheckpointError("checkpoint.already_resolved", `checkpoint is ${describeSuppliedValue(live?.status ?? cp.status)} — the token is consumed, so this resume was neither validated nor executed (idempotent); a different outcome cannot redeem it`);
37
52
  }
53
+ const rowRefusal = checkpointRowRefusal(cp);
54
+ if (rowRefusal !== undefined)
55
+ throw rowRefusal;
38
56
  if ((internals?.inheritedGate?.parentConstraints?.length ?? 0) === 0) {
39
57
  const parked = parentConstraintRegistry.get(token);
40
58
  if (parked !== undefined) {
@@ -48,8 +66,7 @@ export async function resumeAdmission(input) {
48
66
  const outcomeGate = outcome.gate;
49
67
  const resumeSignal = config.signal;
50
68
  let suppliedMessage;
51
- refuseRetiredModeSeed(cp.state);
52
- config = refuseResumeDoors(config, cp.state, runner.deps, sessions, internals?.holder);
69
+ config = refuseResumeDoors(config, runner.deps, sessions, internals?.holder);
53
70
  const parkedSteers = readPendingSteerQueue(cp.state);
54
71
  if (outcomeGate === "wake") {
55
72
  suppliedMessage = outcome.message;
@@ -41,6 +41,10 @@ export interface ResumeApplyInput<R> {
41
41
  export interface ResumeApplyResult {
42
42
  /** The screen's `additionalContext` for the wake message, when a screen ran and supplied one. */
43
43
  wakeHookContext: string | undefined;
44
+ /** The wake message the leg delivers: the validated one, or as the screen handed it on (`prompt.submit` rewrote its text). */
45
+ wakeMessage: Omit<PendingSteerEntry, "seq"> | undefined;
46
+ /** Who rewrote the wake message's text, in the order they did; absent when nobody did. */
47
+ wakeRewrittenBy?: readonly string[];
44
48
  /** The resumed leg's bus, when the wake-message screen made this rung admit it (the leg adopts it). */
45
49
  legMods?: LegMods;
46
50
  /** The approval lane's twin WITH its minted settlement record (undefined on every other lane). */
@@ -2,7 +2,9 @@ import { snapshotActorAssertion } from "../../internal/llm.js";
2
2
  import { CheckpointError, remainingBudgetMicroUsd } from "../checkpoint-store.js";
3
3
  import { chainPolicyOnLeg, chainTopAnchors } from "./child-tree.js";
4
4
  import { mintHookInvocationIdentity } from "../hooks.js";
5
- import { admitLegMods, classicEventBase, failedHandlerClause, screenUserPrompt } from "../mods/stations.js";
5
+ import { admitLegMods, classicEventBase, failedHandlerClause, promptScreenHasHandlers, screenUserPrompt } from "../mods/stations.js";
6
+ import { legTaskIdOf } from "../leg-identity.js";
7
+ import { restoreRowTaskId } from "./checkpoint-scope.js";
6
8
  import { checkToolPolicyProjection, policyCannotAnswer, refuseOutOfContractDecision } from "../tool-policy.js";
7
9
  import { requestGrantBinding } from "../skill-grant-binding.js";
8
10
  import { skillGrantBindingMembers } from "../skill-grant.js";
@@ -22,16 +24,18 @@ export async function resumeApply(input) {
22
24
  const { cp, config, internals, outcomeGate, wakeMessage, resumeSignal, recheckGovernanceWindow, plainReviewOutcome, plainParkOutcome, runner, effectiveDelegationFacts } = input;
23
25
  let plainPolicyOutcome = input.plainPolicyOutcome;
24
26
  let wakeHookContext;
27
+ let wakeDelivered = wakeMessage;
28
+ let wakeRewrittenBy;
25
29
  let legMods;
26
30
  if (outcomeGate === "wake" && wakeMessage !== undefined) {
27
31
  if (resumeSignal?.aborted !== true) {
28
32
  legMods = await admitLegMods({ spec: config, deps: runner.deps, sessionId: cp.sessionId, skills: skillsThatLoad(readSkillsSeat(config.skills)), reopenedSkills: frozenSkillScopesOf(cp.state) });
29
33
  }
30
- if (legMods !== undefined && legMods.bus.hasHandlers("classic.UserPromptSubmit")) {
34
+ if (legMods !== undefined && promptScreenHasHandlers(legMods.bus)) {
31
35
  const screenedMessage = wakeMessage;
32
36
  const identity = mintHookInvocationIdentity({
33
37
  sessionId: cp.sessionId,
34
- taskId: config.taskId ?? cp.sessionId,
38
+ taskId: legTaskIdOf(config, restoreRowTaskId(internals, cp.state.rowTaskId), cp.sessionId),
35
39
  legKind: "resume",
36
40
  isDelegatedChild: effectiveDelegationFacts(internals, cp.state.isDelegatedChild).isDelegatedChild,
37
41
  ...(internals?.insideFork === true ? { insideFork: true } : {}),
@@ -59,6 +63,10 @@ export async function resumeApply(input) {
59
63
  if (screen?.additionalContext !== undefined && screen.additionalContext !== "") {
60
64
  wakeHookContext = screen.additionalContext;
61
65
  }
66
+ if (screen?.kind === "answered" && screen.rewrittenBy !== undefined) {
67
+ wakeDelivered = { ...screenedMessage, text: screen.text };
68
+ wakeRewrittenBy = screen.rewrittenBy;
69
+ }
62
70
  if (recheckGovernanceWindow !== undefined)
63
71
  await recheckGovernanceWindow();
64
72
  }
@@ -174,9 +182,10 @@ export async function resumeApply(input) {
174
182
  if (outcomeForReview?.gate === "plan_review") {
175
183
  outcomeForReview = { ...outcomeForReview, gateOutcome: mintDecideRecord(cp, outcomeForReview.hostDecision, { allowed: outcomeForReview.decision !== "reject", note: outcomeForReview.reason }) };
176
184
  }
177
- const outcomeForStore = plainPolicyOutcome ?? outcomeForReview ?? plainParkOutcome;
185
+ const parkOutcome = plainParkOutcome?.gate === "wake" && wakeDelivered !== wakeMessage && wakeDelivered !== undefined ? { gate: "wake", message: wakeDelivered } : plainParkOutcome;
186
+ const outcomeForStore = plainPolicyOutcome ?? outcomeForReview ?? parkOutcome;
178
187
  if (outcomeForStore === undefined) {
179
188
  throw new CheckpointError("checkpoint.invalid_outcome", `resume outcome (gate "${describeSuppliedValue(outcomeGate)}") matched the checkpoint gate but no lane captured it — refusing pre-CAS rather than passing the caller's live object to the store and the resumed run`);
180
189
  }
181
- return await input.next({ wakeHookContext, ...(legMods !== undefined ? { legMods } : {}), plainPolicyOutcome, outcomeForStore });
190
+ return await input.next({ wakeHookContext, wakeMessage: wakeDelivered, ...(wakeRewrittenBy !== undefined ? { wakeRewrittenBy } : {}), ...(legMods !== undefined ? { legMods } : {}), plainPolicyOutcome, outcomeForStore });
182
191
  }
@@ -1,3 +1,12 @@
1
+ /**
2
+ * The resume ladder's CHECKPOINT SCREEN (E5) and its abort / workspace-handle / inherited-
3
+ * constraint rungs (E6), verbatim from `Runner.resumeStream`: the rungs a deployment fact or a resume input decides — the
4
+ * org-governance wiring check, the already-aborted signal, the remote-handle factory requirement, the requestedCwd conflict,
5
+ * the row's recorded ceiling and own lists (each when the leg runs under it), a renamed delegation mount, the parent-constraint
6
+ * count / content / installation checks, and the array-level snapshot of the validated chain. The rungs the row and the engine
7
+ * decide alone are the row's verdict, judged at admission (`judgeCheckpointRow`).
8
+ * Synchronous; every refusal throws pre-CAS.
9
+ */
1
10
  import { type Checkpoint } from "../checkpoint-store.js";
2
11
  import type { RunInternals, RunnerDepsSeat } from "./contracts.js";
3
12
  export interface ResumeCheckpointScreenInput {
@@ -1,85 +1,15 @@
1
- import { persistedReadDenyEntryProblem } from "../../tools/fs/read-deny.js";
2
- import { validatePath } from "../effective-path-target.js";
3
- import { isAskOrigin } from "../ask-origin.js";
4
- import { CHECKPOINT_FEATURES, CheckpointError, checkpointVersionOf, MAX_SUPPORTED_CHECKPOINT_VERSION, realApprovalOrgFact } from "../checkpoint-store.js";
5
- import { judgeCheckpointRequirements } from "../checkpoint-requirements.js";
1
+ import { CheckpointError, realApprovalOrgFact } from "../checkpoint-store.js";
6
2
  import { constraintChainDigest, constraintChainEntryOfSuppliedLayer } from "../tool-policy.js";
7
- import { readFrozenSkillGrants } from "../skill-grant.js";
8
- import { readFrozenSkillScopes } from "../mods/spec-seats.js";
9
3
  import { chainInstallationGaps, chainInstallationRefusal } from "./child-tree.js";
10
4
  import { chainEntryFault } from "../mods/stations.js";
11
5
  import { refusePersistedToolNames, refuseRenamedDelegationMounts } from "./sub-agent-deny-lists.js";
12
6
  import { asResumeConfigRefusal } from "../mode-policy.js";
13
- import { screenRecordedRunOrigin } from "../run-origin.js";
14
7
  export function resumeCheckpointScreen(input) {
15
8
  const { cp, resumeSignal, internals, tools, runner } = input;
16
- const { realApproval: realApprovalRow, face: faceRow, f012: f012Row } = CHECKPOINT_FEATURES;
17
- if (checkpointVersionOf(cp) > MAX_SUPPORTED_CHECKPOINT_VERSION) {
18
- throw new CheckpointError("checkpoint.unsupported_version", `checkpoint requires reader capabilities this worker lacks (row format v${checkpointVersionOf(cp)}; this worker reads up to v${MAX_SUPPORTED_CHECKPOINT_VERSION}) — resume it on a worker at or above the version that parked it`, { reason: "version_newer" });
19
- }
20
- const requirements = judgeCheckpointRequirements(cp);
21
- if (requirements.kind === "lacking")
22
- throw new CheckpointError("checkpoint.unsupported_version", `checkpoint requires reader capabilities this worker lacks (${requirements.words.join(", ")}) — resume it on a worker at or above the version that parked it`, { reason: "version_newer", requires: requirements.words });
23
- if (requirements.kind === "damaged")
24
- throw new CheckpointError("checkpoint.invalid_outcome", `this checkpoint's reader-requirement list does not match the row (${requirements.why}) — refusing to resume a damaged row (corruption guard), the checkpoint stays pending; no worker can resume it: start the task again`, { reason: "requirements_damaged" });
25
9
  const preCasGateBit = cp.gate.kind === "irreversible_ask" ? cp.gate.realApproval : undefined;
26
- const preCasBitWellFormed = preCasGateBit !== undefined && typeof preCasGateBit === "object" && isAskOrigin(preCasGateBit.origin);
27
- const faceSaysGoverned = (cp.state.readFace?.realApproval) === true;
28
- const preCasBitViolation = checkpointVersionOf(cp) === realApprovalRow.version
29
- ? !preCasBitWellFormed
30
- : checkpointVersionOf(cp) < realApprovalRow.version
31
- ? preCasGateBit !== undefined
32
- : faceSaysGoverned
33
- ? !preCasBitWellFormed
34
- : preCasGateBit !== undefined && !preCasBitWellFormed;
35
- if (preCasBitViolation) {
36
- throw new CheckpointError("checkpoint.invalid_outcome", checkpointVersionOf(cp) >= realApprovalRow.version
37
- ? `a v${checkpointVersionOf(cp)} checkpoint's realApproval gate bit must be well-formed (origin a member of the closed ask-origin set)${checkpointVersionOf(cp) === realApprovalRow.version ? " and present on an irreversible_ask gate" : ""} — this row's is not; refusing to resume a damaged real-approval row (corruption / downgrade guard), the checkpoint stays pending`
38
- : `a v${checkpointVersionOf(cp)} checkpoint carries a realApproval gate bit no release of that version ever minted — refusing to honor a fabricated origin (corruption / forgery guard), the checkpoint stays pending`, { reason: checkpointVersionOf(cp) >= realApprovalRow.version ? "real_approval_damaged" : "real_approval_forged" });
39
- }
40
- {
41
- const faceSectionRaw = cp.state.readFace;
42
- const faceCandidate = faceSectionRaw !== undefined && typeof faceSectionRaw === "object" && faceSectionRaw !== null
43
- ? faceSectionRaw
44
- : undefined;
45
- const faceWellFormed = faceCandidate !== undefined &&
46
- (faceCandidate.face === "open" || faceCandidate.face === "roots") &&
47
- (faceCandidate.realApproval === undefined || faceCandidate.realApproval === true) &&
48
- (faceCandidate.denyEntries === undefined ||
49
- (Array.isArray(faceCandidate.denyEntries) &&
50
- faceCandidate.denyEntries.every((e) => persistedReadDenyEntryProblem(e) === null)));
51
- const v = checkpointVersionOf(cp);
52
- if (v === faceRow.version ? !faceWellFormed : v < faceRow.version ? faceSectionRaw !== undefined : faceSectionRaw !== undefined && !faceWellFormed) {
53
- throw new CheckpointError("checkpoint.invalid_outcome", checkpointVersionOf(cp) >= faceRow.version
54
- ? `a v${checkpointVersionOf(cp)} checkpoint must carry a well-formed read-face section (state.readFace) — this row's is missing or malformed; refusing to resume a damaged read-face row (corruption / downgrade guard), the checkpoint stays pending`
55
- : `a v${checkpointVersionOf(cp)} checkpoint carries a read-face section no release of that version ever minted — refusing to honor a fabricated read-face state (corruption / forgery guard), the checkpoint stays pending`, { reason: checkpointVersionOf(cp) >= faceRow.version ? "read_face_damaged" : "read_face_forged" });
56
- }
57
- const writeFaceSectionRaw = cp.state.writeFace;
58
- if (writeFaceSectionRaw !== undefined) {
59
- const c = typeof writeFaceSectionRaw === "object" && writeFaceSectionRaw !== null ? writeFaceSectionRaw : undefined;
60
- if (c === undefined || !(c.face === "open" || c.face === "roots")) {
61
- throw new CheckpointError("checkpoint.invalid_outcome", `this checkpoint carries a write-face section (state.writeFace) that is not well-formed — refusing to resume a damaged write-face row (corruption guard), the checkpoint stays pending`, { reason: "write_face_damaged" });
62
- }
63
- }
64
- if (readFrozenSkillGrants(cp.state.skillGrants) === undefined)
65
- throw new CheckpointError("checkpoint.invalid_outcome", "this checkpoint carries a skill-grant section (state.skillGrants) that does not read as grant rows under this engine — a damaged section, or a row an earlier release wrote whose entry this release reads as nothing (an entry with a surrounding space, say) — refusing to resume without the grant rows and refusals it carries; the checkpoint stays pending: finish it on a worker of the release that parked it, or expire it", { reason: "skill_grants_damaged" });
66
- if (readFrozenSkillScopes(cp.state.skillScopes) === undefined)
67
- throw new CheckpointError("checkpoint.invalid_outcome", "this checkpoint carries a skill-scope section (state.skillScopes) that does not read as a list of SkillSpec names — a damaged section — refusing to resume without the active skills' hooks it records; the checkpoint stays pending: finish it on a worker of the release that parked it, or expire it", { reason: "skill_scopes_damaged" });
68
- for (const field of ["handsRoot", "handsHome", "handsCwd"]) {
69
- const coordinate = cp.state[field];
70
- if (coordinate !== undefined && validatePath(coordinate, { intent: "validate-coordinate" }) === undefined)
71
- throw new CheckpointError("checkpoint.invalid_outcome", `this checkpoint's state.${field} is not an absolute path — refusing to resume a row whose hands' coordinates are damaged (corruption guard), the checkpoint stays pending`, { reason: "hands_coordinates_damaged" });
72
- }
73
- }
74
10
  if (realApprovalOrgFact(preCasGateBit) !== undefined && runner.deps.permissionRuleStore?.partitions.org !== true) {
75
11
  throw new CheckpointError("checkpoint.unsupported_version", `this checkpoint's approval was minted under organization governance (org ${String(realApprovalOrgFact(preCasGateBit))}, routed as ${String(preCasGateBit?.origin)}) and this worker has no org adjudication wiring (its permission-rule store carries no org partition) — a governed approval may only be redeemed where governance can be enforced; the checkpoint stays pending, resume it on an org-wired worker`, { reason: "governed_unwired" });
76
12
  }
77
- const retiredWalltimeTotal = cp.resourceLedger?.totalWalltimeSec;
78
- if (retiredWalltimeTotal !== undefined) {
79
- throw new CheckpointError("checkpoint.walltime_axis_retired", "this checkpoint's ledger carries a cross-slice WALL-CLOCK allocation (resourceLedger.totalWalltimeSec), an axis this engine version retired — " +
80
- "resuming here would run the leg with that ceiling unenforced. Rejected pre-CAS (the checkpoint stays pending): finish it on a worker of the " +
81
- "previous release, or start a fresh task bounded by resourceSuspend.totalTokens / totalBudgetUsd.");
82
- }
83
13
  if (resumeSignal?.aborted === true && cp.status === "pending") {
84
14
  throw new CheckpointError("checkpoint.resume_aborted", "the resume was handed an ALREADY-ABORTED signal — refusing to consume the approval on a leg that cannot run it (the checkpoint stays pending and is resumable with a live signal)");
85
15
  }
@@ -91,8 +21,7 @@ export function resumeCheckpointScreen(input) {
91
21
  "the restored workspace's own mount path is authoritative for the task root. Drop requestedCwd on resume legs " +
92
22
  "(the checkpoint stays pending and is resumable without it).");
93
23
  }
94
- asResumeConfigRefusal("inheritedGate", () => refusePersistedToolNames((internals?.toolCeiling ?? undefined) === undefined ? cp.state.toolCeiling : undefined, cp.state.inheritedGate?.constraintChain, (internals?.ownToolLists ?? undefined) === undefined ? cp.state.ownToolLists : undefined));
95
- asResumeConfigRefusal("inheritedGate", () => void screenRecordedRunOrigin(cp.state.runOrigin));
24
+ asResumeConfigRefusal("inheritedGate", () => refusePersistedToolNames((internals?.toolCeiling ?? undefined) === undefined ? cp.state.toolCeiling : undefined, undefined, (internals?.ownToolLists ?? undefined) === undefined ? cp.state.ownToolLists : undefined));
96
25
  asResumeConfigRefusal("taskConfig", () => refuseRenamedDelegationMounts(tools));
97
26
  if (cp.state.inheritedGate?.requiresParentConstraint === true) {
98
27
  const supplied = internals?.inheritedGate?.parentConstraints?.length ?? 0;
@@ -108,18 +37,9 @@ export function resumeCheckpointScreen(input) {
108
37
  "re-supply would run the resumed leg under a different ancestor chain than it suspended with; " +
109
38
  "rejected pre-CAS (the checkpoint stays pending) — re-resume with the full original chain");
110
39
  }
111
- if (checkpointVersionOf(cp) >= f012Row.version &&
112
- (cp.state.inheritedGate.constraintChain === undefined || cp.state.inheritedGate.constraintDigest === undefined)) {
113
- throw new CheckpointError("checkpoint.invalid_outcome", `a v${checkpointVersionOf(cp)} checkpoint that requires parent constraints must carry BOTH the frozen constraintChain and its constraintDigest (they are minted in one write with the version stamp) — this row carries neither or only one; refusing to fall back to the count-only contract on a damaged row (corruption / downgrade guard), the checkpoint stays pending`, { reason: "constraint_chain_missing" });
114
- }
115
40
  const expectedDigest = cp.state.inheritedGate.constraintDigest;
116
- if (expectedDigest !== undefined) {
117
- const persistedChain = cp.state.inheritedGate.constraintChain;
118
- if (persistedChain === undefined || constraintChainDigest(persistedChain) !== expectedDigest) {
119
- throw new CheckpointError("resume.parent_constraint_mismatch", "the checkpoint's OWN recorded constraint chain does not match its recorded digest " +
120
- "(corrupt / inconsistently-minted row) — the frozen deny data the resume would execute is not the data the " +
121
- "digest authenticates; rejected pre-CAS (the checkpoint stays pending)");
122
- }
41
+ const persistedChain = cp.state.inheritedGate.constraintChain;
42
+ if (expectedDigest !== undefined && persistedChain !== undefined) {
123
43
  const suppliedDigest = constraintChainDigest((internals?.inheritedGate?.parentConstraints ?? []).map((pc, i) => constraintChainEntryOfSuppliedLayer(pc, persistedChain[i])));
124
44
  if (suppliedDigest !== expectedDigest) {
125
45
  throw new CheckpointError("resume.parent_constraint_mismatch", "the re-supplied parent-constraint chain's projection content does not match what the checkpoint recorded " +
@@ -9,7 +9,8 @@
9
9
  * — the post-consume hook fires on the tick the win was read — and returns what that rung returns.
10
10
  */
11
11
  import { type Checkpoint, type CheckpointStore, type CheckpointToken } from "../checkpoint-store.js";
12
- import type { InheritedGate, InstallingPhaseResult, ResumeRun } from "./contracts.js";
12
+ import type { InheritedGate, InstallingPhaseResult, ResumeRun, SuspendReap } from "./contracts.js";
13
+ import type { LocalClaims } from "./local-claims.js";
13
14
  export interface ResumeClaimInput<R> {
14
15
  /** borrowed-readonly — the checkpoint token being claimed. */
15
16
  token: CheckpointToken;
@@ -21,10 +22,14 @@ export interface ResumeClaimInput<R> {
21
22
  outcomeForStore: ResumeRun["outcome"];
22
23
  /** borrowed-readonly — the deployment's claim holder the resume acts under (`RunInternals.holder`), carried into the CAS. */
23
24
  holder?: string | undefined;
24
- /** borrowed-mutable — the Runner's same-Runner claim marks: opened with the resolve attempt, released on a loss. */
25
- locallyClaimedTokens: Set<CheckpointToken>;
25
+ /** borrowed-mutable — the Runner's same-Runner claims: this attempt opens its own with the resolve, closes it on a loss or a throw. */
26
+ locallyClaimedTokens: LocalClaims;
26
27
  /** borrowed-mutable — the Runner's parked-constraint registry: a terminally consumed token's entry is evicted. */
27
28
  parentConstraintRegistry: Map<CheckpointToken, NonNullable<InheritedGate["parentConstraints"]>>;
29
+ /** borrowed-mutable — the Runner's suspended-env reap handles: a loss to an `expired` row runs that row's duty (its record taken). */
30
+ suspendedEnvReaps: Map<CheckpointToken, SuspendReap>;
31
+ /** borrowed-readonly — where the expired duty's bounded destroy failure is said (the Runner's `onError`); never thrown. */
32
+ onDestroyError: (err: unknown, sessionId: string) => void;
28
33
  /** borrowed-readonly — the driver's post-claim rung, entered in this rung's last continuation. */
29
34
  next: (claimed: ResumeClaimResult) => Promise<R>;
30
35
  }
@@ -1,21 +1,28 @@
1
1
  import { CheckpointError } from "../checkpoint-store.js";
2
2
  import { checkpointRevOf } from "../checkpoint-generation.js";
3
+ import { runExpiredDuty } from "./expire-settle.js";
3
4
  export async function resumeClaim(input) {
4
- const { token, cp, store, outcomeForStore, holder, locallyClaimedTokens, parentConstraintRegistry } = input;
5
+ const { token, cp, store, outcomeForStore, holder, locallyClaimedTokens, parentConstraintRegistry, suspendedEnvReaps, onDestroyError } = input;
5
6
  const expect = { rev: checkpointRevOf(cp), ...(holder !== undefined ? { holder } : {}) };
6
- locallyClaimedTokens.add(token);
7
+ locallyClaimedTokens.open(token);
7
8
  let won, loss;
8
- if (store.claimTerminal !== undefined) {
9
- const claim = await store.claimTerminal(token, cp.scope, { kind: "resolve", outcome: outcomeForStore, expect });
10
- won = claim.claimed;
11
- if (!claim.claimed)
12
- loss = { status: claim.current.status, rev: claim.current.status === "absent" ? undefined : claim.current.rev, sameRow: true };
9
+ try {
10
+ if (store.claimTerminal !== undefined) {
11
+ const claim = await store.claimTerminal(token, cp.scope, { kind: "resolve", outcome: outcomeForStore, expect });
12
+ won = claim.claimed;
13
+ if (!claim.claimed)
14
+ loss = { status: claim.current.status, rev: claim.current.status === "absent" ? undefined : claim.current.rev, sameRow: true };
15
+ }
16
+ else {
17
+ won = await store.resolve(token, cp.scope, outcomeForStore, expect);
18
+ }
13
19
  }
14
- else {
15
- won = await store.resolve(token, cp.scope, outcomeForStore, expect);
20
+ catch (casErr) {
21
+ locallyClaimedTokens.close(token);
22
+ throw casErr;
16
23
  }
17
24
  if (!won)
18
- locallyClaimedTokens.delete(token);
25
+ locallyClaimedTokens.close(token);
19
26
  if (!won) {
20
27
  if (loss === undefined) {
21
28
  const row = await store.get(token);
@@ -27,8 +34,17 @@ export async function resumeClaim(input) {
27
34
  }
28
35
  throw new CheckpointError("checkpoint.reopened_concurrently", "checkpoint changed concurrently (its revision advanced via a resolve/reopen cycle since this resume validated) — not executed; re-resume against the current state");
29
36
  }
30
- parentConstraintRegistry.delete(token);
37
+ if (loss.status === "expired")
38
+ await runExpiredDuty({ token, parentConstraintRegistry, suspendedEnvReaps, destroyLabel: "expired-row env destroy (resume lost)", onDestroyError });
39
+ else
40
+ parentConstraintRegistry.delete(token);
31
41
  throw new CheckpointError("checkpoint.already_resolved", "checkpoint already resolved or expired — not re-executed (idempotent)");
32
42
  }
33
- return await input.next({});
43
+ try {
44
+ return await input.next({});
45
+ }
46
+ catch (handoffErr) {
47
+ locallyClaimedTokens.close(token);
48
+ throw handoffErr;
49
+ }
34
50
  }
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * The resume ladder's INTERNALS-AND-CONFIG rung (E7), verbatim from `Runner.resumeStream`:
3
- * the inherited constraints' retired-member door, the principal and placement identity-continuity rungs,
3
+ * the inherited constraints' retired-member door, the principal, placement and composition-leg identity-continuity rungs,
4
4
  * and the governance-window ENTRANCE check for a row that still owes a delivery.
5
5
  *
6
6
  * Synchronous by construction, with the ladder's ONE await at this rung handed back instead of taken: the
@@ -16,7 +16,7 @@ export interface ResumeInternalsAndConfigInput {
16
16
  cp: Checkpoint;
17
17
  /** borrowed-readonly — the config snapshot (`principal`). */
18
18
  config: ResumeTaskConfig;
19
- /** borrowed-readonly — the internals snapshot (`placementRoot`). */
19
+ /** borrowed-readonly — the internals snapshot (`placementRoot`, `compositionLeg`). */
20
20
  internals: RunInternals | undefined;
21
21
  /** borrowed-readonly — the ONE read of the outcome discriminant (a bare resource_limit continue owes nothing). */
22
22
  outcomeGate: ResumeOutcome["gate"];
@@ -1,7 +1,7 @@
1
1
  import { CheckpointError, readPendingSteerQueue } from "../checkpoint-store.js";
2
2
  import { asResumeConfigRefusal } from "../mode-policy.js";
3
3
  import { GLOBAL_USAGE_KEY, resolveUsageWindows, usageRetryAfterMs } from "../usage-window-store.js";
4
- import { placementValueOrAbsent } from "./checkpoint-scope.js";
4
+ import { compositionLegRecord, placementValueOrAbsent, sameCompositionLeg } from "./checkpoint-scope.js";
5
5
  import { assertNoRetiredInheritedConstraints } from "./retired-runner-deps.js";
6
6
  export function resumeInternalsAndConfig(input) {
7
7
  const { cp, config, internals, outcomeGate, runner } = input;
@@ -25,6 +25,15 @@ export function resumeInternalsAndConfig(input) {
25
25
  "refused pre-CAS (the checkpoint stays pending): re-resume with the recorded root, or omit internals.placementRoot to inherit it");
26
26
  }
27
27
  }
28
+ {
29
+ const recordedLeg = compositionLegRecord(cp.state.compositionLeg);
30
+ const suppliedLeg = compositionLegRecord(internals?.compositionLeg);
31
+ if (recordedLeg !== undefined && suppliedLeg !== undefined && !sameCompositionLeg(recordedLeg, suppliedLeg)) {
32
+ throw new CheckpointError("resume.composition_mismatch", `the resume supplied composition leg ${JSON.stringify(suppliedLeg)} but this checkpoint was parked as ${JSON.stringify(recordedLeg)} — ` +
33
+ "continuing would run the leg as another composition's leg or file its next card under another host session; " +
34
+ "refused pre-CAS (the checkpoint stays pending): re-resume with the recorded value, or omit internals.compositionLeg to inherit it");
35
+ }
36
+ }
28
37
  const owesDelivery = outcomeGate !== "resource_limit" ||
29
38
  readPendingSteerQueue(cp.state).length > 0 ||
30
39
  (cp.state.runningBackgroundTasks?.length ?? 0) > 0;
@@ -11,6 +11,7 @@
11
11
  */
12
12
  import { type Checkpoint, type CheckpointStore, type CheckpointToken } from "../checkpoint-store.js";
13
13
  import type { InheritedGate, InstallingPhaseResult, RunnerDepsSeat, SuspendReap } from "./contracts.js";
14
+ import type { LocalClaims } from "./local-claims.js";
14
15
  export interface ResumePreflightInput<R> {
15
16
  /** borrowed-readonly — the checkpoint token (handed to the deployment and to the settling CAS). */
16
17
  token: CheckpointToken;
@@ -25,8 +26,8 @@ export interface ResumePreflightInput<R> {
25
26
  /** borrowed-readonly — the Runner's deployment deps, read LIVE through the Runner (reads `resumePreflight`, `resumePreflightTimeoutMs`, `onError` (after the seat's await too) and is the seat's owner); the one home of why it is a
26
27
  * seat and not a captured object is {@link RunnerDepsSeat}. */
27
28
  runner: RunnerDepsSeat;
28
- /** borrowed-mutable — the Runner's same-Runner claim marks: opened with the expire attempt, released at the duty decision. */
29
- locallyClaimedTokens: Set<CheckpointToken>;
29
+ /** borrowed-mutable — the Runner's same-Runner claims: the terminal arm's expire attempt opens and closes its own. */
30
+ locallyClaimedTokens: LocalClaims;
30
31
  /** borrowed-mutable — the Runner's parked-constraint registry: the token's entry is evicted when the terminal arm wins. */
31
32
  parentConstraintRegistry: Map<CheckpointToken, NonNullable<InheritedGate["parentConstraints"]>>;
32
33
  /** borrowed-mutable — the Runner's suspended-env reap handles: the winning terminal arm takes and destroys this token's. */
@@ -1,9 +1,9 @@
1
1
  import { CheckpointError } from "../checkpoint-store.js";
2
2
  import { MAX_TIMER_MS } from "../mods/kernel/index.js";
3
- import { frozenHandleCopy, hasDestroy } from "../remote-env.js";
3
+ import { frozenHandleCopy } from "../remote-env.js";
4
4
  import { inlineUntrusted } from "../untrusted-text.js";
5
5
  import { describeSuppliedValue } from "./decide-continuation.js";
6
- import { settleTeardownLeg } from "./teardown-bounded.js";
6
+ import { expireRowWithDuty } from "./expire-settle.js";
7
7
  import { asThrownError } from "../thrown-value.js";
8
8
  async function boundedPreflight(timeoutMs, signal, call) {
9
9
  const controller = new AbortController();
@@ -97,37 +97,24 @@ export async function resumePreflight(input) {
97
97
  const readableMessage = typeof suppliedMessage === "string" && suppliedMessage !== "" ? suppliedMessage : undefined;
98
98
  const said = readableMessage !== undefined ? `: ${inlineUntrusted(readableMessage)}` : " (no readable verdict — fail-closed)";
99
99
  if (disposition === "terminal" && readableMessage !== undefined) {
100
- locallyClaimedTokens.add(token);
101
- let settled;
102
- try {
103
- settled = await store.expire(token, cp.scope);
104
- }
105
- catch (expireErr) {
106
- locallyClaimedTokens.delete(token);
107
- throw expireErr;
108
- }
100
+ const settled = await expireRowWithDuty({
101
+ token, scope: cp.scope, store, locallyClaimedTokens, parentConstraintRegistry, suspendedEnvReaps,
102
+ destroyLabel: "terminal-preflight env destroy",
103
+ onDestroyError: (envErr, sessionId) => {
104
+ try {
105
+ runner.deps.onError?.(envErr, { phase: "config", sessionId });
106
+ }
107
+ catch {
108
+ }
109
+ },
110
+ });
109
111
  if (!settled) {
110
- locallyClaimedTokens.delete(token);
111
112
  const live = await store.get(token);
112
113
  if (live?.status === "pending") {
113
114
  throw new CheckpointError("resume.preflight_rejected", `the deployment's resumePreflight ruled this resume PERMANENTLY blocked${said}, but the row moved under this refusal (a concurrent resolve/reopen cycle) — nothing was settled here; the row is pending again, re-resume against the current state (the preflight screens every attempt)`);
114
115
  }
115
116
  throw new CheckpointError("resume.preflight_rejected", `the deployment's resumePreflight ruled this resume PERMANENTLY blocked${said} — a concurrent actor had already settled the row (${describeSuppliedValue(live?.status ?? "consumed")}); nothing was settled by this refusal`);
116
117
  }
117
- parentConstraintRegistry.delete(token);
118
- const terminalReap = suspendedEnvReaps.get(token);
119
- suspendedEnvReaps.delete(token);
120
- locallyClaimedTokens.delete(token);
121
- if (terminalReap?.env !== undefined && hasDestroy(terminalReap.env)) {
122
- const terminalEnv = terminalReap.env;
123
- await settleTeardownLeg(() => terminalEnv.destroy(), "terminal-preflight env destroy", (envErr) => {
124
- try {
125
- runner.deps.onError?.(envErr, { phase: "config", sessionId: terminalReap.sessionId });
126
- }
127
- catch {
128
- }
129
- });
130
- }
131
118
  try {
132
119
  runner.deps.onError?.(new Error(`resumePreflight ruled this row PERMANENTLY blocked${said} — the row was settled terminally (expired) by this refusal's single-shot CAS (token no longer redeemable)`), { phase: "hook", sessionId: cp.sessionId });
133
120
  }
@@ -6,6 +6,8 @@ const RETIRED_RUNNER_DEPS_KEYS = {
6
6
  builtinWorkflows: "the engine ships no built-in named workflows — the Workflow tool's `{name}` resolves only `RunnerDeps.workflowScriptStore`; register any named workflow there",
7
7
  graderEnvFactory: "the grader env reaches the repair loop as `RepairLoopConfig.graderEnv`, minted by the trusted control plane (`assertOracleIsolation` / `GraderEnv` unchanged)",
8
8
  mcpImageResizer: "one image processor seat serves every image of a run: `RunnerDeps.imageProcessor` (an `ImageDownsampler`, or `false` for none; absent detects sharp once per process) — the MCP result, the Read tool, PDF pages, Bash data URIs, any tool's result, task images and attachments all pass the one admission with it",
9
+ mediaByteCapBytes: "the request's media budget is `RunnerDeps.mediaBudgetBase64Chars`, in base64 characters (the unit a provider counts; 0 or Infinity: none, else a whole number of at least twice `IMAGE_ADMISSION.request.hysteresisBase64Chars`)",
10
+ onMediaStripped: "the media a request leaves out is told to the person as the `context.media_removed` notice (reason `media_budget`, once per block per session) and to the operator as the `context.media_removed` trace frame (one per request)",
9
11
  "hands.readImageDownsampler": "one image processor seat serves every image of a run: `RunnerDeps.imageProcessor` (an `ImageDownsampler`, or `false` for none; absent detects sharp once per process) — the Read tool's images ride it with every other carrier's",
10
12
  "hands.readCyberReminder": "a Read result carries only the reminders about that read (an empty file, an offset past the end, a file already in context) — no standing content-safety tail, so there is nothing to switch; a deployment that wants that sentence states it in its own `appendSystemPrompt`",
11
13
  promptProvider: "a deployment changes prompt text through overlays: register a `prompt.compose` handler on `RunnerDeps.mods` answering `{ overlays }` (role base `replace`, a brand line `add` to the role band, a behavior or scenario `add`, a core-behavior `replace` / `append` / `drop`), choose the role base per task with `TaskSpec.promptRole`, and dispose of an MCP server's instructions with a `prompt.section` registration answering `{ text }` / `{ text: null }`",
@@ -45,6 +45,8 @@ export interface RunGitLaneInput {
45
45
  onTurnEnd: (event: Extract<AgentHarnessEvent, {
46
46
  type: "turn_end";
47
47
  }>) => void;
48
+ /** borrowed-readonly — the harness-handlers lane's turn_start closure (awaited by the loop only when it raises). */
49
+ onTurnStart: () => Promise<void> | undefined;
48
50
  /** borrowed-readonly — the turn-boundary lane's handler, registered on `turn_boundary` AFTER the owed-frame retry
49
51
  * so a pending announcement is re-asserted into the session ahead of the boundary's own context work. */
50
52
  onTurnBoundary: (event: {
@@ -1,8 +1,9 @@
1
1
  import { GIT_STATUS_ECHO_PREVIEW } from "./git-status-frame.js";
2
2
  import { wrapGitFrame } from "./git-leg-delivery.js";
3
+ import { appendAdmittedRow } from "../row-admission.js";
3
4
  import { thrownText } from "../thrown-value.js";
4
5
  export function runGitLane(input) {
5
- const { prepared, queue, rs, ident, onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, onTurnBoundary, runner } = input;
6
+ const { prepared, queue, rs, ident, onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, onTurnStart, onTurnBoundary, runner } = input;
6
7
  prepared.gitStatusRef.reassert = async () => {
7
8
  const ref = prepared.gitStatusRef;
8
9
  const frame = ref.frame;
@@ -14,7 +15,7 @@ export function runGitLane(input) {
14
15
  : { kind: frame.kind, body: frame.body, hash: frame.hash };
15
16
  const wrapped = wrapGitFrame(use.body, prepared.reminderMark);
16
17
  try {
17
- const entryId = await prepared.session.appendMessage({
18
+ const entryId = await appendAdmittedRow(prepared.admitRows, prepared.session, {
18
19
  role: "user",
19
20
  content: [{ type: "text", text: wrapped }],
20
21
  timestamp: Date.now(),
@@ -80,6 +81,8 @@ export function runGitLane(input) {
80
81
  const unsubBoundary = prepared.harness.on("turn_boundary", onTurnBoundary);
81
82
  const unsub = prepared.harness.subscribe((event) => {
82
83
  switch (event.type) {
84
+ case "turn_start":
85
+ return onTurnStart();
83
86
  case "message_update":
84
87
  onMessageUpdate(event);
85
88
  break;
@@ -98,6 +101,7 @@ export function runGitLane(input) {
98
101
  default:
99
102
  break;
100
103
  }
104
+ return undefined;
101
105
  });
102
106
  return { flushGitMirror, unsubGitRetry, unsubBoundary, unsub };
103
107
  }
@@ -36,6 +36,8 @@ export interface RunHarnessHandlersResult {
36
36
  onTurnEnd: (event: Extract<AgentHarnessEvent, {
37
37
  type: "turn_end";
38
38
  }>) => void;
39
+ /** A model turn began: `turn.start` (the loop awaits it before the turn's first request); `undefined` when unheard. */
40
+ onTurnStart: () => Promise<void> | undefined;
39
41
  /** The leg's workspace-frame observation (`Prepared.workspaceFrame.observe`); the run body
40
42
  * calls it after a resume's approved-call resolution, which bypasses onToolEnd. */
41
43
  announceWorkspaceMove: () => void;