@sema-agent/core 7.58.0 → 7.60.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 (519) hide show
  1. package/CHANGELOG.md +1340 -0
  2. package/README.md +6 -4
  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 +2 -1
  6. package/dist/agents/agent-transcript-tool.js +3 -1
  7. package/dist/agents/cc-peer-directory.js +8 -8
  8. package/dist/agents/child-model-seat.d.ts +4 -2
  9. package/dist/agents/child-model-seat.js +9 -4
  10. package/dist/agents/cumulative-stats.js +0 -1
  11. package/dist/agents/inherited-tool-pool.d.ts +26 -1
  12. package/dist/agents/inherited-tool-pool.js +22 -0
  13. package/dist/agents/peer-directory.d.ts +9 -0
  14. package/dist/agents/peer-directory.js +6 -2
  15. package/dist/agents/retain-ledger.d.ts +11 -1
  16. package/dist/agents/retain-ledger.js +13 -2
  17. package/dist/agents/roster-store.d.ts +1 -1
  18. package/dist/agents/roster-store.js +3 -1
  19. package/dist/agents/send-message-tool.d.ts +8 -19
  20. package/dist/agents/send-message-tool.js +32 -50
  21. package/dist/agents/subagent.d.ts +51 -17
  22. package/dist/agents/subagent.js +150 -112
  23. package/dist/agents/tool-filter.d.ts +1 -3
  24. package/dist/agents/tool-filter.js +4 -12
  25. package/dist/bench/metrics.d.ts +3 -5
  26. package/dist/bench/metrics.js +0 -1
  27. package/dist/brain/anthropic.js +161 -45
  28. package/dist/brain/degrading.js +3 -1
  29. package/dist/brain/errors.d.ts +9 -3
  30. package/dist/brain/errors.js +7 -1
  31. package/dist/brain/failover.js +2 -1
  32. package/dist/brain/open-responses.js +3 -3
  33. package/dist/brain/openai.js +103 -53
  34. package/dist/brain/provider-dialect.d.ts +11 -0
  35. package/dist/brain/provider-dialect.js +5 -2
  36. package/dist/brain/reasoning-request.js +5 -4
  37. package/dist/brain/reasoning.d.ts +19 -0
  38. package/dist/brain/reasoning.js +17 -2
  39. package/dist/brain/request-route.d.ts +4 -1
  40. package/dist/brain/request-route.js +4 -1
  41. package/dist/brain/route-adjudicator.d.ts +84 -18
  42. package/dist/brain/route-adjudicator.js +90 -22
  43. package/dist/brain/route-conformance.js +1 -1
  44. package/dist/brain/status-sink.d.ts +7 -1
  45. package/dist/brain/status-sink.js +6 -0
  46. package/dist/brain/stream-engine.js +84 -49
  47. package/dist/brain/stream-shared.d.ts +30 -0
  48. package/dist/brain/stream-shared.js +34 -1
  49. package/dist/brain/timeout.d.ts +65 -6
  50. package/dist/brain/timeout.js +111 -11
  51. package/dist/core/a2a.d.ts +15 -5
  52. package/dist/core/a2a.js +34 -19
  53. package/dist/core/account-row.d.ts +61 -0
  54. package/dist/core/account-row.js +51 -0
  55. package/dist/core/advisor-verdict.d.ts +2 -1
  56. package/dist/core/advisor-verdict.js +1 -1
  57. package/dist/core/agent-definition.d.ts +20 -0
  58. package/dist/core/allow-entry.d.ts +20 -6
  59. package/dist/core/allow-entry.js +17 -7
  60. package/dist/core/approval-object.d.ts +29 -15
  61. package/dist/core/approval-object.js +47 -19
  62. package/dist/core/artifact-host.d.ts +0 -2
  63. package/dist/core/artifact-host.js +0 -1
  64. package/dist/core/auto-compaction.js +1 -1
  65. package/dist/core/auto-mode-defaults.d.ts +8 -0
  66. package/dist/core/auto-mode-defaults.js +1 -0
  67. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  68. package/dist/core/auto-mode.d.ts +39 -4
  69. package/dist/core/auto-mode.js +63 -12
  70. package/dist/core/background-agent-store.d.ts +26 -4
  71. package/dist/core/background-agent-store.js +3 -2
  72. package/dist/core/background-shell.d.ts +12 -1
  73. package/dist/core/background-shell.js +12 -0
  74. package/dist/core/checkpoint-requirements.d.ts +13 -1
  75. package/dist/core/checkpoint-requirements.js +3 -1
  76. package/dist/core/checkpoint-store.d.ts +66 -25
  77. package/dist/core/checkpoint-store.js +22 -9
  78. package/dist/core/child-clamp-seats.d.ts +29 -0
  79. package/dist/core/child-clamp-seats.js +56 -1
  80. package/dist/core/compliance.d.ts +3 -3
  81. package/dist/core/compliance.js +1 -1
  82. package/dist/core/credential-echo.d.ts +52 -0
  83. package/dist/core/credential-echo.js +65 -0
  84. package/dist/core/credential-vocabulary.d.ts +13 -3
  85. package/dist/core/credential-vocabulary.js +12 -4
  86. package/dist/core/cross-boundary-taint.d.ts +4 -5
  87. package/dist/core/effective-path-target.d.ts +8 -2
  88. package/dist/core/effective-path-target.js +8 -3
  89. package/dist/core/engine-notice.d.ts +156 -23
  90. package/dist/core/engine-notice.js +19 -5
  91. package/dist/core/frame-settlement.d.ts +5 -0
  92. package/dist/core/frame-settlement.js +4 -0
  93. package/dist/core/gate-fold.js +8 -6
  94. package/dist/core/gate-lanes.js +47 -12
  95. package/dist/core/gate-outcome.d.ts +32 -3
  96. package/dist/core/gate-outcome.js +19 -1
  97. package/dist/core/governance-codes.d.ts +17 -1
  98. package/dist/core/governance-codes.js +25 -0
  99. package/dist/core/hands-band-screen.js +0 -1
  100. package/dist/core/hands-band.d.ts +0 -3
  101. package/dist/core/hooks.d.ts +70 -59
  102. package/dist/core/hooks.js +125 -80
  103. package/dist/core/image-admission.d.ts +106 -52
  104. package/dist/core/image-admission.js +184 -56
  105. package/dist/core/image-downsample.d.ts +36 -69
  106. package/dist/core/image-downsample.js +111 -73
  107. package/dist/core/integer-option.d.ts +21 -0
  108. package/dist/core/integer-option.js +13 -0
  109. package/dist/core/locked-config.d.ts +59 -5
  110. package/dist/core/locked-config.js +82 -50
  111. package/dist/core/mailbox-store.d.ts +45 -1
  112. package/dist/core/mailbox-store.js +53 -9
  113. package/dist/core/mcp-call-meta.d.ts +2 -2
  114. package/dist/core/mcp-call-meta.js +9 -10
  115. package/dist/core/mcp-failure.d.ts +122 -20
  116. package/dist/core/mcp-failure.js +73 -5
  117. package/dist/core/mcp-host-seat.d.ts +92 -0
  118. package/dist/core/mcp-host-seat.js +131 -0
  119. package/dist/core/mcp-probe.d.ts +7 -2
  120. package/dist/core/mcp-probe.js +7 -2
  121. package/dist/core/mcp-server-link.d.ts +22 -1
  122. package/dist/core/mcp-server-link.js +25 -1
  123. package/dist/core/mcp-server-spec.d.ts +38 -9
  124. package/dist/core/mcp-server-spec.js +55 -21
  125. package/dist/core/mcp.d.ts +27 -12
  126. package/dist/core/mcp.js +105 -76
  127. package/dist/core/memory-admission.d.ts +23 -6
  128. package/dist/core/memory-admission.js +19 -9
  129. package/dist/core/memory-engine/consolidation-driver.d.ts +2 -4
  130. package/dist/core/memory-engine/consolidation-driver.js +3 -3
  131. package/dist/core/memory-engine/consolidation.d.ts +4 -0
  132. package/dist/core/memory-engine/consolidation.js +1 -0
  133. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  134. package/dist/core/memory-engine/content-origin.js +21 -3
  135. package/dist/core/memory-engine/delegation-settlement.js +5 -12
  136. package/dist/core/memory-engine/distiller.js +2 -2
  137. package/dist/core/memory-engine/dual-root.d.ts +50 -1
  138. package/dist/core/memory-engine/dual-root.js +44 -1
  139. package/dist/core/memory-engine/engine.d.ts +67 -14
  140. package/dist/core/memory-engine/engine.js +384 -212
  141. package/dist/core/memory-engine/export-bundle.d.ts +23 -0
  142. package/dist/core/memory-engine/export-bundle.js +23 -4
  143. package/dist/core/memory-engine/file-backend.d.ts +128 -55
  144. package/dist/core/memory-engine/file-backend.js +290 -117
  145. package/dist/core/memory-engine/index.d.ts +3 -2
  146. package/dist/core/memory-engine/index.js +2 -1
  147. package/dist/core/memory-engine/layout.d.ts +59 -11
  148. package/dist/core/memory-engine/layout.js +190 -40
  149. package/dist/core/memory-engine/memory-backend-contract.d.ts +1 -1
  150. package/dist/core/memory-engine/memory-backend-contract.js +39 -2
  151. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  152. package/dist/core/memory-engine/scope-contract.js +2 -2
  153. package/dist/core/memory-engine/sync-client.d.ts +51 -9
  154. package/dist/core/memory-engine/sync-client.js +107 -13
  155. package/dist/core/memory-engine/sync-report.d.ts +103 -0
  156. package/dist/core/memory-engine/sync-report.js +119 -0
  157. package/dist/core/memory-engine/sync.d.ts +8 -1
  158. package/dist/core/memory-engine/types.d.ts +6 -0
  159. package/dist/core/mode-policy.d.ts +9 -1
  160. package/dist/core/mode-policy.js +11 -1
  161. package/dist/core/model-receipt.d.ts +39 -0
  162. package/dist/core/model-receipt.js +139 -0
  163. package/dist/core/mods/agent-stations.d.ts +65 -0
  164. package/dist/core/mods/agent-stations.js +105 -0
  165. package/dist/core/mods/classic-events.d.ts +5 -1
  166. package/dist/core/mods/kernel/dispatch.d.ts +5 -1
  167. package/dist/core/mods/kernel/dispatch.js +6 -5
  168. package/dist/core/mods/kernel/events.d.ts +11 -4
  169. package/dist/core/mods/kernel/events.js +11 -7
  170. package/dist/core/mods/kernel/receive.d.ts +5 -0
  171. package/dist/core/mods/kernel/receive.js +10 -0
  172. package/dist/core/mods/kernel/registration.d.ts +4 -0
  173. package/dist/core/mods/kernel/registration.js +3 -0
  174. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  175. package/dist/core/mods/lifecycle-stations.js +35 -0
  176. package/dist/core/mods/stations.d.ts +73 -60
  177. package/dist/core/mods/stations.js +64 -40
  178. package/dist/core/mods/tool-call.d.ts +10 -4
  179. package/dist/core/mods/tool-call.js +28 -12
  180. package/dist/core/mounted-mcp.d.ts +5 -0
  181. package/dist/core/mounted-mcp.js +2 -2
  182. package/dist/core/namespaced-rule-name.d.ts +7 -1
  183. package/dist/core/namespaced-rule-name.js +13 -2
  184. package/dist/core/oracle-isolation.js +1 -1
  185. package/dist/core/own-property-receipt.d.ts +3 -0
  186. package/dist/core/own-property-receipt.js +3 -0
  187. package/dist/core/parent-spec-seat.d.ts +8 -3
  188. package/dist/core/parent-spec-seat.js +2 -0
  189. package/dist/core/park-selfcheck.js +14 -8
  190. package/dist/core/peer-seat.d.ts +133 -16
  191. package/dist/core/peer-seat.js +319 -42
  192. package/dist/core/permission-rule-consent.d.ts +0 -21
  193. package/dist/core/permission-rule-consent.js +11 -6
  194. package/dist/core/permission-rule-model.d.ts +20 -2
  195. package/dist/core/permission-rule-model.js +8 -7
  196. package/dist/core/present-plan-tool.d.ts +11 -3
  197. package/dist/core/present-plan-tool.js +2 -2
  198. package/dist/core/protocol-http-auth.d.ts +14 -2
  199. package/dist/core/protocol-http-auth.js +16 -7
  200. package/dist/core/read-face-seats.d.ts +7 -5
  201. package/dist/core/read-face-seats.js +4 -1
  202. package/dist/core/redaction-marks.d.ts +4 -3
  203. package/dist/core/redaction-marks.js +2 -2
  204. package/dist/core/remote-env.d.ts +146 -98
  205. package/dist/core/remote-env.js +113 -14
  206. package/dist/core/resume-startup-cause.js +1 -0
  207. package/dist/core/retention.js +37 -12
  208. package/dist/core/retired-keys.d.ts +6 -1
  209. package/dist/core/retired-keys.js +4 -1
  210. package/dist/core/rewrite-rejudge.d.ts +13 -5
  211. package/dist/core/rewrite-rejudge.js +9 -5
  212. package/dist/core/roles.d.ts +69 -3
  213. package/dist/core/roles.js +167 -80
  214. package/dist/core/rule-owner.d.ts +3 -0
  215. package/dist/core/runner/announce-once-ledger.d.ts +5 -4
  216. package/dist/core/runner/announce-once-ledger.js +4 -2
  217. package/dist/core/runner/assemble-result.d.ts +0 -5
  218. package/dist/core/runner/assemble-result.js +0 -1
  219. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  220. package/dist/core/runner/call-hook-stations.js +23 -12
  221. package/dist/core/runner/child-tree.d.ts +7 -8
  222. package/dist/core/runner/child-tree.js +6 -6
  223. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  224. package/dist/core/runner/classifier-ladder.js +39 -8
  225. package/dist/core/runner/construction-doors.js +5 -0
  226. package/dist/core/runner/contracts.d.ts +82 -57
  227. package/dist/core/runner/credential-origin-seat.js +4 -3
  228. package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
  229. package/dist/core/runner/cross-boundary-lane.js +11 -2
  230. package/dist/core/runner/cwd-alignment-probe.d.ts +20 -0
  231. package/dist/core/runner/cwd-alignment-probe.js +21 -0
  232. package/dist/core/runner/decide-continuation.d.ts +2 -2
  233. package/dist/core/runner/env-capability-census.d.ts +15 -20
  234. package/dist/core/runner/env-capability-census.js +25 -34
  235. package/dist/core/runner/file-history-request.d.ts +2 -2
  236. package/dist/core/runner/file-history-request.js +0 -8
  237. package/dist/core/runner/gate-exit.d.ts +87 -11
  238. package/dist/core/runner/gate-exit.js +30 -8
  239. package/dist/core/runner/git-status-frame.d.ts +5 -2
  240. package/dist/core/runner/git-status-frame.js +3 -4
  241. package/dist/core/runner/image-removed-seat.d.ts +12 -0
  242. package/dist/core/runner/image-removed-seat.js +19 -0
  243. package/dist/core/runner/image.d.ts +7 -2
  244. package/dist/core/runner/image.js +14 -8
  245. package/dist/core/runner/inline-image.d.ts +10 -8
  246. package/dist/core/runner/inline-image.js +11 -9
  247. package/dist/core/runner/memory-consolidation-driver.js +5 -5
  248. package/dist/core/runner/park-commit.d.ts +1 -1
  249. package/dist/core/runner/park-commit.js +3 -0
  250. package/dist/core/runner/permission-rule-lanes.js +1 -1
  251. package/dist/core/runner/prepare-ask-lane.d.ts +1 -1
  252. package/dist/core/runner/prepare-ask-lane.js +2 -1
  253. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  254. package/dist/core/runner/prepare-boundary-parks.js +5 -5
  255. package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -5
  256. package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
  257. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  258. package/dist/core/runner/prepare-config-doors.js +16 -9
  259. package/dist/core/runner/prepare-context-lane.js +2 -0
  260. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -3
  261. package/dist/core/runner/prepare-delegation-surface.js +5 -4
  262. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  263. package/dist/core/runner/prepare-file-history.js +3 -12
  264. package/dist/core/runner/prepare-gate-stations.d.ts +4 -3
  265. package/dist/core/runner/prepare-gate-stations.js +4 -3
  266. package/dist/core/runner/prepare-hands-readface.d.ts +7 -1
  267. package/dist/core/runner/prepare-hands-readface.js +19 -6
  268. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -7
  269. package/dist/core/runner/prepare-inherited-gate.js +22 -31
  270. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  271. package/dist/core/runner/prepare-memory.d.ts +2 -2
  272. package/dist/core/runner/prepare-memory.js +12 -19
  273. package/dist/core/runner/prepare-park-ask.d.ts +4 -6
  274. package/dist/core/runner/prepare-park-ask.js +5 -9
  275. package/dist/core/runner/prepare-policy-chain.d.ts +8 -7
  276. package/dist/core/runner/prepare-policy-chain.js +136 -121
  277. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  278. package/dist/core/runner/prepare-project-context.js +10 -7
  279. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -2
  280. package/dist/core/runner/prepare-prompt-inputs.js +10 -20
  281. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  282. package/dist/core/runner/prepare-protocol-tools.js +17 -2
  283. package/dist/core/runner/prepare-run-refs.d.ts +2 -3
  284. package/dist/core/runner/prepare-run-refs.js +4 -1
  285. package/dist/core/runner/prepare-suspend-saga.d.ts +0 -2
  286. package/dist/core/runner/prepare-suspend-saga.js +5 -7
  287. package/dist/core/runner/prepare-task.js +44 -28
  288. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  289. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  290. package/dist/core/runner/prepare-wiring-manifest.d.ts +5 -4
  291. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  292. package/dist/core/runner/prepare-workspace-restore.js +3 -3
  293. package/dist/core/runner/reply-pricing.d.ts +30 -0
  294. package/dist/core/runner/reply-pricing.js +19 -0
  295. package/dist/core/runner/resume-admission.js +4 -2
  296. package/dist/core/runner/resume-apply.js +6 -1
  297. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  298. package/dist/core/runner/resume-policy-outcome.js +5 -5
  299. package/dist/core/runner/retired-runner-deps.js +4 -1
  300. package/dist/core/runner/role-seat-defaulted.d.ts +44 -0
  301. package/dist/core/runner/role-seat-defaulted.js +40 -0
  302. package/dist/core/runner/run-attachment-seats.js +3 -3
  303. package/dist/core/runner/run-brain-sinks.js +3 -0
  304. package/dist/core/runner/run-git-lane.d.ts +3 -1
  305. package/dist/core/runner/run-git-lane.js +1 -1
  306. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  307. package/dist/core/runner/run-harness-handlers.js +3 -1
  308. package/dist/core/runner/run-identity-wiring.d.ts +2 -5
  309. package/dist/core/runner/run-identity-wiring.js +6 -5
  310. package/dist/core/runner/run-leg.d.ts +2 -0
  311. package/dist/core/runner/run-leg.js +63 -56
  312. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  313. package/dist/core/runner/run-notification-lane.js +16 -10
  314. package/dist/core/runner/run-settle-and-teardown.js +5 -1
  315. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  316. package/dist/core/runner/run-stop-and-final-verify.js +14 -6
  317. package/dist/core/runner/run-terminal-adoption.d.ts +2 -5
  318. package/dist/core/runner/run-terminal-adoption.js +9 -3
  319. package/dist/core/runner/run-turn-boundary.js +89 -77
  320. package/dist/core/runner/runtask.d.ts +8 -5
  321. package/dist/core/runner/runtask.js +21 -13
  322. package/dist/core/runner/side-call-account.d.ts +1 -1
  323. package/dist/core/runner/side-call-account.js +3 -18
  324. package/dist/core/runner/skills-seat.js +2 -2
  325. package/dist/core/runner/sub-agent-deny-lists.d.ts +24 -0
  326. package/dist/core/runner/sub-agent-deny-lists.js +20 -7
  327. package/dist/core/runner/synthetic-tools.js +2 -2
  328. package/dist/core/runner/tool-disclosure.js +0 -2
  329. package/dist/core/runner/tool-end-body.js +2 -2
  330. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  331. package/dist/core/runner/tool-face-overlay.js +26 -19
  332. package/dist/core/runner/tool-occurrence.d.ts +1 -1
  333. package/dist/core/runner/tool-occurrence.js +2 -2
  334. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  335. package/dist/core/runner/tool-result-media-seat.js +17 -1
  336. package/dist/core/runner/turn-attachments.d.ts +29 -27
  337. package/dist/core/runner/turn-attachments.js +27 -42
  338. package/dist/core/runner-deps.d.ts +32 -19
  339. package/dist/core/secret-env.d.ts +35 -4
  340. package/dist/core/secret-env.js +65 -3
  341. package/dist/core/sensitive-path-policy.js +3 -3
  342. package/dist/core/session-policy-store.d.ts +12 -3
  343. package/dist/core/session-policy-store.js +29 -10
  344. package/dist/core/session-store.d.ts +5 -7
  345. package/dist/core/session-store.js +50 -11
  346. package/dist/core/side-query.d.ts +11 -1
  347. package/dist/core/side-query.js +9 -0
  348. package/dist/core/skill-grant-binding.d.ts +31 -2
  349. package/dist/core/skill-grant-binding.js +31 -1
  350. package/dist/core/skill-grant.d.ts +17 -5
  351. package/dist/core/skill-grant.js +24 -6
  352. package/dist/core/store-contracts/background-agent-store-contract.js +27 -0
  353. package/dist/core/store-contracts/checkpoint-store-contract.js +3 -2
  354. package/dist/core/store-contracts/mailbox-store-contract.js +31 -1
  355. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  356. package/dist/core/store-contracts/tool-result-store-contract.js +37 -0
  357. package/dist/core/stub-env.d.ts +5 -5
  358. package/dist/core/stub-env.js +11 -1
  359. package/dist/core/swappable-deps.d.ts +17 -43
  360. package/dist/core/swappable-deps.js +15 -5
  361. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  362. package/dist/core/synthetic-read-verdict.js +2 -1
  363. package/dist/core/task-event.d.ts +50 -10
  364. package/dist/core/task-notification.d.ts +88 -5
  365. package/dist/core/task-notification.js +146 -17
  366. package/dist/core/task-registry-agent.d.ts +18 -12
  367. package/dist/core/task-registry-agent.js +19 -6
  368. package/dist/core/task-registry-monitor.d.ts +7 -0
  369. package/dist/core/task-registry-monitor.js +28 -1
  370. package/dist/core/task-registry-shared.d.ts +43 -3
  371. package/dist/core/task-registry-shared.js +21 -7
  372. package/dist/core/task-registry-workflow.js +1 -1
  373. package/dist/core/task-registry.d.ts +50 -35
  374. package/dist/core/task-registry.js +64 -23
  375. package/dist/core/task-result.d.ts +3 -12
  376. package/dist/core/task-spec.d.ts +15 -7
  377. package/dist/core/task-stream.d.ts +1 -1
  378. package/dist/core/terminal-cause.d.ts +10 -0
  379. package/dist/core/tool-catalog-entries.js +1 -1
  380. package/dist/core/tool-check-reading.d.ts +1 -0
  381. package/dist/core/tool-check-reading.js +3 -3
  382. package/dist/core/tool-face-reader.d.ts +7 -6
  383. package/dist/core/tool-face-reader.js +4 -3
  384. package/dist/core/tool-name-aliases.d.ts +19 -0
  385. package/dist/core/tool-name-aliases.js +54 -2
  386. package/dist/core/tool-policy.d.ts +21 -4
  387. package/dist/core/tool-policy.js +1 -1
  388. package/dist/core/tool-registry.d.ts +5 -5
  389. package/dist/core/tool-registry.js +2 -2
  390. package/dist/core/tool-result-store.d.ts +88 -5
  391. package/dist/core/tool-result-store.js +51 -12
  392. package/dist/core/tool-roster.d.ts +112 -5
  393. package/dist/core/tool-roster.js +42 -1
  394. package/dist/core/tool-spec.d.ts +23 -5
  395. package/dist/core/trace.d.ts +0 -1
  396. package/dist/core/types.d.ts +5 -5
  397. package/dist/core/types.js +2 -2
  398. package/dist/core/untrusted-text.js +1 -1
  399. package/dist/core/user-attachment.d.ts +10 -5
  400. package/dist/core/user-attachment.js +15 -7
  401. package/dist/core/wiring-manifest.d.ts +6 -3
  402. package/dist/engine/compaction/compaction.js +29 -3
  403. package/dist/engine/execution-env/node-execution-env.d.ts +11 -5
  404. package/dist/engine/execution-env/node-execution-env.js +21 -13
  405. package/dist/engine/harness/agent-harness.d.ts +26 -3
  406. package/dist/engine/harness/agent-harness.js +49 -16
  407. package/dist/engine/harness/messages.d.ts +3 -1
  408. package/dist/engine/harness/messages.js +3 -2
  409. package/dist/engine/harness/types.d.ts +119 -28
  410. package/dist/engine/llm/rejected-images.d.ts +46 -0
  411. package/dist/engine/llm/rejected-images.js +54 -0
  412. package/dist/engine/llm/tool-turns.d.ts +2 -1
  413. package/dist/engine/llm/types.d.ts +18 -7
  414. package/dist/engine/loop/agent-loop.d.ts +20 -12
  415. package/dist/engine/loop/agent-loop.js +205 -36
  416. package/dist/engine/loop/types.d.ts +12 -3
  417. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  418. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  419. package/dist/engine/session/path-to-root.d.ts +38 -0
  420. package/dist/engine/session/path-to-root.js +39 -0
  421. package/dist/engine/session/storage-base.js +4 -21
  422. package/dist/index.d.ts +35 -21
  423. package/dist/index.js +26 -17
  424. package/dist/internal/harness-types.d.ts +1 -1
  425. package/dist/internal/harness.d.ts +1 -0
  426. package/dist/internal/llm.d.ts +1 -0
  427. package/dist/orchestration/run-workflow-tool.d.ts +9 -3
  428. package/dist/orchestration/run-workflow-tool.js +59 -29
  429. package/dist/orchestration/workflow-governance.d.ts +1 -1
  430. package/dist/orchestration/workflow-governance.js +2 -1
  431. package/dist/orchestration/workflow-observe.d.ts +17 -1
  432. package/dist/orchestration/workflow-observe.js +20 -0
  433. package/dist/orchestration/workflow-types.d.ts +32 -7
  434. package/dist/orchestration/workflow.d.ts +4 -0
  435. package/dist/orchestration/workflow.js +762 -491
  436. package/dist/prompts/default.d.ts +1 -10
  437. package/dist/prompts/default.js +0 -2
  438. package/dist/shell/counting-pass.d.ts +50 -0
  439. package/dist/shell/counting-pass.js +502 -0
  440. package/dist/shell/lex.d.ts +4 -2
  441. package/dist/shell/lex.js +93 -34
  442. package/dist/shell/shell-words.d.ts +1 -1
  443. package/dist/shell/shell-words.js +7 -6
  444. package/dist/stores/file/background-agent-store.d.ts +1 -1
  445. package/dist/stores/file/background-agent-store.js +3 -1
  446. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  447. package/dist/stores/file/checkpoint-store.js +19 -14
  448. package/dist/stores/file/file-history-store.d.ts +1 -1
  449. package/dist/stores/file/file-history-store.js +3 -1
  450. package/dist/stores/file/index.d.ts +4 -3
  451. package/dist/stores/file/index.js +17 -8
  452. package/dist/stores/file/mailbox-store.d.ts +1 -1
  453. package/dist/stores/file/mailbox-store.js +9 -11
  454. package/dist/stores/file/memory-store.d.ts +1 -1
  455. package/dist/stores/file/memory-store.js +3 -1
  456. package/dist/stores/file/session-policy-store.d.ts +1 -1
  457. package/dist/stores/file/session-policy-store.js +3 -1
  458. package/dist/stores/file/session-store.d.ts +1 -1
  459. package/dist/stores/file/session-store.js +3 -1
  460. package/dist/stores/file/shared-ledger.d.ts +26 -0
  461. package/dist/stores/file/shared-ledger.js +38 -9
  462. package/dist/stores/file/tool-result-store.d.ts +20 -2
  463. package/dist/stores/file/tool-result-store.js +74 -6
  464. package/dist/stores/file/usage-window-store.d.ts +1 -1
  465. package/dist/stores/file/usage-window-store.js +3 -1
  466. package/dist/stores/file/workflow-journal-store.d.ts +1 -11
  467. package/dist/stores/file/workflow-journal-store.js +3 -2
  468. package/dist/tools/fs/containment-face.d.ts +5 -0
  469. package/dist/tools/fs/encoding.d.ts +13 -4
  470. package/dist/tools/fs/encoding.js +17 -2
  471. package/dist/tools/fs/fs-bash-background-text.d.ts +7 -0
  472. package/dist/tools/fs/fs-bash-background-text.js +1 -0
  473. package/dist/tools/fs/fs-bash.d.ts +14 -4
  474. package/dist/tools/fs/fs-bash.js +29 -35
  475. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  476. package/dist/tools/fs/fs-pdf.js +26 -21
  477. package/dist/tools/fs/fs-read.d.ts +5 -4
  478. package/dist/tools/fs/fs-read.js +35 -18
  479. package/dist/tools/fs/fs-search-tools.js +4 -1
  480. package/dist/tools/fs/fs-shared.d.ts +11 -13
  481. package/dist/tools/fs/fs-shared.js +11 -7
  482. package/dist/tools/fs/fs-write.js +5 -5
  483. package/dist/tools/fs/index.d.ts +14 -8
  484. package/dist/tools/fs/index.js +13 -5
  485. package/dist/tools/fs/program-read-model.d.ts +13 -0
  486. package/dist/tools/fs/program-read-model.js +15 -0
  487. package/dist/tools/fs/program-read-model.rows.js +1 -1
  488. package/dist/tools/fs/read-deny.d.ts +13 -10
  489. package/dist/tools/fs/read-deny.js +25 -5
  490. package/dist/tools/fs/read-floor.d.ts +62 -0
  491. package/dist/tools/fs/read-floor.js +58 -0
  492. package/dist/tools/fs/removal-targets.d.ts +9 -4
  493. package/dist/tools/fs/removal-targets.js +17 -9
  494. package/dist/tools/fs/search.d.ts +3 -3
  495. package/dist/tools/fs/search.js +4 -4
  496. package/dist/tools/fs/shell-read-check.d.ts +1 -1
  497. package/dist/tools/fs/shell-read-check.js +2 -1
  498. package/dist/tools/fs/shell-read-judge.d.ts +16 -8
  499. package/dist/tools/fs/shell-read-judge.js +10 -6
  500. package/dist/tools/fs/shell-read-plan.d.ts +6 -1
  501. package/dist/tools/fs/shell-read-plan.js +22 -15
  502. package/dist/tools/fs/shell-read-start.js +1 -0
  503. package/dist/tools/fs/shell-reentry-text.d.ts +15 -1
  504. package/dist/tools/fs/shell-reentry-text.js +25 -3
  505. package/dist/tools/monitor.d.ts +9 -4
  506. package/dist/tools/monitor.js +17 -8
  507. package/dist/tools/scheduler-tools.js +42 -4
  508. package/dist/tools/web.d.ts +0 -10
  509. package/dist/tools/web.js +1 -4
  510. package/package.json +5 -2
  511. package/test/export-surface.snapshot.json +161 -21
  512. package/wire-changes/core-stores-sql@7.59.0.json +29 -0
  513. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  514. package/wire-changes/core@7.59.0.json +2459 -0
  515. package/wire-changes/core@7.60.0.json +3274 -0
  516. package/wire-changes/mods-kernel@7.59.0.json +29 -0
  517. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  518. package/wire-changes/primitives@7.59.0.json +29 -0
  519. package/wire-changes/primitives@7.60.0.json +30 -0
