@sema-agent/core 7.66.1 → 7.67.1

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 (904) hide show
  1. package/CHANGELOG.md +3518 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +169 -0
  71. package/dist/brain/model-lane.js +505 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +164 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +105 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +24 -25
  362. package/dist/core/roles.js +148 -21
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +126 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +64 -34
  730. package/dist/index.js +45 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -0,0 +1,85 @@
1
+ import { canAccess } from "./task-registry-shared.js";
2
+ import { stopWorkflowLane } from "./task-registry-workflow.js";
3
+ function stopUnyieldable(core, handle, source) {
4
+ core.markStopSource(handle.id, source);
5
+ handle.abort.abort();
6
+ }
7
+ export function requestYieldLane(core, handle, opts) {
8
+ if (handle.type === "workflow") {
9
+ if (handle.yieldIntent !== undefined) {
10
+ handle.yieldIntent.abort();
11
+ return undefined;
12
+ }
13
+ if (opts.stopUnyieldable !== undefined)
14
+ void stopWorkflowLane(handle);
15
+ return "no_park_lane";
16
+ }
17
+ const seat = handle.yieldSeat;
18
+ seat.requested = opts.stopUnyieldable !== undefined ? { stopUnyieldable: opts.stopUnyieldable } : {};
19
+ if (seat.lane !== "parkable") {
20
+ if (opts.stopUnyieldable !== undefined)
21
+ stopUnyieldable(core, handle, opts.stopUnyieldable);
22
+ return seat.lane;
23
+ }
24
+ if (seat.leg !== undefined && !seat.leg.ready) {
25
+ if (opts.stopUnyieldable !== undefined)
26
+ stopUnyieldable(core, handle, opts.stopUnyieldable);
27
+ else
28
+ seat.leg.controller.abort();
29
+ return "leg_not_ready";
30
+ }
31
+ seat.leg?.controller.abort();
32
+ return undefined;
33
+ }
34
+ export function yieldRequested(handle) {
35
+ return handle.type === "workflow" ? handle.yieldIntent?.signal.aborted === true : handle.yieldSeat.requested !== undefined;
36
+ }
37
+ export function attachYieldLegLane(core, id, controller, ready) {
38
+ const handle = core.handles.get(id);
39
+ if (handle === undefined || handle.type !== "background_agent")
40
+ return;
41
+ const seat = handle.yieldSeat;
42
+ seat.leg = { controller, ready };
43
+ const requested = seat.requested;
44
+ if (requested === undefined)
45
+ return;
46
+ if (!ready && requested.stopUnyieldable !== undefined)
47
+ stopUnyieldable(core, handle, requested.stopUnyieldable);
48
+ else
49
+ controller.abort();
50
+ }
51
+ export function yieldCovers(handle, access, opts) {
52
+ if (handle.status !== "running")
53
+ return false;
54
+ if (handle.type === "workflow")
55
+ return access === undefined && !(opts.skipSessionScoped === true && handle.sessionScoped === true);
56
+ if (handle.type !== "background_agent")
57
+ return false;
58
+ if (access !== undefined && !canAccess(handle, access))
59
+ return false;
60
+ return !(opts.skipSessionScoped === true && handle.sessionScoped);
61
+ }
62
+ export function yieldPopulationLane(core, access, opts) {
63
+ return [...core.handles.values()].filter((handle) => yieldCovers(handle, access, opts));
64
+ }
65
+ export function yieldPopulationLeftRunning(core, ids) {
66
+ for (const id of ids) {
67
+ const handle = core.handles.get(id);
68
+ if (handle !== undefined && (handle.type === "background_agent" || handle.type === "workflow") && handle.status === "running")
69
+ return false;
70
+ }
71
+ return true;
72
+ }
73
+ export async function yieldPopulationWrites(core, ids) {
74
+ const lanes = [];
75
+ const runs = [];
76
+ for (const id of ids) {
77
+ const handle = core.handles.get(id);
78
+ if (handle !== undefined && handle.type === "background_agent" && handle.durable !== undefined)
79
+ lanes.push({ id, lane: handle.durable });
80
+ if (handle !== undefined && handle.type === "workflow")
81
+ runs.push(handle.handle.done.catch(() => undefined));
82
+ }
83
+ await Promise.all([...lanes.map(({ lane }) => lane.chain.catch(() => undefined)), ...runs]);
84
+ return lanes.filter(({ lane }) => lane.flushFailed).map(({ id }) => id);
85
+ }
@@ -8,11 +8,11 @@ import type { TaskNotificationPayload } from "./task-notification.js";
8
8
  import type { ExtensionRequester } from "./task-event.js";
9
9
  import { type TaskArtifactSeat } from "./tool-result-store.js";
10
10
  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";
11
- export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, engineAgentName, chosenAgentName } from "./task-registry-shared.js";
12
- export type { ParkedClaimTicket, RegisterBackgroundAgentInput } from "./task-registry-shared.js";
13
- import type { RegisterBackgroundAgentInput, ParkedClaimTicket, ChildSessionStore, LandedAgentTerminal } from "./task-registry-shared.js";
11
+ export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, engineAgentName, chosenAgentName, PARKED_CLAIM_ROLLBACKS, PARKED_CLAIM_ROLLBACK_FACE } from "./task-registry-shared.js";
12
+ export type { ParkedClaimTicket, ParkedClaimRollback, RegisterBackgroundAgentInput, BackgroundUnyieldableReason, BackgroundYieldLane, BackgroundYieldOptions, BackgroundYieldReport } from "./task-registry-shared.js";
13
+ import type { RegisterBackgroundAgentInput, ParkedClaimTicket, ParkedClaimRollback, ChildSessionStore, LandedAgentTerminal, BackgroundYieldOptions, BackgroundYieldReport } from "./task-registry-shared.js";
14
14
  import type { ChildSessionAnchor } from "./task-registry-agent.js";
