@sema-agent/core 7.62.0 → 7.64.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 (320) hide show
  1. package/CHANGELOG.md +936 -0
  2. package/dist/agents/cc-peer-directory.js +1 -0
  3. package/dist/agents/cc-peer-wire.d.ts +4 -0
  4. package/dist/agents/cc-peer-wire.js +1 -0
  5. package/dist/agents/cc-uds-peer-channel.js +5 -0
  6. package/dist/agents/cross-session-judge.d.ts +3 -1
  7. package/dist/agents/cross-session-judge.js +4 -1
  8. package/dist/agents/peer-directory.d.ts +8 -0
  9. package/dist/agents/peer-directory.js +4 -0
  10. package/dist/agents/peer-held-queue.d.ts +9 -3
  11. package/dist/agents/peer-held-queue.js +12 -9
  12. package/dist/agents/peer-idle.d.ts +20 -1
  13. package/dist/agents/peer-idle.js +23 -12
  14. package/dist/agents/peer-notice-route.d.ts +16 -5
  15. package/dist/agents/peer-notice-route.js +11 -9
  16. package/dist/agents/peer-notices.d.ts +25 -8
  17. package/dist/agents/peer-notices.js +6 -1
  18. package/dist/agents/peer-session-drain.d.ts +32 -6
  19. package/dist/agents/peer-session-drain.js +100 -26
  20. package/dist/agents/send-message-tool.d.ts +7 -0
  21. package/dist/agents/send-message-tool.js +18 -6
  22. package/dist/agents/subagent-transcript-placement.d.ts +23 -0
  23. package/dist/agents/subagent-transcript-placement.js +14 -0
  24. package/dist/agents/subagent.js +102 -54
  25. package/dist/brain/route-adjudicator.js +9 -4
  26. package/dist/core/allow-entry.d.ts +4 -0
  27. package/dist/core/approval-object.js +1 -1
  28. package/dist/core/arg-summary.js +1 -1
  29. package/dist/core/ask-origin.d.ts +1 -1
  30. package/dist/core/ask-origin.js +2 -2
  31. package/dist/core/ask-question.d.ts +2 -2
  32. package/dist/core/ask-unresolvable-notice.d.ts +13 -4
  33. package/dist/core/ask-unresolvable-notice.js +10 -3
  34. package/dist/core/auto-compaction.d.ts +7 -5
  35. package/dist/core/background-agent-store.d.ts +7 -0
  36. package/dist/core/background-agent-store.js +3 -0
  37. package/dist/core/canonical-json.d.ts +23 -13
  38. package/dist/core/canonical-json.js +4 -4
  39. package/dist/core/checkpoint-queries.d.ts +50 -4
  40. package/dist/core/checkpoint-queries.js +42 -17
  41. package/dist/core/checkpoint-requirements.d.ts +3 -3
  42. package/dist/core/checkpoint-requirements.js +2 -1
  43. package/dist/core/checkpoint-row-verdict.d.ts +15 -4
  44. package/dist/core/checkpoint-row-verdict.js +22 -2
  45. package/dist/core/checkpoint-store.d.ts +28 -11
  46. package/dist/core/checkpoint-store.js +45 -4
  47. package/dist/core/compliance.d.ts +6 -2
  48. package/dist/core/compliance.js +3 -3
  49. package/dist/core/context-settings.d.ts +40 -9
  50. package/dist/core/context-settings.js +32 -10
  51. package/dist/core/engine-attestation.d.ts +27 -7
  52. package/dist/core/engine-attestation.js +5 -1
  53. package/dist/core/engine-notice.d.ts +43 -5
  54. package/dist/core/extension-requester.d.ts +9 -0
  55. package/dist/core/extension-requester.js +7 -0
  56. package/dist/core/file-history-store.d.ts +28 -0
  57. package/dist/core/file-history-store.js +48 -5
  58. package/dist/core/fs-write-gate-policy.js +1 -1
  59. package/dist/core/gate-fold.js +2 -0
  60. package/dist/core/gate-lanes.js +2 -0
  61. package/dist/core/gate-outcome.d.ts +39 -2
  62. package/dist/core/gate-outcome.js +20 -1
  63. package/dist/core/git-worktree-env.d.ts +62 -3
  64. package/dist/core/git-worktree-env.js +91 -30
  65. package/dist/core/governance-codes.d.ts +9 -3
  66. package/dist/core/governance-codes.js +17 -3
  67. package/dist/core/leg-identity.d.ts +19 -1
  68. package/dist/core/leg-identity.js +12 -0
  69. package/dist/core/mailbox-store.d.ts +39 -4
  70. package/dist/core/mailbox-store.js +14 -2
  71. package/dist/core/memory-engine/consolidation-driver.d.ts +32 -17
  72. package/dist/core/memory-engine/consolidation-driver.js +99 -98
  73. package/dist/core/memory-engine/consolidation.d.ts +74 -10
  74. package/dist/core/memory-engine/consolidation.js +183 -11
  75. package/dist/core/memory-engine/control-objects.d.ts +25 -0
  76. package/dist/core/memory-engine/control-objects.js +151 -0
  77. package/dist/core/memory-engine/control-plane-adoption.d.ts +48 -0
  78. package/dist/core/memory-engine/control-plane-adoption.js +159 -0
  79. package/dist/core/memory-engine/data-plane.d.ts +8 -4
  80. package/dist/core/memory-engine/data-plane.js +11 -6
  81. package/dist/core/memory-engine/delegation-settlement.d.ts +58 -40
  82. package/dist/core/memory-engine/delegation-settlement.js +270 -85
  83. package/dist/core/memory-engine/dual-root.d.ts +12 -6
  84. package/dist/core/memory-engine/dual-root.js +11 -7
  85. package/dist/core/memory-engine/engine.d.ts +136 -58
  86. package/dist/core/memory-engine/engine.js +491 -394
  87. package/dist/core/memory-engine/entry-scan.d.ts +8 -0
  88. package/dist/core/memory-engine/entry-scan.js +3 -0
  89. package/dist/core/memory-engine/file-backend.d.ts +62 -60
  90. package/dist/core/memory-engine/file-backend.js +122 -198
  91. package/dist/core/memory-engine/index.d.ts +8 -7
  92. package/dist/core/memory-engine/index.js +7 -6
  93. package/dist/core/memory-engine/landing-admission.d.ts +5 -3
  94. package/dist/core/memory-engine/landing-admission.js +3 -3
  95. package/dist/core/memory-engine/layout.d.ts +127 -46
  96. package/dist/core/memory-engine/layout.js +264 -109
  97. package/dist/core/memory-engine/memory-backend-contract.d.ts +26 -1
  98. package/dist/core/memory-engine/memory-backend-contract.js +476 -0
  99. package/dist/core/memory-engine/memory-deployment.d.ts +42 -11
  100. package/dist/core/memory-engine/memory-deployment.js +54 -15
  101. package/dist/core/memory-engine/origin-clearance.d.ts +12 -3
  102. package/dist/core/memory-engine/origin-clearance.js +68 -9
  103. package/dist/core/memory-engine/scope-contract.d.ts +52 -11
  104. package/dist/core/memory-engine/scope-contract.js +68 -19
  105. package/dist/core/memory-engine/session-write-home.d.ts +37 -2
  106. package/dist/core/memory-engine/session-write-home.js +38 -11
  107. package/dist/core/memory-engine/sync-client.d.ts +3 -1
  108. package/dist/core/memory-engine/sync-client.js +7 -0
  109. package/dist/core/memory-engine/sync-report.d.ts +3 -2
  110. package/dist/core/memory-engine/sync-report.js +6 -2
  111. package/dist/core/memory-engine/tools.d.ts +2 -2
  112. package/dist/core/memory-engine/tools.js +10 -10
  113. package/dist/core/memory-engine/types.d.ts +155 -19
  114. package/dist/core/memory-engine/types.js +2 -0
  115. package/dist/core/memory.js +15 -6
  116. package/dist/core/mode-policy.js +3 -3
  117. package/dist/core/mods/agent-stations.d.ts +18 -0
  118. package/dist/core/mods/agent-stations.js +8 -6
  119. package/dist/core/mods/extension-call.d.ts +4 -0
  120. package/dist/core/mods/extension-call.js +8 -0
  121. package/dist/core/mods/stations.d.ts +20 -1
  122. package/dist/core/mods/stations.js +21 -2
  123. package/dist/core/mods/tool-call.js +3 -4
  124. package/dist/core/parent-spec-seat.d.ts +2 -2
  125. package/dist/core/park-selfcheck.js +2 -2
  126. package/dist/core/pause-registry.d.ts +2 -0
  127. package/dist/core/pause-registry.js +3 -0
  128. package/dist/core/peer-channel.d.ts +5 -0
  129. package/dist/core/permission-rule-consent.d.ts +26 -8
  130. package/dist/core/permission-rule-consent.js +76 -36
  131. package/dist/core/permission-rule-store.d.ts +72 -13
  132. package/dist/core/permission-rule-store.js +29 -8
  133. package/dist/core/read-only-shell.js +3 -2
  134. package/dist/core/redaction-marks.d.ts +8 -0
  135. package/dist/core/redaction-marks.js +6 -0
  136. package/dist/core/refusal-echo.d.ts +20 -0
  137. package/dist/core/refusal-echo.js +33 -0
  138. package/dist/core/remote-env.d.ts +12 -1
  139. package/dist/core/remote-env.js +3 -0
  140. package/dist/core/retention.d.ts +180 -10
  141. package/dist/core/retention.js +45 -0
  142. package/dist/core/retired-keys.d.ts +5 -0
  143. package/dist/core/retired-keys.js +3 -0
  144. package/dist/core/rule-offer-read.d.ts +0 -4
  145. package/dist/core/rule-offer-read.js +2 -18
  146. package/dist/core/runner/child-tree.d.ts +29 -3
  147. package/dist/core/runner/child-tree.js +39 -16
  148. package/dist/core/runner/classifier-ladder.d.ts +7 -1
  149. package/dist/core/runner/classifier-ladder.js +4 -2
  150. package/dist/core/runner/compact-session.js +10 -7
  151. package/dist/core/runner/compaction-call-options.d.ts +7 -7
  152. package/dist/core/runner/compaction-call-options.js +3 -2
  153. package/dist/core/runner/contracts.d.ts +39 -11
  154. package/dist/core/runner/delegation-owner.d.ts +10 -3
  155. package/dist/core/runner/delegation-owner.js +4 -1
  156. package/dist/core/runner/gate-exit.d.ts +6 -0
  157. package/dist/core/runner/gate-exit.js +13 -4
  158. package/dist/core/runner/inherited-ask-grants.js +1 -1
  159. package/dist/core/runner/memory-consolidation-driver.d.ts +10 -5
  160. package/dist/core/runner/memory-consolidation-driver.js +12 -9
  161. package/dist/core/runner/memory-consolidation-write-judge.d.ts +2 -1
  162. package/dist/core/runner/memory-consolidation-write-judge.js +3 -2
  163. package/dist/core/runner/person-path-rows.d.ts +8 -3
  164. package/dist/core/runner/person-path-rows.js +5 -1
  165. package/dist/core/runner/placement-fence.d.ts +12 -0
  166. package/dist/core/runner/placement-fence.js +20 -6
  167. package/dist/core/runner/prepare-ask-lane.js +5 -5
  168. package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -2
  169. package/dist/core/runner/prepare-caps-and-workflow.js +7 -4
  170. package/dist/core/runner/prepare-config-doors.js +4 -0
  171. package/dist/core/runner/prepare-delegation-surface.d.ts +3 -0
  172. package/dist/core/runner/prepare-delegation-surface.js +2 -2
  173. package/dist/core/runner/prepare-execution-env.js +17 -6
  174. package/dist/core/runner/prepare-gate-stations.d.ts +5 -0
  175. package/dist/core/runner/prepare-gate-stations.js +5 -5
  176. package/dist/core/runner/prepare-hands-readface.d.ts +2 -1
  177. package/dist/core/runner/prepare-hands-readface.js +5 -4
  178. package/dist/core/runner/prepare-inherited-gate.d.ts +13 -9
  179. package/dist/core/runner/prepare-inherited-gate.js +12 -6
  180. package/dist/core/runner/prepare-memory-engine-session.d.ts +2 -4
  181. package/dist/core/runner/prepare-memory-engine-session.js +4 -4
  182. package/dist/core/runner/prepare-memory.d.ts +7 -2
  183. package/dist/core/runner/prepare-memory.js +41 -39
  184. package/dist/core/runner/prepare-park-ask.js +4 -3
  185. package/dist/core/runner/prepare-policy-chain.js +7 -7
  186. package/dist/core/runner/prepare-prompt-inputs.js +1 -1
  187. package/dist/core/runner/prepare-task.js +26 -18
  188. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -1
  189. package/dist/core/runner/prepare-wiring-manifest.js +3 -2
  190. package/dist/core/runner/prepare-workspace-restore.js +3 -6
  191. package/dist/core/runner/resume-admission.d.ts +2 -2
  192. package/dist/core/runner/resume-admission.js +2 -23
  193. package/dist/core/runner/role-resolution-table.d.ts +98 -0
  194. package/dist/core/runner/role-resolution-table.js +62 -0
  195. package/dist/core/runner/run-compaction-machinery.js +2 -2
  196. package/dist/core/runner/run-identity-wiring.js +12 -9
  197. package/dist/core/runner/run-leg.js +9 -5
  198. package/dist/core/runner/run-notification-lane.js +22 -22
  199. package/dist/core/runner/run-recovery-lanes.js +3 -3
  200. package/dist/core/runner/run-settle-and-teardown.js +3 -2
  201. package/dist/core/runner/run-terminal-adoption.js +1 -1
  202. package/dist/core/runner/run-turn-boundary.js +14 -15
  203. package/dist/core/runner/runtask.js +1 -1
  204. package/dist/core/runner/terminal-account.js +1 -1
  205. package/dist/core/runner/tool-occurrence.d.ts +4 -2
  206. package/dist/core/runner/tool-occurrence.js +2 -2
  207. package/dist/core/runner-deps.d.ts +7 -3
  208. package/dist/core/secret-env.d.ts +1 -1
  209. package/dist/core/secret-env.js +4 -4
  210. package/dist/core/session-checkout.d.ts +168 -0
  211. package/dist/core/session-checkout.js +579 -0
  212. package/dist/core/session-store.d.ts +12 -4
  213. package/dist/core/session-store.js +23 -3
  214. package/dist/core/session.d.ts +16 -2
  215. package/dist/core/session.js +3 -0
  216. package/dist/core/shell-read-silence.js +8 -0
  217. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +0 -12
  218. package/dist/core/store-contracts/checkpoint-store-contract.js +6 -7
  219. package/dist/core/store-contracts/peer-directory-contract.js +8 -1
  220. package/dist/core/store-contracts/session-store-contract.js +39 -0
  221. package/dist/core/task-event.d.ts +30 -5
  222. package/dist/core/task-notification.d.ts +119 -32
  223. package/dist/core/task-notification.js +186 -100
  224. package/dist/core/task-registry-agent.d.ts +25 -2
  225. package/dist/core/task-registry-agent.js +56 -22
  226. package/dist/core/task-registry-shared.d.ts +33 -11
  227. package/dist/core/task-registry.d.ts +33 -9
  228. package/dist/core/task-registry.js +36 -18
  229. package/dist/core/task-spec-members.js +1 -1
  230. package/dist/core/task-spec.d.ts +27 -2
  231. package/dist/core/tool-errors.d.ts +14 -6
  232. package/dist/core/tool-errors.js +1 -1
  233. package/dist/core/tool-policy.d.ts +32 -13
  234. package/dist/core/tool-policy.js +27 -17
  235. package/dist/core/tool-result-store.d.ts +20 -0
  236. package/dist/core/tool-spec.d.ts +42 -19
  237. package/dist/core/trace.d.ts +3 -2
  238. package/dist/core/types.d.ts +1 -1
  239. package/dist/core/untrusted-egress.d.ts +15 -4
  240. package/dist/core/untrusted-egress.js +23 -22
  241. package/dist/core/workflow-journal-store.d.ts +11 -0
  242. package/dist/core/workflow-journal-store.js +7 -0
  243. package/dist/core/workflow-run-store.d.ts +9 -0
  244. package/dist/core/workflow-run-store.js +6 -0
  245. package/dist/core/workspace-snapshot.d.ts +3 -1
  246. package/dist/core/workspace-snapshot.js +1 -0
  247. package/dist/engine/compaction/compaction.d.ts +2 -1
  248. package/dist/engine/harness/types.d.ts +67 -1
  249. package/dist/engine/harness/types.js +108 -0
  250. package/dist/engine/session/import-validate.js +6 -1
  251. package/dist/engine/session/session.d.ts +30 -1
  252. package/dist/engine/session/session.js +48 -1
  253. package/dist/index.d.ts +12 -7
  254. package/dist/index.js +12 -7
  255. package/dist/internal/harness-types.d.ts +1 -1
  256. package/dist/orchestration/run-workflow-tool.d.ts +8 -1
  257. package/dist/orchestration/run-workflow-tool.js +8 -0
  258. package/dist/orchestration/workflow-types.d.ts +2 -1
  259. package/dist/orchestration/workflow.d.ts +6 -0
  260. package/dist/orchestration/workflow.js +5 -2
  261. package/dist/stores/file/checkpoint-store.d.ts +6 -0
  262. package/dist/stores/file/checkpoint-store.js +4 -1
  263. package/dist/stores/file/file-history-store.d.ts +13 -0
  264. package/dist/stores/file/file-history-store.js +75 -13
  265. package/dist/stores/file/index.d.ts +11 -1
  266. package/dist/stores/file/index.js +7 -11
  267. package/dist/stores/file/permission-rule-store.d.ts +23 -0
  268. package/dist/stores/file/permission-rule-store.js +75 -7
  269. package/dist/stores/file/session-store.js +2 -1
  270. package/dist/stores/file/tool-result-store.d.ts +14 -0
  271. package/dist/stores/file/tool-result-store.js +39 -2
  272. package/dist/stores/file/workflow-journal-store.d.ts +4 -0
  273. package/dist/stores/file/workflow-journal-store.js +17 -0
  274. package/dist/stores/file/workflow-run-store.d.ts +3 -0
  275. package/dist/stores/file/workflow-run-store.js +15 -0
  276. package/dist/tools/fs/bash-program-position.js +3 -3
  277. package/dist/tools/fs/program-read-model.d.ts +34 -10
  278. package/dist/tools/fs/program-read-model.js +37 -7
  279. package/dist/tools/fs/program-read-model.rows.js +13 -2
  280. package/dist/tools/fs/read-deny.d.ts +28 -3
  281. package/dist/tools/fs/read-deny.js +18 -2
  282. package/dist/tools/fs/removal-targets.js +3 -3
  283. package/dist/tools/fs/safety.d.ts +2 -0
  284. package/dist/tools/fs/safety.js +1 -1
  285. package/dist/tools/fs/shell-read-argv.d.ts +8 -1
  286. package/dist/tools/fs/shell-read-argv.js +34 -29
  287. package/dist/tools/fs/shell-read-bindings.d.ts +2 -0
  288. package/dist/tools/fs/shell-read-bindings.js +5 -1
  289. package/dist/tools/fs/shell-read-brace.d.ts +18 -0
  290. package/dist/tools/fs/shell-read-brace.js +79 -0
  291. package/dist/tools/fs/shell-read-check.d.ts +8 -2
  292. package/dist/tools/fs/shell-read-check.js +16 -14
  293. package/dist/tools/fs/shell-read-establish.js +23 -16
  294. package/dist/tools/fs/shell-read-judge.d.ts +11 -0
  295. package/dist/tools/fs/shell-read-judge.js +3 -3
  296. package/dist/tools/fs/shell-read-plan.d.ts +10 -0
  297. package/dist/tools/fs/shell-read-plan.js +189 -93
  298. package/dist/tools/fs/shell-read-start.d.ts +19 -9
  299. package/dist/tools/fs/shell-read-start.js +20 -12
  300. package/dist/tools/fs/shell-read-word.d.ts +10 -0
  301. package/dist/tools/fs/shell-read-word.js +9 -5
  302. package/dist/tools/fs/shell-read-workdir.d.ts +26 -7
  303. package/dist/tools/fs/shell-read-workdir.js +73 -12
  304. package/dist/tools/fs/shell-read-write-targets.js +13 -8
  305. package/dist/tools/worktree.d.ts +3 -2
  306. package/dist/tools/worktree.js +7 -35
  307. package/package.json +3 -2
  308. package/test/export-surface.snapshot.json +135 -11
  309. package/wire-changes/core-stores-sql@7.63.0.json +30 -0
  310. package/wire-changes/core-stores-sql@7.64.0.json +30 -0
  311. package/wire-changes/core@7.63.0.json +3523 -0
  312. package/wire-changes/core@7.64.0.json +2653 -0
  313. package/wire-changes/mods-kernel@7.63.0.json +30 -0
  314. package/wire-changes/mods-kernel@7.64.0.json +30 -0
  315. package/wire-changes/primitives@7.63.0.json +445 -0
  316. package/wire-changes/primitives@7.64.0.json +30 -0
  317. package/dist/core/credential-vocabulary.d.ts +0 -176
  318. package/dist/core/credential-vocabulary.js +0 -190
  319. package/dist/core/redaction-passes.d.ts +0 -82
  320. package/dist/core/redaction-passes.js +0 -377
