@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -4,6 +4,18 @@ import { delimitUntrusted } from "./untrusted-text.js";
4
4
  import { boundedRedactedSummary } from "./untrusted-egress.js";
5
5
  import { clipWithFilePointer, OUTPUT_BUDGET_MIN_CHARS } from "./tool-errors.js";
6
6
  import { resolveEnvBudget } from "./env-budget.js";
7
+ export function taskReadHandleText(h) {
8
+ const file = namedHandle(h.outputFile);
9
+ if (file !== undefined)
10
+ return `output: Read ${file}`;
11
+ const ref = namedHandle(h.artifactRef);
12
+ if (ref !== undefined)
13
+ return `result: ReadToolResult (ref "${ref}")`;
14
+ return undefined;
15
+ }
16
+ function namedHandle(value) {
17
+ return value !== undefined && value.trim() !== "" ? value : undefined;
18
+ }
7
19
  export function mintCompletionId(target) {
8
20
  if (target.completionId === undefined)
9
21
  target.completionId = uuidv7();
@@ -77,16 +89,13 @@ export function statusFromBackground(status, exitCode) {
77
89
  return exitCode === 0 ? "completed" : "failed";
78
90
  return "failed";
79
91
  }
80
- export function rollSpoolText(spool, s, cap, onDrop) {
92
+ export function rollSpoolText(spool, s, cap) {
81
93
  if (s.length <= cap)
82
94
  return s;
83
95
  const half = Math.floor(cap / 2);
84
- const dropped = s.slice(half, s.length - half);
85
- spool.rolledChars += dropped.length;
86
- onDrop?.(dropped);
96
+ spool.rolledChars += s.length - 2 * half;
87
97
  return s.slice(0, half) + s.slice(s.length - half);
88
98
  }
89
- export const MONITOR_SPILL_CAP_CHARS = 64 * 1024 * 1024;
90
99
  export function accountDroppedBytes(spool, poll) {
91
100
  const d = poll.bytesDroppedBeforeCursor ?? 0;
92
101
  if (d > 0)
@@ -115,7 +124,7 @@ export function stdoutHeadingOf(replay, gapDisclosed) {
115
124
  export function renderSpoolBody(spool, opts) {
116
125
  const timedOutClause = spool.timedOut === true ? ` (timed out after ${spool.timeoutSec !== undefined ? `${spool.timeoutSec}s` : "its background time budget"})` : "";
117
126
  const displayStatus = (spool.exitCode !== undefined ? `exited(code ${spool.exitCode})` : opts.running ? "running" : opts.handleStatus) + timedOutClause;
118
- 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` : "";
119
128
  const droppedNote = spoolDropNote(spool);
120
129
  const stdoutHeading = stdoutHeadingOf(SPOOL_REPLAY, droppedNote !== "" || opts.drainNote !== "");
121
130
  return (`status: ${displayStatus}\n${rolledNote}${droppedNote}${opts.drainNote}--- ${stdoutHeading} ---\n${opts.shape(spool.stdout) || "(none)"}\n` +
@@ -137,7 +146,7 @@ export function firstDropNote(spool) {
137
146
  return note;
138
147
  }
139
148
  export function alreadyTerminalStopNote(id, status) {
140
- return `${id} already ${status} — nothing to stop; poll TaskOutput for its final state.`;
149
+ return `${id} already ${status} — nothing to stop; its completion notification carries its final state.`;
141
150
  }
142
151
  export function assertOwnership(input, site) {
143
152
  if (input.owner === undefined || input.scope === undefined) {
@@ -155,6 +164,8 @@ export function canAccessWorkflowRun(run, access) {
155
164
  }
156
165
  const WORKFLOW_PARTIAL_RESULTS_MAX = 5;
157
166
  const WORKFLOW_AGENT_ROWS_MAX = 60;
167
+ const WORKFLOW_POLL_BOUNDS = Object.freeze({ rows: WORKFLOW_AGENT_ROWS_MAX, partialResults: WORKFLOW_PARTIAL_RESULTS_MAX });
168
+ export const WORKFLOW_RECORD_WHOLE = Object.freeze({ rows: Number.POSITIVE_INFINITY, partialResults: Number.POSITIVE_INFINITY });
158
169
  function workflowAgentRow(a, ordinal) {
159
170
  return {
160
171
  ordinal,
@@ -195,16 +206,16 @@ function timeoutInterruptionNote(interruption) {
195
206
  ` Raising the timeout only helps if that approval gets answered.`
196
207
  : ""));
197
208
  }
198
- export function formatWorkflowRun(run) {
209
+ export function formatWorkflowRun(run, bounds = WORKFLOW_POLL_BOUNDS) {
199
210
  const summary = summarizeWorkflowRun(run);
200
211
  const done = run.agents.filter((a) => a.status === "completed" || a.status === "failed").length;
201
212
  const failed = run.agents.filter((a) => a.status === "failed").length;
202
213
  const allRows = run.agents.map((a, i) => ({ a, i }));
203
- const overCap = allRows.length > WORKFLOW_AGENT_ROWS_MAX;
214
+ const overCap = allRows.length > bounds.rows;
204
215
  const keptRows = overCap
205
216
  ? (() => {
206
217
  const urgent = allRows.filter((r) => r.a.status !== "completed");
207
- const budget = Math.max(0, WORKFLOW_AGENT_ROWS_MAX - urgent.length);
218
+ const budget = Math.max(0, bounds.rows - urgent.length);
208
219
  const fill = allRows.filter((r) => r.a.status === "completed").slice(0, budget);
209
220
  return [...urgent, ...fill].sort((x, y) => x.i - y.i);
210
221
  })()
@@ -245,12 +256,12 @@ export function formatWorkflowRun(run) {
245
256
  : {}),
246
257
  ...(finishedAgents.length > 0
247
258
  ? {
248
- partial_results: finishedAgents.slice(0, WORKFLOW_PARTIAL_RESULTS_MAX).map((a) => ({
259
+ partial_results: finishedAgents.slice(0, bounds.partialResults).map((a) => ({
249
260
  agent: a.label,
250
261
  output: delimitUntrusted(`workflow agent ${a.label} output`, a.output),
251
262
  })),
252
- ...(finishedAgents.length > WORKFLOW_PARTIAL_RESULTS_MAX
253
- ? { partial_results_note: `showing ${WORKFLOW_PARTIAL_RESULTS_MAX} of ${finishedAgents.length} completed agent outputs; the full set remains retrievable from the workflow run record (getWorkflowRun / the workflow journal).` }
263
+ ...(finishedAgents.length > bounds.partialResults
264
+ ? { partial_results_note: `showing ${bounds.partialResults} of ${finishedAgents.length} completed agent outputs; the full set remains retrievable from the workflow run record (getWorkflowRun / the workflow journal).` }
254
265
  : {}),
255
266
  }
256
267
  : {}),
@@ -299,41 +310,6 @@ export function normalizeAgentName(s) {
299
310
  .toLowerCase()
300
311
  .replace(/\s+/g, "-");
301
312
  }
302
- export function editDistance(a, b) {
303
- if (a === b)
304
- return 0;
305
- const m = a.length;
306
- const n = b.length;
307
- const d = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
308
- for (let i = 1; i <= m; i++) {
309
- for (let j = 1; j <= n; j++) {
310
- const cost = a[i - 1] === b[j - 1] ? 0 : 1;
311
- d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
312
- if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
313
- d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
314
- }
315
- }
316
- }
317
- return d[m][n];
318
- }
319
- export function closestName(query, candidates) {
320
- let best;
321
- let bestDist = 3;
322
- const seen = new Set();
323
- for (const c of candidates) {
324
- if (seen.has(c))
325
- continue;
326
- seen.add(c);
327
- if (Math.abs(c.length - query.length) > 2)
328
- continue;
329
- const dist = editDistance(query, c);
330
- if (dist <= 2 && dist < bestDist) {
331
- bestDist = dist;
332
- best = c;
333
- }
334
- }
335
- return best;
336
- }
337
313
  export function canAccess(handle, access) {
338
314
  if (handle.scope === undefined || access.scope === undefined || access.scope !== handle.scope)
339
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) => {
@@ -39,26 +39,13 @@ export function registerWorkflowLane(core, input) {
39
39
  if (handle.status !== "cancelled")
40
40
  handle.status = "failed";
41
41
  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;
42
+ const settledRun = settledRunOf(input.handle.done);
43
+ if (settledRun?.completionId !== undefined)
44
+ handle.completionId = settledRun.completionId;
47
45
  handle.updatedAt = Date.now();
48
46
  });
49
47
  return id;
50
48
  }
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
49
  export async function pollWorkflowLane(handle, access, deadline, signal) {
63
50
  const store = handle.store;
64
51
  if (store) {
@@ -70,8 +57,6 @@ export async function pollWorkflowLane(handle, access, deadline, signal) {
70
57
  const out = formatWorkflowRun(run);
71
58
  if (run.status === "running" && deadline !== undefined && Date.now() >= deadline)
72
59
  out.details.retrieval_status = "timeout";
73
- else if (run.status !== "running")
74
- fireServedTerminalLane(handle);
75
60
  return out;
76
61
  }
77
62
  await sleepPollStep(deadline, signal);
@@ -80,8 +65,6 @@ export async function pollWorkflowLane(handle, access, deadline, signal) {
80
65
  while (handle.status === "running" && deadline !== undefined && Date.now() < deadline && !signal?.aborted) {
81
66
  await sleepPollStep(deadline, signal);
82
67
  }
83
- if (handle.status !== "running")
84
- fireServedTerminalLane(handle);
85
68
  return {
86
69
  content: JSON.stringify({
87
70
  task_id: handle.id,
@@ -122,7 +105,7 @@ export async function stopWorkflowLane(handle) {
122
105
  type: "workflow",
123
106
  status: handle.status,
124
107
  stopped: false,
125
- note: `workflow already ${handle.status} — nothing to stop; poll TaskOutput for its final state.`,
108
+ note: `workflow already ${handle.status} — nothing to stop; its completion notification carries its final state.`,
126
109
  }),
127
110
  details: { task_id: handle.id, type: "workflow", status: handle.status, retrieval_status: "success" },
128
111
  };
@@ -5,7 +5,7 @@ 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 { 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";
@@ -31,11 +31,11 @@ export interface RegisterBackgroundBashInput extends TaskAccess {
31
31
  sessionScoped?: true;
32
32
  /** design/116 §7 G2b: when set, the registry WATCHES the process (1s poll, increments spooled with a
33
33
  * 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. */
34
+ * half of CC's LocalShellTask completion notify. Also flips the host poll to re-readable spool reads. */
35
35
  onTerminal?: (notification: TaskNotificationPayload) => void;
36
36
  /** The task's OUTPUT FILE — the launch receipt advertises it and the watcher
37
37
  * 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
38
+ * spool), so "Read the output file path" is the model's read of the command's output. Terminal
39
39
  * task-notifications carry the same path (`output_file`). Primarily meaningful with `onTerminal`
40
40
  * (only the watcher mirrors increments live); a watcher-less row still gets ONE final best-effort
41
41
  * append at TaskStop/run-teardown (the tail drain), so the file is written even without a watcher —
@@ -48,6 +48,8 @@ export interface RegisterBackgroundBashInput extends TaskAccess {
48
48
  * STATES the lane: a later run teardown does not re-judge the row. Absent = the launcher does not know the
49
49
  * lane; the owning run's teardown supplies it. */
50
50
  retainBackgroundProcesses?: boolean;
51
+ /** See {@link BackgroundBashTaskHandle.taskArtifacts}. */
52
+ taskArtifacts?: TaskArtifactSeat;
51
53
  }
52
54
  /** One row's receipt from {@link TaskRegistry.killAllBackgroundShellsNow} (closed `outcome` set; `retained`
53
55
  * present when the row was retained, whatever the outcome). */
@@ -64,23 +66,13 @@ export interface TaskPollOptions {
64
66
  * (terminal snapshot / honest cross-instance "running elsewhere"), behind {@link canAccessAgentRecord}. */
65
67
  agentStore?: BackgroundAgentStore;
66
68
  filter?: string;
67
- /** design/116 W3 (CC TaskOutput `block`): wait until the task reaches a terminal state (or `timeoutMs`)
68
- * instead of returning the instantaneous snapshot — saves the model blind re-poll turns. The TOOL layer
69
- * defaults this to TRUE (裁定 2026-07-02); registry callers pass it explicitly. */
69
+ /** design/116 W3: wait until the task reaches a terminal state (or `timeoutMs`) instead of returning the
70
+ * instantaneous snapshot. Absent ⇒ the snapshot. */
70
71
  block?: boolean;
71
72
  /** Max wait for `block` (ms). Default 30s, capped at 600s. */
72
73
  timeoutMs?: number;
73
- /** Abort signal — a blocked wait must stop when the tool call is cancelled. */
74
+ /** Abort signal — a blocked wait stops when the caller cancels. */
74
75
  signal?: AbortSignal;
75
- /** Mirrors {@link import("./types.js").TaskSpec.oneShot} (see {@link TaskToolOptions.oneShot}
76
- * for the full contract): forwarded to the background_agent lane's still-running poll body so it
77
- * does not teach "you will be notified" when this run has no later turn to receive one. */
78
- oneShot?: boolean;
79
- /** design/158 S1 (RB-205-B 半): the offload store a CLIPPED background_agent result's full text
80
- * spills to — the disclosure gains a `ReadToolResult` ref instead of the middle staying gone for
81
- * good (see {@link import("./task-registry-agent.js").spillClippedAgentResult}). Absent (a
82
- * deployment that never wired a tool-result store) ⇒ legal degrade, byte-identical to pre-S1 output. */
83
- toolResultStore?: ToolResultStore;
84
76
  /** The run's checkpoint seat: a PARKED background_agent row's approval card is read from it for the
85
77
  * answer's `agentState` ({@link import("./agent-state.js").readAgentState}). Absent ⇒ the card reads
86
78
  * `unreadable`; nothing else changes. */
@@ -95,37 +87,35 @@ export interface TaskStopOptions {
95
87
  export interface TaskToolOptions extends TaskAccess {
96
88
  registry: TaskRegistry;
97
89
  workflowStore?: WorkflowRunStore;
98
- /** design/151 S1a: durable agent ledger — threads into pollTask/stopTask fallback reads. */
90
+ /** design/151 S1a: durable agent ledger — threads into the stopTask fallback read. */
99
91
  agentStore?: BackgroundAgentStore;
100
- /** the task's soft wall-clock deadline (absolute ms epoch), same source as the Bash
101
- * foreground clamp (design/130 P2b). When present, a BLOCKING TaskOutput wait is clamped so it
102
- * cannot eat the write-out window: the model gets an honest, visible clamp note instead of a
103
- * silent 10-minute blind wait into the finalize wall (TB rs**: 9.1min poll = the exact tax).
104
- * CC posture note: CC classifies WIND-DOWN waits, and its
105
- * block cap rides per-query budgets — a deadline-aware wait is the sema equivalent on the tool face. */
106
- deadlineMs?: () => number | undefined;
107
- /** design/157 B17 S2 (fable 终判 D4) — whether a terminal <task-notification> is actually wired for
108
- * this mount. Drives the composed description's notification sentence: the pre-S2 literal advertised
109
- * the notification unconditionally, which was a false promise on deployments that never wired
110
- * `taskNotification` (B17 方案查出的既有假广告). Default true (a direct public-API consumer keeps the
111
- * historical wording); prepare-task passes the real wiring state. */
112
- notificationWired?: boolean;
113
- /**
114
- * Mirrors {@link import("./types.js").TaskSpec.oneShot}: this run has no later turn for an
115
- * async background notification to land in (a headless `-p` process exits once the turn ends).
116
- * Threaded into the background_agent lane's non-blocking/blocked-timeout "still running" poll body
117
- * (see {@link import("./task-registry-agent.js").pollBackgroundAgentLane}), which otherwise taught
118
- * "you will be notified when it completes" — the same failure form `run_workflow`'s launch note was
119
- * fixed for (RB-215/run-workflow-tool.ts). Default undefined ⇒ byte-compat (pre-RB-220 wording).
120
- */
121
- oneShot?: boolean;
122
- /** design/158 S1 (RB-205-B 半): the offload store a CLIPPED background_agent result's full text
123
- * spills to — see {@link TaskPollOptions.toolResultStore} (forwarded verbatim into `pollTask`).
124
- * Absent ⇒ legal degrade, byte-identical to pre-S1 output. */
125
- toolResultStore?: ToolResultStore;
126
- /** The run's checkpoint seat — see {@link TaskPollOptions.checkpointSeat} (forwarded verbatim into
127
- * `pollTask`). The first-party mount passes the same seat the Agent tool parks children into. */
128
- checkpointSeat?: CheckpointSeat;
92
+ }
93
+ /** One row of {@link TaskRegistry.list} (and {@link TaskRegistry.liveTasks}): the DISPLAY projection of a task
94
+ * the caller reaches — never the internal handle. One name for the list, the live reading and the walk behind both. */
95
+ export interface TaskListRow {
96
+ task_id: string;
97
+ type: SemaTaskType;
98
+ status: SemaTaskStatus;
99
+ /** design/129 lifetime flag, surfaced for observability — on resume-leg deployments the
100
+ * canonical taskId==sessionId, so task- and session-scoped rows share an owner KEY VALUE and only this
101
+ * explicit flag tells them apart. Bulk attribution should use {@link TaskRegistry.markStopSourceForOwner}, not a
102
+ * list()-driven loop (the 500-row cap). */
103
+ sessionScoped: boolean;
104
+ /** Present on a shell-lane row (`background_bash` / `monitor`) that THE retain predicate keeps alive
105
+ * past the automatic reaps — the "keeps running" half of an exit listing: the controlled-exit reap and
106
+ * the hard face under `includeRetained: false` leave it running; every other running shell row stops. */
107
+ retained?: true;
108
+ description?: string;
109
+ toolUseId?: string;
110
+ /** The child session a `background_agent` row is anchored to — absent in the startup window before the
111
+ * bind (right after registration, once the child's session id is fixed), present from the bind until a
112
+ * successful release of that session (a terminal row keeps it until that release or the terminal GC),
113
+ * absent on every other task type. Present means "the registry has not released the anchor", not "the
114
+ * session store still holds the session" — the session store answers that. Only this process's
115
+ * handles are listed: a row known only to the durable store of another process is not here. */
116
+ sessionId?: string;
117
+ createdAt: number;
118
+ updatedAt: number;
129
119
  }
130
120
  /**
131
121
  * RB-49 B-3 (2026-07-25): the row-metadata projection `getAccessibleTask` returns. Was spelled out as a
@@ -225,7 +215,9 @@ export declare class TaskRegistry {
225
215
  skippedNoSessions: number;
226
216
  orphanPlacedReleased: number;
227
217
  }>;
228
- releaseDurableTranscriptAnchor(id: string): void;
218
+ /** The successful release of child session `sessionId` ends row `id`'s anchor on it — handle and durable
219
+ * record together, and only while the row still names that session (see {@link releaseDurableTranscriptAnchorLane}). */
220
+ releaseDurableTranscriptAnchor(id: string, sessionId: string): void;
229
221
  bindBackgroundAgentSession(id: string, sessionId: string): void;
230
222
  registerBackgroundAgent(input: RegisterBackgroundAgentInput): string;
231
223
  /** #22 — persist this leg's org-memory admission verdict on the durable row (the cross-process
@@ -359,7 +351,7 @@ export declare class TaskRegistry {
359
351
  disposition: "queued" | "parked" | "pending";
360
352
  } | {
361
353
  ok: false;
362
- reason: "not_found" | "not_running" | "no_channel" | "queue_full";
354
+ reason: "not_found" | "not_running" | "no_channel" | "queue_full" | "refused";
363
355
  }>;
364
356
  runningBackgroundAgentLabels(access: TaskAccess): string[];
365
357
  private pollBackgroundAgent;
@@ -400,9 +392,11 @@ export declare class TaskRegistry {
400
392
  private durableHeartbeatTimer;
401
393
  mintTaskId(type: SemaTaskType): string;
402
394
  registerBackgroundBash(input: RegisterBackgroundBashInput): string;
395
+ /** {@link commandRecordSink} over this registry's rows, ref book and guarded send. */
396
+ private commandRecordSink;
403
397
  /** Background output-file read exemption: true iff `canonicalPath` is EXACTLY the registered output
404
- * file of a background bash row that (a) the caller can access (same owner/scope/session visibility as
405
- * a TaskOutput poll — {@link canAccess}) and (b) was registered on the caller's OWN execution env —
398
+ * file of a background bash or monitor row that (a) the caller can access (same owner/scope/session visibility as
399
+ * a task poll — {@link canAccess}) and (b) was registered on the caller's OWN execution env —
406
400
  * `env` identity is part of the match, same discipline as {@link runningShellIds}. A canonical path only names a file within ONE env's filesystem
407
401
  * namespace: on a shared registry, a row minted on env A must never exempt a same-named outside-root
408
402
  * file in env B's namespace (same session or not), so instance equality — never a string proxy — is
@@ -441,25 +435,9 @@ export declare class TaskRegistry {
441
435
  * must not be marked, or the next reader would be told a live process had been killed.
442
436
  *
443
437
  * Attribution only: it never kills anything. The caller has already demonstrated kill capability on the
444
- * env, which is why there is no access guard (same reasoning as {@link markStopSourceByShellId}).
438
+ * env, which is why there is no access guard.
445
439
  */
446
440
  markStopSourceForEnvSweep(env: unknown, source: StopSource, except?: readonly string[]): string[];
447
- /** design/134 KNOWN-ISSUES close-out (env-direct TaskStop): the stop-source annotation face
448
- * addressed by the ENV-level shellId — for a kill initiator that holds only the env handle (the
449
- * registry-less TaskStop band) and is about to `env.killBackground` directly, i.e. without going
450
- * through {@link stopTask}. Resolves the shellId → unified task id and delegates to
451
- * {@link markStopSource}, so the running-only + first-marker-wins guards hold unchanged.
452
- * ⚠️ `env` is REQUIRED for any effect (RB-479-A②, 5.0.0): a shellId without its env is ambiguous
453
- * by construction on a shared registry, so an env-less call is a NO-OP — this marker is
454
- * best-effort attribution, not data. No access guard — attribution only (never kills); the
455
- * caller already demonstrated kill capability on the env. */
456
- markStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
457
- /** Withdraw a pending stop-source marker after the kill it announced FAILED (小优化批 2026-07-13):
458
- * a marker left by a failed env-direct kill would win first-marker-wins against the NEXT, real stopper
459
- * (e.g. a later user TaskStop reads "parent"). Clears ONLY the exact still-pending marker the caller
460
- * minted — same (shellId, env) resolution as {@link markStopSourceByShellId}; a row already settled,
461
- * or carrying a different source, is left alone. */
462
- clearPendingStopSourceByShellId(shellId: string, source: StopSource, env?: unknown): void;
463
441
  /** design/134 §3.3: narrow terminal read for consumers (subagent sinkEmit/notify) — only a KILLED row
464
442
  * has an attribution; "system" is the defensive floor for a row that went killed without a landed
465
443
  * stoppedBy (e.g. env-direct flips). Returns undefined for running/completed/failed/evicted rows. */
@@ -471,6 +449,20 @@ export declare class TaskRegistry {
471
449
  * every registered task kind, workflow included, carries it the same way. Undefined until the task's
472
450
  * own settle point has run ({@link mintCompletionId}), or for an id this registry never held. */
473
451
  getCompletionId(id: string): string | undefined;
452
+ /** Record the ref a task's result was stored under (`persistTaskArtifact` landed it) — the read handle a later list of
453
+ * tasks names for it. `completionId` = the settle the result belongs to ({@link getCompletionId}, read in that settle's own
454
+ * synchronous step — every terminal frame carries it): the write records only while the row still holds that settle. A row revived
455
+ * since (a new cycle clears the id and mints its own), replaced under the same id (a revival in another registration),
456
+ * or gone (terminal GC) records nothing — and so does a write that names no settle. */
457
+ recordArtifactRef(id: string, ref: string, completionId: string | undefined): void;
458
+ /** The legs a page-back of `ref` travels (ReadToolResult's per-call reading): a ref holding a background task's result —
459
+ * its origin is part of the ref ({@link taskArtifactOriginOf}), so no row eviction, restart or other store forgets it —
460
+ * travels what a poll of that task travels ({@link boundaryLegsOf}, `"output"` — another tree's agent, a workflow run, a
461
+ * row gone or out of reach are off-target reads); any other ref (offloaded tool output) stays inside the engine. */
462
+ artifactBoundaryLegs(ref: string, access: TaskAccess, tree: object): BoundaryLegsGiven;
463
+ /** The read handle ({@link taskReadHandleText}) of a task `access` reaches — `undefined` for an unknown or unreachable
464
+ * id (the same info-hiding a poll gives) and for a task with nothing to read beyond its notification. */
465
+ readHandleOf(id: string, access: TaskAccess): string | undefined;
474
466
  /** Bulk stop-source attribution for one owner — the registry-side primitive that
475
467
  * replaces the service's `list()+markStopSource` per-row loop, which had TWO holes: ① `list()` didn't
476
468
  * expose `sessionScoped`, so on the resume leg (canonical taskId==sessionId, rebuilt taskConfig without
@@ -556,7 +548,7 @@ export declare class TaskRegistry {
556
548
  * `originatingSessionId` — see {@link reapSessionBackground}'s own workflow arm for why) — and runs
557
549
  * the per-session reap on each pair; retained rows are left alone (row and process), exactly like the
558
550
  * per-session anchor. Timing discipline: call at the hardShutdown TERMINUS, never at drain start — an
559
- * in-flight turn may still be TaskOutput-following a bg process. Returns total rows reaped.
551
+ * in-flight turn may still be following a bg process. Returns total rows reaped.
560
552
  *
561
553
  * Its kills go through each env's `killBackground` (possibly a TERM-then-timer ladder), and it reaches
562
554
  * session-resident rows only: every exit terminus calls {@link killAllBackgroundShellsNow} after it. */
@@ -622,7 +614,7 @@ export declare class TaskRegistry {
622
614
  * watcher tick that passed its status gate before the settle landed) emits exactly ONE terminal notice.
623
615
  * The latch stays set even if the sink throws — a faulty sink must not re-arm it. */
624
616
  private notifyTerminalOnce;
625
- /** G2b watcher (design/116 §7): 1s poll loop that spools increments (rolling bound) and fires ONE
617
+ /** G2b watcher (design/116 §7): 1s poll loop (its first beat at registration) that spools increments (rolling bound) and fires ONE
626
618
  * completion notification at the terminal state. `unref()`d — a watcher never keeps the process alive.
627
619
  * Stops itself on terminal, on a vanished shell (env disposed), or when the handle is evicted. */
628
620
  private startBashWatcher;
@@ -639,7 +631,7 @@ export declare class TaskRegistry {
639
631
  * one terminal notification (exit code / timeout / auto-stop / env-side kill). */
640
632
  registerMonitor(input: RegisterMonitorInput): string;
641
633
  registerWorkflow(input: RegisterWorkflowInput): string;
642
- /** The legs one TaskOutput (`"output"`) or TaskStop (`"stop"`) call travels, read off the handle the call dispatches to by the same
634
+ /** 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
643
635
  * resolution the poll and the stop take: a background shell's or a monitor's process lives in its own environment (the `env` leg
644
636
  * reaches that one); an agent handle that recorded the calling tree's own token moves nothing across the boundary; any other handle — an
645
637
  * agent of another tree, a workflow run, an id no live handle answers (a durable row read back) — is content from beyond the
@@ -662,28 +654,11 @@ export declare class TaskRegistry {
662
654
  */
663
655
  list(access: TaskAccess, opts?: {
664
656
  limit?: number;
665
- }): Array<{
666
- task_id: string;
667
- type: SemaTaskType;
668
- status: SemaTaskStatus;
669
- /** design/129 lifetime flag, surfaced for observability — on resume-leg deployments the
670
- * canonical taskId==sessionId, so task- and session-scoped rows share an owner KEY VALUE and only this
671
- * explicit flag tells them apart. Bulk attribution should use {@link markStopSourceForOwner}, not a
672
- * list()-driven loop (the 500-row cap). */
673
- sessionScoped: boolean;
674
- /** Present on a shell-lane row (`background_bash` / `monitor`) that THE retain predicate keeps alive
675
- * past the automatic reaps — the "keeps running" half of an exit listing: the controlled-exit reap and
676
- * the hard face under `includeRetained: false` leave it running; every other running shell row stops. */
677
- retained?: true;
678
- description?: string;
679
- toolUseId?: string;
680
- createdAt: number;
681
- updatedAt: number;
682
- }>;
657
+ }): TaskListRow[];
683
658
  /** The tasks `access` reaches that have not finished (`pending`, `running` or `parked`), newest first — EVERY one, with no display
684
659
  * cap ({@link list}'s): the one reading of a leg's live background tasks (its end's {@link owedDeliveries}, the post-compaction
685
660
  * listing and the resume's orphan diff, the suspend's snapshot), each consumer projecting its own columns from it. */
686
- liveTasks(access: TaskAccess): ReturnType<TaskRegistry["list"]>;
661
+ liveTasks(access: TaskAccess): TaskListRow[];
687
662
  /** Every row `access` reaches, newest first, in {@link list}'s projection — the one walk both readings take. */
688
663
  private rowsUnder;
689
664
  /** Throttled {@link gc} for hot-path callers (design/115 review B5): prepare-task runs once per task,
@@ -700,5 +675,4 @@ export declare class TaskRegistry {
700
675
  private stopWorkflow;
701
676
  }
702
677
  export declare const defaultTaskRegistry: TaskRegistry;
703
- export declare function createTaskOutputTool(opts: TaskToolOptions): AgentTool;
704
678
  export declare function createTaskStopTool(opts: TaskToolOptions): AgentTool;