@sema-agent/core 7.61.0 → 7.63.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 (298) hide show
  1. package/CHANGELOG.md +840 -0
  2. package/dist/agents/cascade.d.ts +11 -3
  3. package/dist/agents/cascade.js +1 -1
  4. package/dist/agents/peer-held-queue.d.ts +27 -4
  5. package/dist/agents/peer-held-queue.js +81 -36
  6. package/dist/agents/peer-session-drain.js +13 -3
  7. package/dist/agents/subagent-transcript-placement.d.ts +23 -0
  8. package/dist/agents/subagent-transcript-placement.js +14 -0
  9. package/dist/agents/subagent.d.ts +6 -1
  10. package/dist/agents/subagent.js +143 -58
  11. package/dist/agents/suspend-guard.d.ts +38 -16
  12. package/dist/agents/suspend-guard.js +9 -4
  13. package/dist/agents/verify.js +4 -3
  14. package/dist/brain/route-adjudicator.js +9 -4
  15. package/dist/core/approval-object.js +1 -1
  16. package/dist/core/arg-summary.js +1 -1
  17. package/dist/core/ask-question.d.ts +2 -2
  18. package/dist/core/canonical-json.d.ts +23 -13
  19. package/dist/core/canonical-json.js +4 -4
  20. package/dist/core/checkpoint-features.d.ts +722 -0
  21. package/dist/core/checkpoint-features.js +98 -0
  22. package/dist/core/checkpoint-queries.d.ts +47 -4
  23. package/dist/core/checkpoint-queries.js +36 -16
  24. package/dist/core/checkpoint-requirements.d.ts +12 -5
  25. package/dist/core/checkpoint-requirements.js +11 -5
  26. package/dist/core/checkpoint-row-verdict.d.ts +110 -0
  27. package/dist/core/checkpoint-row-verdict.js +245 -0
  28. package/dist/core/checkpoint-store.d.ts +76 -753
  29. package/dist/core/checkpoint-store.js +83 -144
  30. package/dist/core/compliance.d.ts +6 -2
  31. package/dist/core/compliance.js +3 -3
  32. package/dist/core/engine-attestation.d.ts +1 -1
  33. package/dist/core/engine-notice.d.ts +38 -7
  34. package/dist/core/engine-notice.js +9 -2
  35. package/dist/core/gate-fold.js +2 -2
  36. package/dist/core/git-worktree-env.d.ts +62 -3
  37. package/dist/core/git-worktree-env.js +91 -30
  38. package/dist/core/governance-codes.d.ts +9 -3
  39. package/dist/core/governance-codes.js +16 -3
  40. package/dist/core/hooks.d.ts +13 -0
  41. package/dist/core/human-input-projection.d.ts +1 -0
  42. package/dist/core/human-input-projection.js +3 -0
  43. package/dist/core/image-admission.d.ts +1 -1
  44. package/dist/core/locked-config.d.ts +2 -2
  45. package/dist/core/mcp-host-seat.js +6 -1
  46. package/dist/core/memory-engine/consolidation-driver.d.ts +33 -18
  47. package/dist/core/memory-engine/consolidation-driver.js +99 -98
  48. package/dist/core/memory-engine/consolidation.d.ts +73 -10
  49. package/dist/core/memory-engine/consolidation.js +167 -11
  50. package/dist/core/memory-engine/data-plane.d.ts +8 -4
  51. package/dist/core/memory-engine/data-plane.js +11 -6
  52. package/dist/core/memory-engine/delegation-settlement.d.ts +37 -35
  53. package/dist/core/memory-engine/delegation-settlement.js +53 -59
  54. package/dist/core/memory-engine/dual-root.d.ts +12 -6
  55. package/dist/core/memory-engine/dual-root.js +9 -5
  56. package/dist/core/memory-engine/engine.d.ts +98 -35
  57. package/dist/core/memory-engine/engine.js +477 -380
  58. package/dist/core/memory-engine/entry-scan.d.ts +8 -0
  59. package/dist/core/memory-engine/entry-scan.js +3 -0
  60. package/dist/core/memory-engine/file-backend.d.ts +29 -3
  61. package/dist/core/memory-engine/file-backend.js +66 -35
  62. package/dist/core/memory-engine/index.d.ts +7 -7
  63. package/dist/core/memory-engine/index.js +6 -6
  64. package/dist/core/memory-engine/landing-admission.d.ts +5 -3
  65. package/dist/core/memory-engine/landing-admission.js +3 -3
  66. package/dist/core/memory-engine/layout.d.ts +121 -45
  67. package/dist/core/memory-engine/layout.js +252 -102
  68. package/dist/core/memory-engine/memory-backend-contract.d.ts +19 -1
  69. package/dist/core/memory-engine/memory-backend-contract.js +320 -0
  70. package/dist/core/memory-engine/memory-deployment.d.ts +31 -8
  71. package/dist/core/memory-engine/memory-deployment.js +26 -12
  72. package/dist/core/memory-engine/scope-contract.d.ts +52 -11
  73. package/dist/core/memory-engine/scope-contract.js +68 -19
  74. package/dist/core/memory-engine/session-write-home.d.ts +3 -1
  75. package/dist/core/memory-engine/session-write-home.js +1 -1
  76. package/dist/core/memory-engine/sync-client.d.ts +3 -1
  77. package/dist/core/memory-engine/sync-client.js +7 -0
  78. package/dist/core/memory-engine/sync-report.d.ts +3 -2
  79. package/dist/core/memory-engine/sync-report.js +6 -2
  80. package/dist/core/memory-engine/tools.d.ts +2 -2
  81. package/dist/core/memory-engine/tools.js +10 -10
  82. package/dist/core/memory-engine/types.d.ts +118 -19
  83. package/dist/core/memory-engine/types.js +1 -0
  84. package/dist/core/memory-vector.d.ts +1 -1
  85. package/dist/core/memory.d.ts +10 -10
  86. package/dist/core/memory.js +15 -6
  87. package/dist/core/mode-policy.js +1 -1
  88. package/dist/core/mods/classic-events.d.ts +9 -1
  89. package/dist/core/mods/dollar.d.ts +32 -1
  90. package/dist/core/mods/dollar.js +13 -1
  91. package/dist/core/mods/kernel/events.d.ts +11 -3
  92. package/dist/core/mods/kernel/events.js +13 -10
  93. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  94. package/dist/core/mods/lifecycle-stations.js +44 -9
  95. package/dist/core/mods/session-append.d.ts +4 -1
  96. package/dist/core/mods/session-append.js +7 -0
  97. package/dist/core/mods/session-receive.js +12 -15
  98. package/dist/core/mods/stations.d.ts +70 -6
  99. package/dist/core/mods/stations.js +144 -1
  100. package/dist/core/own-property-receipt.d.ts +7 -0
  101. package/dist/core/own-property-receipt.js +3 -0
  102. package/dist/core/park-selfcheck.js +2 -2
  103. package/dist/core/pause-registry.d.ts +2 -0
  104. package/dist/core/pause-registry.js +3 -0
  105. package/dist/core/permission-rule-consent.d.ts +10 -3
  106. package/dist/core/permission-rule-consent.js +37 -24
  107. package/dist/core/permission-rule-store.d.ts +35 -1
  108. package/dist/core/permission-rule-store.js +27 -8
  109. package/dist/core/read-only-shell.js +3 -2
  110. package/dist/core/read-root-candidate.js +1 -1
  111. package/dist/core/redaction-marks.d.ts +8 -0
  112. package/dist/core/redaction-marks.js +6 -0
  113. package/dist/core/remote-env.d.ts +12 -1
  114. package/dist/core/remote-env.js +3 -0
  115. package/dist/core/resume-startup-cause.d.ts +5 -4
  116. package/dist/core/runner/child-tree.d.ts +29 -3
  117. package/dist/core/runner/child-tree.js +39 -16
  118. package/dist/core/runner/compact-session.js +5 -2
  119. package/dist/core/runner/contracts.d.ts +36 -17
  120. package/dist/core/runner/delegation-owner.d.ts +43 -0
  121. package/dist/core/runner/delegation-owner.js +59 -0
  122. package/dist/core/runner/gate-exit.js +2 -2
  123. package/dist/core/runner/inherited-ask-grants.js +1 -1
  124. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  125. package/dist/core/runner/lineage-reroot-view.js +108 -0
  126. package/dist/core/runner/memory-consolidation-driver.d.ts +6 -3
  127. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  128. package/dist/core/runner/memory-consolidation-write-judge.d.ts +2 -1
  129. package/dist/core/runner/memory-consolidation-write-judge.js +3 -2
  130. package/dist/core/runner/permission-rule-lanes.d.ts +2 -1
  131. package/dist/core/runner/permission-rule-lanes.js +2 -2
  132. package/dist/core/runner/person-path-rows.d.ts +23 -3
  133. package/dist/core/runner/person-path-rows.js +31 -4
  134. package/dist/core/runner/placement-fence.d.ts +12 -0
  135. package/dist/core/runner/placement-fence.js +20 -6
  136. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  137. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  138. package/dist/core/runner/prepare-ask-lane.js +2 -2
  139. package/dist/core/runner/prepare-caps-and-workflow.d.ts +5 -1
  140. package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
  141. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  142. package/dist/core/runner/prepare-config-doors.js +3 -4
  143. package/dist/core/runner/prepare-execution-env.js +17 -6
  144. package/dist/core/runner/prepare-hands-readface.d.ts +3 -2
  145. package/dist/core/runner/prepare-hands-readface.js +32 -10
  146. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -8
  147. package/dist/core/runner/prepare-inherited-gate.js +14 -6
  148. package/dist/core/runner/prepare-memory-engine-session.d.ts +2 -4
  149. package/dist/core/runner/prepare-memory-engine-session.js +4 -4
  150. package/dist/core/runner/prepare-memory.d.ts +3 -2
  151. package/dist/core/runner/prepare-memory.js +28 -20
  152. package/dist/core/runner/prepare-park-ask.js +4 -3
  153. package/dist/core/runner/prepare-task.js +22 -16
  154. package/dist/core/runner/prepare-workspace-restore.js +3 -6
  155. package/dist/core/runner/resume-admission.d.ts +3 -3
  156. package/dist/core/runner/resume-admission.js +6 -3
  157. package/dist/core/runner/resume-apply.d.ts +4 -0
  158. package/dist/core/runner/resume-apply.js +11 -4
  159. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  160. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  161. package/dist/core/runner/run-git-lane.d.ts +2 -0
  162. package/dist/core/runner/run-git-lane.js +4 -1
  163. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  164. package/dist/core/runner/run-harness-handlers.js +3 -2
  165. package/dist/core/runner/run-leg.js +25 -8
  166. package/dist/core/runner/run-settle-and-teardown.js +6 -4
  167. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  168. package/dist/core/runner/run-turn-boundary.js +7 -4
  169. package/dist/core/runner/runtask.js +6 -6
  170. package/dist/core/runner/steering-preview.d.ts +9 -0
  171. package/dist/core/runner/steering-preview.js +5 -0
  172. package/dist/core/runner/stream-steer-verb.js +8 -0
  173. package/dist/core/runner/terminal-account.js +1 -1
  174. package/dist/core/runner/tool-face-overlay.js +2 -0
  175. package/dist/core/runner/turn-attachments.d.ts +5 -0
  176. package/dist/core/runner/turn-attachments.js +1 -1
  177. package/dist/core/runner-deps.d.ts +8 -4
  178. package/dist/core/secret-env.d.ts +9 -6
  179. package/dist/core/secret-env.js +41 -22
  180. package/dist/core/session-checkout.d.ts +108 -0
  181. package/dist/core/session-checkout.js +485 -0
  182. package/dist/core/session-store.d.ts +13 -5
  183. package/dist/core/session-store.js +28 -4
  184. package/dist/core/session.d.ts +29 -5
  185. package/dist/core/session.js +3 -0
  186. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +6 -12
  187. package/dist/core/store-contracts/checkpoint-store-contract.js +73 -6
  188. package/dist/core/store-contracts/session-store-contract.js +61 -8
  189. package/dist/core/task-event.d.ts +28 -1
  190. package/dist/core/task-notification.d.ts +9 -1
  191. package/dist/core/task-notification.js +8 -1
  192. package/dist/core/task-registry-agent.d.ts +40 -8
  193. package/dist/core/task-registry-agent.js +57 -24
  194. package/dist/core/task-registry-shared.d.ts +33 -11
  195. package/dist/core/task-registry-workflow.js +4 -3
  196. package/dist/core/task-registry.d.ts +27 -10
  197. package/dist/core/task-registry.js +19 -13
  198. package/dist/core/task-result.d.ts +5 -5
  199. package/dist/core/task-spec-members.js +1 -1
  200. package/dist/core/task-spec.d.ts +21 -1
  201. package/dist/core/terminal-cause.d.ts +6 -6
  202. package/dist/core/tool-face.d.ts +6 -2
  203. package/dist/core/tool-face.js +1 -1
  204. package/dist/core/tool-policy.d.ts +16 -13
  205. package/dist/core/tool-policy.js +11 -10
  206. package/dist/core/tool-roster.d.ts +4 -4
  207. package/dist/core/tool-spec.d.ts +42 -19
  208. package/dist/core/types.d.ts +2 -2
  209. package/dist/core/types.js +1 -1
  210. package/dist/core/untrusted-egress.d.ts +15 -4
  211. package/dist/core/untrusted-egress.js +23 -22
  212. package/dist/core/workspace-snapshot.d.ts +3 -1
  213. package/dist/core/workspace-snapshot.js +1 -0
  214. package/dist/engine/execution-env/node-execution-env.d.ts +3 -0
  215. package/dist/engine/execution-env/node-execution-env.js +12 -5
  216. package/dist/engine/harness/types.d.ts +77 -1
  217. package/dist/engine/harness/types.js +108 -0
  218. package/dist/engine/session/import-validate.js +6 -1
  219. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  220. package/dist/engine/session/parent-chain-guard.js +1 -1
  221. package/dist/engine/session/path-to-root.d.ts +18 -3
  222. package/dist/engine/session/path-to-root.js +15 -1
  223. package/dist/engine/session/repo-utils.d.ts +12 -1
  224. package/dist/engine/session/repo-utils.js +41 -0
  225. package/dist/engine/session/session.d.ts +24 -1
  226. package/dist/engine/session/session.js +46 -2
  227. package/dist/engine/session/storage-base.d.ts +20 -0
  228. package/dist/engine/session/storage-base.js +28 -9
  229. package/dist/index.d.ts +16 -12
  230. package/dist/index.js +11 -8
  231. package/dist/internal/harness-types.d.ts +1 -1
  232. package/dist/internal/harness.d.ts +4 -3
  233. package/dist/internal/harness.js +3 -2
  234. package/dist/orchestration/run-workflow-tool.d.ts +7 -1
  235. package/dist/orchestration/run-workflow-tool.js +28 -11
  236. package/dist/orchestration/workflow-governance.d.ts +1 -1
  237. package/dist/orchestration/workflow.d.ts +6 -0
  238. package/dist/orchestration/workflow.js +5 -8
  239. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  240. package/dist/stores/file/checkpoint-store.js +7 -6
  241. package/dist/stores/file/fs-atomic.d.ts +0 -22
  242. package/dist/stores/file/fs-atomic.js +0 -17
  243. package/dist/stores/file/index.d.ts +2 -9
  244. package/dist/stores/file/index.js +2 -4
  245. package/dist/stores/file/session-store.d.ts +13 -7
  246. package/dist/stores/file/session-store.js +42 -18
  247. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  248. package/dist/tools/fs/bash-program-position.js +10 -10
  249. package/dist/tools/fs/program-read-model.d.ts +34 -10
  250. package/dist/tools/fs/program-read-model.js +37 -7
  251. package/dist/tools/fs/program-read-model.rows.js +13 -2
  252. package/dist/tools/fs/read-deny.d.ts +13 -1
  253. package/dist/tools/fs/read-deny.js +10 -2
  254. package/dist/tools/fs/removal-targets.js +5 -5
  255. package/dist/tools/fs/safety.d.ts +2 -0
  256. package/dist/tools/fs/safety.js +1 -1
  257. package/dist/tools/fs/shell-read-argv.d.ts +11 -2
  258. package/dist/tools/fs/shell-read-argv.js +45 -29
  259. package/dist/tools/fs/shell-read-bindings.d.ts +20 -2
  260. package/dist/tools/fs/shell-read-bindings.js +153 -69
  261. package/dist/tools/fs/shell-read-brace.d.ts +18 -0
  262. package/dist/tools/fs/shell-read-brace.js +79 -0
  263. package/dist/tools/fs/shell-read-check.js +29 -11
  264. package/dist/tools/fs/shell-read-establish.js +43 -22
  265. package/dist/tools/fs/shell-read-functions.js +2 -2
  266. package/dist/tools/fs/shell-read-judge.d.ts +11 -0
  267. package/dist/tools/fs/shell-read-judge.js +3 -3
  268. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  269. package/dist/tools/fs/shell-read-object-path.js +119 -0
  270. package/dist/tools/fs/shell-read-plan.d.ts +18 -0
  271. package/dist/tools/fs/shell-read-plan.js +217 -104
  272. package/dist/tools/fs/shell-read-start.d.ts +76 -13
  273. package/dist/tools/fs/shell-read-start.js +97 -17
  274. package/dist/tools/fs/shell-read-word.d.ts +10 -0
  275. package/dist/tools/fs/shell-read-word.js +9 -5
  276. package/dist/tools/fs/shell-read-workdir.d.ts +54 -14
  277. package/dist/tools/fs/shell-read-workdir.js +103 -19
  278. package/dist/tools/fs/shell-read-write-targets.js +13 -8
  279. package/dist/tools/worktree.d.ts +3 -2
  280. package/dist/tools/worktree.js +7 -35
  281. package/package.json +3 -2
  282. package/test/export-surface.snapshot.json +93 -43
  283. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  284. package/wire-changes/core-stores-sql@7.63.0.json +30 -0
  285. package/wire-changes/core@7.62.0.json +2181 -0
  286. package/wire-changes/core@7.63.0.json +3523 -0
  287. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  288. package/wire-changes/mods-kernel@7.63.0.json +30 -0
  289. package/wire-changes/primitives@7.62.0.json +30 -0
  290. package/wire-changes/primitives@7.63.0.json +445 -0
  291. package/dist/core/consolidate-scope.d.ts +0 -93
  292. package/dist/core/consolidate-scope.js +0 -98
  293. package/dist/core/credential-vocabulary.d.ts +0 -176
  294. package/dist/core/credential-vocabulary.js +0 -190
  295. package/dist/core/redaction-passes.d.ts +0 -82
  296. package/dist/core/redaction-passes.js +0 -377
  297. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  298. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -3,7 +3,7 @@ import { isAbsolute } from "node:path";
