@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
@@ -2,6 +2,7 @@ import { Type } from "typebox";
2
2
  import { isAbsolute } from "node:path";
3
3
  import { backgroundChildTerminal } from "../core/delegation-frames.js";
4
4
  import { bindDelegationName } from "../core/delegation-name.js";
5
+ import { authoredSteerOf } from "../core/input-author.js";
5
6
  import { principalNameOf } from "../core/principal-name.js";
6
7
  import { resumeRefusalDetailOf, resumeStartupCauseOf } from "../core/resume-startup-cause.js";
7
8
  import { errorCodeOf, thrownFailureOf } from "../core/runner/terminal-account.js";
@@ -21,8 +22,9 @@ import { childModelSeat, childThinkingSeat, deploymentStatesSubagentModel, deplo
21
22
  export { childThinkingSeat, deploymentSubagentThinking, deploymentSubagentTierModel } from "./child-model-seat.js";
22
23
  import { REPORT_BLOCKED_TOOL_NAME } from "../core/runner/synthetic-tools.js";
23
24
  import { TOOL_SEARCH_NAME } from "../core/runner/tool-disclosure.js";
24
- import { OFFLOAD_TOOL_NAME } from "../core/tool-result-store.js";
25
- import { compileToolSelector, delegationListWhere, namesEveryTool, snapshotDefinitionLists, toolListsDigest, toolNameAllowed, toolNameListFlaw } from "./tool-filter.js";
25
+ import { OFFLOAD_TOOL_NAME, persistTaskArtifact } from "../core/tool-result-store.js";
26
+ import { compileToolSelector, delegationListWhere, namesEveryTool, toolListsDigest, toolNameAllowed, toolNameListFlaw } from "./tool-filter.js";
27
+ import { snapshotDefinitionLists } from "./agent-definition.js";
26
28
  import { readToolNameList, snapshotToolNameList } from "../core/tool-name-list.js";
27
29
  import { EXTRA_TOOL_NAMES_CODE, delegationPoolFace, extraToolNamesError, firstUndeclaredExtraTool, readExtraToolNames } from "./extra-tool-names.js";
28
30
  import { builtinAgentDefinitions } from "./builtin-agents.js";
@@ -34,6 +36,7 @@ import { hasSessionFork } from "../core/session.js";
34
36
  import { isDurablePause, pauseFamily } from "./suspend-guard.js";
35
37
  import { childRejection, childTerminalFace, childThrownText } from "./child-failure.js";
36
38
  import { forwardSafely } from "../core/runner/forward-sink.js";
39
+ import { legTaskIdOf } from "../core/leg-identity.js";
37
40
  import { delimitUntrusted, inlineUntrusted } from "../core/untrusted-text.js";
38
41
  import { createSafeNotifier } from "../core/safe-notify.js";
39
42
  import { boundedRedactedSummary } from "../core/untrusted-egress.js";
@@ -44,7 +47,7 @@ import { BG_AGENT_REAP_STOP_ERROR, chosenAgentName } from "../core/task-registry
44
47
  import { readDurableOrgAdmission } from "../core/memory-admission.js";
45
48
  import { governanceRetryClass } from "../core/governance-codes.js";
46
49
  import { readSkillGrantCapture } from "../core/skill-grant.js";
47
- import { notifyResultField, terminalFrameFacets } from "../core/task-notification.js";
50
+ import { admitsBackgroundLaunch, completionResultField, oweTerminalDelivery, resolveCompletionSink, terminalFrameFacets } from "../core/task-notification.js";
48
51
  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";
49
52
  function rollupDelegatedCost(stats, nested) {
50
53
  if (stats.costMicroUsd === undefined)
@@ -71,15 +74,16 @@ function providerFaultField(child) {
71
74
  };
72
75
  }
73
76
  export { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX };
74
- import { SUBAGENT_RESUME_CAP, SubagentRetainLedger, getOrCreateSessionRetainLedger, ensureSessionReapHook, createResumePrompt, } from "./retain-ledger.js";
77
+ import { SUBAGENT_RESUME_CAP, SubagentRetainLedger, getOrCreateSessionRetainLedger, ensureSessionReapHook, createResumePrompt, holdChildDeclarations, } from "./retain-ledger.js";
75
78
  import { createPeerInboundChainRef, createPeerSelfRef } from "./peer-admission.js";
76
79
  import { recordRosterSpawn } from "./roster-store.js";
77
80
  import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "./launch-receipt-contract.js";
78
81
  import { ObserverDigestTap, ObserverPairing, createObserverReportToolSpec, markObserverTaskId, unmarkObserverTaskId, isObserverTaskId, ObserverResumeStateError, ObserverStoppedByUserError, observerFramingPrompt, observerSlug, resolveObserverDeclaration, } from "./observer.js";
79
- import { SubagentStepRecorder } from "./subagent-steps.js";
82
+ import { SubagentStepRecorder, redactThenCut } from "./subagent-steps.js";
83
+ import { childOwnerKeys, parkCompletionNotify, runningBackgroundUnder } from "./subagent-completion-gate.js";
80
84
  import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
81
85
  import { canonicalNameValue } from "../core/permission-rule-model.js";
82
- import { inheritedChildPool, inheritedMcpDeclarations } from "./inherited-tool-pool.js";
86
+ import { definitionAllowTools, inheritedChildPool, inheritedHostSeats, inheritedMcpDeclarations, withDefinitionServers, withoutWakerSeats } from "./inherited-tool-pool.js";
83
87
  import { readMember, thrownText } from "../core/thrown-value.js";
84
88
  const BG_AGENT_RESULT_MAX = 4_000;
85
89
  const BG_AGENT_RESULT_FULL_MAX = 200_000;
@@ -288,11 +292,12 @@ const isolationUnavailable = (content) => notStartedResult({
288
292
  content,
289
293
  details: { error: "isolation.unavailable" },
290
294
  });
291
- export function createSubagentWorktreeHelper(baseEnv, repoRoot) {
295
+ export function createSubagentWorktreeHelper(baseEnv, repoRoot, parentFloor) {
292
296
  const handles = new Map();
297
+ const readFloorNow = () => { const readFloor = parentFloor(); return readFloor !== undefined ? { readFloor } : {}; };
293
298
  return {
294
299
  async mint(childId) {
295
- const probe = await baseEnv.exec("git rev-parse --is-inside-work-tree", { cwd: repoRoot });
300
+ const probe = await baseEnv.exec("git rev-parse --is-inside-work-tree", { cwd: repoRoot, ...readFloorNow() });
296
301
  if (!probe.ok || probe.value.exitCode !== 0) {
297
302
  const detail = probe.ok ? (probe.value.stderr || probe.value.stdout).trim().split("\n")[0] : thrownText(probe.error);
298
303
  throw Object.assign(new Error(`the working directory ${repoRoot} is not a git repository${detail ? ` (${detail})` : ""}`), { code: WORKTREE_NOT_A_REPOSITORY });
@@ -300,13 +305,14 @@ export function createSubagentWorktreeHelper(baseEnv, repoRoot) {
300
305
  const { env, worktreeDir } = await addWorktree(baseEnv, {
301
306
  repoRoot,
302
307
  sessionId: childId,
308
+ readFloor: parentFloor,
303
309
  rootEnvAt: (dir) => Object.create(baseEnv, {
304
310
  cwd: { value: dir, configurable: true },
305
311
  destroy: { value: undefined, writable: true, configurable: true },
306
312
  }),
307
313
  });
308
- const baseSha = await baseEnv
309
- .exec("git rev-parse HEAD", { cwd: worktreeDir })
314
+ const baseSha = await Promise.resolve()
315
+ .then(() => baseEnv.exec("git rev-parse HEAD", { cwd: worktreeDir, ...readFloorNow() }))
310
316
  .then((r) => (r.ok && r.value.exitCode === 0 ? r.value.stdout.trim() : undefined))
311
317
  .catch(() => undefined);
312
318
  handles.set(worktreeDir, { destroy: () => env.destroy(), baseSha });
@@ -316,13 +322,18 @@ export function createSubagentWorktreeHelper(baseEnv, repoRoot) {
316
322
  const handle = handles.get(worktreeDir);
317
323
  handles.delete(worktreeDir);
318
324
  let changed = true;
319
- const status = await baseEnv.exec("git status --porcelain", { cwd: worktreeDir });
320
- if (status.ok && status.value.exitCode === 0 && handle?.baseSha !== undefined) {
321
- const dirtyFiles = status.value.stdout.split("\n").filter((l) => l.trim() !== "").length;
322
- const ahead = await baseEnv.exec(`git rev-list --count ${shellQuote(`${handle.baseSha}..HEAD`)}`, { cwd: worktreeDir });
323
- const commits = ahead.ok && ahead.value.exitCode === 0 ? parseInt(ahead.value.stdout.trim(), 10) || 0 : -1;
324
- if (commits >= 0)
325
- changed = dirtyFiles > 0 || commits > 0;
325
+ try {
326
+ const status = await baseEnv.exec("git status --porcelain", { cwd: worktreeDir, ...readFloorNow() });
327
+ if (status.ok && status.value.exitCode === 0 && handle?.baseSha !== undefined) {
328
+ const dirtyFiles = status.value.stdout.split("\n").filter((l) => l.trim() !== "").length;
329
+ const ahead = await baseEnv.exec(`git rev-list --count ${shellQuote(`${handle.baseSha}..HEAD`)}`, { cwd: worktreeDir, ...readFloorNow() });
330
+ const commits = ahead.ok && ahead.value.exitCode === 0 ? parseInt(ahead.value.stdout.trim(), 10) || 0 : -1;
331
+ if (commits >= 0)
332
+ changed = dirtyFiles > 0 || commits > 0;
333
+ }
334
+ }
335
+ catch {
336
+ return "kept";
326
337
  }
327
338
  if (changed)
328
339
  return "kept";
@@ -343,6 +354,7 @@ const ccElapsedTag = (ms) => {
343
354
  };
344
355
  const ccCompletionText = (desc, settled, rawStatus, elapsedMs) => `Agent "${desc}" ${settled === "killed" ? "stopped" : settled === "completed" ? "finished" : rawStatus}${ccElapsedTag(elapsedMs)}`;
345
356
  const SYNC_ESCAPE_SENTENCE = "Pass `run_in_background: false` for a synchronous run when you need the result before continuing (a named agent always runs in the background).";
357
+ export const AGENT_RAN_SYNC_NO_CHANNEL_NOTE = "note: this agent ran synchronously — no completion would come back from a background agent on this mount, so the background lane is not used here.";
346
358
  function continuationSentence(toolName, durableRevival, forkOffered) {
347
359
  return (`Where the SendMessage tool is mounted, use it with the agent's ID or name to message a RUNNING agent, or — when session retention${durableRevival ? " or durable named-agent revival" : ""} is enabled — ` +
348
360
  `to continue a COMPLETED one with its context intact; a new ${toolName} call starts fresh${forkOffered ? ` (except subagent_type: "${FORK_SUBAGENT_TYPE}", which inherits your context)` : ""}.`);
@@ -485,6 +497,9 @@ function createBgActivityBeat(parentToolCallId, emitTick, noteActivity) {
485
497
  emitTick(starts);
486
498
  };
487
499
  }
500
+ function backgroundLegFacts(taskId, cycleSeq) {
501
+ return { delegationTaskType: "background_agent", rowTaskId: taskId, ...(cycleSeq !== undefined ? { cycleSeq } : {}) };
502
+ }
488
503
  export function markerFragment() {
489
504
  return uuidv7().replace(/-/g, "").slice(-12);
490
505
  }
@@ -516,7 +531,7 @@ export function createSubagentResume(deps) {
516
531
  assertNoRetiredKeys(deps, RETIRED_RESUME_CLAMP_KEYS, "createSubagentResume");
517
532
  assertClampRecord(deps.currentClamps, "createSubagentResume currentClamps");
518
533
  const notifier = createSafeNotifier(deps.onNotifyError !== undefined ? { onError: deps.onNotifyError } : undefined);
519
- const resumeAs = (peerOrigin) => async (content) => {
534
+ const resumeAs = (by) => async (content) => {
520
535
  const ledger = deps.ledger;
521
536
  if (!ledger) {
522
537
  throw configError("resume unavailable: the parent run did not enable TaskSpec.retainSubagentSessions.", "resume.retain_off");
@@ -541,8 +556,9 @@ export function createSubagentResume(deps) {
541
556
  entry.running = true;
542
557
  const abort = new AbortController();
543
558
  entry.activeAbort = abort;
559
+ const wakeTaskId = legTaskIdOf(entry.specSnapshot, entry.internalsSnapshot, entry.childSessionId);
544
560
  const resumeStepRecorder = new SubagentStepRecorder(deps.parentToolCallId);
545
- resumeStepRecorder.lockTo(entry.childSessionId);
561
+ resumeStepRecorder.lockTo(wakeTaskId);
546
562
  const resumeResidual = () => {
547
563
  const recentSteps = resumeStepRecorder.recentSteps();
548
564
  const editedFiles = resumeStepRecorder.editedFiles();
@@ -552,6 +568,7 @@ export function createSubagentResume(deps) {
552
568
  let stream;
553
569
  let reviveCycle;
554
570
  let reviveEmit;
571
+ let releaseCycleSlot = noopRelease;
555
572
  let marker;
556
573
  let reviveStartedAt = Date.now();
557
574
  try {
@@ -576,7 +593,7 @@ export function createSubagentResume(deps) {
576
593
  const wakeClamps = foldClampSources(entry.specSnapshot, deps.currentClamps);
577
594
  const resumeSpec = applyClampSeats({
578
595
  ...entry.specSnapshot,
579
- objective: createResumePrompt(marker, content, peerOrigin !== undefined ? "peer" : "operator"),
596
+ objective: createResumePrompt(marker, content, by.author),
580
597
  sessionId: entry.childSessionId,
581
598
  requireExistingSession: true,
582
599
  ...(deps.currentOnQuestion !== undefined ? { onQuestion: deps.currentOnQuestion } : {}),
@@ -644,15 +661,18 @@ export function createSubagentResume(deps) {
644
661
  sessionId: entry.childSessionId,
645
662
  ...(deps.parentToolCallId !== undefined ? { parentToolCallId: deps.parentToolCallId } : {}),
646
663
  seq: entry.cycleSeq,
647
- progressTaskId: entry.childSessionId,
664
+ progressTaskId: wakeTaskId,
648
665
  ...(currentAction !== undefined ? { currentAction } : {}),
649
666
  ...(currentTool !== undefined ? { currentTool } : {}),
650
667
  usage: { toolUses: toolStarts },
651
668
  });
652
669
  }, deps.registry !== undefined && deps.taskId !== undefined ? () => deps.registry.noteBackgroundAgentActivity(deps.taskId) : undefined);
670
+ releaseCycleSlot = deps.entryGate?.occupy(reviveCycle !== undefined ? "registered" : "local") ?? noopRelease;
653
671
  stream = childRunner.runTaskStream(resumeSpec, undefined, {
654
672
  ...entry.internalsSnapshot,
655
- ...(peerOrigin === undefined ? { operatorObjective: true } : {}),
673
+ ...inheritedHostSeats(deps.currentMcpHostSeats, resumeSpec.mcp ?? []),
674
+ ...(deps.currentPlacementTarget !== undefined ? { placementTarget: deps.currentPlacementTarget } : {}),
675
+ objectiveAuthor: by.author,
656
676
  cycleSeq: entry.cycleSeq,
657
677
  parentInteractionPosture: postureUnderClamps(entry.internalsSnapshot.parentInteractionPosture, { interactiveTools: resumeSpec.interactiveTools, approvalReach: resumeSpec.approvalReach }),
658
678
  ...(true
@@ -683,7 +703,7 @@ export function createSubagentResume(deps) {
683
703
  ...(deps.currentParentNotify !== undefined
684
704
  ? { parentNotify: deps.currentParentNotify, parentPeerRef: deps.currentParentPeerRef }
685
705
  : {}),
686
- peerInboundChainRef: createPeerInboundChainRef(peerOrigin?.hopChain),
706
+ peerInboundChainRef: createPeerInboundChainRef(by.author === "peer" ? by.hopChain : undefined),
687
707
  ...(reviveCycle !== undefined
688
708
  ? {
689
709
  onNotifyInjectorReady: (inject) => {
@@ -707,12 +727,15 @@ export function createSubagentResume(deps) {
707
727
  catch (err) {
708
728
  entry.running = false;
709
729
  entry.activeAbort = undefined;
730
+ releaseCycleSlot();
710
731
  throw err;
711
732
  }
712
733
  if (entry.deferredNotify !== undefined) {
713
- entry.deferredNotify.cancel();
734
+ const parked = entry.deferredNotify;
714
735
  entry.deferredNotify = undefined;
736
+ notifier.notify(() => parked.cancel(), "subagent.resume.park_cancel");
715
737
  }
738
+ oweTerminalDelivery(deps.notify, { task_id: wakeTaskId, task_type: "background_agent" });
716
739
  let settleResolve;
717
740
  const settled = new Promise((r) => {
718
741
  settleResolve = r;
@@ -737,6 +760,7 @@ export function createSubagentResume(deps) {
737
760
  const resumeHandbackResult = withHandbackWarning(resumeHandbackWarning, child.result);
738
761
  const errCodeRevive = status === "failed" ? childFace.errorCode : undefined;
739
762
  const errClassRevive = status === "failed" ? classifySubagentError({ kind: "failed", ...(childFace.errorCode !== undefined ? { code: childFace.errorCode } : {}) }) : undefined;
763
+ let completionIdRevive;
740
764
  if (reviveCycle !== undefined && deps.registry !== undefined && deps.taskId !== undefined) {
741
765
  try {
742
766
  const winner = deps.registry.settleRevivedAgent(deps.taskId, reviveCycle, {
@@ -746,14 +770,15 @@ export function createSubagentResume(deps) {
746
770
  ...(errCodeRevive !== undefined ? { errorCode: errCodeRevive } : {}),
747
771
  ...(errClassRevive !== undefined ? { retryable: errClassRevive.retryable, errorKind: errClassRevive.errorKind } : {}),
748
772
  });
749
- if (winner !== undefined)
773
+ if (winner !== undefined) {
750
774
  status = winner;
775
+ completionIdRevive = deps.registry.getCompletionId(deps.taskId);
776
+ }
751
777
  }
752
778
  catch {
753
779
  }
754
780
  }
755
781
  const stoppedByRevive = status === "killed" ? deps.registry?.getStopAttribution(deps.taskId ?? "") ?? "system" : undefined;
756
- const completionIdRevive = deps.registry?.getCompletionId(deps.taskId ?? "");
757
782
  const reviveName = deps.rowDescription ?? `sub-agent ${marker}`;
758
783
  const failReasonRevive = status === "failed" ? childFace.errorMessage : undefined;
759
784
  const reviveElapsedMs = Date.now() - reviveStartedAt;
@@ -771,8 +796,12 @@ export function createSubagentResume(deps) {
771
796
  named: deps.rowName !== undefined,
772
797
  });
773
798
  const ownsTerminalFacesRevive = deps.registry !== undefined && deps.taskId !== undefined ? deps.registry.claimAgentTerminalNotify(deps.taskId) : true;
799
+ const resumeResultField = await completionResultField(resumeHandbackResult, (report) => persistTaskArtifact(deps.currentTaskArtifacts, wakeTaskId, report), (ref) => {
800
+ if (deps.taskId !== undefined)
801
+ deps.registry?.recordArtifactRef(deps.taskId, ref, completionIdRevive);
802
+ }, notifier);
774
803
  const resumeFrame = {
775
- task_id: deps.taskId ?? entry.childSessionId,
804
+ task_id: wakeTaskId,
776
805
  ...(entry.childSessionId !== undefined ? { sessionId: entry.childSessionId } : {}),
777
806
  task_type: "background_agent",
778
807
  toolUseId: deps.parentToolCallId,
@@ -784,7 +813,7 @@ export function createSubagentResume(deps) {
784
813
  ...(failReasonRevive !== undefined ? { error: failReasonRevive.slice(0, REPORT_FIELD_MAX) } : {}),
785
814
  ...(status === "failed" && errCodeRevive !== undefined ? { errorCode: errCodeRevive } : {}),
786
815
  ...providerFaultField(child),
787
- ...(resumeHandbackResult ? { result: notifyResultField(resumeHandbackResult) } : {}),
816
+ ...(resumeResultField !== undefined ? { result: resumeResultField.text } : {}),
788
817
  ...(status === "killed" && child.result ? { partial: true } : {}),
789
818
  ...resumeResidual(),
790
819
  resumable: resumableRevive,
@@ -793,15 +822,15 @@ export function createSubagentResume(deps) {
793
822
  };
794
823
  if (ownsTerminalFacesRevive)
795
824
  reviveEmit?.(backgroundChildTerminal(resumeFrame, { taskId: deps.taskId, sessionScoped: deps.sessionScoped === true, sessionId: entry.childSessionId, transcriptId: entry.childSessionId, ...(deps.parentToolCallId !== undefined ? { parentToolCallId: deps.parentToolCallId } : {}) }));
796
- const gateOwner = ownsTerminalFacesRevive && status === "completed" && deps.notify !== undefined && deps.registry !== undefined && ledger.get(deps.parentToolCallId) === entry
797
- ? entry.childSessionId
798
- : undefined;
799
- const aliveBgCount = gateOwner !== undefined ? deps.registry.countRunningBackgroundForOwner(gateOwner) : 0;
800
- if (gateOwner !== undefined && aliveBgCount > 0) {
825
+ const gateOwners = ownsTerminalFacesRevive && status === "completed" && deps.notify !== undefined && deps.registry !== undefined && ledger.get(deps.parentToolCallId) === entry
826
+ ? childOwnerKeys(child.taskId, entry.childSessionId)
827
+ : [];
828
+ const aliveBgCount = deps.registry !== undefined ? runningBackgroundUnder(deps.registry, gateOwners) : 0;
829
+ if (aliveBgCount > 0) {
801
830
  parkCompletionNotify({
802
831
  registry: deps.registry,
803
832
  entry,
804
- owner: gateOwner,
833
+ owners: gateOwners,
805
834
  pendingCount: aliveBgCount,
806
835
  payload: resumeFrame,
807
836
  notify: deps.notify,
@@ -819,24 +848,26 @@ export function createSubagentResume(deps) {
819
848
  const msgRevive = childThrownText(e);
820
849
  const errCodeReviveReject = abort.signal.aborted ? undefined : thrownErrorCode(e);
821
850
  const errClassReviveReject = abort.signal.aborted ? undefined : classifySubagentError({ kind: "failed", ...(errCodeReviveReject !== undefined ? { code: errCodeReviveReject } : {}) });
851
+ let completionIdRejectRevive;
822
852
  if (reviveCycle !== undefined && deps.registry !== undefined && deps.taskId !== undefined) {
823
853
  try {
824
- deps.registry.settleRevivedAgent(deps.taskId, reviveCycle, {
854
+ const winnerReject = deps.registry.settleRevivedAgent(deps.taskId, reviveCycle, {
825
855
  status: abort.signal.aborted ? "killed" : "failed",
826
856
  error: msgRevive.slice(0, 500),
827
857
  ...(errCodeReviveReject !== undefined ? { errorCode: errCodeReviveReject } : {}),
828
858
  ...(errClassReviveReject !== undefined ? { retryable: errClassReviveReject.retryable, errorKind: errClassReviveReject.errorKind } : {}),
829
859
  });
860
+ if (winnerReject !== undefined)
861
+ completionIdRejectRevive = deps.registry.getCompletionId(deps.taskId);
830
862
  }
831
863
  catch {
832
864
  }
833
865
  }
834
866
  const stoppedByReject = abort.signal.aborted ? deps.registry?.getStopAttribution(deps.taskId ?? "") ?? "system" : undefined;
835
- const completionIdRejectRevive = deps.registry?.getCompletionId(deps.taskId ?? "");
836
867
  const rejectName = deps.rowDescription ?? `sub-agent ${marker}`;
837
868
  const ownsTerminalFacesReviveReject = deps.registry !== undefined && deps.taskId !== undefined ? deps.registry.claimAgentTerminalNotify(deps.taskId) : true;
838
869
  const reviveRejectFrame = {
839
- task_id: deps.taskId ?? entry.childSessionId,
870
+ task_id: wakeTaskId,
840
871
  ...(entry.childSessionId !== undefined ? { sessionId: entry.childSessionId } : {}),
841
872
  task_type: "background_agent",
842
873
  toolUseId: deps.parentToolCallId,
@@ -860,6 +891,7 @@ export function createSubagentResume(deps) {
860
891
  finally {
861
892
  entry.running = false;
862
893
  entry.activeAbort = undefined;
894
+ releaseCycleSlot();
863
895
  entry.settledAt = Date.now();
864
896
  ledger.markSettled(deps.parentToolCallId);
865
897
  settleResolve();
@@ -867,38 +899,8 @@ export function createSubagentResume(deps) {
867
899
  })();
868
900
  return marker;
869
901
  };
870
- const operatorResume = resumeAs(undefined);
871
- return deps.peerOrigin === undefined ? operatorResume : resumeAs(deps.peerOrigin);
872
- }
873
- function parkCompletionNotify(deps) {
874
- const { registry, entry, owner, pendingCount, payload, notify } = deps;
875
- let done = false;
876
- const deliver = (decorated) => {
877
- if (done)
878
- return;
879
- done = true;
880
- unsubscribe();
881
- if (entry.deferredNotify?.cancel === cancel)
882
- entry.deferredNotify = undefined;
883
- try {
884
- notify(decorated
885
- ? {
886
- ...payload,
887
- summary: `${payload.summary} (delivered after ${pendingCount} background ${pendingCount === 1 ? "child" : "children"} settled)`,
888
- }
889
- : payload, { priority: "next" });
890
- }
891
- catch {
892
- }
893
- };
894
- const unsubscribe = registry.onBackgroundQuiescence(owner, (reason) => deliver(reason === "quiescent"));
895
- const cancel = () => {
896
- if (done)
897
- return;
898
- done = true;
899
- unsubscribe();
900
- };
901
- entry.deferredNotify = { ...(payload.seq !== undefined ? { seq: payload.seq } : {}), cancel, flush: () => deliver(false) };
902
+ const operatorResume = resumeAs({ author: "operator" });
903
+ return deps.peerOrigin === undefined ? operatorResume : resumeAs({ author: "peer", hopChain: deps.peerOrigin.hopChain });
902
904
  }
903
905
  export function resolveDelegationEntryCaps(caps) {
904
906
  const bad = (member, value) => {
@@ -1109,15 +1111,24 @@ async function untilAbort(p, signal) {
1109
1111
  signal.removeEventListener("abort", onAbort);
1110
1112
  }
1111
1113
  }
1114
+ const delegationPoolKey = (scope, root) => JSON.stringify([scope, root]);
1115
+ function delegationEntryPool(seat) {
1116
+ if (seat.root === undefined)
1117
+ return { key: undefined, occupy: () => noopRelease };
1118
+ const key = delegationPoolKey(seat.scope ?? DELEGATION_POOL_DEFAULT_SCOPE, seat.root);
1119
+ return { key, occupy: (kind) => (kind === "local" ? chargeLocalDelegationInFlight(seat.poolAnchor, key) : noopRelease) };
1120
+ }
1112
1121
  async function openDelegationEntryGate(input) {
1113
- const { poolAnchor, registry, store, root, caps, revival, signal } = input;
1122
+ const { poolAnchor, registry, store, root, caps, signal } = input;
1123
+ const pool = delegationEntryPool(input);
1114
1124
  if (root === undefined)
1115
- return { key: undefined, admit: () => ({ admitted: true, release: noopRelease }) };
1125
+ return { ...pool, admit: () => ({ admitted: true, release: noopRelease }) };
1116
1126
  const scope = input.scope ?? DELEGATION_POOL_DEFAULT_SCOPE;
1117
- const key = JSON.stringify([scope, root]);
1127
+ const key = delegationPoolKey(scope, root);
1128
+ const { occupy } = pool;
1118
1129
  let storedHandles = [];
1119
1130
  let storedEnumerationOk = false;
1120
- if (store !== undefined && !revival) {
1131
+ if (store !== undefined) {
1121
1132
  try {
1122
1133
  storedHandles = (await untilAbort(store.listBySession(scope, root), signal)).map((r) => r.handle);
1123
1134
  storedEnumerationOk = true;
@@ -1140,42 +1151,40 @@ async function openDelegationEntryGate(input) {
1140
1151
  },
1141
1152
  };
1142
1153
  }
1143
- if (!revival) {
1144
- const ledger = delegationEntryLedger(poolAnchor, key);
1145
- let retained;
1146
- if (store !== undefined && storedEnumerationOk) {
1147
- const keep = new Set([...storedHandles, ...active]);
1148
- if (kind === "registered") {
1149
- for (const h of [...ledger])
1150
- if (!keep.has(h))
1151
- ledger.delete(h);
1152
- retained = new Set([...storedHandles, ...ledger]).size;
1153
- }
1154
- else {
1155
- const survivors = new Set(storedHandles);
1156
- for (const h of ledger)
1157
- if (keep.has(h))
1158
- survivors.add(h);
1159
- retained = survivors.size;
1160
- }
1154
+ const ledger = delegationEntryLedger(poolAnchor, key);
1155
+ let retained;
1156
+ if (store !== undefined && storedEnumerationOk) {
1157
+ const keep = new Set([...storedHandles, ...active]);
1158
+ if (kind === "registered") {
1159
+ for (const h of [...ledger])
1160
+ if (!keep.has(h))
1161
+ ledger.delete(h);
1162
+ retained = new Set([...storedHandles, ...ledger]).size;
1161
1163
  }
1162
1164
  else {
1163
- retained = ledger.size;
1164
- }
1165
- const cumulative = retained + local;
1166
- if (cumulative >= caps.maxCumulativePerSession) {
1167
- return {
1168
- admitted: false,
1169
- refusal: {
1170
- code: "delegation.session_cap",
1171
- text: `this session tree has already launched ${cumulative} agents in its retained window — the cumulative cap (${caps.maxCumulativePerSession}; RunnerDeps.delegationEntryCaps.maxCumulativePerSession) refuses more. Continue an existing agent (SendMessage) instead of launching new ones.`,
1172
- },
1173
- };
1165
+ const survivors = new Set(storedHandles);
1166
+ for (const h of ledger)
1167
+ if (keep.has(h))
1168
+ survivors.add(h);
1169
+ retained = survivors.size;
1174
1170
  }
1175
1171
  }
1176
- return { admitted: true, release: kind === "local" ? chargeLocalDelegationInFlight(poolAnchor, key) : noopRelease };
1172
+ else {
1173
+ retained = ledger.size;
1174
+ }
1175
+ const cumulative = retained + local;
1176
+ if (cumulative >= caps.maxCumulativePerSession) {
1177
+ return {
1178
+ admitted: false,
1179
+ refusal: {
1180
+ code: "delegation.session_cap",
1181
+ text: `this session tree has already launched ${cumulative} agents in its retained window — the cumulative cap (${caps.maxCumulativePerSession}; RunnerDeps.delegationEntryCaps.maxCumulativePerSession) refuses more. Continue an existing agent (SendMessage) instead of launching new ones.`,
1182
+ },
1183
+ };
1184
+ }
1185
+ return { admitted: true, release: occupy(kind) };
1177
1186
  };
1178
- return { key, admit };
1187
+ return { key, admit, occupy };
1179
1188
  }
1180
1189
  function chargeDelegationEntryHandle(registry, key, store, handle) {
1181
1190
  if (handle !== undefined)
@@ -1184,6 +1193,16 @@ function chargeDelegationEntryHandle(registry, key, store, handle) {
1184
1193
  armDelegationLedgerLifecycle(registry);
1185
1194
  sweepDelegationLedgerRound(registry, 3);
1186
1195
  }
1196
+ async function releaseBoundChildSession(bound, sessionId, release) {
1197
+ try {
1198
+ await release();
1199
+ }
1200
+ catch {
1201
+ return false;
1202
+ }
1203
+ bound?.registry.releaseDurableTranscriptAnchor(bound.taskId, sessionId);
1204
+ return true;
1205
+ }
1187
1206
  export { normalizeSubagentType } from "../core/permission-rule-model.js";
1188
1207
  function canonicalSubagentTypeArgs(args, accepted, generalPurposeShadowed) {
1189
1208
  if (args === null || typeof args !== "object" || Array.isArray(args))
@@ -1246,20 +1265,11 @@ export function forkWorktreeTranslationNote(parentCwd, worktreeDir) {
1246
1265
  }
1247
1266
  export function asyncLaunchedReceipt(p) {
1248
1267
  const noteLines = (p.notes ?? []).filter((n) => n !== undefined && n !== "");
1249
- const oneShotBlocked = p.notify && p.oneShot === true;
1250
1268
  return (`Async agent launched successfully. (${launchReceiptNoQuoteClause(", including the task_id below,")})\n` +
1251
1269
  `task_id: ${p.taskId} (internal ID - do not mention to user. ${launchContinuationSentence(p.taskId)})\n` +
1252
- (oneShotBlocked
1253
- ? `${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`
1254
- : p.notify
1255
- ? `${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`
1256
- : `${p.workingLine} Its result is NOT pushed automatically — retrieve progress and results with TaskOutput(task_id) where mounted.\n`) +
1270
+ `${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` +
1257
1271
  noteLines.map((n) => `${n}\n`).join("") +
1258
- (oneShotBlocked
1259
- ? `${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.`
1260
- : p.notify
1261
- ? `${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.`
1262
- : `${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.`));
1272
+ `${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.`);
1263
1273
  }
1264
1274
  function runnerModelCatalog(runner) {
1265
1275
  try {
@@ -1387,10 +1397,11 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1387
1397
  const depthPermitsNesting = depth + 1 < maxDepth;
1388
1398
  const agentToolFaces = [
1389
1399
  ...(generalPurposeShadowed ? [] : [{ name: GENERAL_PURPOSE_SUBAGENT_TYPE, ...(depthPermitsNesting ? { canRedelegate: true } : {}) }]),
1390
- ...available.map((a) => ({
1400
+ ...available.map((a) => ({ a, allow: definitionAllowTools(a) })).map(({ a, allow }) => ({
1391
1401
  name: a.name,
1392
- ...(a.allowTools !== undefined ? { allowTools: a.allowTools } : {}),
1402
+ ...(allow !== undefined ? { allowTools: allow } : {}),
1393
1403
  ...(a.denyTools !== undefined ? { denyTools: a.denyTools } : {}),
1404
+ ...(a.mcp !== undefined && a.mcp.length > 0 ? { servers: a.mcp.map((s) => ({ name: s.name, ...(s.contentOrigin !== undefined ? { contentOrigin: s.contentOrigin } : {}) })) } : {}),
1394
1405
  ...(depthPermitsNesting && toolNameAllowed(delegationToolName, a.allowTools, a.denyTools) ? { canRedelegate: true } : {}),
1395
1406
  ...(depth === 0 && !builtins.includes(a) ? { authored: true } : {}),
1396
1407
  })),
@@ -1428,7 +1439,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1428
1439
  : `- Each agent type's model, thinking level, and tools come from its agent definition.\n`) +
1429
1440
  `- \`isolation: "worktree"\` gives the agent its own git worktree (auto-cleaned if unchanged).` +
1430
1441
  (opts.background
1431
- ? `\n- Subagents run in the background by default${opts.background.notify ? "; you'll be notified when one completes" : "; the receipt's task_id retrieves progress and results via the TaskOutput tool where mounted"}. ${SYNC_ESCAPE_SENTENCE} Never fabricate or predict a pending agent's results — ${opts.background.notify ? "the notification is never something you write yourself; " : ""}if the user asks before it arrives, say it's still running.\n` +
1442
+ ? `\n- Subagents run in the background by default; you'll be notified when one completes. ${SYNC_ESCAPE_SENTENCE} Never fabricate or predict a pending agent's results — the notification is never something you write yourself; if the user asks before it arrives, say it's still running.\n` +
1432
1443
  `- ${continuationSentence(opts.name ?? DEFAULT_SUBAGENT_TOOL_NAME, opts.background.agentStore !== undefined, forkOffered)}`
1433
1444
  : `\n- \`run_in_background\` is unavailable here — only synchronous subagents.`),
1434
1445
  descriptionVariants: [{ id: "classic", traits: { noneOf: ["lean_prompt"] }, text: `Launch a new agent. Delegate a self-contained subtask to an isolated sub-agent and get back a single report. ` +
@@ -1457,11 +1468,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1457
1468
  `\nSet isolation: "worktree" to give the agent its own detached git worktree (auto-removed if it made no changes; kept for you to inspect/merge when it did).` +
1458
1469
  (opts.background
1459
1470
  ?
1460
- (opts.background.notify
1461
- ? `\n\nAgents run in the background by default. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead. ${SYNC_ESCAPE_SENTENCE}`
1462
- : `\n\nAgents run in the background by default. A background agent's result is not pushed automatically — the launch receipt's task_id retrieves progress and results via the TaskOutput tool where mounted. ${SYNC_ESCAPE_SENTENCE}`) +
1471
+ `\n\nAgents run in the background by default. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead. ${SYNC_ESCAPE_SENTENCE}` +
1463
1472
  ` ${continuationSentence(opts.name ?? DEFAULT_SUBAGENT_TOOL_NAME, opts.background.agentStore !== undefined, forkOffered)}` +
1464
- `\n\n**Don't race.** After launching, you know nothing about what the agent found. Never fabricate or predict agent results in any format — not as prose, summary, or structured output. ${opts.background.notify ? "The notification arrives as a user-role message in a later turn; it is never something you write yourself." : "The result exists only when you retrieve it; it is never something you write yourself."}`
1473
+ `\n\n**Don't race.** After launching, you know nothing about what the agent found. Never fabricate or predict agent results in any format — not as prose, summary, or structured output. The notification arrives as a user-role message in a later turn; it is never something you write yourself.`
1465
1474
  : `\n\nThe run_in_background parameter is not available in this context. Only synchronous subagents are supported.`) }],
1466
1475
  parameters: Type.Object({
1467
1476
  subagent_type: Type.Optional(Type.String({ description: "The type of specialized agent to use for this task" })),
@@ -1488,9 +1497,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1488
1497
  ...(opts.background
1489
1498
  ? {
1490
1499
  run_in_background: Type.Optional(Type.Boolean({
1491
- description: opts.background.notify
1492
- ? "Agents run in the background by default; you will be notified when one completes. Set to false to run this agent synchronously when you need its result before continuing (a named agent always runs in the background)."
1493
- : "Agents run in the background by default; the launch receipt's task_id retrieves progress and results via the TaskOutput tool where mounted. Set to false to run this agent synchronously when you need its result before continuing (a named agent always runs in the background).",
1500
+ description: "Agents run in the background by default; you will be notified when one completes. Set to false to run this agent synchronously when you need its result before continuing (a named agent always runs in the background).",
1494
1501
  })),
1495
1502
  }
1496
1503
  : {}),
@@ -1504,10 +1511,12 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1504
1511
  const a = canonicalSubagentTypeArgs(args, acceptedSubagentTypes(), generalPurposeShadowed);
1505
1512
  const parentSpecSeat = parentSpecSeatOfCtx(ctx);
1506
1513
  const reviveClaim = ctx.reviveClaim;
1507
- if (reviveClaim !== undefined && opts.background === undefined) {
1514
+ const backgroundSink = opts.background !== undefined ? resolveCompletionSink(ctx.onTaskNotification, opts.background.notify) : undefined;
1515
+ const backgroundLane = opts.background !== undefined && admitsBackgroundLaunch(backgroundSink);
1516
+ if (reviveClaim !== undefined && !backgroundLane) {
1508
1517
  return notStartedResult({
1509
1518
  isError: true,
1510
- content: "Sub-agent not revived: this delegation tool has no background surface (run_in_background is not available here), and a revival is a background run by definition.",
1519
+ content: "Sub-agent not revived: no background lane is available here (this delegation tool has no background surface, or no completion would come back from a background agent on this mount), and a revival is a background run by definition.",
1511
1520
  details: { error: "revive.no_background" },
1512
1521
  });
1513
1522
  }
@@ -1565,7 +1574,14 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1565
1574
  });
1566
1575
  }
1567
1576
  }
1568
- const wantsBackground = opts.background !== undefined && (a.run_in_background !== false || def?.background === true || agentName !== undefined);
1577
+ const backgroundAsked = opts.background !== undefined && (a.run_in_background !== false || def?.background === true || agentName !== undefined);
1578
+ const wantsBackground = backgroundLane && backgroundAsked;
1579
+ const ranSyncNote = backgroundAsked && !backgroundLane ? AGENT_RAN_SYNC_NO_CHANNEL_NOTE : undefined;
1580
+ const stations = reviveClaim === undefined ? ctx.agentStations : undefined;
1581
+ const extensionSpawn = stations?.extensionSpawn(ctx.toolCallId);
1582
+ if (extensionSpawn !== undefined && !wantsBackground) {
1583
+ return notStartedResult({ isError: true, content: `Sub-agent not started: an extension's spawn runs in the background, and this one would hold the foreground (${backgroundLane ? "the call as it was let go asks to run in the foreground" : "this delegation tool has no background lane here"}).`, details: { error: "mods.spawn_foreground" } });
1584
+ }
1569
1585
  if (a.cwd !== undefined && typeof a.cwd !== "string") {
1570
1586
  return notStartedResult({ isError: true, content: "Sub-agent not started: cwd must be an absolute path string.", details: { error: "cwd.relative" } });
1571
1587
  }
@@ -1726,6 +1742,29 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1726
1742
  details: { error: "skill_grants.unreadable" },
1727
1743
  });
1728
1744
  }
1745
+ if (extensionSpawn === undefined && stations?.listens("agent.offer") === true) {
1746
+ const listed = agentListing.find((entry) => entry.name === spawnAgentType);
1747
+ const offered = await stations.offered([{ name: spawnAgentType, description: listed?.description ?? "" }], ctx.signal);
1748
+ if (offered.length === 0) {
1749
+ 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" } });
1750
+ }
1751
+ }
1752
+ if (stations?.listens("agent.spawn") === true) {
1753
+ const verdict = await stations.spawn({
1754
+ toolCallId: ctx.toolCallId,
1755
+ prompt,
1756
+ description: typeof a.description === "string" ? a.description : "",
1757
+ subagentType: spawnAgentType,
1758
+ ...(spawnModel !== undefined ? { model: spawnModel } : {}),
1759
+ ...(ctx.model?.id !== undefined ? { parentModel: ctx.model.id } : {}),
1760
+ background: wantsBackground,
1761
+ fork: wantsFork,
1762
+ ...(agentName !== undefined ? { name: agentName } : {}),
1763
+ ...(childCwd !== undefined ? { cwd: childCwd } : {}),
1764
+ }, ctx.signal);
1765
+ if (!verdict.go)
1766
+ return notStartedResult({ isError: true, content: `Sub-agent not started: ${verdict.reason.slice(0, 600)}`, details: { error: "mods.spawn_refused", refusedBy: verdict.by } });
1767
+ }
1729
1768
  let worktreeDir;
1730
1769
  if (reviveClaim === undefined && (a.isolation ?? def?.isolation) === "worktree") {
1731
1770
  const iso = ctx.worktreeIsolation;
@@ -1848,13 +1887,14 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1848
1887
  }
1849
1888
  childPool = [...(opts.tools ?? inherited.filter((t) => ![t.name, ...(t.aliases ?? [])].some((n) => taken.has(n)))), ...accepted];
1850
1889
  }
1851
- const governingLists = def !== undefined ? { allow: def.allowTools, deny: def.denyTools } : { allow: opts.allowTools, deny: opts.denyTools };
1890
+ const governingLists = def !== undefined ? { allow: definitionAllowTools(def), deny: def.denyTools } : { allow: opts.allowTools, deny: opts.denyTools };
1852
1891
  const childOwnLayer = Object.freeze({ ...(governingLists.allow != null ? { allow: Object.freeze([...governingLists.allow]) } : {}), deny: Object.freeze([...(governingLists.deny ?? [])]) });
1853
1892
  const childListsDigest = toolListsDigest(childOwnLayer.allow, childOwnLayer.deny);
1854
1893
  const childListsJudged = agentToolPool !== undefined ? childListsDigest : undefined;
1855
1894
  const childCeiling = ctx.toolSelector?.layers ?? [];
1856
- const parentMcp = opts.tools === undefined && extraToolsNote === undefined ? ctx.mountedMcp?.() : undefined;
1857
- const childMcp = parentMcp !== undefined ? inheritedMcpDeclarations(parentMcp, compileToolSelector([...childCeiling, childOwnLayer])) : undefined;
1895
+ const mountedMcpNow = ctx.mountedMcp?.();
1896
+ const parentMcp = opts.tools === undefined && extraToolsNote === undefined ? mountedMcpNow : undefined;
1897
+ const childMcp = withDefinitionServers(parentMcp !== undefined ? inheritedMcpDeclarations(parentMcp, compileToolSelector([...childCeiling, childOwnLayer])) : undefined, def?.mcp);
1858
1898
  const childTools = [...childPool];
1859
1899
  const childRoleBase = roleBaseOf([def !== undefined ? { systemPrompt: def.systemPrompt } : undefined, { promptRole: opts.promptRole, systemPrompt: opts.systemPrompt }]);
1860
1900
  const childSystemPrompt = childRoleBase?.systemPrompt;
@@ -1903,13 +1943,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1903
1943
  pendingTrigger = [];
1904
1944
  return joined;
1905
1945
  };
1906
- const injectObservedRequest = async (text, origin) => {
1946
+ const injectObservedRequest = async (text, author) => {
1907
1947
  const steer = observedSteerRef.steer;
1908
1948
  if (!steer)
1909
1949
  throw new Error("observed child has no steer lane (report undeliverable)");
1910
- if (origin !== "observer")
1950
+ if (author !== "observer")
1911
1951
  pendingTrigger.push(text);
1912
- await steer(text);
1952
+ await steer(author, text);
1913
1953
  };
1914
1954
  if (observerArm) {
1915
1955
  pendingTrigger.push(prompt);
@@ -1960,7 +2000,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1960
2000
  ...(parentGate.shellGate !== undefined ? { shellGate: parentGate.shellGate } : {}),
1961
2001
  admittedOrgScopes: parentGate.admittedOrgScopes,
1962
2002
  };
1963
- const observerInternals = { ...(ctx.interactionPosture !== undefined ? { parentInteractionPosture: ctx.interactionPosture } : {}), ...(pickedRef !== undefined ? { inheritedModelRef: pickedRef } : {}), ...(observerGate !== undefined ? { inheritedGate: observerGate } : {}), toolCeiling: [...childCeiling, childOwnLayer], observerLeg: true };
2003
+ const observerInternals = { ...(ctx.interactionPosture !== undefined ? { parentInteractionPosture: ctx.interactionPosture } : {}), ...(pickedRef !== undefined ? { inheritedModelRef: pickedRef } : {}), ...(observerGate !== undefined ? { inheritedGate: observerGate } : {}), toolCeiling: [...childCeiling, childOwnLayer], observerLeg: true, objectiveAuthor: "observer" };
1964
2004
  const r = await opts.runner.runTask(spec, observerInternals);
1965
2005
  if (r.terminal.kind !== "completed") {
1966
2006
  const endedFace = childTerminalFace(r.terminal);
@@ -2102,16 +2142,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2102
2142
  const entryCapRoot = reviveClaim !== undefined
2103
2143
  ? (reviveClaim.row.rootSessionId ?? reviveClaim.row.parentSessionId ?? (reviveClaim.row.sessionScoped ? reviveClaim.row.owner : undefined))
2104
2144
  : (ctx.rootSessionId ?? ctx.sessionId);
2105
- const openEntryGate = () => openDelegationEntryGate({
2106
- poolAnchor: entryCapPoolAnchor,
2107
- registry: opts.background?.registry,
2108
- store: opts.background?.agentStore,
2109
- scope: treeScope,
2110
- root: entryCapRoot,
2111
- caps: entryCaps,
2112
- revival: reviveClaim !== undefined,
2113
- signal: ctx.signal,
2114
- });
2145
+ const entryPoolSeat = { poolAnchor: entryCapPoolAnchor, scope: treeScope, root: entryCapRoot };
2146
+ const openEntryGate = () => openDelegationEntryGate({ ...entryPoolSeat, registry: opts.background?.registry, store: opts.background?.agentStore, caps: entryCaps, signal: ctx.signal });
2115
2147
  const provenanceRequest = ctx.delegationProvenanceForChildren?.();
2116
2148
  const childProvenanceRef = provenanceRequest !== undefined ? { current: newDelegationProvenanceAggregate() } : undefined;
2117
2149
  const childAttestation = (completed) => childProvenanceRef !== undefined ? reduceDelegationAttestation(childProvenanceRef.current, { completed }) : undefined;
@@ -2123,7 +2155,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2123
2155
  const childInternals = {
2124
2156
  ...(ctx.toolSelector !== undefined ? { toolCeiling: childCeiling, ...(childListsJudged !== undefined ? { toolListsJudged: childListsJudged } : {}) } : {}),
2125
2157
  ...(childListsDigest !== undefined ? { ownToolLists: { toolName, ...(def !== undefined ? { definition: def.name } : {}), lists: childListsDigest } } : {}),
2126
- ...(parentMcp?.pool !== undefined && childMcp !== undefined && childMcp.length > 0 ? { mcpPool: parentMcp.pool } : {}),
2158
+ ...(mountedMcpNow?.pool !== undefined && childMcp.length > 0 ? { mcpPool: mountedMcpNow.pool } : {}),
2159
+ ...inheritedHostSeats(mountedMcpNow?.hostSeats, childMcp),
2127
2160
  ...(childPick.modelRef !== undefined ? { inheritedModelRef: childPick.modelRef } : {}),
2128
2161
  ...(inheritedSkillGrants.length > 0 ? { inheritedSkillGrants } : {}),
2129
2162
  ...(inheritedAllowedTools !== undefined && inheritedAllowedTools.length > 0 ? { inheritedAllowedTools: [...inheritedAllowedTools] } : {}),
@@ -2143,6 +2176,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2143
2176
  peerInboundChainRef: createPeerInboundChainRef(reviveClaim?.peerSeed?.hopChain),
2144
2177
  ...(childDefaultPersona !== undefined ? { defaultSystemPrompt: childDefaultPersona } : {}),
2145
2178
  isDelegatedChild: true,
2179
+ objectiveAuthor: reviveClaim !== undefined ? "peer" : "parent_model",
2146
2180
  ...(childPosture !== undefined ? { parentInteractionPosture: childPosture } : {}),
2147
2181
  ...(reviveClaim === undefined
2148
2182
  ? {
@@ -2187,6 +2221,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2187
2221
  ...(ctx.subagentRetain !== undefined ? { parentRetainLedger: ctx.subagentRetain } : {}),
2188
2222
  onForwardEvent: recordingForward,
2189
2223
  ...(ctx.parentCwd !== undefined ? { callerRoot: ctx.parentCwd } : {}),
2224
+ ...(ctx.placementTarget !== undefined ? { placementTarget: ctx.placementTarget } : {}),
2190
2225
  ...(worktreeDir !== undefined
2191
2226
  ? { parentCwd: worktreeDir, worktreeOffered: true, onWorkspaceResolved: (ws) => void (childPlacement = ws) }
2192
2227
  : childCwd !== undefined
@@ -2215,7 +2250,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2215
2250
  ...childSeat,
2216
2251
  ...childThinking,
2217
2252
  tools: childTools,
2218
- ...(childMcp !== undefined && childMcp.length > 0 ? { mcp: childMcp } : {}),
2253
+ ...(childMcp.length > 0 ? { mcp: childMcp } : {}),
2219
2254
  systemPrompt: childSystemPrompt,
2220
2255
  ...(childRoleBase?.promptRole !== undefined ? { promptRole: childRoleBase.promptRole } : {}),
2221
2256
  ...(def?.memory ? { memory: def.memory } : {}),
@@ -2236,14 +2271,27 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2236
2271
  signal,
2237
2272
  }, parentSpecSeat));
2238
2273
  const spawnPolicyFloor = () => clampSeatsOf(buildChildSpec(undefined));
2239
- const tryRetainChild = async (ledger, entryTtlMs, preMintedSessionId, durableProbe, releaseAnchor, internalsExtra) => {
2274
+ const tryRetainChild = async (ledger, entryTtlMs, preMintedSessionId, durableProbe, bound, internalsExtra) => {
2240
2275
  if (!ledger)
2241
2276
  return undefined;
2242
2277
  const childSessionId = preMintedSessionId ?? uuidv7();
2243
2278
  const retainStrip = stripSpawnTurnQuestionFace(buildChildSpec(undefined));
2244
2279
  const { signal: _spawnSignal, ...plainSpec } = retainStrip.spec;
2280
+ const launchesOnThisId = preMintedSessionId !== undefined;
2281
+ let releasing;
2282
+ const releaseEntry = () => (releasing ??= (async () => {
2283
+ try {
2284
+ await opts.runner.sessions.unpin?.(childSessionId);
2285
+ }
2286
+ catch {
2287
+ }
2288
+ if (durableProbe && (await durableProbe().catch(() => false)))
2289
+ return;
2290
+ await releaseBoundChildSession(bound, childSessionId, () => opts.runner.sessions.release(childSessionId));
2291
+ })());
2245
2292
  let entry = ledger.register(ctx.toolCallId, {
2246
2293
  childSessionId,
2294
+ declarations: holdChildDeclarations(opts.runner, plainSpec),
2247
2295
  runner: opts.runner,
2248
2296
  ...(entryTtlMs !== undefined ? { ttlMs: entryTtlMs } : {}),
2249
2297
  ...(childAgentName !== undefined ? { agentName: childAgentName } : {}),
@@ -2260,22 +2308,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2260
2308
  ...(plainSpec.alwaysLoadTools !== undefined ? { alwaysLoadTools: [...plainSpec.alwaysLoadTools] } : {}),
2261
2309
  ...(Array.isArray(plainSpec.restoreGatedTools) ? { restoreGatedTools: [...plainSpec.restoreGatedTools] } : {}),
2262
2310
  }),
2263
- internalsSnapshot: { ...childInternals, ...retainStrip.internalsFlag, ...(internalsExtra ?? {}) },
2264
- release: async () => {
2265
- try {
2266
- await opts.runner.sessions.unpin?.(childSessionId);
2267
- }
2268
- catch {
2269
- }
2270
- if (durableProbe && (await durableProbe().catch(() => false)))
2271
- return;
2272
- try {
2273
- await opts.runner.sessions.release(childSessionId);
2274
- releaseAnchor?.();
2275
- }
2276
- catch {
2277
- }
2278
- },
2311
+ internalsSnapshot: { ...withoutWakerSeats(childInternals), ...retainStrip.internalsFlag, ...(internalsExtra ?? {}) },
2312
+ release: releaseEntry,
2279
2313
  });
2280
2314
  if (entry) {
2281
2315
  try {
@@ -2283,21 +2317,20 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2283
2317
  }
2284
2318
  catch {
2285
2319
  await ledger.evict(ctx.toolCallId);
2320
+ if (launchesOnThisId)
2321
+ await releaseEntry();
2286
2322
  entry = undefined;
2287
2323
  }
2288
2324
  if (entry !== undefined && (ledger.disposed || ledger.get(ctx.toolCallId) !== entry)) {
2325
+ if (launchesOnThisId)
2326
+ await releaseEntry();
2289
2327
  try {
2290
2328
  await opts.runner.sessions.unpin?.(childSessionId);
2291
2329
  }
2292
2330
  catch {
2293
2331
  }
2294
2332
  if (!(durableProbe && (await durableProbe().catch(() => false)))) {
2295
- try {
2296
- await opts.runner.sessions.release(childSessionId);
2297
- releaseAnchor?.();
2298
- }
2299
- catch {
2300
- }
2333
+ await releaseBoundChildSession(bound, childSessionId, () => opts.runner.sessions.release(childSessionId));
2301
2334
  }
2302
2335
  entry = undefined;
2303
2336
  }
@@ -2327,6 +2360,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2327
2360
  const { signal: _spawnSignal, ...plainSpec } = failedRetainStrip.spec;
2328
2361
  const entry = ledger.register(ctx.toolCallId, {
2329
2362
  childSessionId,
2363
+ declarations: holdChildDeclarations(opts.runner, plainSpec),
2330
2364
  runner: opts.runner,
2331
2365
  ttlMs: FAILED_SESSION_RETAIN_TTL_MS,
2332
2366
  ...(childAgentName !== undefined ? { agentName: childAgentName } : {}),
@@ -2343,7 +2377,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2343
2377
  ...(plainSpec.alwaysLoadTools !== undefined ? { alwaysLoadTools: [...plainSpec.alwaysLoadTools] } : {}),
2344
2378
  ...(Array.isArray(plainSpec.restoreGatedTools) ? { restoreGatedTools: [...plainSpec.restoreGatedTools] } : {}),
2345
2379
  }),
2346
- internalsSnapshot: { ...childInternals, ...failedRetainStrip.internalsFlag },
2380
+ internalsSnapshot: { ...withoutWakerSeats(childInternals), ...failedRetainStrip.internalsFlag },
2347
2381
  release: releaseChild,
2348
2382
  });
2349
2383
  if (entry) {
@@ -2445,7 +2479,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2445
2479
  const forkObjective = `${FORK_DIRECTIVE_FRAME}${prompt}${forkWorktreeNote !== undefined ? `\n\n${forkWorktreeNote}` : ""}${parentSpecSeat?.advisorModel !== undefined ? `\n\n${ADVISOR_FORK_SENTENCE}` : ""}`;
2446
2480
  if (wantsBackground) {
2447
2481
  const bg = opts.background;
2448
- const notify = ctx.onTaskNotification ?? bg.notify;
2482
+ const notify = backgroundSink;
2449
2483
  const abort = new AbortController();
2450
2484
  const sessionScopedBg = ctx.backgroundScope === "session" && ctx.sessionId !== undefined;
2451
2485
  const onHostAbort = () => abort.abort();
@@ -2456,7 +2490,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2456
2490
  else if (!sessionScopedBg)
2457
2491
  ctx.signal.addEventListener("abort", onHostAbort, { once: true });
2458
2492
  }
2459
- const shortDesc = `fork: ${(typeof a.description === "string" && a.description.trim() ? a.description.trim() : prompt).slice(0, 180)}`;
2493
+ const shortDesc = `fork: ${redactThenCut(typeof a.description === "string" && a.description.trim() ? a.description.trim() : prompt, 180)}`;
2460
2494
  const bgOwner = sessionScopedBg ? ctx.sessionId : ctx.taskId ?? bg.owner;
2461
2495
  const bgScope = treeScope;
2462
2496
  const forkEntryGate = await openEntryGate();
@@ -2557,8 +2591,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2557
2591
  }
2558
2592
  if (forkEntryGate.key !== undefined)
2559
2593
  chargeDelegationEntryHandle(bg.registry, forkEntryGate.key, bg.agentStore, taskId);
2594
+ oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
2560
2595
  childInternals.peerSelfRef?.addAxis("h", taskId);
2561
2596
  bg.registry.bindBackgroundAgentSession(taskId, forkedId);
2597
+ stepRecorder.lockTo(taskId);
2562
2598
  const forkBgHangAt = Date.now();
2563
2599
  bg.registry.attachAgentTerminalNotifier(taskId, () => {
2564
2600
  const stoppedByReap = bg.registry.getStopAttribution(taskId) ?? "system";
@@ -2576,7 +2612,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2576
2612
  ...(completionIdReap !== undefined ? { completionId: completionIdReap } : {}),
2577
2613
  };
2578
2614
  sinkEmit(backgroundChildTerminal(reapFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: forkedId, transcriptId: forkedId, parentToolCallId: ctx.toolCallId, ...(seqReap !== undefined ? { generation: seqReap } : {}) }));
2579
- notifier.notify(() => notify?.(reapFrame, { priority: "next" }), "subagent.reapTerminalNotify");
2615
+ notifier.notify(() => notify(reapFrame, { priority: "next" }), "subagent.reapTerminalNotify");
2580
2616
  });
2581
2617
  if (agentName !== undefined) {
2582
2618
  recordRosterSpawn(ctx.roster, { name: agentName, agentId: taskId, sessionId: forkedId, toolUseId: ctx.toolCallId, owner: bgOwner, scope: bgScope, ...(rowModelKey !== undefined ? { model: rowModelKey } : {}), ...(modelFallback !== undefined ? { modelFallback } : {}), ...((ctx.rootSessionId ?? ctx.sessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? ctx.sessionId } : {}), ...(sessionScopedBg ? { sessionScoped: true } : {}), createdAt: Date.now() }, (err) => opts.onObserverError?.(err, { site: "roster.recordSpawn" }));
@@ -2626,7 +2662,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2626
2662
  transcriptId: forkedId,
2627
2663
  sessionId: forkedId,
2628
2664
  parentToolCallId: ctx.toolCallId,
2629
- progressTaskId: forkedId,
2665
+ progressTaskId: taskId,
2630
2666
  agentType: spawnAgentType,
2631
2667
  ...(spawnModel !== undefined ? { model: spawnModel } : {}),
2632
2668
  ...(bgForkCycleSeq !== undefined ? { seq: bgForkCycleSeq } : {}),
@@ -2640,8 +2676,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2640
2676
  ...forkInternals,
2641
2677
  ...(forkQuestionStrip !== undefined ? forkQuestionStrip.internalsFlag : {}),
2642
2678
  onNotifyInjectorReady: s2ForkNotifyReady,
2643
- delegationTaskType: "background_agent",
2644
- ...(bgForkCycleSeq !== undefined ? { cycleSeq: bgForkCycleSeq } : {}),
2679
+ ...backgroundLegFacts(taskId, bgForkCycleSeq),
2645
2680
  onForwardEvent: (e) => {
2646
2681
  try {
2647
2682
  recordingForward(e, { bgAgentId: taskId });
@@ -2676,8 +2711,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2676
2711
  ...forkInternals,
2677
2712
  ...(forkQuestionStrip !== undefined ? forkQuestionStrip.internalsFlag : {}),
2678
2713
  onNotifyInjectorReady: s2ForkNotifyReady,
2679
- delegationTaskType: "background_agent",
2680
- ...(bgForkCycleSeq !== undefined ? { cycleSeq: bgForkCycleSeq } : {}),
2714
+ ...backgroundLegFacts(taskId, bgForkCycleSeq),
2681
2715
  onForwardEvent: (e) => {
2682
2716
  try {
2683
2717
  recordingForward(e, { bgAgentId: taskId });
@@ -2687,8 +2721,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2687
2721
  bgForkActivityBeat(e);
2688
2722
  },
2689
2723
  };
2690
- void opts.runner
2691
- .runTask(bgForkSpec, bgForkInternals)
2724
+ const bgForkChild = opts.runner.runTask(bgForkSpec, bgForkInternals);
2725
+ extensionSpawn?.launched(taskId, spawnModel);
2726
+ void bgForkChild
2692
2727
  .then(async (child) => {
2693
2728
  const childFace = childTerminalFace(child.terminal);
2694
2729
  settleForkRow(child.terminal);
@@ -2719,23 +2754,20 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2719
2754
  const failedFork = !okBg && !reapedBg;
2720
2755
  const errCodeFork = failedFork ? childFace.errorCode : undefined;
2721
2756
  const errClassFork = failedFork ? classifySubagentError({ kind: "failed", ...(childFace.errorCode !== undefined ? { code: childFace.errorCode } : {}) }) : undefined;
2722
- const settledBg = bg.registry.settleBackgroundAgent(taskId, {
2757
+ const settleWinnerFork = bg.registry.settleBackgroundAgent(taskId, {
2723
2758
  cycle: 0,
2724
2759
  status: okBg ? "completed" : reapedBg ? "killed" : "failed",
2725
2760
  ...resultSettleFields(forkBgResult),
2726
2761
  ...(!okBg ? { error: reapedBg ? (collateralBg ? BG_AGENT_COLLATERAL_REAP_REASON : BG_AGENT_REAP_STOP_ERROR) : childFace.errorMessage ?? childFace.status } : {}),
2727
2762
  ...(errCodeFork !== undefined ? { errorCode: errCodeFork } : {}),
2728
2763
  ...(errClassFork !== undefined ? { retryable: errClassFork.retryable, errorKind: errClassFork.errorKind } : {}),
2729
- }) ?? (abort.signal.aborted ? "killed" : okBg ? "completed" : "failed");
2764
+ });
2765
+ const completionIdFork = settleWinnerFork !== undefined ? bg.registry.getCompletionId(taskId) : undefined;
2766
+ const settledBg = settleWinnerFork ?? (abort.signal.aborted ? "killed" : okBg ? "completed" : "failed");
2730
2767
  const stoppedByBg = settledBg === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
2731
- const completionIdFork = bg.registry.getCompletionId(taskId);
2732
2768
  const stillbornFork = child.terminal.kind === "failed" && child.terminal.code === "resume.session_not_found";
2733
2769
  if (stillbornFork) {
2734
- try {
2735
- await (releaseForked ? releaseForked() : opts.runner.sessions.release?.(forkedId));
2736
- }
2737
- catch {
2738
- }
2770
+ await releaseBoundChildSession({ registry: bg.registry, taskId }, forkedId, () => (releaseForked ? releaseForked() : opts.runner.sessions.release?.(forkedId)));
2739
2771
  }
2740
2772
  const residualFork = residualFields();
2741
2773
  const resumableFork = false;
@@ -2746,6 +2778,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2746
2778
  ? `Agent "${shortDesc}" failed: ${failReasonFork}${ccElapsedTag(forkElapsedMs)}`.slice(0, 300) + errorKindClause(errClassFork)
2747
2779
  : `${ccCompletionText(shortDesc, settledBg, childFace.status, forkElapsedMs)}`;
2748
2780
  const ownsTerminalFacesFork = bg.registry.claimAgentTerminalNotify(taskId);
2781
+ const forkResultField = await completionResultField(forkBgResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report), (ref) => bg.registry.recordArtifactRef(taskId, ref, completionIdFork), notifier);
2749
2782
  const forkFrame = {
2750
2783
  task_id: taskId,
2751
2784
  task_type: "background_agent",
@@ -2758,7 +2791,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2758
2791
  ...(settledBg === "failed" && errCodeFork !== undefined ? { errorCode: errCodeFork } : {}),
2759
2792
  ...providerFaultField(child),
2760
2793
  ...(child.sessionId ? { sessionId: child.sessionId } : {}),
2761
- ...(forkBgResult ? { result: notifyResultField(forkBgResult) } : {}),
2794
+ ...(forkResultField !== undefined ? { result: forkResultField.text } : {}),
2762
2795
  ...(settledBg === "killed" && child.result ? { partial: true } : {}),
2763
2796
  ...residualFork,
2764
2797
  resumable: resumableFork,
@@ -2769,7 +2802,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2769
2802
  sinkEmit(backgroundChildTerminal(forkFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: forkTranscriptId, ...(stillbornFork ? {} : { transcriptId: forkTranscriptId }), parentToolCallId: ctx.toolCallId, ...(bgForkCycleSeq !== undefined ? { generation: bgForkCycleSeq } : {}) }));
2770
2803
  try {
2771
2804
  if (ownsTerminalFacesFork)
2772
- notify?.(forkFrame, { priority: "next" });
2805
+ notify(forkFrame, { priority: "next" });
2773
2806
  }
2774
2807
  catch {
2775
2808
  }
@@ -2782,15 +2815,16 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2782
2815
  const msgFork = childThrownText(e);
2783
2816
  const errCodeForkReject = killed ? undefined : thrownErrorCode(e);
2784
2817
  const errClassForkReject = killed ? undefined : classifySubagentError({ kind: "failed", ...(errCodeForkReject !== undefined ? { code: errCodeForkReject } : {}) });
2785
- const settledBg = bg.registry.settleBackgroundAgent(taskId, {
2818
+ const settleWinnerForkReject = bg.registry.settleBackgroundAgent(taskId, {
2786
2819
  cycle: 0,
2787
2820
  status: killed ? "killed" : "failed",
2788
2821
  error: killed ? BG_AGENT_REAP_STOP_ERROR : msgFork,
2789
2822
  ...(errCodeForkReject !== undefined ? { errorCode: errCodeForkReject } : {}),
2790
2823
  ...(errClassForkReject !== undefined ? { retryable: errClassForkReject.retryable, errorKind: errClassForkReject.errorKind } : {}),
2791
- }) ?? (killed ? "killed" : "failed");
2824
+ });
2825
+ const completionIdForkReject = settleWinnerForkReject !== undefined ? bg.registry.getCompletionId(taskId) : undefined;
2826
+ const settledBg = settleWinnerForkReject ?? (killed ? "killed" : "failed");
2792
2827
  const stoppedByBg = settledBg === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
2793
- const completionIdForkReject = bg.registry.getCompletionId(taskId);
2794
2828
  const summaryBg = `${shortDesc} — ${settledBg === "failed" ? `failed: ${msgFork}` : settledBg}`.slice(0, 300) + (settledBg === "failed" ? errorKindClause(errClassForkReject) : "");
2795
2829
  const ownsTerminalFacesForkReject = bg.registry.claimAgentTerminalNotify(taskId);
2796
2830
  const forkRejectFrame = {
@@ -2810,7 +2844,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2810
2844
  sinkEmit(backgroundChildTerminal(forkRejectFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: forkedId, transcriptId: forkedId, parentToolCallId: ctx.toolCallId, ...(bgForkCycleSeq !== undefined ? { generation: bgForkCycleSeq } : {}) }));
2811
2845
  try {
2812
2846
  if (ownsTerminalFacesForkReject)
2813
- notify?.(forkRejectFrame, { priority: "next" });
2847
+ notify(forkRejectFrame, { priority: "next" });
2814
2848
  }
2815
2849
  catch {
2816
2850
  }
@@ -2819,8 +2853,6 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2819
2853
  content: asyncLaunchedReceipt({
2820
2854
  taskId,
2821
2855
  workingLine: `The forked agent inherits your full current context and works on its prompt in the background.`,
2822
- notify: Boolean(notify),
2823
- oneShot: ctx.oneShot === true,
2824
2856
  notes: [
2825
2857
  modelNote,
2826
2858
  extraToolsNote,
@@ -2835,9 +2867,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2835
2867
  details: { type: "agent", subagent_type: FORK_SUBAGENT_TYPE, status: "async_launched", isAsync: true, task_id: taskId, description: shortDesc, prompt, ...(forkSettleId !== undefined ? { settle_id: forkSettleId } : {}) },
2836
2868
  };
2837
2869
  }
2838
- const bgIgnoredNote = a.run_in_background === true
2839
- ? `note: run_in_background was ignored for subagent_type "${FORK_SUBAGENT_TYPE}" — the fork ran synchronously (this delegation tool has no background surface configured).`
2840
- : undefined;
2870
+ const bgIgnoredNote = ranSyncNote ??
2871
+ (a.run_in_background === true
2872
+ ? `note: run_in_background was ignored for subagent_type "${FORK_SUBAGENT_TYPE}" — the fork ran synchronously (this delegation tool has no background surface configured).`
2873
+ : undefined);
2841
2874
  const syncForkEntryGate = await openEntryGate();
2842
2875
  if (ctx.signal?.aborted) {
2843
2876
  try {
@@ -2944,7 +2977,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2944
2977
  if (ctx.checkpointStoreForChildren !== undefined && ctx.checkpointStoreForChildren !== "disabled" && bg.checkpointStore !== undefined && bg.checkpointStore !== ctx.checkpointStoreForChildren)
2945
2978
  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");
2946
2979
  const childParkStore = ctx.checkpointStoreForChildren === undefined ? bg.checkpointStore : ctx.checkpointStoreForChildren === "disabled" ? undefined : ctx.checkpointStoreForChildren;
2947
- const notify = ctx.onTaskNotification ?? bg.notify;
2980
+ const notify = backgroundSink;
2948
2981
  const abort = new AbortController();
2949
2982
  const reviveRow = reviveClaim?.row;
2950
2983
  const parkedResume = reviveClaim?.parkedResume;
@@ -2961,10 +2994,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2961
2994
  const shortDesc = reviveRow?.description ?? String(a.description ?? "sub-agent").slice(0, 200);
2962
2995
  const bgOwner = reviveRow !== undefined ? reviveRow.owner : sessionScopedBg ? ctx.sessionId : ctx.taskId ?? bg.owner;
2963
2996
  const bgScope = treeScope;
2964
- const bgEntryGate = await openEntryGate();
2965
- const capLedgerKey = bgEntryGate.key;
2966
- {
2967
- const admission = bgEntryGate.admit("registered");
2997
+ const bgEntryPool = delegationEntryPool(entryPoolSeat);
2998
+ const capLedgerKey = bgEntryPool.key;
2999
+ if (reviveRow !== undefined) {
3000
+ bgEntryPool.occupy("registered");
3001
+ }
3002
+ else {
3003
+ const admission = (await openEntryGate()).admit("registered");
2968
3004
  if (!admission.admitted) {
2969
3005
  dropHostAbortListener();
2970
3006
  await cancelObserver();
@@ -3087,6 +3123,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3087
3123
  }
3088
3124
  if (capLedgerKey !== undefined)
3089
3125
  chargeDelegationEntryHandle(bg.registry, capLedgerKey, bg.agentStore, reviveRow === undefined ? taskId : undefined);
3126
+ oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
3090
3127
  childInternals.peerSelfRef?.addAxis("h", taskId);
3091
3128
  if (agentName !== undefined) {
3092
3129
  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" }));
@@ -3101,7 +3138,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3101
3138
  };
3102
3139
  const bgChildSessionId = reviveRow?.sessionId ?? uuidv7();
3103
3140
  const bgStartedAt = Date.now();
3104
- stepRecorder.lockTo(bgChildSessionId);
3141
+ stepRecorder.lockTo(taskId);
3105
3142
  bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId);
3106
3143
  const bgCycleSeq = bg.registry.backgroundAgentCycleSeq(taskId);
3107
3144
  bg.registry.attachAgentTerminalNotifier(taskId, () => {
@@ -3121,7 +3158,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3121
3158
  ...(completionIdReap !== undefined ? { completionId: completionIdReap } : {}),
3122
3159
  };
3123
3160
  sinkEmit(backgroundChildTerminal(reapFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(seqReap !== undefined ? { generation: seqReap } : {}) }));
3124
- notifier.notify(() => notify?.(reapFrame, { priority: "next" }), "subagent.reapTerminalNotify");
3161
+ notifier.notify(() => notify(reapFrame, { priority: "next" }), "subagent.reapTerminalNotify");
3125
3162
  });
3126
3163
  const bgDurableProbe = bg.registry.durableAgentRowProbe(taskId);
3127
3164
  const bgRowConfirmed = async () => (bgDurableProbe ? await bgDurableProbe().catch(() => false) : false);
@@ -3161,9 +3198,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3161
3198
  : ctx.subagentRetain;
3162
3199
  if (sessionScopedBg && bgRetainLedger)
3163
3200
  ensureSessionReapHook(bg.registry);
3164
- const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe, () => bg.registry.releaseDurableTranscriptAnchor(taskId), {
3165
- delegationTaskType: "background_agent",
3166
- });
3201
+ const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe, { registry: bg.registry, taskId }, backgroundLegFacts(taskId));
3167
3202
  if (bgRetain) {
3168
3203
  bg.registry.markRetainedContinuation(taskId);
3169
3204
  const origRelease = bgRetain.release;
@@ -3172,6 +3207,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3172
3207
  await origRelease();
3173
3208
  };
3174
3209
  }
3210
+ bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId);
3175
3211
  const forwardDurableApproval = ctx.durableApprovalForChildren !== undefined &&
3176
3212
  bg.agentStore !== undefined &&
3177
3213
  childParkStore !== undefined &&
@@ -3205,7 +3241,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3205
3241
  transcriptId: bgChildSessionId,
3206
3242
  sessionId: bgChildSessionId,
3207
3243
  parentToolCallId: ctx.toolCallId,
3208
- progressTaskId: bgChildSessionId,
3244
+ progressTaskId: taskId,
3209
3245
  agentType: spawnAgentType,
3210
3246
  ...(spawnModel !== undefined ? { model: spawnModel } : {}),
3211
3247
  ...(bgCycleSeq !== undefined ? { seq: bgCycleSeq } : {}),
@@ -3231,8 +3267,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3231
3267
  ...(bgQuestionStrip !== undefined ? bgQuestionStrip.internalsFlag : {}),
3232
3268
  ...(bgPlacement !== undefined ? { sessionPlacement: bgPlacement } : {}),
3233
3269
  onNotifyInjectorReady: s2NotifyReady,
3234
- delegationTaskType: "background_agent",
3235
- ...(bgCycleSeq !== undefined ? { cycleSeq: bgCycleSeq } : {}),
3270
+ ...backgroundLegFacts(taskId, bgCycleSeq),
3236
3271
  onForwardEvent: (e) => {
3237
3272
  try {
3238
3273
  recordingForward(e, { bgAgentId: taskId });
@@ -3268,8 +3303,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3268
3303
  ...(bgQuestionStrip !== undefined ? bgQuestionStrip.internalsFlag : {}),
3269
3304
  ...(bgPlacement !== undefined ? { sessionPlacement: bgPlacement } : {}),
3270
3305
  onNotifyInjectorReady: s2NotifyReady,
3271
- delegationTaskType: "background_agent",
3272
- ...(bgCycleSeq !== undefined ? { cycleSeq: bgCycleSeq } : {}),
3306
+ ...backgroundLegFacts(taskId, bgCycleSeq),
3273
3307
  onForwardEvent: (e) => {
3274
3308
  try {
3275
3309
  recordingForward(e, { bgAgentId: taskId });
@@ -3375,7 +3409,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3375
3409
  ...(pr.inheritedGate !== undefined ? { inheritedGate: pr.inheritedGate } : {}),
3376
3410
  afterCheckpointResolve,
3377
3411
  });
3378
- observedSteerRef.steer = (t, o) => bgStream.steer(t, o);
3412
+ observedSteerRef.steer = authoredSteerOf(bgStream);
3379
3413
  for await (const ev of bgStream)
3380
3414
  observerTap?.record(ev);
3381
3415
  childResult = await bgStream.result();
@@ -3413,7 +3447,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3413
3447
  : observerPairing
3414
3448
  ? (() => {
3415
3449
  const bgStream = opts.runner.runTaskStream(bgSpec, undefined, bgInternals);
3416
- observedSteerRef.steer = (t, o) => bgStream.steer(t, o);
3450
+ observedSteerRef.steer = authoredSteerOf(bgStream);
3417
3451
  return (async () => {
3418
3452
  for await (const ev of bgStream)
3419
3453
  observerTap?.record(ev);
@@ -3421,6 +3455,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3421
3455
  })();
3422
3456
  })()
3423
3457
  : opts.runner.runTask(bgSpec, bgInternals);
3458
+ extensionSpawn?.launched(taskId, spawnModel);
3424
3459
  void bgChildPromise
3425
3460
  .then(async (child) => {
3426
3461
  const childFace = childTerminalFace(child.terminal);
@@ -3526,7 +3561,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3526
3561
  : childFace.errorCode
3527
3562
  : undefined;
3528
3563
  const errClassBg = failedBg ? classifySubagentError({ kind: "failed", ...(childFace.errorCode !== undefined ? { code: childFace.errorCode } : {}) }) : undefined;
3529
- const settled = bg.registry.settleBackgroundAgent(taskId, {
3564
+ const settleWinnerBg = bg.registry.settleBackgroundAgent(taskId, {
3530
3565
  cycle: 0,
3531
3566
  status: ok ? "completed" : reaped ? "killed" : "failed",
3532
3567
  seq: seqAtSettle ?? 1,
@@ -3535,18 +3570,14 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3535
3570
  ...(errCodeBg !== undefined ? { errorCode: errCodeBg } : {}),
3536
3571
  ...(errClassBg !== undefined ? { retryable: errClassBg.retryable, errorKind: errClassBg.errorKind } : {}),
3537
3572
  ...(failedBg && child.retryAfterMs !== undefined ? { retryAfterMs: child.retryAfterMs } : {}),
3538
- }) ??
3573
+ });
3574
+ const completionIdBg = settleWinnerBg !== undefined ? bg.registry.getCompletionId(taskId) : undefined;
3575
+ const settled = settleWinnerBg ??
3539
3576
  (abort.signal.aborted ? "killed" : ok ? "completed" : "failed");
3540
3577
  if (!bgRetain && reviveRow === undefined && !(await bgRowConfirmed())) {
3541
- try {
3542
- await opts.runner.sessions.release(child.sessionId);
3543
- bg.registry.releaseDurableTranscriptAnchor(taskId);
3544
- }
3545
- catch {
3546
- }
3578
+ await releaseBoundChildSession({ registry: bg.registry, taskId }, child.sessionId, () => opts.runner.sessions.release(child.sessionId));
3547
3579
  }
3548
3580
  const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
3549
- const completionIdBg = bg.registry.getCompletionId(taskId);
3550
3581
  const observerNote = observerNoteFor(await startBoundedObserverDrain());
3551
3582
  const residual = residualFields();
3552
3583
  const bgDurableRow = await bgRowConfirmed();
@@ -3564,6 +3595,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3564
3595
  ? `Agent "${shortDesc}" failed: ${failReasonBg}${ccElapsedTag(bgElapsedMs)}${observerNote}`.slice(0, 300) + errorKindClause(errClassBg)
3565
3596
  : `${ccCompletionText(shortDesc, settled, childFace.status, bgElapsedMs)}${observerNote}`;
3566
3597
  const ownsTerminalFaces = bg.registry.claimAgentTerminalNotify(taskId);
3598
+ const bgResultField = await completionResultField(bgHandbackResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report), (ref) => bg.registry.recordArtifactRef(taskId, ref, completionIdBg), notifier);
3567
3599
  const completionFrame = {
3568
3600
  task_id: taskId,
3569
3601
  task_type: "background_agent",
@@ -3577,7 +3609,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3577
3609
  ...(settled === "failed" && errCodeBg !== undefined ? { errorCode: errCodeBg } : {}),
3578
3610
  ...providerFaultField(child),
3579
3611
  ...(child.sessionId ? { sessionId: child.sessionId } : {}),
3580
- ...(bgHandbackResult ? { result: notifyResultField(bgHandbackResult) } : {}),
3612
+ ...(bgResultField !== undefined ? { result: bgResultField.text } : {}),
3581
3613
  ...(settled === "killed" && child.result ? { partial: true } : {}),
3582
3614
  ...residual,
3583
3615
  resumable: resumableBg,
@@ -3586,21 +3618,21 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3586
3618
  };
3587
3619
  if (ownsTerminalFaces)
3588
3620
  sinkEmit(backgroundChildTerminal(completionFrame, { taskId, sessionScoped: sessionScopedBg === true, ...(child.sessionId ? { sessionId: child.sessionId, transcriptId: child.sessionId } : {}), parentToolCallId: ctx.toolCallId, ...(bgCycleSeq !== undefined ? { generation: bgCycleSeq } : {}) }));
3589
- const gateOwner = ownsTerminalFaces && settled === "completed" && notify !== undefined ? bgRetain?.childSessionId : undefined;
3590
- const aliveBgCount = gateOwner !== undefined ? bg.registry.countRunningBackgroundForOwner(gateOwner) : 0;
3591
- if (gateOwner !== undefined && bgRetain !== undefined && aliveBgCount > 0) {
3621
+ const gateOwners = ownsTerminalFaces && settled === "completed" && bgRetain !== undefined ? childOwnerKeys(child.taskId, bgRetain.childSessionId) : [];
3622
+ const aliveBgCount = runningBackgroundUnder(bg.registry, gateOwners);
3623
+ if (bgRetain !== undefined && aliveBgCount > 0) {
3592
3624
  parkCompletionNotify({
3593
3625
  registry: bg.registry,
3594
3626
  entry: bgRetain,
3595
- owner: gateOwner,
3627
+ owners: gateOwners,
3596
3628
  pendingCount: aliveBgCount,
3597
3629
  payload: completionFrame,
3598
- notify: notify,
3630
+ notify,
3599
3631
  });
3600
3632
  }
3601
3633
  else if (ownsTerminalFaces) {
3602
3634
  try {
3603
- notify?.(completionFrame, { priority: "next" });
3635
+ notify(completionFrame, { priority: "next" });
3604
3636
  }
3605
3637
  catch {
3606
3638
  }
@@ -3622,24 +3654,20 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3622
3654
  const msg = childThrownText(e);
3623
3655
  const errCodeBgReject = killed ? undefined : thrownErrorCode(e);
3624
3656
  const errClassBgReject = killed ? undefined : classifySubagentError({ kind: "failed", ...(errCodeBgReject !== undefined ? { code: errCodeBgReject } : {}) });
3625
- const settled = bg.registry.settleBackgroundAgent(taskId, {
3657
+ const settleWinnerBgReject = bg.registry.settleBackgroundAgent(taskId, {
3626
3658
  cycle: 0,
3627
3659
  status: killed ? "killed" : "failed",
3628
3660
  error: msg,
3629
3661
  seq: seqAtSettle ?? 1,
3630
3662
  ...(errCodeBgReject !== undefined ? { errorCode: errCodeBgReject } : {}),
3631
3663
  ...(errClassBgReject !== undefined ? { retryable: errClassBgReject.retryable, errorKind: errClassBgReject.errorKind } : {}),
3632
- }) ?? (killed ? "killed" : "failed");
3664
+ });
3665
+ const completionIdBgReject = settleWinnerBgReject !== undefined ? bg.registry.getCompletionId(taskId) : undefined;
3666
+ const settled = settleWinnerBgReject ?? (killed ? "killed" : "failed");
3633
3667
  if (!bgRetain && reviveRow === undefined && !(await bgRowConfirmed())) {
3634
- try {
3635
- await opts.runner.sessions.release(bgChildSessionId);
3636
- bg.registry.releaseDurableTranscriptAnchor(taskId);
3637
- }
3638
- catch {
3639
- }
3668
+ await releaseBoundChildSession({ registry: bg.registry, taskId }, bgChildSessionId, () => opts.runner.sessions.release(bgChildSessionId));
3640
3669
  }
3641
3670
  const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
3642
- const completionIdBgReject = bg.registry.getCompletionId(taskId);
3643
3671
  const observerNote = observerNoteFor(await startBoundedObserverDrain());
3644
3672
  const ownsTerminalFacesReject = bg.registry.claimAgentTerminalNotify(taskId);
3645
3673
  const rejectFrame = {
@@ -3660,7 +3688,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3660
3688
  sinkEmit(backgroundChildTerminal(rejectFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(bgCycleSeq !== undefined ? { generation: bgCycleSeq } : {}) }));
3661
3689
  try {
3662
3690
  if (ownsTerminalFacesReject)
3663
- notify?.(rejectFrame, { priority: "next" });
3691
+ notify(rejectFrame, { priority: "next" });
3664
3692
  }
3665
3693
  catch {
3666
3694
  }
@@ -3695,8 +3723,6 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3695
3723
  content: asyncLaunchedReceipt({
3696
3724
  taskId,
3697
3725
  workingLine: `The agent is working in the background.`,
3698
- notify: Boolean(notify),
3699
- oneShot: ctx.oneShot === true,
3700
3726
  notes: [
3701
3727
  modelNote,
3702
3728
  extraToolsNote,
@@ -3732,7 +3758,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3732
3758
  if (retainEntry)
3733
3759
  stepRecorder.lockTo(retainEntry.childSessionId);
3734
3760
  const stream = opts.runner.runTaskStream({ ...buildChildSpec(ctx.signal), ...(retainEntry ? { sessionId: retainEntry.childSessionId } : {}) }, undefined, childInternals);
3735
- observedSteerRef.steer = (text, o) => stream.steer(text, o);
3761
+ observedSteerRef.steer = authoredSteerOf(stream);
3736
3762
  let settleResolve;
3737
3763
  const settled = new Promise((r) => { settleResolve = r; });
3738
3764
  if (ctx.onSubagentSpawn) {
@@ -3743,9 +3769,12 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3743
3769
  ...(opts.background?.notify ? { notify: opts.background.notify } : {}),
3744
3770
  sink: ctx.onSubagentSpawn,
3745
3771
  ...(opts.background ? { registry: opts.background.registry } : {}),
3772
+ entryGate: syncEntryGate,
3746
3773
  ...(opts.onObserverError !== undefined ? { onNotifyError: (f) => opts.onObserverError?.(f.error, { site: f.site }) } : {}),
3747
3774
  ...(ctx.onQuestion !== undefined ? { currentOnQuestion: ctx.onQuestion } : {}),
3748
3775
  ...(ctx.autoModeReview !== undefined ? { currentAutoModeReview: ctx.autoModeReview } : {}),
3776
+ currentMcpHostSeats: ctx.mountedMcp?.().hostSeats,
3777
+ currentPlacementTarget: ctx.placementTarget,
3749
3778
  });
3750
3779
  notifier.notify(() => ctx.onSubagentSpawn?.(createSteerHandle(stream, ctx.toolCallId, childAgentName, settled, {
3751
3780
  resume,
@@ -3827,6 +3856,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3827
3856
  `status: ${childFace.status}`,
3828
3857
  modelNote ?? "",
3829
3858
  extraToolsNote ?? "",
3859
+ ranSyncNote ?? "",
3830
3860
  worktreeLine ?? "",
3831
3861
  childFace.blockedReason ? `blocked_reason: ${inlineUntrusted(childFace.blockedReason, REPORT_FIELD_MAX)}` : "",
3832
3862
  childFace.errorMessage ? `error: ${inlineUntrusted(childFace.errorMessage, REPORT_FIELD_MAX)}` : "",