@@ -32,22 +32,26 @@ 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";
42
- import { boundedRedactedSummary } from "../core/untrusted-egress.js";
43
+ import { boundedRedactedSummary, extensionWords } from "../core/untrusted-egress.js";
44
+ import { readExtensionRequester } from "../core/extension-requester.js";
43
45
  import { uuidv7 } from "../internal/harness.js";
44
46
  import { addWorktree } from "../core/git-worktree-env.js";
45
47
  import { shellQuote } from "../tools/fs/search.js";
46
48
  import { BG_AGENT_REAP_STOP_ERROR, chosenAgentName } from "../core/task-registry.js";
49
+ import { agentOutcomeIsError } from "../core/task-registry-agent.js";
47
50
  import { readDurableOrgAdmission } from "../core/memory-admission.js";
48
51
  import { governanceRetryClass } from "../core/governance-codes.js";
49
52
  import { readSkillGrantCapture } from "../core/skill-grant.js";
50
- import { admitsBackgroundLaunch, completionResultField, oweTerminalDelivery, resolveCompletionSink, terminalFrameFacets } from "../core/task-notification.js";
53
+ import { admitsBackgroundLaunch, completionResultField, moveTerminalDelivery, oweTerminalDelivery, resolveCompletionSink, terminalFrameFacets } from "../core/task-notification.js";
54
+ import { deliverEngineNotice } from "../core/engine-notice.js";
51
55
  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