3
3
  import { backgroundChildTerminal } from "../core/delegation-frames.js";
4
4
  import { bindDelegationName } from "../core/delegation-name.js";
5
5
  import { authoredSteerOf } from "../core/input-author.js";
6
- import { principalNameOf } from "../core/principal-name.js";
6
+ import { DELEGATION_OWNER_UNBOUND, delegationOwnerOf, rowOwnerReading } from "../core/runner/delegation-owner.js";
7
7
  import { resumeRefusalDetailOf, resumeStartupCauseOf } from "../core/resume-startup-cause.js";
8
8
  import { errorCodeOf, thrownFailureOf } from "../core/runner/terminal-account.js";
9
9
  import { applyParentSpecSeat, parentSpecSeatOfCtx } from "../core/parent-spec-seat.js";
@@ -32,10 +32,11 @@ import { normalizePeerName, reservedPeerNameReason } from "./cross-session-ref.j
32
32
  import { SUBAGENT_PROMPT } from "../prompts/default.js";
33
33
  import { roleBaseOf } from "../prompt-assembly/role-base.js";
34
34
  import { readPromptRole } from "../prompt-assembly/select.js";
35
- import { hasSessionFork } from "../core/session.js";
35
+ import { declaresSubagentPlacement, hasSessionFork } from "../core/session.js";
36
36
  import { isDurablePause, pauseFamily } from "./suspend-guard.js";
