@sema-agent/core 7.60.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/CHANGELOG.md +605 -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 +61 -10
  6. package/dist/agents/cascade.js +60 -20
  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-notice-route.d.ts +1 -1
  17. package/dist/agents/peer-notice-route.js +4 -3
  18. package/dist/agents/peer-notices.d.ts +4 -4
  19. package/dist/agents/peer-notices.js +8 -4
  20. package/dist/agents/peer-session-drain.d.ts +8 -1
  21. package/dist/agents/peer-session-drain.js +36 -7
  22. package/dist/agents/repair-loop.js +16 -6
  23. package/dist/agents/retain-ledger.js +3 -1
  24. package/dist/agents/roster-store.d.ts +1 -1
  25. package/dist/agents/roster-store.js +7 -4
  26. package/dist/agents/send-message-tool.d.ts +8 -10
  27. package/dist/agents/send-message-tool.js +43 -23
  28. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  29. package/dist/agents/subagent-completion-gate.js +62 -0
  30. package/dist/agents/subagent-steps.d.ts +7 -6
  31. package/dist/agents/subagent.d.ts +30 -40
  32. package/dist/agents/subagent.js +187 -196
  33. package/dist/agents/suspend-guard.d.ts +9 -0
  34. package/dist/agents/suspend-guard.js +4 -0
  35. package/dist/agents/verify.d.ts +41 -14
  36. package/dist/agents/verify.js +37 -27
  37. package/dist/brain/anthropic.js +1 -0
  38. package/dist/brain/errors.d.ts +7 -1
  39. package/dist/brain/errors.js +6 -0
  40. package/dist/brain/failover.js +2 -1
  41. package/dist/brain/open-responses.js +1 -0
  42. package/dist/brain/openai.js +1 -0
  43. package/dist/brain/provider-dialect.d.ts +10 -0
  44. package/dist/brain/provider-dialect.js +13 -2
  45. package/dist/brain/stream-engine.d.ts +3 -0
  46. package/dist/brain/stream-engine.js +4 -0
  47. package/dist/core/agent-state.d.ts +1 -1
  48. package/dist/core/allow-entry.d.ts +59 -23
  49. package/dist/core/allow-entry.js +131 -38
  50. package/dist/core/ask-origin.d.ts +79 -0
  51. package/dist/core/ask-origin.js +76 -0
  52. package/dist/core/ask-question.d.ts +19 -13
  53. package/dist/core/ask-question.js +8 -2
  54. package/dist/core/auto-compaction.d.ts +2 -0
  55. package/dist/core/auto-compaction.js +2 -1
  56. package/dist/core/auto-mode.js +3 -5
  57. package/dist/core/background-agent-store.d.ts +7 -5
  58. package/dist/core/background-agent-store.js +12 -11
  59. package/dist/core/checkpoint-requirements.d.ts +24 -3
  60. package/dist/core/checkpoint-requirements.js +9 -1
  61. package/dist/core/checkpoint-store.d.ts +78 -19
  62. package/dist/core/checkpoint-store.js +8 -4
  63. package/dist/core/child-clamp-seats.d.ts +3 -2
  64. package/dist/core/child-clamp-seats.js +4 -3
  65. package/dist/core/closest-name.d.ts +13 -0
  66. package/dist/core/closest-name.js +35 -0
  67. package/dist/core/context-settings.js +3 -5
  68. package/dist/core/cross-boundary-taint.d.ts +1 -1
  69. package/dist/core/decision-receipt.d.ts +14 -1
  70. package/dist/core/decision-receipt.js +6 -3
  71. package/dist/core/delegation-frames.d.ts +13 -9
  72. package/dist/core/effective-path-target.js +2 -3
  73. package/dist/core/engine-attestation.d.ts +11 -1
  74. package/dist/core/engine-attestation.js +2 -0
  75. package/dist/core/engine-notice.d.ts +49 -18
  76. package/dist/core/file-history-retention.d.ts +8 -0
  77. package/dist/core/file-history-retention.js +14 -11
  78. package/dist/core/file-history-store.d.ts +31 -1
  79. package/dist/core/file-history-store.js +31 -2
  80. package/dist/core/frame-settlement.d.ts +10 -0
  81. package/dist/core/frame-settlement.js +6 -1
  82. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  83. package/dist/core/fs-write-gate-policy.js +8 -7
  84. package/dist/core/gate-fold.js +2 -1
  85. package/dist/core/gate-lanes.js +7 -4
  86. package/dist/core/gate-outcome.d.ts +40 -1
  87. package/dist/core/gate-outcome.js +10 -0
  88. package/dist/core/git-worktree-env.d.ts +7 -3
  89. package/dist/core/git-worktree-env.js +16 -13
  90. package/dist/core/governance-codes.d.ts +12 -4
  91. package/dist/core/governance-codes.js +16 -4
  92. package/dist/core/hooks.d.ts +12 -4
  93. package/dist/core/hooks.js +11 -4
  94. package/dist/core/host-floor.js +3 -5
  95. package/dist/core/image-admission.d.ts +48 -8
  96. package/dist/core/image-admission.js +35 -4
  97. package/dist/core/input-author.d.ts +36 -0
  98. package/dist/core/input-author.js +39 -0
  99. package/dist/core/leg-identity.d.ts +62 -0
  100. package/dist/core/leg-identity.js +18 -0
  101. package/dist/core/locked-config.d.ts +2 -1
  102. package/dist/core/locked-config.js +5 -3
  103. package/dist/core/lsp.d.ts +5 -3
  104. package/dist/core/lsp.js +3 -2
  105. package/dist/core/mailbox-store.d.ts +85 -10
  106. package/dist/core/mailbox-store.js +31 -10
  107. package/dist/core/mcp-connection-pool.d.ts +6 -20
  108. package/dist/core/mcp-connection-pool.js +10 -28
  109. package/dist/core/mcp-failure.d.ts +76 -15
  110. package/dist/core/mcp-failure.js +60 -33
  111. package/dist/core/mcp-host-seat.d.ts +92 -53
  112. package/dist/core/mcp-host-seat.js +220 -46
  113. package/dist/core/mcp-probe.js +2 -2
  114. package/dist/core/mcp-server-link.d.ts +18 -6
  115. package/dist/core/mcp-server-link.js +19 -4
  116. package/dist/core/mcp-server-spec.d.ts +2 -1
  117. package/dist/core/mcp-session-end.d.ts +1 -2
  118. package/dist/core/mcp-session-end.js +1 -1
  119. package/dist/core/mcp.d.ts +6 -49
  120. package/dist/core/mcp.js +115 -111
  121. package/dist/core/media-byte-cap.d.ts +21 -46
  122. package/dist/core/media-byte-cap.js +55 -55
  123. package/dist/core/member-group.d.ts +7 -0
  124. package/dist/core/member-group.js +35 -0
  125. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  126. package/dist/core/memory-engine/consolidation.js +7 -1
  127. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  128. package/dist/core/memory-engine/dual-root.js +59 -11
  129. package/dist/core/memory-engine/engine.js +27 -24
  130. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  131. package/dist/core/memory-engine/file-backend.js +35 -15
  132. package/dist/core/memory-engine/layout.d.ts +3 -0
  133. package/dist/core/memory-engine/layout.js +13 -3
  134. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  135. package/dist/core/memory-engine/memory-deployment.js +182 -0
  136. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  137. package/dist/core/memory-engine/sync-client.js +72 -14
  138. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  139. package/dist/core/memory-engine/sync.d.ts +9 -1
  140. package/dist/core/mode-policy.d.ts +8 -8
  141. package/dist/core/mode-policy.js +7 -5
  142. package/dist/core/mods/agent-stations.d.ts +39 -4
  143. package/dist/core/mods/agent-stations.js +59 -10
  144. package/dist/core/mods/dollar.d.ts +62 -0
  145. package/dist/core/mods/extension-call.d.ts +15 -1
  146. package/dist/core/mods/extension-call.js +7 -2
  147. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  148. package/dist/core/mods/kernel/dispatch.js +4 -4
  149. package/dist/core/mods/kernel/events.d.ts +4 -1
  150. package/dist/core/mods/kernel/events.js +6 -6
  151. package/dist/core/mods/kernel/registration.d.ts +3 -0
  152. package/dist/core/mods/kernel/registration.js +5 -0
  153. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  154. package/dist/core/mods/kernel/site-rules.js +10 -2
  155. package/dist/core/mods/session-append.d.ts +115 -0
  156. package/dist/core/mods/session-append.js +311 -0
  157. package/dist/core/mods/session-compact.d.ts +48 -0
  158. package/dist/core/mods/session-compact.js +194 -0
  159. package/dist/core/mods/session-receive.d.ts +93 -0
  160. package/dist/core/mods/session-receive.js +141 -0
  161. package/dist/core/mods/session-send.d.ts +72 -0
  162. package/dist/core/mods/session-send.js +88 -0
  163. package/dist/core/mods/stations.d.ts +38 -16
  164. package/dist/core/mods/stations.js +25 -11
  165. package/dist/core/mods/tool-call.d.ts +2 -0
  166. package/dist/core/mods/tool-call.js +4 -4
  167. package/dist/core/output-style.js +3 -4
  168. package/dist/core/own-property-receipt.d.ts +61 -2
  169. package/dist/core/own-property-receipt.js +42 -2
  170. package/dist/core/park-selfcheck.js +4 -2
  171. package/dist/core/path-identity.d.ts +11 -0
  172. package/dist/core/path-identity.js +4 -0
  173. package/dist/core/path-rule-binding.d.ts +3 -1
  174. package/dist/core/path-rule-binding.js +3 -1
  175. package/dist/core/peer-seat.d.ts +3 -3
  176. package/dist/core/peer-seat.js +20 -8
  177. package/dist/core/permission-rule-consent.d.ts +21 -5
  178. package/dist/core/permission-rule-consent.js +21 -1
  179. package/dist/core/permission-rule-model.d.ts +34 -11
  180. package/dist/core/permission-rule-model.js +47 -10
  181. package/dist/core/permission-rule-org.d.ts +1 -1
  182. package/dist/core/permission-rule-provider.js +4 -1
  183. package/dist/core/permission-rules.d.ts +4 -0
  184. package/dist/core/permission-rules.js +11 -16
  185. package/dist/core/remote-env.d.ts +74 -26
  186. package/dist/core/remote-env.js +20 -0
  187. package/dist/core/retention-policy.d.ts +24 -23
  188. package/dist/core/retention-policy.js +36 -2
  189. package/dist/core/retention.d.ts +4 -1
  190. package/dist/core/retired-keys.d.ts +4 -4
  191. package/dist/core/row-admission.d.ts +10 -0
  192. package/dist/core/row-admission.js +5 -0
  193. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  194. package/dist/core/runner/advisor-instructions.js +2 -1
  195. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  196. package/dist/core/runner/assemble-result.d.ts +13 -3
  197. package/dist/core/runner/assemble-result.js +12 -7
  198. package/dist/core/runner/caller-roster.d.ts +12 -9
  199. package/dist/core/runner/caller-roster.js +5 -2
  200. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  201. package/dist/core/runner/checkpoint-scope.js +21 -0
  202. package/dist/core/runner/compact-session.js +14 -2
  203. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  204. package/dist/core/runner/compaction-restate.d.ts +2 -2
  205. package/dist/core/runner/compaction-restate.js +4 -3
  206. package/dist/core/runner/construction-doors.d.ts +2 -2
  207. package/dist/core/runner/construction-doors.js +2 -2
  208. package/dist/core/runner/contracts.d.ts +98 -26
  209. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  210. package/dist/core/runner/decide-continuation.d.ts +4 -2
  211. package/dist/core/runner/decide-continuation.js +7 -4
  212. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  213. package/dist/core/runner/denial-limit-arms.js +17 -10
  214. package/dist/core/runner/expire-settle.d.ts +44 -0
  215. package/dist/core/runner/expire-settle.js +55 -0
  216. package/dist/core/runner/git-status-frame.d.ts +3 -3
  217. package/dist/core/runner/git-status-frame.js +2 -1
  218. package/dist/core/runner/halt-attribution.d.ts +2 -1
  219. package/dist/core/runner/halt-attribution.js +2 -1
  220. package/dist/core/runner/local-claims.d.ts +17 -0
  221. package/dist/core/runner/local-claims.js +18 -0
  222. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  223. package/dist/core/runner/media-removed-seat.js +88 -0
  224. package/dist/core/runner/park-commit.d.ts +2 -2
  225. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  226. package/dist/core/runner/permission-rule-lanes.js +28 -9
  227. package/dist/core/runner/person-path-rows.js +1 -1
  228. package/dist/core/runner/placement-fence.d.ts +26 -0
  229. package/dist/core/runner/placement-fence.js +38 -0
  230. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  231. package/dist/core/runner/prepare-ask-lane.js +4 -4
  232. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  233. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  234. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  235. package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
  236. package/dist/core/runner/prepare-config-doors.js +16 -17
  237. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  238. package/dist/core/runner/prepare-context-lane.js +13 -13
  239. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  240. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  241. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  242. package/dist/core/runner/prepare-execution-env.js +7 -4
  243. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  244. package/dist/core/runner/prepare-gate-stations.js +6 -4
  245. package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
  246. package/dist/core/runner/prepare-hands-readface.js +4 -4
  247. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
  248. package/dist/core/runner/prepare-inherited-gate.js +3 -0
  249. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  250. package/dist/core/runner/prepare-lsp.js +2 -2
  251. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  252. package/dist/core/runner/prepare-park-ask.js +4 -5
  253. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  254. package/dist/core/runner/prepare-policy-chain.js +16 -25
  255. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  256. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  257. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  258. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  259. package/dist/core/runner/prepare-question-face.js +2 -2
  260. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  261. package/dist/core/runner/prepare-run-refs.js +2 -2
  262. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  263. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  264. package/dist/core/runner/prepare-task.d.ts +1 -1
  265. package/dist/core/runner/prepare-task.js +56 -28
  266. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  267. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  268. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  269. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  270. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  271. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  272. package/dist/core/runner/read-root-grant.d.ts +1 -1
  273. package/dist/core/runner/read-root-grant.js +2 -1
  274. package/dist/core/runner/resume-admission.d.ts +5 -3
  275. package/dist/core/runner/resume-admission.js +17 -3
  276. package/dist/core/runner/resume-apply.js +3 -1
  277. package/dist/core/runner/resume-claim.d.ts +8 -3
  278. package/dist/core/runner/resume-claim.js +28 -12
  279. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  280. package/dist/core/runner/resume-internals-and-config.js +10 -1
  281. package/dist/core/runner/resume-preflight.d.ts +3 -2
  282. package/dist/core/runner/resume-preflight.js +13 -26
  283. package/dist/core/runner/retired-runner-deps.js +2 -0
  284. package/dist/core/runner/run-git-lane.js +2 -1
  285. package/dist/core/runner/run-harness-handlers.js +2 -2
  286. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  287. package/dist/core/runner/run-identity-wiring.js +14 -5
  288. package/dist/core/runner/run-leg.d.ts +3 -3
  289. package/dist/core/runner/run-leg.js +40 -29
  290. package/dist/core/runner/run-notification-lane.js +20 -2
  291. package/dist/core/runner/run-recovery-lanes.js +3 -2
  292. package/dist/core/runner/run-settle-and-teardown.js +9 -7
  293. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  294. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  295. package/dist/core/runner/run-terminal-adoption.js +26 -17
  296. package/dist/core/runner/run-turn-boundary.js +27 -14
  297. package/dist/core/runner/runtask.d.ts +18 -3
  298. package/dist/core/runner/runtask.js +27 -11
  299. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  300. package/dist/core/runner/session-rule-policy.js +6 -1
  301. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  302. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  303. package/dist/core/runner/stream-halt-verbs.js +4 -3
  304. package/dist/core/runner/stream-reap.d.ts +7 -6
  305. package/dist/core/runner/stream-reap.js +13 -16
  306. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  307. package/dist/core/runner/stream-settle-backstop.js +5 -3
  308. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  309. package/dist/core/runner/stream-steer-verb.js +8 -7
  310. package/dist/core/runner/terminal-account.d.ts +11 -1
  311. package/dist/core/runner/terminal-account.js +20 -0
  312. package/dist/core/runner/terminal-projection.d.ts +8 -2
  313. package/dist/core/runner/terminal-projection.js +2 -2
  314. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  315. package/dist/core/runner/tool-disclosure.js +5 -2
  316. package/dist/core/runner/tool-end-body.d.ts +3 -3
  317. package/dist/core/runner/tool-end-body.js +1 -1
  318. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  319. package/dist/core/runner/tool-output-projection.js +7 -6
  320. package/dist/core/runner/tool-table-view.d.ts +56 -0
  321. package/dist/core/runner/tool-table-view.js +51 -0
  322. package/dist/core/runner/turn-attachments.d.ts +3 -2
  323. package/dist/core/runner/turn-attachments.js +1 -1
  324. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  325. package/dist/core/runner/void-verifier-pause.js +41 -0
  326. package/dist/core/runner-deps.d.ts +24 -25
  327. package/dist/core/secret-env.d.ts +11 -11
  328. package/dist/core/secret-env.js +8 -9
  329. package/dist/core/session-log-transfer.js +9 -10
  330. package/dist/core/session-policy-store.d.ts +1 -1
  331. package/dist/core/session-policy-store.js +5 -2
  332. package/dist/core/session-reconcile.d.ts +3 -2
  333. package/dist/core/session-reconcile.js +7 -4
  334. package/dist/core/session-store.d.ts +2 -0
  335. package/dist/core/session-store.js +5 -7
  336. package/dist/core/session.d.ts +2 -1
  337. package/dist/core/shell-confinement.d.ts +37 -0
  338. package/dist/core/shell-confinement.js +56 -0
  339. package/dist/core/skill-grant.js +1 -1
  340. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  341. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  342. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  343. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  344. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  345. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  346. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  347. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  348. package/dist/core/task-event.d.ts +17 -8
  349. package/dist/core/task-limits.d.ts +5 -0
  350. package/dist/core/task-notification.d.ts +89 -12
  351. package/dist/core/task-notification.js +87 -13
  352. package/dist/core/task-registry-agent.d.ts +5 -43
  353. package/dist/core/task-registry-agent.js +24 -51
  354. package/dist/core/task-registry-monitor.d.ts +1 -1
  355. package/dist/core/task-registry-monitor.js +15 -60
  356. package/dist/core/task-registry-shared.d.ts +15 -112
  357. package/dist/core/task-registry-shared.js +3 -41
  358. package/dist/core/task-registry-workflow.js +4 -21
  359. package/dist/core/task-registry.d.ts +19 -60
  360. package/dist/core/task-registry.js +19 -106
  361. package/dist/core/task-result.d.ts +24 -7
  362. package/dist/core/task-spec-members.d.ts +39 -0
  363. package/dist/core/task-spec-members.js +92 -0
  364. package/dist/core/task-spec.d.ts +10 -10
  365. package/dist/core/task-tool-shape.d.ts +7 -57
  366. package/dist/core/task-tool-shape.js +7 -66
  367. package/dist/core/terminal-cause.d.ts +30 -0
  368. package/dist/core/terminal-cause.js +1 -0
  369. package/dist/core/tool-catalog-entries.js +2 -5
  370. package/dist/core/tool-check-reading.js +16 -10
  371. package/dist/core/tool-conformance.js +1 -2
  372. package/dist/core/tool-errors.d.ts +6 -3
  373. package/dist/core/tool-errors.js +2 -0
  374. package/dist/core/tool-face-reader.js +3 -2
  375. package/dist/core/tool-face.d.ts +2 -3
  376. package/dist/core/tool-name-aliases.d.ts +5 -29
  377. package/dist/core/tool-name-aliases.js +9 -5
  378. package/dist/core/tool-name-readings.d.ts +14 -3
  379. package/dist/core/tool-name-readings.js +2 -0
  380. package/dist/core/tool-policy.d.ts +108 -18
  381. package/dist/core/tool-policy.js +84 -14
  382. package/dist/core/tool-result-store.d.ts +23 -0
  383. package/dist/core/tool-result-store.js +3 -2
  384. package/dist/core/tool-spec.d.ts +19 -6
  385. package/dist/core/trace.d.ts +18 -1
  386. package/dist/core/user-attachment.js +26 -21
  387. package/dist/core/workflow-journal-store.d.ts +1 -1
  388. package/dist/core/workflow-run-store.d.ts +2 -0
  389. package/dist/core/workflow-run-store.js +6 -5
  390. package/dist/core/workflow-settled-run.d.ts +5 -0
  391. package/dist/core/workflow-settled-run.js +7 -0
  392. package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
  393. package/dist/engine/execution-env/node-execution-env.js +213 -21
  394. package/dist/engine/harness/agent-harness.d.ts +65 -18
  395. package/dist/engine/harness/agent-harness.js +90 -23
  396. package/dist/engine/harness/messages.d.ts +4 -3
  397. package/dist/engine/harness/messages.js +2 -2
  398. package/dist/engine/harness/types.d.ts +41 -7
  399. package/dist/engine/llm/media-removed.d.ts +14 -0
  400. package/dist/engine/llm/media-removed.js +9 -0
  401. package/dist/engine/llm/rejected-images.d.ts +35 -25
  402. package/dist/engine/llm/rejected-images.js +59 -10
  403. package/dist/engine/llm/types.d.ts +24 -3
  404. package/dist/engine/llm/types.js +7 -3
  405. package/dist/engine/loop/agent-loop.d.ts +6 -1
  406. package/dist/engine/loop/agent-loop.js +20 -11
  407. package/dist/engine/loop/types.d.ts +12 -3
  408. package/dist/engine/session/import-validate.js +7 -0
  409. package/dist/fixtures/index.d.ts +7 -5
  410. package/dist/fixtures/index.js +5 -3
  411. package/dist/index.d.ts +21 -11
  412. package/dist/index.js +15 -7
  413. package/dist/internal/harness-types.d.ts +2 -0
  414. package/dist/internal/llm.d.ts +2 -1
  415. package/dist/internal/llm.js +1 -0
  416. package/dist/orchestration/goal.d.ts +6 -2
  417. package/dist/orchestration/goal.js +6 -3
  418. package/dist/orchestration/run-workflow-tool.d.ts +11 -17
  419. package/dist/orchestration/run-workflow-tool.js +19 -42
  420. package/dist/orchestration/workflow-governance.d.ts +1 -1
  421. package/dist/orchestration/workflow-types.d.ts +2 -2
  422. package/dist/orchestration/workflow.d.ts +4 -0
  423. package/dist/orchestration/workflow.js +8 -5
  424. package/dist/stores/file/background-agent-store.js +18 -15
  425. package/dist/stores/file/checkpoint-store.js +7 -4
  426. package/dist/stores/file/file-history-store.js +3 -2
  427. package/dist/stores/file/index.d.ts +5 -3
  428. package/dist/stores/file/index.js +23 -8
  429. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  430. package/dist/stores/file/ledger-tuning.js +21 -0
  431. package/dist/stores/file/mailbox-store.js +42 -22
  432. package/dist/stores/file/memory-store.js +3 -2
  433. package/dist/stores/file/permission-rule-adopt.js +24 -21
  434. package/dist/stores/file/permission-rule-store.js +6 -3
  435. package/dist/stores/file/session-policy-store.js +3 -2
  436. package/dist/stores/file/session-store.d.ts +16 -3
  437. package/dist/stores/file/session-store.js +21 -20
  438. package/dist/stores/file/tool-result-store.d.ts +11 -0
  439. package/dist/stores/file/tool-result-store.js +57 -3
  440. package/dist/stores/file/usage-window-store.js +3 -2
  441. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  442. package/dist/stores/file/workflow-journal-store.js +3 -18
  443. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  444. package/dist/stores/file/workflow-run-store.js +15 -10
  445. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  446. package/dist/tools/fs/dead-cwd.js +4 -11
  447. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  448. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  449. package/dist/tools/fs/fs-bash.d.ts +3 -18
  450. package/dist/tools/fs/fs-bash.js +37 -124
  451. package/dist/tools/fs/fs-pdf.js +8 -6
  452. package/dist/tools/fs/fs-read.js +2 -2
  453. package/dist/tools/fs/fs-shared.d.ts +28 -3
  454. package/dist/tools/fs/fs-shared.js +15 -0
  455. package/dist/tools/fs/index.d.ts +1 -1
  456. package/dist/tools/fs/index.js +4 -14
  457. package/dist/tools/fs/pdf.d.ts +4 -4
  458. package/dist/tools/fs/pdf.js +6 -6
  459. package/dist/tools/fs/read-deny-home.js +8 -1
  460. package/dist/tools/fs/read-deny.d.ts +26 -2
  461. package/dist/tools/fs/read-deny.js +9 -2
  462. package/dist/tools/fs/read-floor.d.ts +13 -5
  463. package/dist/tools/fs/read-floor.js +206 -2
  464. package/dist/tools/fs/search.d.ts +3 -2
  465. package/dist/tools/fs/search.js +6 -6
  466. package/dist/tools/fs/shell-read-establish.js +3 -1
  467. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  468. package/dist/tools/fs/shell-read-identity.js +4 -2
  469. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  470. package/dist/tools/fs/shell-read-judge.js +1 -1
  471. package/dist/tools/monitor.d.ts +8 -7
  472. package/dist/tools/monitor.js +12 -10
  473. package/dist/tools/worktree.d.ts +5 -1
  474. package/dist/tools/worktree.js +20 -17
  475. package/package.json +6 -3
  476. package/test/export-surface.snapshot.json +92 -10
  477. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  478. package/wire-changes/core@7.61.0.json +4405 -0
  479. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  480. package/wire-changes/primitives@7.61.0.json +30 -0
  481. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  482. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1,6 +1,7 @@