@@ -7,7 +7,7 @@ import { resumeRefusalDetailOf, resumeStartupCauseOf } from "../core/resume-star
7
7
  import { errorCodeOf, thrownFailureOf } from "../core/runner/terminal-account.js";
8
8
  import { applyParentSpecSeat, parentSpecSeatOfCtx } from "../core/parent-spec-seat.js";
9
9
  import { ADVISOR_FORK_SENTENCE, ADVISOR_TOOL_NAME } from "../core/advisor-verdict.js";
10
- import { applyClampSeats, assertClampRecord, childClampSeats, clampSeatsOf, clampSourceOf, engineHeadlessLegSeats, foldClampSources, postureUnderClamps } from "../core/child-clamp-seats.js";
10
+ import { applyClampSeats, assertClampRecord, childClampSeats, clampSeatsOf, clampSourceOf, clampsReachNoPerson, clampValuesOf, engineHeadlessLegSeats, foldClampSources, postureUnderClamps, readClampFloor } from "../core/child-clamp-seats.js";
11
11
  import { assertNoRetiredKeys } from "../core/retired-keys.js";
12
12
  import { stripSpawnTurnQuestionFace } from "../core/ask-question.js";
13
13
  import { withDelegationProvenance } from "../core/tool-policy.js";
@@ -16,14 +16,14 @@ import { notStartedResult } from "../core/delegation-not-started.js";
16
16
  import { isHighSurrogate, isLowSurrogate } from "../core/surrogate-safe-slice.js";