37
37
  import { childRejection, childTerminalFace, childThrownText } from "./child-failure.js";
38
38
  import { forwardSafely } from "../core/runner/forward-sink.js";
39
+ import { callerPlacementSeats } from "../core/runner/child-tree.js";
39
40
  import { legTaskIdOf } from "../core/leg-identity.js";
40
41
  import { delimitUntrusted, inlineUntrusted } from "../core/untrusted-text.js";
41
42
  import { createSafeNotifier } from "../core/safe-notify.js";
@@ -47,7 +48,8 @@ import { BG_AGENT_REAP_STOP_ERROR, chosenAgentName } from "../core/task-registry
47
48
  import { readDurableOrgAdmission } from "../core/memory-admission.js";
48
49
  import { governanceRetryClass } from "../core/governance-codes.js";
49
50
  import { readSkillGrantCapture } from "../core/skill-grant.js";
50
- import { admitsBackgroundLaunch, completionResultField, oweTerminalDelivery, resolveCompletionSink, terminalFrameFacets } from "../core/task-notification.js";
51
+ import { admitsBackgroundLaunch, completionResultField, moveTerminalDelivery, oweTerminalDelivery, resolveCompletionSink, terminalFrameFacets } from "../core/task-notification.js";
52
+ import { deliverEngineNotice } from "../core/engine-notice.js";
51
53
  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";