1
+ import { REFUSES_NO_WHOLE_TOOL, TOOL_TABLE_VIEW_READ, toolPolicyWholeToolRefusals } from "../tool-policy.js";
1
2
  import { persistedRuleMandateOf, ruleClearanceOf } from "../ask-origin.js";
2
3
  import {} from "../hooks.js";
3
- import { adjudicatePersistedDomainRules, adjudicatePersistedNameRules, adjudicatePersistedPathRules, adjudicatePersistedRules, adjudicatePersistedToolRules, callPathFaceOf, cardRuleFormOf, eligiblePersisted, escapeForDisclosure, faceRowsSpeakFor, parseRuleText, laneToolNamesOf, nameRuleSubjectOf, ruleToolGrammarOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, wholeToolRuleReaches } from "../permission-rule-model.js";
4
+ import { adjudicatePersistedDomainRules, adjudicatePersistedNameRules, adjudicatePersistedPathRules, adjudicatePersistedRules, adjudicatePersistedToolRules, callPathFaceOf, cardRuleFormOf, eligiblePersisted, escapeForDisclosure, faceRowsSpeakFor, parseRuleText, ruleWordsOf, nameRuleSubjectOf, ruleToolGrammarOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, wholeToolRuleReaches } from "../permission-rule-model.js";
4
5
  import { callHostTargetOf } from "../host-target.js";