15
- import { type DelegationOccupant } from "./task-registry-agent.js";
15
+ import { type DelegationOccupant, type DelegationRowAddress } from "./task-registry-agent.js";
16
16
  import { type AgentStateSource } from "./agent-state.js";
17
17
  import type { CheckpointSeat } from "./checkpoint-seat.js";
18
18
  export type { SemaTaskType, StopSource, SemaTaskStatus, TaskRetrievalStatus, UnifiedTaskOutput, SemaTaskHandle, TaskAccess, MonitorTimers, RegisterMonitorInput, RegisterWorkflowInput, };
@@ -76,7 +76,7 @@ export interface TaskPollOptions {
76
76
  timeoutMs?: number;
77
77
  /** Abort signal — a blocked wait stops when the caller cancels. */
78
78
  signal?: AbortSignal;
79
- /** The run's checkpoint seat: a PARKED background_agent row's approval card is read from it for the
79
+ /** The run's checkpoint seat: a PARKED background_agent row's park card is read from it for the
80
80
  * answer's `agentState` ({@link import("./agent-state.js").readAgentState}). Absent ⇒ the card reads
81
81
  * `unreadable`; nothing else changes. */
82
82
  checkpointSeat?: CheckpointSeat;
@@ -121,8 +121,32 @@ export interface TaskListRow {
121
121
  * `$.agent.spawn` (`ExtensionRequester`); ABSENT on every other row (the model's own spawn, the host's, and every row an earlier
122
122
  * release registered): the one reading, with no word for either. A display and audit fact only. */
123
123
  requestedBy?: ExtensionRequester;
124
+ /** Present, `true`, on a `running` workflow row whose run has a leg parked (on any gate) — something is being waited on
125
+ * while `status` still says `running` (the run-level bit, `runParkedOf`, read off the live run through
126
+ * `WorkflowHandle.parked`; the row projects it and derives nothing). ABSENT on every other row — a workflow that is not
127
+ * waiting, one a TaskStop or its own end has moved past `running`, a handle that does not answer `true` (one that THROWS is
128
+ * {@link TaskListRow.parkedUnreadable}), and every other task type — never `false`. */
129
+ parked?: true;
130
+ /** Present, `true`, on a `running` workflow row whose handle THREW when asked whether its run is parked (`parked` is absent
131
+ * then): the row cannot say whether somebody is being waited on, so "not parked" would be a guess — an absent `parked` beside this
132
+ * member is "unknown", not "no". The handle is a host's to supply (`registerWorkflow`), and one handle that cannot answer costs its
133
+ * own row this member and no other row, nor the listing, anything. ABSENT on every other row — a handle that answered (`true` or
134
+ * anything else), a settled workflow, every other task type — never `false`. */
135
+ parkedUnreadable?: true;
136
+ /** The row's completion identity — the handle's own fill-once value ({@link SemaTaskHandle.completionId}), the same one the
137
+ * completion frame, the inbox / replay record and the host poll carry for this completion, so a host that met the
138
+ * completion on one of those recognizes the row. Present iff the row's completion minted one: a settled row of every
139
+ * task type; absent on a `pending` / `running` / `parked` row (a revived background agent drops its earlier cycle's value
140
+ * until the new cycle settles) and on a settled row whose ending minted none (a workflow whose run never reached its
141
+ * terminal transition). Never derived, never a placeholder. */
142
+ completionId?: string;
124
143
  createdAt: number;
144
+ /** The wall-clock instant of the row's last activity — for display. A clock that steps, or a machine that sleeps, moves it. */
125
145
  updatedAt: number;
146
+ /** The same instant on this process's monotonic clock (`performance.now()` milliseconds): how long the row has been silent is
147
+ * `performance.now() - lastActivityMono`, immune to wall-clock steps and sleep. Only meaningful in the process that listed the row —
148
+ * never persisted, never compared across processes. */
149
+ lastActivityMono: number;
126
150
  }
127
151
  /**
128
152
  * RB-49 B-3 (2026-07-25): the row-metadata projection `getAccessibleTask` returns. Was spelled out as a
@@ -229,6 +253,42 @@ export declare class TaskRegistry {
229
253
  * session in (see {@link bindBackgroundAgentSessionLane}). */
230
254
  bindBackgroundAgentSession(id: string, sessionId: string, store: ChildSessionStore): void;
231
255
  registerBackgroundAgent(input: RegisterBackgroundAgentInput): string;
256
+ /**
257
+ * A whole-registry yield covers what enters `running` after it too — a spawn (here, at registration), a parked-resume drive
258
+ * (born parked, running from its consume flip: covered at its leg's report), a retained wake (covered when the wake
259
+ * lands) and a workflow run (at its registration). One rule at the four doors; work the request already reached is left
260
+ * as it is.
261
+ */
262
+ private coverByRegistryYield;
263
+ /**
264
+ * THE yield verb for background work. Hands every running background agent and workflow run the request covers the
265
+ * yield: an agent whose spawner can hold its park parks at its leg's next clean turn boundary (a
266
+ * `resource_limit/preempt` checkpoint, its row `parked`), a workflow run whose park lane is armed has each of its legs
267
+ * do the same and suspends on their parks; one that cannot is listed with why, and stopped only when
268
+ * `opts.stopUnyieldable` says so.
269
+ *
270
+ * `access` absent ⇒ the whole registry, workflow runs included, and the request stays in force for work registered after
271
+ * it (a draining process: call it beside raising your own root legs' `TaskSpec.preemptSignal`, then wait on `drained()`
272
+ * or your drain window). With `access` ⇒ the background agents that access reaches (a workflow run is never its
273
+ * launching leg's to decide) — the engine's own call is a parent leg that durably parked, over the agents it owns
274
+ * (`skipSessionScoped`, `stopUnyieldable: "parent"`). A host that mounted its own registry calls this on that
275
+ * registry; the engine reaches only the run's own. What yielded continues when its owner runs again: a yielded agent
276
+ * row is claimed and driven by its owner's next leg; a yielded workflow run continues on its next resume
277
+ * (`resumeFromRunId`), which drives its yielded legs with no decision.
278
+ */
279
+ yieldBackground(access?: TaskAccess, opts?: BackgroundYieldOptions): BackgroundYieldReport;
280
+ /** A background agent's leg reports its own yield controller and whether it can suspend durably (the delegation lane wires
281
+ * it into the leg's trusted internals; see {@link RunInternals.reportSuspendLane}). */
282
+ attachYieldLeg(id: string, controller: AbortController, ready: boolean): void;
283
+ /** The whole-registry yield in force, if any (it covers agents that enter `running` after it). */
284
+ private registryYield;
285
+ /** Pending `drained()` checks, re-run after every transition poke. */
286
+ private readonly drainChecks;
287
+ /** A yield's `drained()` re-reads on every transition (an agent's park or settle, a workflow run's end), one microtask
288
+ * later: a park or a settle queues its durable write in the same synchronous stretch as its poke, so the write is in
289
+ * the chain the check then awaits. */
290
+ private pokeYieldDrains;
291
+ private whenDrained;
232
292
  /** #22 — persist this leg's org-memory admission verdict on the durable row (the cross-process
233
293
  * revival's only carrier). See {@link recordBackgroundAgentOrgAdmissionLane}. */
234
294
  recordBackgroundAgentOrgAdmission(id: string, verdict: import("./memory-admission.js").OwnOrgAdmissionVerdict): void;
@@ -263,7 +323,7 @@ export declare class TaskRegistry {
263
323
  rollbackParkedClaim(stores: {
264
324
  agentStore: import("./background-agent-store.js").BackgroundAgentStore;
265
325
  checkpointStore: Pick<import("./checkpoint-store.js").CheckpointStore, "get">;
266
- }, ticket: ParkedClaimTicket): Promise<"rolled_back" | "failed" | "lost" | "retry">;
326
+ }, ticket: ParkedClaimTicket): Promise<ParkedClaimRollback>;
267
327
  consumeParkedFlip(id: string, stores: {
268
328
  agentStore: import("./background-agent-store.js").BackgroundAgentStore;
269
329
  }, ticket: ParkedClaimTicket): Promise<boolean>;
