@sema-agent/core 7.60.0 → 7.62.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 (560) hide show
  1. package/CHANGELOG.md +917 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +71 -12
  6. package/dist/agents/cascade.js +61 -21
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-held-queue.d.ts +27 -4
  17. package/dist/agents/peer-held-queue.js +81 -36
  18. package/dist/agents/peer-notice-route.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.js +4 -3
  20. package/dist/agents/peer-notices.d.ts +4 -4
  21. package/dist/agents/peer-notices.js +8 -4
  22. package/dist/agents/peer-session-drain.d.ts +8 -1
  23. package/dist/agents/peer-session-drain.js +49 -10
  24. package/dist/agents/repair-loop.js +16 -6
  25. package/dist/agents/retain-ledger.js +3 -1
  26. package/dist/agents/roster-store.d.ts +1 -1
  27. package/dist/agents/roster-store.js +7 -4
  28. package/dist/agents/send-message-tool.d.ts +8 -10
  29. package/dist/agents/send-message-tool.js +43 -23
  30. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  31. package/dist/agents/subagent-completion-gate.js +62 -0
  32. package/dist/agents/subagent-steps.d.ts +7 -6
  33. package/dist/agents/subagent.d.ts +36 -41
  34. package/dist/agents/subagent.js +245 -200
  35. package/dist/agents/suspend-guard.d.ts +47 -16
  36. package/dist/agents/suspend-guard.js +13 -4
  37. package/dist/agents/verify.d.ts +41 -14
  38. package/dist/agents/verify.js +41 -30
  39. package/dist/brain/anthropic.js +1 -0
  40. package/dist/brain/errors.d.ts +7 -1
  41. package/dist/brain/errors.js +6 -0
  42. package/dist/brain/failover.js +2 -1
  43. package/dist/brain/open-responses.js +1 -0
  44. package/dist/brain/openai.js +1 -0
  45. package/dist/brain/provider-dialect.d.ts +10 -0
  46. package/dist/brain/provider-dialect.js +13 -2
  47. package/dist/brain/stream-engine.d.ts +3 -0
  48. package/dist/brain/stream-engine.js +4 -0
  49. package/dist/core/agent-state.d.ts +1 -1
  50. package/dist/core/allow-entry.d.ts +59 -23
  51. package/dist/core/allow-entry.js +131 -38
  52. package/dist/core/ask-origin.d.ts +79 -0
  53. package/dist/core/ask-origin.js +76 -0
  54. package/dist/core/ask-question.d.ts +19 -13
  55. package/dist/core/ask-question.js +8 -2
  56. package/dist/core/auto-compaction.d.ts +2 -0
  57. package/dist/core/auto-compaction.js +2 -1
  58. package/dist/core/auto-mode.js +3 -5
  59. package/dist/core/background-agent-store.d.ts +7 -5
  60. package/dist/core/background-agent-store.js +12 -11
  61. package/dist/core/checkpoint-features.d.ts +722 -0
  62. package/dist/core/checkpoint-features.js +98 -0
  63. package/dist/core/checkpoint-requirements.d.ts +33 -5
  64. package/dist/core/checkpoint-requirements.js +18 -5
  65. package/dist/core/checkpoint-row-verdict.d.ts +99 -0
  66. package/dist/core/checkpoint-row-verdict.js +225 -0
  67. package/dist/core/checkpoint-store.d.ts +107 -738
  68. package/dist/core/checkpoint-store.js +45 -143
  69. package/dist/core/child-clamp-seats.d.ts +3 -2
  70. package/dist/core/child-clamp-seats.js +4 -3
  71. package/dist/core/closest-name.d.ts +13 -0
  72. package/dist/core/closest-name.js +35 -0
  73. package/dist/core/context-settings.js +3 -5
  74. package/dist/core/cross-boundary-taint.d.ts +1 -1
  75. package/dist/core/decision-receipt.d.ts +14 -1
  76. package/dist/core/decision-receipt.js +6 -3
  77. package/dist/core/delegation-frames.d.ts +13 -9
  78. package/dist/core/effective-path-target.js +2 -3
  79. package/dist/core/engine-attestation.d.ts +11 -1
  80. package/dist/core/engine-attestation.js +2 -0
  81. package/dist/core/engine-notice.d.ts +68 -21
  82. package/dist/core/engine-notice.js +9 -2
  83. package/dist/core/file-history-retention.d.ts +8 -0
  84. package/dist/core/file-history-retention.js +14 -11
  85. package/dist/core/file-history-store.d.ts +31 -1
  86. package/dist/core/file-history-store.js +31 -2
  87. package/dist/core/frame-settlement.d.ts +10 -0
  88. package/dist/core/frame-settlement.js +6 -1
  89. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  90. package/dist/core/fs-write-gate-policy.js +8 -7
  91. package/dist/core/gate-fold.js +4 -3
  92. package/dist/core/gate-lanes.js +7 -4
  93. package/dist/core/gate-outcome.d.ts +40 -1
  94. package/dist/core/gate-outcome.js +10 -0
  95. package/dist/core/git-worktree-env.d.ts +7 -3
  96. package/dist/core/git-worktree-env.js +16 -13
  97. package/dist/core/governance-codes.d.ts +14 -4
  98. package/dist/core/governance-codes.js +19 -4
  99. package/dist/core/hooks.d.ts +25 -4
  100. package/dist/core/hooks.js +11 -4
  101. package/dist/core/host-floor.js +3 -5
  102. package/dist/core/human-input-projection.d.ts +1 -0
  103. package/dist/core/human-input-projection.js +3 -0
  104. package/dist/core/image-admission.d.ts +47 -7
  105. package/dist/core/image-admission.js +35 -4
  106. package/dist/core/input-author.d.ts +36 -0
  107. package/dist/core/input-author.js +39 -0
  108. package/dist/core/leg-identity.d.ts +62 -0
  109. package/dist/core/leg-identity.js +18 -0
  110. package/dist/core/locked-config.d.ts +4 -3
  111. package/dist/core/locked-config.js +5 -3
  112. package/dist/core/lsp.d.ts +5 -3
  113. package/dist/core/lsp.js +3 -2
  114. package/dist/core/mailbox-store.d.ts +85 -10
  115. package/dist/core/mailbox-store.js +31 -10
  116. package/dist/core/mcp-connection-pool.d.ts +6 -20
  117. package/dist/core/mcp-connection-pool.js +10 -28
  118. package/dist/core/mcp-failure.d.ts +76 -15
  119. package/dist/core/mcp-failure.js +60 -33
  120. package/dist/core/mcp-host-seat.d.ts +92 -53
  121. package/dist/core/mcp-host-seat.js +225 -46
  122. package/dist/core/mcp-probe.js +2 -2
  123. package/dist/core/mcp-server-link.d.ts +18 -6
  124. package/dist/core/mcp-server-link.js +19 -4
  125. package/dist/core/mcp-server-spec.d.ts +2 -1
  126. package/dist/core/mcp-session-end.d.ts +1 -2
  127. package/dist/core/mcp-session-end.js +1 -1
  128. package/dist/core/mcp.d.ts +6 -49
  129. package/dist/core/mcp.js +115 -111
  130. package/dist/core/media-byte-cap.d.ts +21 -46
  131. package/dist/core/media-byte-cap.js +55 -55
  132. package/dist/core/member-group.d.ts +7 -0
  133. package/dist/core/member-group.js +35 -0
  134. package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
  135. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  136. package/dist/core/memory-engine/consolidation.js +7 -1
  137. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  138. package/dist/core/memory-engine/dual-root.js +59 -11
  139. package/dist/core/memory-engine/engine.js +27 -24
  140. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  141. package/dist/core/memory-engine/file-backend.js +35 -15
  142. package/dist/core/memory-engine/layout.d.ts +3 -0
  143. package/dist/core/memory-engine/layout.js +13 -3
  144. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  145. package/dist/core/memory-engine/memory-deployment.js +182 -0
  146. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  147. package/dist/core/memory-engine/sync-client.js +72 -14
  148. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  149. package/dist/core/memory-engine/sync.d.ts +9 -1
  150. package/dist/core/memory-vector.d.ts +1 -1
  151. package/dist/core/memory.d.ts +10 -10
  152. package/dist/core/mode-policy.d.ts +8 -8
  153. package/dist/core/mode-policy.js +8 -6
  154. package/dist/core/mods/agent-stations.d.ts +39 -4
  155. package/dist/core/mods/agent-stations.js +59 -10
  156. package/dist/core/mods/classic-events.d.ts +9 -1
  157. package/dist/core/mods/dollar.d.ts +94 -1
  158. package/dist/core/mods/dollar.js +13 -1
  159. package/dist/core/mods/extension-call.d.ts +15 -1
  160. package/dist/core/mods/extension-call.js +7 -2
  161. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  162. package/dist/core/mods/kernel/dispatch.js +4 -4
  163. package/dist/core/mods/kernel/events.d.ts +14 -3
  164. package/dist/core/mods/kernel/events.js +18 -15
  165. package/dist/core/mods/kernel/registration.d.ts +3 -0
  166. package/dist/core/mods/kernel/registration.js +5 -0
  167. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  168. package/dist/core/mods/kernel/site-rules.js +10 -2
  169. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  170. package/dist/core/mods/lifecycle-stations.js +44 -9
  171. package/dist/core/mods/session-append.d.ts +118 -0
  172. package/dist/core/mods/session-append.js +318 -0
  173. package/dist/core/mods/session-compact.d.ts +48 -0
  174. package/dist/core/mods/session-compact.js +194 -0
  175. package/dist/core/mods/session-receive.d.ts +93 -0
  176. package/dist/core/mods/session-receive.js +138 -0
  177. package/dist/core/mods/session-send.d.ts +72 -0
  178. package/dist/core/mods/session-send.js +88 -0
  179. package/dist/core/mods/stations.d.ts +88 -21
  180. package/dist/core/mods/stations.js +149 -11
  181. package/dist/core/mods/tool-call.d.ts +2 -0
  182. package/dist/core/mods/tool-call.js +4 -4
  183. package/dist/core/output-style.js +3 -4
  184. package/dist/core/own-property-receipt.d.ts +68 -2
  185. package/dist/core/own-property-receipt.js +45 -2
  186. package/dist/core/park-selfcheck.js +4 -2
  187. package/dist/core/path-identity.d.ts +11 -0
  188. package/dist/core/path-identity.js +4 -0
  189. package/dist/core/path-rule-binding.d.ts +3 -1
  190. package/dist/core/path-rule-binding.js +3 -1
  191. package/dist/core/peer-seat.d.ts +3 -3
  192. package/dist/core/peer-seat.js +20 -8
  193. package/dist/core/permission-rule-consent.d.ts +21 -5
  194. package/dist/core/permission-rule-consent.js +21 -1
  195. package/dist/core/permission-rule-model.d.ts +34 -11
  196. package/dist/core/permission-rule-model.js +47 -10
  197. package/dist/core/permission-rule-org.d.ts +1 -1
  198. package/dist/core/permission-rule-provider.js +4 -1
  199. package/dist/core/permission-rules.d.ts +4 -0
  200. package/dist/core/permission-rules.js +11 -16
  201. package/dist/core/read-root-candidate.js +1 -1
  202. package/dist/core/remote-env.d.ts +74 -26
  203. package/dist/core/remote-env.js +20 -0
  204. package/dist/core/resume-startup-cause.d.ts +5 -4
  205. package/dist/core/retention-policy.d.ts +24 -23
  206. package/dist/core/retention-policy.js +36 -2
  207. package/dist/core/retention.d.ts +4 -1
  208. package/dist/core/retired-keys.d.ts +4 -4
  209. package/dist/core/row-admission.d.ts +10 -0
  210. package/dist/core/row-admission.js +5 -0
  211. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  212. package/dist/core/runner/advisor-instructions.js +2 -1
  213. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  214. package/dist/core/runner/assemble-result.d.ts +13 -3
  215. package/dist/core/runner/assemble-result.js +12 -7
  216. package/dist/core/runner/caller-roster.d.ts +12 -9
  217. package/dist/core/runner/caller-roster.js +5 -2
  218. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  219. package/dist/core/runner/checkpoint-scope.js +21 -0
  220. package/dist/core/runner/compact-session.js +18 -3
  221. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  222. package/dist/core/runner/compaction-restate.d.ts +2 -2
  223. package/dist/core/runner/compaction-restate.js +4 -3
  224. package/dist/core/runner/construction-doors.d.ts +2 -2
  225. package/dist/core/runner/construction-doors.js +2 -2
  226. package/dist/core/runner/contracts.d.ts +116 -34
  227. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  228. package/dist/core/runner/decide-continuation.d.ts +4 -2
  229. package/dist/core/runner/decide-continuation.js +7 -4
  230. package/dist/core/runner/delegation-owner.d.ts +43 -0
  231. package/dist/core/runner/delegation-owner.js +59 -0
  232. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  233. package/dist/core/runner/denial-limit-arms.js +17 -10
  234. package/dist/core/runner/expire-settle.d.ts +44 -0
  235. package/dist/core/runner/expire-settle.js +55 -0
  236. package/dist/core/runner/git-status-frame.d.ts +3 -3
  237. package/dist/core/runner/git-status-frame.js +2 -1
  238. package/dist/core/runner/halt-attribution.d.ts +2 -1
  239. package/dist/core/runner/halt-attribution.js +2 -1
  240. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  241. package/dist/core/runner/lineage-reroot-view.js +108 -0
  242. package/dist/core/runner/local-claims.d.ts +17 -0
  243. package/dist/core/runner/local-claims.js +18 -0
  244. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  245. package/dist/core/runner/media-removed-seat.js +88 -0
  246. package/dist/core/runner/park-commit.d.ts +2 -2
  247. package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
  248. package/dist/core/runner/permission-rule-lanes.js +28 -9
  249. package/dist/core/runner/person-path-rows.d.ts +15 -0
  250. package/dist/core/runner/person-path-rows.js +27 -4
  251. package/dist/core/runner/placement-fence.d.ts +26 -0
  252. package/dist/core/runner/placement-fence.js +38 -0
  253. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  254. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  255. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  256. package/dist/core/runner/prepare-ask-lane.js +4 -4
  257. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  258. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  259. package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
  260. package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
  261. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  262. package/dist/core/runner/prepare-config-doors.js +19 -21
  263. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  264. package/dist/core/runner/prepare-context-lane.js +13 -13
  265. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  266. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  267. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  268. package/dist/core/runner/prepare-execution-env.js +7 -4
  269. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  270. package/dist/core/runner/prepare-gate-stations.js +6 -4
  271. package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
  272. package/dist/core/runner/prepare-hands-readface.js +32 -11
  273. package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
  274. package/dist/core/runner/prepare-inherited-gate.js +10 -3
  275. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  276. package/dist/core/runner/prepare-lsp.js +2 -2
  277. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  278. package/dist/core/runner/prepare-park-ask.js +4 -5
  279. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  280. package/dist/core/runner/prepare-policy-chain.js +16 -25
  281. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  282. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  283. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  284. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  285. package/dist/core/runner/prepare-question-face.js +2 -2
  286. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  287. package/dist/core/runner/prepare-run-refs.js +2 -2
  288. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  289. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  290. package/dist/core/runner/prepare-task.d.ts +1 -1
  291. package/dist/core/runner/prepare-task.js +61 -30
  292. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  293. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  294. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  295. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  296. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  297. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  298. package/dist/core/runner/read-root-grant.d.ts +1 -1
  299. package/dist/core/runner/read-root-grant.js +2 -1
  300. package/dist/core/runner/resume-admission.d.ts +8 -6
  301. package/dist/core/runner/resume-admission.js +23 -6
  302. package/dist/core/runner/resume-apply.d.ts +4 -0
  303. package/dist/core/runner/resume-apply.js +14 -5
  304. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  305. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  306. package/dist/core/runner/resume-claim.d.ts +8 -3
  307. package/dist/core/runner/resume-claim.js +28 -12
  308. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  309. package/dist/core/runner/resume-internals-and-config.js +10 -1
  310. package/dist/core/runner/resume-preflight.d.ts +3 -2
  311. package/dist/core/runner/resume-preflight.js +13 -26
  312. package/dist/core/runner/retired-runner-deps.js +2 -0
  313. package/dist/core/runner/run-git-lane.d.ts +2 -0
  314. package/dist/core/runner/run-git-lane.js +6 -2
  315. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  316. package/dist/core/runner/run-harness-handlers.js +5 -4
  317. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  318. package/dist/core/runner/run-identity-wiring.js +14 -5
  319. package/dist/core/runner/run-leg.d.ts +3 -3
  320. package/dist/core/runner/run-leg.js +64 -36
  321. package/dist/core/runner/run-notification-lane.js +20 -2
  322. package/dist/core/runner/run-recovery-lanes.js +3 -2
  323. package/dist/core/runner/run-settle-and-teardown.js +12 -9
  324. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  325. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  326. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  327. package/dist/core/runner/run-terminal-adoption.js +26 -17
  328. package/dist/core/runner/run-turn-boundary.js +34 -18
  329. package/dist/core/runner/runtask.d.ts +18 -3
  330. package/dist/core/runner/runtask.js +33 -17
  331. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  332. package/dist/core/runner/session-rule-policy.js +6 -1
  333. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  334. package/dist/core/runner/steering-preview.d.ts +9 -0
  335. package/dist/core/runner/steering-preview.js +5 -0
  336. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  337. package/dist/core/runner/stream-halt-verbs.js +4 -3
  338. package/dist/core/runner/stream-reap.d.ts +7 -6
  339. package/dist/core/runner/stream-reap.js +13 -16
  340. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  341. package/dist/core/runner/stream-settle-backstop.js +5 -3
  342. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  343. package/dist/core/runner/stream-steer-verb.js +16 -7
  344. package/dist/core/runner/terminal-account.d.ts +11 -1
  345. package/dist/core/runner/terminal-account.js +20 -0
  346. package/dist/core/runner/terminal-projection.d.ts +8 -2
  347. package/dist/core/runner/terminal-projection.js +2 -2
  348. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  349. package/dist/core/runner/tool-disclosure.js +5 -2
  350. package/dist/core/runner/tool-end-body.d.ts +3 -3
  351. package/dist/core/runner/tool-end-body.js +1 -1
  352. package/dist/core/runner/tool-face-overlay.js +2 -0
  353. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  354. package/dist/core/runner/tool-output-projection.js +7 -6
  355. package/dist/core/runner/tool-table-view.d.ts +56 -0
  356. package/dist/core/runner/tool-table-view.js +51 -0
  357. package/dist/core/runner/turn-attachments.d.ts +8 -2
  358. package/dist/core/runner/turn-attachments.js +2 -2
  359. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  360. package/dist/core/runner/void-verifier-pause.js +41 -0
  361. package/dist/core/runner-deps.d.ts +26 -27
  362. package/dist/core/secret-env.d.ts +19 -16
  363. package/dist/core/secret-env.js +45 -27
  364. package/dist/core/session-log-transfer.js +9 -10
  365. package/dist/core/session-policy-store.d.ts +1 -1
  366. package/dist/core/session-policy-store.js +5 -2
  367. package/dist/core/session-reconcile.d.ts +3 -2
  368. package/dist/core/session-reconcile.js +7 -4
  369. package/dist/core/session-store.d.ts +3 -1
  370. package/dist/core/session-store.js +10 -8
  371. package/dist/core/session.d.ts +16 -5
  372. package/dist/core/shell-confinement.d.ts +37 -0
  373. package/dist/core/shell-confinement.js +56 -0
  374. package/dist/core/skill-grant.js +1 -1
  375. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
  376. package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
  377. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  378. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  379. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  380. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  381. package/dist/core/store-contracts/session-store-contract.js +22 -8
  382. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  383. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  384. package/dist/core/task-event.d.ts +24 -9
  385. package/dist/core/task-limits.d.ts +5 -0
  386. package/dist/core/task-notification.d.ts +89 -12
  387. package/dist/core/task-notification.js +89 -14
  388. package/dist/core/task-registry-agent.d.ts +32 -50
  389. package/dist/core/task-registry-agent.js +36 -56
  390. package/dist/core/task-registry-monitor.d.ts +1 -1
  391. package/dist/core/task-registry-monitor.js +15 -60
  392. package/dist/core/task-registry-shared.d.ts +22 -112
  393. package/dist/core/task-registry-shared.js +3 -41
  394. package/dist/core/task-registry-workflow.js +5 -21
  395. package/dist/core/task-registry.d.ts +32 -62
  396. package/dist/core/task-registry.js +30 -110
  397. package/dist/core/task-result.d.ts +29 -12
  398. package/dist/core/task-spec-members.d.ts +39 -0
  399. package/dist/core/task-spec-members.js +92 -0
  400. package/dist/core/task-spec.d.ts +11 -11
  401. package/dist/core/task-tool-shape.d.ts +7 -57
  402. package/dist/core/task-tool-shape.js +7 -66
  403. package/dist/core/terminal-cause.d.ts +36 -6
  404. package/dist/core/terminal-cause.js +1 -0
  405. package/dist/core/tool-catalog-entries.js +2 -5
  406. package/dist/core/tool-check-reading.js +16 -10
  407. package/dist/core/tool-conformance.js +1 -2
  408. package/dist/core/tool-errors.d.ts +6 -3
  409. package/dist/core/tool-errors.js +2 -0
  410. package/dist/core/tool-face-reader.js +3 -2
  411. package/dist/core/tool-face.d.ts +8 -5
  412. package/dist/core/tool-face.js +1 -1
  413. package/dist/core/tool-name-aliases.d.ts +5 -29
  414. package/dist/core/tool-name-aliases.js +9 -5
  415. package/dist/core/tool-name-readings.d.ts +14 -3
  416. package/dist/core/tool-name-readings.js +2 -0
  417. package/dist/core/tool-policy.d.ts +109 -18
  418. package/dist/core/tool-policy.js +84 -14
  419. package/dist/core/tool-result-store.d.ts +23 -0
  420. package/dist/core/tool-result-store.js +3 -2
  421. package/dist/core/tool-roster.d.ts +4 -4
  422. package/dist/core/tool-spec.d.ts +23 -6
  423. package/dist/core/trace.d.ts +18 -1
  424. package/dist/core/types.d.ts +1 -1
  425. package/dist/core/types.js +1 -1
  426. package/dist/core/user-attachment.js +26 -21
  427. package/dist/core/workflow-journal-store.d.ts +1 -1
  428. package/dist/core/workflow-run-store.d.ts +2 -0
  429. package/dist/core/workflow-run-store.js +6 -5
  430. package/dist/core/workflow-settled-run.d.ts +5 -0
  431. package/dist/core/workflow-settled-run.js +7 -0
  432. package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
  433. package/dist/engine/execution-env/node-execution-env.js +221 -22
  434. package/dist/engine/harness/agent-harness.d.ts +65 -18
  435. package/dist/engine/harness/agent-harness.js +90 -23
  436. package/dist/engine/harness/messages.d.ts +4 -3
  437. package/dist/engine/harness/messages.js +2 -2
  438. package/dist/engine/harness/types.d.ts +52 -7
  439. package/dist/engine/llm/media-removed.d.ts +14 -0
  440. package/dist/engine/llm/media-removed.js +9 -0
  441. package/dist/engine/llm/rejected-images.d.ts +35 -25
  442. package/dist/engine/llm/rejected-images.js +59 -10
  443. package/dist/engine/llm/types.d.ts +24 -3
  444. package/dist/engine/llm/types.js +7 -3
  445. package/dist/engine/loop/agent-loop.d.ts +6 -1
  446. package/dist/engine/loop/agent-loop.js +20 -11
  447. package/dist/engine/loop/types.d.ts +12 -3
  448. package/dist/engine/session/import-validate.js +7 -0
  449. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  450. package/dist/engine/session/parent-chain-guard.js +1 -1
  451. package/dist/engine/session/path-to-root.d.ts +18 -3
  452. package/dist/engine/session/path-to-root.js +15 -1
  453. package/dist/engine/session/repo-utils.d.ts +12 -1
  454. package/dist/engine/session/repo-utils.js +41 -0
  455. package/dist/engine/session/session.js +1 -1
  456. package/dist/engine/session/storage-base.d.ts +20 -0
  457. package/dist/engine/session/storage-base.js +28 -9
  458. package/dist/fixtures/index.d.ts +7 -5
  459. package/dist/fixtures/index.js +5 -3
  460. package/dist/index.d.ts +29 -18
  461. package/dist/index.js +19 -11
  462. package/dist/internal/harness-types.d.ts +2 -0
  463. package/dist/internal/harness.d.ts +4 -3
  464. package/dist/internal/harness.js +3 -2
  465. package/dist/internal/llm.d.ts +2 -1
  466. package/dist/internal/llm.js +1 -0
  467. package/dist/orchestration/goal.d.ts +6 -2
  468. package/dist/orchestration/goal.js +6 -3
  469. package/dist/orchestration/run-workflow-tool.d.ts +14 -17
  470. package/dist/orchestration/run-workflow-tool.js +43 -50
  471. package/dist/orchestration/workflow-types.d.ts +2 -2
  472. package/dist/orchestration/workflow.d.ts +7 -0
  473. package/dist/orchestration/workflow.js +10 -12
  474. package/dist/stores/file/background-agent-store.js +18 -15
  475. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  476. package/dist/stores/file/checkpoint-store.js +13 -9
  477. package/dist/stores/file/file-history-store.js +3 -2
  478. package/dist/stores/file/fs-atomic.d.ts +0 -22
  479. package/dist/stores/file/fs-atomic.js +0 -17
  480. package/dist/stores/file/index.d.ts +7 -12
  481. package/dist/stores/file/index.js +25 -12
  482. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  483. package/dist/stores/file/ledger-tuning.js +21 -0
  484. package/dist/stores/file/mailbox-store.js +42 -22
  485. package/dist/stores/file/memory-store.js +3 -2
  486. package/dist/stores/file/permission-rule-adopt.js +24 -21
  487. package/dist/stores/file/permission-rule-store.js +6 -3
  488. package/dist/stores/file/session-policy-store.js +3 -2
  489. package/dist/stores/file/session-store.d.ts +26 -7
  490. package/dist/stores/file/session-store.js +59 -35
  491. package/dist/stores/file/tool-result-store.d.ts +11 -0
  492. package/dist/stores/file/tool-result-store.js +57 -3
  493. package/dist/stores/file/usage-window-store.js +3 -2
  494. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  495. package/dist/stores/file/workflow-journal-store.js +3 -18
  496. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  497. package/dist/stores/file/workflow-run-store.js +15 -10
  498. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  499. package/dist/tools/fs/bash-program-position.js +7 -7
  500. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  501. package/dist/tools/fs/dead-cwd.js +4 -11
  502. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  503. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  504. package/dist/tools/fs/fs-bash.d.ts +3 -18
  505. package/dist/tools/fs/fs-bash.js +37 -124
  506. package/dist/tools/fs/fs-pdf.js +8 -6
  507. package/dist/tools/fs/fs-read.js +2 -2
  508. package/dist/tools/fs/fs-shared.d.ts +28 -3
  509. package/dist/tools/fs/fs-shared.js +15 -0
  510. package/dist/tools/fs/index.d.ts +1 -1
  511. package/dist/tools/fs/index.js +4 -14
  512. package/dist/tools/fs/pdf.d.ts +4 -4
  513. package/dist/tools/fs/pdf.js +6 -6
  514. package/dist/tools/fs/read-deny-home.js +8 -1
  515. package/dist/tools/fs/read-deny.d.ts +26 -2
  516. package/dist/tools/fs/read-deny.js +9 -2
  517. package/dist/tools/fs/read-floor.d.ts +13 -5
  518. package/dist/tools/fs/read-floor.js +206 -2
  519. package/dist/tools/fs/removal-targets.js +2 -2
  520. package/dist/tools/fs/search.d.ts +3 -2
  521. package/dist/tools/fs/search.js +6 -6
  522. package/dist/tools/fs/shell-read-argv.d.ts +4 -2
  523. package/dist/tools/fs/shell-read-argv.js +14 -3
  524. package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
  525. package/dist/tools/fs/shell-read-bindings.js +148 -68
  526. package/dist/tools/fs/shell-read-check.js +20 -4
  527. package/dist/tools/fs/shell-read-establish.js +25 -9
  528. package/dist/tools/fs/shell-read-functions.js +2 -2
  529. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  530. package/dist/tools/fs/shell-read-identity.js +4 -2
  531. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  532. package/dist/tools/fs/shell-read-judge.js +1 -1
  533. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  534. package/dist/tools/fs/shell-read-object-path.js +119 -0
  535. package/dist/tools/fs/shell-read-plan.d.ts +8 -0
  536. package/dist/tools/fs/shell-read-plan.js +47 -30
  537. package/dist/tools/fs/shell-read-start.d.ts +66 -13
  538. package/dist/tools/fs/shell-read-start.js +89 -17
  539. package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
  540. package/dist/tools/fs/shell-read-workdir.js +31 -8
  541. package/dist/tools/monitor.d.ts +8 -7
  542. package/dist/tools/monitor.js +12 -10
  543. package/dist/tools/worktree.d.ts +5 -1
  544. package/dist/tools/worktree.js +20 -17
  545. package/package.json +6 -3
  546. package/test/export-surface.snapshot.json +112 -42
  547. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  548. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  549. package/wire-changes/core@7.61.0.json +4405 -0
  550. package/wire-changes/core@7.62.0.json +2181 -0
  551. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  552. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  553. package/wire-changes/primitives@7.61.0.json +30 -0
  554. package/wire-changes/primitives@7.62.0.json +30 -0
  555. package/dist/core/consolidate-scope.d.ts +0 -93
  556. package/dist/core/consolidate-scope.js +0 -98
  557. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  558. package/dist/core/runner/image-removed-seat.js +0 -19
  559. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  560. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -20,7 +20,7 @@ export interface SendMessageToolOptions {
20
20
  /** design/122 D1 — the parent run's retain ledger (present only when `TaskSpec.retainSubagentSessions`
21
21
  * opted in). Absent ⇒ the tool stays mounted but every call returns the honest not-retained text. */
22
22
  retain?: SubagentRetainLedger;
23
- /** Registry access identity (mirrors TaskOutput's closure identity — the mount fills these). */
23
+ /** Registry access identity (mirrors TaskStop's closure identity — the mount fills these). */
24
24
  owner?: string;
25
25
  scope?: string;
26
26
  sessionId?: string;
@@ -33,20 +33,18 @@ export interface SendMessageToolOptions {
33
33
  /** Completion-notify sink for the resumed run. The Runner mount wires the SENDING run's own
34
34
  * notification injector here (its runtask-wrapped `injectTaskNotification`), so the completion
35
35
  * notice lands in the sender's live injection queue at a turn boundary; a direct mount may wire a
36
- * deployment-level background-notify sink instead. Absent ⇒ completion is silent. */
36
+ * deployment-level background-notify sink instead. A call's own run lane (`ctx.onTaskNotification`) wins over it —
37
+ * the one completion-sink resolution. With neither (and no {@link notificationWired} channel) continuing a finished
38
+ * agent is refused at the call: a continuation is a background run, and nothing would hear it complete. */
37
39
  notify?: (n: TaskNotificationPayload, opts?: {
38
40
  priority?: "now" | "next" | "later";
39
41
  }) => void;
40
42
  /** The sending run's result store, the pair of {@link notify}: a continued agent's cut completion is stored where that
41
43
  * run's `ReadToolResult` reads. Absent ⇒ the cut says the full text is not readable from this session. */
42
44
  taskArtifacts?: import("../core/tool-result-store.js").TaskArtifactSeat;
43
- /** Whether a completion notification really reaches the sender — drives every "you will be notified"
44
- * sentence on this face (description + four receipts), mirroring TaskOutput's `notificationWired`.
45
- * Default = `notify !== undefined`, which is the truth on both the first-party mount and a direct
46
- * mount that wires its own sink here. Pass `true` only when the deployment announces a finished
47
- * agent through a channel of its own (this tool then keeps the wired wording); `false` states the
48
- * degraded truth explicitly. A one-shot submission needs no wording of its own: its ending waits for a continued
49
- * agent's completion, owed to the lane `notify` delivers into (`DeliveryObligations`). */
45
+ /** `true` when the deployment announces a finished agent through a channel of its own — the deployment-channel term
46
+ * of the one background admission: continuing a finished agent is then admitted without a sink here (its
47
+ * completion reaches the sender that way). Absent / `false` ⇒ only a resolved sink admits a continuation. */
50
48
  notificationWired?: boolean;
51
49
  /** Steer-handle sink: the revived run re-emits a FRESH handle (design/122 risk-table contract). */
52
50
  sink?: (handle: SubagentSteerHandle) => void;
@@ -83,7 +81,7 @@ export interface SendMessageToolOptions {
83
81
  * resolved fine). RB-409 opened the ctx route as well ({@link enrichCtx}), and the Runner mount
84
82
  * fills BOTH from the same internals chain; this seat remains the fallback (and the only route for
85
83
  * a host that wires the tool itself). A `ctx.parentTaskId` wins when present. SendMessage ONLY —
86
- * the TaskStop/TaskOutput mounts deliberately have no such seat (no widening of the kill/read
84
+ * the TaskStop mount deliberately has no such seat (no widening of the kill
87
85
  * surface). */
88
86
  parentTaskId?: string;
89
87
  /** RB-390 — companion session axis of {@link parentTaskId} (RunInternals.parentSessionId): a
@@ -1,5 +1,6 @@
1
+ import { randomBytes } from "node:crypto";
1
2
  import { Type } from "typebox";
2
- import { isNotificationInjectionOutcome } from "../core/task-notification.js";
3
+ import { admitsBackgroundLaunch, isNotificationInjectionOutcome, resolveCompletionSink } from "../core/task-notification.js";
3
4
  import { defineTool } from "../core/tools.js";
4
5
  import { normalizeAgentName, chosenAgentName, DURABLE_AGENT_HANDLE_RE, DURABLE_AGENT_HEARTBEAT_MS } from "../core/task-registry.js";
5
6
  import { announceTranscriptIntegrityGapOnce, canAccessAgentRecord, clearRevivedRowTerminalPayload } from "../core/background-agent-store.js";
@@ -24,7 +25,11 @@ import { clampValuesOf } from "../core/child-clamp-seats.js";
24
25
  import { assertParentSpecSeatCurrent } from "../core/parent-spec-seat.js";
25
26
  import { resolveSubagentTranscriptTier } from "../core/wiring-manifest.js";
26
27
  export const SEND_MESSAGE_TOOL_NAME = "SendMessage";
27
- let uplinkSeqGlobal = Date.now();
28
+ let uplinkSeqGlobal = processUplinkSeqOrigin();
29
+ function processUplinkSeqOrigin() {
30
+ const draw = randomBytes(7);
31
+ return 2 ** 51 + (draw[0] & 0x07) * 2 ** 48 + draw.readUIntBE(1, 6);
32
+ }
28
33
  const UPLINK_RESULT_MAX = 8000;
29
34
  function clipCarrierMessage(text) {
30
35
  return text.length > UPLINK_RESULT_MAX ? `${text.slice(0, UPLINK_RESULT_MAX)}\n[message truncated: ${text.length} chars total]` : text;
@@ -102,13 +107,8 @@ export function createSendMessageTool(opts) {
102
107
  const sendMessageParameters = peerLane.active
103
108
  ? Type.Object({ ...baseParameters.properties, message: Type.Optional(Type.String({ description: `${baseParameters.properties.message.description ?? ""} Optional only for a pure notify_when_idle subscription.`.trim() })), ...notifyWhenIdleParameter })
104
109
  : baseParameters;
105
- const RETRIEVE_LATER = "retrieve its status and result with TaskOutput(task_id) where mounted";
106
- const CHECK_LATER = "check for its completion with TaskOutput(task_id) where mounted";
107
- const capitalize = (text) => `${text.charAt(0).toUpperCase()}${text.slice(1)}`;
108
- const notifyWired = opts.notificationWired ?? opts.notify !== undefined;
109
- const NO_COMPLETION_NOTICE = `its completion is NOT announced on this mount — ${RETRIEVE_LATER}`;
110
- const AWAIT_COMPLETION = notifyWired ? "Wait for its completion notification" : capitalize(CHECK_LATER);
111
- const awaitCompletion = notifyWired ? "wait for its completion notification" : CHECK_LATER;
110
+ const AWAIT_COMPLETION = "Wait for its completion notification";
111
+ const awaitCompletion = "wait for its completion notification";
112
112
  const sendMessagePins = new Map();
113
113
  const pinGuard = (targetId, targetName, rung, to) => {
114
114
  if (rung === "other")
@@ -150,9 +150,7 @@ export function createSendMessageTool(opts) {
150
150
  `background run with its full prior conversation preserved, so don't re-explain what it already knows. Names ` +
151
151
  `keep working after an agent completes; but if a name you already messaged is later taken by a NEWER agent, the ` +
152
152
  `send is refused rather than silently redirected — re-send with the task_id of whichever agent you meant. ` +
153
- (notifyWired
154
- ? `You will be notified automatically when it completes — prefer ending your turn; do not poll. `
155
- : `A finished agent is NOT announced on this mount — check on it with TaskOutput(task_id) where mounted rather than ending your turn to wait for a notification that never comes. `) +
153
+ `You will be notified automatically when it completes — prefer ending your turn; do not poll. ` +
156
154
  (continuationTier === "full"
157
155
  ? `Continuing a finished agent works for agents with a durable record — by name or task_id, even across restarts — and for runs that retain sub-agent sessions; when neither covers it you get an honest error and should launch a new agent with the needed context instead.`
158
156
  : continuationTier === "rows"
@@ -201,6 +199,11 @@ export function createSendMessageTool(opts) {
201
199
  if (isObserverTaskId(to)) {
202
200
  return { content: OBSERVER_SENDMESSAGE_TARGET_REFUSAL, details: { error: "observer_target", to }, isError: true };
203
201
  }
202
+ if (message !== "" && ctx.sendStation?.listens() === true) {
203
+ const verdict = await ctx.sendStation.send({ to, text: message, toolCallId: ctx.toolCallId }, ctx.signal);
204
+ if (!verdict.go)
205
+ return { content: `Message not sent: ${verdict.reason}`, details: { error: "send_refused", code: "send_refused", by: verdict.by, to }, isError: true };
206
+ }
204
207
  const admissionConfig = resolvePeerLaneConfig(opts.lane, opts.onNotice);
205
208
  const guardScope = ctx.principal ?? opts.scope ?? opts.peerSelfSession?.scope;
206
209
  const selfRef = ctx.peerSelfRef ?? opts.peerSelf;
@@ -216,6 +219,13 @@ export function createSendMessageTool(opts) {
216
219
  const prospectiveChain = appendHopToken(inboundChain, senderKey);
217
220
  const admitFor = (recipientKey, ownTokens) => judgePeerAdmission(guardScope, recipientKey, { senderKey, body: message, prospectiveChain, ownTokens }, admissionConfig);
218
221
  const DEDUP_RETRY_NOTE = "Note: resending the identical text within the dedup window reads as duplicate — rephrase or wait it out.";
222
+ const continuationSink = resolveCompletionSink(ctx.onTaskNotification, opts.notify);
223
+ const continuationAdmitted = admitsBackgroundLaunch(continuationSink, opts.notificationWired === true);
224
+ const noContinuationLane = (whoLabel) => ({
225
+ content: `Message not sent: ${whoLabel.slice(0, 200)} has finished and cannot be continued here — no completion would come back from it on this mount. Launch a new agent with the needed context instead.`,
226
+ details: { error: "revive.no_background", code: "revive.no_background", to },
227
+ isError: true,
228
+ });
219
229
  const admissionRefusal = (reason, whoLabel) => {
220
230
  const text = reason === "rate_limited"
221
231
  ? `you are sending messages to ${whoLabel} faster than its rate limit — the budget refills on its own; slow down and resend in a moment.`
@@ -463,7 +473,9 @@ export function createSendMessageTool(opts) {
463
473
  ? `Message parked in process for main (${mainLabel}): it has no run in progress, so the message waits in this process for its next run — this copy does not survive a restart of this process. Continue with your task; do not wait for a reply.`
464
474
  : outcome === "dropped_duplicate"
465
475
  ? `Message not re-sent to main (${mainLabel}): it already delivered this exact message. Continue with your task; do not resend the same content.`
466
- : `Message sent to main — queued for ${mainLabel} at its next turn boundary (accepted into its lane, not yet read). If that run finishes before reading it, the message may not survive. Continue with your task; do not wait for a reply.`;
476
+ : outcome === "refused"
477
+ ? `Message not delivered to main (${mainLabel}): its receiving station did not hand it to its model (an extension there consumed it, or a handler there failed). Continue with your task; do not resend the same content.`
478
+ : `Message sent to main — queued for ${mainLabel} at its next turn boundary (accepted into its lane, not yet read). If that run finishes before reading it, the message may not survive. Continue with your task; do not wait for a reply.`;
467
479
  return {
468
480
  content,
469
481
  details: { type: "send-message", status: "uplinked", to: "main", seq: uplinkSeq, ...(outcome !== undefined ? { disposition: outcome } : {}), ...(opts.uplinkSessionId !== undefined ? { session: opts.uplinkSessionId } : {}) },
@@ -552,6 +564,8 @@ export function createSendMessageTool(opts) {
552
564
  }
553
565
  if (row.sessionId === undefined)
554
566
  return undefined;
567
+ if (!continuationAdmitted)
568
+ return noContinuationLane(whoT3);
555
569
  const floorRead = readClampFloor(row.policyFloor);
556
570
  if (!floorRead.ok) {
557
571
  return {
@@ -786,9 +800,7 @@ export function createSendMessageTool(opts) {
786
800
  const priorCount = lease.messages.length - 1;
787
801
  return {
788
802
  content: `Message sent — ${whoT3} was revived in the background with its prior context intact${priorCount > 0 ? ` (${priorCount} earlier pending message(s) delivered with it)` : ""}. ` +
789
- (notifyWired
790
- ? `You will be notified automatically when it completes. Continue with other work — do not poll.`
791
- : `${NO_COMPLETION_NOTICE.charAt(0).toUpperCase()}${NO_COMPLETION_NOTICE.slice(1)}.`),
803
+ `You will be notified automatically when it completes. Continue with other work — do not poll.`,
792
804
  details: { type: "send-message", status: "revived", to, task_id: handle, seq: nextSeq, ...(priorCount > 0 ? { priorMessages: priorCount } : {}) },
793
805
  };
794
806
  }
@@ -929,15 +941,22 @@ export function createSendMessageTool(opts) {
929
941
  }, { priority: "next" });
930
942
  if (delivered.ok) {
931
943
  const receiptText = delivered.disposition === "parked"
932
- ? `Message parked for ${who}: the agent finished before reading it — it will be delivered when the agent is next continued. ${notifyWired ? "You will be notified of its completion; continue with other work." : `Note: ${NO_COMPLETION_NOTICE}.`}`
944
+ ? `Message parked for ${who}: the agent finished before reading it — it will be delivered when the agent is next continued. You will be notified of its completion; continue with other work.`
933
945
  : delivered.disposition === "pending"
934
- ? `Message accepted for ${who} but delivery is UNCONFIRMED (its channel did not confirm within the wait window) — it stays queued and will deliver if the channel binds. ${notifyWired ? "You will be notified of the agent's completion either way" : `Note: ${NO_COMPLETION_NOTICE}`}; resend then if it went unanswered. ${DEDUP_RETRY_NOTE}`
935
- : `Message queued for delivery to ${who} at its next turn. If it finishes before reading it, the message may not survive — ${notifyWired ? "you will be notified of its completion either way" : NO_COMPLETION_NOTICE}; resend then if it went unanswered. ${notifyWired ? "Continue with other work; do not poll. " : ""}${DEDUP_RETRY_NOTE}`;
946
+ ? `Message accepted for ${who} but delivery is UNCONFIRMED (its channel did not confirm within the wait window) — it stays queued and will deliver if the channel binds. You will be notified of the agent's completion either way; resend then if it went unanswered. ${DEDUP_RETRY_NOTE}`
947
+ : `Message queued for delivery to ${who} at its next turn. If it finishes before reading it, the message may not survive — you will be notified of its completion either way; resend then if it went unanswered. Continue with other work; do not poll. ${DEDUP_RETRY_NOTE}`;
936
948
  return {
937
949
  content: receiptText,
938
950
  details: { type: "send-message", status: "delivered_running", disposition: delivered.disposition, to, task_id: targetId, summary },
939
951
  };
940
952
  }
953
+ if (delivered.reason === "refused") {
954
+ return {
955
+ content: `Message not delivered: ${who} did not take it — its receiving station did not hand it to its model (an extension there consumed it, or a handler there failed). Do not resend the same message; continue, or choose another approach.`,
956
+ details: { error: "refused", code: "refused", to },
957
+ isError: true,
958
+ };
959
+ }
941
960
  if (delivered.reason === "no_channel") {
942
961
  return {
943
962
  content: `Message not sent: ${who} is still running and this deployment has no mid-run delivery channel for it. ${AWAIT_COMPLETION}, then SendMessage to continue it. ${DEDUP_RETRY_NOTE}`,
@@ -1011,6 +1030,8 @@ export function createSendMessageTool(opts) {
1011
1030
  isError: true,
1012
1031
  };
1013
1032
  }
1033
+ if (!continuationAdmitted)
1034
+ return noContinuationLane(who);
1014
1035
  return await withTargetLane(targetLaneKey(access.scope, targetId), async () => {
1015
1036
  const l3Entry = ledger.get(resumeToolUseId);
1016
1037
  const l3RecipientKey = peerAxisToken(access.scope, "h", targetId);
@@ -1028,7 +1049,7 @@ export function createSendMessageTool(opts) {
1028
1049
  runner: opts.runner,
1029
1050
  peerOrigin: { hopChain: prospectiveChain },
1030
1051
  ...(opts.notify !== undefined && selfRef !== undefined ? { currentParentPeerRef: selfRef } : {}),
1031
- ...(opts.notify ? { notify: opts.notify } : {}),
1052
+ ...(continuationSink !== undefined ? { notify: continuationSink } : {}),
1032
1053
  ...(opts.sink ? { sink: opts.sink } : {}),
1033
1054
  registry: opts.registry,
1034
1055
  taskId: targetId,
@@ -1051,6 +1072,7 @@ export function createSendMessageTool(opts) {
1051
1072
  currentClamps: clampValuesOf(ctx, ctx.parentSpecSeat),
1052
1073
  ...(ctx.autoModeReview !== undefined ? { currentAutoModeReview: ctx.autoModeReview } : {}),
1053
1074
  currentMcpHostSeats: ctx.mountedMcp?.().hostSeats,
1075
+ currentPlacementTarget: ctx.placementTarget,
1054
1076
  });
1055
1077
  const fromPrefix = senderIsChild ? `(message from teammate "${senderLabel}")\n` : "";
1056
1078
  try {
@@ -1059,9 +1081,7 @@ export function createSendMessageTool(opts) {
1059
1081
  const marker = await resume(`${fromPrefix}[${safeSummary}] ${safeMessage}`);
1060
1082
  return {
1061
1083
  content: `Message sent — ${who} resumed in the background with its prior context intact (correlation marker [${marker}]).\n` +
1062
- (notifyWired
1063
- ? `You will be notified automatically when it completes; its reply will carry [${marker}]. Continue with other work — do not poll.`
1064
- : `Its reply will carry [${marker}], but ${NO_COMPLETION_NOTICE}.`),
1084
+ `You will be notified automatically when it completes; its reply will carry [${marker}]. Continue with other work — do not poll.`,
1065
1085
  details: { type: "send-message", status: "resumed", to, task_id: targetId, marker, summary },
1066
1086
  };
1067
1087
  }
@@ -0,0 +1,35 @@
1
+ import type { TaskRegistry } from "../core/task-registry.js";
2
+ import { type TaskNotificationPayload } from "../core/task-notification.js";
3
+ import type { SubagentRetainEntry } from "./retain-ledger.js";
4
+ /** The registry owner keys a child's own background work registers under: run-scoped work under the
5
+ * child's task id, session-scoped work under its session id (the `sessionScoped ? sessionId : taskId`
6
+ * owner read of the bash and monitor tools and of the sub-agent lanes). On a background lane the two
7
+ * differ — the task id is the row id — so a reader of "the child's work" reads both; elsewhere they are
8
+ * one key. */
9
+ export declare function childOwnerKeys(taskId: string, sessionId: string): readonly string[];
10
+ /** Running background tasks under any of `owners` (the gate's liveness read). */
11
+ export declare function runningBackgroundUnder(registry: TaskRegistry, owners: readonly string[]): number;
12
+ /**
13
+ * design/144 §1.2 — PARK a background child's `completed` notification behind its own still-running
14
+ * background tasks (207 p0g: "the child finished, but work it launched is still running — the completion
15
+ * news waits for the last of it"). Callers: the spawn settle resolve leg AND the resume settle resolve
16
+ * leg (1.284 C1 — the gate applies to every stop cycle). The frame is the PARK-TIME SNAPSHOT (seq /
17
+ * recentSteps / editedFiles composed by the caller before this call); delivery happens on the registry's
18
+ * owner-quiescence hook (the LAST settling background task's poke), exactly once (registry one-shot set
19
+ * + the `done` latch). The delivered frame's summary gets a decorative "(delivered after N …)" suffix —
20
+ * DISPLAY ONLY, not contract (tests must never lock that wording). `entry.deferredNotify` is both the
21
+ * resume-void hook (a wake cancels the watcher and drops the frame — see the SubagentRetainEntry ruling)
22
+ * and the C2 eviction-flush hook (an entry leaving the ledger delivers the frame NOW, undecorated).
23
+ */
24
+ export declare function parkCompletionNotify(deps: {
25
+ registry: TaskRegistry;
26
+ entry: SubagentRetainEntry;
27
+ /** The child's owner keys in the registry ({@link childOwnerKeys}). */
28
+ owners: readonly string[];
29
+ /** Running background-task count at park time (rides the decorative delivery suffix). */
30
+ pendingCount: number;
31
+ payload: TaskNotificationPayload;
32
+ notify: (n: TaskNotificationPayload, opts?: {
33
+ priority?: "now" | "next" | "later";
34
+ }) => void;
35
+ }): void;
@@ -0,0 +1,62 @@
1
+ import { retireTerminalDelivery } from "../core/task-notification.js";
2
+ export function childOwnerKeys(taskId, sessionId) {
3
+ return taskId === sessionId ? [taskId] : [taskId, sessionId];
4
+ }
5
+ export function runningBackgroundUnder(registry, owners) {
6
+ let n = 0;
7
+ for (const owner of owners)
8
+ n += registry.countRunningBackgroundForOwner(owner);
9
+ return n;
10
+ }
11
+ export function parkCompletionNotify(deps) {
12
+ const { registry, entry, owners, pendingCount, payload, notify } = deps;
13
+ let done = false;
14
+ const deliver = (decorated) => {
15
+ if (done)
16
+ return;
17
+ done = true;
18
+ unsubscribe();
19
+ if (entry.deferredNotify?.cancel === cancel)
20
+ entry.deferredNotify = undefined;
21
+ try {
22
+ notify(decorated
23
+ ? {
24
+ ...payload,
25
+ summary: `${payload.summary} (delivered after ${pendingCount} background ${pendingCount === 1 ? "child" : "children"} settled)`,
26
+ }
27
+ : payload, { priority: "next" });
28
+ }
29
+ catch {
30
+ }
31
+ };
32
+ const watchers = new Map();
33
+ const unsubscribe = () => {
34
+ for (const off of watchers.values())
35
+ off();
36
+ watchers.clear();
37
+ };
38
+ const arm = () => {
39
+ for (const owner of owners) {
40
+ if (watchers.has(owner) || registry.countRunningBackgroundForOwner(owner) === 0)
41
+ continue;
42
+ watchers.set(owner, registry.onBackgroundQuiescence(owner, (reason) => {
43
+ watchers.delete(owner);
44
+ if (reason === "evicted")
45
+ deliver(false);
46
+ else if (runningBackgroundUnder(registry, owners) === 0)
47
+ deliver(true);
48
+ else
49
+ arm();
50
+ }));
51
+ }
52
+ };
53
+ arm();
54
+ const cancel = () => {
55
+ if (done)
56
+ return;
57
+ done = true;
58
+ unsubscribe();
59
+ retireTerminalDelivery(notify, payload);
60
+ };
61
+ entry.deferredNotify = { ...(payload.seq !== undefined ? { seq: payload.seq } : {}), cancel, flush: () => deliver(false) };
62
+ }
@@ -5,9 +5,10 @@
5
5
  *
6
6
  * Scope: ONE direct child. A grandchild re-threads the same forward sink, and the sink does not order direct-child
7
7
  * content before grandchild frames, so scoping is EXPLICIT:
8
- * 1. the spawn site calls {@link SubagentStepRecorder.lockTo} the moment the child's taskId is known
9
- * (fork lanes: the forked sessionId; retained lanes: the pre-minted child sessionId) — after that,
10
- * only `sourceTaskId === lockedSource` frames are recorded;
8
+ * 1. the spawn site calls {@link SubagentStepRecorder.lockTo} the moment the child's task id is known
9
+ * (a background lane: its registry row id; a synchronous fork: the forked sessionId; a synchronous
10
+ * retained child: the pre-minted child sessionId; a retained wake: the woken leg's task id) — after
11
+ * that, only `sourceTaskId === lockedSource` frames are recorded;
11
12
  * 2. lanes where the child id is minted inside `runTask` (plain sync / non-retained background) anchor
12
13
  * by FRAME PAIRING instead: the runner stamps `sourceTaskId` + `parentToolCallId` together on every
13
14
  * child content event, and the DIRECT child's `parentToolCallId` is THIS delegation's own tool-call
@@ -70,9 +71,9 @@ export declare class SubagentStepRecorder {
70
71
  */
71
72
  constructor(parentToolCallId?: string);
72
73
  /**
73
- * CORE-2 — explicitly anchor the observed DIRECT child by its taskId (= its sessionId on every
74
- * delegation lane: `buildChildSpec` never sets `spec.taskId`). Call as soon as the id is known at the
75
- * spawn site. If events arrived BEFORE the anchor and the provisional lock caught a DIFFERENT source
74
+ * CORE-2 — explicitly anchor the observed DIRECT child by its task id — the `sourceTaskId` its frames
75
+ * carry (`legTaskIdOf`: its registry row id on a background lane, else its session id, since
76
+ * `buildChildSpec` never sets `spec.taskId`). Call as soon as the id is known at the spawn site. If events arrived BEFORE the anchor and the provisional lock caught a DIFFERENT source
76
77
  * (a grandchild racing through the shared sink), everything recorded so far belongs to the wrong
77
78
  * descendant — reset it and re-lock, so the projection never mixes generations.
78
79
  */
@@ -1,7 +1,7 @@
1
1
  import type { RunnerSelfSeat } from "../core/runner/contracts.js";
2
2
  import type { AgentDefinition, Model, ModelRef, TaskLimits, TerminalCause, ToolSpec } from "../core/types.js";
3
3
  export { childThinkingSeat, deploymentSubagentThinking, deploymentSubagentTierModel } from "./child-model-seat.js";
4
- import { type ExecutionEnv } from "../internal/harness.js";
4
+ import { type ExecutionEnv, type ReadFloor } from "../internal/harness.js";
5
5
  import type { TaskNotificationPayload } from "../core/task-notification.js";
6
6
  import { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX } from "../config/defaults.js";
7
7
  /**
@@ -173,9 +173,13 @@ export interface SubagentWorktreeIsolation {
173
173
  * (closure over the run's ExecutionEnv/taskRootPath — trusted, mirrors the scheduler/fork mounts). The
174
174
  * worktree-rooted env handed to {@link addWorktree} is a thin prototype view over the base env with `destroy`
175
175
  * MASKED (an own `destroy: undefined`), so tearing the worktree down can never cascade into destroying the
176
- * parent's own (possibly factory-owned) env.
176
+ * parent's own (possibly factory-owned) env. Its git starts carry the floor `parentFloor` answers as each begins (the run's base table).
177
177
  */
178
- export declare function createSubagentWorktreeHelper(baseEnv: ExecutionEnv, repoRoot: string): SubagentWorktreeIsolation;
178
+ export declare function createSubagentWorktreeHelper(baseEnv: ExecutionEnv, repoRoot: string, parentFloor: () => ReadFloor | undefined): SubagentWorktreeIsolation;
179
+ /** The one line a synchronous result carries when the call asked for the background lane (by default, by
180
+ * `run_in_background`, by its definition, or by a name) but no completion sink resolved for it — no background launch
181
+ * is made where nothing would hear it finish (`admitsBackgroundLaunch`). */
182
+ export declare const AGENT_RAN_SYNC_NO_CHANNEL_NOTE = "note: this agent ran synchronously \u2014 no completion would come back from a background agent on this mount, so the background lane is not used here.";
179
183
  /** Names an `AgentDefinition.name` must not collide with (would confuse the enum vs a real tool name). Includes the
180
184
  * default delegation tool name itself, so a child agent can't be named "Agent" even when a custom `opts.name` is set. */
181
185
  export declare const RESERVED_AGENT_NAMES: ReadonlySet<string>;
@@ -331,8 +335,8 @@ export declare const SUBAGENT_SUSPENDED_CHECKPOINT_EXPIRED = "suspended.checkpoi
331
335
  * rejects with `steering.not_running` once the child ends. The handle never reaches the model.
332
336
  */
333
337
  export interface SubagentSteerHandle {
334
- /** The child run's unified task id (`spec.taskId ?? sessionId` fallback resolves post-start, so this
335
- * is the SPAWN-time identity: the parent's tool call id — stable, unique per delegation). */
338
+ /** The child run's task id is minted inside the child's own prepare (`legTaskIdOf`), after spawn, so
339
+ * this is the SPAWN-time identity: the parent's tool call id — stable, unique per delegation. */
336
340
  parentToolCallId: string;
337
341
  /** The child's display name (taskName / agent-type), when one was threaded. */
338
342
  agentName?: string;
@@ -429,6 +433,9 @@ export declare function createSubagentResume(deps: {
429
433
  /** The RESUMING caller's own host seats (its trusted `ToolExecuteContext.mountedMcp` seats), same turn-bound reasoning: the snapshot keeps
430
434
  * none, so the resumed cycle's host-transport servers dial through the waker's seats of their names, or fail their dial without one. */
431
435
  currentMcpHostSeats?: ReadonlyMap<string, import("../core/mcp-host-seat.js").McpHostSeat> | undefined;
436
+ /** The RESUMING caller's own placement target (its trusted `ToolExecuteContext.placementTarget`), same per-wake reasoning: the snapshot
437
+ * keeps none, so the resumed cycle is minted under the waker's target — the one fence a tier-3 revival of the same agent would get. */
438
+ currentPlacementTarget?: import("../core/remote-env.js").PlacementTarget | undefined;
432
439
  /** design/176 — present iff this resume is PEER-DRIVEN (the SendMessage carrier): the resume
433
440
  * prompt takes the peer-resume trust frame (teammate header + fence label + the per-message
434
441
  * discipline block — never the operator-authority wording), and the woken cycle's inbound peer
@@ -482,7 +489,7 @@ export declare function createSubagentResume(deps: {
482
489
  * no row is charged to the pool's local half (`local`). Occupy only — the cap verdicts stay on the
483
490
  * spawn door: CC 2.1.309's resume path calls `takeConcurrencySlot` (cli309.js:288053) with no cap read.
484
491
  * Absent ⇒ the waker wakes rows only (SendMessage: every launch it makes revives a row, which counts itself). */
485
- entryGate?: Pick<DelegationEntryGate, "occupy">;
492
+ entryGate?: Pick<DelegationEntryPool, "occupy">;
486
493
  }): (content: string) => Promise<string>;
487
494
  /** Subagent transcript persistence — the RESOLVED delegation entry-caps pair (both members present;
488
495
  * see {@link resolveDelegationEntryCaps}). */
@@ -508,33 +515,14 @@ export declare function delegationEntryLedgerFootprint(registry: object): {
508
515
  keys: number;
509
516
  handles: number;
510
517
  };
511
- /** A refused entry-cap door: the coded reason plus the lane-neutral half of its prose. Each spawn
512
- * lane owns its own "Sub-agent not started…" head and its own cleanup obligations (worktree,
513
- * observer, abort listener, settlement row), which is why the gate hands back the reason instead
514
- * of the finished envelope. */
515
- interface DelegationEntryRefusal {
516
- code: "delegation.concurrency_cap" | "delegation.session_cap";
517
- text: string;
518
- }
519
- /** The gate's synchronous verdict. `release` is the local reservation's giveback (a no-op for the
520
- * registered kind, whose giveback IS its registry row settling). */
521
- type DelegationEntryAdmission = {
522
- admitted: true;
523
- release: () => void;
524
- } | {
525
- admitted: false;
526
- refusal: DelegationEntryRefusal;
527
- };
528
518
  /** Which half of the running count a started child lives in: `registered` = it has a running registry
529
519
  * row (the row IS its count), `local` = it runs with no row and is counted by the pool's in-flight map. */
530
520
  type DelegationEntryKind = "registered" | "local";
531
- /** One opened delegation entry gate (see {@link openDelegationEntryGate}). `occupy` is the pool's ONE
532
- * reservation — every child that starts running is charged through it; `admit` is the spawn door,
533
- * the two cap verdicts in front of that same reservation. A resume cycle occupies without the
534
- * verdicts: waking a retained child counts in its tree's pool but is not refused by a full one. */
535
- interface DelegationEntryGate {
521
+ /** One session tree's delegation pool ({@link delegationEntryPool}): its key and its ONE reservation, which
522
+ * every child that starts running is charged through. A CONTINUATION — a retained child woken here, or a
523
+ * stopped child revived from its durable row — only occupies: counted, never refused by a full pool. */
524
+ interface DelegationEntryPool {
536
525
  key: string | undefined;
537
- admit: (kind: DelegationEntryKind) => DelegationEntryAdmission;
538
526
  /** Reserve this pool's slot for a child of `kind`; returns the idempotent giveback. */
539
527
  occupy: (kind: DelegationEntryKind) => () => void;
540
528
  }
@@ -603,7 +591,7 @@ export interface SubagentToolOptions {
603
591
  * asynchronously, and completion fires ONE task-notification ("next" priority — design/373 §3.7 census
604
592
  * re-seat, upstream-anchored: every background-task terminal is explicitly "next" there; the earlier
605
593
  * "later doesn't derail active work" reading was the flat era's — a completion must reach a busy model
606
- * at the boundary, not at the run's closing seat). Poll/stop via TaskOutput/TaskStop. Absent ⇒ synchronous only.
594
+ * at the boundary, not at the run's closing seat). Stop via TaskStop; the result arrives in the completion notification. Absent ⇒ synchronous only.
607
595
  */
608
596
  background?: {
609
597
  registry: import("../core/task-registry.js").TaskRegistry;
@@ -619,15 +607,16 @@ export interface SubagentToolOptions {
619
607
  * the tool-execution context carries the run's own notification injector (the completion lands
620
608
  * in the PARENT's live injection queue at its next turn boundary) and this sink is not called for it —
621
609
  * one completion, one channel. It fires for a settle only WITHOUT an engine notification channel (direct
622
- * `execute()` harnesses, minimal mounts). An operator resume (`handle.resume`) is launched by no call of a run, so
623
- * its completion always goes to this sink, engine-driven or not; absent, it is not delivered. An unconditional
624
- * process-level completion tap is `RunnerDeps.onBackgroundChildEvent` (the BCE terminal frame).
610
+ * `execute()` harnesses, minimal mounts); with neither, no background launch is made — the agent runs synchronously
611
+ * (the one background admission, `admitsBackgroundLaunch`). An operator resume (`handle.resume`) is launched by no
612
+ * call of a run, so its completion always goes to this sink, engine-driven or not; absent, it is not delivered. An
613
+ * unconditional process-level completion tap is `RunnerDeps.onBackgroundChildEvent` (the BCE terminal frame).
625
614
  */
626
615
  notify?: (n: import("../core/task-notification.js").TaskNotificationPayload, opts?: {
627
616
  priority?: "now" | "next" | "later";
628
617
  }) => void;
629
618
  /** design/151 S1a: the durable execution-row ledger. Present ⇒ every background registration
630
- * writes a durable row (restart-surviving TaskOutput reads; the S1b lifecycle flip keys off the
619
+ * writes a durable row (restart-surviving host reads; the S1b lifecycle flip keys off the
631
620
  * same wiring). Absent ⇒ pre-151 in-memory-only lifecycle, unchanged. */
632
621
  agentStore?: import("../core/background-agent-store.js").BackgroundAgentStore;
633
622
  /** design/153 §7.3 — the park lane's checkpoint store where no host seat rides (a tool invoked outside a Runner task, and the
@@ -652,8 +641,13 @@ export interface SubagentToolOptions {
652
641
  * milliseconds of minting and the redemption window never exists. The hook must cover the
653
642
  * store the child session ACTUALLY lives in — copy the session tree into the durable store,
654
643
  * then re-verify, and only then resolve.
644
+ *
645
+ * `given.owner` is the child's delegation tree owner (the owner of its tree root's row as the root run read it; for a revived
646
+ * child, its own row's): a promotion that creates the durable row records exactly it — the hook derives no owner of its own.
655
647
  */
656
- ensureChildSessionDurable?: (sessionId: string) => Promise<void>;
648
+ ensureChildSessionDurable?: (sessionId: string, given: {
649
+ owner: string | null;
650
+ }) => Promise<void>;
657
651
  };
658
652
  /** Model the child runs on when neither the call nor the agent definition names one (the tool-level explicit seat).
659
653
  * Omitted too ⇒ the deployment's stated `roles.subagent` tier, else the parent run's effective model (`childModelSeat`). */
@@ -828,7 +822,7 @@ export interface SubagentToolOptions {
828
822
  export interface SubagentSpawnContext {
829
823
  /** THIS delegation tool-call's id — the spawn moment's stable coordinate. */
830
824
  toolCallId: string;
831
- /** The PARENT run's stable taskId (`spec.taskId ?? sessionId`, Runner-filled). Absent outside a Runner. */
825
+ /** The PARENT run's stable task id (its leg's single mint, `legTaskIdOf`; Runner-filled). Absent outside a Runner. */
832
826
  parentTaskId?: string;
833
827
  /** The PARENT run's session id (Runner-filled). Absent outside a Runner. */
834
828
  parentSessionId?: string;
@@ -887,17 +881,14 @@ export declare function forkWorktreeTranslationNote(parentCwd: string | undefine
887
881
  * ③ the SendMessage continuation pointer was absent — CC teaches the exact follow-up call, with the
888
882
  * summary shape, right on the card.
889
883
  * Registered sema-side deltas that STAY: the id is the unified `task_id` (CC: `agentId`); sema has no
890
- * agent output file, so the anchor's no-outputFile variant is the one reproduced; `notify: false` is
891
- * sema's honest degrade arm (CC always has a notification lane); the caller's `notes` are sema's own
884
+ * agent output file, so the anchor's no-outputFile variant is the one reproduced; like CC, a card exists only where a
885
+ * notification lane does (no sink ⇒ no background launch); the caller's `notes` are sema's own
892
886
  * per-call truths (model override, injected tools, worktree, task- vs session-scoped lifetime).
893
887
  */
894
888
  export declare function asyncLaunchedReceipt(p: {
895
889
  taskId: string;
896
890
  /** The lane's own "what is running" opener — the Agent lane and the fork lane say different things. */
897
891
  workingLine: string;
898
- /** Whether a real notification sink is wired (the receipt speaks the RUNTIME sink truth). A one-shot submission needs
899
- * no wording of its own: its ending waits for the completion its lane is owed (`DeliveryObligations`). */
900
- notify: boolean;
901
892
  /** Per-call honest notes, rendered one per line between the status line and the closing instruction. */
902
893
  notes?: (string | undefined)[];
903
894
  }): string;
@@ -906,6 +897,10 @@ export declare function asyncLaunchedReceipt(p: {
906
897
  *
907
898
  * The child runs synchronously in a fresh session (isolated context) with a narrowed tool set and
908
899
  * its own model, and returns a structured, machine-readable handoff (status / result / blockedReason / stats).
900
+ *
901
+ * The Runner passed as `runner` is also the child's deployment statement: the child resolves its read face from that Runner's
902
+ * `RunnerDeps.readFace` seat, so a host that binds this tool to a different Runner than the parent's has changed the seat the child
903
+ * reads, and the parent's `roots` still reaches the child through the restricting clamp, so the stricter side wins.
909
904
  */
910
905
  export declare function createSubagentTool(opts: SubagentToolOptions): ToolSpec;
911
906
  /**