56
  function rollupDelegatedCost(stats, nested) {
53
57
  if (stats.costMicroUsd === undefined)
@@ -81,6 +85,7 @@ import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "./l
81
85
  import { ObserverDigestTap, ObserverPairing, createObserverReportToolSpec, markObserverTaskId, unmarkObserverTaskId, isObserverTaskId, ObserverResumeStateError, ObserverStoppedByUserError, observerFramingPrompt, observerSlug, resolveObserverDeclaration, } from "./observer.js";
82
86
  import { SubagentStepRecorder, redactThenCut } from "./subagent-steps.js";
83
87
  import { childOwnerKeys, parkCompletionNotify, runningBackgroundUnder } from "./subagent-completion-gate.js";
88
+ import { placesSubagentTranscripts, subagentTranscriptPlacement } from "./subagent-transcript-placement.js";
84
89
  import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
85
90
  import { canonicalNameValue } from "../core/permission-rule-model.js";
86
91
  import { definitionAllowTools, inheritedChildPool, inheritedHostSeats, inheritedMcpDeclarations, withDefinitionServers, withoutWakerSeats } from "./inherited-tool-pool.js";
@@ -387,6 +392,7 @@ const SUBAGENT_ERROR_KIND_BY_CODE = {
387
392
  stream_torn: "network",
388
393
  refusal: "logic",
389
394
  length_empty: "logic",
395
+ "config.placement_not_honored": "logic",
390
396
  };
391
397
  const SUBAGENT_RETRYABLE = {
392
398
  rate_limit: true,
@@ -1090,7 +1096,13 @@ function reachableOccupants(registry, scope, root, caller) {
1090
1096
  if (typeof face !== "function")
1091
1097
  return new Map();
1092
1098
  try {
1093
- return new Map(face.call(registry, scope, root, caller).filter((o) => o.reachable).map((o) => [o.id, o.name]));
1099
+ return new Map(face
1100
+ .call(registry, scope, root, caller)
1101
+ .filter((o) => o.reachable)
1102
+ .map((o) => {
1103
+ const requestedBy = readExtensionRequester(o.requestedBy);
1104
+ return [o.id, { name: o.name, ...(requestedBy !== undefined ? { requestedBy } : {}) }];
1105
+ }));
1094
1106
  }
1095
1107
  catch {
1096
1108
  return new Map();
@@ -1098,7 +1110,10 @@ function reachableOccupants(registry, scope, root, caller) {
1098
1110
  }
1099
1111
  function concurrencyOccupants(active, reachable, local) {
1100
1112
  const listed = active.filter((id) => reachable.has(id)).slice(0, REFUSAL_OCCUPANTS_LISTED);
1101
- const parts = listed.map((id) => `task_id ${id} (${JSON.stringify(reachable.get(id))})`);
1113
+ const parts = listed.map((id) => {
1114
+ const o = reachable.get(id);
1115
+ return `task_id ${id} (${JSON.stringify(o.name)}${o.requestedBy !== undefined ? `, started by extension "${extensionWords(o.requestedBy.name, 80)}"` : ""})`;
1116
+ });
1102
1117
  const rest = active.length - listed.length;
1103
1118
  if (rest > 0)
1104
1119
  parts.push(`${rest} ${listed.length > 0 ? "more " : ""}registered`);
@@ -1535,7 +1550,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
1535
1550
  const a = canonicalSubagentTypeArgs(args, acceptedSubagentTypes(), generalPurposeShadowed);
1536
1551
  const parentSpecSeat = parentSpecSeatOfCtx(ctx);
1537
1552
  const reviveClaim = ctx.reviveClaim;
1538
- const backgroundSink = opts.background !== undefined ? resolveCompletionSink(ctx.onTaskNotification, opts.background.notify) : undefined;
1553
+ const parkedLane = reviveClaim?.parkedResume !== undefined ? opts.background?.registry.parkedCompletionSink(reviveClaim.row.handle) : undefined;
1554
+ const backgroundSink = opts.background !== undefined ? resolveCompletionSink(ctx.onTaskNotification ?? parkedLane, opts.background.notify) : undefined;
1539
1555
  const backgroundLane = opts.background !== undefined && admitsBackgroundLaunch(backgroundSink);
1540
1556
  if (reviveClaim !== undefined && !backgroundLane) {
1541
1557
  return notStartedResult({
@@ -2241,6 +2257,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2241
2257
  ...(ctx.taskId !== undefined ? { parentTaskId: ctx.taskId } : {}),
2242
2258
  ...(ctx.sessionId !== undefined ? { parentSessionId: ctx.sessionId } : {}),
2243
2259
  ...((ctx.rootSessionId ?? ctx.sessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? ctx.sessionId } : {}),
2260
+ ...(ctx.rootSessionIncarnation !== undefined ? { rootSessionIncarnation: ctx.rootSessionIncarnation } : {}),
2244
2261
  ...(ctx.placementRoot !== undefined ? { placementRoot: ctx.placementRoot } : {}),
2245
2262
  }),
2246
2263
  ...(ctx.centerArtifactDigest !== undefined ? { parentCenterArtifactDigest: ctx.centerArtifactDigest } : {}),
@@ -2256,7 +2273,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2256
2273
  })(),
2257
2274
  ...(ctx.subagentRetain !== undefined ? { parentRetainLedger: ctx.subagentRetain } : {}),
2258
2275
  onForwardEvent: recordingForward,
2259
- ...(ctx.parentCwd !== undefined ? { callerRoot: ctx.parentCwd } : {}),
2276
+ ...callerPlacementSeats(ctx.parentCwd, ctx.callerRoot),
2260
2277
  ...(ctx.placementTarget !== undefined ? { placementTarget: ctx.placementTarget } : {}),
2261
2278
  ...(worktreeDir !== undefined
2262
2279
  ? { parentCwd: worktreeDir, worktreeOffered: true, onWorkspaceResolved: (ws) => void (childPlacement = ws) }
@@ -2494,14 +2511,17 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2494
2511
  const forkTree = await delegationOwnerOf(ctx.delegationOwner);
2495
2512
  if (!forkTree.bound)
2496
2513
  return ownerUnboundResult(false, forkTree);
2514
+ const forkBg = wantsBackground ? opts.background : undefined;
2515
+ const forkPlacementHandle = forkBg?.agentStore !== undefined ? forkBg.registry.mintTaskId("background_agent") : undefined;
2516
+ const forkOpts = forkPlacementHandle !== undefined ? { placement: subagentTranscriptPlacement(ctx, treeScope, forkPlacementHandle) } : undefined;
2497
2517
  try {
2498
2518
  if (ctx.hostSessionFork) {
2499
- const forkHandle = await ctx.hostSessionFork();
2519
+ const forkHandle = await ctx.hostSessionFork(forkOpts);
2500
2520
  forkedId = forkHandle?.sessionId ?? null;
2501
2521
  releaseForked = forkHandle?.release;
2502
2522
  }
2503
2523
  else {
2504
- forkedId = (await opts.runner.sessions.fork?.(ctx.sessionId, forkTree.owner)) ?? null;
2524
+ forkedId = (await opts.runner.sessions.fork?.(ctx.sessionId, forkTree.owner, declaresSubagentPlacement(opts.runner.sessions) ? forkOpts : undefined)) ?? null;
2505
2525
  }
2506
2526
  }
2507
2527
  catch (e) {
@@ -2551,7 +2571,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2551
2571
  const forkSettleId = forkSettlementSeat !== undefined ? `bg-${uuidv7()}` : undefined;
2552
2572
  if (forkSettlementSeat !== undefined && forkSettleId !== undefined) {
2553
2573
  try {
2554
- registerDelegationLaunch(forkSettlementSeat.controlDir, { settleId: forkSettleId, sessionId: forkSettlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
2574
+ await registerDelegationLaunch(forkSettlementSeat.governance, { settleId: forkSettleId, sessionId: forkSettlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
2555
2575
  }
2556
2576
  catch (e) {
2557
2577
  dropHostAbortListener();
@@ -2563,7 +2583,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2563
2583
  });
2564
2584
  }
2565
2585
  }
2566
- const settleForkRow = (terminal) => {
2586
+ const settleForkRow = async (terminal) => {
2567
2587
  if (forkSettlementSeat === undefined || forkSettleId === undefined)
2568
2588
  return;
2569
2589
  const att = terminal !== undefined ? childAttestation(terminal.kind === "completed") : undefined;
@@ -2572,7 +2592,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2572
2592
  let lastErr;
2573
2593
  for (let attempt = 0; attempt < 3 && !settled; attempt++) {
2574
2594
  try {
2575
- settleDelegation(forkSettlementSeat.controlDir, { settleId: forkSettleId, status: verdict, now: Date.now });
2595
+ await settleDelegation(forkSettlementSeat.governance, { settleId: forkSettleId, status: verdict, now: Date.now });
2576
2596
  settled = true;
2577
2597
  }
2578
2598
  catch (e) {
@@ -2581,7 +2601,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2581
2601
  }
2582
2602
  if (settled && verdict === "external") {
2583
2603
  try {
2584
- replayExternalSettlementEffects(forkSettlementSeat.controlDir, { carry: true, now: Date.now });
2604
+ await replayExternalSettlementEffects(forkSettlementSeat.governance, forkSettlementSeat.controlDir, { carry: true, now: Date.now });
2585
2605
  }
2586
2606
  catch {
2587
2607
  }
@@ -2594,11 +2614,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2594
2614
  let taskId;
2595
2615
  try {
2596
2616
  taskId = bg.registry.registerBackgroundAgent({
2617
+ ...(forkPlacementHandle !== undefined ? { id: forkPlacementHandle } : {}),
2597
2618
  ...(bgOwner !== undefined ? { owner: bgOwner } : {}),
2598
2619
  ...(bgScope !== undefined ? { scope: bgScope } : {}),
2599
2620
  ...(sessionScopedBg ? { sessionScoped: true } : {}),
2600
2621
  description: shortDesc,
2601
2622
  agentType: spawnAgentType,
2623
+ ...(extensionSpawn !== undefined ? { requestedBy: extensionSpawn.requestedBy } : {}),
2602
2624
  ...(agentName !== undefined ? { name: agentName } : {}),
2603
2625
  ...(ctx.taskId !== undefined && ctx.taskId !== ctx.sessionId ? { parentTaskId: ctx.taskId } : {}),
2604
2626
  ...(ctx.sessionId !== undefined ? { parentSessionId: ctx.sessionId } : {}),
@@ -2621,7 +2643,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2621
2643
  const wt = await finishWorktree();
2622
2644
  if (forkSettlementSeat !== undefined && forkSettleId !== undefined) {
2623
2645
  try {
2624
- settleDelegation(forkSettlementSeat.controlDir, { settleId: forkSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
2646
+ await settleDelegation(forkSettlementSeat.governance, { settleId: forkSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
2625
2647
  }
2626
2648
  catch {
2627
2649
  }
@@ -2765,8 +2787,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2765
2787
  void bgForkChild
2766
2788
  .then(async (child) => {
2767
2789
  const childFace = childTerminalFace(child.terminal);
2768
- settleForkRow(child.terminal);
2790
+ const forkSettled = settleForkRow(child.terminal);
2769
2791
  dropHostAbortListener();
2792
+ await forkSettled;
2770
2793
  await finishWorktree(child.terminal);
2771
2794
  try {
2772
2795
  const nsb = child.stats.nested;
@@ -2847,7 +2870,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2847
2870
  }
2848
2871
  })
2849
2872
  .catch((e) => {
2850
- settleForkRow({ kind: "failed" });
2873
+ void settleForkRow({ kind: "failed" });
2851
2874
  dropHostAbortListener();
2852
2875
  void finishWorktree();
2853
2876
  const killed = abort.signal.aborted;
@@ -2995,6 +3018,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2995
3018
  ].filter(Boolean);
2996
3019
  return {
2997
3020
  content: forkLines.join("\n"),
3021
+ ...(agentOutcomeIsError(forkFace.status) ? { isError: true } : {}),
2998
3022
  details: completedAgentCard(forkChild, {
2999
3023
  subagentType: FORK_SUBAGENT_TYPE,
3000
3024
  error: forkErr,
@@ -3020,6 +3044,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3020
3044
  const abort = new AbortController();
3021
3045
  const reviveRow = reviveClaim?.row;
3022
3046
  const parkedResume = reviveClaim?.parkedResume;
3047
+ let cycleSink = parkedResume !== undefined && parkedLane !== undefined ? parkedLane : notify;
3023
3048
  const sessionScopedBg = reviveRow !== undefined ? reviveRow.sessionScoped : ctx.backgroundScope === "session" && ctx.sessionId !== undefined;
3024
3049
  const outlivesThisRequest = sessionScopedBg || reviveRow !== undefined;
3025
3050
  const onHostAbort = () => abort.abort();
@@ -3035,7 +3060,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3035
3060
  const bgScope = treeScope;
3036
3061
  const childTreeOwner = () => (reviveRow !== undefined ? rowOwnerReading(opts.runner.sessions, reviveRow.sessionId) : delegationOwnerOf(ctx.delegationOwner));
3037
3062
  let placedTreeOwner;
3038
- if (reviveRow === undefined && bg.agentStore !== undefined && opts.runner.sessions.placements?.subagent !== undefined) {
3063
+ if (reviveRow === undefined && placesSubagentTranscripts(bg.agentStore, opts.runner.sessions)) {
3039
3064
  const tree = await childTreeOwner();
3040
3065
  if (!tree.bound) {
3041
3066
  dropHostAbortListener();
@@ -3062,7 +3087,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3062
3087
  const bgSettleId = settlementSeat !== undefined ? `bg-${uuidv7()}` : undefined;
3063
3088
  if (settlementSeat !== undefined && bgSettleId !== undefined) {
3064
3089
  try {
3065
- registerDelegationLaunch(settlementSeat.controlDir, { settleId: bgSettleId, sessionId: settlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
3090
+ await registerDelegationLaunch(settlementSeat.governance, { settleId: bgSettleId, sessionId: settlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
3066
3091
  }
3067
3092
  catch (e) {
3068
3093
  dropHostAbortListener();
@@ -3075,7 +3100,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3075
3100
  });
3076
3101
  }
3077
3102
  }
3078
- const settleDelegationRow = (terminal) => {
3103
+ const settleDelegationRow = async (terminal) => {
3079
3104
  if (settlementSeat === undefined || bgSettleId === undefined)
3080
3105
  return;
3081
3106
  const att = terminal !== undefined ? childAttestation(terminal.kind === "completed") : undefined;
@@ -3084,7 +3109,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3084
3109
  let lastErr;
3085
3110
  for (let attempt = 0; attempt < 3 && !settled; attempt++) {
3086
3111
  try {
3087
- settleDelegation(settlementSeat.controlDir, { settleId: bgSettleId, status: verdict, now: Date.now });
3112
+ await settleDelegation(settlementSeat.governance, { settleId: bgSettleId, status: verdict, now: Date.now });
3088
3113
  settled = true;
3089
3114
  }
3090
3115
  catch (e) {
@@ -3093,7 +3118,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3093
3118
  }
3094
3119
  if (settled && verdict === "external") {
3095
3120
  try {
3096
- replayExternalSettlementEffects(settlementSeat.controlDir, { carry: true, now: Date.now });
3121
+ await replayExternalSettlementEffects(settlementSeat.governance, settlementSeat.controlDir, { carry: true, now: Date.now });
3097
3122
  }
3098
3123
  catch {
3099
3124
  }
@@ -3113,6 +3138,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3113
3138
  ...(reviveRow.sessionScoped ? { sessionScoped: true } : {}),
3114
3139
  ...(reviveRow.description !== undefined ? { description: reviveRow.description } : {}),
3115
3140
  agentType: spawnAgentType,
3141
+ ...(reviveRow.requestedBy !== undefined ? { requestedBy: reviveRow.requestedBy } : {}),
3116
3142
  name: reviveRow.name,
3117
3143
  ...(reviveRow.parentTaskId !== undefined ? { parentTaskId: reviveRow.parentTaskId } : {}),
3118
3144
  ...(reviveRow.parentSessionId !== undefined ? { parentSessionId: reviveRow.parentSessionId } : {}),
@@ -3146,6 +3172,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3146
3172
  ...(sessionScopedBg ? { sessionScoped: true } : {}),
3147
3173
  description: shortDesc,
3148
3174
  agentType: spawnAgentType,
3175
+ ...(extensionSpawn !== undefined ? { requestedBy: extensionSpawn.requestedBy } : {}),
3149
3176
  ...(agentName !== undefined ? { name: agentName } : {}),
3150
3177
  ...(ctx.taskId !== undefined && ctx.taskId !== ctx.sessionId ? { parentTaskId: ctx.taskId } : {}),
3151
3178
  ...(ctx.sessionId !== undefined ? { parentSessionId: ctx.sessionId } : {}),
@@ -3164,7 +3191,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3164
3191
  const wt = await finishWorktree();
3165
3192
  if (settlementSeat !== undefined && bgSettleId !== undefined) {
3166
3193
  try {
3167
- settleDelegation(settlementSeat.controlDir, { settleId: bgSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
3194
+ await settleDelegation(settlementSeat.governance, { settleId: bgSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
3168
3195
  }
3169
3196
  catch {
3170
3197
  }
@@ -3173,7 +3200,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3173
3200
  }
3174
3201
  if (capLedgerKey !== undefined)
3175
3202
  chargeDelegationEntryHandle(bg.registry, capLedgerKey, bg.agentStore, reviveRow === undefined ? taskId : undefined);
3176
- oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
3203
+ if (parkedResume === undefined)
3204
+ oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
3177
3205
  childInternals.peerSelfRef?.addAxis("h", taskId);
3178
3206
  if (agentName !== undefined) {
3179
3207
  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" }));
@@ -3191,24 +3219,30 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3191
3219
  stepRecorder.lockTo(taskId);
3192
3220
  bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId, opts.runner.sessions);
3193
3221
  const bgCycleSeq = bg.registry.backgroundAgentCycleSeq(taskId);
3194
- bg.registry.attachAgentTerminalNotifier(taskId, () => {
3195
- const stoppedByReap = bg.registry.getStopAttribution(taskId) ?? "system";
3196
- const completionIdReap = bg.registry.getCompletionId(taskId);
3197
- const seqReap = bg.registry.backgroundAgentCycleSeq(taskId);
3198
- const reapFrame = {
3222
+ let retainedCycle;
3223
+ const cycleSeqOfFrames = () => retainedCycle?.cycleSeq ?? (parkedResume !== undefined ? (reviveRow?.seq ?? 1) + 1 : reviveRow?.seq);
3224
+ bg.registry.attachAgentTerminalNotifier(taskId, (ending) => {
3225
+ const stoppedByLanded = ending.status === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
3226
+ const completionIdLanded = bg.registry.getCompletionId(taskId);
3227
+ const seqLanded = bg.registry.backgroundAgentCycleSeq(taskId);
3228
+ const landedElapsedMs = Date.now() - bgStartedAt;
3229
+ const landedFrame = {
3199
3230
  task_id: taskId,
3200
3231
  task_type: "background_agent",
3201
3232
  toolUseId: ctx.toolCallId,
3202
- status: "killed",
3233
+ status: ending.status,
3203
3234
  ...terminalFrameFacets({ spawnName: agentName }),
3204
- stoppedBy: stoppedByReap,
3205
- summary: ccCompletionText(shortDesc, "killed", "killed", Date.now() - bgStartedAt),
3235
+ ...(cycleSeqOfFrames() !== undefined ? { seq: cycleSeqOfFrames() } : {}),
3236
+ ...(stoppedByLanded !== undefined ? { stoppedBy: stoppedByLanded } : {}),
3237
+ summary: ending.status === "failed" ? `Agent "${shortDesc}" failed: ${ending.error ?? "ended"}${ccElapsedTag(landedElapsedMs)}`.slice(0, 300) : ccCompletionText(shortDesc, "killed", "killed", landedElapsedMs),
3238
+ ...(ending.status === "failed" && ending.error !== undefined ? { error: ending.error.slice(0, REPORT_FIELD_MAX) } : {}),
3206
3239
  sessionId: bgChildSessionId,
3207
3240
  resumable: false,
3208
- ...(completionIdReap !== undefined ? { completionId: completionIdReap } : {}),
3241
+ ...(completionIdLanded !== undefined ? { completionId: completionIdLanded } : {}),
3209
3242
  };
3210
- sinkEmit(backgroundChildTerminal(reapFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(seqReap !== undefined ? { generation: seqReap } : {}) }));
3211
- notifier.notify(() => notify(reapFrame, { priority: "next" }), "subagent.reapTerminalNotify");
3243
+ sinkEmit(backgroundChildTerminal(landedFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(seqLanded !== undefined ? { generation: seqLanded } : {}) }));
3244
+ const landedLane = ending.parkLane ?? cycleSink;
3245
+ notifier.notify(() => landedLane?.(landedFrame, { priority: "next" }), "subagent.landedTerminalNotify");
3212
3246
  });
3213
3247
  const bgDurableProbe = bg.registry.durableAgentRowProbe(taskId);
3214
3248
  const bgRowConfirmed = async () => (bgDurableProbe ? await bgDurableProbe().catch(() => false) : false);
@@ -3249,6 +3283,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3249
3283
  if (sessionScopedBg && bgRetainLedger)
3250
3284
  ensureSessionReapHook(bg.registry);
3251
3285
  const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe, { registry: bg.registry, taskId }, backgroundLegFacts(taskId));
3286
+ retainedCycle = bgRetain;
3252
3287
  if (bgRetain) {
3253
3288
  bg.registry.markRetainedContinuation(taskId);
3254
3289
  const origRelease = bgRetain.release;
@@ -3300,17 +3335,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3300
3335
  usage: { toolUses: toolStarts },
3301
3336
  });
3302
3337
  }, () => bg.registry.noteBackgroundAgentActivity(taskId));
3303
- const bgPlacementRoot = ctx.rootSessionId ?? ctx.sessionId;
3304
- const bgPlacementParent = ctx.sessionId;
3305
3338
  const bgPlacement = placedTreeOwner !== undefined
3306
- ? {
3307
- kind: "subagent",
3308
- ...(bgScope !== undefined ? { scope: bgScope } : {}),
3309
- ...(bgPlacementParent !== undefined ? { parentSessionId: bgPlacementParent } : {}),
3310
- ...(bgPlacementRoot !== undefined ? { rootSessionId: bgPlacementRoot } : {}),
3311
- handle: taskId,
3312
- owner: placedTreeOwner,
3313
- }
3339
+ ? { ...subagentTranscriptPlacement(ctx, bgScope, taskId), owner: placedTreeOwner }
3314
3340
  : undefined;
3315
3341
  const bgInternals = bgSink
3316
3342
  ? {
@@ -3367,6 +3393,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3367
3393
  const driveParkedResume = async () => {
3368
3394
  const pr = parkedResume;
3369
3395
  const claimStores = { agentStore: bg.agentStore, checkpointStore: childParkStore };
3396
+ let consumed = false;
3370
3397
  const rollbackAndThrow = async (e) => {
3371
3398
  let disp = "retry";
3372
3399
  try {
@@ -3374,6 +3401,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3374
3401
  }
3375
3402
  catch {
3376
3403
  }
3404
+ if (!consumed && disp !== "failed")
3405
+ cycleSink = undefined;
3377
3406
  const msg = thrownText(e);
3378
3407
  throw new Error(disp === "rolled_back"
3379
3408
  ? `parked resume rolled back — the approval is still pending (retryable): ${msg}`
@@ -3432,6 +3461,16 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3432
3461
  const won = await bg.registry.consumeParkedFlip(taskId, { agentStore: bg.agentStore }, pr.ticket);
3433
3462
  if (!won)
3434
3463
  throw new Error("the parked row moved under the resume (a stop or another transition won) — resume aborted");
3464
+ moveTerminalDelivery(parkedLane, notify, { task_id: taskId, task_type: "background_agent" });
3465
+ cycleSink = notify;
3466
+ consumed = true;
3467
+ if (parkedLane === undefined && ctx.onTaskNotification === undefined) {
3468
+ deliverEngineNotice(undefined, {
3469
+ code: "delegation.resume_lane_missing",
3470
+ 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`,
3471
+ detail: { taskId, ...(reviveRow?.rootSessionId !== undefined ? { rootSessionId: reviveRow.rootSessionId } : {}) },
3472
+ });
3473
+ }
3435
3474
  };
3436
3475
  let childResult;
3437
3476
  try {
@@ -3478,8 +3517,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3478
3517
  reopened = false;
3479
3518
  }
3480
3519
  if (reopened) {
3481
- bg.registry.parkBackgroundAgent(taskId, {
3520
+ const reParked = bg.registry.parkBackgroundAgent(taskId, {
3482
3521
  checkpointToken: pr.ticket.token,
3522
+ completionSink: cycleSink,
3483
3523
  resolveStop: async () => {
3484
3524
  const cpS = childParkStore;
3485
3525
  const cp = (await cpS.get(pr.ticket.token));
@@ -3488,6 +3528,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3488
3528
  return await cpS.expire(pr.ticket.token, cp.scope);
3489
3529
  },
3490
3530
  });
3531
+ if (reParked === "parked")
3532
+ cycleSink = undefined;
3491
3533
  throw new Error(`parked resume could not complete and the approval was REOPENED (still approvable/retryable): ${childResult.terminal.message ?? "failed"}`, { cause: childResult.terminal });
3492
3534
  }
3493
3535
  }
@@ -3510,9 +3552,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3510
3552
  void bgChildPromise
3511
3553
  .then(async (child) => {
3512
3554
  const childFace = childTerminalFace(child.terminal);
3513
- settleDelegationRow(child.terminal);
3555
+ const rowSettled = settleDelegationRow(child.terminal);
3514
3556
  closeObserverWindow(childFace.status);
3515
3557
  dropHostAbortListener();
3558
+ await rowSettled;
3516
3559
  await finishWorktree(child.terminal);
3517
3560
  try {
3518
3561
  const ns2 = child.stats.nested;
@@ -3525,7 +3568,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3525
3568
  }
3526
3569
  catch {
3527
3570
  }
3528
- const seqAtSettle = bgRetain?.cycleSeq ?? (parkedResume !== undefined ? (reviveRow?.seq ?? 1) + 1 : reviveRow?.seq);
3571
+ const seqAtSettle = cycleSeqOfFrames();
3529
3572
  const bgHandbackWarning = isDurablePause(child.terminal)
3530
3573
  ? undefined
3531
3574
  : await reviewHandback({
@@ -3581,6 +3624,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3581
3624
  ? bg.registry.parkBackgroundAgent(taskId, {
3582
3625
  checkpointToken: token,
3583
3626
  seq: seqAtSettle ?? 1,
3627
+ completionSink: cycleSink,
3584
3628
  resolveStop: async () => {
3585
3629
  const cpS = childParkStore;
3586
3630
  const cp = (await cpS.get(token));
@@ -3648,7 +3692,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3648
3692
  const bgTerminalSummary = failReasonBg !== undefined
3649
3693
  ? `Agent "${shortDesc}" failed: ${failReasonBg}${ccElapsedTag(bgElapsedMs)}${observerNote}`.slice(0, 300) + errorKindClause(errClassBg)
3650
3694
  : `${ccCompletionText(shortDesc, settled, childFace.status, bgElapsedMs)}${observerNote}`;
3651
- const ownsTerminalFaces = bg.registry.claimAgentTerminalNotify(taskId);
3695
+ const completionSink = cycleSink;
3696
+ const ownsTerminalFaces = completionSink !== undefined && bg.registry.claimAgentTerminalNotify(taskId);
3652
3697
  const bgResultField = await completionResultField(bgHandbackResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report), (ref) => bg.registry.recordArtifactRef(taskId, ref, completionIdBg), notifier);
3653
3698
  const completionFrame = {
3654
3699
  task_id: taskId,
@@ -3681,24 +3726,25 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3681
3726
  owners: gateOwners,
3682
3727
  pendingCount: aliveBgCount,
3683
3728
  payload: completionFrame,
3684
- notify,
3729
+ notify: completionSink,
3685
3730
  });
3686
3731
  }
3687
3732
  else if (ownsTerminalFaces) {
3688
3733
  try {
3689
- notify(completionFrame, { priority: "next" });
3734
+ completionSink(completionFrame, { priority: "next" });
3690
3735
  }
3691
3736
  catch {
3692
3737
  }
3693
3738
  }
3694
3739
  })
3695
3740
  .catch(async (e) => {
3696
- settleDelegationRow({ kind: "failed" });
3741
+ const rowSettled = settleDelegationRow({ kind: "failed" });
3697
3742
  closeObserverWindow("failed");
3698
3743
  dropHostAbortListener();
3744
+ await rowSettled;
3699
3745
  void finishWorktree();
3700
3746
  const killed = abort.signal.aborted;
3701
- const seqAtSettle = bgRetain?.cycleSeq ?? (parkedResume !== undefined ? (reviveRow?.seq ?? 1) + 1 : reviveRow?.seq);
3747
+ const seqAtSettle = cycleSeqOfFrames();
3702
3748
  if (bgRetain) {
3703
3749
  if (killed)
3704
3750
  void bgRetainLedger?.evict(ctx.toolCallId);
@@ -3723,7 +3769,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3723
3769
  }
3724
3770
  const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
3725
3771
  const observerNote = observerNoteFor(await startBoundedObserverDrain());
3726
- const ownsTerminalFacesReject = bg.registry.claimAgentTerminalNotify(taskId);
3772
+ const rejectSink = cycleSink;
3773
+ const ownsTerminalFacesReject = rejectSink !== undefined && bg.registry.claimAgentTerminalNotify(taskId);
3727
3774
  const rejectFrame = {
3728
3775
  task_id: taskId,
3729
3776
  task_type: "background_agent",
@@ -3742,7 +3789,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3742
3789
  sinkEmit(backgroundChildTerminal(rejectFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(bgCycleSeq !== undefined ? { generation: bgCycleSeq } : {}) }));
3743
3790
  try {
3744
3791
  if (ownsTerminalFacesReject)
3745
- notify(rejectFrame, { priority: "next" });
3792
+ rejectSink(rejectFrame, { priority: "next" });
3746
3793
  }
3747
3794
  catch {
3748
3795
  }
@@ -3958,6 +4005,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3958
4005
  ].filter(Boolean);
3959
4006
  return {
3960
4007
  content: lines.join("\n"),
4008
+ ...(agentOutcomeIsError(childFace.status) ? { isError: true } : {}),
3961
4009
  details: completedAgentCard(child, {
3962
4010
  ...(def !== undefined ? { subagentType: def.name } : {}),
3963
4011
  error: errClass,
@@ -5,9 +5,9 @@ import { receiptRefusal, receiveOwnProperties } from "../core/own-property-recei
5
5
  import { credentialHeaderValues, holdOwnCredentialValues, isBlankCredential, isCredentialHeaderName, isSchemedCredentialHeader } from "../core/secret-env.js";
6
6
  import { deliverEngineNotice } from "../core/engine-notice.js";
7
7
  import { uuidv7 } from "../engine/session/uuid.js";
8
- import { REDACTION_MARKS } from "../core/redaction-marks.js";
9
- import { URI_SCHEME_SOURCE, URL_USERINFO_SOURCE } from "../core/credential-vocabulary.js";
10
- const REDACTED_VALUE = "«redacted»";
8
+ import { REDACTION_MARKS, WITHHELD_VALUE_MARK } from "../core/redaction-marks.js";
9
+ import { CREDENTIAL_VOCABULARY } from "@sema-agent/primitives";
10
+ const REDACTED_VALUE = WITHHELD_VALUE_MARK;
11
11
  const REDACTED_CREDENTIALS = REDACTION_MARKS.credentials;
12
12
  function servableParse(raw) {
13
13
  let u;
@@ -181,7 +181,12 @@ export function joinRequestUrl(root, suffix) {
181
181
  }
182
182
  return composed;
183
183
  }
184
- const AUTHORITY_USERINFO = new RegExp(String.raw `(${URI_SCHEME_SOURCE}:\/\/)${URL_USERINFO_SOURCE}`, "g");
184
+ const AUTHORITY_USERINFO = (() => {
185
+ const row = CREDENTIAL_VOCABULARY.values.find((r) => r.id === "url-userinfo");
186
+ if (row === undefined)
187
+ throw new Error('route-adjudicator: the credential vocabulary has no "url-userinfo" row');
188
+ return new RegExp(row.match.source, row.match.flags);
189
+ })();
185
190
  export function stripUrlCredentials(text) {
186
191
  return text.replace(AUTHORITY_USERINFO, `$1${REDACTED_CREDENTIALS}@`);
187
192
  }
@@ -313,6 +313,10 @@ type AllowedToolsSeat = keyof typeof ALLOW_LIST_SEATS;
313
313
  * cannot be received ({@link receiveAnchoredMember}) with `config.invalid_argument`; an anchored path rule whose set declares a
314
314
  * base it cannot be read at — a relative spelling, one of no tree's family — with the code and issue (`unsupported.path_base`) a
315
315
  * deny / ask rule set's declaration meets (`unusableDeclaredBase`, the one judgment).
316
+ *
317
+ * Exported from the package root: a host that takes an allow list in ahead of the run (an admission door) calls this with the seat the
318
+ * list will be handed at, and meets — at the door, in the same words and with the same `code` and `issues` — the refusal the run would
319
+ * answer at its start. It is the one judgment; the host writes no second one.
316
320
  */
317
321
  export declare function screenAllowedToolsValue(value: unknown, seat: AllowedToolsSeat): readonly AllowListEntry[] | undefined;
318
322
  /** The disclosure record for one member, minted from the entries it matched: each sanitized (deployment or model-authored
@@ -81,7 +81,7 @@ function judgeTool(row, live, station) {
81
81
  return { member: "tool", disposition: "veto", code: "resume.target_moved", message: vetoed(row.toolName, "the tool's declaration (what it does, reaches and trusts: its effect, egress, irreversibility, content origin, boundary legs, rule face or model gate) changed after the approval") };
82
82
  }
83
83
  function judgeTargets(row, live) {
84
- if ((row.targets === undefined && row.targetReads === undefined) || ("decided" in live && !licenseCovers(row.boundInputHash, live.decided)))
84
+ if ((row.targets === undefined && row.targetReads === undefined) || ("decided" in live && !licenseCovers(row.boundInputHash, row.toolName, live.decided)))
85
85
  return undefined;
86
86
  const why = landedElsewhere(row.targets, row.targetReads, live);
87
87
  return why === undefined ? undefined : { member: "targets", disposition: "veto", code: "resume.target_moved", message: vetoed(row.toolName, why) };
@@ -1,6 +1,6 @@
1
1
  import { readProgramPosition } from "../tools/fs/bash-program-position.js";
2
2
  import { argvOf, lexShell } from "../shell/lex.js";
3
- import { isSensitiveRecordKey } from "./credential-vocabulary.js";
3
+ import { isSensitiveRecordKey } from "@sema-agent/primitives";
4
4
  import { egressText } from "./untrusted-egress.js";
5
5
  const ACTIVITY_ARG_MAX = 80;
6
6
  function truncCodePoints(s) {
@@ -136,7 +136,7 @@ export declare function hookAskReasonOf(registration: string | undefined, cause:
136
136
  * inherited station's read of an ancestor's ask): the receipt's own words, under the asker its own members name (the origin
137
137
  * ladder over {@link INHERITED_STATION_FACTS} — a rule it matched, a classifier fallback it replays, else the policy). None when
138
138
  * the ask has no words, or when its engine record says its words are the engine's generic question for the call
139
- * (`genericQuestion`, while the ask's sentence is still that one: a write gate's default question, the plan mode's — the
139
+ * ({@link engineSentenceOf}, while the ask's sentence is still that one: a write gate's default question, the plan mode's — the
140
140
  * call's arguments and the ask's class already say it).
141
141
  */
142
142
  export declare function chainAskReasonsOf(receipt: Extract<PermissionResult, {
@@ -1,4 +1,4 @@
1
- import { attestationOf } from "./engine-attestation.js";
1
+ import { attestationOf, engineSentenceOf } from "./engine-attestation.js";
2
2
  import { isShellFaceToolName } from "./tool-registry.js";
3
3
  import { inlineUntrusted } from "./untrusted-text.js";
4
4
  export const ASK_ORIGINS = Object.freeze(["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "shell_gate_tighten", "safety_tighten", "policy"]);
@@ -22,7 +22,7 @@ export function chainAskReasonsOf(receipt, call) {
22
22
  const record = attestationOf(receipt, call);
23
23
  if (record?.receivedAskReasons !== undefined)
24
24
  return record.receivedAskReasons.length > 0 ? record.receivedAskReasons : undefined;
25
- if (message === undefined || message === record?.genericQuestion)
25
+ if (message === undefined || engineSentenceOf(receipt, call)?.generic === true)
26
26
  return undefined;
27
27
  const by = askOriginOf(receipt, { ...INHERITED_STATION_FACTS, call });
28
28
  const words = inlineUntrusted(message, ASK_REASON_WORDS_MAX);
@@ -77,8 +77,8 @@ export interface AskQuestionRequest {
77
77
  * question. `readonly` + same caveat as `principal`. */
78
78
  readonly agentId?: string;
79
79
  /**
80
- * The canonical hash of the tool-call arguments this question was built from, as computed by the
81
- * engine's one `boundInputHashOf` (the same digest the durable park binds its checkpoint to, so the
80
+ * The canonical hash of the tool call this question was built from — the call's tool and its arguments, as computed by
81
+ * the engine's one call binding `exactBoundInputHashOf` (the same digest the durable park binds its checkpoint to, so the
82
82
  * two lanes are reconcilable against each other). Present only when the engine routed the question
83
83
  * — a directly-mounted tool calling its own face carries none.
84
84
  *