@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
@@ -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">;
@@ -84,8 +87,8 @@ export interface PrepareBoundaryParksInput {
84
87
  resourceSuspendEligible: boolean;
85
88
  /** borrowed-readonly — the wiring-manifest phase's durable-infra predicate: exposes `suspendForPlatformLimit`. */
86
89
  durableSuspendInfraReady: boolean;
87
- /** borrowed-readonly — the restore-incomplete adapter's missing members, or undefined (the review lane refuses loudly). */
88
- incompleteSuspendAdapter: readonly ("resumeVM" | "postResumeInit")[] | undefined;
90
+ /** borrowed-readonly — why the per-task remote env is in neither suspend target, or undefined (the review lane refuses loudly). */
91
+ suspendTargetGap: string | undefined;
89
92
  }
90
93
  export interface PrepareBoundaryParksResult {
91
94
  /** owned — the task-axis resource lane (`Prepared.suspendForResource`), or undefined (no opt-in / no infra / inactive). */
@@ -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, incompleteSuspendAdapter } = 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;
@@ -83,9 +83,9 @@ export function prepareBoundaryParks(input) {
83
83
  return false;
84
84
  if (abortController.signal.aborted)
85
85
  return false;
86
- if (incompleteSuspendAdapter !== undefined) {
86
+ if (suspendTargetGap !== undefined) {
87
87
  try {
88
- deps.onError?.(new Error(`plan_review park skipped: the per-task execution env declares capabilities.suspendable but its adapter does not implement ${incompleteSuspendAdapter.join(" or ")}, so its workspace could not be restored on resume (the plan-review request was dropped; the run continues without pausing)`), { phase: "config", sessionId });
88
+ deps.onError?.(new Error(`plan_review park skipped: the per-task execution env ${suspendTargetGap}, so its workspace could not be restored on resume (the plan-review request was dropped; the run continues without pausing)`), { phase: "config", sessionId });
89
89
  }
90
90
  catch {
91
91
  }
@@ -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). */
@@ -105,6 +107,8 @@ export interface PrepareCapsAndWorkflowInput {
105
107
  offload?: boolean;
106
108
  offloadThresholdChars?: number;
107
109
  }) => AgentTool;
110
+ /** borrowed-readonly — where a workflow run's full record is stored when its completion carries less (the driver's one mint). */
111
+ taskArtifacts: import("../tool-result-store.js").TaskArtifactSeat | undefined;
108
112
  /** borrowed-readonly — the plan-review primitive the ExitPlanMode tool calls. */
109
113
  requestReview: (opts?: import("../present-plan-tool.js").ReviewRequest) => void;
110
114
  /** borrowed-readonly — the declared session plan file as ExitPlanMode's FILE arm reads it (absent ⇒ the parameter arm). */ planFileSource?: PlanFileSource;
@@ -144,6 +148,8 @@ export interface PrepareCapsAndWorkflowInput {
144
148
  artifact: PromptArtifact;
145
149
  sourceRevision?: string;
146
150
  } | undefined;
151
+ /** borrowed-readonly — LATE-BOUND: the leg's agent stations; the Workflow mount's getter reads them at ITS call time. */
152
+ agentStations: () => import("../mods/agent-stations.js").AgentStations | undefined;
147
153
  }
