@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
@@ -7,6 +7,7 @@ import { reconcileInterruptedSession } from "../session-reconcile.js";
7
7
  import { detectConflicts, settleBranchWriteBack } from "./branch-writeback.js";
8
8
  import { settleTeardownLeg } from "./teardown-bounded.js";
9
9
  import { writesThroughLeg } from "./session-write-ledger.js";
10
+ import { replayLossLeg } from "./lineage-reroot-view.js";
10
11
  const RECONCILE_MAX_RETRIES = 3;
11
12
  export async function prepareAcquireReconcile(input) {
12
13
  const { sessions, spec, resume, wakeEffects } = input;
@@ -15,6 +16,7 @@ export async function prepareAcquireReconcile(input) {
15
16
  let conflictRef;
16
17
  let wakeRecovered = [];
17
18
  let branch;
19
+ const lossLeg = input.replayLossNotice !== undefined ? replayLossLeg(input.replayLossNotice) : undefined;
18
20
  for (let attempt = 0;; attempt++) {
19
21
  try {
20
22
  acquired = await sessions.acquire(spec.sessionId, spec.requireExistingSession ? { requireExisting: true } : input.placement !== undefined ? { placement: input.placement } : undefined);
@@ -30,14 +32,15 @@ export async function prepareAcquireReconcile(input) {
30
32
  }
31
33
  conflictRef = { hit: false };
32
34
  const own = { ids: undefined };
33
- session = new StoredSession(detectConflicts(input.legWrites !== undefined ? writesThroughLeg(acquired.session.getStorage(), input.legWrites, acquired.sessionId) : acquired.session.getStorage(), conflictRef, own));
35
+ const legStorage = input.legWrites !== undefined ? writesThroughLeg(acquired.session.getStorage(), input.legWrites, acquired.sessionId) : acquired.session.getStorage();
36
+ session = new StoredSession(detectConflicts(lossLeg !== undefined ? lossLeg.view(legStorage, acquired.sessionId) : legStorage, conflictRef, own));
34
37
  if (!spec.sessionId) {
35
38
  break;
36
39
  }
37
40
  try {
38
41
  if (resume) {
39
42
  await session.getStorage().setLeafId(resume.leafId).catch((cut) => {
40
- throw readMember(cut, "code") === "not_found" ? new SessionError("invalid_session", `session "${spec.sessionId}" no longer holds the entry its checkpoint was cut at ("${resume.leafId}")`, cut) : cut;
43
+ throw readMember(cut, "code") === "not_found" ? new SessionError("corrupt_session", `session "${spec.sessionId}" no longer holds the entry its checkpoint was cut at ("${resume.leafId}")`, cut) : cut;
41
44
  });
42
45
  }
43
46
  else if (spec.resumeAt !== undefined) {
@@ -113,6 +116,7 @@ export async function prepareAcquireReconcile(input) {
113
116
  await settleTeardownLeg(() => Promise.resolve(forget(id)).catch(() => undefined), "forget (acquire-reconcile re-wake leg)", (e) => input.report?.(e, id));
114
117
  }
115
118
  branch = undefined;
119
+ lossLeg?.discard();
116
120
  continue;
117
121
  }
118
122
  if (branch !== undefined)
@@ -121,5 +125,6 @@ export async function prepareAcquireReconcile(input) {
121
125
  throw err;
122
126
  }
123
127
  }
128
+ lossLeg?.settle();
124
129
  return { acquired, session, conflictRef, wakeRecovered, branch };
125
130
  }
@@ -3,8 +3,8 @@ import type { AgentTool } from "../../internal/harness.js";
3
3
  import type { AdvertisedWritableDirs } from "./advertised-writable-dirs.js";
4
4
  import type { AutoModeDenialTracker } from "../auto-mode.js";
5
5
  import { type LegModBus } from "../mods/stations.js";
6
- import { type OnAsk, type ToolCallRequest, type ToolPolicy } from "../tool-policy.js";
7
- import type { RunnerDeps, TaskSpec } from "../types.js";
6
+ import { type AskSourceIdentity, type OnAsk, type ToolCallRequest, type ToolPolicy } from "../tool-policy.js";
7
+ import type { RunnerDeps } from "../types.js";
8
8
  import type { CwdRef } from "../../tools/fs/fs-shared.js";
9
9
  import type { AskLane, Prepared } from "./contracts.js";
10
10
  import { type GrantBindingOf } from "../skill-grant-binding.js";
@@ -60,14 +60,8 @@ export interface PrepareAskLaneInput {
60
60
  ruleOffersOf: ReturnType<typeof createRuleOffersOf>;
61
61
  /** borrowed-readonly — the policy-chain phase's Skill-card binding factory (`boundGrants` / `boundGrantDigest` on the ask). */
62
62
  grantBindingOf: GrantBindingOf;
63
- /** borrowed-readonly — the policy-chain phase's Runner-filled source identity (one factory, every ask mint site). */
64
- askSourceIdentity: () => {
65
- principal?: string;
66
- sourceTaskId?: string;
67
- fromSubagent?: true;
68
- sourceAgentName?: string;
69
- isDelegatedChild?: true;
70
- };
63
+ /** borrowed-readonly — the leg's one ask source (minted once by the driver; every ask mint site spreads it). */
64
+ askSource: AskSourceIdentity;
71
65
  /** borrowed-readonly — the policy-chain phase's per-tool risk-axes projection (`riskAxes` on the ask). */
72
66
  riskAxesOf: (call: Pick<ToolCallRequest, "toolName" | "face">) => {
73
67
  riskAxes?: {
@@ -80,8 +74,8 @@ export interface PrepareAskLaneInput {
80
74
  autoModeDenialTracking: {
81
75
  readonly current: AutoModeDenialTracker | undefined;
82
76
  };
83
- /** borrowed-readonly — the REBOUND spec; only `taskId` is read (the late-settlement observer's tag). */
84
- spec: Pick<TaskSpec, "taskId">;
77
+ /** borrowed-readonly — the leg's own task id (`Prepared.taskId`; the late-settlement observer's tag). */
78
+ hostTaskId: string;
85
79
  /** borrowed-readonly — the deployment seats this lane reports on, as a Pick over the SAME `deps` object (receiver
86
80
  * preserved for `deps.onError?.()`): the late-settlement observer's notice/error sinks and the hook-crash notifier. */
87
81
  deps: Pick<RunnerDeps, "onNotice" | "onError">;
@@ -55,7 +55,7 @@ function resolveApprovalPreview(tools, toolName, args) {
55
55
  }
56
56
  }
57
57
  export function prepareAskLane(input) {
58
- const { gateMachineryActive, abortController, effectivePolicy, budgetSnapshot, handsCwdRef, handsRoot, stampCallTarget, advertisedWritableDirs, exemptRoots, tools, inheritedUnavailableAsks, inheritedAskGrants, onAsk, humanReviewRef, now, ruleOffersOf, grantBindingOf, askSourceIdentity, riskAxesOf, autoModeDenialTracking, spec, deps, sessionId, runId, grantReadRoot, modBus, notifyOwnHookCrash } = input;
58
+ const { gateMachineryActive, abortController, effectivePolicy, budgetSnapshot, handsCwdRef, handsRoot, stampCallTarget, advertisedWritableDirs, exemptRoots, tools, inheritedUnavailableAsks, inheritedAskGrants, onAsk, humanReviewRef, now, ruleOffersOf, grantBindingOf, askSource, riskAxesOf, autoModeDenialTracking, hostTaskId, deps, sessionId, runId, grantReadRoot, modBus, notifyOwnHookCrash } = input;
59
59
  if (!gateMachineryActive)
60
60
  return { askLane: undefined };
61
61
  const composedCallSignal = (callSignal) => composeCallSignal(abortController.signal, callSignal);
@@ -106,7 +106,7 @@ export function prepareAskLane(input) {
106
106
  ...ruleOffersOf(req, req.args, decision.action === "ask" ? decision : undefined),
107
107
  ...grantBindingOf(req, req.args),
108
108
  ...cardDisclosureOf(decision, `approval required for "${req.toolName}"`),
109
- ...askSourceIdentity(),
109
+ ...askSource,
110
110
  ...riskAxesOf(req),
111
111
  ...approvalCardMemberOf(req),
112
112
  ...requesterOf(modBus, req.toolCallId),
@@ -117,9 +117,9 @@ export function prepareAskLane(input) {
117
117
  ...(decision.action === "ask" && decision.probeCause !== undefined ? { probeCause: decision.probeCause } : {}),
118
118
  ...(decision.action === "ask" && decision.probeReadRootCandidate !== undefined ? { readRootCandidate: decision.probeReadRootCandidate } : {}),
119
119
  ...(decision.action === "ask" && decision.ruleEvidence !== undefined ? { ruleEvidence: decision.ruleEvidence } : {}),
120
- }, onAsk, composedCallSignal(callSignal), lateAskSettlementObserver({ toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId, ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}), onNotice: deps.onNotice, onError: deps.onError }));
120
+ }, onAsk, composedCallSignal(callSignal), lateAskSettlementObserver({ toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice, onError: deps.onError }));
121
121
  const waitMs = Math.max(0, now() - t0);
122
- const granting = settleReadRootGrant(resolved.readRootGrant, grantReadRoot, { toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId, ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}), onNotice: deps.onNotice, signal: composedCallSignal(callSignal) });
122
+ const granting = settleReadRootGrant(resolved.readRootGrant, grantReadRoot, { toolName: req.toolName, toolCallId: req.toolCallId, sessionId, runId, taskId: hostTaskId, onNotice: deps.onNotice, signal: composedCallSignal(callSignal) });
123
123
  if (granting !== undefined)
124
124
  await granting;
125
125
  if (resolved.approverUnavailable !== true && attestationOf(resolved, req)?.settlement?.kind !== "task_aborted") {
@@ -19,6 +19,7 @@ import type { AgentHarness } from "../../internal/harness.js";
19
19
  import { type CheckpointStore } from "../checkpoint-store.js";
20
20
  import type { SessionStore } from "../session.js";
21
21
  import type { RunnerDeps, TaskSpec } from "../types.js";
22
+ import type { AskSourceIdentity } from "../tool-policy.js";
22
23
  import type { Prepared, SuspendSaga } from "./contracts.js";
23
24
  export interface PrepareBoundaryParksInput {
24
25
  /** borrowed-readonly — the suspend saga's eight seats (the serializer, the commit saga, the loop cap, the env split, the
@@ -48,8 +49,10 @@ export interface PrepareBoundaryParksInput {
48
49
  session: Pick<Prepared["session"], "getLeafId">;
49
50
  /** borrowed-readonly — the session store; only the optional `pin` is called (best-effort, after commit). */
50
51
  sessions: Pick<SessionStore, "pin">;
51
- /** borrowed-readonly — the acquired session id (the rows' session, the source attribution, every disclosure's tag). */
52
+ /** borrowed-readonly — the acquired session id (the rows' session, every disclosure's tag). */
52
53
  sessionId: string;
54
+ /** borrowed-readonly — the leg's one ask source (minted once by the driver): the plan_review row's `sourceSessionId`. */
55
+ askSource: Pick<AskSourceIdentity, "sourceSessionId">;
53
56
  /** borrowed-readonly — the deployment's error face, as a Pick over the SAME `deps` object (receiver preserved for
54
57
  * `deps.onError?.()`): the suspendVM refusals, the skipped-review lines, the pin failures. */
55
58
  deps: Pick<RunnerDeps, "onError">;
@@ -4,7 +4,7 @@ import { defaultTaskRegistry } from "../task-registry.js";
4
4
  import { DEFAULT_RESOURCE_TTL_MS, publishCommittedSuspend, sanitizedTtlMs, USAGE_WINDOW_REAP_MARGIN_MS } from "./park-commit.js";
5
5
  import { remoteEnvFailureNote } from "./remote-env-retry.js";
6
6
  export function prepareBoundaryParks(input) {
7
- const { saga, spec, checkpointStore, checkpointScope, abortController, harness, session, sessions, sessionId, deps, priorLedger, maxSlices, maxSuspends, resourceTotal, priorSuspendCount, suspendChainBase, humanReviewRef, liveSpendRef, now, pausedRef, remoteEnvFailures, resourceSuspendEligible, durableSuspendInfraReady, suspendTargetGap } = input;
7
+ const { saga, spec, checkpointStore, checkpointScope, abortController, harness, session, sessions, sessionId, askSource, deps, priorLedger, maxSlices, maxSuspends, resourceTotal, priorSuspendCount, suspendChainBase, humanReviewRef, liveSpendRef, now, pausedRef, remoteEnvFailures, resourceSuspendEligible, durableSuspendInfraReady, suspendTargetGap } = input;
8
8
  if (saga === undefined)
9
9
  return { suspendForResource: undefined, suspendForPlatformLimit: undefined, suspendForReview: undefined };
10
10
  const { inFlightSpendMicroUsd, serializeCheckpointState, commitSuspendSaga, suspendLoopCapHit, suspendableEnv, parkOnlyRemoteEnv, parkOnlyHandle } = saga;
@@ -144,7 +144,7 @@ export function prepareBoundaryParks(input) {
144
144
  ? { count: humanReviewRef.count, totalWaitMs: humanReviewRef.totalWaitMs, gates: [...humanReviewRef.gates] }
145
145
  : undefined,
146
146
  resourceLedger: reviewLedger,
147
- sourceTaskId: sessionId,
147
+ sourceSessionId: askSource.sourceSessionId,
148
148
  ...(spec.principal ? { principal: spec.principal } : {}),
149
149
  ...(spec.durableApproval !== undefined ? { durableApproval: { ...spec.durableApproval } } : {}),
150
150
  };
@@ -59,6 +59,7 @@ export interface PrepareCapsAndWorkflowInput {
59
59
  * the chain's auto-mode face (`inheritedGate.autoModeFace`). */
60
60
  internals: Pick<RunInternals, "rootSessionId" | "placementRoot" | "onTaskNotification" | "workflowDepth" | "memoryCaptureAncestors" | "workflowParkedResume" | "holder" | "questionFaceStripped" | "inheritedGate"> | undefined;
61
61
  /** borrowed-readonly — the tree's cross-boundary token (inherited or minted), which the Workflow mount hands to its children. */ crossBoundaryTree: import("../cross-boundary-taint.js").CrossBoundaryTreeToken;
62
+ /** borrowed-readonly — the tree's owner seat, which the Workflow mount hands to its children (by reference). */ delegationOwner: import("./delegation-owner.js").DelegationOwnerSeat;
62
63
  /** borrowed-readonly — the acquired session; the classifier leg rebuilds its transcript window from `buildContext`. */
63
64
  session: Pick<StoredSession, "buildContext">;
64
65
  /** borrowed-readonly — the acquired session id (operator-line context, the refusal codes' phase record). */
@@ -71,6 +72,8 @@ export interface PrepareCapsAndWorkflowInput {
71
72
  taskScope: string;
72
73
  /** borrowed-readonly — the SETTLED task root the Workflow mount hands its children as `parentCwd`. */
73
74
  taskRootFinal: string;
75
+ /** borrowed-readonly — this leg's own target (absent: none), the fence the Workflow mount hands every agent it spawns. */
76
+ ownTarget: import("../remote-env.js").PlacementTarget | undefined;
74
77
  /** borrowed-readonly — the run's resolved model: the classifier leg's fallback and the route pre-flight's primary. */
75
78
  model: Model;
76
79
  /** borrowed-readonly — the run's resolved thinking level, when one is (the Workflow mount's parentThinking fallback). */
@@ -331,7 +331,7 @@ export async function prepareCapsAndWorkflow(input) {
331
331
  scope: taskScope,
332
332
  notifier: deps.workflowCompletionNotifier,
333
333
  originatingSessionId: sessionId,
334
- rootSessionId: internals?.rootSessionId ?? sessionId, ...(internals?.placementRoot !== undefined ? { placementRoot: internals.placementRoot } : {}), crossBoundaryTree: input.crossBoundaryTree,
334
+ rootSessionId: internals?.rootSessionId ?? sessionId, ...(internals?.placementRoot !== undefined ? { placementRoot: internals.placementRoot } : {}), crossBoundaryTree: input.crossBoundaryTree, delegationOwner: input.delegationOwner,
335
335
  taskRegistry: defaultTaskRegistry,
336
336
  taskNotification: internals?.onTaskNotification, ...(taskArtifacts !== undefined ? { taskArtifacts } : {}),
337
337
  taskOwner: hostTaskId,
@@ -367,6 +367,7 @@ export async function prepareCapsAndWorkflow(input) {
367
367
  agentStations: input.agentStations,
368
368
  workflowDepth: internals?.workflowDepth,
369
369
  parentCwd: taskRootFinal,
370
+ ...(input.ownTarget !== undefined ? { placementTarget: input.ownTarget } : {}),
370
371
  parentThinking: () => childThinkingSeat(undefined, deploymentSubagentThinking(runnerSelf.agentCatalog?.roles), harnessRef.current?.getThinkingLevel() ?? thinking).thinking,
371
372
  parentClamps: runClampSource,
372
373
  onNotice: deps.onNotice,
@@ -24,7 +24,6 @@ import type { ThinkingLevel } from "../../internal/harness.js";
24
24
  import { type MicroCompactMachine } from "../context-edit.js";
25
25
  import { type CrossBoundaryPosture } from "../cross-boundary-taint.js";
26
26
  import { type HostFloor } from "../host-floor.js";
27
- import { type CheckpointState } from "../checkpoint-store.js";
28
27
  import { runOriginOfLeg, type RunOrigin } from "../run-origin.js";
29
28
  import { type ConfigDoorEntry, type LockedPreflight, type ReceivedPeerDeclarations } from "../locked-config.js";
30
29
  import { type ResolvedRole } from "../roles.js";
@@ -269,15 +268,16 @@ export declare function configValueDoors(input: {
269
268
  * The doors a RESUMED leg's prepare refuses at, run as one screen BEFORE the claim — prepare's own functions, so a refusal carries
270
269
  * the very sentence and code prepare throws: the mode doors (`refusePermissionModeDoors`), the output-style seat, the approval
271
270
  * reach, the skills invoked by name (the part no roster changes), the attachments (a resume sends no new human message, so any
272
- * entry is refused), the leg declarations of the tools it re-supplies (this phase's first door), this phase's value doors over the config, the deployment's deps and the session store the Runner holds
273
- * ({@link configValueDoors}, the retention capability door and the run-origin door over the row's recorded word included) and the mode
274
- * words the row recorded (`recordedModeSeed`). It leaves by the resume's ONE refusal channel (`asResumeConfigRefusal`:
271
+ * entry is refused), the leg declarations of the tools it re-supplies (this phase's first door), and this phase's value doors over the config, the deployment's deps and the session store the Runner holds
272
+ * ({@link configValueDoors}, the retention capability door and the run-origin door over the config's word included). The words the
273
+ * row recorded (its mode seed, its run origin) are not this door's: the row's own verdict judged them before it (`judgeCheckpointRow`,
274
+ * checkpoint-row-verdict.ts), so this door reads nothing off the row. It leaves by the resume's ONE refusal channel (`asResumeConfigRefusal`:
275
275
  * `checkpoint.config_refused`, `detail.code` = prepare's code, `detail.field` = `"taskConfig"`, `"deps"` or `"inheritedGate"`)
276
276
  * where prepare would end the leg `failed` after the claim — the row consumed on a store without `reopen`, replayed as a system
277
277
  * retry on one with it, which a configuration fix cannot reach. Before the claim the row stays `pending` and byte-identical and the
278
278
  * corrected resume redeems the same token. A throw that is none of prepare's codes leaves as it was thrown. Returns the config the
279
- * leg is handed: the caller's, its MCP servers and A2A peers the frozen entries the lock layer judged (read once, dialed as judged).
279
+ * leg is handed: the caller's, its MCP servers and A2A peers the lock layer's judged copies of the lists THIS resume handed (read once, dialed as judged; the row records none).
280
280
  */
281
- export declare function refuseResumeDoors<C extends ValueDoorSpec & Pick<TaskSpec, "userAttachments">>(config: C, recorded: Pick<CheckpointState, "inheritedGate" | "runOrigin"> | undefined, deps: RunnerDeps, sessions: SessionStore, holder?: string): C;
281
+ export declare function refuseResumeDoors<C extends ValueDoorSpec & Pick<TaskSpec, "userAttachments">>(config: C, deps: RunnerDeps, sessions: SessionStore, holder?: string): C;
282
282
  export declare function prepareConfigDoors(input: PrepareConfigDoorsInput): PrepareConfigDoorsResult;
283
283
  export {};
@@ -5,7 +5,7 @@ import { assertAddOnlySeats } from "../child-clamp-seats.js";
5
5
  import { CROSS_BOUNDARY_POSTURES } from "../cross-boundary-taint.js";
6
6
  import { compileHostFloor } from "../host-floor.js";
7
7
  import { assertNoRetiredRunnerDeps } from "./retired-runner-deps.js";
8
- import { recordedModeSeed, resolveCheckpointStore } from "../checkpoint-store.js";
8
+ import { resolveCheckpointStore } from "../checkpoint-store.js";
9
9
  import { runOriginOfLeg, screenRecordedRunOrigin } from "../run-origin.js";
10
10
  import { assertCheckpointStoreJudgesHolder, assertHolderValue } from "../checkpoint-generation.js";
11
11
  import { asResumeConfigRefusal, refusePermissionModeDoors } from "../mode-policy.js";
@@ -36,18 +36,18 @@ import { assertToolBoundaryLegs } from "../tool-roster.js";
36
36
  import { assertToolCardDeclarations } from "../../prompt-assembly/tool-catalog.js";
37
37
  import { refuseRenamedDelegationMounts } from "./sub-agent-deny-lists.js";
38
38
  import { readPrincipal } from "../principal-name.js";
39
- const TASK_LIMIT_KEY_DICT = {
40
- maxTokens: true,
41
- maxCostUsd: true,
42
- maxTurns: true,
43
- maxWalltimeMs: true,
44
- maxOutputTokens: true,
45
- approachNotice: true,
46
- budgetStreamCancel: true,
47
- degrade: true,
48
- brainCallGuardrailMs: true,
49
- };
50
- const TASK_LIMIT_KEYS = Object.keys(TASK_LIMIT_KEY_DICT);
39
+ import { optionKeys, strayMembersOf } from "../own-property-receipt.js";
40
+ const TASK_LIMIT_KEYS = optionKeys()({
41
+ maxTokens: 0,
42
+ maxCostUsd: 0,
43
+ maxTurns: 0,
44
+ maxWalltimeMs: 0,
45
+ maxOutputTokens: 0,
46
+ approachNotice: 0,
47
+ budgetStreamCancel: 0,
48
+ degrade: 0,
49
+ brainCallGuardrailMs: 0,
50
+ });
51
51
  const NUMERIC_TASK_LIMIT_KEYS = ["maxTokens", "maxCostUsd", "maxTurns", "maxWalltimeMs", "maxOutputTokens"];
52
52
  const RETIRED_TASK_LIMIT_KEYS = {
53
53
  timeoutSec: "maxWalltimeMs (milliseconds, not seconds)",
@@ -76,11 +76,10 @@ export function resolveTaskLimits(limits) {
76
76
  throw limitConfigError("config.limit_invalid", `TaskSpec.limits must be an object (got ${limits === null ? "null" : Array.isArray(limits) ? "an array" : typeof limits})`);
77
77
  }
78
78
  const raw = limits;
79
- const legal = TASK_LIMIT_KEYS;
80
- for (const key of Object.keys(raw)) {
81
- if (legal.includes(key))
82
- continue;
83
- const replacement = RETIRED_TASK_LIMIT_KEYS[key];
79
+ const stray = strayMembersOf(raw, { subject: "TaskSpec.limits", unit: "limit", moment: "when the task is prepared" }, TASK_LIMIT_KEYS)?.names[0];
80
+ if (stray !== undefined) {
81
+ const key = String(stray);
82
+ const replacement = Object.hasOwn(RETIRED_TASK_LIMIT_KEYS, key) ? RETIRED_TASK_LIMIT_KEYS[key] : undefined;
84
83
  throw limitConfigError("config.limit_unknown_key", `TaskSpec.limits.${key} is not a limit this engine reads` +
85
84
  (replacement !== undefined ? ` — it was replaced by \`${replacement}\`` : "") +
86
85
  `. Legal keys: ${TASK_LIMIT_KEYS.join(", ")}. Refused rather than ignored: a limit that is silently dropped reads to the caller as an armed ceiling.`);
@@ -347,7 +346,7 @@ export function configValueDoors(input, enter = ENTER_AS_IS) {
347
346
  enter("taskConfig", () => assertRetentionWords({ ...retention, stores: [{ name: "checkpointStore", store: taskStore }] }));
348
347
  return { toolFaceLists, promptHost, promptBinding, promptLean, lockedPreflight, skillListingSeats, skills, projectMemory, microCompactKnob, memoryDelegationEvidence, memoryProvenance, memoryCapturePolicy, usageWindows, brainCallGuardrailMs, crossBoundaryPosture, advisorTool, hostFloor, runOrigin, deploymentRoles, taskRoles };
349
348
  }
350
- export function refuseResumeDoors(config, recorded, deps, sessions, holder) {
349
+ export function refuseResumeDoors(config, deps, sessions, holder) {
351
350
  asResumeConfigRefusal("taskConfig", () => {
352
351
  refusePermissionModeDoors(config);
353
352
  resolveOutputStyleFrame(config.outputStyle);
@@ -357,8 +356,7 @@ export function refuseResumeDoors(config, recorded, deps, sessions, holder) {
357
356
  assertToolBoundaryLegs(config.tools);
358
357
  assertToolCardDeclarations(config.tools);
359
358
  });
360
- const { lockedPreflight, skills } = configValueDoors({ spec: config, deps, resumeLeg: true, sessions, holder, ...(recorded !== undefined ? { resumedRow: { recorded: recorded.runOrigin } } : {}) }, asResumeConfigRefusal);
361
- asResumeConfigRefusal("inheritedGate", () => void recordedModeSeed(recorded?.inheritedGate));
359
+ const { lockedPreflight, skills } = configValueDoors({ spec: config, deps, resumeLeg: true, sessions, holder, resumedRow: { recorded: undefined } }, asResumeConfigRefusal);
362
360
  return { ...config, ...(config.mcp !== undefined ? { mcp: lockedPreflight.mcp ?? [] } : {}), ...(config.a2a !== undefined ? { a2a: lockedPreflight.a2a ?? [] } : {}), skills };
363
361
  }
364
362
  export function prepareConfigDoors(input) {
@@ -27,13 +27,17 @@ import type { Prepared, PreparedMicroCompact } from "./contracts.js";
27
27
  import { type GitStatusLaneRef } from "./git-status-frame.js";
28
28
  import type { ReadFileState } from "../../tools/fs/safety.js";
29
29
  import { type ToolRosterDeltaSeat } from "../tool-roster.js";
30
+ import { type MediaBudgetRecord } from "./media-removed-seat.js";
30
31
  export interface PrepareContextLaneInput {
31
32
  /** borrowed-readonly — the task model: the budgets, the trigger-window geometry and `charsPerToken` are read off it. */
32
33
  model: Model;
33
34
  /** borrowed-readonly — the deployment seats, whole: `onNotice` (the clamp outlet, the offload-loss announcement, the
34
- * tool-turn repair seat), `tracer` (the cap / clear / trim frames), `mediaByteCapBytes` and `onMediaStripped` (the media
35
- * cap), `onError` (the git-frame degrade) — the guard chain and the machine-state builder read through the whole record. */
35
+ * tool-turn repair seat, the media-removed seats), `tracer` (the cap / clear / trim frames), `mediaBudgetBase64Chars` (the
36
+ * media trim), `onError` (the git-frame degrade) — the guard chain and the machine-state builder read the whole record. */
36
37
  deps: RunnerDeps;
38
+ /** borrowed-mutable — the session's announced record and the leg's receipt ledger: the media budget's account records
39
+ * the blocks it told of and parks the record's write ({@link createMediaBudgetSeat}). */
40
+ announced: MediaBudgetRecord;
37
41
  /** borrowed-readonly — the acquired session id (the offload persist key; every disclosure's attribution). */
38
42
  sessionId: string;
39
43
  /** borrowed-readonly — the run's invocation id (the clamp notice's per-run claim). */
@@ -3,7 +3,8 @@ import { TOOL_TURN_REPAIR_DROPS } from "../../internal/llm.js";
3
3
  import { droppedTransmissions } from "../user-attachment.js";
4
4
  import { clearStaleToolResults, createClearedProjectionLedger, dropEmptyFailureAssistants, editBudget, replayClearedProjection, resolveTriggerWindow } from "../context-edit.js";
5
5
  import { guardBudget, insertTrimNotice, protectGitFrame, trimToBudget } from "../context-guard.js";
6
- import { capAggregateMediaBytes, mediaBudgetBytes } from "../media-byte-cap.js";
6
+ import { requestMediaLimits } from "../image-admission.js";
7
+ import { trimRequestMedia } from "../media-byte-cap.js";
7
8
  import { capAggregateToolResults } from "../tool-result-budget.js";
8
9
  import { createOffloadPersist } from "../tool-result-store.js";
9
10
  import { emitTrace } from "../trace.js";
@@ -12,7 +13,7 @@ import { applyGitFrameGuard } from "./git-status-frame.js";
12
13
  import { applyContextShrinkToReadFileState } from "../../tools/fs/index.js";
13
14
  import { rosterToolName } from "../tool-roster.js";
14
15
  import { createToolTurnRepairSeat } from "./tool-turn-repair-seat.js";
15
- import { createImageRemovedSeat } from "./image-removed-seat.js";
16
+ import { createMediaBudgetSeat, createProviderRefusalSeat, createToolSchemaRemovedSeat } from "./media-removed-seat.js";
16
17
  export function prepareContextLane(input) {
17
18
  const { model, deps, sessionId, runId, hostTaskId, offloadStore, toolRosterDeltas, microCompactKnob, harness, batchHaltRef, gitStatusRef, postureFrameRef, requestLossyRef, trimPressureRef, readFileState } = input;
18
19
  const toolNameOf = (recorded) => rosterToolName(toolRosterDeltas.current, recorded);
@@ -20,7 +21,7 @@ export function prepareContextLane(input) {
20
21
  const requestGeometry = () => {
21
22
  const current = harness.getModel();
22
23
  const overlay = contextOverlay();
23
- return { editAt: editBudget(current, overlay), guardAt: guardBudget(current, overlay), charsPerToken: current.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN };
24
+ return { editAt: editBudget(current, overlay), guardAt: guardBudget(current, overlay), charsPerToken: current.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN, media: requestMediaLimits(current, deps.mediaBudgetBase64Chars) };
24
25
  };
25
26
  const microCompact = buildMicroCompactState(deps, model, sessionId, runId, offloadStore, microCompactKnob, contextOverlay());
26
27
  const charsPerToken = model.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN;
@@ -30,12 +31,15 @@ export function prepareContextLane(input) {
30
31
  requestLossyRef.current = true;
31
32
  announceRepairs(repairs);
32
33
  };
33
- harness.onImagesRemoved = createImageRemovedSeat((notice) => deps.onNotice?.(notice), { sessionId, runId });
34
+ const mediaNotices = { onNotice: deps.onNotice, sessionId, runId };
35
+ harness.onImagesRemoved = createProviderRefusalSeat(mediaNotices);
36
+ harness.onToolSchemaRefused = createToolSchemaRemovedSeat((notice) => deps.onNotice?.(notice), { sessionId, runId });
37
+ const accountMediaCut = createMediaBudgetSeat(mediaNotices, input.announced, { tracer: deps.tracer, taskId: hostTaskId });
34
38
  harness.on("context", async ({ messages, recheck, signal }) => {
35
39
  batchHaltRef.current = undefined;
36
40
  const pendingProjectionObservations = [];
37
41
  try {
38
- const { editAt, guardAt, charsPerToken: cpt } = requestGeometry();
42
+ const { editAt, guardAt, charsPerToken: cpt, media } = requestGeometry();
39
43
  const healed = dropEmptyFailureAssistants(messages);
40
44
  const replay = replayClearedProjection(healed, microCompact.ledger);
41
45
  const replayed = replay.messages;
@@ -52,14 +56,10 @@ export function prepareContextLane(input) {
52
56
  ts: Date.now(),
53
57
  }))),
54
58
  });
55
- const mediaCapped = capAggregateMediaBytes(capped, {
56
- limitBytes: mediaBudgetBytes(deps.mediaByteCapBytes),
57
- onStripped: (info) => {
58
- const onMediaStripped = deps.onMediaStripped;
59
- if (onMediaStripped !== undefined)
60
- pendingProjectionObservations.push(() => onMediaStripped(info));
61
- },
62
- });
59
+ const mediaTrim = trimRequestMedia(capped, media);
60
+ const mediaCapped = mediaTrim.messages;
61
+ if (mediaTrim.removed.length > 0)
62
+ pendingProjectionObservations.push(() => accountMediaCut(mediaTrim, media));
63
63
  let ccPass;
64
64
  const edited = microCompact.machine === "off" ? mediaCapped : clearStaleToolResults(mediaCapped, {
65
65
  budgetTokens: editAt, toolNameOf,
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * PrepareTask's DELEGATION-SURFACE phase, verbatim from the driver: the surface's two doors
3
3
  * (the background/workflow door the read/kill faces keep; the delegated-child arm SendMessage additionally mounts
4
- * on), the TaskOutput / TaskStop mounts, the SendMessage mount with its tier-3 revival spawner and peer seats, the
4
+ * on), the TaskStop mount, the SendMessage mount with its tier-3 revival spawner and peer seats, the
5
5
  * AgentTranscript residual lane, the peer lane's ListAgents, the Monitor tool, the EnterWorktree / ExitWorktree pair
6
6
  * with the worktree session seat it seeds from the checkpoint or the workspace snapshot, and the offload reader. The
7
7
  * revival spawner and the continuation tier it yields are machinery below (send-message-continuation.ts). The
@@ -13,7 +13,7 @@
13
13
  * (`@contract prepare.deps-read-stable`).
14
14
  *
15
15
  * The roster (`tools`) is borrowed-mutable here — the writer table lives on {@link Prepared.tools};
16
- * this phase's rows are the eight mounts named above. `childPolicy` is NOT a seat yet: the
16
+ * this phase's rows are the seven mounts named above. `childPolicy` is NOT a seat yet: the
17
17
  * delegation carriers still ride the enriched ctx's individual clamp fields, as they did in the driver.
18
18
  */
19
19
  import type { AgentTool, ExecutionEnv, WorkspaceState } from "../../internal/harness.js";
@@ -31,7 +31,7 @@ export interface PrepareDelegationSurfaceInput {
31
31
  /** borrowed-readonly — the REBOUND spec. Read: `tools` (the shadow checks and the revival spawner's delegation-tool
32
32
  * lookup), `retainBackgroundProcesses` (the Monitor receipt), `handsReadOnly` is NOT read here (the hands mount
33
33
  * decided the surface). Never mutated. */
34
- spec: Pick<TaskSpec, "tools" | "retainBackgroundProcesses" | "excludeAllTools">;
34
+ spec: Pick<TaskSpec, "tools" | "retainBackgroundProcesses" | "excludeAllTools" | "oneShot">;
35
35
  /** borrowed-readonly — the deployment seats the mounts read: `workflowRunStore` / `backgroundAgentStore` / `mailboxStore` (the
36
36
  * read/kill faces and the tier-3 revival seams), `rosterStore`, `peerLane`, `peerDirectory`, `peerChannel`, `onNotice`,
37
37
  * `onBackgroundChildEvent`, `tracer`. */
@@ -62,9 +62,9 @@ export interface PrepareDelegationSurfaceInput {
62
62
  backgroundTaskToolsActive: boolean;
63
63
  /** borrowed-readonly — this run's shell read station's pre-spawn ADMISSION (declared at the hands phase), for `Monitor`: the only P11 face that spawns a shell command. */
64
64
  shellReadAdmission: ShellReadAdmission | undefined;
65
- /** borrowed-readonly — the byte floor's seat over the run's read-deny table (declared at the hands phase), for `Monitor`:
66
- * the watched command's start carries the table to the environment, as the band's shell starts do. */
67
- shellReadFloor: ReadFloorSeat | undefined;
65
+ /** borrowed-readonly — the run's byte-floor seat (read-floor.ts), for the faces mounted here that start commands
66
+ * (`Monitor`, EnterWorktree / ExitWorktree): each start carries the floor it answers, as the band's shell starts do. */
67
+ runReadFloor: ReadFloorSeat;
68
68
  /** borrowed-readonly — the door's second half: the Workflow tool is on the roster. */
69
69
  workflowToolsActive: boolean;
70
70
  /** borrowed-readonly — the peer lane's mount verdict for this leg. */
@@ -76,11 +76,11 @@ export interface PrepareDelegationSurfaceInput {
76
76
  peerLaneRefs: PeerLaneRefs;
77
77
  /** borrowed-readonly — the session-box drain's mount judgment (the `ReadInbox` door: a box drained by this leg). */ sessionBox?: import("../task-notification.js").SessionBoxBinding | undefined;
78
78
  /** borrowed-mutable — the run's roster builder (`Prepared.tools` is its read face; the writer table is on that field).
79
- * Writers here: the eight mounts (TaskOutput, TaskStop, SendMessage, AgentTranscript, ListAgents, Monitor, the worktree
79
+ * Writers here: the seven mounts (TaskStop, SendMessage, AgentTranscript, ListAgents, Monitor, the worktree
80
80
  * pair, the offload reader), every one a `mount`. */
81
81
  roster: RosterBuilder;
82
82
  /** borrowed-readonly — not read by this phase: the effect collection (`Prepared.toolEffects`), the same map `roster` writes at each mount
83
- * (TaskOutput → read, TaskStop / SendMessage / Monitor / EnterWorktree / ExitWorktree → write, ReadInbox / ListAgents and its
83
+ * (TaskStop / SendMessage / Monitor / EnterWorktree / ExitWorktree → write, ReadInbox / ListAgents and its
84
84
  * alias → read), each from the mounted tool's own declaration; this phase writes nothing into it by name. */
85
85
  toolEffects: Map<string, ToolEffect>;
86
86
  /** borrowed-mutable — the explicit-negative axis declarations. Writer here: the built-in SendMessage mount's `egress: false`
@@ -128,7 +128,7 @@ export interface PrepareDelegationSurfaceInput {
128
128
  worktreeSeat: WorktreeSessionRef;
129
129
  }
130
130
  export interface PrepareDelegationSurfaceResult {
131
- /** owned — whether the background/workflow door is open (TaskOutput / TaskStop / AgentTranscript ride it). */
131
+ /** owned — whether the background/workflow door is open (TaskStop / AgentTranscript ride it). */
132
132
  delegationSurfaceActive: boolean;
133
133
  /** borrowed-mutable — the EnterWorktree session's shared serializable state (`Prepared.worktreeSessionRef`), minted iff the
134
134
  * worktree pair mounted. Writers: the worktree tools at run time (Enter/Exit); the suspend serializer reads it. */
@@ -6,7 +6,7 @@ import { createReadInboxTool, READ_INBOX_TOOL_NAME } from "../../agents/read-inb
6
6
  import { valveLeaves } from "../../agents/tool-filter.js";
7
7
  import { createMonitorTool } from "../../tools/monitor.js";
8
8
  import { createWorktreeTools } from "../../tools/worktree.js";
9
- import { createTaskOutputTool, createTaskStopTool, defaultTaskRegistry } from "../task-registry.js";
9
+ import { createTaskStopTool, defaultTaskRegistry } from "../task-registry.js";
10
10
  import { createReadToolResultTool } from "../tool-result-store.js";
11
11
  import { emitTrace } from "../trace.js";
12
12
  import { deliverEngineNotice } from "../types.js";
@@ -21,7 +21,6 @@ export function prepareDelegationSurface(input) {
21
21
  if (delegationSurfaceActive || internals?.parentNotify !== undefined || peerLaneActive) {
22
22
  if (delegationSurfaceActive) {
23
23
  roster.mountAll([
24
- firstPartyOffload(createTaskOutputTool({ registry: defaultTaskRegistry, owner: hostTaskId, scope: taskScope, sessionId, workflowStore: deps.workflowRunStore, agentStore: deps.backgroundAgentStore, notificationWired: internals?.onTaskNotification !== undefined, toolResultStore: offloadStore, ...(checkpointSeat !== undefined ? { checkpointSeat } : {}) })),
25
24
  firstPartyOffload(createTaskStopTool({ registry: defaultTaskRegistry, owner: hostTaskId, scope: taskScope, sessionId, workflowStore: deps.workflowRunStore, agentStore: deps.backgroundAgentStore })),
26
25
  ], { source: "builtin", mountedBy: "delegation" });
27
26
  }
@@ -93,14 +92,14 @@ export function prepareDelegationSurface(input) {
93
92
  roster.mount(firstPartyOffload(createMonitorTool(executionEnv, {
94
93
  registry: defaultTaskRegistry,
95
94
  ...(input.shellReadAdmission !== undefined ? { shellReadAdmission: input.shellReadAdmission } : {}),
96
- ...(input.shellReadFloor !== undefined ? { readFloor: input.shellReadFloor } : {}),
95
+ readFloor: input.runReadFloor,
97
96
  owner: hostTaskId,
98
97
  scope: taskScope,
99
98
  ...(sessionId !== undefined ? { sessionId } : {}),
100
99
  ...(internals?.onTaskNotification !== undefined ? { onTaskNotification: internals.onTaskNotification } : {}),
101
100
  ...(handsCwdRef !== undefined ? { cwdRef: handsCwdRef } : {}),
102
101
  rootCanonical: taskRootCanonical,
103
- ...(offloadStore !== undefined ? { toolResultStore: offloadStore } : {}),
102
+ ...(spec.oneShot !== undefined ? { oneShot: spec.oneShot } : {}),
104
103
  retainBackgroundProcesses: spec.retainBackgroundProcesses === true,
105
104
  })), { source: "builtin", mountedBy: "backgroundTasks" });
106
105
  }
@@ -123,7 +122,7 @@ export function prepareDelegationSurface(input) {
123
122
  worktreeSessionRef.current = seeded;
124
123
  if (workspaceStateSettle !== undefined)
125
124
  workspaceStateSettle.restoredWorktreeDir = worktreeSessionRef.current?.worktreeDir;
126
- roster.mountAll(createWorktreeTools(executionEnv, { repoRoot: taskRootFinal, cwdRef: handsCwdRef, session: worktreeSessionRef }).map((t) => (envHandToolNames.add(t.name), firstPartyOffload(t))), { source: "builtin", mountedBy: "hands" });
125
+ roster.mountAll(createWorktreeTools(executionEnv, { repoRoot: taskRootFinal, cwdRef: handsCwdRef, session: worktreeSessionRef, readFloor: input.runReadFloor }).map((t) => (envHandToolNames.add(t.name), firstPartyOffload(t))), { source: "builtin", mountedBy: "hands" });
127
126
  }
128
127
  if (offloadStore)
129
128
  roster.mount(createReadToolResultTool(offloadStore, (ref, tree) => defaultTaskRegistry.artifactBoundaryLegs(ref, { owner: hostTaskId, scope: taskScope, sessionId }, tree)), { source: "builtin", mountedBy: "optional" });
@@ -1,3 +1,4 @@
1
+ import { type PlacementTarget } from "../remote-env.js";
1
2
  import type { ExecutionEnv } from "../../internal/harness.js";
2
3
  import type { RunnerDeps, TaskSpec } from "../types.js";
3
4
  import type { ChildPlacement, PrepareResume, RollbackStack, RunInternals } from "./contracts.js";
@@ -19,8 +20,8 @@ export interface PrepareExecutionEnvInput {
19
20
  spec: Pick<TaskSpec, "taskId">;
20
21
  /** borrowed-readonly — the trusted spawn-side requests: the explicit cwd (a contract), the isolation
21
22
  * request and the parent's cwd (both threaded to the factory ctx). */
22
- internals: Pick<RunInternals, "requestedCwd" | "isolation" | "parentCwd" | "callerRoot" | "worktreeOffered"> | undefined;
23
- /** borrowed-readonly — the resume leg: read to refuse an explicit cwd a checkpoint restore would overrule, and to tell the factory which workspace it rebuilds. */
23
+ internals: Pick<RunInternals, "requestedCwd" | "isolation" | "parentCwd" | "callerRoot" | "worktreeOffered" | "placementTarget"> | undefined;
24
+ /** borrowed-readonly — the resume leg: read to refuse an explicit cwd a checkpoint restore would overrule, and for the target its row recorded (the fence's first member source). */
24
25
  resume: Pick<PrepareResume, "workspaceHandle"> | undefined;
25
26
  /** borrowed-readonly — the run tree's placement fixed point, resolved ONCE by the driver; the factory
26
27
  * door refuses an empty value loudly before the factory is asked. */
@@ -52,5 +53,7 @@ export interface PrepareExecutionEnvResult {
52
53
  /** borrowed-readonly — where a CHILD landed against where its caller asked ({@link childPlacementOnLeg}); absent on a leg no
53
54
  * delegation caller placed (no `callerRoot`). */
54
55
  placement: ChildPlacement | undefined;
56
+ /** borrowed-readonly — the fence this leg was minted under (folded once here; absent when unfenced): the restore phase checks the env against it. */
57
+ placementFence: PlacementTarget | undefined;
55
58
  }
56
59
  export declare function prepareExecutionEnv(input: PrepareExecutionEnvInput): Promise<PrepareExecutionEnvResult>;
@@ -1,5 +1,6 @@
1
1
  import { StubExecutionEnv } from "../stub-env.js";
2
- import { frozenHandleCopy, hasDestroy } from "../remote-env.js";
2
+ import { hasDestroy } from "../remote-env.js";
3
+ import { mintPlacementFence } from "./placement-fence.js";
3
4
  import { announceMalformedCapabilities } from "./env-capability-census.js";
4
5
  import { childPlacementOnLeg, deploymentCanRerootChild, worktreeNotHonored } from "./child-tree.js";
5
6
  import { settleTeardownLeg } from "./teardown-bounded.js";
@@ -17,14 +18,16 @@ export async function prepareExecutionEnv(input) {
17
18
  await settleTeardownLeg(() => forgetOnThrow(), "forgetOnThrow (cwd-conflicts-restore leg)", (err) => deps.onError?.(err, { phase: "config", sessionId }));
18
19
  throw cwdConflictsRestoreError(internals.requestedCwd);
19
20
  }
21
+ let placementFence;
20
22
  try {
23
+ placementFence = mintPlacementFence(resume?.workspaceHandle, internals?.placementTarget);
21
24
  ownedEnv = deps.executionEnvFactory
22
25
  ? await deps.executionEnvFactory({
23
26
  sessionId, placementRootSessionId: mintPlacementRootSessionId(placementRootResolved),
24
- taskId: spec.taskId,
27
+ ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}),
25
28
  ...(internals?.isolation ? { isolation: internals.isolation } : {}),
26
29
  ...(internals?.parentCwd ? { parentCwd: internals.parentCwd } : {}),
27
- ...(resume?.workspaceHandle !== undefined ? { resumeWorkspace: frozenHandleCopy(resume.workspaceHandle) } : {}),
30
+ ...(placementFence !== undefined ? { placementTarget: placementFence } : {}),
28
31
  })
29
32
  : undefined;
30
33
  if (ownedEnv !== undefined)
@@ -78,7 +81,7 @@ export async function prepareExecutionEnv(input) {
78
81
  ownedEnvSeat.current = undefined;
79
82
  throw worktreeNotHonored(executionEnv.cwd);
80
83
  }
81
- return { executionEnv, ownedEnvSeat, ownedEnvObservedAt, handsEnabled, taskRootInitial, placement };
84
+ return { executionEnv, ownedEnvSeat, ownedEnvObservedAt, handsEnabled, taskRootInitial, placement, placementFence };
82
85
  }
83
86
  function cwdConflictsRestoreError(requestedCwd) {
84
87
  const e = new Error(`RunInternals.requestedCwd ("${requestedCwd}") cannot be combined with a checkpoint workspace restore — ` +