@sema-agent/core 7.60.0 → 7.62.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (560) hide show
  1. package/CHANGELOG.md +917 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +71 -12
  6. package/dist/agents/cascade.js +61 -21
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-held-queue.d.ts +27 -4
  17. package/dist/agents/peer-held-queue.js +81 -36
  18. package/dist/agents/peer-notice-route.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.js +4 -3
  20. package/dist/agents/peer-notices.d.ts +4 -4
  21. package/dist/agents/peer-notices.js +8 -4
  22. package/dist/agents/peer-session-drain.d.ts +8 -1
  23. package/dist/agents/peer-session-drain.js +49 -10
  24. package/dist/agents/repair-loop.js +16 -6
  25. package/dist/agents/retain-ledger.js +3 -1
  26. package/dist/agents/roster-store.d.ts +1 -1
  27. package/dist/agents/roster-store.js +7 -4
  28. package/dist/agents/send-message-tool.d.ts +8 -10
  29. package/dist/agents/send-message-tool.js +43 -23
  30. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  31. package/dist/agents/subagent-completion-gate.js +62 -0
  32. package/dist/agents/subagent-steps.d.ts +7 -6
  33. package/dist/agents/subagent.d.ts +36 -41
  34. package/dist/agents/subagent.js +245 -200
  35. package/dist/agents/suspend-guard.d.ts +47 -16
  36. package/dist/agents/suspend-guard.js +13 -4
  37. package/dist/agents/verify.d.ts +41 -14
  38. package/dist/agents/verify.js +41 -30
  39. package/dist/brain/anthropic.js +1 -0
  40. package/dist/brain/errors.d.ts +7 -1
  41. package/dist/brain/errors.js +6 -0
  42. package/dist/brain/failover.js +2 -1
  43. package/dist/brain/open-responses.js +1 -0
  44. package/dist/brain/openai.js +1 -0
  45. package/dist/brain/provider-dialect.d.ts +10 -0
  46. package/dist/brain/provider-dialect.js +13 -2
  47. package/dist/brain/stream-engine.d.ts +3 -0
  48. package/dist/brain/stream-engine.js +4 -0
  49. package/dist/core/agent-state.d.ts +1 -1
  50. package/dist/core/allow-entry.d.ts +59 -23
  51. package/dist/core/allow-entry.js +131 -38
  52. package/dist/core/ask-origin.d.ts +79 -0
  53. package/dist/core/ask-origin.js +76 -0
  54. package/dist/core/ask-question.d.ts +19 -13
  55. package/dist/core/ask-question.js +8 -2
  56. package/dist/core/auto-compaction.d.ts +2 -0
  57. package/dist/core/auto-compaction.js +2 -1
  58. package/dist/core/auto-mode.js +3 -5
  59. package/dist/core/background-agent-store.d.ts +7 -5
  60. package/dist/core/background-agent-store.js +12 -11
  61. package/dist/core/checkpoint-features.d.ts +722 -0
  62. package/dist/core/checkpoint-features.js +98 -0
  63. package/dist/core/checkpoint-requirements.d.ts +33 -5
  64. package/dist/core/checkpoint-requirements.js +18 -5
  65. package/dist/core/checkpoint-row-verdict.d.ts +99 -0
  66. package/dist/core/checkpoint-row-verdict.js +225 -0
  67. package/dist/core/checkpoint-store.d.ts +107 -738
  68. package/dist/core/checkpoint-store.js +45 -143
  69. package/dist/core/child-clamp-seats.d.ts +3 -2
  70. package/dist/core/child-clamp-seats.js +4 -3
  71. package/dist/core/closest-name.d.ts +13 -0
  72. package/dist/core/closest-name.js +35 -0
  73. package/dist/core/context-settings.js +3 -5
  74. package/dist/core/cross-boundary-taint.d.ts +1 -1
  75. package/dist/core/decision-receipt.d.ts +14 -1
  76. package/dist/core/decision-receipt.js +6 -3
  77. package/dist/core/delegation-frames.d.ts +13 -9
  78. package/dist/core/effective-path-target.js +2 -3
  79. package/dist/core/engine-attestation.d.ts +11 -1
  80. package/dist/core/engine-attestation.js +2 -0
  81. package/dist/core/engine-notice.d.ts +68 -21
  82. package/dist/core/engine-notice.js +9 -2
  83. package/dist/core/file-history-retention.d.ts +8 -0
  84. package/dist/core/file-history-retention.js +14 -11
  85. package/dist/core/file-history-store.d.ts +31 -1
  86. package/dist/core/file-history-store.js +31 -2
  87. package/dist/core/frame-settlement.d.ts +10 -0
  88. package/dist/core/frame-settlement.js +6 -1
  89. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  90. package/dist/core/fs-write-gate-policy.js +8 -7
  91. package/dist/core/gate-fold.js +4 -3
  92. package/dist/core/gate-lanes.js +7 -4
  93. package/dist/core/gate-outcome.d.ts +40 -1
  94. package/dist/core/gate-outcome.js +10 -0
  95. package/dist/core/git-worktree-env.d.ts +7 -3
  96. package/dist/core/git-worktree-env.js +16 -13
  97. package/dist/core/governance-codes.d.ts +14 -4
  98. package/dist/core/governance-codes.js +19 -4
  99. package/dist/core/hooks.d.ts +25 -4
  100. package/dist/core/hooks.js +11 -4
  101. package/dist/core/host-floor.js +3 -5
  102. package/dist/core/human-input-projection.d.ts +1 -0
  103. package/dist/core/human-input-projection.js +3 -0
  104. package/dist/core/image-admission.d.ts +47 -7
  105. package/dist/core/image-admission.js +35 -4
  106. package/dist/core/input-author.d.ts +36 -0
  107. package/dist/core/input-author.js +39 -0
  108. package/dist/core/leg-identity.d.ts +62 -0
  109. package/dist/core/leg-identity.js +18 -0
  110. package/dist/core/locked-config.d.ts +4 -3
  111. package/dist/core/locked-config.js +5 -3
  112. package/dist/core/lsp.d.ts +5 -3
  113. package/dist/core/lsp.js +3 -2
  114. package/dist/core/mailbox-store.d.ts +85 -10
  115. package/dist/core/mailbox-store.js +31 -10
  116. package/dist/core/mcp-connection-pool.d.ts +6 -20
  117. package/dist/core/mcp-connection-pool.js +10 -28
  118. package/dist/core/mcp-failure.d.ts +76 -15
  119. package/dist/core/mcp-failure.js +60 -33
  120. package/dist/core/mcp-host-seat.d.ts +92 -53
  121. package/dist/core/mcp-host-seat.js +225 -46
  122. package/dist/core/mcp-probe.js +2 -2
  123. package/dist/core/mcp-server-link.d.ts +18 -6
  124. package/dist/core/mcp-server-link.js +19 -4
  125. package/dist/core/mcp-server-spec.d.ts +2 -1
  126. package/dist/core/mcp-session-end.d.ts +1 -2
  127. package/dist/core/mcp-session-end.js +1 -1
  128. package/dist/core/mcp.d.ts +6 -49
  129. package/dist/core/mcp.js +115 -111
  130. package/dist/core/media-byte-cap.d.ts +21 -46
  131. package/dist/core/media-byte-cap.js +55 -55
  132. package/dist/core/member-group.d.ts +7 -0
  133. package/dist/core/member-group.js +35 -0
  134. package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
  135. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  136. package/dist/core/memory-engine/consolidation.js +7 -1
  137. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  138. package/dist/core/memory-engine/dual-root.js +59 -11
  139. package/dist/core/memory-engine/engine.js +27 -24
  140. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  141. package/dist/core/memory-engine/file-backend.js +35 -15
  142. package/dist/core/memory-engine/layout.d.ts +3 -0
  143. package/dist/core/memory-engine/layout.js +13 -3
  144. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  145. package/dist/core/memory-engine/memory-deployment.js +182 -0
  146. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  147. package/dist/core/memory-engine/sync-client.js +72 -14
  148. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  149. package/dist/core/memory-engine/sync.d.ts +9 -1
  150. package/dist/core/memory-vector.d.ts +1 -1
  151. package/dist/core/memory.d.ts +10 -10
  152. package/dist/core/mode-policy.d.ts +8 -8
  153. package/dist/core/mode-policy.js +8 -6
  154. package/dist/core/mods/agent-stations.d.ts +39 -4
  155. package/dist/core/mods/agent-stations.js +59 -10
  156. package/dist/core/mods/classic-events.d.ts +9 -1
  157. package/dist/core/mods/dollar.d.ts +94 -1
  158. package/dist/core/mods/dollar.js +13 -1
  159. package/dist/core/mods/extension-call.d.ts +15 -1
  160. package/dist/core/mods/extension-call.js +7 -2
  161. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  162. package/dist/core/mods/kernel/dispatch.js +4 -4
  163. package/dist/core/mods/kernel/events.d.ts +14 -3
  164. package/dist/core/mods/kernel/events.js +18 -15
  165. package/dist/core/mods/kernel/registration.d.ts +3 -0
  166. package/dist/core/mods/kernel/registration.js +5 -0
  167. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  168. package/dist/core/mods/kernel/site-rules.js +10 -2
  169. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  170. package/dist/core/mods/lifecycle-stations.js +44 -9
  171. package/dist/core/mods/session-append.d.ts +118 -0
  172. package/dist/core/mods/session-append.js +318 -0
  173. package/dist/core/mods/session-compact.d.ts +48 -0
  174. package/dist/core/mods/session-compact.js +194 -0
  175. package/dist/core/mods/session-receive.d.ts +93 -0
  176. package/dist/core/mods/session-receive.js +138 -0
  177. package/dist/core/mods/session-send.d.ts +72 -0
  178. package/dist/core/mods/session-send.js +88 -0
  179. package/dist/core/mods/stations.d.ts +88 -21
  180. package/dist/core/mods/stations.js +149 -11
  181. package/dist/core/mods/tool-call.d.ts +2 -0
  182. package/dist/core/mods/tool-call.js +4 -4
  183. package/dist/core/output-style.js +3 -4
  184. package/dist/core/own-property-receipt.d.ts +68 -2
  185. package/dist/core/own-property-receipt.js +45 -2
  186. package/dist/core/park-selfcheck.js +4 -2
  187. package/dist/core/path-identity.d.ts +11 -0
  188. package/dist/core/path-identity.js +4 -0
  189. package/dist/core/path-rule-binding.d.ts +3 -1
  190. package/dist/core/path-rule-binding.js +3 -1
  191. package/dist/core/peer-seat.d.ts +3 -3
  192. package/dist/core/peer-seat.js +20 -8
  193. package/dist/core/permission-rule-consent.d.ts +21 -5
  194. package/dist/core/permission-rule-consent.js +21 -1
  195. package/dist/core/permission-rule-model.d.ts +34 -11
  196. package/dist/core/permission-rule-model.js +47 -10
  197. package/dist/core/permission-rule-org.d.ts +1 -1
  198. package/dist/core/permission-rule-provider.js +4 -1
  199. package/dist/core/permission-rules.d.ts +4 -0
  200. package/dist/core/permission-rules.js +11 -16
  201. package/dist/core/read-root-candidate.js +1 -1
  202. package/dist/core/remote-env.d.ts +74 -26
  203. package/dist/core/remote-env.js +20 -0
  204. package/dist/core/resume-startup-cause.d.ts +5 -4
  205. package/dist/core/retention-policy.d.ts +24 -23
  206. package/dist/core/retention-policy.js +36 -2
  207. package/dist/core/retention.d.ts +4 -1
  208. package/dist/core/retired-keys.d.ts +4 -4
  209. package/dist/core/row-admission.d.ts +10 -0
  210. package/dist/core/row-admission.js +5 -0
  211. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  212. package/dist/core/runner/advisor-instructions.js +2 -1
  213. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  214. package/dist/core/runner/assemble-result.d.ts +13 -3
  215. package/dist/core/runner/assemble-result.js +12 -7
  216. package/dist/core/runner/caller-roster.d.ts +12 -9
  217. package/dist/core/runner/caller-roster.js +5 -2
  218. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  219. package/dist/core/runner/checkpoint-scope.js +21 -0
  220. package/dist/core/runner/compact-session.js +18 -3
  221. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  222. package/dist/core/runner/compaction-restate.d.ts +2 -2
  223. package/dist/core/runner/compaction-restate.js +4 -3
  224. package/dist/core/runner/construction-doors.d.ts +2 -2
  225. package/dist/core/runner/construction-doors.js +2 -2
  226. package/dist/core/runner/contracts.d.ts +116 -34
  227. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  228. package/dist/core/runner/decide-continuation.d.ts +4 -2
  229. package/dist/core/runner/decide-continuation.js +7 -4
  230. package/dist/core/runner/delegation-owner.d.ts +43 -0
  231. package/dist/core/runner/delegation-owner.js +59 -0
  232. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  233. package/dist/core/runner/denial-limit-arms.js +17 -10
  234. package/dist/core/runner/expire-settle.d.ts +44 -0
  235. package/dist/core/runner/expire-settle.js +55 -0
  236. package/dist/core/runner/git-status-frame.d.ts +3 -3
  237. package/dist/core/runner/git-status-frame.js +2 -1
  238. package/dist/core/runner/halt-attribution.d.ts +2 -1
  239. package/dist/core/runner/halt-attribution.js +2 -1
  240. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  241. package/dist/core/runner/lineage-reroot-view.js +108 -0
  242. package/dist/core/runner/local-claims.d.ts +17 -0
  243. package/dist/core/runner/local-claims.js +18 -0
  244. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  245. package/dist/core/runner/media-removed-seat.js +88 -0
  246. package/dist/core/runner/park-commit.d.ts +2 -2
  247. package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
  248. package/dist/core/runner/permission-rule-lanes.js +28 -9
  249. package/dist/core/runner/person-path-rows.d.ts +15 -0
  250. package/dist/core/runner/person-path-rows.js +27 -4
  251. package/dist/core/runner/placement-fence.d.ts +26 -0
  252. package/dist/core/runner/placement-fence.js +38 -0
  253. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  254. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  255. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  256. package/dist/core/runner/prepare-ask-lane.js +4 -4
  257. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  258. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  259. package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
  260. package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
  261. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  262. package/dist/core/runner/prepare-config-doors.js +19 -21
  263. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  264. package/dist/core/runner/prepare-context-lane.js +13 -13
  265. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  266. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  267. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  268. package/dist/core/runner/prepare-execution-env.js +7 -4
  269. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  270. package/dist/core/runner/prepare-gate-stations.js +6 -4
  271. package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
  272. package/dist/core/runner/prepare-hands-readface.js +32 -11
  273. package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
  274. package/dist/core/runner/prepare-inherited-gate.js +10 -3
  275. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  276. package/dist/core/runner/prepare-lsp.js +2 -2
  277. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  278. package/dist/core/runner/prepare-park-ask.js +4 -5
  279. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  280. package/dist/core/runner/prepare-policy-chain.js +16 -25
  281. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  282. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  283. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  284. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  285. package/dist/core/runner/prepare-question-face.js +2 -2
  286. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  287. package/dist/core/runner/prepare-run-refs.js +2 -2
  288. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  289. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  290. package/dist/core/runner/prepare-task.d.ts +1 -1
  291. package/dist/core/runner/prepare-task.js +61 -30
  292. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  293. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  294. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  295. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  296. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  297. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  298. package/dist/core/runner/read-root-grant.d.ts +1 -1
  299. package/dist/core/runner/read-root-grant.js +2 -1
  300. package/dist/core/runner/resume-admission.d.ts +8 -6
  301. package/dist/core/runner/resume-admission.js +23 -6
  302. package/dist/core/runner/resume-apply.d.ts +4 -0
  303. package/dist/core/runner/resume-apply.js +14 -5
  304. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  305. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  306. package/dist/core/runner/resume-claim.d.ts +8 -3
  307. package/dist/core/runner/resume-claim.js +28 -12
  308. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  309. package/dist/core/runner/resume-internals-and-config.js +10 -1
  310. package/dist/core/runner/resume-preflight.d.ts +3 -2
  311. package/dist/core/runner/resume-preflight.js +13 -26
  312. package/dist/core/runner/retired-runner-deps.js +2 -0
  313. package/dist/core/runner/run-git-lane.d.ts +2 -0
  314. package/dist/core/runner/run-git-lane.js +6 -2
  315. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  316. package/dist/core/runner/run-harness-handlers.js +5 -4
  317. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  318. package/dist/core/runner/run-identity-wiring.js +14 -5
  319. package/dist/core/runner/run-leg.d.ts +3 -3
  320. package/dist/core/runner/run-leg.js +64 -36
  321. package/dist/core/runner/run-notification-lane.js +20 -2
  322. package/dist/core/runner/run-recovery-lanes.js +3 -2
  323. package/dist/core/runner/run-settle-and-teardown.js +12 -9
  324. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  325. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  326. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  327. package/dist/core/runner/run-terminal-adoption.js +26 -17
  328. package/dist/core/runner/run-turn-boundary.js +34 -18
  329. package/dist/core/runner/runtask.d.ts +18 -3
  330. package/dist/core/runner/runtask.js +33 -17
  331. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  332. package/dist/core/runner/session-rule-policy.js +6 -1
  333. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  334. package/dist/core/runner/steering-preview.d.ts +9 -0
  335. package/dist/core/runner/steering-preview.js +5 -0
  336. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  337. package/dist/core/runner/stream-halt-verbs.js +4 -3
  338. package/dist/core/runner/stream-reap.d.ts +7 -6
  339. package/dist/core/runner/stream-reap.js +13 -16
  340. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  341. package/dist/core/runner/stream-settle-backstop.js +5 -3
  342. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  343. package/dist/core/runner/stream-steer-verb.js +16 -7
  344. package/dist/core/runner/terminal-account.d.ts +11 -1
  345. package/dist/core/runner/terminal-account.js +20 -0
  346. package/dist/core/runner/terminal-projection.d.ts +8 -2
  347. package/dist/core/runner/terminal-projection.js +2 -2
  348. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  349. package/dist/core/runner/tool-disclosure.js +5 -2
  350. package/dist/core/runner/tool-end-body.d.ts +3 -3
  351. package/dist/core/runner/tool-end-body.js +1 -1
  352. package/dist/core/runner/tool-face-overlay.js +2 -0
  353. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  354. package/dist/core/runner/tool-output-projection.js +7 -6
  355. package/dist/core/runner/tool-table-view.d.ts +56 -0
  356. package/dist/core/runner/tool-table-view.js +51 -0
  357. package/dist/core/runner/turn-attachments.d.ts +8 -2
  358. package/dist/core/runner/turn-attachments.js +2 -2
  359. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  360. package/dist/core/runner/void-verifier-pause.js +41 -0
  361. package/dist/core/runner-deps.d.ts +26 -27
  362. package/dist/core/secret-env.d.ts +19 -16
  363. package/dist/core/secret-env.js +45 -27
  364. package/dist/core/session-log-transfer.js +9 -10
  365. package/dist/core/session-policy-store.d.ts +1 -1
  366. package/dist/core/session-policy-store.js +5 -2
  367. package/dist/core/session-reconcile.d.ts +3 -2
  368. package/dist/core/session-reconcile.js +7 -4
  369. package/dist/core/session-store.d.ts +3 -1
  370. package/dist/core/session-store.js +10 -8
  371. package/dist/core/session.d.ts +16 -5
  372. package/dist/core/shell-confinement.d.ts +37 -0
  373. package/dist/core/shell-confinement.js +56 -0
  374. package/dist/core/skill-grant.js +1 -1
  375. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
  376. package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
  377. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  378. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  379. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  380. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  381. package/dist/core/store-contracts/session-store-contract.js +22 -8
  382. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  383. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  384. package/dist/core/task-event.d.ts +24 -9
  385. package/dist/core/task-limits.d.ts +5 -0
  386. package/dist/core/task-notification.d.ts +89 -12
  387. package/dist/core/task-notification.js +89 -14
  388. package/dist/core/task-registry-agent.d.ts +32 -50
  389. package/dist/core/task-registry-agent.js +36 -56
  390. package/dist/core/task-registry-monitor.d.ts +1 -1
  391. package/dist/core/task-registry-monitor.js +15 -60
  392. package/dist/core/task-registry-shared.d.ts +22 -112
  393. package/dist/core/task-registry-shared.js +3 -41
  394. package/dist/core/task-registry-workflow.js +5 -21
  395. package/dist/core/task-registry.d.ts +32 -62
  396. package/dist/core/task-registry.js +30 -110
  397. package/dist/core/task-result.d.ts +29 -12
  398. package/dist/core/task-spec-members.d.ts +39 -0
  399. package/dist/core/task-spec-members.js +92 -0
  400. package/dist/core/task-spec.d.ts +11 -11
  401. package/dist/core/task-tool-shape.d.ts +7 -57
  402. package/dist/core/task-tool-shape.js +7 -66
  403. package/dist/core/terminal-cause.d.ts +36 -6
  404. package/dist/core/terminal-cause.js +1 -0
  405. package/dist/core/tool-catalog-entries.js +2 -5
  406. package/dist/core/tool-check-reading.js +16 -10
  407. package/dist/core/tool-conformance.js +1 -2
  408. package/dist/core/tool-errors.d.ts +6 -3
  409. package/dist/core/tool-errors.js +2 -0
  410. package/dist/core/tool-face-reader.js +3 -2
  411. package/dist/core/tool-face.d.ts +8 -5
  412. package/dist/core/tool-face.js +1 -1
  413. package/dist/core/tool-name-aliases.d.ts +5 -29
  414. package/dist/core/tool-name-aliases.js +9 -5
  415. package/dist/core/tool-name-readings.d.ts +14 -3
  416. package/dist/core/tool-name-readings.js +2 -0
  417. package/dist/core/tool-policy.d.ts +109 -18
  418. package/dist/core/tool-policy.js +84 -14
  419. package/dist/core/tool-result-store.d.ts +23 -0
  420. package/dist/core/tool-result-store.js +3 -2
  421. package/dist/core/tool-roster.d.ts +4 -4
  422. package/dist/core/tool-spec.d.ts +23 -6
  423. package/dist/core/trace.d.ts +18 -1
  424. package/dist/core/types.d.ts +1 -1
  425. package/dist/core/types.js +1 -1
  426. package/dist/core/user-attachment.js +26 -21
  427. package/dist/core/workflow-journal-store.d.ts +1 -1
  428. package/dist/core/workflow-run-store.d.ts +2 -0
  429. package/dist/core/workflow-run-store.js +6 -5
  430. package/dist/core/workflow-settled-run.d.ts +5 -0
  431. package/dist/core/workflow-settled-run.js +7 -0
  432. package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
  433. package/dist/engine/execution-env/node-execution-env.js +221 -22
  434. package/dist/engine/harness/agent-harness.d.ts +65 -18
  435. package/dist/engine/harness/agent-harness.js +90 -23
  436. package/dist/engine/harness/messages.d.ts +4 -3
  437. package/dist/engine/harness/messages.js +2 -2
  438. package/dist/engine/harness/types.d.ts +52 -7
  439. package/dist/engine/llm/media-removed.d.ts +14 -0
  440. package/dist/engine/llm/media-removed.js +9 -0
  441. package/dist/engine/llm/rejected-images.d.ts +35 -25
  442. package/dist/engine/llm/rejected-images.js +59 -10
  443. package/dist/engine/llm/types.d.ts +24 -3
  444. package/dist/engine/llm/types.js +7 -3
  445. package/dist/engine/loop/agent-loop.d.ts +6 -1
  446. package/dist/engine/loop/agent-loop.js +20 -11
  447. package/dist/engine/loop/types.d.ts +12 -3
  448. package/dist/engine/session/import-validate.js +7 -0
  449. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  450. package/dist/engine/session/parent-chain-guard.js +1 -1
  451. package/dist/engine/session/path-to-root.d.ts +18 -3
  452. package/dist/engine/session/path-to-root.js +15 -1
  453. package/dist/engine/session/repo-utils.d.ts +12 -1
  454. package/dist/engine/session/repo-utils.js +41 -0
  455. package/dist/engine/session/session.js +1 -1
  456. package/dist/engine/session/storage-base.d.ts +20 -0
  457. package/dist/engine/session/storage-base.js +28 -9
  458. package/dist/fixtures/index.d.ts +7 -5
  459. package/dist/fixtures/index.js +5 -3
  460. package/dist/index.d.ts +29 -18
  461. package/dist/index.js +19 -11
  462. package/dist/internal/harness-types.d.ts +2 -0
  463. package/dist/internal/harness.d.ts +4 -3
  464. package/dist/internal/harness.js +3 -2
  465. package/dist/internal/llm.d.ts +2 -1
  466. package/dist/internal/llm.js +1 -0
  467. package/dist/orchestration/goal.d.ts +6 -2
  468. package/dist/orchestration/goal.js +6 -3
  469. package/dist/orchestration/run-workflow-tool.d.ts +14 -17
  470. package/dist/orchestration/run-workflow-tool.js +43 -50
  471. package/dist/orchestration/workflow-types.d.ts +2 -2
  472. package/dist/orchestration/workflow.d.ts +7 -0
  473. package/dist/orchestration/workflow.js +10 -12
  474. package/dist/stores/file/background-agent-store.js +18 -15
  475. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  476. package/dist/stores/file/checkpoint-store.js +13 -9
  477. package/dist/stores/file/file-history-store.js +3 -2
  478. package/dist/stores/file/fs-atomic.d.ts +0 -22
  479. package/dist/stores/file/fs-atomic.js +0 -17
  480. package/dist/stores/file/index.d.ts +7 -12
  481. package/dist/stores/file/index.js +25 -12
  482. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  483. package/dist/stores/file/ledger-tuning.js +21 -0
  484. package/dist/stores/file/mailbox-store.js +42 -22
  485. package/dist/stores/file/memory-store.js +3 -2
  486. package/dist/stores/file/permission-rule-adopt.js +24 -21
  487. package/dist/stores/file/permission-rule-store.js +6 -3
  488. package/dist/stores/file/session-policy-store.js +3 -2
  489. package/dist/stores/file/session-store.d.ts +26 -7
  490. package/dist/stores/file/session-store.js +59 -35
  491. package/dist/stores/file/tool-result-store.d.ts +11 -0
  492. package/dist/stores/file/tool-result-store.js +57 -3
  493. package/dist/stores/file/usage-window-store.js +3 -2
  494. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  495. package/dist/stores/file/workflow-journal-store.js +3 -18
  496. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  497. package/dist/stores/file/workflow-run-store.js +15 -10
  498. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  499. package/dist/tools/fs/bash-program-position.js +7 -7
  500. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  501. package/dist/tools/fs/dead-cwd.js +4 -11
  502. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  503. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  504. package/dist/tools/fs/fs-bash.d.ts +3 -18
  505. package/dist/tools/fs/fs-bash.js +37 -124
  506. package/dist/tools/fs/fs-pdf.js +8 -6
  507. package/dist/tools/fs/fs-read.js +2 -2
  508. package/dist/tools/fs/fs-shared.d.ts +28 -3
  509. package/dist/tools/fs/fs-shared.js +15 -0
  510. package/dist/tools/fs/index.d.ts +1 -1
  511. package/dist/tools/fs/index.js +4 -14
  512. package/dist/tools/fs/pdf.d.ts +4 -4
  513. package/dist/tools/fs/pdf.js +6 -6
  514. package/dist/tools/fs/read-deny-home.js +8 -1
  515. package/dist/tools/fs/read-deny.d.ts +26 -2
  516. package/dist/tools/fs/read-deny.js +9 -2
  517. package/dist/tools/fs/read-floor.d.ts +13 -5
  518. package/dist/tools/fs/read-floor.js +206 -2
  519. package/dist/tools/fs/removal-targets.js +2 -2
  520. package/dist/tools/fs/search.d.ts +3 -2
  521. package/dist/tools/fs/search.js +6 -6
  522. package/dist/tools/fs/shell-read-argv.d.ts +4 -2
  523. package/dist/tools/fs/shell-read-argv.js +14 -3
  524. package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
  525. package/dist/tools/fs/shell-read-bindings.js +148 -68
  526. package/dist/tools/fs/shell-read-check.js +20 -4
  527. package/dist/tools/fs/shell-read-establish.js +25 -9
  528. package/dist/tools/fs/shell-read-functions.js +2 -2
  529. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  530. package/dist/tools/fs/shell-read-identity.js +4 -2
  531. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  532. package/dist/tools/fs/shell-read-judge.js +1 -1
  533. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  534. package/dist/tools/fs/shell-read-object-path.js +119 -0
  535. package/dist/tools/fs/shell-read-plan.d.ts +8 -0
  536. package/dist/tools/fs/shell-read-plan.js +47 -30
  537. package/dist/tools/fs/shell-read-start.d.ts +66 -13
  538. package/dist/tools/fs/shell-read-start.js +89 -17
  539. package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
  540. package/dist/tools/fs/shell-read-workdir.js +31 -8
  541. package/dist/tools/monitor.d.ts +8 -7
  542. package/dist/tools/monitor.js +12 -10
  543. package/dist/tools/worktree.d.ts +5 -1
  544. package/dist/tools/worktree.js +20 -17
  545. package/package.json +6 -3
  546. package/test/export-surface.snapshot.json +112 -42
  547. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  548. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  549. package/wire-changes/core@7.61.0.json +4405 -0
  550. package/wire-changes/core@7.62.0.json +2181 -0
  551. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  552. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  553. package/wire-changes/primitives@7.61.0.json +30 -0
  554. package/wire-changes/primitives@7.62.0.json +30 -0
  555. package/dist/core/consolidate-scope.d.ts +0 -93
  556. package/dist/core/consolidate-scope.js +0 -98
  557. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  558. package/dist/core/runner/image-removed-seat.js +0 -19
  559. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  560. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -89,16 +89,13 @@ export function statusFromBackground(status, exitCode) {
89
89
  return exitCode === 0 ? "completed" : "failed";
90
90
  return "failed";
91
91
  }
