@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -6,14 +6,14 @@ 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";
13
13
  import { RosterBuilder } from "../tool-roster.js";
14
14
  import { sendMessageContinuationSeats } from "./send-message-continuation.js";
15
15
  export function prepareDelegationSurface(input) {
16
- const { spec, deps, internals, resume, sessionId, hostTaskId, taskScope, taskRootFinal, taskRootCanonical, executionEnv, runnerSelf, backgroundTaskToolsActive, workflowToolsActive, peerLaneActive, peerSendMessageBuiltIn, peerLaneRefs, sessionBox, roster, axisExplicitNegatives, envHandToolNames, toolFaceSnapshot, firstPartyOffload, offloadStore, subagentRetain, enrichSpecToolCtx, checkpointSeat, handsCwdRef, wsSnapshot, rebaseWsPath, rebaseRestoredPath, workspaceStateSettle, worktreeSeat } = input;
16
+ const { spec, deps, internals, resume, sessionId, hostTaskId, taskScope, taskRootFinal, taskRootCanonical, executionEnv, runnerSelf, backgroundTaskToolsActive, workflowToolsActive, peerLaneActive, peerSendMessageBuiltIn, peerLaneRefs, sessionBox, roster, axisExplicitNegatives, envHandToolNames, toolFaceSnapshot, firstPartyOffload, offloadStore, taskArtifacts, subagentRetain, enrichSpecToolCtx, checkpointSeat, handsCwdRef, wsSnapshot, rebaseWsPath, rebaseRestoredPath, workspaceStateSettle, worktreeSeat } = input;
17
17
  let worktreeSessionRef;
18
18
  const delegationSurfaceActive = backgroundTaskToolsActive || workflowToolsActive;
19
19
  const leaves = valveLeaves(spec, toolFaceSnapshot.selector);
@@ -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, oneShot: spec.oneShot, 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
  }