5
6
  import { callTargetViewsOf, validatePath } from "../effective-path-target.js";
6
7
  import { bindPathRules, persistedRowAnchors, projectScopeIdentity } from "../path-rule-binding.js";
@@ -54,9 +55,10 @@ export function pathRuleLaneAnswer(table, req, ctx) {
54
55
  return persistedRuleAnswerOf(adjudicatePersistedPathRules(table, { tool: req.toolName, cwd: ctx.root, sessionId: ctx.sessionId, face: callPathFaceOf(req), ...(ctx.scopeIdentity !== undefined ? { scopeIdentity: ctx.scopeIdentity } : {}) }, { ...(tighten !== undefined ? { tighten } : {}), ...(allow !== undefined ? { allow } : {}) }, ctx.anchorsOf, ctx.leads));
55
56
  }
56
57
  export function orgRuleLane(cfg) {
58
+ const questionToolExempt = (call) => wireOf("offer.orgQuestionExemption", call) === cfg.questionToolName && cfg.questionToolMounted;
57
59
  return {
58
60
  adjudicate: async (req) => {
59
- if (wireOf("offer.orgQuestionExemption", req) === cfg.questionToolName && cfg.questionToolMounted)
61
+ if (questionToolExempt(req))
60
62
  return { status: "available" };
61
63
  let resolution;
62
64
  try {
@@ -73,13 +75,19 @@ export function orgRuleLane(cfg) {
73
75
  return { status: "unavailable", disclosures: [`the store's org resolution cannot be read (${reading.refused}) — unreadable governance, never an empty one`] };
74
76
  const command = req.args?.command;
75
77
  const face = callPathFaceOf(req);
76
- const verdict = reading.verdictFor({ tool: laneToolNamesOf(req), ...(typeof command === "string" ? { command } : {}), ...(face !== undefined ? { face } : {}) });
78
+ const verdict = reading.verdictFor({ tool: ruleWordsOf(req, "deny"), ...(typeof command === "string" ? { command } : {}), ...(face !== undefined ? { face } : {}) });
77
79
  const revisionCell = orgRevisionEvidenceOf(resolution, cfg.onRevisionDefect);
78
80
  const degraded = describeUnreadableOrgRows(reading.unreadable, revisionCell.revision);
79
81
  if (degraded !== undefined)
80
82
  cfg.onDegraded(degraded);
81
83
  return verdict === undefined ? { status: "available", ...revisionCell } : { status: "available", verdict, ...revisionCell };
82
84
  },
85
+ refusesWholeOver: (resolution) => {
86
+ const reading = resolution.status === "unavailable" || resolution.status === "ungoverned" ? undefined : readOrgRules(resolution.rules);
87
+ if (reading === undefined || "refused" in reading)
88
+ return REFUSES_NO_WHOLE_TOOL;
89
+ return (tool) => !questionToolExempt(tool) && reading.verdictFor({ tool: ruleWordsOf(tool, "deny"), face: callPathFaceOf({ ...tool, args: undefined }) })?.behavior === "deny";
90
+ },
83
91
  };
84
92
  }
85
93
  export function orgVerdictBeforeClaim(cfg, req) {
@@ -106,7 +114,7 @@ export function createPermissionRuleLanes(cfg) {
106
114
  }
107
115
  }
108
116
  if (provider === undefined)
109
- return { personal: undefined, org: undefined };
117
+ return { personal: undefined, org: undefined, wholeToolRefusals: undefined };
110
118
  const anonymous = readPrincipal(cfg.principal).kind === "absent";
111
119
  const reader = cfg.rows;
112
120
  const orgViewOf = async (toolCallId, judged) => {
@@ -119,9 +127,9 @@ export function createPermissionRuleLanes(cfg) {
119
127
  const personalAdjudicate = async (req) => {
120
128
  if (anonymous && !cfg.localOwnerDeclared)
121
129
  return undefined;
122
- const judged = laneToolNamesOf(req).map((n) => [n, ruleToolGrammarOf(n)]);
123
- if (!judged.some(([, g]) => g === "path") && faceRowsSpeakFor(callPathFaceOf(req)))
124
- judged.push([req.toolName, "path"]);
130
+ const judged = ruleWordsOf(req, "deny").map((n) => [n, ruleToolGrammarOf(n), ruleWordsOf(req, "allow").includes(n)]);
131
+ if (!judged.some(([, g, grants]) => g === "path" && grants) && faceRowsSpeakFor(callPathFaceOf(req)))
132
+ judged.push([req.toolName, "path", true]);
125
133
  const view = await reader.pin(req.toolCallId, req.args);
126
134
  const ownRow = (r) => judged.some(([n]) => n === r.tool) || wholeToolRuleReaches(r.tool, req, r.behavior);
127
135
  if (judged.length === 0 && !view.rules.some(ownRow))
@@ -139,7 +147,7 @@ export function createPermissionRuleLanes(cfg) {
139
147
  const leads = judgesPath ? await cfg.leads.resolve(bindPathRules(table.filter((r) => r.match === "path" || r.match === "subpath").map((r) => ({ parsed: r, ruleText: r.rule, rule: r })), (spec) => anchorsOf(spec.rule))) : NO_LEADS;
140
148
  const scopeIdentity = await projectScopeIdentity(table, cfg.rootCanonical, cfg.leads);
141
149
  const wholeTool = persistedRuleAnswerOf(adjudicatePersistedToolRules(table, { request: req, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) }));
142
- const judgedAnswer = strongestAnswer([...judged.map(([n, grammar]) => judgeAgainst(table, { ...req, toolName: n }, grammar, leads, scopeIdentity)), wholeTool]);
150
+ const judgedAnswer = strongestAnswer([...judged.map(([n, grammar, grants]) => judgeAgainst(grants ? table : table.filter((r) => r.behavior !== "allow"), { ...req, toolName: n }, grammar, leads, scopeIdentity)), wholeTool]);
143
151
  const unjudged = noRule.find(({ row }) => (row.behavior === "deny" || row.behavior === "ask") && eligiblePersisted(row, { tool: row.tool, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) }, row.behavior));
144
152
  const answer = unjudged !== undefined && !(judgedAnswer !== undefined && "behavior" in judgedAnswer && judgedAnswer.behavior === "deny") ? unjudgedRowAnswer(unjudged.row, unjudged.why, req.toolName) : judgedAnswer;
145
153
  const stands = answer !== undefined && (("behavior" in answer && answer.behavior === "deny") || "unreadable" in answer);
@@ -176,8 +184,19 @@ export function createPermissionRuleLanes(cfg) {
176
184
  const coverage = segmentCoverageOf(command, { persisted: table }, { tool: req.toolName, cwd: cfg.root, sessionId: cfg.sessionId, ...execCwd, ...scope });
177
185
  return coverage !== undefined ? { segmentCoverage: coverage } : undefined;
178
186
  };
187
+ const personalRefusesWholeOver = async (rules) => {
188
+ const deny = anonymous && !cfg.localOwnerDeclared ? [] : rules.filter((r) => r.behavior === "deny" && r.match === "tool");
189
+ const scopeIdentity = deny.length === 0 ? undefined : await projectScopeIdentity(deny, cfg.rootCanonical, cfg.leads);
190
+ return deny.length === 0 ? REFUSES_NO_WHOLE_TOOL : (tool) => !routesContent(tool.face) && adjudicatePersistedToolRules(deny, { request: tool, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) })?.behavior === "deny";
191
+ };
179
192
  const personal = provider.partitions.durable ? { adjudicate: personalAdjudicate } : undefined;
180
- return { personal, org };
193
+ let inFlight;
194
+ const viewRead = () => (inFlight ??= reader.pin(TOOL_TABLE_VIEW_READ).finally(() => (inFlight = undefined)));
195
+ const wholeToolRefusals = toolPolicyWholeToolRefusals([
196
+ personal !== undefined ? { wholeToolRefusals: async () => personalRefusesWholeOver((await viewRead()).rules) } : undefined,
197
+ org !== undefined ? { wholeToolRefusals: async () => ((read) => (read.org !== undefined ? org.refusesWholeOver(read.org) : REFUSES_NO_WHOLE_TOOL))(await viewRead()) } : undefined,
198
+ ]);
199
+ return { personal, org, wholeToolRefusals };
181
200
  }
182
201
  export function createRuleOffersOf(cfg) {
183
202
  return (call, args, ask) => {
@@ -271,7 +271,7 @@ export function createPersonPathRows(cfg) {
271
271
  unexcludableUnder: (scope) => judging().readDeny.unexcludableUnder?.(scope) ?? false,
272
272
  rowUnderRoot: (scope) => judging().readDeny.rowUnderRoot?.(scope) ?? null,
273
273
  rowAtOrBelow: (path) => judging().readDeny.rowAtOrBelow?.(path) ?? null,
274
- forCall: (id) => tablesFor(id).readDeny,
274
+ forCall: (id) => (id === undefined ? judging() : tablesFor(id)).readDeny,
275
275
  });
276
276
  const writeDeny = {
277
277
  face: "write",
@@ -0,0 +1,26 @@
1
+ /**
2
+ * The placement fence's two engine readings (the seat and its contract: `ExecutionEnvFactoryContext.placementTarget`,
3
+ * remote-env.ts): the MINT folds a leg's fence once, and the SETTLE POINT reads the leg's own target once — which is
4
+ * also every fenced leg's receipt (a restore takes the same receipt earlier as well, against the env before and the
5
+ * handle after `resumeVM`, in prepare-workspace-restore.ts).
6
+ */
7
+ import { type PlacementTarget, type WorkspaceHandle } from "../remote-env.js";
8
+ import type { ExecutionEnv } from "../../internal/harness.js";
9
+ /**
10
+ * The fence a leg is minted under, from its two sources: the target its checkpoint row recorded (a durable resume leg)
11
+ * and the one its trusted internals carry (the leg that handed it work). Member by member — a member the row states
12
+ * wins, a member it does not state is the internals' (a row recorded before `deviceId` existed takes the waking leg's
13
+ * device) — so neither source replaces the other whole. `undefined` when neither names a provider. A handed value the
14
+ * engine cannot read as a target (no non-empty string `provider`, a `deviceId` that is not a string) is refused loudly
15
+ * rather than read as "no fence", which would place the leg wherever the current binding points.
16
+ */
17
+ export declare function mintPlacementFence(row: WorkspaceHandle | undefined, handedValue: unknown): PlacementTarget | undefined;
18
+ /**
19
+ * The leg's OWN target, read once at its settle point (what its env reports, {@link reportedPlacementTarget}) — the fence
20
+ * of every leg it hands work to — and every fenced leg's receipt on that same reading: an env that does not name the
21
+ * device its fence names is refused before anything reports the workspace or runs on it. A leg that restored a
22
+ * checkpointed workspace (its restore took the receipt already, against the restored handle) is refused
23
+ * `resume.env_failed` here too — its env may have moved after the restore (re-initialization reconnecting elsewhere) —
24
+ * any other leg `config.placement_not_honored`.
25
+ */
26
+ export declare function settleOwnTarget(env: ExecutionEnv | undefined, fence: PlacementTarget | undefined, restoredCheckpoint: boolean): PlacementTarget | undefined;
@@ -0,0 +1,38 @@
1
+ import { placementHonored, placementTargetOf, reportedPlacementTarget } from "../remote-env.js";
2
+ export function mintPlacementFence(row, handedValue) {
3
+ const fromRow = row !== undefined ? placementTargetOf(row) : undefined;
4
+ const handed = handedFence(handedValue);
5
+ const provider = fromRow?.provider ?? handed?.provider;
6
+ if (provider === undefined)
7
+ return undefined;
8
+ const deviceId = fromRow?.deviceId ?? handed?.deviceId;
9
+ return Object.freeze(deviceId !== undefined ? { provider, deviceId } : { provider });
10
+ }
11
+ function handedFence(value) {
12
+ if (value === undefined)
13
+ return undefined;
14
+ const provider = typeof value === "object" && value !== null ? value.provider : undefined;
15
+ const deviceId = typeof value === "object" && value !== null ? value.deviceId : undefined;
16
+ if (typeof provider !== "string" || provider === "" || (deviceId !== undefined && typeof deviceId !== "string")) {
17
+ throw placementNotHonored("RunInternals.placementTarget cannot be read as a target (it needs a non-empty string `provider`, and a string `deviceId` when it names one) — a fence the engine cannot read cannot be honored; fix the lane that handed it instead of dropping it.");
18
+ }
19
+ return Object.freeze(deviceId !== undefined ? { provider, deviceId } : { provider });
20
+ }
21
+ export function settleOwnTarget(env, fence, restoredCheckpoint) {
22
+ const own = reportedPlacementTarget(env);
23
+ if (!placementHonored(fence, own)) {
24
+ const reported = own?.deviceId !== undefined ? `reports device "${own.deviceId}"` : "reports no device";
25
+ throw restoredCheckpoint
26
+ ? refusal("resume.env_failed", `resume workspace identity mismatch: the placement fence names deviceId "${fence?.deviceId}" but the restored execution environment ${reported} once its workspace settled — refusing to continue on a different physical device`)
27
+ : refusal("config.placement_not_honored", `this agent's placement fence names device "${fence?.deviceId}" but its execution environment ${reported} — refusing to run it on another target than the one it was handed (the factory must mint on the fenced device or throw)`);
28
+ }
29
+ return own;
30
+ }
31
+ function placementNotHonored(message) {
32
+ return refusal("config.placement_not_honored", message);
33
+ }
34
+ function refusal(code, message) {
35
+ const e = new Error(message);
36
+ e.code = code;
37
+ return e;
38
+ }
@@ -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
  };
@@ -71,6 +71,8 @@ export interface PrepareCapsAndWorkflowInput {
71
71
  taskScope: string;
72
72
  /** borrowed-readonly — the SETTLED task root the Workflow mount hands its children as `parentCwd`. */
73
73
  taskRootFinal: string;
74
+ /** borrowed-readonly — this leg's own target (absent: none), the fence the Workflow mount hands every agent it spawns. */
75
+ ownTarget: import("../remote-env.js").PlacementTarget | undefined;
74
76
  /** borrowed-readonly — the run's resolved model: the classifier leg's fallback and the route pre-flight's primary. */
75
77
  model: Model;
76
78
  /** borrowed-readonly — the run's resolved thinking level, when one is (the Workflow mount's parentThinking fallback). */
@@ -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,
@@ -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.`);
@@ -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 — ` +