92
- export function rollSpoolText(spool, s, cap, onDrop) {
92
+ export function rollSpoolText(spool, s, cap) {
93
93
  if (s.length <= cap)
94
94
  return s;
95
95
  const half = Math.floor(cap / 2);
96
- const dropped = s.slice(half, s.length - half);
97
- spool.rolledChars += dropped.length;
98
- onDrop?.(dropped);
96
+ spool.rolledChars += s.length - 2 * half;
99
97
  return s.slice(0, half) + s.slice(s.length - half);
100
98
  }
101
- export const MONITOR_SPILL_CAP_CHARS = 64 * 1024 * 1024;
102
99
  export function accountDroppedBytes(spool, poll) {
103
100
  const d = poll.bytesDroppedBeforeCursor ?? 0;
104
101
  if (d > 0)
@@ -127,7 +124,7 @@ export function stdoutHeadingOf(replay, gapDisclosed) {
127
124
  export function renderSpoolBody(spool, opts) {
128
125
  const timedOutClause = spool.timedOut === true ? ` (timed out after ${spool.timeoutSec !== undefined ? `${spool.timeoutSec}s` : "its background time budget"})` : "";
129
126
  const displayStatus = (spool.exitCode !== undefined ? `exited(code ${spool.exitCode})` : opts.running ? "running" : opts.handleStatus) + timedOutClause;
130
- const rolledNote = spool.rolledChars > 0 ? `[!] ${spool.rolledChars} earlier char(s) dropped from the spool (memory bound)${opts.rolledExtraClause}\n` : "";
127
+ const rolledNote = spool.rolledChars > 0 ? `[!] ${spool.rolledChars} earlier char(s) dropped from the spool (memory bound)\n` : "";
131
128
  const droppedNote = spoolDropNote(spool);
132
129
  const stdoutHeading = stdoutHeadingOf(SPOOL_REPLAY, droppedNote !== "" || opts.drainNote !== "");
133
130
  return (`status: ${displayStatus}\n${rolledNote}${droppedNote}${opts.drainNote}--- ${stdoutHeading} ---\n${opts.shape(spool.stdout) || "(none)"}\n` +
@@ -313,41 +310,6 @@ export function normalizeAgentName(s) {
313
310
  .toLowerCase()
314
311
  .replace(/\s+/g, "-");
315
312
  }
316
- export function editDistance(a, b) {
317
- if (a === b)
318
- return 0;
319
- const m = a.length;
320
- const n = b.length;
321
- const d = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
322
- for (let i = 1; i <= m; i++) {
323
- for (let j = 1; j <= n; j++) {
324
- const cost = a[i - 1] === b[j - 1] ? 0 : 1;
325
- d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
326
- if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
327
- d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
328
- }
329
- }
330
- }
331
- return d[m][n];
332
- }
333
- export function closestName(query, candidates) {
334
- let best;
335
- let bestDist = 3;
336
- const seen = new Set();
337
- for (const c of candidates) {
338
- if (seen.has(c))
339
- continue;
340
- seen.add(c);
341
- if (Math.abs(c.length - query.length) > 2)
342
- continue;
343
- const dist = editDistance(query, c);
344
- if (dist <= 2 && dist < bestDist) {
345
- bestDist = dist;
346
- best = c;
347
- }
348
- }
349
- return best;
350
- }
351
313
  export function canAccess(handle, access) {
352
314
  if (handle.scope === undefined || access.scope === undefined || access.scope !== handle.scope)
353
315
  return false;
@@ -1,6 +1,7 @@
1
1
  import { boundedRedactedSummary } from "./untrusted-egress.js";
2
2
  import { delimitUntrusted } from "./untrusted-text.js";
3
3
  import { thrownText } from "./thrown-value.js";
4
+ import { settledRunOf } from "./workflow-settled-run.js";
4
5
  import { assertOwnership, canAccessWorkflowRun, formatWorkflowRun, sleepPollStep, } from "./task-registry-shared.js";
5
6
  export function registerWorkflowLane(core, input) {
6
7
  assertOwnership(input, "registerWorkflow");
@@ -23,7 +24,6 @@ export function registerWorkflowLane(core, input) {
23
24
  handle: input.handle,
24
25
  ...(input.store !== undefined ? { store: input.store } : {}),
25
26
  ...(originatingSessionId !== undefined ? { originatingSessionId, sessionScoped: true } : {}),
26
- ...(input.onServedTerminal !== undefined ? { onServedTerminal: input.onServedTerminal } : {}),
27
27
  };
28
28
  core.handles.set(id, handle);
29
29
  void input.handle.done.then((res) => {
@@ -38,27 +38,15 @@ export function registerWorkflowLane(core, input) {
38
38
  }, (err) => {
39
39
  if (handle.status !== "cancelled")
40
40
  handle.status = "failed";
41
+ const settledRun = settledRunOf(input.handle.done);
42
+ const settleId = settledRun?.completionId;
41
43
  handle.error = boundedRedactedSummary(thrownText(err), 500);
42
- const rejectedRun = err !== null && (typeof err === "object" || typeof err === "function")
43
- ? err.workflowRun
44
- : undefined;
45
- if (rejectedRun?.completionId !== undefined)
46
- handle.completionId = rejectedRun.completionId;
44
+ if (settleId !== undefined)
45
+ handle.completionId = settleId;
47
46
  handle.updatedAt = Date.now();
48
47
  });
49
48
  return id;
50
49
  }
51
- function fireServedTerminalLane(handle) {
52
- const cb = handle.onServedTerminal;
53
- if (!cb)
54
- return;
55
- handle.onServedTerminal = undefined;
56
- try {
57
- cb();
58
- }
59
- catch {
60
- }
61
- }
62
50
  export async function pollWorkflowLane(handle, access, deadline, signal) {
63
51
  const store = handle.store;
64
52
  if (store) {
@@ -70,8 +58,6 @@ export async function pollWorkflowLane(handle, access, deadline, signal) {
70
58
  const out = formatWorkflowRun(run);
71
59
  if (run.status === "running" && deadline !== undefined && Date.now() >= deadline)
72
60
  out.details.retrieval_status = "timeout";
73
- else if (run.status !== "running")
74
- fireServedTerminalLane(handle);
75
61
  return out;
76
62
  }
77
63
  await sleepPollStep(deadline, signal);
@@ -80,8 +66,6 @@ export async function pollWorkflowLane(handle, access, deadline, signal) {
80
66
  while (handle.status === "running" && deadline !== undefined && Date.now() < deadline && !signal?.aborted) {
81
67
  await sleepPollStep(deadline, signal);
82
68
  }
83
- if (handle.status !== "running")
84
- fireServedTerminalLane(handle);
85
69
  return {
86
70
  content: JSON.stringify({
87
71
  task_id: handle.id,
@@ -5,11 +5,13 @@ import type { BoundaryLegsGiven } from "./cross-boundary-taint.js";
5
5
  import type { WorkflowRunStore } from "./workflow-run-store.js";
6
6
  import { type BackgroundAgentStore } from "./background-agent-store.js";
7
7
  import type { TaskNotificationPayload } from "./task-notification.js";
8
- import { type TaskArtifactSeat, type ToolResultStore } from "./tool-result-store.js";
8
+ import { type TaskArtifactSeat } from "./tool-result-store.js";
9
9
  import { type SemaTaskType, type StopSource, type SemaTaskStatus, type TaskRetrievalStatus, type UnifiedTaskOutput, type UnifiedTaskResult, type SemaTaskHandle, type TaskAccess, type BackgroundAgentTaskHandle, type MonitorTimers, type RegisterMonitorInput, type RegisterWorkflowInput, canAccessWorkflowRun, clipTaskOutput, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE } from "./task-registry-shared.js";
10
10
  export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, engineAgentName, chosenAgentName } from "./task-registry-shared.js";
11
11
  export type { ParkedClaimTicket, RegisterBackgroundAgentInput } from "./task-registry-shared.js";
12
- import type { RegisterBackgroundAgentInput, ParkedClaimTicket } from "./task-registry-shared.js";
12
+ import type { RegisterBackgroundAgentInput, ParkedClaimTicket, ChildSessionStore } from "./task-registry-shared.js";
13
+ import type { ChildSessionAnchor } from "./task-registry-agent.js";
14
+ import { type DelegationOccupant } from "./task-registry-agent.js";
13
15
  import { type AgentStateSource } from "./agent-state.js";
14
16
  import type { CheckpointSeat } from "./checkpoint-seat.js";
15
17
  export type { SemaTaskType, StopSource, SemaTaskStatus, TaskRetrievalStatus, UnifiedTaskOutput, SemaTaskHandle, TaskAccess, MonitorTimers, RegisterMonitorInput, RegisterWorkflowInput, };
@@ -31,11 +33,11 @@ export interface RegisterBackgroundBashInput extends TaskAccess {
31
33
  sessionScoped?: true;
32
34
  /** design/116 §7 G2b: when set, the registry WATCHES the process (1s poll, increments spooled with a
33
35
  * rolling bound) and fires ONE completion task-notification at the terminal state — the background-bash
34
- * half of CC's LocalShellTask completion notify. Also flips TaskOutput to re-readable spool reads. */
36
+ * half of CC's LocalShellTask completion notify. Also flips the host poll to re-readable spool reads. */
35
37
  onTerminal?: (notification: TaskNotificationPayload) => void;
36
38
  /** The task's OUTPUT FILE — the launch receipt advertises it and the watcher
37
39
  * mirrors every polled increment into it (append-only, unbounded — unlike the rolling in-memory
38
- * spool), so "Read the output file path" is a real alternative to TaskOutput. Terminal
40
+ * spool), so "Read the output file path" is the model's read of the command's output. Terminal
39
41
  * task-notifications carry the same path (`output_file`). Primarily meaningful with `onTerminal`
40
42
  * (only the watcher mirrors increments live); a watcher-less row still gets ONE final best-effort
41
43
  * append at TaskStop/run-teardown (the tail drain), so the file is written even without a watcher —
@@ -66,19 +68,13 @@ export interface TaskPollOptions {
66
68
  * (terminal snapshot / honest cross-instance "running elsewhere"), behind {@link canAccessAgentRecord}. */
67
69
  agentStore?: BackgroundAgentStore;
68
70
  filter?: string;
69
- /** design/116 W3 (CC TaskOutput `block`): wait until the task reaches a terminal state (or `timeoutMs`)
70
- * instead of returning the instantaneous snapshot — saves the model blind re-poll turns. The TOOL layer
71
- * defaults this to TRUE (裁定 2026-07-02); registry callers pass it explicitly. */
71
+ /** design/116 W3: wait until the task reaches a terminal state (or `timeoutMs`) instead of returning the
72
+ * instantaneous snapshot. Absent ⇒ the snapshot. */
72
73
  block?: boolean;
73
74
  /** Max wait for `block` (ms). Default 30s, capped at 600s. */
74
75
  timeoutMs?: number;
75
- /** Abort signal — a blocked wait must stop when the tool call is cancelled. */
76
+ /** Abort signal — a blocked wait stops when the caller cancels. */
76
77
  signal?: AbortSignal;
77
- /** design/158 S1 (RB-205-B 半): the offload store a CLIPPED background_agent result's full text
78
- * spills to — the disclosure gains a `ReadToolResult` ref instead of the middle staying gone for
79
- * good (see {@link import("./task-registry-agent.js").spillClippedAgentResult}). Absent (a
80
- * deployment that never wired a tool-result store) ⇒ legal degrade, byte-identical to pre-S1 output. */
81
- toolResultStore?: ToolResultStore;
82
78
  /** The run's checkpoint seat: a PARKED background_agent row's approval card is read from it for the
83
79
  * answer's `agentState` ({@link import("./agent-state.js").readAgentState}). Absent ⇒ the card reads
84
80
  * `unreadable`; nothing else changes. */
@@ -93,28 +89,8 @@ export interface TaskStopOptions {
93
89
  export interface TaskToolOptions extends TaskAccess {
94
90
  registry: TaskRegistry;
95
91
  workflowStore?: WorkflowRunStore;
96
- /** design/151 S1a: durable agent ledger — threads into pollTask/stopTask fallback reads. */
92
+ /** design/151 S1a: durable agent ledger — threads into the stopTask fallback read. */
97
93
  agentStore?: BackgroundAgentStore;
98
- /** the task's soft wall-clock deadline (absolute ms epoch), same source as the Bash
99
- * foreground clamp (design/130 P2b). When present, a BLOCKING TaskOutput wait is clamped so it
100
- * cannot eat the write-out window: the model gets an honest, visible clamp note instead of a
101
- * silent 10-minute blind wait into the finalize wall (TB rs**: 9.1min poll = the exact tax).
102
- * CC posture note: CC classifies WIND-DOWN waits, and its
103
- * block cap rides per-query budgets — a deadline-aware wait is the sema equivalent on the tool face. */
104
- deadlineMs?: () => number | undefined;
105
- /** design/157 B17 S2 (fable 终判 D4) — whether a terminal <task-notification> is actually wired for
106
- * this mount. Drives the composed description's notification sentence: the pre-S2 literal advertised
107
- * the notification unconditionally, which was a false promise on deployments that never wired
108
- * `taskNotification` (B17 方案查出的既有假广告). Default true (a direct public-API consumer keeps the
109
- * historical wording); prepare-task passes the real wiring state. */
110
- notificationWired?: boolean;
111
- /** design/158 S1 (RB-205-B 半): the offload store a CLIPPED background_agent result's full text
112
- * spills to — see {@link TaskPollOptions.toolResultStore} (forwarded verbatim into `pollTask`).
113
- * Absent ⇒ legal degrade, byte-identical to pre-S1 output. */
114
- toolResultStore?: ToolResultStore;
115
- /** The run's checkpoint seat — see {@link TaskPollOptions.checkpointSeat} (forwarded verbatim into
116
- * `pollTask`). The first-party mount passes the same seat the Agent tool parks children into. */
117
- checkpointSeat?: CheckpointSeat;
118
94
  }
119
95
  /** One row of {@link TaskRegistry.list} (and {@link TaskRegistry.liveTasks}): the DISPLAY projection of a task
120
96
  * the caller reaches — never the internal handle. One name for the list, the live reading and the walk behind both. */
@@ -244,7 +220,9 @@ export declare class TaskRegistry {
244
220
  /** The successful release of child session `sessionId` ends row `id`'s anchor on it — handle and durable
245
221
  * record together, and only while the row still names that session (see {@link releaseDurableTranscriptAnchorLane}). */
246
222
  releaseDurableTranscriptAnchor(id: string, sessionId: string): void;
247
- bindBackgroundAgentSession(id: string, sessionId: string): void;
223
+ /** Anchor row `id` to its child session `sessionId`, held through `store` — the store the child's run creates or resumes that
224
+ * session in (see {@link bindBackgroundAgentSessionLane}). */
225
+ bindBackgroundAgentSession(id: string, sessionId: string, store: ChildSessionStore): void;
248
226
  registerBackgroundAgent(input: RegisterBackgroundAgentInput): string;
249
227
  /** #22 — persist this leg's org-memory admission verdict on the durable row (the cross-process
250
228
  * revival's only carrier). See {@link recordBackgroundAgentOrgAdmissionLane}. */
@@ -338,6 +316,9 @@ export declare class TaskRegistry {
338
316
  * contract (the caps check and the registration form one atomic segment). See
339
317
  * {@link activeDelegationHandlesLane}. */
340
318
  activeDelegationHandles(scope: string, rootSessionId: string): string[];
319
+ /** The same rows as {@link activeDelegationHandles}, each with its addressing name and whether `caller` reaches it — what a refusal
320
+ * of one more child may tell its caller about who holds the tree's slots. See {@link activeDelegationOccupantsLane}. */
321
+ activeDelegationOccupants(scope: string, rootSessionId: string, caller?: TaskAccess): DelegationOccupant[];
341
322
  /** ASYNC (revive arbitration) — the durable half is a guarded ownership claim on the row (awaited before the
342
323
  * in-memory flip), so this leg and a cross-process claim arbitrate in one domain instead of both
343
324
  * believing they own the cycle. See {@link reviveBackgroundAgentLane}. */
@@ -377,7 +358,7 @@ export declare class TaskRegistry {
377
358
  disposition: "queued" | "parked" | "pending";
378
359
  } | {
379
360
  ok: false;
380
- reason: "not_found" | "not_running" | "no_channel" | "queue_full";
361
+ reason: "not_found" | "not_running" | "no_channel" | "queue_full" | "refused";
381
362
  }>;
382
363
  runningBackgroundAgentLabels(access: TaskAccess): string[];
383
364
  private pollBackgroundAgent;
@@ -422,7 +403,7 @@ export declare class TaskRegistry {
422
403
  private commandRecordSink;
423
404
  /** Background output-file read exemption: true iff `canonicalPath` is EXACTLY the registered output
424
405
  * file of a background bash or monitor row that (a) the caller can access (same owner/scope/session visibility as
425
- * a TaskOutput poll — {@link canAccess}) and (b) was registered on the caller's OWN execution env —
406
+ * a task poll — {@link canAccess}) and (b) was registered on the caller's OWN execution env —
426
407
  * `env` identity is part of the match, same discipline as {@link runningShellIds}. A canonical path only names a file within ONE env's filesystem
427
408
  * namespace: on a shared registry, a row minted on env A must never exempt a same-named outside-root
428
409
  * file in env B's namespace (same session or not), so instance equality — never a string proxy — is
@@ -461,25 +442,9 @@ export declare class TaskRegistry {
461
442
  * must not be marked, or the next reader would be told a live process had been killed.
462
443
  *
463
444
  * Attribution only: it never kills anything. The caller has already demonstrated kill capability on the
464
- * env, which is why there is no access guard (same reasoning as {@link markStopSourceByShellId}).
445
+ * env, which is why there is no access guard.
465
446
  */
466
447
  markStopSourceForEnvSweep(env: unknown, source: StopSource, except?: readonly string[]): string[];
467
- /** design/134 KNOWN-ISSUES close-out (env-direct TaskStop): the stop-source annotation face
468
- * addressed by the ENV-level shellId — for a kill initiator that holds only the env handle (the
469
- * registry-less TaskStop band) and is about to `env.killBackground` directly, i.e. without going
470
- * through {@link stopTask}. Resolves the shellId → unified task id and delegates to
471
- * {@link markStopSource}, so the running-only + first-marker-wins guards hold unchanged.
472
- * ⚠️ `env` is REQUIRED for any effect (RB-479-A②, 5.0.0): a shellId without its env is ambiguous
473
- * by construction on a shared registry, so an env-less call is a NO-OP — this marker is
474
- * best-effort attribution, not data. No access guard — attribution only (never kills); the
475
- * caller already demonstrated kill capability on the env. */
476
- markStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
477
- /** Withdraw a pending stop-source marker after the kill it announced FAILED (小优化批 2026-07-13):
478
- * a marker left by a failed env-direct kill would win first-marker-wins against the NEXT, real stopper
479
- * (e.g. a later user TaskStop reads "parent"). Clears ONLY the exact still-pending marker the caller
480
- * minted — same (shellId, env) resolution as {@link markStopSourceByShellId}; a row already settled,
481
- * or carrying a different source, is left alone. */
482
- clearPendingStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
483
448
  /** design/134 §3.3: narrow terminal read for consumers (subagent sinkEmit/notify) — only a KILLED row
484
449
  * has an attribution; "system" is the defensive floor for a row that went killed without a landed
485
450
  * stoppedBy (e.g. env-direct flips). Returns undefined for running/completed/failed/evicted rows. */
@@ -491,10 +456,12 @@ export declare class TaskRegistry {
491
456
  * every registered task kind, workflow included, carries it the same way. Undefined until the task's
492
457
  * own settle point has run ({@link mintCompletionId}), or for an id this registry never held. */
493
458
  getCompletionId(id: string): string | undefined;
494
- /** Record the ref a task's cut result was stored under (`persistTaskArtifact` landed it) — the read handle a
495
- * later list of tasks names for it. `cycle` = the revive cycle the result belongs to (0 = the spawn cycle; a workflow
496
- * has only 0): a row revived since (its cycle moved on) or already gone (terminal GC) records nothing. */
497
- recordArtifactRef(id: string, ref: string, cycle: number): void;
459
+ /** Record the ref a task's result was stored under (`persistTaskArtifact` landed it) — the read handle a later list of
460
+ * tasks names for it. `completionId` = the settle the result belongs to ({@link getCompletionId}, read in that settle's own
461
+ * synchronous step — every terminal frame carries it): the write records only while the row still holds that settle. A row revived
462
+ * since (a new cycle clears the id and mints its own), replaced under the same id (a revival in another registration),
463
+ * or gone (terminal GC) records nothing — and so does a write that names no settle. */
464
+ recordArtifactRef(id: string, ref: string, completionId: string | undefined): void;
498
465
  /** The legs a page-back of `ref` travels (ReadToolResult's per-call reading): a ref holding a background task's result —
499
466
  * its origin is part of the ref ({@link taskArtifactOriginOf}), so no row eviction, restart or other store forgets it —
500
467
  * travels what a poll of that task travels ({@link boundaryLegsOf}, `"output"` — another tree's agent, a workflow run, a
@@ -588,7 +555,7 @@ export declare class TaskRegistry {
588
555
  * `originatingSessionId` — see {@link reapSessionBackground}'s own workflow arm for why) — and runs
589
556
  * the per-session reap on each pair; retained rows are left alone (row and process), exactly like the
590
557
  * per-session anchor. Timing discipline: call at the hardShutdown TERMINUS, never at drain start — an
591
- * in-flight turn may still be TaskOutput-following a bg process. Returns total rows reaped.
558
+ * in-flight turn may still be following a bg process. Returns total rows reaped.
592
559
  *
593
560
  * Its kills go through each env's `killBackground` (possibly a TERM-then-timer ladder), and it reaches
594
561
  * session-resident rows only: every exit terminus calls {@link killAllBackgroundShellsNow} after it. */
@@ -654,7 +621,7 @@ export declare class TaskRegistry {
654
621
  * watcher tick that passed its status gate before the settle landed) emits exactly ONE terminal notice.
655
622
  * The latch stays set even if the sink throws — a faulty sink must not re-arm it. */
656
623
  private notifyTerminalOnce;
657
- /** G2b watcher (design/116 §7): 1s poll loop that spools increments (rolling bound) and fires ONE
624
+ /** G2b watcher (design/116 §7): 1s poll loop (its first beat at registration) that spools increments (rolling bound) and fires ONE
658
625
  * completion notification at the terminal state. `unref()`d — a watcher never keeps the process alive.
659
626
  * Stops itself on terminal, on a vanished shell (env disposed), or when the handle is evicted. */
660
627
  private startBashWatcher;
@@ -671,7 +638,7 @@ export declare class TaskRegistry {
671
638
  * one terminal notification (exit code / timeout / auto-stop / env-side kill). */
672
639
  registerMonitor(input: RegisterMonitorInput): string;
673
640
  registerWorkflow(input: RegisterWorkflowInput): string;
674
- /** The legs one TaskOutput (`"output"`) or TaskStop (`"stop"`) call travels, read off the handle the call dispatches to by the same
641
+ /** The legs one read of a task's output (`"output"`: a stored artifact read back by ref) or TaskStop (`"stop"`) call travels, read off the handle the call dispatches to by the same
675
642
  * resolution the poll and the stop take: a background shell's or a monitor's process lives in its own environment (the `env` leg
676
643
  * reaches that one); an agent handle that recorded the calling tree's own token moves nothing across the boundary; any other handle — an
677
644
  * agent of another tree, a workflow run, an id no live handle answers (a durable row read back) — is content from beyond the
@@ -699,6 +666,10 @@ export declare class TaskRegistry {
699
666
  * cap ({@link list}'s): the one reading of a leg's live background tasks (its end's {@link owedDeliveries}, the post-compaction
700
667
  * listing and the resume's orphan diff, the suspend's snapshot), each consumer projecting its own columns from it. */
701
668
  liveTasks(access: TaskAccess): TaskListRow[];
669
+ /** The child session task `taskId`'s row is anchored to — its id and the store the child's run holds it through — when
670
+ * `access` reaches the row (the reach {@link list} reads with): `undefined` for an unknown or out-of-reach id, `null` for a
671
+ * reached row with no anchor (no background agent's row, not bound yet, or released). */
672
+ anchoredSession(taskId: string, access: TaskAccess): ChildSessionAnchor | null | undefined;
702
673
  /** Every row `access` reaches, newest first, in {@link list}'s projection — the one walk both readings take. */
703
674
  private rowsUnder;
704
675
  /** Throttled {@link gc} for hot-path callers (design/115 review B5): prepare-task runs once per task,
@@ -715,5 +686,4 @@ export declare class TaskRegistry {
715
686
  private stopWorkflow;
716
687
  }
717
688
  export declare const defaultTaskRegistry: TaskRegistry;
718
- export declare function createTaskOutputTool(opts: TaskToolOptions): AgentTool;
719
689
  export declare function createTaskStopTool(opts: TaskToolOptions): AgentTool;
@@ -11,8 +11,8 @@ import { registerMonitorLane, pollMonitorLane, stopMonitorLane } from "./task-re
11
11
  import { registerWorkflowLane, pollWorkflowLane, stopWorkflowLane } from "./task-registry-workflow.js";
12
12
  import { mintCompletionId, taskReadHandleText, canAccessWorkflowRun, formatWorkflowRun, clipTaskOutput, assertOwnership, sleepPollStep, statusFromBackground, rollSpoolText, accountDroppedBytes, renderSpoolBody, stdoutHeadingOf, REPLAY_FACE, SPOOL_REPLAY, INCREMENT_REPLAY, spoolDropNote, droppedGapNote, alreadyTerminalStopNote, terminalTaskSummary, TASK_OUTPUT_MAX_CHARS, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE, canAccess, DURABLE_AGENT_HANDLE_RE, } from "./task-registry-shared.js";
13
13
  export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, engineAgentName, chosenAgentName } from "./task-registry-shared.js";
14
- import { TASK_OUTPUT_TOOL_NAME, TASK_STOP_TOOL_NAME, TASK_OUTPUT_MISSING_ID_MESSAGE, TASK_STOP_MISSING_ID_MESSAGE, TASK_STOP_PARAMS, resolveTaskIdArg, REGISTRY_TASK_TOOL_CAPS, composeTaskOutputDescription, composeTaskOutputParams, composeTaskStopDescription, } from "./task-tool-shape.js";
15
- import { durableAgentArmedLane, durableAgentRowProbeLane, beginDurableClaimLane, endDurableClaimLane, reapDurableAgentsLane, noteBackgroundAgentActivityLane, reapStaleSessionBackgroundAgentsLane, releaseDurableTranscriptAnchorLane, bindBackgroundAgentSessionLane, childSessionAnchorOf, registerBackgroundAgentLane, recordBackgroundAgentOrgAdmissionLane, parkBackgroundAgentLane, reconcileParkedAgentsLane, claimParkedAgentLane, rollbackParkedClaimLane, consumeParkedFlipLane, finalizeParkedResumeLane, settleBackgroundAgentLane, abortBackgroundAgentsForOwnerLane, serveDurableAgentRowLane, resolveBackgroundAgentByNameLane, backgroundAgentCycleSeqLane, activeDelegationHandlesLane, markRetainedContinuationLane, reviveBackgroundAgentLane, settleRevivedAgentLane, unmarkRetainedContinuationLane, attachAgentNotifyLane, deliverToRunningAgentLane, runningBackgroundAgentLabelsLane, runningAgentFooterLane, notFoundRunningAgentsTail, pollBackgroundAgentLane, stopBackgroundAgentLane, } from "./task-registry-agent.js";
14
+ import { TASK_STOP_TOOL_NAME, TASK_STOP_MISSING_ID_MESSAGE, TASK_STOP_PARAMS, TASK_STOP_DESCRIPTION, resolveTaskIdArg } from "./task-tool-shape.js";
15
+ import { durableAgentArmedLane, durableAgentRowProbeLane, beginDurableClaimLane, endDurableClaimLane, reapDurableAgentsLane, noteBackgroundAgentActivityLane, reapStaleSessionBackgroundAgentsLane, releaseDurableTranscriptAnchorLane, bindBackgroundAgentSessionLane, childSessionAnchorOf, registerBackgroundAgentLane, recordBackgroundAgentOrgAdmissionLane, parkBackgroundAgentLane, reconcileParkedAgentsLane, claimParkedAgentLane, rollbackParkedClaimLane, consumeParkedFlipLane, finalizeParkedResumeLane, settleBackgroundAgentLane, abortBackgroundAgentsForOwnerLane, serveDurableAgentRowLane, resolveBackgroundAgentByNameLane, backgroundAgentCycleSeqLane, activeDelegationHandlesLane, activeDelegationOccupantsLane, markRetainedContinuationLane, reviveBackgroundAgentLane, settleRevivedAgentLane, unmarkRetainedContinuationLane, attachAgentNotifyLane, deliverToRunningAgentLane, runningBackgroundAgentLabelsLane, runningAgentFooterLane, notFoundRunningAgentsTail, pollBackgroundAgentLane, stopBackgroundAgentLane, } from "./task-registry-agent.js";
16
16
  import { mountRuleFace, toolFace } from "./tool-catalog-entries.js";
17
17
  import { thrownText } from "./thrown-value.js";
18
18
  import { agentStateSourceOfHandle, agentStateSourceOfRecord, agentStateSummary, readAgentState } from "./agent-state.js";
@@ -26,7 +26,6 @@ function blockDeadline(timeoutMs, now) {
26
26
  const t = Math.min(BLOCK_MAX_TIMEOUT_MS, Math.max(1, Math.floor(timeoutMs ?? BLOCK_DEFAULT_TIMEOUT_MS)));
27
27
  return now + t;
28
28
  }
29
- const BLOCK_WAIT_WRITEOUT_RESERVE_MS = 5_000;
30
29
  const TASK_PREFIX = {
31
30
  background_bash: "b",
32
31
  workflow: "w",
@@ -93,11 +92,11 @@ function commandRecordSink(rowOf, record, guarded, sink) {
93
92
  const retained = row.spool !== undefined && row.spool.stdout.length + row.spool.stderr.length > 0 ? row.spool : undefined;
94
93
  if (row.taskArtifacts === undefined || retained === undefined)
95
94
  return sink(gap === "incomplete" ? { ...n, summary: n.summary + commandRecordGapNote(row, gap, undefined) } : n);
96
- const body = renderSpoolBody(retained, { running: false, handleStatus: row.status, shape: (text) => text, rolledExtraClause: "", drainNote: "" });
95
+ const body = renderSpoolBody(retained, { running: false, handleStatus: row.status, shape: (text) => text, drainNote: "" });
97
96
  void persistTaskArtifact(row.taskArtifacts, row.id, body).then((artifact) => {
98
97
  const ref = artifact.kind === "stored" ? artifact.ref : undefined;
99
98
  if (ref !== undefined)
100
- record(row.id, ref);
99
+ record(row.id, ref, n.completionId);
101
100
  guarded(() => sink(ref === undefined && gap === "missing" ? n : { ...n, summary: n.summary + commandRecordGapNote(row, gap, ref) }));
102
101
  });
103
102
  };
@@ -169,8 +168,8 @@ export class TaskRegistry {
169
168
  releaseDurableTranscriptAnchor(id, sessionId) {
170
169
  return releaseDurableTranscriptAnchorLane(this.core, id, sessionId);
171
170
  }
172
- bindBackgroundAgentSession(id, sessionId) {
173
- return bindBackgroundAgentSessionLane(this.core, id, sessionId);
171
+ bindBackgroundAgentSession(id, sessionId, store) {
172
+ return bindBackgroundAgentSessionLane(this.core, id, sessionId, store);
174
173
  }
175
174
  registerBackgroundAgent(input) {
176
175
  return registerBackgroundAgentLane(this.core, input);
@@ -232,6 +231,9 @@ export class TaskRegistry {
232
231
  activeDelegationHandles(scope, rootSessionId) {
233
232
  return activeDelegationHandlesLane(this.core, scope, rootSessionId);
234
233
  }
234
+ activeDelegationOccupants(scope, rootSessionId, caller) {
235
+ return activeDelegationOccupantsLane(this.core, scope, rootSessionId, caller);
236
+ }
235
237
  reviveBackgroundAgent(id, access, abort) {
236
238
  return reviveBackgroundAgentLane(this.core, id, access, abort);
237
239
  }
@@ -267,8 +269,8 @@ export class TaskRegistry {
267
269
  runningBackgroundAgentLabels(access) {
268
270
  return runningBackgroundAgentLabelsLane(this.core, access);
269
271
  }
270
- async pollBackgroundAgent(handle, deadline, signal, toolResultStore, sessionId, checkpointSeat) {
271
- return pollBackgroundAgentLane(handle, deadline, signal, toolResultStore, sessionId, checkpointSeat);
272
+ async pollBackgroundAgent(handle, deadline, signal, checkpointSeat) {
273
+ return pollBackgroundAgentLane(handle, deadline, signal, checkpointSeat);
272
274
  }
273
275
  async stopBackgroundAgent(handle) {
274
276
  return stopBackgroundAgentLane(this.core, handle);
@@ -318,7 +320,7 @@ export class TaskRegistry {
318
320
  return id;
319
321
  }
320
322
  commandRecordSink(sink) {
321
- return commandRecordSink((id) => this.handles.get(id), (id, ref) => this.recordArtifactRef(id, ref, 0), (send) => this.notifier.notify(send, "taskRegistry.commandRecordSink"), sink);
323
+ return commandRecordSink((id) => this.handles.get(id), (id, ref, completionId) => this.recordArtifactRef(id, ref, completionId), (send) => this.notifier.notify(send, "taskRegistry.commandRecordSink"), sink);
322
324
  }
323
325
  isBackgroundOutputFile(canonicalPath, access, env) {
324
326
  for (const handle of this.handles.values()) {
@@ -380,39 +382,6 @@ export class TaskRegistry {
380
382
  }
381
383
  return marked;
382
384
  }
383
- markStopSourceByShellId(shellId, source, env) {
384
- if (env === undefined)
385
- return;
386
- const sid = String(shellId);
387
- for (const [id, handle] of this.handles) {
388
- if (handle.type === "background_bash" && String(handle.shellId) === sid && handle.env === env) {
389
- this.markStopSource(id, source);
390
- return;
391
- }
392
- }
393
- }
394
- clearPendingStopSourceByShellId(shellId, source, env) {
395
- const sid = String(shellId);
396
- const clear = (id) => {
397
- const handle = this.handles.get(id);
398
- if (!handle || handle.type !== "background_bash")
399
- return false;
400
- if (env !== undefined && handle.env !== env)
401
- return false;
402
- if (handle.status === "running" && handle.stopSource === source && handle.stoppedBy === undefined) {
403
- handle.stopSource = undefined;
404
- }
405
- return true;
406
- };
407
- if (env === undefined)
408
- return;
409
- for (const [id, handle] of this.handles) {
410
- if (handle.type === "background_bash" && String(handle.shellId) === sid && handle.env === env) {
411
- clear(id);
412
- return;
413
- }
414
- }
415
- }
416
385
  getStopAttribution(id) {
417
386
  const handle = this.handles.get(id);
418
387
  if (!handle || (handle.type !== "background_agent" && handle.type !== "background_bash" && handle.type !== "monitor"))
@@ -424,11 +393,9 @@ export class TaskRegistry {
424
393
  getCompletionId(id) {
425
394
  return this.handles.get(id)?.completionId;
426
395
  }
427
- recordArtifactRef(id, ref, cycle) {
396
+ recordArtifactRef(id, ref, completionId) {
428
397
  const h = this.handles.get(id);
429
- if (h === undefined)
430
- return;
431
- if ((h.type === "background_agent" ? (h.reviveCycle ?? 0) : 0) !== cycle)
398
+ if (h === undefined || completionId === undefined || h.completionId !== completionId)
432
399
  return;
433
400
  h.artifactRef = ref;
434
401
  }
@@ -822,6 +789,8 @@ export class TaskRegistry {
822
789
  if (!ap.ok)
823
790
  spool.mirrorFailed = true;
824
791
  }
792
+ if (this.handles.get(id) !== handle || handle.status !== "running")
793
+ return stop();
825
794
  handle.status = statusFromBackground(r.value.status, r.value.exitCode);
826
795
  if (handle.status === "killed" && handle.stoppedBy === undefined) {
827
796
  handle.stoppedBy = handle.stopSource ?? (r.value.timedOut === true ? "timeout" : "system");
@@ -888,6 +857,7 @@ export class TaskRegistry {
888
857
  };
889
858
  handle.watcher = setInterval(() => void tick(), 1_000);
890
859
  handle.watcher.unref?.();
860
+ void tick();
891
861
  }
892
862
  runningShellIds(env) {
893
863
  const out = [];
@@ -923,7 +893,7 @@ export class TaskRegistry {
923
893
  if (handle.type === "background_bash")
924
894
  return this.pollBackgroundBash(handle, taskId, access, opts.filter, deadline, opts.signal);
925
895
  if (handle.type === "background_agent")
926
- return this.pollBackgroundAgent(handle, deadline, opts.signal, opts.toolResultStore, access.sessionId, opts.checkpointSeat);
896
+ return this.pollBackgroundAgent(handle, deadline, opts.signal, opts.checkpointSeat);
927
897
  if (handle.type === "monitor")
928
898
  return this.pollMonitor(handle, opts.filter, deadline, opts.signal);
929
899
  return this.pollWorkflow(handle, access, deadline, opts.signal);
@@ -964,7 +934,7 @@ export class TaskRegistry {
964
934
  state: ${agentStateSummary(agentState)}
965
935
  The durable record is still marked running (last update ${new Date(row.updatedAt).toISOString()}), but this engine instance is not executing it — the outcome is unknown here. If its host process is gone, a retention sweep (staleRunningMaxAgeMs) settles the record as interrupted.`;
966
936
  return {
967
- content: delimitUntrusted(`TaskOutput ${row.handle}`, body),
937
+ content: delimitUntrusted(`task ${row.handle}`, body),
968
938
  isError: true,
969
939
  details: {
970
940
  task_id: row.handle,
@@ -1066,6 +1036,10 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1066
1036
  liveTasks(access) {
1067
1037
  return this.rowsUnder(access).filter((t) => t.status === "pending" || t.status === "running" || t.status === "parked");
1068
1038
  }
1039
+ anchoredSession(taskId, access) {
1040
+ const h = this.handles.get(taskId);
1041
+ return h !== undefined && canAccess(h, access) ? (childSessionAnchorOf(h) ?? null) : undefined;
1042
+ }
1069
1043
  rowsUnder(access) {
1070
1044
  const out = [];
1071
1045
  for (const h of this.handles.values()) {
@@ -1080,7 +1054,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1080
1054
  ...((h.type === "background_bash" || h.type === "monitor") && shellRowRetained(h) ? { retained: true } : {}),
1081
1055
  ...(h.description !== undefined ? { description: h.description } : {}),
1082
1056
  ...(h.toolUseId !== undefined ? { toolUseId: h.toolUseId } : {}),
1083
- ...(childSession !== undefined ? { sessionId: childSession } : {}),
1057
+ ...(childSession !== undefined ? { sessionId: childSession.sessionId } : {}),
1084
1058
  createdAt: h.createdAt,
1085
1059
  updatedAt: h.updatedAt,
1086
1060
  });
@@ -1164,7 +1138,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1164
1138
  }
1165
1139
  catch {
1166
1140
  return {
1167
- content: `Error (TaskOutput): invalid filter regex: ${filter}`,
1141
+ content: `Error (task poll): invalid filter regex: ${filter}`,
1168
1142
  details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status: "not_ready" },
1169
1143
  isError: true,
1170
1144
  };
@@ -1180,9 +1154,9 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1180
1154
  const shape = (text) => clipTaskOutput(rx ? text.split(/\r?\n/).filter((l) => rx.test(l)).join("\n") : text, handle.outputFile);
1181
1155
  const running = handle.status === "running";
1182
1156
  const retrieval = running && deadline !== undefined && Date.now() >= deadline ? "timeout" : "success";
1183
- const body = renderSpoolBody(spool, { running, handleStatus: handle.status, shape, rolledExtraClause: "", drainNote: "" });
1157
+ const body = renderSpoolBody(spool, { running, handleStatus: handle.status, shape, drainNote: "" });
1184
1158
  return {
1185
- content: delimitUntrusted(`TaskOutput ${handle.id}`, body),
1159
+ content: delimitUntrusted(`task ${handle.id}`, body),
1186
1160
  details: {
1187
1161
  task_id: handle.id,
1188
1162
  type: "background_bash",
@@ -1223,7 +1197,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1223
1197
  ? `\n--- output accumulated before the error ---\n${clipTaskOutput(stdout, handle.outputFile)}${stderr ? `\n--- stderr ---\n${clipTaskOutput(stderr, handle.outputFile)}` : ""}`
1224
1198
  : "";
1225
1199
  return {
1226
- content: `Error (TaskOutput): ${r.error.message}${salvaged}`,
1200
+ content: `Error (task poll): ${r.error.message}${salvaged}`,
1227
1201
  details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status, ...(carriedOutput ? { details: { replay: INCREMENT_REPLAY } } : {}), error: r.error.code },
1228
1202
  isError: true,
1229
1203
  };
@@ -1248,7 +1222,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1248
1222
  const body = `status: ${displayStatus}\n${droppedNote}--- ${stdoutHeadingOf(INCREMENT_REPLAY, droppedNote !== "")} ---\n${shape(stdout) || "(none)"}\n` +
1249
1223
  `--- ${REPLAY_FACE[INCREMENT_REPLAY].stderr} ---\n${shape(stderr) || "(none)"}`;
1250
1224
  return {
1251
- content: delimitUntrusted(`TaskOutput ${handle.id}`, body),
1225
+ content: delimitUntrusted(`task ${handle.id}`, body),
1252
1226
  details: {
1253
1227
  task_id: handle.id,
1254
1228
  type: "background_bash",
@@ -1354,66 +1328,12 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1354
1328
  }
1355
1329
  }
1356
1330
  export const defaultTaskRegistry = new TaskRegistry();
1357
- export function createTaskOutputTool(opts) {
1358
- const caps = { ...REGISTRY_TASK_TOOL_CAPS, notification: opts.notificationWired !== false };
1359
- return defineTool({
1360
- name: TASK_OUTPUT_TOOL_NAME,
1361
- ...toolFace("task-output"),
1362
- ruleFace: mountRuleFace("task-output"),
1363
- description: composeTaskOutputDescription(caps),
1364
- parameters: composeTaskOutputParams(caps),
1365
- boundaryLegsFor: (rawArgs, at) => {
1366
- const id = resolveTaskIdArg(rawArgs?.task_id);
1367
- return id ? opts.registry.boundaryLegsOf(id, { owner: opts.owner, scope: opts.scope, ...(opts.sessionId !== undefined ? { sessionId: opts.sessionId } : {}) }, "output", at.tree) : { legs: [] };
1368
- },
1369
- execute: async (rawArgs, ctx) => {
1370
- const args = rawArgs;
1371
- const id = resolveTaskIdArg(args.task_id);
1372
- if (!id)
1373
- return errorResult(TASK_OUTPUT_MISSING_ID_MESSAGE);
1374
- const requestedMs = typeof args.timeout === "number" ? args.timeout : undefined;
1375
- let effectiveTimeoutMs = requestedMs;
1376
- let waitClampNote = "";
1377
- const wall = opts.deadlineMs?.();
1378
- const requestedWaitMs = Math.max(1, Math.floor(requestedMs ?? BLOCK_DEFAULT_TIMEOUT_MS));
1379
- if (args.block !== false && wall !== undefined) {
1380
- const remainMs = wall - Date.now() - BLOCK_WAIT_WRITEOUT_RESERVE_MS;
1381
- const wantMs = Math.min(BLOCK_MAX_TIMEOUT_MS, requestedWaitMs);
1382
- if (remainMs <= 0) {
1383
- effectiveTimeoutMs = 1;
1384
- waitClampNote =
1385
- "\n\nNOTE: wait skipped — the task's wall-clock deadline has been reached. Do NOT wait on this background task again; write out your results now (an unfinished answer beats a hard timeout).";
1386
- }
1387
- else if (remainMs < wantMs) {
1388
- effectiveTimeoutMs = remainMs;
1389
- waitClampNote = `\n\nNOTE: wait clamped to ${Math.round(remainMs / 1000)}s (requested ${Math.round(requestedWaitMs / 1000)}s) — the task's wall-clock deadline is near. If the task is still running after this wait, do NOT re-wait: proceed with other work or write out your results now.`;
1390
- }
1391
- }
1392
- const r = await opts.registry.pollTask(id, { owner: ctx.taskId ?? opts.owner, scope: ctx.principal ?? opts.scope, ...((ctx.sessionId ?? opts.sessionId) !== undefined ? { sessionId: ctx.sessionId ?? opts.sessionId } : {}) }, {
1393
- workflowStore: opts.workflowStore,
1394
- agentStore: opts.agentStore,
1395
- filter: typeof args.filter === "string" ? args.filter : undefined,
1396
- block: args.block !== false,
1397
- timeoutMs: effectiveTimeoutMs,
1398
- signal: ctx.signal,
1399
- toolResultStore: opts.toolResultStore,
1400
- checkpointSeat: opts.checkpointSeat,
1401
- });
1402
- const { type: taskType, ...rest } = r.details;
1403
- return {
1404
- content: r.content + waitClampNote,
1405
- details: { type: "task-output", ...(taskType !== undefined ? { taskType } : {}), ...(waitClampNote !== "" ? { waitClamped: true } : {}), ...rest },
1406
- ...(r.isError ? { isError: true } : {}),
1407
- };
1408
- },
1409
- });
1410
- }
1411
1331
  export function createTaskStopTool(opts) {
1412
1332
  return defineTool({
1413
1333
  name: TASK_STOP_TOOL_NAME,
1414
1334
  ...toolFace("task-stop"),
1415
1335
  ruleFace: mountRuleFace("task-stop"),
1416
- description: composeTaskStopDescription(REGISTRY_TASK_TOOL_CAPS),
1336
+ description: TASK_STOP_DESCRIPTION,
1417
1337
  parameters: TASK_STOP_PARAMS,
1418
1338
  boundaryLegsFor: (rawArgs, at) => {
1419
1339
  const a = rawArgs;