@@ -286,12 +346,15 @@ export declare class TaskRegistry {
286
346
  cycle?: number;
287
347
  }): "completed" | "failed" | "killed" | undefined;
288
348
  /** design/164 — record one tool-lifecycle beat on a running background-agent row; see
289
- * {@link noteBackgroundAgentActivityLane} for why the in-memory row needed a stall signal at all. */
290
- noteBackgroundAgentActivity(id: string, now?: number): void;
349
+ * {@link noteBackgroundAgentActivityLane} for why the in-memory row needed a stall signal at all. `atMono` is an instant on the
350
+ * process-monotonic clock (`performance.now()` milliseconds), never a wall-clock time, from 0 to the clock's now (anything else
351
+ * throws); absent ⇒ now. The row's stamp never goes back: an earlier instant leaves it. */
352
+ noteBackgroundAgentActivity(id: string, atMono?: number): void;
291
353
  /** design/164 — collect SESSION-SCOPED background agents that have gone silent for `staleMs`, the
292
354
  * stall-based replacement for the retired wall-clock ceiling on that lane. Caller-supplied policy
293
- * like every other retention knob here; see {@link reapStaleSessionBackgroundAgentsLane}. */
294
- reapStaleSessionBackgroundAgents(staleMs: number, now?: number): number;
355
+ * like every other retention knob here; see {@link reapStaleSessionBackgroundAgentsLane}. Silence is measured on the
356
+ * process-monotonic clock: `nowMono` is `performance.now()` milliseconds (absent ⇒ now), never a wall-clock time. */
357
+ reapStaleSessionBackgroundAgents(staleMs: number, nowMono?: number): number;
295
358
  abortBackgroundAgentsForOwner(access: TaskAccess, opts?: {
296
359
  skipSessionScoped?: boolean;
297
360
  sessionScopedOnly?: boolean;
@@ -328,6 +391,11 @@ export declare class TaskRegistry {
328
391
  /** The same rows as {@link activeDelegationHandles}, each with its addressing name and whether `caller` reaches it — what a refusal
329
392
  * of one more child may tell its caller about who holds the tree's slots. See {@link activeDelegationOccupantsLane}. */
330
393
  activeDelegationOccupants(scope: string, rootSessionId: string, caller?: TaskAccess): DelegationOccupant[];
394
+ /** The ACTIVE (running / pending) rows of one delegation tree in THIS process, in EVERY scope, each with the scope it is registered
395
+ * in — the live twin of `BackgroundAgentStore.listByRoot` (one tree reading, one root judge: a root that is not a non-empty string
396
+ * of at most 256 characters without control characters is refused with `config.invalid_argument`). A host enumerating a
397
+ * session's children for deletion reads both and acts on each row in that row's own scope. See {@link activeDelegationHandlesByRootLane}. */
398
+ activeDelegationHandlesByRoot(rootSessionId: string): DelegationRowAddress[];
331
399
  /** ASYNC (revive arbitration) — the durable half is a guarded ownership claim on the row (awaited before the
332
400
  * in-memory flip), so this leg and a cross-process claim arbitrate in one domain instead of both
333
401
  * believing they own the cycle. See {@link reviveBackgroundAgentLane}. */
@@ -606,6 +674,16 @@ export declare class TaskRegistry {
606
674
  countRunningBackgroundShells(opts: {
607
675
  includeRetained: boolean;
608
676
  }): number;
677
+ /** How many session-scoped background agents have a child run in flight in this process: the registry's `running`
678
+ * `background_agent` rows that carry the explicit `sessionScoped` flag, over the WHOLE registry — no owner, session, scope or
679
+ * access narrowing. The rows are chosen by the reading both reaps use ({@link isLiveSessionResidentAgent}), so the count and
680
+ * the sweeps cannot drift: a `parked` row (a wait on a person) and a settled row are not counted, a task-scoped agent is
681
+ * not, and a workflow or a shell row is not an agent. SYNCHRONOUS and READ-ONLY, and it never throws: it reads three of the
682
+ * registry's own row fields and nothing a host provides. It counts registry rows, not process truth — a row stays counted
683
+ * until its settle lands (a reap, the child's own end, a TaskStop). Not {@link list}'s length (the caller's reach, capped,
684
+ * every type and status), not {@link liveTasks} (the caller's reach), not {@link countRunningBackgroundForOwner} (one owner
685
+ * key, shells included); the shell-lane twin is {@link countRunningBackgroundShells}. */
686
+ countRunningSessionBackgroundAgents(): number;
609
687
  /** subscribe to `reapSessionBackground` (the design/129 session terminal anchor).
610
688
  * Returns an unsubscribe. Hooks are best-effort observers; a throwing hook is swallowed. */
611
689
  onSessionReap(hook: (sessionId: string, scope?: string) => void): () => void;
@@ -2,6 +2,7 @@ import { randomBytes } from "node:crypto";
2
2
  import { defineTool, errorResult } from "./tools.js";
3
3
  import { envDeclaresRetain, hasBackgroundShell, retainsBackgroundProcesses } from "./background-shell.js";
4
4
  import { shutdownDebug } from "./shutdown-debug.js";
5
+ import { mintCompletionId } from "./completion-id.js";
5
6
  import { canAccessAgentRecord, } from "./background-agent-store.js";
6
7
  import { delimitUntrusted } from "./untrusted-text.js";
7
8
  import { createSafeNotifier } from "./safe-notify.js";
@@ -10,13 +11,16 @@ import { readExtensionRequester } from "./extension-requester.js";
10
11
  import { persistTaskArtifact, taskArtifactOriginOf } from "./tool-result-store.js";
11
12
  import { registerMonitorLane, pollMonitorLane, stopMonitorLane } from "./task-registry-monitor.js";
12
13
  import { registerWorkflowLane, pollWorkflowLane, stopWorkflowLane } from "./task-registry-workflow.js";
13
- 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";
14
- export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, engineAgentName, chosenAgentName } from "./task-registry-shared.js";
14
+ import { taskReadHandleText, canAccessWorkflowRun, formatWorkflowRun, clipTaskOutput, assertOwnership, sleepPollStep, statusFromBackground, rollSpoolText, accountDroppedBytes, dropFactsOf, 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, isLiveSessionResidentAgent, DURABLE_AGENT_HANDLE_RE, activityStamp, stampActivity, } from "./task-registry-shared.js";
15
+ export { normalizeAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, engineAgentName, chosenAgentName, PARKED_CLAIM_ROLLBACKS, PARKED_CLAIM_ROLLBACK_FACE } from "./task-registry-shared.js";
16
+ import { attachYieldLegLane, requestYieldLane, yieldCovers, yieldPopulationLane, yieldPopulationLeftRunning, yieldPopulationWrites, yieldRequested } from "./task-registry-yield.js";
15
17
  import { TASK_STOP_TOOL_NAME, TASK_STOP_MISSING_ID_MESSAGE, TASK_STOP_PARAMS, TASK_STOP_DESCRIPTION, resolveTaskIdArg } from "./task-tool-shape.js";
16
- import { durableAgentArmedLane, durableAgentRowProbeLane, beginDurableClaimLane, endDurableClaimLane, reapDurableAgentsLane, noteBackgroundAgentActivityLane, reapStaleSessionBackgroundAgentsLane, announceLandedAgentTerminal, 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";
18
+ import { durableAgentArmedLane, durableAgentRowProbeLane, beginDurableClaimLane, endDurableClaimLane, reapDurableAgentsLane, noteBackgroundAgentActivityLane, reapStaleSessionBackgroundAgentsLane, announceLandedAgentTerminal, releaseDurableTranscriptAnchorLane, bindBackgroundAgentSessionLane, childSessionAnchorOf, registerBackgroundAgentLane, recordBackgroundAgentOrgAdmissionLane, parkBackgroundAgentLane, reconcileParkedAgentsLane, claimParkedAgentLane, rollbackParkedClaimLane, consumeParkedFlipLane, finalizeParkedResumeLane, settleBackgroundAgentLane, abortBackgroundAgentsForOwnerLane, serveDurableAgentRowLane, resolveBackgroundAgentByNameLane, backgroundAgentCycleSeqLane, activeDelegationHandlesLane, activeDelegationHandlesByRootLane, activeDelegationOccupantsLane, markRetainedContinuationLane, reviveBackgroundAgentLane, settleRevivedAgentLane, unmarkRetainedContinuationLane, attachAgentNotifyLane, deliverToRunningAgentLane, runningBackgroundAgentLabelsLane, runningAgentFooterLane, notFoundRunningAgentsTail, pollBackgroundAgentLane, stopBackgroundAgentLane, } from "./task-registry-agent.js";
17
19
  import { mountRuleFace, toolFace } from "./tool-catalog-entries.js";
18
20
  import { thrownText } from "./thrown-value.js";
19
21
  import { agentStateSourceOfHandle, agentStateSourceOfRecord, agentStateSummary, readAgentState } from "./agent-state.js";
22
+ import { callScopeOf } from "./isolation-scope.js";
23
+ import { envErrorDetail } from "../tools/fs/env-error-detail.js";
20
24
  export { canAccessWorkflowRun, clipTaskOutput, MONITOR_BATCH_WINDOW_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, MONITOR_MAX_BATCHES_PER_MINUTE };
21
25
  function shellRowRetained(h) {
22
26
  return retainsBackgroundProcesses({ marked: h.retained === true, env: envDeclaresRetain(h.env) });
@@ -137,6 +141,14 @@ function explicitStopBashTerminalNote(handle, alreadyGone) {
137
141
  function monitorInTimeoutWindow(handle) {
138
142
  return handle.status === "running" && handle.deadlineAt !== undefined && handle.timers.now() < handle.deadlineAt;
139
143
  }
144
+ function workflowParkedProjection(handle) {
145
+ try {
146
+ return handle.parked?.() === true ? { parked: true } : {};
147
+ }
148
+ catch {
149
+ return { parkedUnreadable: true };
150
+ }
151
+ }
140
152
  export class TaskRegistry {
141
153
  handles = new Map();
142
154
  sessionReapHooks = new Set();
@@ -153,6 +165,7 @@ export class TaskRegistry {
153
165
  markStopSource: (id, source) => self.markStopSource(id, source),
154
166
  notifyTerminalOnce: (handle, send) => self.notifyTerminalOnce(handle, send),
155
167
  pokeBgQuiescence: (owner) => self.pokeBgQuiescence(owner),
168
+ pokeYieldDrains: () => self.pokeYieldDrains(),
156
169
  get writerId() { return self.writerId; },
157
170
  get reapingHandles() { return self.reapingHandles; },
158
171
  get reapedHandles() { return self.reapedHandles; },
@@ -184,7 +197,62 @@ export class TaskRegistry {
184
197
  return bindBackgroundAgentSessionLane(this.core, id, sessionId, store);
185
198
  }
186
199
  registerBackgroundAgent(input) {
187
- return registerBackgroundAgentLane(this.core, input);
200
+ const id = registerBackgroundAgentLane(this.core, input);
201
+ this.coverByRegistryYield(id);
202
+ return id;
203
+ }
204
+ coverByRegistryYield(id) {
205
+ const handle = this.handles.get(id);
206
+ if (this.registryYield === undefined || handle === undefined || !yieldCovers(handle, undefined, this.registryYield.opts))
207
+ return;
208
+ if (yieldRequested(handle))
209
+ return;
210
+ requestYieldLane(this.core, handle, this.registryYield.opts);
211
+ this.registryYield.population.add(id);
212
+ }
213
+ yieldBackground(access, opts = {}) {
214
+ const population = new Set();
215
+ const yielding = [];
216
+ const notYieldable = [];
217
+ if (access === undefined)
218
+ this.registryYield = { opts, population };
219
+ for (const handle of yieldPopulationLane(this.core, access, opts)) {
220
+ population.add(handle.id);
221
+ const reason = requestYieldLane(this.core, handle, opts);
222
+ if (reason === undefined)
223
+ yielding.push(handle.id);
224
+ else
225
+ notYieldable.push({ id: handle.id, reason });
226
+ }
227
+ return { yielding, notYieldable, drained: () => this.whenDrained(population) };
228
+ }
229
+ attachYieldLeg(id, controller, ready) {
230
+ this.coverByRegistryYield(id);
231
+ attachYieldLegLane(this.core, id, controller, ready);
232
+ }
233
+ registryYield;
234
+ drainChecks = new Set();
235
+ pokeYieldDrains() {
236
+ for (const check of this.drainChecks)
237
+ queueMicrotask(check);
238
+ }
239
+ whenDrained(population) {
240
+ return new Promise((resolve) => {
241
+ const check = () => {
242
+ if (!this.drainChecks.has(check) || !yieldPopulationLeftRunning(this.core, population))
243
+ return;
244
+ this.drainChecks.delete(check);
245
+ const seen = population.size;
246
+ void yieldPopulationWrites(this.core, population).then((unpersisted) => {
247
+ if (population.size === seen && yieldPopulationLeftRunning(this.core, population))
248
+ return resolve({ unpersisted });
249
+ this.drainChecks.add(check);
250
+ check();
251
+ });
252
+ };
253
+ this.drainChecks.add(check);
254
+ check();
255
+ });
188
256
  }
189
257
  recordBackgroundAgentOrgAdmission(id, verdict) {
190
258
  return recordBackgroundAgentOrgAdmissionLane(this.core, id, verdict);
@@ -214,11 +282,11 @@ export class TaskRegistry {
214
282
  settleBackgroundAgent(id, outcome) {
215
283
  return settleBackgroundAgentLane(this.core, id, outcome);
216
284
  }
217
- noteBackgroundAgentActivity(id, now) {
218
- return noteBackgroundAgentActivityLane(this.core, id, now);
285
+ noteBackgroundAgentActivity(id, atMono) {
286
+ return noteBackgroundAgentActivityLane(this.core, id, atMono);
219
287
  }
220
- reapStaleSessionBackgroundAgents(staleMs, now) {
221
- return reapStaleSessionBackgroundAgentsLane(this.core, staleMs, now);
288
+ reapStaleSessionBackgroundAgents(staleMs, nowMono) {
289
+ return reapStaleSessionBackgroundAgentsLane(this.core, staleMs, nowMono);
222
290
  }
223
291
  abortBackgroundAgentsForOwner(access, opts) {
224
292
  return abortBackgroundAgentsForOwnerLane(this.core, access, opts);
@@ -248,8 +316,15 @@ export class TaskRegistry {
248
316
  activeDelegationOccupants(scope, rootSessionId, caller) {
249
317
  return activeDelegationOccupantsLane(this.core, scope, rootSessionId, caller);
250
318
  }
319
+ activeDelegationHandlesByRoot(rootSessionId) {
320
+ return activeDelegationHandlesByRootLane(this.core, rootSessionId);
321
+ }
251
322
  reviveBackgroundAgent(id, access, abort) {
252
- return reviveBackgroundAgentLane(this.core, id, access, abort);
323
+ return reviveBackgroundAgentLane(this.core, id, access, abort).then((r) => {
324
+ if (r.ok)
325
+ this.coverByRegistryYield(id);
326
+ return r;
327
+ });
253
328
  }
254
329
  settleRevivedAgent(id, cycle, outcome) {
255
330
  return settleRevivedAgentLane(this.core, id, cycle, outcome);
@@ -320,7 +395,7 @@ export class TaskRegistry {
320
395
  ...(input.scope !== undefined ? { scope: input.scope } : {}),
321
396
  ...(input.toolUseId !== undefined ? { toolUseId: input.toolUseId } : {}),
322
397
  createdAt: now,
323
- updatedAt: now,
398
+ ...activityStamp(now),
324
399
  env: input.env,
325
400
  shellId: input.shellId,
326
401
  ...(onTerminal !== undefined ? { onTerminal } : {}),
@@ -481,7 +556,7 @@ export class TaskRegistry {
481
556
  const killFailed = !kill.ok && kill.error.code !== "not_found";
482
557
  handle.status = "killed";
483
558
  handle.stoppedBy = handle.stopSource ?? source;
484
- handle.updatedAt = Date.now();
559
+ stampActivity(handle);
485
560
  mintCompletionId(handle);
486
561
  await drainBashTailBestEffort(handle);
487
562
  const resultText = handle.spool !== undefined ? bashTerminalResult(handle.spool) : "";
@@ -508,7 +583,7 @@ export class TaskRegistry {
508
583
  const killFailed = !kill.ok && kill.error.code !== "not_found";
509
584
  handle.status = "killed";
510
585
  handle.stoppedBy = handle.stopSource ?? source;
511
- handle.updatedAt = Date.now();
586
+ stampActivity(handle);
512
587
  mintCompletionId(handle);
513
588
  const lastLines = handle.lineBuf !== "" ? [handle.lineBuf] : [];
514
589
  handle.lineBuf = "";
@@ -554,7 +629,7 @@ export class TaskRegistry {
554
629
  void this.reportSessionReapKillFailure("monitor", handle);
555
630
  handle.status = "killed";
556
631
  handle.stoppedBy = handle.stopSource ?? "system";
557
- handle.updatedAt = Date.now();
632
+ stampActivity(handle);
558
633
  mintCompletionId(handle);
559
634
  reaped++;
560
635
  continue;
@@ -569,7 +644,7 @@ export class TaskRegistry {
569
644
  void this.reportSessionReapKillFailure("background_bash", handle);
570
645
  handle.status = "killed";
571
646
  handle.stoppedBy = handle.stopSource ?? "system";
572
- handle.updatedAt = Date.now();
647
+ stampActivity(handle);
573
648
  mintCompletionId(handle);
574
649
  reaped++;
575
650
  continue;
@@ -579,7 +654,7 @@ export class TaskRegistry {
579
654
  reaped++;
580
655
  continue;
581
656
  }
582
- if (handle.type !== "background_agent" || handle.status !== "running" || !handle.sessionScoped)
657
+ if (!isLiveSessionResidentAgent(handle))
583
658
  continue;
584
659
  if (!canAccess(handle, access))
585
660
  continue;
@@ -663,7 +738,7 @@ export class TaskRegistry {
663
738
  }
664
739
  handle.status = "killed";
665
740
  handle.stoppedBy = handle.stopSource ?? "system";
666
- handle.updatedAt = Date.now();
741
+ stampActivity(handle);
667
742
  mintCompletionId(handle);
668
743
  if (handle.owner !== undefined)
669
744
  settledOwners.add(handle.owner);
@@ -682,6 +757,14 @@ export class TaskRegistry {
682
757
  }
683
758
  return n;
684
759
  }
760
+ countRunningSessionBackgroundAgents() {
761
+ let n = 0;
762
+ for (const row of this.handles.values()) {
763
+ if (isLiveSessionResidentAgent(row))
764
+ n++;
765
+ }
766
+ return n;
767
+ }
685
768
  onSessionReap(hook) {
686
769
  this.sessionReapHooks.add(hook);
687
770
  return () => void this.sessionReapHooks.delete(hook);
@@ -728,6 +811,7 @@ export class TaskRegistry {
728
811
  };
729
812
  }
730
813
  pokeBgQuiescence(owner) {
814
+ this.pokeYieldDrains();
731
815
  if (owner === undefined)
732
816
  return;
733
817
  const set = this.bgQuiescenceWatchers.get(owner);
@@ -779,7 +863,7 @@ export class TaskRegistry {
779
863
  if ((r.error.code === "timeout" || r.error.code === "io") && ++pollFailures <= MAX_RETRYABLE_POLL_FAILURES)
780
864
  return;
781
865
  handle.status = "failed";
782
- handle.updatedAt = Date.now();
866
+ stampActivity(handle);
783
867
  mintCompletionId(handle);
784
868
  stop();
785
869
  const lostResult = bashTerminalResult(handle.spool);
@@ -789,7 +873,7 @@ export class TaskRegistry {
789
873
  ...(handle.toolUseId !== undefined ? { toolUseId: handle.toolUseId } : {}),
790
874
  ...(handle.outputFile !== undefined ? { output_file: handle.outputFile } : {}),
791
875
  status: "failed",
792
- summary: `${terminalTaskSummary("bash", (handle.description ?? "background command").slice(0, 200), "failed")} — lost its background process (${r.error.message}); no further output will arrive.`,
876
+ summary: `${terminalTaskSummary("bash", (handle.description ?? "background command").slice(0, 200), "failed")} — lost its background process (${envErrorDetail(r.error.message)}); no further output will arrive.`,
793
877
  ...(lostResult.length > 0 ? { result: lostResult } : {}),
794
878
  ...(handle.completionId !== undefined ? { completionId: handle.completionId } : {}),
795
879
  }));
@@ -811,7 +895,7 @@ export class TaskRegistry {
811
895
  if (handle.status === "killed" && handle.stoppedBy === undefined) {
812
896
  handle.stoppedBy = handle.stopSource ?? (r.value.timedOut === true ? "timeout" : "system");
813
897
  }
814
- handle.updatedAt = Date.now();
898
+ stampActivity(handle);
815
899
  if (r.value.status !== "running") {
816
900
  mintCompletionId(handle);
817
901
  spool.exitCode = r.value.exitCode;
@@ -852,7 +936,7 @@ export class TaskRegistry {
852
936
  if (++pollFailures <= MAX_RETRYABLE_POLL_FAILURES)
853
937
  return;
854
938
  handle.status = "failed";
855
- handle.updatedAt = Date.now();
939
+ stampActivity(handle);
856
940
  mintCompletionId(handle);
857
941
  stop();
858
942
  const crashedResult = bashTerminalResult(handle.spool);
@@ -888,7 +972,9 @@ export class TaskRegistry {
888
972
  return registerMonitorLane(this.core, input.onEvent !== undefined ? { ...input, onEvent: this.commandRecordSink(input.onEvent) } : input);
889
973
  }
890
974
  registerWorkflow(input) {
891
- return registerWorkflowLane(this.core, input);
975
+ const id = registerWorkflowLane(this.core, input);
976
+ this.coverByRegistryYield(id);
977
+ return id;
892
978
  }
893
979
  boundaryLegsOf(id, access, verb, tree) {
894
980
  const handle = this.resolveInternal(id.trim(), access);
@@ -1069,12 +1155,15 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1069
1155
  status: h.status,
1070
1156
  sessionScoped: h.sessionScoped === true,
1071
1157
  ...(requestedBy !== undefined ? { requestedBy } : {}),
1158
+ ...(h.type === "workflow" && h.status === "running" ? workflowParkedProjection(h.handle) : {}),
1072
1159
  ...((h.type === "background_bash" || h.type === "monitor") && shellRowRetained(h) ? { retained: true } : {}),
1073
1160
  ...(h.description !== undefined ? { description: h.description } : {}),
1074
1161
  ...(h.toolUseId !== undefined ? { toolUseId: h.toolUseId } : {}),
1075
1162
  ...(childSession !== undefined ? { sessionId: childSession.sessionId } : {}),
1163
+ ...(h.completionId !== undefined ? { completionId: h.completionId } : {}),
1076
1164
  createdAt: h.createdAt,
1077
1165
  updatedAt: h.updatedAt,
1166
+ lastActivityMono: h.lastActivityMono,
1078
1167
  });
1079
1168
  }
1080
1169
  out.sort((a, b) => b.createdAt - a.createdAt);
@@ -1186,7 +1275,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1186
1275
  status: running ? "running" : handle.status,
1187
1276
  exitCode: spool.exitCode,
1188
1277
  replay: SPOOL_REPLAY,
1189
- ...(spool.droppedBytes !== undefined ? { bytesDroppedBeforeCursor: spool.droppedBytes } : {}),
1278
+ ...dropFactsOf(spool),
1190
1279
  ...(spool.timedOut === true ? { timedOut: true, ...(spool.timeoutSec !== undefined ? { timeoutSec: spool.timeoutSec } : {}) } : {}),
1191
1280
  },
1192
1281
  },
@@ -1211,12 +1300,13 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1211
1300
  return noTask(requestedId, runningAgentFooterLane(this.core, access));
1212
1301
  const retrieval_status = r.error.code === "timeout" ? "timeout" : "not_ready";
1213
1302
  const carriedOutput = stdout.length > 0 || stderr.length > 0;
1214
- const salvaged = carriedOutput
1215
- ? `\n--- output accumulated before the error ---\n${clipTaskOutput(stdout, handle.outputFile)}${stderr ? `\n--- stderr ---\n${clipTaskOutput(stderr, handle.outputFile)}` : ""}`
1216
- : "";
1303
+ const lostFacts = dropFactsOf(dropAcct);
1304
+ const lostLine = spoolDropNote(dropAcct).trimEnd();
1305
+ const salvaged = (lostLine === "" ? "" : `\n${lostLine}`) +
1306
+ (carriedOutput ? `\n--- output accumulated before the error ---\n${clipTaskOutput(stdout, handle.outputFile)}${stderr ? `\n--- stderr ---\n${clipTaskOutput(stderr, handle.outputFile)}` : ""}` : "");
1217
1307
  return {
1218
- content: `Error (task poll): ${r.error.message}${salvaged}`,
1219
- details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status, ...(carriedOutput ? { details: { replay: INCREMENT_REPLAY } } : {}), error: r.error.code },
1308
+ content: `Error (task poll): ${envErrorDetail(r.error.message)}${salvaged}`,
1309
+ details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status, ...(carriedOutput || Object.keys(lostFacts).length > 0 ? { details: { ...(carriedOutput ? { replay: INCREMENT_REPLAY } : {}), ...lostFacts } } : {}), error: r.error.code },
1220
1310
  isError: true,
1221
1311
  };
1222
1312
  }
@@ -1226,7 +1316,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1226
1316
  handle.status = statusFromBackground(r.value.status, r.value.exitCode);
1227
1317
  if (handle.status === "killed" && handle.stoppedBy === undefined)
1228
1318
  handle.stoppedBy = handle.stopSource ?? (r.value.timedOut === true ? "timeout" : "system");
1229
- handle.updatedAt = Date.now();
1319
+ stampActivity(handle);
1230
1320
  const running = r.value.status === "running";
1231
1321
  if (!running)
1232
1322
  mintCompletionId(handle);
@@ -1252,7 +1342,8 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1252
1342
  status: r.value.status,
1253
1343
  exitCode: r.value.exitCode,
1254
1344
  replay: INCREMENT_REPLAY,
1255
- bytesDroppedBeforeCursor: dropAcct.droppedBytes ?? 0,
1345
+ bytesDroppedBeforeCursor: 0,
1346
+ ...dropFactsOf(dropAcct),
1256
1347
  ...(r.value.timedOut === true ? { timedOut: true, ...(r.value.timeoutSec !== undefined ? { timeoutSec: r.value.timeoutSec } : {}) } : {}),
1257
1348
  },
1258
1349
  },
@@ -1290,7 +1381,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1290
1381
  if (handle.stoppedBy === undefined)
1291
1382
  handle.stoppedBy = handle.stopSource ?? "parent";
1292
1383
  handle.status = "killed";
1293
- handle.updatedAt = Date.now();
1384
+ stampActivity(handle);
1294
1385
  mintCompletionId(handle);
1295
1386
  this.notifyTerminalOnce(handle, () => explicitStopBashTerminalNote(handle, true));
1296
1387
  return {
@@ -1310,7 +1401,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1310
1401
  this.startBashWatcher(handle.id, handle.onTerminal);
1311
1402
  const retrieval_status = r.error.code === "timeout" ? "timeout" : "not_ready";
1312
1403
  return {
1313
- content: `Error (TaskStop): ${r.error.message} — the kill did not land; the process may still be running.` +
1404
+ content: `Error (TaskStop): ${envErrorDetail(r.error.message)} — the kill did not land; the process may still be running.` +
1314
1405
  (restored ? " Its watcher keeps running: its output file keeps filling and the completion notification will still fire." : " It has no watcher, so no completion notification will follow."),
1315
1406
  details: { task_id: handle.id, type: "background_bash", status: handle.status, retrieval_status, error: r.error.code },
1316
1407
  isError: true,
@@ -1319,7 +1410,7 @@ The durable record is still marked running (last update ${new Date(row.updatedAt
1319
1410
  if (handle.stoppedBy === undefined)
1320
1411
  handle.stoppedBy = handle.stopSource ?? "parent";
1321
1412
  handle.status = "killed";
1322
- handle.updatedAt = Date.now();
1413
+ stampActivity(handle);
1323
1414
  mintCompletionId(handle);
1324
1415
  await drainBashTailBestEffort(handle);
1325
1416
  this.notifyTerminalOnce(handle, () => explicitStopBashTerminalNote(handle, false));
@@ -1363,7 +1454,7 @@ export function createTaskStopTool(opts) {
1363
1454
  const id = resolveTaskIdArg(args.task_id, args.shell_id);
1364
1455
  if (!id)
1365
1456
  return errorResult(TASK_STOP_MISSING_ID_MESSAGE);
1366
- const r = await opts.registry.stopTask(id, { owner: ctx.taskId ?? opts.owner, scope: ctx.principal ?? opts.scope, ...((ctx.sessionId ?? opts.sessionId) !== undefined ? { sessionId: ctx.sessionId ?? opts.sessionId } : {}) }, { workflowStore: opts.workflowStore, agentStore: opts.agentStore });
1457
+ const r = await opts.registry.stopTask(id, { owner: ctx.taskId ?? opts.owner, scope: callScopeOf(ctx, opts), ...((ctx.sessionId ?? opts.sessionId) !== undefined ? { sessionId: ctx.sessionId ?? opts.sessionId } : {}) }, { workflowStore: opts.workflowStore, agentStore: opts.agentStore });
1367
1458
  const { type: taskType, ...rest } = r.details;
1368
1459
  return {
1369
1460
  content: r.content,