148
154
  export interface PrepareCapsAndWorkflowResult {
149
155
  /** owned — THE run's roster BUILDER (the mount array is private to it; `Prepared.tools` is its read face,
@@ -117,7 +117,7 @@ function autoModeArmReasonOf(intent, facePresent, caps, capsFaulted) {
117
117
  return { armed: true, reason: "armed" };
118
118
  }
119
119
  export async function prepareCapsAndWorkflow(input) {
120
- const { spec, deps, parentSpecSeat, checkpointSeat, internals, session, sessionId, runId, hostTaskId, taskScope, taskRootFinal, model, thinking, lockedPreflight, toolEffects, toolFaceSnapshot, promptLean, resolvedInteractionPosture, harnessRef, askSeat, runClampSource, forwardEvent, inheritedGateForChildren, enrichSpecToolCtx, maybeOffload, requestReview, enterPlanMode, permissionMode, readDenyEntries, peerLaneActive, peerSendMessageBuiltIn, runnerSelf, delegated, sideCallBookRef } = input;
120
+ const { spec, deps, parentSpecSeat, checkpointSeat, internals, session, sessionId, runId, hostTaskId, taskScope, taskRootFinal, model, thinking, lockedPreflight, toolEffects, toolFaceSnapshot, promptLean, resolvedInteractionPosture, harnessRef, askSeat, runClampSource, forwardEvent, inheritedGateForChildren, enrichSpecToolCtx, maybeOffload, taskArtifacts, requestReview, enterPlanMode, permissionMode, readDenyEntries, peerLaneActive, peerSendMessageBuiltIn, runnerSelf, delegated, sideCallBookRef } = input;
121
121
  const roster = new RosterBuilder(toolEffects);
122
122
  for (const t of spec.tools ?? []) {
123
123
  const mounted = mountCallerTool(t);
@@ -238,7 +238,7 @@ export async function prepareCapsAndWorkflow(input) {
238
238
  const classifierRungs = classifierLadderRungs(am.classifierFallback, classifierModel, model);
239
239
  const denialTracking = createAutoModeDenialTracker(am.denialLimit);
240
240
  const decider = createAutoModeDecider({
241
- ...(am.timeoutMs !== undefined ? { timeoutMs: am.timeoutMs } : {}),
241
+ ...(am.timeoutMs !== undefined ? { timeoutMs: am.timeoutMs } : {}), ...(am.rateLimitBreakAfter !== undefined ? { rateLimitBreakAfter: am.rateLimitBreakAfter } : {}),
242
242
  candidates: classifierRungs.map((m) => m.id),
243
243
  onClassified: classifierRoundObserver({ tracer: deps.tracer, onNotice: deps.onNotice, taskId: hostTaskId, seatModelId: classifierModel.id, ...(sessionId !== undefined ? { sessionId } : {}), ...(runId !== undefined ? { runId } : {}) }),
244
244
  assemble: async (input) => {
@@ -333,7 +333,7 @@ export async function prepareCapsAndWorkflow(input) {
333
333
  originatingSessionId: sessionId,
334
334
  rootSessionId: internals?.rootSessionId ?? sessionId, ...(internals?.placementRoot !== undefined ? { placementRoot: internals.placementRoot } : {}), crossBoundaryTree: input.crossBoundaryTree,
335
335
  taskRegistry: defaultTaskRegistry,
336
- taskNotification: internals?.onTaskNotification,
336
+ taskNotification: internals?.onTaskNotification, ...(taskArtifacts !== undefined ? { taskArtifacts } : {}),
337
337
  taskOwner: hostTaskId,
338
338
  limits: deps.workflowLimits,
339
339
  sourceTaskId: hostTaskId,
@@ -364,8 +364,10 @@ export async function prepareCapsAndWorkflow(input) {
364
364
  return assembleParentCaptureState(co?.optedOut() ?? false, co?.indeterminate() ?? false, ctl, [...(internals?.memoryCaptureAncestors ?? []), { sessionId, ...(ctl !== undefined ? { controlDir: ctl } : {}) }]);
365
365
  },
366
366
  autoModeReview: () => (autoModeDeciderRef.current !== undefined ? { decider: autoModeDeciderRef.current } : undefined),
367
+ agentStations: input.agentStations,
367
368
  workflowDepth: internals?.workflowDepth,
368
369
  parentCwd: taskRootFinal,
370
+ ...(input.ownTarget !== undefined ? { placementTarget: input.ownTarget } : {}),
369
371
  parentThinking: () => childThinkingSeat(undefined, deploymentSubagentThinking(runnerSelf.agentCatalog?.roles), harnessRef.current?.getThinkingLevel() ?? thinking).thinking,
370
372
  parentClamps: runClampSource,
371
373
  onNotice: deps.onNotice,
@@ -26,7 +26,7 @@ import { type CrossBoundaryPosture } from "../cross-boundary-taint.js";
26
26
  import { type HostFloor } from "../host-floor.js";
27
27
  import { type CheckpointState } from "../checkpoint-store.js";
28
28
  import { runOriginOfLeg, type RunOrigin } from "../run-origin.js";
29
- import { type ConfigDoorEntry, type LockedPreflight } from "../locked-config.js";
29
+ import { type ConfigDoorEntry, type LockedPreflight, type ReceivedPeerDeclarations } from "../locked-config.js";
30
30
  import { type ResolvedRole } from "../roles.js";
31
31
  import { type ResolvedSkillListingBudget } from "../skill-listing-budget.js";
32
32
  import type { SessionStore } from "../session.js";
@@ -133,6 +133,8 @@ export interface PrepareConfigDoorsResult {
133
133
  * `spec.agents` was set, in which case it is a shallow copy whose `tools` is the
134
134
  * withAgents-rebuilt roster. Every later phase (the safety scan above all — T21) must read THIS, never the original input. */
135
135
  spec: RosterSpec;
136
+ /** The deps the leg reads from here on: the caller's, with the deployment role map's one receipt in place of the live map. */
137
+ deps: RunnerDeps;
136
138
  /** owned — the frozen task-start copies of the caller's tool-face control arrays; the driver compiles the leg's selector
137
139
  * from them, and the selector (with the disclosure lists) is the ONLY thing later face reads consult. Frozen-immutable. */
138
140
  toolFaceLists: ToolFaceLists;
@@ -243,6 +245,8 @@ type ConfigValueDoorsResult = Pick<PrepareConfigDoorsResult, "toolFaceLists" | "
243
245
  };