17
17
  import { newDelegationProvenanceAggregate, reduceDelegationAttestation } from "../core/memory-engine/delegation-provenance.js";
18
18
  import { registerDelegationLaunch, replayExternalSettlementEffects, settleDelegation } from "../core/memory-engine/delegation-settlement.js";
19
- import { enqueueMemoryAnnouncement } from "../core/memory-engine/layout.js";
20
19
  import { resolveModel, resolveModelDisplayLabel } from "../core/roles.js";
21
20
  import { childModelSeat, childThinkingSeat, deploymentStatesSubagentModel, deploymentSubagentThinking, forkModelSeat, inheritedParentModel, runnerRoleMap } from "./child-model-seat.js";
22
21
  export { childThinkingSeat, deploymentSubagentThinking, deploymentSubagentTierModel } from "./child-model-seat.js";
23
22
  import { REPORT_BLOCKED_TOOL_NAME } from "../core/runner/synthetic-tools.js";
24
23
  import { TOOL_SEARCH_NAME } from "../core/runner/tool-disclosure.js";
25
- import { OFFLOAD_TOOL_NAME } from "../core/tool-result-store.js";
26
- import { compileToolSelector, delegationListWhere, namesEveryTool, snapshotDefinitionLists, toolListsDigest, toolNameAllowed, toolNameListFlaw } from "./tool-filter.js";
24
+ import { OFFLOAD_TOOL_NAME, persistTaskArtifact } from "../core/tool-result-store.js";
25
+ import { compileToolSelector, delegationListWhere, namesEveryTool, toolListsDigest, toolNameAllowed, toolNameListFlaw } from "./tool-filter.js";
26
+ import { snapshotDefinitionLists } from "./agent-definition.js";
27
27
  import { readToolNameList, snapshotToolNameList } from "../core/tool-name-list.js";