@@ -36,7 +35,7 @@ export function prepareDelegationSurface(input) {
36
35
  owner: hostTaskId,
37
36
  scope: taskScope,
38
37
  ...(sessionId !== undefined ? { sessionId } : {}),
39
- ...(internals?.onTaskNotification !== undefined ? { notify: internals.onTaskNotification } : {}), ...(spec.oneShot !== undefined ? { oneShot: spec.oneShot } : {}), retrievalToolMounted: delegationSurfaceActive,
38
+ ...(internals?.onTaskNotification !== undefined ? { notify: internals.onTaskNotification } : {}), ...(taskArtifacts !== undefined ? { taskArtifacts } : {}),
40
39
  ...(internals?.onSubagentSpawn !== undefined ? { sink: internals.onSubagentSpawn } : {}),
41
40
  ...(internals?.parentNotify !== undefined
42
41
  ? { uplink: internals.parentNotify, ...(internals.parentPeerRef !== undefined ? { uplinkRecipient: internals.parentPeerRef } : {}) }
@@ -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,9 +122,9 @@ 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
- roster.mount(createReadToolResultTool(offloadStore), { source: "builtin", mountedBy: "optional" });
128
+ roster.mount(createReadToolResultTool(offloadStore, (ref, tree) => defaultTaskRegistry.artifactBoundaryLegs(ref, { owner: hostTaskId, scope: taskScope, sessionId }, tree)), { source: "builtin", mountedBy: "optional" });
130
129
  return { delegationSurfaceActive, worktreeSessionRef };
131
130
  }
@@ -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 — ` +
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * PrepareTask's file-history phase, verbatim from the driver: the DV-14 first-touch
3
- * policy door, the `RunnerDeps.fileHistoryStore` / `fileHistoryCapture` and `TaskSpec.fileHistory` bad-value doors, the retired `rewindFiles` two-sense
4
- * split, the restoreFiles / resumeAt / rewindFilesTo combination gates, the run's history coordinates
3
+ * policy door, the `RunnerDeps.fileHistoryStore` / `fileHistoryCapture` and `TaskSpec.fileHistory` bad-value doors, the restoreFiles / resumeAt / rewindFilesTo combination gates, the run's history coordinates
5
4
  * (canonical root, recording scope, filesystem identity), the fork carry, the child-scope refusal, the
6
5
  * rewind RESTORE itself (anchor translation in "before" mode, the per-file ledger, partial-restore
7
6
  * policy), the `trackFileEdit` hook the hands band calls before every mutation lane, and the turn-start
@@ -32,8 +31,7 @@ export interface PrepareFileHistoryInput {
32
31
  /** borrowed-readonly — the deployment seats this phase reads: the first-touch failure policy, the history
33
32
  * store and its capture switch (all validated HERE, once), the incident sink, and the retired-epoch diagnostic probe. */
34
33
  deps: Pick<RunnerDeps, "onError">;
35
- /** borrowed-readonly — the REBOUND spec's rewind request fields and off-switch word (the retired `rewindFiles`
36
- * spelling is read off the same object as an unknown key) and the caller's cancel signal for the restore. */
34
+ /** borrowed-readonly — the REBOUND spec's rewind request fields and off-switch word and the caller's cancel signal for the restore. */
37
35
  spec: Pick<TaskSpec, "resumeAt" | "restoreFiles" | "acceptPartialRestore" | "signal">;
38
36
  /** borrowed-readonly — the request door's resolution ({@link resolveFileHistoryRequest}), judged before the session was
39
37
  * acquired: every refusal the request and the deployment's seats decide on their own has already thrown. */
@@ -125,14 +123,14 @@ export declare function resolveFileHistoryScope(lineage: RunInternals["fileHisto
125
123
  /**
126
124
  * WHICH filesystem an env is a view of — the second coordinate of tree identity for the file-history
127
125
  * lineage, read from what the env's MINTER states rather than inferred from a path:
128
- * · a remote workspace names itself through its {@link WorkspaceHandle} (provider + sandbox, and the
129
- * device lane's id when stamped) — two runs on one sandbox share a tree, two sandboxes never do;
130
- * · an env that DECLARES its paths host-local (`hostLocalPaths: true`), or is the host adapter itself
131
- * (a {@link NodeExecutionEnv}, which the seam names as the host-local default), is the
132
- * control-plane host's filesystem — every such env is one tree;
133
- * · anything else — an env declaring `hostLocalPaths: false`, or an undeclared custom adapter — is
134
- * attested to nothing, so it is its OWN tree: a per-instance token, which still matches when the
135
- * child literally holds the parent's env object and never matches a fresh per-task mint.
126
+ * · an env that DECLARES its paths host-local (`pathsAreHostLocal` — `NodeExecutionEnv`, a host lane) is the
127
+ * control-plane host's filesystem — every such env is one tree, whatever interface it drives it through;
128
+ * · otherwise a remote workspace names itself through its {@link WorkspaceHandle} (provider + sandbox, and
129
+ * the device lane's id when stamped) — two runs on one sandbox share a tree, two sandboxes never do;
130
+ * · anything else — an env declaring `hostLocalPaths: false` with no handle, or one whose declaration is
131
+ * missing or malformed (read as not host-local) — is attested to nothing, so it is its OWN tree: a
132
+ * per-instance token, which still matches when the child literally holds the parent's env object and
133
+ * never matches a fresh per-task mint.
136
134
  * A remote handle that cannot be read (an env not yet connected) falls to the per-instance arm for
137
135
  * the same reason: unattested is not shared.
138
136
  */
@@ -1,5 +1,4 @@
1
- import { NodeExecutionEnv } from "../../engine/execution-env/node-execution-env.js";
2
- import { isRemoteExecutionEnv } from "../remote-env.js";
1
+ import { isRemoteExecutionEnv, pathsAreHostLocal } from "../remote-env.js";
3
2
  import { FILE_HISTORY_ERROR_CODES, FileHistoryStoreError } from "../file-history-store.js";
4
3
  import { readMember, thrownText } from "../thrown-value.js";
5
4
  import { isGovernanceRetryClass } from "../governance-codes.js";
@@ -8,13 +7,6 @@ export async function prepareFileHistory(input) {
8
7
  const { deps, spec, request, internals, executionEnv, taskRootFinal, handsEnabled, sessionId, session, abortController } = input;
9
8
  const rewindNotes = [];
10
9
  const { onTrackFailure, captureOff, declaredOff, fileHistoryStore, captureStore, rewindTarget, rewindBefore } = request;
11
- if (spec.rewindFiles === true) {
12
- try {
13
- deps.onError?.(new Error(`TaskSpec.rewindFiles (capture sense) is retired and was ignored: per-edited-file first-touch tracking is on whenever RunnerDeps.fileHistoryStore is wired and neither RunnerDeps.fileHistoryCapture nor TaskSpec.fileHistory turns it off, so a per-turn capture request has nothing left to ask for. Drop the field; the restore sense moved to TaskSpec.restoreFiles.`), { phase: "config", sessionId });
14
- }
15
- catch {
16
- }
17
- }
18
10
  if (spec.resumeAt !== undefined && spec.restoreFiles !== true) {
19
11
  rewindNotes.push({
20
12
  code: "conversation_only",
@@ -226,6 +218,8 @@ export function resolveFileHistoryScope(lineage, historyRoot, historyFs, session
226
218
  const envFilesystemTokens = new WeakMap();
227
219
  let envFilesystemSeq = 0;
228
220
  export function fileHistoryFilesystemIdentity(env) {
221
+ if (pathsAreHostLocal(env))
222
+ return "host";
229
223
  if (isRemoteExecutionEnv(env)) {
230
224
  try {
231
225
  const h = env.workspaceHandle();
@@ -234,9 +228,6 @@ export function fileHistoryFilesystemIdentity(env) {
234
228
  catch {
235
229
  }
236
230
  }
237
- else if (env.hostLocalPaths === true || (env.hostLocalPaths === undefined && env instanceof NodeExecutionEnv)) {
238
- return "host";
239
- }
240
231
  let token = envFilesystemTokens.get(env);
241
232
  if (token === undefined) {
242
233
  token = `instance:${++envFilesystemSeq}`;
@@ -30,7 +30,7 @@ import type { Arbitration, ToolMarkSource } from "../ask-origin.js";
30
30
  import { type PermissionModeController } from "../mode-policy.js";
31
31
  import type { AutoModeDecider, AutoModeDenialTracker } from "../auto-mode.js";
32
32
  import { type ComplianceCapability } from "../compliance.js";
33
- import type { InheritedToolCheck, LegModBus } from "../mods/stations.js";
33
+ import type { InheritedInstallation, LegModBus } from "../mods/stations.js";
34
34
  import { type HookEnvCapabilities, type HookInvocationIdentity } from "../hooks.js";
35
35
  import type { ToolPolicy } from "../tool-policy.js";
36
36
  import { type GateOutcome } from "../gate-outcome.js";
@@ -47,20 +47,25 @@ import type { ToolCallLike } from "../tool-registry.js";
47
47
  import type { FrameSettlement } from "../frame-settlement.js";
48
48
  import { type ApprovedCallScreen } from "./call-hook-stations.js";
49
49
  /**
50
- * The parent-thread human-rejection boundary — judged ONCE here, from the pass's own record (CC parity:
51
- * the reference CLI's reject path aborts exactly when there is no feedback and the run is not a
52
- * subagent; a rejection WITH the decider's note, and every delegated child — forks included — keep the
53
- * continue / adapt-or-report posture): the final block IS a person's refusal (`deniedBy: ask_resolution`
54
- * and a `human_refused` settlement — not a later fold layer's deny that merely followed a human
55
- * interaction), the refusal carried NO note (`settlement.note` absent — a fact composed at the refusal,
56
- * never re-derived from message text), and the run is not a delegated child (the raw trusted delegation
57
- * facet — the same fact that selects the refusal text's posture, so the boundary and the words the model
58
- * was told always agree). Policy/hook/classifier denies and window/abort settlements never satisfy it.
59
- *
60
- * Returns the loop directive that settles every never-started same-batch sibling: honest
61
- * known-not-executed wording plus the machine mark (`error`/`code` twin — the wire errorCode lift
62
- * reads `details.code`; `details.error` is the in-band mark result consumers grep) naming the
63
- * rejected call. `undefined` = no boundary (the block stands alone, current behavior).
50
+ * The parent-thread human-rejection boundary — THE judgment behind every halt on a person's "no", read off the one
51
+ * record a decide mints (a live gate pass's, a parked tool approval's, a plan pause's), never off message text. CC
52
+ * parity: the reference's reject handler (one handler for a tool call's card and the plan card) aborts the turn
53
+ * exactly when there is no feedback, no attached content and the run is not a subagent; a rejection WITH the decider's
54
+ * note, and every delegated child — forks included — keep the continue / adapt-or-report posture. True iff the record
55
+ * IS a person's refusal (`deniedBy: ask_resolution` and a `human_refused` settlement — not a later fold layer's deny
56
+ * that merely followed a human interaction), the refusal carried NO note (`settlement.note` absent — a fact composed
57
+ * at the refusal, never re-derived from message text), and the leg is not a delegated child (the raw trusted
58
+ * delegation facet — the same fact that selects the refusal text's posture, so the boundary and the words the model
59
+ * was told always agree). Policy/hook/classifier denies and window/abort settlements never satisfy it. A leg it
60
+ * answers true for ends its turn awaiting the user: the live batch through {@link maybeHumanRejectionHalt}'s
61
+ * directive, a resumed leg by recording the decision and requesting nothing more.
62
+ */
63
+ export declare function isBareHumanRefusal(gate: GateOutcome | undefined, isDelegatedChild: boolean): boolean;
64
+ /**
65
+ * The loop directive a bare refusal of a CALL ({@link isBareHumanRefusal}) hands the batch it halts: it settles every
66
+ * never-started same-batch sibling with honest known-not-executed wording plus the machine mark (`error`/`code` twin —
67
+ * the wire errorCode lift reads `details.code`; `details.error` is the in-band mark result consumers grep) naming the
68
+ * rejected call. `undefined` = no boundary (the block stands alone).
64
69
  */
65
70
  export declare function maybeHumanRejectionHalt(input: {
66
71
  gate: GateOutcome | undefined;
@@ -96,8 +101,9 @@ export interface PrepareGateStationsInput {
96
101
  /** borrowed-readonly — the leg's mods bus: `classic.PreToolUse` presence arms the gate; the screenings and the post-call
97
102
  * events are raised on it. */
98
103
  modBus: LegModBus;
99
- /** borrowed-readonly — the inherited installations the gate raises `tool.check` on after `modBus` (the inherited-gate phase's). */
100
- inheritedToolChecks: readonly InheritedToolCheck[];
104
+ /** borrowed-readonly — the inherited installations the gate judges its calls on after `modBus` (`classic.PreToolUse` at phase 1,
105
+ * `tool.check` at the verdict read; the policy-chain phase's). */
106
+ inheritedInstallations: readonly InheritedInstallation[];
101
107
  /** borrowed-readonly — the egress vocabulary: arming, and the per-call `egress` flag handed to the gate. */
102
108
  egressTools: ReadonlySet<string>;
103
109
  /** borrowed-readonly — the irreversible vocabulary: arming only. */
@@ -29,11 +29,13 @@ function screenGateResult(result) {
29
29
  }
30
30
  return defects.length > 0 ? { defects } : { gate, defects };
31
31
  }
32
+ export function isBareHumanRefusal(gate, isDelegatedChild) {
33
+ const d = gate?.disposition;
34
+ const s = gate?.settlement;
35
+ return d?.kind === "denied" && d.deniedBy === "ask_resolution" && s?.kind === "human_refused" && s.note === undefined && !isDelegatedChild;
36
+ }
32
37
  export function maybeHumanRejectionHalt(input) {
33
- const d = input.gate?.disposition;
34
- const s = input.gate?.settlement;
35
- const bare = d?.kind === "denied" && d.deniedBy === "ask_resolution" && s?.kind === "human_refused" && s.note === undefined;
36
- if (!bare || input.isDelegatedChild)
38
+ if (!isBareHumanRefusal(input.gate, input.isDelegatedChild))
37
39
  return undefined;
38
40
  return {
39
41
  reason: `This tool call was NOT executed: the user rejected the "${input.toolName}" tool call in the same ` +
@@ -48,7 +50,7 @@ export function maybeHumanRejectionHalt(input) {
48
50
  };
49
51
  }
50
52
  export function prepareGateStations(input) {
51
- const { askLane, parkAsk, tools, toolRosterDeltas, deps, toolCallGateArmedRef, effectivePolicy, egressTools, irreversibleTools, spec, complianceDenies, harness, blockedToolCalls, inheritedAskGrants, inheritedUnavailableAsks, foldAskClasses, ancestorSandboxAdmissions, preToolContexts, toolOccurrences, batchHaltRef, blockedTracked, hookIdentity, reminderMark, hostTaskId, sessionId, handsCwdRef, stampCallTarget, hookEnvFace, writeProtectionCheck, shellReadCheck, crossBoundaryCheck, readFace, irreversibilityTier, reversibilityProbes, abortController, shellGatedTools, autoModeDecider, autoModeDenialTracking, askRoute, permissionMode, toolMarkSources, a2aIsolatePeers, ancestorArbitrations, runId, stopForDenialLimit, permissionRuleLane, permissionRuleOrgLane, questionToolMounted, sandboxAdmissionArmed, sandboxBoundaryCapable, emitSandboxAdmitted, delegation, frameSettlement, seatInputsFor, modBus, inheritedToolChecks } = input;
53
+ const { askLane, parkAsk, tools, toolRosterDeltas, deps, toolCallGateArmedRef, effectivePolicy, egressTools, irreversibleTools, spec, complianceDenies, harness, blockedToolCalls, inheritedAskGrants, inheritedUnavailableAsks, foldAskClasses, ancestorSandboxAdmissions, preToolContexts, toolOccurrences, batchHaltRef, blockedTracked, hookIdentity, reminderMark, hostTaskId, sessionId, handsCwdRef, stampCallTarget, hookEnvFace, writeProtectionCheck, shellReadCheck, crossBoundaryCheck, readFace, irreversibilityTier, reversibilityProbes, abortController, shellGatedTools, autoModeDecider, autoModeDenialTracking, askRoute, permissionMode, toolMarkSources, a2aIsolatePeers, ancestorArbitrations, runId, stopForDenialLimit, permissionRuleLane, permissionRuleOrgLane, questionToolMounted, sandboxAdmissionArmed, sandboxBoundaryCapable, emitSandboxAdmitted, delegation, frameSettlement, seatInputsFor, modBus, inheritedInstallations } = input;
52
54
  const releasesAnnounced = new Map();
53
55
  const onModeReleased = (info) => {
54
56
  const table = info.readUnestablished === true ? input.readDenyInForce(info.toolCallId) : undefined;
@@ -78,6 +80,7 @@ export function prepareGateStations(input) {
78
80
  toolCallGateArmedRef.armed =
79
81
  effectivePolicy !== undefined ||
80
82
  modBus.hasHandlers("classic.PreToolUse") ||
83
+ inheritedInstallations.length > 0 ||
81
84
  egressTools.size > 0 ||
82
85
  irreversibleTools.size > 0 ||
83
86
  spec.enablePlanMode === true ||
@@ -117,7 +120,7 @@ export function prepareGateStations(input) {
117
120
  identity: hookIdentity,
118
121
  reminderMark,
119
122
  modBus,
120
- ...(inheritedToolChecks.length > 0 ? { inheritedToolChecks } : {}),
123
+ ...(inheritedInstallations.length > 0 ? { inheritedInstallations } : {}),
121
124
  observedPermissionMode: () => permissionMode.observed,
122
125
  ...(handsCwdRef !== undefined ? { trackedCwd: () => handsCwdRef.current } : {}),
123
126
  ...(stampCallTarget !== undefined ? { stampCallTarget } : {}),
@@ -251,7 +254,7 @@ export function prepareGateStations(input) {
251
254
  });
252
255
  }
253
256
  }
254
- const toolResultStation = createToolResultStation({ modBus, blockedToolCalls, toolRosterDeltas, preToolContexts, abortController, spec, handsCwdRef, hookEnvFace, hookIdentity, permissionMode, reminderMark, frameSettlement });
257
+ const toolResultStation = createToolResultStation({ modBus, blockedToolCalls, toolRosterDeltas, preToolContexts, inheritedScreens: inheritedInstallations.length > 0, abortController, spec, handsCwdRef, hookEnvFace, hookIdentity, permissionMode, reminderMark, frameSettlement });
255
258
  if (toolResultStation !== undefined)
256
259
  harness.on("tool_result", toolResultStation);
257
260
  const approvedCallScreen = createApprovedCallScreen({ modBus, permissionMode, abortController, handsCwdRef, hookEnvFace, hookIdentity, preToolContexts });
@@ -56,6 +56,8 @@ export interface PrepareHandsReadFaceInput {
56
56
  /** borrowed-readonly — the acquired session's id, for error/notice tags and the band's session
57
57
  * registration. */
58
58
  sessionId: string;
59
+ /** borrowed-readonly — this run's id, carried on the byte-floor notice (once per run). */
60
+ runId: string;
59
61
  /** borrowed-readonly — the host task id: trace frames + the band's task-registry owner. */
60
62
  hostTaskId: string;
61
63
  /** borrowed-readonly — the registry scope (`internals?.registryScope ?? spec.principal ??
@@ -98,7 +100,7 @@ export interface PrepareHandsReadFaceInput {
98
100
  * object (R-4: `deps.onError?.()` keeps its receiver; a new deps read must widen this Pick).
99
101
  * `readDenyBuiltinTiers`/`readDenyBuiltinExclude` are SNAPSHOTTED before the first await that
100
102
  * precedes the toolkit compile (the caller retains these arrays by reference). */
101
- deps: Pick<RunnerDeps, "onError" | "onNotice" | "tracer" | "readDenyPatterns" | "readDenyBuiltinTiers" | "readDenyBuiltinExclude" | "agentConfigDir" | "readFace" | "writeFace" | "permissionRuleStore" | "hands">;
103
+ deps: Pick<RunnerDeps, "onError" | "onNotice" | "tracer" | "readDenyPatterns" | "readDenyBuiltinTiers" | "readDenyBuiltinExclude" | "readDenyFloorRequired" | "agentConfigDir" | "readFace" | "writeFace" | "permissionRuleStore" | "hands" | "imageProcessor">;
102
104
  /** borrowed-readonly — the trusted spawn-side seats the band forwards: the finished-command
103
105
  * notification lane, the mid-flight detach hub, and the Runner's per-session
104
106
  * read-state seats and their restore channel (absent on a standalone prepare ⇒ the transcript-replay rung
@@ -208,7 +210,7 @@ export interface PrepareHandsReadFaceResult {
208
210
  /** owned — the wsSnapshot path rebaser (identity when no snapshot / same root); the G4 worktree
209
211
  * seed applies it to the snapshot's worktree paths. */
210
212
  rebaseWsPath: (p: string) => string;
211
- /** owned — real shell + write hands + background-capable env: gates the driver's TaskOutput/
213
+ /** owned — real shell + write hands + background-capable env: gates the driver's
212
214
  * TaskStop/Monitor/SendMessage mounts (P11) and the Monitor arm of the shellGate fold here. */
213
215
  backgroundTaskToolsActive: boolean;
214
216
  /** owned — this run's READ STATIONS as the one gate input (`ToolGateInput.shellReadCheck`): the shell's (ONE judgment of
@@ -220,9 +222,9 @@ export interface PrepareHandsReadFaceResult {
220
222
  /** owned — the same station's pre-spawn ADMISSION, published for the P11 face that spawns a shell command
221
223
  * and mounts LATER than the band (`Monitor`): the SAME function the band's shell faces got. ⇔ a real shell. */
222
224
  shellReadAdmission: ShellReadAdmission | undefined;
223
- /** owned — the byte floor's seat over the run's read-deny table (read-floor.ts), for the same LATER face (`Monitor`): the
224
- * table the band's shell faces carry to the environment on every start. ⇔ a real shell. */
225
- shellReadFloor: ReadFloorSeat | undefined;
225
+ /** owned — the byte floor's seat over the run's read-deny tables (read-floor.ts): every start the run makes reads its floor
226
+ * through it, at the start — a call's own pinned table, else the run's base table. ⇔ the run compiled tables (hands). */
227
+ runReadFloor: ReadFloorSeat | undefined;
226
228
  /** owned — the same station's landings of a judged call (`ShellReadStation.landings`): the park binds them, the resumed leg's execution station compares. ⇔ a real shell. */
227
229
  shellReadLandings: ShellReadLandings | undefined;
228
230
  /** owned — the file read station's admission (`FileReadStation.admitted`) the band's read tools got, for the read tools mounted later (LSP). */
@@ -285,7 +287,7 @@ export interface PrepareHandsReadFaceResult {
285
287
  * mounts (Monitor, the worktree pair — the SAME Set identity, mutated at those mount sites).
286
288
  * Consumed by the O9a external-content-target fold: these are the tools whose RESULTS are the
287
289
  * target's bytes, so membership must be what actually mounted on the env — never a static table
288
- * (the wake/resume reconciliation table lists TaskOutput/TaskStop, which are orchestration, and
290
+ * (the wake/resume reconciliation table lists TaskStop, which is orchestration, and
289
291
  * misses Monitor/worktree, which are hands — both directions wrong for this consumer). Empty on
290
292
  * a hands-less leg (nothing mounts on the env; the driver's env mounts are hands-gated too). */
291
293
  envHandToolNames: Set<string>;
@@ -1,5 +1,5 @@
1
1
  import { emitTrace } from "../trace.js";
2
- import { StubExecutionEnv } from "../stub-env.js";
2
+ import { performsIo } from "../remote-env.js";
3
3
  import { hasBackgroundShell } from "../background-shell.js";
4
4
  import { defaultTaskRegistry } from "../task-registry.js";
5
5
  import { bashReversibilityProbe, activeReadDenyBuiltinTiers, readDenyBuiltinConfigOf, compileReadDeny, createHandsToolkit, deploymentFaceClampNotice, pdfModelCapabilitiesOf, inheritSessionReadFileState, backgroundOutputReadExemption, resolveContainmentFace, seedReadFileStateFromContext, seedReadFileStateFromTranscript, } from "../../tools/fs/index.js";
@@ -9,7 +9,7 @@ import { carryReadFace } from "../../tools/fs/read-deny-home.js";
9
9
  import { EMPTY_READ_ROOTS, afterCallTables, denySeatsOf, onPinnedRead, pathTablesCompile, readRootsOver } from "./person-path-rows.js";
10
10
  import { createShellOverflowSpoolFence } from "../../tools/fs/fs-shared.js";
11
11
  import { createShellReadStation } from "../../tools/fs/shell-read-check.js";
12
- import { readFloorSeat } from "../../tools/fs/read-floor.js";
12
+ import { judgeReadFloorKept, readFloorSeat } from "../../tools/fs/read-floor.js";
13
13
  import { createFileReadStation } from "../../tools/fs/file-read-check.js";
14
14
  import { isShellFaceToolName, predictMountedToolNames, readTargetToolNames } from "../tool-registry.js";
15
15
  import { normalizeFileText } from "../../tools/fs/encoding.js";
@@ -20,7 +20,7 @@ import { sessionSeatAnchorHolds } from "./session-read-file-states.js";
20
20
  import { rebaseWorkspacePath } from "./workspace-path.js";
21
21
  import { RosterBuilder } from "../tool-roster.js";
22
22
  import { unionAddOnly } from "../child-clamp-seats.js";
23
- import { assertStringArraySeat } from "../read-face-seats.js";
23
+ import { assertStringArraySeat, screenReadDenySeat } from "../read-face-seats.js";
24
24
  import { modePolicyOf } from "../mode-policy.js";
25
25
  import { valveLeaves } from "../../agents/tool-filter.js";
26
26
  const faceClampAnnouncedSinks = { read: new WeakSet(), write: new WeakSet() };
@@ -87,7 +87,7 @@ export function resolveHandsLessReadFace(input) {
87
87
  shellReadCheck: undefined,
88
88
  shellReadStationArmed: false,
89
89
  shellReadAdmission: undefined,
90
- shellReadFloor: undefined,
90
+ runReadFloor: undefined,
91
91
  shellReadLandings: undefined,
92
92
  readAdmission: undefined,
93
93
  resolvedReadFace: undefined,
@@ -124,7 +124,7 @@ export async function prepareHandsMount(input) {
124
124
  let rebaseWsPath = (p) => p;
125
125
  let backgroundTaskToolsActive = false;
126
126
  let shellReadStation;
127
- let shellReadFloor;
127
+ let runReadFloor;
128
128
  let shellReadTools = new Set();
129
129
  let fileReadStation;
130
130
  let resolvedReadFace;
@@ -191,7 +191,7 @@ export async function prepareHandsMount(input) {
191
191
  seedReadFileStateFromContext(readFileState, rk.key, f.content);
192
192
  }
193
193
  };
194
- const handsIncludeShell = !(executionEnv instanceof StubExecutionEnv);
194
+ const handsIncludeShell = performsIo(executionEnv) === true;
195
195
  const handsReadOnly = spec.handsReadOnly === true;
196
196
  backgroundTaskToolsActive = handsIncludeShell && !handsReadOnly && hasBackgroundShell(executionEnv);
197
197
  const shellFaceHere = [...predictMountedToolNames(new Set(backgroundTaskToolsActive ? ["hands", "backgroundTasks"] : ["hands"]))].filter(isShellFaceToolName);
@@ -214,8 +214,17 @@ export async function prepareHandsMount(input) {
214
214
  const readDenyBuiltinCfg = readDenyBuiltinConfigOf({ tiers: deps.readDenyBuiltinTiers, exclude: deps.readDenyBuiltinExclude });
215
215
  const canonicalize = async (dirs) => { const out = []; for (const d of dirs)
216
216
  await canonicalizeExtraDirs([d], "persistedReadRule", out).catch((err) => deps.onError?.(new Error(`persistedReadRule entry skipped (its lookup threw): ${d}: ${thrownText(err)}`), { phase: "config", sessionId })); return out; };
217
- const tables = (pathTables = await input.personRows.attachTables(pathTablesCompile({ env: executionEnv, additions: readDenyAdditions, builtin: readDenyBuiltinCfg, legRows: input.denyRuleRows, leads: input.headLeads, configRoot: deps.agentConfigDir, canonicalize })));
217
+ const floorRequired = screenReadDenySeat("readDenyFloorRequired", deps.readDenyFloorRequired) === true;
218
+ const floorSaid = { done: false };
219
+ const compileRunTables = pathTablesCompile({ env: executionEnv, additions: readDenyAdditions, builtin: readDenyBuiltinCfg, legRows: input.denyRuleRows, leads: input.headLeads, configRoot: deps.agentConfigDir, canonicalize });
220
+ const judgedRunTables = async (person) => {
221
+ const compiled = await compileRunTables(person);
222
+ judgeReadFloorKept({ env: executionEnv, table: compiled.readDeny, floor: readFloorSeat(compiled.readDeny)?.(undefined), required: floorRequired, onNotice: deps.onNotice, attribution: { sessionId, runId: input.runId }, said: floorSaid });
223
+ return compiled;
224
+ };
225
+ const tables = (pathTables = await input.personRows.attachTables(judgedRunTables));
218
226
  readDenyMatcher = tables.readDeny;
227
+ runReadFloor = readFloorSeat(tables.readDeny);
219
228
  readRoots = readRootsOver({ own: () => [...additionalRootsCanonical, ...additionalReadRootsCanonical], tables, ready: input.personRows.tablesReady, store: () => artifactStoreRef.current,
220
229
  onHeld: (entry, store) => emitTrace(deps.tracer, () => ({ kind: "config.additional_directory_skipped", version: 1, taskId: hostTaskId, entry, field: "persistedReadRule", reason: `admits_artifact_store: the local artifact store ${store} lies inside it or it inside the store — the Artifact tool's ledger and stored files stay outside every root the file tools reach`, ts: Date.now() })) });
221
230
  readDenyBuiltinTiersActive = activeReadDenyBuiltinTiers(readDenyBuiltinCfg);
@@ -314,7 +323,6 @@ export async function prepareHandsMount(input) {
314
323
  return { roots: [rootCanonical, ...readRoots.forCall(toolCallId)()], cwd: rootCanonical, ...denySeat, ...writeDenySeat, ...(input.personRows.unreadFor(toolCallId) ? { unreadPartitions: true } : {}), alsoInside: spoolFence };
315
324
  };
316
325
  shellReadTools = new Set(shellFaceHere);
317
- shellReadFloor = readFloorSeat(tables.readDeny);
318
326
  shellReadStation = createShellReadStation({
319
327
  env: executionEnv,
320
328
  tools: shellReadTools,
@@ -368,7 +376,7 @@ export async function prepareHandsMount(input) {
368
376
  pdfModelCapabilities: pdfModelCapabilitiesOf(model),
369
377
  ...(deps.hands?.bashReadonlyAllow !== undefined ? { bashReadonlyAllow: deps.hands.bashReadonlyAllow } : {}),
370
378
  ...(deps.hands?.commitCoAuthor !== undefined ? { commitCoAuthor: deps.hands.commitCoAuthor } : {}),
371
- ...(deps.hands?.readImageDownsampler !== undefined ? { readImageDownsampler: deps.hands.readImageDownsampler } : {}),
379
+ ...(deps.imageProcessor !== undefined ? { imageProcessor: deps.imageProcessor } : {}),
372
380
  ...(deps.hands?.autoBackgroundOnTimeout !== undefined ? { autoBackgroundOnTimeout: deps.hands.autoBackgroundOnTimeout } : {}),
373
381
  beforeWrite: async (w) => {
374
382
  const deploymentGate = deps.hands?.beforeWrite;
@@ -392,7 +400,7 @@ export async function prepareHandsMount(input) {
392
400
  }
393
401
  roster.mountAll(band.map((t) => (envHandToolNames.add(t.name), firstPartyOffload(afterCallTables(input.personRows, t)))), { source: "builtin", mountedBy: "hands" });
394
402
  const shellFloor = effectiveShellGate;
395
- if (!(executionEnv instanceof StubExecutionEnv) && spec.handsReadOnly !== true) {
403
+ if (handsIncludeShell && spec.handsReadOnly !== true) {
396
404
  const installShellSeat = (name) => {
397
405
  const tierBefore = irreversibilityTier.get(name);
398
406
  const seatOwned = !egressTools.has(name) && tierBefore !== "always" && tierBefore !== "maybe";
@@ -419,7 +427,7 @@ export async function prepareHandsMount(input) {
419
427
  shellReadCheck: onPinnedRead(input.personRows, [...(shellReadStation !== undefined ? [{ check: shellReadStation.check, tools: shellReadTools }] : []), ...(fileReadStation !== undefined ? [fileReadStation] : [])]),
420
428
  shellReadStationArmed: shellReadStation !== undefined,
421
429
  shellReadAdmission: shellReadStation?.admit,
422
- shellReadFloor,
430
+ runReadFloor,
423
431
  shellReadLandings: shellReadStation?.landings,
424
432
  readAdmission: fileReadStation?.admitted,
425
433
  resolvedReadFace,
@@ -37,7 +37,6 @@ import type { AutoModeArmingRecipe } from "../auto-mode-arming.js";
37
37
  import type { AutoModeDecider, AutoModeDenialTracker } from "../auto-mode.js";
38
38
  import { type OnQuestion } from "../ask-question.js";
39
39
  import { type ParentSpecSeat } from "../parent-spec-seat.js";
40
- import { type HookEnvCapabilities } from "../hooks.js";
41
40
  import { type LegModBus, type ModChainLink } from "../mods/stations.js";
42
41
  import { type ChildClampSource } from "../child-clamp-seats.js";
43
42
  import type { LockedPreflight } from "../locked-config.js";
@@ -45,6 +44,7 @@ import type { OwnOrgAdmissionVerdict } from "../memory-admission.js";
45
44
  import type { DelegationContentSafety } from "../memory-engine/delegation-provenance.js";
46
45
  import type { SessionPermissionRules } from "../session-policy-store.js";
47
46
  import type { SessionStore } from "../session.js";
47
+ import { type PlacementTarget } from "../remote-env.js";
48
48
  import { type OnAsk, type ToolPolicy } from "../tool-policy.js";
49
49
  import type { PathRuleBases } from "../permission-rule-model.js";
50
50
  import type { PermissionMode, RunnerDeps, RuntimeCaps, ShellGateDoctrine, TaskEvent, TaskSpec, ToolExecuteContext, ToolSpec } from "../types.js";
@@ -92,6 +92,9 @@ export interface PrepareInheritedGateInput {
92
92
  hostTaskId: string;
93
93
  /** borrowed-readonly — the SETTLED task root (`ctx.parentCwd`). */
94
94
  taskRootFinal: string;
95
+ /** borrowed-readonly — the target this leg's env reported as its workspace settled (`ctx.placementTarget`: the fence of
96
+ * every agent the delegation tools spawn or wake from this leg); absent when it reported none. */
97
+ ownTarget: PlacementTarget | undefined;
95
98
  /** borrowed-readonly — the run's resolved env: the full-shell predicate's kind test and the hook-env identity value. */
96
99
  executionEnv: ExecutionEnv;
97
100
  /** borrowed-readonly — the per-task owned env when a factory minted one (the hook-env identity predicate reads presence). */
@@ -134,6 +137,8 @@ export interface PrepareInheritedGateInput {
134
137
  forwardEvent: ((e: TaskEvent) => void) | undefined;
135
138
  /** borrowed-readonly — the retain ledger (ctx seat; absent ⇒ no key). */
136
139
  subagentRetain: SubagentRetainLedger | undefined;
140
+ /** borrowed-readonly — where a background task's cut result is stored (ctx seat `taskArtifacts`; absent ⇒ no key). */
141
+ taskArtifacts: import("../tool-result-store.js").TaskArtifactSeat | undefined;
137
142
  /** borrowed-readonly — the worktree-isolation helper (ctx seat; absent ⇒ no key). */
138
143
  worktreeIsolation: SubagentWorktreeIsolation | undefined;
139
144
  /** borrowed-readonly — the three run-ref primitives the ctx exposes (plan mode only under `enablePlanMode`). */
@@ -161,12 +166,10 @@ export interface PrepareInheritedGateInput {
161
166
  * `inheritedGateForChildren` (the two mandate tests), at spawn time. */
162
167
  runtimeCaps: () => RuntimeCaps | undefined;
163
168
  /** borrowed-readonly — what the leg hands its descendants of its mods bus (`LegMods.handedDown`: without the skills' own
164
- * registrations): the chain assembly mints this leg's screening entry over its `classic.PreToolUse` chain. */
169
+ * registrations): the chain assembly hands it down as this leg's screening installation. */
165
170
  modBus: LegModBus;
166
171
  /** borrowed-readonly — this leg's chain identity as its admission recorded it (`chainOfBus`) — the installation identity's chain term. */
167
172
  ownModChain: readonly ModChainLink[];
168
- /** borrowed-readonly — LATE-BOUND: the hook-env capability face the screening-face entry's policy resolves paths in. */
169
- hookEnvFace: () => HookEnvCapabilities | undefined;
170
173
  /** borrowed-readonly — LATE-BOUND: the armed classifier (undefined = not armed), read where the chain freezes it onto both
171
174
  * entries and where the ctx exposes the spawn-review seat. */
172
175
  autoModeDecider: () => AutoModeDecider | undefined;
@@ -176,6 +179,10 @@ export interface PrepareInheritedGateInput {
176
179
  autoModeArming: () => AutoModeArmingRecipe | undefined;
177
180
  /** borrowed-readonly — LATE-BOUND: the fork-governance verdict (ctx `forkAccess`, present only when denied). */
178
181
  agentForkDenial: () => ReturnType<typeof forkGovernanceDenial>;
182
+ /** borrowed-readonly — LATE-BOUND: the leg's agent stations (ctx `agentStations`; bound once the leg's identity is known). */
183
+ agentStations: () => import("../mods/agent-stations.js").AgentStations | undefined;
184
+ /** borrowed-readonly — LATE-BOUND: the leg's `session.send` station (ctx `sendStation`; bound once the leg's identity is known). */
185
+ sendStation: () => import("../mods/session-send.js").SendStation | undefined;
179
186
  /** borrowed-readonly — LATE-BOUND: the observers grant (ctx `observersAllowed`, present only when explicitly granted). */
180
187
  observersActive: () => boolean;
181
188
  /** borrowed-readonly — LATE-BOUND: the hands mount's resolved read face (undefined until/unless hands mount). */