244
246
  skills: TaskSpec["skills"];
245
247
  projectMemory: TaskSpec["projectMemory"];
248
+ deploymentRoles: RunnerDeps["roles"];
249
+ taskRoles: TaskSpec["roles"];
246
250
  };
247
251
  /**
248
252
  * The phase's VALUE doors as ONE function with two callers — each judges a declared value against its own vocabulary, reading only the
@@ -259,6 +263,7 @@ export declare function configValueDoors(input: {
259
263
  sessions: SessionStore;
260
264
  holder?: string | undefined;
261
265
  resumedRow?: Parameters<typeof runOriginOfLeg>[1];
266
+ receivedPeers?: ReceivedPeerDeclarations;
262
267
  }, enter?: ConfigDoorEntry): ConfigValueDoorsResult;
263
268
  /**
264
269
  * The doors a RESUMED leg's prepare refuses at, run as one screen BEFORE the claim — prepare's own functions, so a refusal carries
@@ -29,25 +29,25 @@ import { effectiveTraitsOf, readModelPromptTraits, resolveHost, resolvePromptLea
29
29
  import { assertNoRetiredKeys, RETIRED_MODEL_KEYS } from "../retired-keys.js";
30
30
  import { resolvePromptBinding } from "../../prompt-assembly/overlay.js";
31
31
  import { assertPeerPresenceValue } from "../../agents/peer-directory.js";
32
- import { snapshotDefinitionLists } from "../../agents/tool-filter.js";
32
+ import { snapshotDefinitionLists } from "../../agents/agent-definition.js";
33
33
  import { mcpUnavailableOn, TOTAL_TOKENS_REMINDER_MODES } from "./turn-attachments.js";
34
34
  import { refuseRetiredMember, rosterFaceOf } from "./caller-roster.js";
35
35
  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.`);
@@ -183,7 +182,8 @@ export function assertResumeConfigRecord(config) {
183
182
  }
184
183
  }
185
184
  export function configValueDoors(input, enter = ENTER_AS_IS) {
186
- const { spec, deps, resumeLeg, sessions, holder } = input;
185
+ const { spec, resumeLeg, sessions, holder } = input;
186
+ let deps = input.deps;
187
187
  enter("deps", () => assertNoRetiredRunnerDeps(deps));
188
188
  enter("taskConfig", () => assertPrincipalValue(spec.principal));
189
189
  const runOrigin = enter("taskConfig", () => runOriginOfLeg(spec.runOrigin, input.resumedRow));
@@ -225,8 +225,10 @@ export function configValueDoors(input, enter = ENTER_AS_IS) {
225
225
  : undefined,
226
226
  };
227
227
  const promptHost = enter("taskConfig", () => resolveHost(spec));
228
- enter("deps", () => screenRoleMap(deps.roles, "RunnerDeps.roles"));
229
- enter("taskConfig", () => screenRoleMap(spec.roles, "TaskSpec.roles"));
228
+ const deploymentRoles = enter("deps", () => screenRoleMap(deps.roles, "RunnerDeps.roles"));
229
+ if (deploymentRoles !== undefined)
230
+ deps = { ...deps, roles: deploymentRoles };
231
+ const taskRoles = enter("taskConfig", () => screenRoleMap(spec.roles, "TaskSpec.roles"));
230
232
  const promptBinding = enter("taskConfig", () => resolvePromptBinding(spec));
231
233
  const promptLean = enter("taskConfig", () => resolvePromptLean(spec));
232
234
  if (spec.resumeAt !== undefined)
@@ -297,7 +299,7 @@ export function configValueDoors(input, enter = ENTER_AS_IS) {
297
299
  e.code = "config.empty_objective";
298
300
  throw e;
299
301
  }
300
- const lockedPreflight = preflightLockedConfig(spec, deps, enter);
302
+ const lockedPreflight = preflightLockedConfig(spec, deps, enter, input.receivedPeers);
301
303
  const declaredSkills = spec.skills;
302
304
  const skills = declaredSkills === undefined ? undefined : enter("taskConfig", () => readSkillsSeat(declaredSkills));
303
305
  enter("deps", () => screenHandsBandOptions(deps.hands));
@@ -342,7 +344,7 @@ export function configValueDoors(input, enter = ENTER_AS_IS) {
342
344
  }));
343
345
  if (taskStore !== undefined)
344
346
  enter("taskConfig", () => assertRetentionWords({ ...retention, stores: [{ name: "checkpointStore", store: taskStore }] }));
345
- return { toolFaceLists, promptHost, promptBinding, promptLean, lockedPreflight, skillListingSeats, skills, projectMemory, microCompactKnob, memoryDelegationEvidence, memoryProvenance, memoryCapturePolicy, usageWindows, brainCallGuardrailMs, crossBoundaryPosture, advisorTool, hostFloor, runOrigin };
347
+ return { toolFaceLists, promptHost, promptBinding, promptLean, lockedPreflight, skillListingSeats, skills, projectMemory, microCompactKnob, memoryDelegationEvidence, memoryProvenance, memoryCapturePolicy, usageWindows, brainCallGuardrailMs, crossBoundaryPosture, advisorTool, hostFloor, runOrigin, deploymentRoles, taskRoles };
346
348
  }
347
349
  export function refuseResumeDoors(config, recorded, deps, sessions, holder) {
348
350
  asResumeConfigRefusal("taskConfig", () => {
@@ -359,13 +361,14 @@ export function refuseResumeDoors(config, recorded, deps, sessions, holder) {
359
361
  return { ...config, ...(config.mcp !== undefined ? { mcp: lockedPreflight.mcp ?? [] } : {}), ...(config.a2a !== undefined ? { a2a: lockedPreflight.a2a ?? [] } : {}), skills };
360
362
  }
361
363
  export function prepareConfigDoors(input) {
362
- const { deps, sessions, resume, internals } = input;
364
+ const { sessions, resume, internals } = input;
363
365
  assertToolBoundaryLegs(input.spec.tools);
364
366
  assertToolCardDeclarations(input.spec.tools);
365
367
  let spec = input.spec;
366
- const { toolFaceLists, promptHost, promptBinding, promptLean, lockedPreflight, skillListingSeats, skills, projectMemory, microCompactKnob, memoryDelegationEvidence, memoryProvenance, memoryCapturePolicy, usageWindows, brainCallGuardrailMs, crossBoundaryPosture, advisorTool, hostFloor, runOrigin } = configValueDoors({ spec, deps, resumeLeg: resume !== undefined, sessions, holder: internals?.holder, ...(resume !== undefined ? { resumedRow: { recorded: screenRecordedRunOrigin(resume.seed.runOrigin), ...(resume.opening !== undefined ? { opening: resume.opening } : {}) } } : {}) });
368
+ const { toolFaceLists, promptHost, promptBinding, promptLean, lockedPreflight, skillListingSeats, skills, projectMemory, microCompactKnob, memoryDelegationEvidence, memoryProvenance, memoryCapturePolicy, usageWindows, brainCallGuardrailMs, crossBoundaryPosture, advisorTool, hostFloor, runOrigin, deploymentRoles, taskRoles } = configValueDoors({ spec, deps: input.deps, resumeLeg: resume !== undefined, sessions, holder: internals?.holder, ...(internals?.receivedPeers !== undefined ? { receivedPeers: internals.receivedPeers } : {}), ...(resume !== undefined ? { resumedRow: { recorded: screenRecordedRunOrigin(resume.seed.runOrigin), ...(resume.opening !== undefined ? { opening: resume.opening } : {}) } } : {}) });
367
369
  const doorRead = (value) => ({ value, enumerable: value !== undefined, writable: false, configurable: false });
368
- spec = Object.create(Object.getPrototypeOf(spec), { ...Object.getOwnPropertyDescriptors(spec), skills: doorRead(skills), projectMemory: doorRead(projectMemory), runOrigin: doorRead(runOrigin) });
370
+ const deps = deploymentRoles !== undefined ? { ...input.deps, roles: deploymentRoles } : input.deps;
371
+ spec = Object.create(Object.getPrototypeOf(spec), { ...Object.getOwnPropertyDescriptors(spec), skills: doorRead(skills), projectMemory: doorRead(projectMemory), runOrigin: doorRead(runOrigin), ...(taskRoles !== undefined ? { roles: doorRead(taskRoles) } : {}) });
369
372
  const resolvedInteractionPosture = spec.interactionPosture ?? internals?.parentInteractionPosture ?? deps.interactionPosture;
370
373
  const askSeat = resolveAskSeat(spec, deps);
371
374
  {
@@ -492,6 +495,7 @@ export function prepareConfigDoors(input) {
492
495
  const compModel = resolveCompactionModel(spec, deps, "TaskSpec.compactionModel");
493
496
  return {
494
497
  spec,
498
+ deps,
495
499
  toolFaceLists,
496
500
  promptLean,
497
501
  promptTraits,
@@ -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";
@@ -29,9 +29,9 @@ import type { PrepareResume, RunInternals, RunnerSelfSeat, ToolFaceSnapshot } fr
29
29
  import { RosterBuilder } from "../tool-roster.js";
30
30
  export interface PrepareDelegationSurfaceInput {
31
31
  /** borrowed-readonly — the REBOUND spec. Read: `tools` (the shadow checks and the revival spawner's delegation-tool
32
- * lookup), `oneShot` (the read/kill faces' completion promises), `retainBackgroundProcesses` (the Monitor receipt),
33
- * `handsReadOnly` is NOT read here (the hands mount decided the surface). Never mutated. */
34
- spec: Pick<TaskSpec, "tools" | "oneShot" | "retainBackgroundProcesses" | "excludeAllTools">;
32
+ * lookup), `retainBackgroundProcesses` (the Monitor receipt), `handsReadOnly` is NOT read here (the hands mount
33
+ * decided the surface). Never mutated. */
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`
@@ -99,6 +99,8 @@ export interface PrepareDelegationSurfaceInput {
99
99
  /** borrowed-readonly — the run's offload store, or undefined when offload is disabled (then no reader mounts and the
100
100
  * read/kill faces spill nowhere). */
101
101
  offloadStore: ToolResultStore | undefined;
102
+ /** borrowed-readonly — where a cut completion's full result is stored (the driver's one mint over `offloadStore`). */
103
+ taskArtifacts: import("../tool-result-store.js").TaskArtifactSeat | undefined;
102
104
  /** borrowed-readonly — the retain ledger the SendMessage mount continues children through (absent ⇒ honest not-retained). */
103
105
  subagentRetain: SubagentRetainLedger | undefined;
104
106
  /** borrowed-readonly — the caller-tool ctx enrichment: the revival spawner re-enters the delegation tool through it, and
@@ -126,7 +128,7 @@ export interface PrepareDelegationSurfaceInput {
126
128
  worktreeSeat: WorktreeSessionRef;
127
129
  }
128
130
  export interface PrepareDelegationSurfaceResult {
129
- /** 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). */
130
132
  delegationSurfaceActive: boolean;
131
133
  /** borrowed-mutable — the EnterWorktree session's shared serializable state (`Prepared.worktreeSessionRef`), minted iff the
132
134
  * worktree pair mounted. Writers: the worktree tools at run time (Enter/Exit); the suspend serializer reads it. */