28
28
  import { EXTRA_TOOL_NAMES_CODE, delegationPoolFace, extraToolNamesError, firstUndeclaredExtraTool, readExtraToolNames } from "./extra-tool-names.js";
29
29
  import { builtinAgentDefinitions } from "./builtin-agents.js";
@@ -45,7 +45,7 @@ import { BG_AGENT_REAP_STOP_ERROR, chosenAgentName } from "../core/task-registry
45
45
  import { readDurableOrgAdmission } from "../core/memory-admission.js";
46
46
  import { governanceRetryClass } from "../core/governance-codes.js";
47
47
  import { readSkillGrantCapture } from "../core/skill-grant.js";
48
- import { notifyResultField, terminalFrameFacets } from "../core/task-notification.js";
48
+ import { completionResultField, oweTerminalDelivery, resolveCompletionSink, retireTerminalDelivery, terminalFrameFacets } from "../core/task-notification.js";
49
49
  import { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX, RUNNING_AGENT_OBSERVE_EVERY_BEATS, DELEGATION_MAX_CONCURRENT_DEFAULT, DELEGATION_MAX_PER_SESSION_DEFAULT } from "../config/defaults.js";
50
50
  function rollupDelegatedCost(stats, nested) {
51
51
  if (stats.costMicroUsd === undefined)
@@ -72,15 +72,15 @@ function providerFaultField(child) {
72
72
  };
73
73
  }
74
74
  export { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX };
75
- import { SUBAGENT_RESUME_CAP, SubagentRetainLedger, getOrCreateSessionRetainLedger, ensureSessionReapHook, createResumePrompt, } from "./retain-ledger.js";
75
+ import { SUBAGENT_RESUME_CAP, SubagentRetainLedger, getOrCreateSessionRetainLedger, ensureSessionReapHook, createResumePrompt, holdChildDeclarations, } from "./retain-ledger.js";
76
76
  import { createPeerInboundChainRef, createPeerSelfRef } from "./peer-admission.js";
77
77
  import { recordRosterSpawn } from "./roster-store.js";
78
78
  import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "./launch-receipt-contract.js";
79
79
  import { ObserverDigestTap, ObserverPairing, createObserverReportToolSpec, markObserverTaskId, unmarkObserverTaskId, isObserverTaskId, ObserverResumeStateError, ObserverStoppedByUserError, observerFramingPrompt, observerSlug, resolveObserverDeclaration, } from "./observer.js";
80
- import { SubagentStepRecorder } from "./subagent-steps.js";
80
+ import { SubagentStepRecorder, redactThenCut } from "./subagent-steps.js";
81
81
  import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
82
82
  import { canonicalNameValue } from "../core/permission-rule-model.js";
83
- import { inheritedChildPool, inheritedMcpDeclarations } from "./inherited-tool-pool.js";
83
+ import { definitionAllowTools, inheritedChildPool, inheritedHostSeats, inheritedMcpDeclarations, withDefinitionServers, withoutHostSeats } from "./inherited-tool-pool.js";
84
84
  import { readMember, thrownText } from "../core/thrown-value.js";
85
85
  const BG_AGENT_RESULT_MAX = 4_000;
86
86
  const BG_AGENT_RESULT_FULL_MAX = 200_000;