52
54
  function rollupDelegatedCost(stats, nested) {
53
55
  if (stats.costMicroUsd === undefined)
@@ -81,6 +83,7 @@ import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "./l
81
83
  import { ObserverDigestTap, ObserverPairing, createObserverReportToolSpec, markObserverTaskId, unmarkObserverTaskId, isObserverTaskId, ObserverResumeStateError, ObserverStoppedByUserError, observerFramingPrompt, observerSlug, resolveObserverDeclaration, } from "./observer.js";
82
84
  import { SubagentStepRecorder, redactThenCut } from "./subagent-steps.js";
83
85
  import { childOwnerKeys, parkCompletionNotify, runningBackgroundUnder } from "./subagent-completion-gate.js";
86
+ import { placesSubagentTranscripts, subagentTranscriptPlacement } from "./subagent-transcript-placement.js";
84
87
  import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
85
88
  import { canonicalNameValue } from "../core/permission-rule-model.js";
86
89
  import { definitionAllowTools, inheritedChildPool, inheritedHostSeats, inheritedMcpDeclarations, withDefinitionServers, withoutWakerSeats } from "./inherited-tool-pool.js";
@@ -387,6 +390,7 @@ const SUBAGENT_ERROR_KIND_BY_CODE = {
387
390
  stream_torn: "network",
388
391
  refusal: "logic",
389
392
  length_empty: "logic",
393
+ "config.placement_not_honored": "logic",
390
394
  };
391
395
  const SUBAGENT_RETRYABLE = {
392
396
  rate_limit: true,
@@ -1084,6 +1088,28 @@ function chargeLocalDelegationInFlight(anchor, key) {
1084
1088
  live.delete(key);
1085
1089
  };
1086
1090
  }
1091
+ const REFUSAL_OCCUPANTS_LISTED = 5;
1092
+ function reachableOccupants(registry, scope, root, caller) {
1093
+ const face = registry === undefined ? undefined : registry.activeDelegationOccupants;
1094
+ if (typeof face !== "function")
1095
+ return new Map();
1096
+ try {
1097
+ return new Map(face.call(registry, scope, root, caller).filter((o) => o.reachable).map((o) => [o.id, o.name]));
1098
+ }
1099
+ catch {
1100
+ return new Map();
1101
+ }
1102
+ }
1103
+ function concurrencyOccupants(active, reachable, local) {
1104
+ const listed = active.filter((id) => reachable.has(id)).slice(0, REFUSAL_OCCUPANTS_LISTED);
1105
+ const parts = listed.map((id) => `task_id ${id} (${JSON.stringify(reachable.get(id))})`);
1106
+ const rest = active.length - listed.length;
1107
+ if (rest > 0)
1108
+ parts.push(`${rest} ${listed.length > 0 ? "more " : ""}registered`);
1109
+ if (local > 0)
1110
+ parts.push(`${local} running synchronously inside a call of this tree, no task_id`);
1111
+ return { text: parts.join(", "), stoppable: listed.length > 0 };
1112
+ }
1087
1113
  const spawnAbortedResult = (wt, fault) => notStartedResult({
1088
1114
  isError: true,
1089
1115
  content: `Sub-agent not started: the delegating call was aborted.${wt ? `\n${wt}` : ""}`,
@@ -1119,7 +1145,7 @@ function delegationEntryPool(seat) {
1119
1145
  return { key, occupy: (kind) => (kind === "local" ? chargeLocalDelegationInFlight(seat.poolAnchor, key) : noopRelease) };
1120
1146
  }
1121
1147
  async function openDelegationEntryGate(input) {
1122
- const { poolAnchor, registry, store, root, caps, signal } = input;
1148
+ const { poolAnchor, registry, store, root, caps, signal, caller } = input;
1123
1149
  const pool = delegationEntryPool(input);
1124
1150
  if (root === undefined)
1125
1151
  return { ...pool, admit: () => ({ admitted: true, release: noopRelease }) };
@@ -1143,11 +1169,13 @@ async function openDelegationEntryGate(input) {
1143
1169
  const local = localDelegationInFlightCount(poolAnchor, key);
1144
1170
  const running = active.length + local;
1145
1171
  if (running >= caps.maxConcurrent) {
1172
+ const who = concurrencyOccupants(active, reachableOccupants(registry, scope, root, { ...caller, scope }), local);
1173
+ const stop = who.stoppable ? " or stop a listed one (TaskStop with its task_id)" : "";
1146
1174
  return {
1147
1175
  admitted: false,
1148
1176
  refusal: {
1149
1177
  code: "delegation.concurrency_cap",
1150
- text: `this session tree already has ${running} agents running — the concurrency cap (${caps.maxConcurrent}; RunnerDeps.delegationEntryCaps.maxConcurrent) refuses another. ${kind === "registered" ? "Wait for one to complete (you will be notified) or stop one, then relaunch." : "Wait for one of them to finish or stop one, then try again."}`,
1178
+ text: `this session tree already has ${running} agents running${who.text === "" ? "" : ` (${who.text})`} — the concurrency cap (${caps.maxConcurrent}; RunnerDeps.delegationEntryCaps.maxConcurrent) refuses another. ${kind === "registered" ? `Wait for one to complete (you will be notified)${stop}, then relaunch.` : `Wait for one of them to finish${stop}, then try again.`}`,
1151
1179
  },
1152
1180
  };
1153
1181
  }
@@ -1511,7 +1539,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1511
1539
  const a = canonicalSubagentTypeArgs(args, acceptedSubagentTypes(), generalPurposeShadowed);
1512
1540
  const parentSpecSeat = parentSpecSeatOfCtx(ctx);
1513
1541
  const reviveClaim = ctx.reviveClaim;
1514
- const backgroundSink = opts.background !== undefined ? resolveCompletionSink(ctx.onTaskNotification, opts.background.notify) : undefined;
1542
+ const parkedLane = reviveClaim?.parkedResume !== undefined ? opts.background?.registry.parkedCompletionSink(reviveClaim.row.handle) : undefined;
1543
+ const backgroundSink = opts.background !== undefined ? resolveCompletionSink(ctx.onTaskNotification ?? parkedLane, opts.background.notify) : undefined;
1515
1544
  const backgroundLane = opts.background !== undefined && admitsBackgroundLaunch(backgroundSink);
1516
1545
  if (reviveClaim !== undefined && !backgroundLane) {
1517
1546
  return notStartedResult({
@@ -1815,6 +1844,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1815
1844
  ...(cause !== undefined ? { cause: childThrownText(cause) } : {}),
1816
1845
  ...(worktreeFault !== undefined ? { worktreeCause: worktreeFault } : {}),
1817
1846
  });
1847
+ const ownerUnboundResult = async (background, tree) => {
1848
+ const wt = await finishWorktree();
1849
+ return notStartedResult(errorResult(`${background ? "Sub-agent not started in background" : "Sub-agent not started"}: the delegation tree's owner does not bind — ${tree.reason.slice(0, 600)}.${wt ? `\n${wt.slice(0, 1600)}` : ""}`, { error: DELEGATION_OWNER_UNBOUND, code: DELEGATION_OWNER_UNBOUND, ...faultDetails(tree.fault) }));
1850
+ };
1818
1851
  let injectedTools = [];
1819
1852
  let extraToolsNote;
1820
1853
  const treeBudget = extraToolsBudget ?? { used: 0 };
@@ -2143,7 +2176,14 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2143
2176
  ? (reviveClaim.row.rootSessionId ?? reviveClaim.row.parentSessionId ?? (reviveClaim.row.sessionScoped ? reviveClaim.row.owner : undefined))
2144
2177
  : (ctx.rootSessionId ?? ctx.sessionId);
2145
2178
  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 });
2179
+ const openEntryGate = () => openDelegationEntryGate({
2180
+ ...entryPoolSeat,
2181
+ registry: opts.background?.registry,
2182
+ store: opts.background?.agentStore,
2183
+ caps: entryCaps,
2184
+ signal: ctx.signal,
2185
+ caller: { owner: ctx.taskId ?? opts.background?.owner, ...(ctx.sessionId !== undefined ? { sessionId: ctx.sessionId } : {}) },
2186
+ });
2147
2187
  const provenanceRequest = ctx.delegationProvenanceForChildren?.();
2148
2188
  const childProvenanceRef = provenanceRequest !== undefined ? { current: newDelegationProvenanceAggregate() } : undefined;
2149
2189
  const childAttestation = (completed) => childProvenanceRef !== undefined ? reduceDelegationAttestation(childProvenanceRef.current, { completed }) : undefined;
@@ -2162,6 +2202,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2162
2202
  ...(inheritedAllowedTools !== undefined && inheritedAllowedTools.length > 0 ? { inheritedAllowedTools: [...inheritedAllowedTools] } : {}),
2163
2203
  ...(childProvenanceRef !== undefined && provenanceRequest !== undefined ? { delegationProvenance: { ref: childProvenanceRef, contentSafety: provenanceRequest } } : {}),
2164
2204
  ...(reviveClaim === undefined && ctx.crossBoundaryTreeForChildren !== undefined ? { crossBoundaryTree: ctx.crossBoundaryTreeForChildren } : {}),
2205
+ ...(reviveClaim === undefined && ctx.delegationOwner !== undefined ? { delegationOwner: ctx.delegationOwner } : {}),
2165
2206
  ...(treeScope !== undefined ? { registryScope: treeScope } : {}),
2166
2207
  ...(ctx.checkpointScopeForChildren !== undefined ? { checkpointScope: ctx.checkpointScopeForChildren } : {}),
2167
2208
  ...(ctx.inheritedGateForChildren ? { inheritedGate: ctx.inheritedGateForChildren() } : {}),
@@ -2220,7 +2261,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2220
2261
  })(),
2221
2262
  ...(ctx.subagentRetain !== undefined ? { parentRetainLedger: ctx.subagentRetain } : {}),
2222
2263
  onForwardEvent: recordingForward,
2223
- ...(ctx.parentCwd !== undefined ? { callerRoot: ctx.parentCwd } : {}),
2264
+ ...callerPlacementSeats(ctx.parentCwd, ctx.callerRoot),
2224
2265
  ...(ctx.placementTarget !== undefined ? { placementTarget: ctx.placementTarget } : {}),
2225
2266
  ...(worktreeDir !== undefined
2226
2267
  ? { parentCwd: worktreeDir, worktreeOffered: true, onWorkspaceResolved: (ws) => void (childPlacement = ws) }
@@ -2455,14 +2496,20 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2455
2496
  if (wantsFork) {
2456
2497
  let forkedId;
2457
2498
  let releaseForked;
2499
+ const forkTree = await delegationOwnerOf(ctx.delegationOwner);
2500
+ if (!forkTree.bound)
2501
+ return ownerUnboundResult(false, forkTree);
2502
+ const forkBg = wantsBackground ? opts.background : undefined;
2503
+ const forkPlacementHandle = forkBg?.agentStore !== undefined ? forkBg.registry.mintTaskId("background_agent") : undefined;
2504
+ const forkOpts = forkPlacementHandle !== undefined ? { placement: subagentTranscriptPlacement(ctx, treeScope, forkPlacementHandle) } : undefined;
2458
2505
  try {
2459
2506
  if (ctx.hostSessionFork) {
2460
- const forkHandle = await ctx.hostSessionFork();
2507
+ const forkHandle = await ctx.hostSessionFork(forkOpts);
2461
2508
  forkedId = forkHandle?.sessionId ?? null;
2462
2509
  releaseForked = forkHandle?.release;
2463
2510
  }
2464
2511
  else {
2465
- forkedId = (await opts.runner.sessions.fork?.(ctx.sessionId, principalNameOf(ctx.principal) ?? null)) ?? null;
2512
+ forkedId = (await opts.runner.sessions.fork?.(ctx.sessionId, forkTree.owner, declaresSubagentPlacement(opts.runner.sessions) ? forkOpts : undefined)) ?? null;
2466
2513
  }
2467
2514
  }
2468
2515
  catch (e) {
@@ -2512,7 +2559,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2512
2559
  const forkSettleId = forkSettlementSeat !== undefined ? `bg-${uuidv7()}` : undefined;
2513
2560
  if (forkSettlementSeat !== undefined && forkSettleId !== undefined) {
2514
2561
  try {
2515
- registerDelegationLaunch(forkSettlementSeat.controlDir, { settleId: forkSettleId, sessionId: forkSettlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
2562
+ await registerDelegationLaunch(forkSettlementSeat.governance, { settleId: forkSettleId, sessionId: forkSettlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
2516
2563
  }
2517
2564
  catch (e) {
2518
2565
  dropHostAbortListener();
@@ -2524,7 +2571,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2524
2571
  });
2525
2572
  }
2526
2573
  }
2527
- const settleForkRow = (terminal) => {
2574
+ const settleForkRow = async (terminal) => {
2528
2575
  if (forkSettlementSeat === undefined || forkSettleId === undefined)
2529
2576
  return;
2530
2577
  const att = terminal !== undefined ? childAttestation(terminal.kind === "completed") : undefined;
@@ -2533,7 +2580,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2533
2580
  let lastErr;
2534
2581
  for (let attempt = 0; attempt < 3 && !settled; attempt++) {
2535
2582
  try {
2536
- settleDelegation(forkSettlementSeat.controlDir, { settleId: forkSettleId, status: verdict, now: Date.now });
2583
+ await settleDelegation(forkSettlementSeat.governance, { settleId: forkSettleId, status: verdict, now: Date.now });
2537
2584
  settled = true;
2538
2585
  }
2539
2586
  catch (e) {
@@ -2542,7 +2589,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2542
2589
  }
2543
2590
  if (settled && verdict === "external") {
2544
2591
  try {
2545
- replayExternalSettlementEffects(forkSettlementSeat.controlDir, { carry: true, now: Date.now });
2592
+ await replayExternalSettlementEffects(forkSettlementSeat.governance, forkSettlementSeat.controlDir, { carry: true, now: Date.now });
2546
2593
  }
2547
2594
  catch {
2548
2595
  }
@@ -2555,6 +2602,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2555
2602
  let taskId;
2556
2603
  try {
2557
2604
  taskId = bg.registry.registerBackgroundAgent({
2605
+ ...(forkPlacementHandle !== undefined ? { id: forkPlacementHandle } : {}),
2558
2606
  ...(bgOwner !== undefined ? { owner: bgOwner } : {}),
2559
2607
  ...(bgScope !== undefined ? { scope: bgScope } : {}),
2560
2608
  ...(sessionScopedBg ? { sessionScoped: true } : {}),
@@ -2582,7 +2630,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2582
2630
  const wt = await finishWorktree();
2583
2631
  if (forkSettlementSeat !== undefined && forkSettleId !== undefined) {
2584
2632
  try {
2585
- settleDelegation(forkSettlementSeat.controlDir, { settleId: forkSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
2633
+ await settleDelegation(forkSettlementSeat.governance, { settleId: forkSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
2586
2634
  }
2587
2635
  catch {
2588
2636
  }
@@ -2593,7 +2641,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2593
2641
  chargeDelegationEntryHandle(bg.registry, forkEntryGate.key, bg.agentStore, taskId);
2594
2642
  oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
2595
2643
  childInternals.peerSelfRef?.addAxis("h", taskId);
2596
- bg.registry.bindBackgroundAgentSession(taskId, forkedId);
2644
+ bg.registry.bindBackgroundAgentSession(taskId, forkedId, opts.runner.sessions);
2597
2645
  stepRecorder.lockTo(taskId);
2598
2646
  const forkBgHangAt = Date.now();
2599
2647
  bg.registry.attachAgentTerminalNotifier(taskId, () => {
@@ -2726,8 +2774,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2726
2774
  void bgForkChild
2727
2775
  .then(async (child) => {
2728
2776
  const childFace = childTerminalFace(child.terminal);
2729
- settleForkRow(child.terminal);
2777
+ const forkSettled = settleForkRow(child.terminal);
2730
2778
  dropHostAbortListener();
2779
+ await forkSettled;
2731
2780
  await finishWorktree(child.terminal);
2732
2781
  try {
2733
2782
  const nsb = child.stats.nested;
@@ -2808,7 +2857,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2808
2857
  }
2809
2858
  })
2810
2859
  .catch((e) => {
2811
- settleForkRow({ kind: "failed" });
2860
+ void settleForkRow({ kind: "failed" });
2812
2861
  dropHostAbortListener();
2813
2862
  void finishWorktree();
2814
2863
  const killed = abort.signal.aborted;
@@ -2981,6 +3030,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2981
3030
  const abort = new AbortController();
2982
3031
  const reviveRow = reviveClaim?.row;
2983
3032
  const parkedResume = reviveClaim?.parkedResume;
3033
+ let cycleSink = parkedResume !== undefined && parkedLane !== undefined ? parkedLane : notify;
2984
3034
  const sessionScopedBg = reviveRow !== undefined ? reviveRow.sessionScoped : ctx.backgroundScope === "session" && ctx.sessionId !== undefined;
2985
3035
  const outlivesThisRequest = sessionScopedBg || reviveRow !== undefined;
2986
3036
  const onHostAbort = () => abort.abort();
@@ -2994,6 +3044,17 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2994
3044
  const shortDesc = reviveRow?.description ?? String(a.description ?? "sub-agent").slice(0, 200);
2995
3045
  const bgOwner = reviveRow !== undefined ? reviveRow.owner : sessionScopedBg ? ctx.sessionId : ctx.taskId ?? bg.owner;
2996
3046
  const bgScope = treeScope;
3047
+ const childTreeOwner = () => (reviveRow !== undefined ? rowOwnerReading(opts.runner.sessions, reviveRow.sessionId) : delegationOwnerOf(ctx.delegationOwner));
3048
+ let placedTreeOwner;
3049
+ if (reviveRow === undefined && placesSubagentTranscripts(bg.agentStore, opts.runner.sessions)) {
3050
+ const tree = await childTreeOwner();
3051
+ if (!tree.bound) {
3052
+ dropHostAbortListener();
3053
+ await cancelObserver();
3054
+ return ownerUnboundResult(true, tree);
3055
+ }
3056
+ placedTreeOwner = tree.owner;
3057
+ }
2997
3058
  const bgEntryPool = delegationEntryPool(entryPoolSeat);
2998
3059
  const capLedgerKey = bgEntryPool.key;
2999
3060
  if (reviveRow !== undefined) {
@@ -3012,7 +3073,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3012
3073
  const bgSettleId = settlementSeat !== undefined ? `bg-${uuidv7()}` : undefined;
3013
3074
  if (settlementSeat !== undefined && bgSettleId !== undefined) {
3014
3075
  try {
3015
- registerDelegationLaunch(settlementSeat.controlDir, { settleId: bgSettleId, sessionId: settlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
3076
+ await registerDelegationLaunch(settlementSeat.governance, { settleId: bgSettleId, sessionId: settlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
3016
3077
  }
3017
3078
  catch (e) {
3018
3079
  dropHostAbortListener();
@@ -3025,7 +3086,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3025
3086
  });
3026
3087
  }
3027
3088
  }
3028
- const settleDelegationRow = (terminal) => {
3089
+ const settleDelegationRow = async (terminal) => {
3029
3090
  if (settlementSeat === undefined || bgSettleId === undefined)
3030
3091
  return;
3031
3092
  const att = terminal !== undefined ? childAttestation(terminal.kind === "completed") : undefined;
@@ -3034,7 +3095,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3034
3095
  let lastErr;
3035
3096
  for (let attempt = 0; attempt < 3 && !settled; attempt++) {
3036
3097
  try {
3037
- settleDelegation(settlementSeat.controlDir, { settleId: bgSettleId, status: verdict, now: Date.now });
3098
+ await settleDelegation(settlementSeat.governance, { settleId: bgSettleId, status: verdict, now: Date.now });
3038
3099
  settled = true;
3039
3100
  }
3040
3101
  catch (e) {
@@ -3043,7 +3104,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3043
3104
  }
3044
3105
  if (settled && verdict === "external") {
3045
3106
  try {
3046
- replayExternalSettlementEffects(settlementSeat.controlDir, { carry: true, now: Date.now });
3107
+ await replayExternalSettlementEffects(settlementSeat.governance, settlementSeat.controlDir, { carry: true, now: Date.now });
3047
3108
  }
3048
3109
  catch {
3049
3110
  }
@@ -3114,7 +3175,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3114
3175
  const wt = await finishWorktree();
3115
3176
  if (settlementSeat !== undefined && bgSettleId !== undefined) {
3116
3177
  try {
3117
- settleDelegation(settlementSeat.controlDir, { settleId: bgSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
3178
+ await settleDelegation(settlementSeat.governance, { settleId: bgSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
3118
3179
  }
3119
3180
  catch {
3120
3181
  }
@@ -3123,7 +3184,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3123
3184
  }
3124
3185
  if (capLedgerKey !== undefined)
3125
3186
  chargeDelegationEntryHandle(bg.registry, capLedgerKey, bg.agentStore, reviveRow === undefined ? taskId : undefined);
3126
- oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
3187
+ if (parkedResume === undefined)
3188
+ oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
3127
3189
  childInternals.peerSelfRef?.addAxis("h", taskId);
3128
3190
  if (agentName !== undefined) {
3129
3191
  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" }));
@@ -3139,26 +3201,32 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3139
3201
  const bgChildSessionId = reviveRow?.sessionId ?? uuidv7();
3140
3202
  const bgStartedAt = Date.now();
3141
3203
  stepRecorder.lockTo(taskId);
3142
- bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId);
3204
+ bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId, opts.runner.sessions);
3143
3205
  const bgCycleSeq = bg.registry.backgroundAgentCycleSeq(taskId);
3144
- bg.registry.attachAgentTerminalNotifier(taskId, () => {
3145
- const stoppedByReap = bg.registry.getStopAttribution(taskId) ?? "system";
3146
- const completionIdReap = bg.registry.getCompletionId(taskId);
3147
- const seqReap = bg.registry.backgroundAgentCycleSeq(taskId);
3148
- const reapFrame = {
3206
+ let retainedCycle;
3207
+ const cycleSeqOfFrames = () => retainedCycle?.cycleSeq ?? (parkedResume !== undefined ? (reviveRow?.seq ?? 1) + 1 : reviveRow?.seq);
3208
+ bg.registry.attachAgentTerminalNotifier(taskId, (ending) => {
3209
+ const stoppedByLanded = ending.status === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
3210
+ const completionIdLanded = bg.registry.getCompletionId(taskId);
3211
+ const seqLanded = bg.registry.backgroundAgentCycleSeq(taskId);
3212
+ const landedElapsedMs = Date.now() - bgStartedAt;
3213
+ const landedFrame = {
3149
3214
  task_id: taskId,
3150
3215
  task_type: "background_agent",
3151
3216
  toolUseId: ctx.toolCallId,
3152
- status: "killed",
3217
+ status: ending.status,
3153
3218
  ...terminalFrameFacets({ spawnName: agentName }),
3154
- stoppedBy: stoppedByReap,
3155
- summary: ccCompletionText(shortDesc, "killed", "killed", Date.now() - bgStartedAt),
3219
+ ...(cycleSeqOfFrames() !== undefined ? { seq: cycleSeqOfFrames() } : {}),
3220
+ ...(stoppedByLanded !== undefined ? { stoppedBy: stoppedByLanded } : {}),
3221
+ summary: ending.status === "failed" ? `Agent "${shortDesc}" failed: ${ending.error ?? "ended"}${ccElapsedTag(landedElapsedMs)}`.slice(0, 300) : ccCompletionText(shortDesc, "killed", "killed", landedElapsedMs),
3222
+ ...(ending.status === "failed" && ending.error !== undefined ? { error: ending.error.slice(0, REPORT_FIELD_MAX) } : {}),
3156
3223
  sessionId: bgChildSessionId,
3157
3224
  resumable: false,
3158
- ...(completionIdReap !== undefined ? { completionId: completionIdReap } : {}),
3225
+ ...(completionIdLanded !== undefined ? { completionId: completionIdLanded } : {}),
3159
3226
  };
3160
- sinkEmit(backgroundChildTerminal(reapFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(seqReap !== undefined ? { generation: seqReap } : {}) }));
3161
- notifier.notify(() => notify(reapFrame, { priority: "next" }), "subagent.reapTerminalNotify");
3227
+ sinkEmit(backgroundChildTerminal(landedFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(seqLanded !== undefined ? { generation: seqLanded } : {}) }));
3228
+ const landedLane = ending.parkLane ?? cycleSink;
3229
+ notifier.notify(() => landedLane?.(landedFrame, { priority: "next" }), "subagent.landedTerminalNotify");
3162
3230
  });
3163
3231
  const bgDurableProbe = bg.registry.durableAgentRowProbe(taskId);
3164
3232
  const bgRowConfirmed = async () => (bgDurableProbe ? await bgDurableProbe().catch(() => false) : false);
@@ -3199,6 +3267,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3199
3267
  if (sessionScopedBg && bgRetainLedger)
3200
3268
  ensureSessionReapHook(bg.registry);
3201
3269
  const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe, { registry: bg.registry, taskId }, backgroundLegFacts(taskId));
3270
+ retainedCycle = bgRetain;
3202
3271
  if (bgRetain) {
3203
3272
  bg.registry.markRetainedContinuation(taskId);
3204
3273
  const origRelease = bgRetain.release;
@@ -3207,7 +3276,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3207
3276
  await origRelease();
3208
3277
  };
3209
3278
  }
3210
- bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId);
3279
+ bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId, opts.runner.sessions);
3211
3280
  const forwardDurableApproval = ctx.durableApprovalForChildren !== undefined &&
3212
3281
  bg.agentStore !== undefined &&
3213
3282
  childParkStore !== undefined &&
@@ -3250,16 +3319,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3250
3319
  usage: { toolUses: toolStarts },
3251
3320
  });
3252
3321
  }, () => bg.registry.noteBackgroundAgentActivity(taskId));
3253
- const bgPlacementRoot = reviveRow !== undefined ? (reviveRow.rootSessionId ?? reviveRow.parentSessionId) : (ctx.rootSessionId ?? ctx.sessionId);
3254
- const bgPlacementParent = reviveRow !== undefined ? reviveRow.parentSessionId : ctx.sessionId;
3255
- const bgPlacement = bg.agentStore !== undefined && opts.runner.sessions.placements?.subagent !== undefined
3256
- ? {
3257
- kind: "subagent",
3258
- ...(bgScope !== undefined ? { scope: bgScope } : {}),
3259
- ...(bgPlacementParent !== undefined ? { parentSessionId: bgPlacementParent } : {}),
3260
- ...(bgPlacementRoot !== undefined ? { rootSessionId: bgPlacementRoot } : {}),
3261
- handle: taskId,
3262
- }
3322
+ const bgPlacement = placedTreeOwner !== undefined
3323
+ ? { ...subagentTranscriptPlacement(ctx, bgScope, taskId), owner: placedTreeOwner }
3263
3324
  : undefined;
3264
3325
  const bgInternals = bgSink
3265
3326
  ? {
@@ -3316,6 +3377,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3316
3377
  const driveParkedResume = async () => {
3317
3378
  const pr = parkedResume;
3318
3379
  const claimStores = { agentStore: bg.agentStore, checkpointStore: childParkStore };
3380
+ let consumed = false;
3319
3381
  const rollbackAndThrow = async (e) => {
3320
3382
  let disp = "retry";
3321
3383
  try {
@@ -3323,6 +3385,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3323
3385
  }
3324
3386
  catch {
3325
3387
  }
3388
+ if (!consumed && disp !== "failed")
3389
+ cycleSink = undefined;
3326
3390
  const msg = thrownText(e);
3327
3391
  throw new Error(disp === "rolled_back"
3328
3392
  ? `parked resume rolled back — the approval is still pending (retryable): ${msg}`
@@ -3381,6 +3445,16 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3381
3445
  const won = await bg.registry.consumeParkedFlip(taskId, { agentStore: bg.agentStore }, pr.ticket);
3382
3446
  if (!won)
3383
3447
  throw new Error("the parked row moved under the resume (a stop or another transition won) — resume aborted");
3448
+ moveTerminalDelivery(parkedLane, notify, { task_id: taskId, task_type: "background_agent" });
3449
+ cycleSink = notify;
3450
+ consumed = true;
3451
+ if (parkedLane === undefined && ctx.onTaskNotification === undefined) {
3452
+ deliverEngineNotice(undefined, {
3453
+ code: "delegation.resume_lane_missing",
3454
+ message: `the parked agent ${taskId} was resumed with no run lane in this process to complete into (it parked in another process, or before this one restarted): its completion goes to the deployment's background channel, and a submission still waiting on it elsewhere is not settled by it`,
3455
+ detail: { taskId, ...(reviveRow?.rootSessionId !== undefined ? { rootSessionId: reviveRow.rootSessionId } : {}) },
3456
+ });
3457
+ }
3384
3458
  };
3385
3459
  let childResult;
3386
3460
  try {
@@ -3427,8 +3501,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3427
3501
  reopened = false;
3428
3502
  }
3429
3503
  if (reopened) {
3430
- bg.registry.parkBackgroundAgent(taskId, {
3504
+ const reParked = bg.registry.parkBackgroundAgent(taskId, {
3431
3505
  checkpointToken: pr.ticket.token,
3506
+ completionSink: cycleSink,
3432
3507
  resolveStop: async () => {
3433
3508
  const cpS = childParkStore;
3434
3509
  const cp = (await cpS.get(pr.ticket.token));
@@ -3437,6 +3512,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3437
3512
  return await cpS.expire(pr.ticket.token, cp.scope);
3438
3513
  },
3439
3514
  });
3515
+ if (reParked === "parked")
3516
+ cycleSink = undefined;
3440
3517
  throw new Error(`parked resume could not complete and the approval was REOPENED (still approvable/retryable): ${childResult.terminal.message ?? "failed"}`, { cause: childResult.terminal });
3441
3518
  }
3442
3519
  }
@@ -3459,9 +3536,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3459
3536
  void bgChildPromise
3460
3537
  .then(async (child) => {
3461
3538
  const childFace = childTerminalFace(child.terminal);
3462
- settleDelegationRow(child.terminal);
3539
+ const rowSettled = settleDelegationRow(child.terminal);
3463
3540
  closeObserverWindow(childFace.status);
3464
3541
  dropHostAbortListener();
3542
+ await rowSettled;
3465
3543
  await finishWorktree(child.terminal);
3466
3544
  try {
3467
3545
  const ns2 = child.stats.nested;
@@ -3474,7 +3552,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3474
3552
  }
3475
3553
  catch {
3476
3554
  }
3477
- const seqAtSettle = bgRetain?.cycleSeq ?? (parkedResume !== undefined ? (reviveRow?.seq ?? 1) + 1 : reviveRow?.seq);
3555
+ const seqAtSettle = cycleSeqOfFrames();
3478
3556
  const bgHandbackWarning = isDurablePause(child.terminal)
3479
3557
  ? undefined
3480
3558
  : await reviewHandback({
@@ -3517,7 +3595,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3517
3595
  else {
3518
3596
  let attested = false;
3519
3597
  try {
3520
- await bg.ensureChildSessionDurable(bgChildSessionId);
3598
+ const tree = placedTreeOwner !== undefined ? { bound: true, owner: placedTreeOwner } : await childTreeOwner();
3599
+ if (!tree.bound)
3600
+ throw new Error(tree.reason);
3601
+ await bg.ensureChildSessionDurable(bgChildSessionId, { owner: tree.owner });
3521
3602
  attested = true;
3522
3603
  }
3523
3604
  catch {
@@ -3527,6 +3608,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3527
3608
  ? bg.registry.parkBackgroundAgent(taskId, {
3528
3609
  checkpointToken: token,
3529
3610
  seq: seqAtSettle ?? 1,
3611
+ completionSink: cycleSink,
3530
3612
  resolveStop: async () => {
3531
3613
  const cpS = childParkStore;
3532
3614
  const cp = (await cpS.get(token));
@@ -3594,7 +3676,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3594
3676
  const bgTerminalSummary = failReasonBg !== undefined
3595
3677
  ? `Agent "${shortDesc}" failed: ${failReasonBg}${ccElapsedTag(bgElapsedMs)}${observerNote}`.slice(0, 300) + errorKindClause(errClassBg)
3596
3678
  : `${ccCompletionText(shortDesc, settled, childFace.status, bgElapsedMs)}${observerNote}`;
3597
- const ownsTerminalFaces = bg.registry.claimAgentTerminalNotify(taskId);
3679
+ const completionSink = cycleSink;
3680
+ const ownsTerminalFaces = completionSink !== undefined && bg.registry.claimAgentTerminalNotify(taskId);
3598
3681
  const bgResultField = await completionResultField(bgHandbackResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report), (ref) => bg.registry.recordArtifactRef(taskId, ref, completionIdBg), notifier);
3599
3682
  const completionFrame = {
3600
3683
  task_id: taskId,
@@ -3627,24 +3710,25 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3627
3710
  owners: gateOwners,
3628
3711
  pendingCount: aliveBgCount,
3629
3712
  payload: completionFrame,
3630
- notify,
3713
+ notify: completionSink,
3631
3714
  });
3632
3715
  }
3633
3716
  else if (ownsTerminalFaces) {
3634
3717
  try {
3635
- notify(completionFrame, { priority: "next" });
3718
+ completionSink(completionFrame, { priority: "next" });
3636
3719
  }
3637
3720
  catch {
3638
3721
  }
3639
3722
  }
3640
3723
  })
3641
3724
  .catch(async (e) => {
3642
- settleDelegationRow({ kind: "failed" });
3725
+ const rowSettled = settleDelegationRow({ kind: "failed" });
3643
3726
  closeObserverWindow("failed");
3644
3727
  dropHostAbortListener();
3728
+ await rowSettled;
3645
3729
  void finishWorktree();
3646
3730
  const killed = abort.signal.aborted;
3647
- const seqAtSettle = bgRetain?.cycleSeq ?? (parkedResume !== undefined ? (reviveRow?.seq ?? 1) + 1 : reviveRow?.seq);
3731
+ const seqAtSettle = cycleSeqOfFrames();
3648
3732
  if (bgRetain) {
3649
3733
  if (killed)
3650
3734
  void bgRetainLedger?.evict(ctx.toolCallId);
@@ -3669,7 +3753,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3669
3753
  }
3670
3754
  const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
3671
3755
  const observerNote = observerNoteFor(await startBoundedObserverDrain());
3672
- const ownsTerminalFacesReject = bg.registry.claimAgentTerminalNotify(taskId);
3756
+ const rejectSink = cycleSink;
3757
+ const ownsTerminalFacesReject = rejectSink !== undefined && bg.registry.claimAgentTerminalNotify(taskId);
3673
3758
  const rejectFrame = {
3674
3759
  task_id: taskId,
3675
3760
  task_type: "background_agent",
@@ -3688,7 +3773,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3688
3773
  sinkEmit(backgroundChildTerminal(rejectFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(bgCycleSeq !== undefined ? { generation: bgCycleSeq } : {}) }));
3689
3774
  try {
3690
3775
  if (ownsTerminalFacesReject)
3691
- notify(rejectFrame, { priority: "next" });
3776
+ rejectSink(rejectFrame, { priority: "next" });
3692
3777
  }
3693
3778
  catch {
3694
3779
  }