@@ -517,7 +517,7 @@ export function createSubagentResume(deps) {
517
517
  assertNoRetiredKeys(deps, RETIRED_RESUME_CLAMP_KEYS, "createSubagentResume");
518
518
  assertClampRecord(deps.currentClamps, "createSubagentResume currentClamps");
519
519
  const notifier = createSafeNotifier(deps.onNotifyError !== undefined ? { onError: deps.onNotifyError } : undefined);
520
- const resume = async (content) => {
520
+ const resumeAs = (peerOrigin) => async (content) => {
521
521
  const ledger = deps.ledger;
522
522
  if (!ledger) {
523
523
  throw configError("resume unavailable: the parent run did not enable TaskSpec.retainSubagentSessions.", "resume.retain_off");
@@ -553,6 +553,7 @@ export function createSubagentResume(deps) {
553
553
  let stream;
554
554
  let reviveCycle;
555
555
  let reviveEmit;
556
+ let releaseCycleSlot = noopRelease;
556
557
  let marker;
557
558
  let reviveStartedAt = Date.now();
558
559
  try {
@@ -577,7 +578,7 @@ export function createSubagentResume(deps) {
577
578
  const wakeClamps = foldClampSources(entry.specSnapshot, deps.currentClamps);
578
579
  const resumeSpec = applyClampSeats({
579
580
  ...entry.specSnapshot,
580
- objective: createResumePrompt(marker, content, deps.peerOrigin !== undefined ? "peer" : "operator"),
581
+ objective: createResumePrompt(marker, content, peerOrigin !== undefined ? "peer" : "operator"),
581
582
  sessionId: entry.childSessionId,
582
583
  requireExistingSession: true,
583
584
  ...(deps.currentOnQuestion !== undefined ? { onQuestion: deps.currentOnQuestion } : {}),
@@ -651,8 +652,11 @@ export function createSubagentResume(deps) {
651
652
  usage: { toolUses: toolStarts },
652
653
  });
653
654
  }, deps.registry !== undefined && deps.taskId !== undefined ? () => deps.registry.noteBackgroundAgentActivity(deps.taskId) : undefined);
655
+ releaseCycleSlot = deps.entryGate?.occupy(reviveCycle !== undefined ? "registered" : "local") ?? noopRelease;
654
656
  stream = childRunner.runTaskStream(resumeSpec, undefined, {
655
657
  ...entry.internalsSnapshot,
658
+ ...inheritedHostSeats(deps.currentMcpHostSeats, resumeSpec.mcp ?? []),
659
+ ...(peerOrigin === undefined ? { operatorObjective: true } : {}),
656
660
  cycleSeq: entry.cycleSeq,
657
661
  parentInteractionPosture: postureUnderClamps(entry.internalsSnapshot.parentInteractionPosture, { interactiveTools: resumeSpec.interactiveTools, approvalReach: resumeSpec.approvalReach }),
658
662
  ...(true
@@ -683,7 +687,7 @@ export function createSubagentResume(deps) {
683
687
  ...(deps.currentParentNotify !== undefined
684
688
  ? { parentNotify: deps.currentParentNotify, parentPeerRef: deps.currentParentPeerRef }
685
689
  : {}),
686
- peerInboundChainRef: createPeerInboundChainRef(deps.peerOrigin?.hopChain),
690
+ peerInboundChainRef: createPeerInboundChainRef(peerOrigin?.hopChain),
687
691
  ...(reviveCycle !== undefined
688
692
  ? {
689
693
  onNotifyInjectorReady: (inject) => {
@@ -707,18 +711,21 @@ export function createSubagentResume(deps) {
707
711
  catch (err) {
708
712
  entry.running = false;
709
713
  entry.activeAbort = undefined;
714
+ releaseCycleSlot();
710
715
  throw err;
711
716
  }
712
717
  if (entry.deferredNotify !== undefined) {
713
- entry.deferredNotify.cancel();
718
+ const parked = entry.deferredNotify;
714
719
  entry.deferredNotify = undefined;
720
+ notifier.notify(() => parked.cancel(), "subagent.resume.park_cancel");
715
721
  }
722
+ oweTerminalDelivery(deps.notify, { task_id: deps.taskId ?? entry.childSessionId, task_type: "background_agent" });
716
723
  let settleResolve;
717
724
  const settled = new Promise((r) => {
718
725
  settleResolve = r;
719
726
  });
720
727
  if (deps.sink) {
721
- notifier.notify(() => deps.sink?.(createSteerHandle(stream, deps.parentToolCallId, entry.agentName, settled, { resume, childSessionId: entry.childSessionId })), "subagent.resume.sink");
728
+ notifier.notify(() => deps.sink?.(createSteerHandle(stream, deps.parentToolCallId, entry.agentName, settled, { resume: operatorResume, childSessionId: entry.childSessionId })), "subagent.resume.sink");
722
729
  }
723
730
  void (async () => {
724
731
  try {
@@ -771,6 +778,9 @@ export function createSubagentResume(deps) {
771
778
  named: deps.rowName !== undefined,
772
779
  });
773
780
  const ownsTerminalFacesRevive = deps.registry !== undefined && deps.taskId !== undefined ? deps.registry.claimAgentTerminalNotify(deps.taskId) : true;
781
+ const resumeResultField = await completionResultField(resumeHandbackResult, (report) => persistTaskArtifact(deps.currentTaskArtifacts, deps.taskId ?? entry.childSessionId, report));
782
+ if (resumeResultField?.ref !== undefined && deps.taskId !== undefined && reviveCycle !== undefined)
783
+ deps.registry?.recordArtifactRef(deps.taskId, resumeResultField.ref, reviveCycle);
774
784
  const resumeFrame = {
775
785
  task_id: deps.taskId ?? entry.childSessionId,
776
786
  ...(entry.childSessionId !== undefined ? { sessionId: entry.childSessionId } : {}),
@@ -784,7 +794,7 @@ export function createSubagentResume(deps) {
784
794
  ...(failReasonRevive !== undefined ? { error: failReasonRevive.slice(0, REPORT_FIELD_MAX) } : {}),
785
795
  ...(status === "failed" && errCodeRevive !== undefined ? { errorCode: errCodeRevive } : {}),
786
796
  ...providerFaultField(child),
787
- ...(resumeHandbackResult ? { result: notifyResultField(resumeHandbackResult) } : {}),
797
+ ...(resumeResultField !== undefined ? { result: resumeResultField.text } : {}),
788
798
  ...(status === "killed" && child.result ? { partial: true } : {}),
789
799
  ...resumeResidual(),
790
800
  resumable: resumableRevive,
@@ -860,6 +870,7 @@ export function createSubagentResume(deps) {
860
870
  finally {
861
871
  entry.running = false;
862
872
  entry.activeAbort = undefined;
873
+ releaseCycleSlot();
863
874
  entry.settledAt = Date.now();
864
875
  ledger.markSettled(deps.parentToolCallId);
865
876
  settleResolve();
@@ -867,7 +878,8 @@ export function createSubagentResume(deps) {
867
878
  })();
868
879
  return marker;
869
880
  };
870
- return resume;
881
+ const operatorResume = resumeAs(undefined);
882
+ return deps.peerOrigin === undefined ? operatorResume : resumeAs(deps.peerOrigin);
871
883
  }
872
884
  function parkCompletionNotify(deps) {
873
885
  const { registry, entry, owner, pendingCount, payload, notify } = deps;
@@ -896,6 +908,7 @@ function parkCompletionNotify(deps) {
896
908
  return;
897
909
  done = true;
898
910
  unsubscribe();
911
+ retireTerminalDelivery(notify, payload);
899
912
  };
900
913
  entry.deferredNotify = { ...(payload.seq !== undefined ? { seq: payload.seq } : {}), cancel, flush: () => deliver(false) };
901
914
  }
@@ -1111,9 +1124,10 @@ async function untilAbort(p, signal) {
1111
1124
  async function openDelegationEntryGate(input) {
1112
1125
  const { poolAnchor, registry, store, root, caps, revival, signal } = input;
1113
1126
  if (root === undefined)
1114
- return { key: undefined, admit: () => ({ admitted: true, release: noopRelease }) };
1127
+ return { key: undefined, admit: () => ({ admitted: true, release: noopRelease }), occupy: () => noopRelease };
1115
1128
  const scope = input.scope ?? DELEGATION_POOL_DEFAULT_SCOPE;
1116
1129
  const key = JSON.stringify([scope, root]);
1130
+ const occupy = (kind) => (kind === "local" ? chargeLocalDelegationInFlight(poolAnchor, key) : noopRelease);
1117
1131
  let storedHandles = [];
1118
1132
  let storedEnumerationOk = false;
1119
1133
  if (store !== undefined && !revival) {
@@ -1172,9 +1186,9 @@ async function openDelegationEntryGate(input) {
1172
1186
  };
1173
1187
  }
1174
1188
  }
1175
- return { admitted: true, release: kind === "local" ? chargeLocalDelegationInFlight(poolAnchor, key) : noopRelease };
1189
+ return { admitted: true, release: occupy(kind) };
1176
1190
  };
1177
- return { key, admit };
1191
+ return { key, admit, occupy };
1178
1192
  }
1179
1193
  function chargeDelegationEntryHandle(registry, key, store, handle) {
1180
1194
  if (handle !== undefined)
@@ -1183,6 +1197,16 @@ function chargeDelegationEntryHandle(registry, key, store, handle) {
1183
1197
  armDelegationLedgerLifecycle(registry);
1184
1198
  sweepDelegationLedgerRound(registry, 3);
1185
1199
  }
1200
+ async function releaseBoundChildSession(bound, sessionId, release) {
1201
+ try {
1202
+ await release();
1203
+ }
1204
+ catch {
1205
+ return false;
1206
+ }
1207
+ bound?.registry.releaseDurableTranscriptAnchor(bound.taskId, sessionId);
1208
+ return true;
1209
+ }
1186
1210
  export { normalizeSubagentType } from "../core/permission-rule-model.js";
1187
1211
  function canonicalSubagentTypeArgs(args, accepted, generalPurposeShadowed) {
1188
1212
  if (args === null || typeof args !== "object" || Array.isArray(args))
@@ -1245,20 +1269,15 @@ export function forkWorktreeTranslationNote(parentCwd, worktreeDir) {
1245
1269
  }
1246
1270
  export function asyncLaunchedReceipt(p) {
1247
1271
  const noteLines = (p.notes ?? []).filter((n) => n !== undefined && n !== "");
1248
- const oneShotBlocked = p.notify && p.oneShot === true;
1249
1272
  return (`Async agent launched successfully. (${launchReceiptNoQuoteClause(", including the task_id below,")})\n` +
1250
1273
  `task_id: ${p.taskId} (internal ID - do not mention to user. ${launchContinuationSentence(p.taskId)})\n` +
1251
- (oneShotBlocked
1252
- ? `${p.workingLine} This is a ONE-SHOT submission — there is no later turn for a background notification to land in, so do NOT end your turn expecting one. Actively wait instead: TaskOutput(task_id: "${p.taskId}", block: true). If it is still running after the wait, wait again (bounded) rather than ending the turn, or write out your best available answer now if you are near your own time budget.\n`
1253
- : p.notify
1254
- ? `${p.workingLine} You will be notified automatically when it completes. You know nothing about its results until that notification arrives — do not report, assume, or predict them; continue other work or respond to the user in the meantime.\n`
1255
- : `${p.workingLine} Its result is NOT pushed automatically — retrieve progress and results with TaskOutput(task_id) where mounted.\n`) +
1274
+ (p.notify
1275
+ ? `${p.workingLine} You will be notified automatically when it completes. You know nothing about its results until that notification arrives — do not report, assume, or predict them; continue other work or respond to the user in the meantime.\n`
1276
+ : `${p.workingLine} Its result is NOT pushed automatically — retrieve progress and results with TaskOutput(task_id) where mounted.\n`) +
1256
1277
  noteLines.map((n) => `${n}\n`).join("") +
1257
- (oneShotBlocked
1258
- ? `${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE} Do not assume a later message will deliver the result: this submission ends after this turn, so retrieve it now with the blocking TaskOutput wait above before writing your final answer.`
1259
- : p.notify
1260
- ? `${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE} Agent results will arrive in a subsequent message. If the user asks for progress, say the agent is still running.`
1261
- : `${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE} The result will NOT arrive on its own — retrieve it with TaskOutput(task_id) where mounted before relying on it.`));
1278
+ (p.notify
1279
+ ? `${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE} Agent results will arrive in a subsequent message. If the user asks for progress, say the agent is still running.`
1280
+ : `${LAUNCH_RECEIPT_OWN_WORDS_CLAUSE} The result will NOT arrive on its own — retrieve it with TaskOutput(task_id) where mounted before relying on it.`));
1262
1281
  }
1263
1282
  function runnerModelCatalog(runner) {
1264
1283
  try {
@@ -1386,10 +1405,11 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1386
1405
  const depthPermitsNesting = depth + 1 < maxDepth;
1387
1406
  const agentToolFaces = [
1388
1407
  ...(generalPurposeShadowed ? [] : [{ name: GENERAL_PURPOSE_SUBAGENT_TYPE, ...(depthPermitsNesting ? { canRedelegate: true } : {}) }]),
1389
- ...available.map((a) => ({
1408
+ ...available.map((a) => ({ a, allow: definitionAllowTools(a) })).map(({ a, allow }) => ({
1390
1409
  name: a.name,
1391
- ...(a.allowTools !== undefined ? { allowTools: a.allowTools } : {}),
1410
+ ...(allow !== undefined ? { allowTools: allow } : {}),
1392
1411
  ...(a.denyTools !== undefined ? { denyTools: a.denyTools } : {}),
1412
+ ...(a.mcp !== undefined && a.mcp.length > 0 ? { servers: a.mcp.map((s) => ({ name: s.name, ...(s.contentOrigin !== undefined ? { contentOrigin: s.contentOrigin } : {}) })) } : {}),
1393
1413
  ...(depthPermitsNesting && toolNameAllowed(delegationToolName, a.allowTools, a.denyTools) ? { canRedelegate: true } : {}),
1394
1414
  ...(depth === 0 && !builtins.includes(a) ? { authored: true } : {}),
1395
1415
  })),
@@ -1510,6 +1530,16 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1510
1530
  details: { error: "revive.no_background" },
1511
1531
  });
1512
1532
  }
1533
+ const revivalFloor = reviveClaim !== undefined ? readClampFloor(reviveClaim.row.policyFloor) : undefined;
1534
+ const floorRefusal = revivalFloor !== undefined && !revivalFloor.ok ? revivalFloor.why : undefined;
1535
+ if (floorRefusal !== undefined && reviveClaim?.parkedResume === undefined) {
1536
+ return notStartedResult({
1537
+ isError: true,
1538
+ content: `Sub-agent not revived: ${inlineUntrusted(floorRefusal, 400)}, so the restrictions it ran under cannot be held on a new cycle. Launch a new agent with the needed context instead.`,
1539
+ details: { error: "revive.policy_floor_unreadable" },
1540
+ });
1541
+ }
1542
+ const bornFloor = revivalFloor?.ok === true ? revivalFloor.floor : undefined;
1513
1543
  const prompt = String(a.prompt ?? "").trim();
1514
1544
  if (!prompt) {
1515
1545
  return notStartedResult({ isError: true, content: "Sub-agent not started: 'prompt' was empty.", details: { error: "empty prompt" } });
@@ -1670,7 +1700,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1670
1700
  const inheritedParent = ctx.modelRef ?? ctx.model;
1671
1701
  const explicitModelChain = wantsFork ? [inheritedParentModel(inheritedParent, liveCatalog), opts.model] : [perCallModel, def?.model, opts.model];
1672
1702
  let childModel = explicitModelChain.find((c) => c !== undefined);
1673
- const deploymentStatedSubagentModel = deploymentStatesSubagentModel(runnerRoleMap(opts.runner));
1703
+ const deploymentStatedSubagentModel = deploymentStatesSubagentModel(runnerRoleMap(opts.runner), liveCatalog);
1674
1704
  if (reviveClaim !== undefined && typeof childModel === "string") {
1675
1705
  const resolvable = (ref) => {
1676
1706
  try {
@@ -1715,6 +1745,30 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1715
1745
  details: { error: "skill_grants.unreadable" },
1716
1746
  });
1717
1747
  }
1748
+ const stations = reviveClaim === undefined ? ctx.agentStations : undefined;
1749
+ if (stations?.listens("agent.offer") === true) {
1750
+ const listed = agentListing.find((entry) => entry.name === spawnAgentType);
1751
+ const offered = await stations.offered([{ name: spawnAgentType, description: listed?.description ?? "" }], ctx.signal);
1752
+ if (offered.length === 0) {
1753
+ return notStartedResult({ isError: true, content: `Sub-agent not started: subagent_type "${inlineUntrusted(spawnAgentType, 80)}" is not offered here. Available subagent_type values are the ones the agent listing names.`, details: { error: "unknown subagent_type" } });
1754
+ }
1755
+ }
1756
+ if (stations?.listens("agent.spawn") === true) {
1757
+ const verdict = await stations.spawn({
1758
+ toolCallId: ctx.toolCallId,
1759
+ prompt,
1760
+ description: typeof a.description === "string" ? a.description : "",
1761
+ subagentType: spawnAgentType,
1762
+ ...(spawnModel !== undefined ? { model: spawnModel } : {}),
1763
+ ...(ctx.model?.id !== undefined ? { parentModel: ctx.model.id } : {}),
1764
+ background: wantsBackground,
1765
+ fork: wantsFork,
1766
+ ...(agentName !== undefined ? { name: agentName } : {}),
1767
+ ...(childCwd !== undefined ? { cwd: childCwd } : {}),
1768
+ }, ctx.signal);
1769
+ if (!verdict.go)
1770
+ return notStartedResult({ isError: true, content: `Sub-agent not started: ${verdict.reason.slice(0, 600)}`, details: { error: "mods.spawn_refused", refusedBy: verdict.by } });
1771
+ }
1718
1772
  let worktreeDir;
1719
1773
  if (reviveClaim === undefined && (a.isolation ?? def?.isolation) === "worktree") {
1720
1774
  const iso = ctx.worktreeIsolation;
@@ -1837,13 +1891,14 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1837
1891
  }
1838
1892
  childPool = [...(opts.tools ?? inherited.filter((t) => ![t.name, ...(t.aliases ?? [])].some((n) => taken.has(n)))), ...accepted];
1839
1893
  }
1840
- const governingLists = def !== undefined ? { allow: def.allowTools, deny: def.denyTools } : { allow: opts.allowTools, deny: opts.denyTools };
1894
+ const governingLists = def !== undefined ? { allow: definitionAllowTools(def), deny: def.denyTools } : { allow: opts.allowTools, deny: opts.denyTools };
1841
1895
  const childOwnLayer = Object.freeze({ ...(governingLists.allow != null ? { allow: Object.freeze([...governingLists.allow]) } : {}), deny: Object.freeze([...(governingLists.deny ?? [])]) });
1842
1896
  const childListsDigest = toolListsDigest(childOwnLayer.allow, childOwnLayer.deny);
1843
1897
  const childListsJudged = agentToolPool !== undefined ? childListsDigest : undefined;
1844
1898
  const childCeiling = ctx.toolSelector?.layers ?? [];
1845
- const parentMcp = opts.tools === undefined && extraToolsNote === undefined ? ctx.mountedMcp?.() : undefined;
1846
- const childMcp = parentMcp !== undefined ? inheritedMcpDeclarations(parentMcp, compileToolSelector([...childCeiling, childOwnLayer])) : undefined;
1899
+ const mountedMcpNow = ctx.mountedMcp?.();
1900
+ const parentMcp = opts.tools === undefined && extraToolsNote === undefined ? mountedMcpNow : undefined;
1901
+ const childMcp = withDefinitionServers(parentMcp !== undefined ? inheritedMcpDeclarations(parentMcp, compileToolSelector([...childCeiling, childOwnLayer])) : undefined, def?.mcp);
1847
1902
  const childTools = [...childPool];
1848
1903
  const childRoleBase = roleBaseOf([def !== undefined ? { systemPrompt: def.systemPrompt } : undefined, { promptRole: opts.promptRole, systemPrompt: opts.systemPrompt }]);
1849
1904
  const childSystemPrompt = childRoleBase?.systemPrompt;
@@ -1911,7 +1966,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1911
1966
  queueReport: async (framed) => injectObservedRequest(framed, "observer"),
1912
1967
  };
1913
1968
  const reportTool = createObserverReportToolSpec(reportOpts);
1914
- const observerModelPick = () => childModelSeat(undefined, deploymentStatesSubagentModel(runnerRoleMap(opts.runner)), ctx.modelRef ?? ctx.model, runnerModelCatalog(opts.runner));
1969
+ const observerModelPick = () => childModelSeat(undefined, deploymentStatesSubagentModel(runnerRoleMap(opts.runner), runnerModelCatalog(opts.runner)), ctx.modelRef ?? ctx.model, runnerModelCatalog(opts.runner));
1915
1970
  const observerSpec = (objectiveText, resume) => applyParentSpecSeat({
1916
1971
  sessionId: sid,
1917
1972
  ...(resume ? { requireExistingSession: true } : {}),
@@ -2107,10 +2162,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2107
2162
  const liveCaptureFloor = reviveClaim === undefined
2108
2163
  ? { optedOut: (await ctx.memoryCaptureOptedOut) === true, indeterminate: (await ctx.memoryCaptureIndeterminate) === true }
2109
2164
  : undefined;
2165
+ const revivalClamps = bornFloor !== undefined ? clampValuesOf(clampSourceOf(ctx, "clamp"), bornFloor) : undefined;
2166
+ const childPosture = revivalClamps !== undefined && clampsReachNoPerson({ interactiveTools: revivalClamps.interactiveTools, approvalReach: revivalClamps.approvalReach }) ? "headless" : ctx.interactionPosture;
2110
2167
  const childInternals = {
2111
2168
  ...(ctx.toolSelector !== undefined ? { toolCeiling: childCeiling, ...(childListsJudged !== undefined ? { toolListsJudged: childListsJudged } : {}) } : {}),
2112
2169
  ...(childListsDigest !== undefined ? { ownToolLists: { toolName, ...(def !== undefined ? { definition: def.name } : {}), lists: childListsDigest } } : {}),
2113
- ...(parentMcp?.pool !== undefined && childMcp !== undefined && childMcp.length > 0 ? { mcpPool: parentMcp.pool } : {}),
2170
+ ...(mountedMcpNow?.pool !== undefined && childMcp.length > 0 ? { mcpPool: mountedMcpNow.pool } : {}),
2171
+ ...inheritedHostSeats(mountedMcpNow?.hostSeats, childMcp),
2114
2172
  ...(childPick.modelRef !== undefined ? { inheritedModelRef: childPick.modelRef } : {}),
2115
2173
  ...(inheritedSkillGrants.length > 0 ? { inheritedSkillGrants } : {}),
2116
2174
  ...(inheritedAllowedTools !== undefined && inheritedAllowedTools.length > 0 ? { inheritedAllowedTools: [...inheritedAllowedTools] } : {}),
@@ -2130,7 +2188,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2130
2188
  peerInboundChainRef: createPeerInboundChainRef(reviveClaim?.peerSeed?.hopChain),
2131
2189
  ...(childDefaultPersona !== undefined ? { defaultSystemPrompt: childDefaultPersona } : {}),
2132
2190
  isDelegatedChild: true,
2133
- ...(ctx.interactionPosture !== undefined ? { parentInteractionPosture: ctx.interactionPosture } : {}),
2191
+ ...(childPosture !== undefined ? { parentInteractionPosture: childPosture } : {}),
2134
2192
  ...(reviveClaim === undefined
2135
2193
  ? {
2136
2194
  ...(liveCaptureFloor?.optedOut === true ? { memoryCaptureFloor: true } : {}),
@@ -2196,12 +2254,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2196
2254
  ...(provenanceAgentName !== undefined ? { agentName: provenanceAgentName } : {}),
2197
2255
  })
2198
2256
  : undefined;
2199
- const buildChildSpec = (signal) => applyParentSpecSeat({
2257
+ const underBornFloor = (spec) => (bornFloor === undefined ? spec : applyClampSeats(spec, clampValuesOf(spec, bornFloor)));
2258
+ const buildChildSpec = (signal) => underBornFloor(applyParentSpecSeat({
2200
2259
  objective: prompt,
2201
2260
  ...childSeat,
2202
2261
  ...childThinking,
2203
2262
  tools: childTools,
2204
- ...(childMcp !== undefined && childMcp.length > 0 ? { mcp: childMcp } : {}),
2263
+ ...(childMcp.length > 0 ? { mcp: childMcp } : {}),
2205
2264
  systemPrompt: childSystemPrompt,
2206
2265
  ...(childRoleBase?.promptRole !== undefined ? { promptRole: childRoleBase.promptRole } : {}),
2207
2266
  ...(def?.memory ? { memory: def.memory } : {}),
@@ -2220,15 +2279,29 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2220
2279
  enableBlockedReport: true,
2221
2280
  limits: childLimits,
2222
2281
  signal,
2223
- }, parentSpecSeat);
2224
- const tryRetainChild = async (ledger, entryTtlMs, preMintedSessionId, durableProbe, releaseAnchor, internalsExtra) => {
2282
+ }, parentSpecSeat));
2283
+ const spawnPolicyFloor = () => clampSeatsOf(buildChildSpec(undefined));
2284
+ const tryRetainChild = async (ledger, entryTtlMs, preMintedSessionId, durableProbe, bound, internalsExtra) => {
2225
2285
  if (!ledger)
2226
2286
  return undefined;
2227
2287
  const childSessionId = preMintedSessionId ?? uuidv7();
2228
2288
  const retainStrip = stripSpawnTurnQuestionFace(buildChildSpec(undefined));
2229
2289
  const { signal: _spawnSignal, ...plainSpec } = retainStrip.spec;
2290
+ const launchesOnThisId = preMintedSessionId !== undefined;
2291
+ let releasing;
2292
+ const releaseEntry = () => (releasing ??= (async () => {
2293
+ try {
2294
+ await opts.runner.sessions.unpin?.(childSessionId);
2295
+ }
2296
+ catch {
2297
+ }
2298
+ if (durableProbe && (await durableProbe().catch(() => false)))
2299
+ return;
2300
+ await releaseBoundChildSession(bound, childSessionId, () => opts.runner.sessions.release(childSessionId));
2301
+ })());
2230
2302
  let entry = ledger.register(ctx.toolCallId, {
2231
2303
  childSessionId,
2304
+ declarations: holdChildDeclarations(opts.runner, plainSpec),
2232
2305
  runner: opts.runner,
2233
2306
  ...(entryTtlMs !== undefined ? { ttlMs: entryTtlMs } : {}),
2234
2307
  ...(childAgentName !== undefined ? { agentName: childAgentName } : {}),
@@ -2245,22 +2318,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2245
2318
  ...(plainSpec.alwaysLoadTools !== undefined ? { alwaysLoadTools: [...plainSpec.alwaysLoadTools] } : {}),
2246
2319
  ...(Array.isArray(plainSpec.restoreGatedTools) ? { restoreGatedTools: [...plainSpec.restoreGatedTools] } : {}),
2247
2320
  }),
2248
- internalsSnapshot: { ...childInternals, ...retainStrip.internalsFlag, ...(internalsExtra ?? {}) },
2249
- release: async () => {
2250
- try {
2251
- await opts.runner.sessions.unpin?.(childSessionId);
2252
- }
2253
- catch {
2254
- }
2255
- if (durableProbe && (await durableProbe().catch(() => false)))
2256
- return;
2257
- try {
2258
- await opts.runner.sessions.release(childSessionId);
2259
- releaseAnchor?.();
2260
- }
2261
- catch {
2262
- }
2263
- },
2321
+ internalsSnapshot: { ...withoutHostSeats(childInternals), ...retainStrip.internalsFlag, ...(internalsExtra ?? {}) },
2322
+ release: releaseEntry,
2264
2323
  });
2265
2324
  if (entry) {
2266
2325
  try {
@@ -2268,21 +2327,20 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2268
2327
  }
2269
2328
  catch {
2270
2329
  await ledger.evict(ctx.toolCallId);
2330
+ if (launchesOnThisId)
2331
+ await releaseEntry();
2271
2332
  entry = undefined;
2272
2333
  }
2273
2334
  if (entry !== undefined && (ledger.disposed || ledger.get(ctx.toolCallId) !== entry)) {
2335
+ if (launchesOnThisId)
2336
+ await releaseEntry();
2274
2337
  try {
2275
2338
  await opts.runner.sessions.unpin?.(childSessionId);
2276
2339
  }
2277
2340
  catch {
2278
2341
  }
2279
2342
  if (!(durableProbe && (await durableProbe().catch(() => false)))) {
2280
- try {
2281
- await opts.runner.sessions.release(childSessionId);
2282
- releaseAnchor?.();
2283
- }
2284
- catch {
2285
- }
2343
+ await releaseBoundChildSession(bound, childSessionId, () => opts.runner.sessions.release(childSessionId));
2286
2344
  }
2287
2345
  entry = undefined;
2288
2346
  }
@@ -2312,6 +2370,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2312
2370
  const { signal: _spawnSignal, ...plainSpec } = failedRetainStrip.spec;
2313
2371
  const entry = ledger.register(ctx.toolCallId, {
2314
2372
  childSessionId,
2373
+ declarations: holdChildDeclarations(opts.runner, plainSpec),
2315
2374
  runner: opts.runner,
2316
2375
  ttlMs: FAILED_SESSION_RETAIN_TTL_MS,
2317
2376
  ...(childAgentName !== undefined ? { agentName: childAgentName } : {}),
@@ -2328,7 +2387,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2328
2387
  ...(plainSpec.alwaysLoadTools !== undefined ? { alwaysLoadTools: [...plainSpec.alwaysLoadTools] } : {}),
2329
2388
  ...(Array.isArray(plainSpec.restoreGatedTools) ? { restoreGatedTools: [...plainSpec.restoreGatedTools] } : {}),
2330
2389
  }),
2331
- internalsSnapshot: { ...childInternals, ...failedRetainStrip.internalsFlag },
2390
+ internalsSnapshot: { ...withoutHostSeats(childInternals), ...failedRetainStrip.internalsFlag },
2332
2391
  release: releaseChild,
2333
2392
  });
2334
2393
  if (entry) {
@@ -2430,7 +2489,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2430
2489
  const forkObjective = `${FORK_DIRECTIVE_FRAME}${prompt}${forkWorktreeNote !== undefined ? `\n\n${forkWorktreeNote}` : ""}${parentSpecSeat?.advisorModel !== undefined ? `\n\n${ADVISOR_FORK_SENTENCE}` : ""}`;
2431
2490
  if (wantsBackground) {
2432
2491
  const bg = opts.background;
2433
- const notify = ctx.onTaskNotification ?? bg.notify;
2492
+ const notify = resolveCompletionSink(ctx.onTaskNotification, bg.notify);
2434
2493
  const abort = new AbortController();
2435
2494
  const sessionScopedBg = ctx.backgroundScope === "session" && ctx.sessionId !== undefined;
2436
2495
  const onHostAbort = () => abort.abort();
@@ -2441,7 +2500,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2441
2500
  else if (!sessionScopedBg)
2442
2501
  ctx.signal.addEventListener("abort", onHostAbort, { once: true });
2443
2502
  }
2444
- const shortDesc = `fork: ${(typeof a.description === "string" && a.description.trim() ? a.description.trim() : prompt).slice(0, 180)}`;
2503
+ const shortDesc = `fork: ${redactThenCut(typeof a.description === "string" && a.description.trim() ? a.description.trim() : prompt, 180)}`;
2445
2504
  const bgOwner = sessionScopedBg ? ctx.sessionId : ctx.taskId ?? bg.owner;
2446
2505
  const bgScope = treeScope;
2447
2506
  const forkEntryGate = await openEntryGate();
@@ -2500,16 +2559,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2500
2559
  }
2501
2560
  if (!settled) {
2502
2561
  const detail = childThrownText(lastErr);
2503
- try {
2504
- enqueueMemoryAnnouncement(forkSettlementSeat.controlDir, {
2505
- kind: "gate",
2506
- at: Date.now(),
2507
- items: [`delegation settlement: the terminal observation for a background fork of session ${JSON.stringify(forkSettlementSeat.sessionId)} could NOT be recorded (verdict ${verdict}) — the row stays pending and expires as UNPROVEN at the settlement window (fail-closed floor): ${detail.slice(0, 200)}`],
2508
- });
2509
- }
2510
- catch {
2511
- console.warn(`[sema] delegation settlement terminal write failed (fork, verdict ${verdict}, session ${forkSettlementSeat.sessionId}): ${detail}`);
2512
- }
2562
+ console.warn(`[sema] delegation settlement terminal write failed (fork, verdict ${verdict}, session ${forkSettlementSeat.sessionId}): ${detail} — the pending row expires as unproven at the settlement window`);
2513
2563
  }
2514
2564
  };
2515
2565
  let taskId;
@@ -2528,7 +2578,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2528
2578
  deliveryChannel: "attaching",
2529
2579
  toolUseId: ctx.toolCallId,
2530
2580
  ...(ctx.crossBoundaryTreeForChildren !== undefined ? { crossBoundaryTree: ctx.crossBoundaryTreeForChildren } : {}),
2531
- ...(bg.agentStore !== undefined ? { store: bg.agentStore } : {}),
2581
+ ...(bg.agentStore !== undefined ? { store: bg.agentStore, policyFloor: spawnPolicyFloor() } : {}),
2532
2582
  abort,
2533
2583
  });
2534
2584
  }
@@ -2551,6 +2601,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2551
2601
  }
2552
2602
  if (forkEntryGate.key !== undefined)
2553
2603
  chargeDelegationEntryHandle(bg.registry, forkEntryGate.key, bg.agentStore, taskId);
2604
+ oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
2554
2605
  childInternals.peerSelfRef?.addAxis("h", taskId);
2555
2606
  bg.registry.bindBackgroundAgentSession(taskId, forkedId);
2556
2607
  const forkBgHangAt = Date.now();
@@ -2725,11 +2776,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2725
2776
  const completionIdFork = bg.registry.getCompletionId(taskId);
2726
2777
  const stillbornFork = child.terminal.kind === "failed" && child.terminal.code === "resume.session_not_found";
2727
2778
  if (stillbornFork) {
2728
- try {
2729
- await (releaseForked ? releaseForked() : opts.runner.sessions.release?.(forkedId));
2730
- }
2731
- catch {
2732
- }
2779
+ await releaseBoundChildSession({ registry: bg.registry, taskId }, forkedId, () => (releaseForked ? releaseForked() : opts.runner.sessions.release?.(forkedId)));
2733
2780
  }
2734
2781
  const residualFork = residualFields();
2735
2782
  const resumableFork = false;
@@ -2740,6 +2787,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2740
2787
  ? `Agent "${shortDesc}" failed: ${failReasonFork}${ccElapsedTag(forkElapsedMs)}`.slice(0, 300) + errorKindClause(errClassFork)
2741
2788
  : `${ccCompletionText(shortDesc, settledBg, childFace.status, forkElapsedMs)}`;
2742
2789
  const ownsTerminalFacesFork = bg.registry.claimAgentTerminalNotify(taskId);
2790
+ const forkResultField = await completionResultField(forkBgResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report));
2791
+ if (forkResultField?.ref !== undefined)
2792
+ bg.registry.recordArtifactRef(taskId, forkResultField.ref, 0);
2743
2793
  const forkFrame = {
2744
2794
  task_id: taskId,
2745
2795
  task_type: "background_agent",
@@ -2752,7 +2802,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2752
2802
  ...(settledBg === "failed" && errCodeFork !== undefined ? { errorCode: errCodeFork } : {}),
2753
2803
  ...providerFaultField(child),
2754
2804
  ...(child.sessionId ? { sessionId: child.sessionId } : {}),
2755
- ...(forkBgResult ? { result: notifyResultField(forkBgResult) } : {}),
2805
+ ...(forkResultField !== undefined ? { result: forkResultField.text } : {}),
2756
2806
  ...(settledBg === "killed" && child.result ? { partial: true } : {}),
2757
2807
  ...residualFork,
2758
2808
  resumable: resumableFork,
@@ -2814,7 +2864,6 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2814
2864
  taskId,
2815
2865
  workingLine: `The forked agent inherits your full current context and works on its prompt in the background.`,
2816
2866
  notify: Boolean(notify),
2817
- oneShot: ctx.oneShot === true,
2818
2867
  notes: [
2819
2868
  modelNote,
2820
2869
  extraToolsNote,
@@ -2938,7 +2987,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2938
2987
  if (ctx.checkpointStoreForChildren !== undefined && ctx.checkpointStoreForChildren !== "disabled" && bg.checkpointStore !== undefined && bg.checkpointStore !== ctx.checkpointStoreForChildren)
2939
2988
  throw configError("background.checkpointStore is not the store this run's children park in (the host's resolved checkpoint seat, TaskSpec/RunnerDeps.checkpointStore) — wire the one store, or leave the option unset and let the seat ride.", "config.invalid_checkpoint_store");
2940
2989
  const childParkStore = ctx.checkpointStoreForChildren === undefined ? bg.checkpointStore : ctx.checkpointStoreForChildren === "disabled" ? undefined : ctx.checkpointStoreForChildren;
2941
- const notify = ctx.onTaskNotification ?? bg.notify;
2990
+ const notify = resolveCompletionSink(ctx.onTaskNotification, bg.notify);
2942
2991
  const abort = new AbortController();
2943
2992
  const reviveRow = reviveClaim?.row;
2944
2993
  const parkedResume = reviveClaim?.parkedResume;
@@ -3008,16 +3057,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3008
3057
  }
3009
3058
  if (!settled) {
3010
3059
  const detail = childThrownText(lastErr);
3011
- try {
3012
- enqueueMemoryAnnouncement(settlementSeat.controlDir, {
3013
- kind: "gate",
3014
- at: Date.now(),
3015
- items: [`delegation settlement: the terminal observation for a background delegation of session ${JSON.stringify(settlementSeat.sessionId)} could NOT be recorded (verdict ${verdict}) — the row stays pending and expires as UNPROVEN at the settlement window (fail-closed floor): ${detail.slice(0, 200)}`],
3016
- });
3017
- }
3018
- catch {
3019
- console.warn(`[sema] delegation settlement terminal write failed (verdict ${verdict}, session ${settlementSeat.sessionId}): ${detail} — the pending row expires as unproven at the settlement window`);
3020
- }
3060
+ console.warn(`[sema] delegation settlement terminal write failed (verdict ${verdict}, session ${settlementSeat.sessionId}): ${detail} — the pending row expires as unproven at the settlement window`);
3021
3061
  }
3022
3062
  };
3023
3063
  let taskId;
@@ -3071,7 +3111,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3071
3111
  deliveryChannel: "attaching",
3072
3112
  toolUseId: ctx.toolCallId,
3073
3113
  ...(ctx.crossBoundaryTreeForChildren !== undefined ? { crossBoundaryTree: ctx.crossBoundaryTreeForChildren } : {}),
3074
- ...(bg.agentStore !== undefined ? { store: bg.agentStore } : {}),
3114
+ ...(bg.agentStore !== undefined ? { store: bg.agentStore, policyFloor: spawnPolicyFloor() } : {}),
3075
3115
  abort,
3076
3116
  });
3077
3117
  }
@@ -3090,6 +3130,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3090
3130
  }
3091
3131
  if (capLedgerKey !== undefined)
3092
3132
  chargeDelegationEntryHandle(bg.registry, capLedgerKey, bg.agentStore, reviveRow === undefined ? taskId : undefined);
3133
+ oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
3093
3134
  childInternals.peerSelfRef?.addAxis("h", taskId);
3094
3135
  if (agentName !== undefined) {
3095
3136
  recordRosterSpawn(ctx.roster, { name: agentName, agentId: taskId, toolUseId: ctx.toolCallId, owner: bgOwner, scope: bgScope, ...(reviveRow !== undefined ? (reviveRow.model !== undefined ? { model: reviveRow.model } : {}) : rowModelKey !== undefined ? { model: rowModelKey } : {}), ...(modelFallback !== undefined ? { modelFallback } : {}), ...(reviveRow !== undefined ? ((reviveRow.rootSessionId ?? reviveRow.parentSessionId) !== undefined ? { rootSessionId: reviveRow.rootSessionId ?? reviveRow.parentSessionId } : {}) : (ctx.rootSessionId ?? ctx.sessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? ctx.sessionId } : {}), ...(sessionScopedBg ? { sessionScoped: true } : {}), createdAt: reviveRow?.spawnedAt ?? Date.now() }, (err) => opts.onObserverError?.(err, { site: "roster.recordSpawn" }));
@@ -3164,7 +3205,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3164
3205
  : ctx.subagentRetain;
3165
3206
  if (sessionScopedBg && bgRetainLedger)
3166
3207
  ensureSessionReapHook(bg.registry);
3167
- const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe, () => bg.registry.releaseDurableTranscriptAnchor(taskId), {
3208
+ const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe, { registry: bg.registry, taskId }, {
3168
3209
  delegationTaskType: "background_agent",
3169
3210
  });
3170
3211
  if (bgRetain) {
@@ -3175,6 +3216,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3175
3216
  await origRelease();
3176
3217
  };
3177
3218
  }
3219
+ bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId);
3178
3220
  const forwardDurableApproval = ctx.durableApprovalForChildren !== undefined &&
3179
3221
  bg.agentStore !== undefined &&
3180
3222
  childParkStore !== undefined &&
@@ -3299,6 +3341,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3299
3341
  ? `parked resume failed — the approval is no longer redeemable: ${msg}`
3300
3342
  : `parked resume did not proceed (${disp}): ${msg}`, { cause: e });
3301
3343
  };
3344
+ if (floorRefusal !== undefined)
3345
+ return rollbackAndThrow(Object.assign(new Error(`the agent was not resumed: ${inlineUntrusted(floorRefusal, 400)}, so the restrictions it ran under cannot be held on a new cycle`), { code: "revive.policy_floor_unreadable" }));
3302
3346
  try {
3303
3347
  await opts.runner.sessions.acquire(bgChildSessionId, { requireExisting: true });
3304
3348
  if (opts.runner.sessions.forget)
@@ -3539,12 +3583,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3539
3583
  }) ??
3540
3584
  (abort.signal.aborted ? "killed" : ok ? "completed" : "failed");
3541
3585
  if (!bgRetain && reviveRow === undefined && !(await bgRowConfirmed())) {
3542
- try {
3543
- await opts.runner.sessions.release(child.sessionId);
3544
- bg.registry.releaseDurableTranscriptAnchor(taskId);
3545
- }
3546
- catch {
3547
- }
3586
+ await releaseBoundChildSession({ registry: bg.registry, taskId }, child.sessionId, () => opts.runner.sessions.release(child.sessionId));
3548
3587
  }
3549
3588
  const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
3550
3589
  const completionIdBg = bg.registry.getCompletionId(taskId);
@@ -3565,6 +3604,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3565
3604
  ? `Agent "${shortDesc}" failed: ${failReasonBg}${ccElapsedTag(bgElapsedMs)}${observerNote}`.slice(0, 300) + errorKindClause(errClassBg)
3566
3605
  : `${ccCompletionText(shortDesc, settled, childFace.status, bgElapsedMs)}${observerNote}`;
3567
3606
  const ownsTerminalFaces = bg.registry.claimAgentTerminalNotify(taskId);
3607
+ const bgResultField = await completionResultField(bgHandbackResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report));
3608
+ if (bgResultField?.ref !== undefined)
3609
+ bg.registry.recordArtifactRef(taskId, bgResultField.ref, 0);
3568
3610
  const completionFrame = {
3569
3611
  task_id: taskId,
3570
3612
  task_type: "background_agent",
@@ -3578,7 +3620,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3578
3620
  ...(settled === "failed" && errCodeBg !== undefined ? { errorCode: errCodeBg } : {}),
3579
3621
  ...providerFaultField(child),
3580
3622
  ...(child.sessionId ? { sessionId: child.sessionId } : {}),
3581
- ...(bgHandbackResult ? { result: notifyResultField(bgHandbackResult) } : {}),
3623
+ ...(bgResultField !== undefined ? { result: bgResultField.text } : {}),
3582
3624
  ...(settled === "killed" && child.result ? { partial: true } : {}),
3583
3625
  ...residual,
3584
3626
  resumable: resumableBg,
@@ -3632,12 +3674,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3632
3674
  ...(errClassBgReject !== undefined ? { retryable: errClassBgReject.retryable, errorKind: errClassBgReject.errorKind } : {}),
3633
3675
  }) ?? (killed ? "killed" : "failed");
3634
3676
  if (!bgRetain && reviveRow === undefined && !(await bgRowConfirmed())) {
3635
- try {
3636
- await opts.runner.sessions.release(bgChildSessionId);
3637
- bg.registry.releaseDurableTranscriptAnchor(taskId);
3638
- }
3639
- catch {
3640
- }
3677
+ await releaseBoundChildSession({ registry: bg.registry, taskId }, bgChildSessionId, () => opts.runner.sessions.release(bgChildSessionId));
3641
3678
  }
3642
3679
  const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
3643
3680
  const completionIdBgReject = bg.registry.getCompletionId(taskId);
@@ -3697,7 +3734,6 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3697
3734
  taskId,
3698
3735
  workingLine: `The agent is working in the background.`,
3699
3736
  notify: Boolean(notify),
3700
- oneShot: ctx.oneShot === true,
3701
3737
  notes: [
3702
3738
  modelNote,
3703
3739
  extraToolsNote,
@@ -3744,9 +3780,11 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3744
3780
  ...(opts.background?.notify ? { notify: opts.background.notify } : {}),
3745
3781
  sink: ctx.onSubagentSpawn,
3746
3782
  ...(opts.background ? { registry: opts.background.registry } : {}),
3783
+ entryGate: syncEntryGate,
3747
3784
  ...(opts.onObserverError !== undefined ? { onNotifyError: (f) => opts.onObserverError?.(f.error, { site: f.site }) } : {}),
3748
3785
  ...(ctx.onQuestion !== undefined ? { currentOnQuestion: ctx.onQuestion } : {}),
3749
3786
  ...(ctx.autoModeReview !== undefined ? { currentAutoModeReview: ctx.autoModeReview } : {}),
3787
+ currentMcpHostSeats: ctx.mountedMcp?.().hostSeats,
3750
3788
  });
3751
3789
  notifier.notify(() => ctx.onSubagentSpawn?.(createSteerHandle(stream, ctx.toolCallId, childAgentName, settled, {
3752
3790
  resume,