@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
@@ -1,7 +1,9 @@
1
1
  import { delimitUntrusted } from "./untrusted-text.js";
2
2
  import { envDeclaresRetain, retainsBackgroundProcesses } from "./background-shell.js";
3
- import { assertOwnership, defaultMonitorTimers, MONITOR_MAX_TIMEOUT_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_BATCH_WINDOW_MS, MONITOR_MAX_BATCHES_PER_MINUTE, MONITOR_STORM_BURST, MONITOR_STORM_KILL_AFTER_MS, MONITOR_LINE_BUF_CAP, TASK_OUTPUT_MAX_CHARS, mintCompletionId, clipMonitorEvent, clipMonitorLine, terminalTaskSummary, accountDroppedBytes, renderSpoolBody, SPOOL_REPLAY, rollSpoolText, statusFromBackground, droppedGapNote, firstDropNote, alreadyTerminalStopNote, clipTaskOutput, sleepPollStep, } from "./task-registry-shared.js";
3
+ import { mintCompletionId } from "./completion-id.js";
4
+ import { assertOwnership, defaultMonitorTimers, MONITOR_MAX_TIMEOUT_MS, MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_BATCH_WINDOW_MS, MONITOR_MAX_BATCHES_PER_MINUTE, MONITOR_STORM_BURST, MONITOR_STORM_KILL_AFTER_MS, MONITOR_LINE_BUF_CAP, TASK_OUTPUT_MAX_CHARS, clipMonitorEvent, clipMonitorLine, terminalTaskSummary, accountDroppedBytes, dropFactsOf, renderSpoolBody, SPOOL_REPLAY, rollSpoolText, statusFromBackground, droppedGapNote, firstDropNote, alreadyTerminalStopNote, clipTaskOutput, sleepPollStep, activityStamp, stampActivity, } from "./task-registry-shared.js";
4
5
  import { thrownText } from "./thrown-value.js";
6
+ import { envErrorDetail } from "../tools/fs/env-error-detail.js";
5
7
  export function registerMonitorLane(core, input) {
6
8
  assertOwnership(input, "registerMonitor");
7
9
  const id = core.mintTaskId("monitor");
@@ -24,7 +26,7 @@ export function registerMonitorLane(core, input) {
24
26
  ...(persistent ? { persistent: true } : {}),
25
27
  ...(input.sessionScoped ? { sessionScoped: true } : {}),
26
28
  createdAt: now,
27
- updatedAt: now,
29
+ ...activityStamp(now),
28
30
  env: input.env,
29
31
  shellId: input.shellId,
30
32
  spool: { stdout: "", stderr: "", rolledChars: 0 },
@@ -119,7 +121,7 @@ export function startMonitorWatcherLane(core, id) {
119
121
  };
120
122
  const pendingSuppressionNote = () => consumePendingSuppressionNote(handle);
121
123
  const terminal = (status, detail, finalLines, exitCode) => {
122
- handle.updatedAt = Date.now();
124
+ stampActivity(handle);
123
125
  mintCompletionId(handle);
124
126
  stop();
125
127
  core.notifyTerminalOnce(handle, () => emit({
@@ -151,7 +153,7 @@ export function startMonitorWatcherLane(core, id) {
151
153
  if ((r.error.code === "timeout" || r.error.code === "io") && ++pollFailures <= MAX_RETRYABLE_POLL_FAILURES)
152
154
  return;
153
155
  handle.status = "failed";
154
- return terminal("failed", `monitor lost its process (${r.error.message}); watch ended.${pendingSuppressionNote()}`, pendingFinalLines([]));
156
+ return terminal("failed", `monitor lost its process (${envErrorDetail(r.error.message)}); watch ended.${pendingSuppressionNote()}`, pendingFinalLines([]));
155
157
  }
156
158
  pollFailures = 0;
157
159
  const mirrored = mirrorMonitorPollLane(handle, r.value);
@@ -187,7 +189,7 @@ export function startMonitorWatcherLane(core, id) {
187
189
  return stop();
188
190
  if (!k.ok && k.error.code !== "not_found") {
189
191
  handle.status = "failed";
190
- return terminal("failed", `timed out after ${handle.timeoutMs}ms, but the kill failed (${k.error.message}); the process may still be running. Watch ended.${pendingSuppressionNote()}`, pendingFinalLines(lines));
192
+ return terminal("failed", `timed out after ${handle.timeoutMs}ms, but the kill failed (${envErrorDetail(k.error.message)}); the process may still be running. Watch ended.${pendingSuppressionNote()}`, pendingFinalLines(lines));
191
193
  }
192
194
  handle.status = "killed";
193
195
  handle.stoppedBy = handle.stopSource ?? "timeout";
@@ -195,7 +197,7 @@ export function startMonitorWatcherLane(core, id) {
195
197
  }
196
198
  if (lines.length === 0) {
197
199
  if (r.value.stdout.length > 0 || r.value.stderr.length > 0)
198
- handle.updatedAt = Date.now();
200
+ stampActivity(handle);
199
201
  return;
200
202
  }
201
203
  if (!consumeStormToken(handle, now)) {
@@ -208,7 +210,7 @@ export function startMonitorWatcherLane(core, id) {
208
210
  else {
209
211
  handle.overloadSince ??= now;
210
212
  }
211
- handle.updatedAt = Date.now();
213
+ stampActivity(handle);
212
214
  if (now - handle.overloadSince <= MONITOR_STORM_KILL_AFTER_MS)
213
215
  return;
214
216
  const suppressed = handle.suppressedBatches;
@@ -219,7 +221,7 @@ export function startMonitorWatcherLane(core, id) {
219
221
  return stop();
220
222
  if (!k.ok && k.error.code !== "not_found") {
221
223
  handle.status = "failed";
222
- return terminal("failed", `auto-stop triggered (${suppressed} event batch(es) suppressed over ${overloadSecs}s of sustained overload), but the kill failed (${k.error.message}); the process may still be running. Watch ended.`, pendingFinalLines(lines));
224
+ return terminal("failed", `auto-stop triggered (${suppressed} event batch(es) suppressed over ${overloadSecs}s of sustained overload), but the kill failed (${envErrorDetail(k.error.message)}); the process may still be running. Watch ended.`, pendingFinalLines(lines));
223
225
  }
224
226
  handle.status = "killed";
225
227
  handle.stoppedBy = handle.stopSource ?? "system";
@@ -244,7 +246,7 @@ export function startMonitorWatcherLane(core, id) {
244
246
  });
245
247
  }
246
248
  handle.seq += 1;
247
- handle.updatedAt = Date.now();
249
+ stampActivity(handle);
248
250
  const shown = lines.map(clipMonitorLine);
249
251
  emit({
250
252
  task_id: id,
@@ -312,7 +314,7 @@ export async function pollMonitorLane(handle, filter, deadline, signal) {
312
314
  status: running ? "running" : handle.status,
313
315
  exitCode: spool.exitCode,
314
316
  replay: SPOOL_REPLAY,
315
- ...(spool.droppedBytes !== undefined ? { bytesDroppedBeforeCursor: spool.droppedBytes } : {}),
317
+ ...dropFactsOf(spool),
316
318
  ...(spool.timedOut === true ? { timedOut: true, ...(spool.timeoutSec !== undefined ? { timeoutSec: spool.timeoutSec } : {}) } : {}),
317
319
  },
318
320
  },
@@ -365,7 +367,7 @@ export async function stopMonitorLane(core, handle) {
365
367
  handle.lineBuf = "";
366
368
  if (finalLines.length > 0 && handle.status === "running") {
367
369
  handle.seq += 1;
368
- handle.updatedAt = Date.now();
370
+ stampActivity(handle);
369
371
  emitMonitorEventLane(handle, {
370
372
  task_id: handle.id,
371
373
  task_type: "monitor",
@@ -410,7 +412,7 @@ export async function stopMonitorLane(core, handle) {
410
412
  if (handle.stoppedBy === undefined)
411
413
  handle.stoppedBy = handle.stopSource ?? "parent";
412
414
  handle.status = "killed";
413
- handle.updatedAt = Date.now();
415
+ stampActivity(handle);
414
416
  mintCompletionId(handle);
415
417
  core.notifyTerminalOnce(handle, () => explicitStopTerminalNote(handle, true));
416
418
  return {
@@ -429,7 +431,7 @@ export async function stopMonitorLane(core, handle) {
429
431
  startMonitorWatcherLane(core, handle.id);
430
432
  const retrieval_status = r.error.code === "timeout" ? "timeout" : "not_ready";
431
433
  return {
432
- content: `Error (TaskStop): ${r.error.message} — the kill did not land; the process may still be running. The watch keeps running: events and the terminal notification still fire.`,
434
+ content: `Error (TaskStop): ${envErrorDetail(r.error.message)} — the kill did not land; the process may still be running. The watch keeps running: events and the terminal notification still fire.`,
433
435
  isError: true,
434
436
  details: { task_id: handle.id, type: "monitor", status: handle.status, retrieval_status, error: r.error.code },
435
437
  };
@@ -438,7 +440,7 @@ export async function stopMonitorLane(core, handle) {
438
440
  if (handle.stoppedBy === undefined)
439
441
  handle.stoppedBy = handle.stopSource ?? "parent";
440
442
  handle.status = "killed";
441
- handle.updatedAt = Date.now();
443
+ stampActivity(handle);
442
444
  mintCompletionId(handle);
443
445
  core.notifyTerminalOnce(handle, () => explicitStopTerminalNote(handle, false));
444
446
  }
@@ -17,7 +17,8 @@ export type SemaTaskType = "background_bash" | "workflow" | "background_agent" |
17
17
  * task-notification.ts `TaskNotificationPayload.stoppedBy`. */
18
18
  export type StopSource = "user" | "parent" | "system" | (string & {});
19
19
  /** design/153 §7.1: `"parked"` (background agents only today) = durably suspended on a pending
20
- * approval checkpoint — neither live nor terminal. Every `=== "running"` liveness check treats it
20
+ * checkpoint (any gate — a person's approval, or a resource limit such as a scheduler's yield; the gate is the
21
+ * checkpoint's, never the row's) — neither live nor terminal. Every `=== "running"` liveness check treats it
21
22
  * as not-running (correct: no process exists); it exits poll waits, refuses settles, and is
22
23
  * reap-exempt. Downstream switches over this union gain an arm (announced). */
23
24
  export type SemaTaskStatus = "pending" | "running" | "parked" | "completed" | "failed" | "killed" | "cancelled";
@@ -68,12 +69,13 @@ export interface UnifiedTaskOutput {
68
69
  * this poll projection) — a consumer today has to reconstruct "are these the same completion?" from
69
70
  * weaker signals (task_id + status + timing). Minted ONCE per completion, fill-once (first writer
70
71
  * wins) on the handle/record the completion is settled onto, so every read face — this poll
71
- * projection, the notification payload, and (for background_agent) the cross-restart durable
72
- * fallback row — serves the exact same value. Open-shape `string` (a uuidv7 in this implementation,
72
+ * projection, the notification payload, both registry listings (`TaskListRow`, and for background_agent the
73
+ * durable `BackgroundAgentRowSummary`), and the cross-restart durable fallback row — serves the exact same
74
+ * value. Open-shape `string` (a uuidv7 in this implementation,
73
75
  * not contractually required to stay one); absent when the underlying task hasn't reached a terminal
74
76
  * settle yet, or on a pre-P1-3 core build that never minted one. */
75
77
  completionId?: string;
76
- /** A background agent's current state (status word, last activity, the approval card a parked row
78
+ /** A background agent's current state (status word, last activity, the park card a parked row
77
79
  * waits on) — {@link import("./agent-state.js").readAgentState}, the one reading AgentTranscript and
78
80
  * ListAgents render too. Present on every background_agent POLL answer that resolved a row (live,
79
81
  * durable terminal, durable parked, durable still-running); absent on other lanes, on not-found, and on
@@ -97,6 +99,27 @@ export type UnifiedTaskResult = {
97
99
  details: UnifiedTaskOutput;
98
100
  isError?: boolean;
99
101
  };
102
+ /** The process-monotonic clock a row's activity is measured on (`performance.now()`, milliseconds): it never steps back and does not
103
+ * jump with the wall clock. The one reading of it for the task rows — a stamp, a silence test and a test's injected instant all
104
+ * name this clock. */
105
+ export declare function monotonicNow(): number;
106
+ /** How far past this process's monotonic clock an injected activity instant may read. A beat is stamped at the instant its caller
107
+ * read the clock, which is never after the reader's own read; the slack is the one tolerance a reading is allowed. */
108
+ export declare const ACTIVITY_INSTANT_SLACK_MS = 1000;
109
+ /** Is `at` a reading of this process's monotonic clock a beat may carry: a finite number of milliseconds from 0 to the clock's
110
+ * own now (plus {@link ACTIVITY_INSTANT_SLACK_MS}). The one judge of an injected activity instant — a negative or a far-future
111
+ * value would otherwise be written as the row's stamp (a future one is never past the silence threshold again). */
112
+ export declare function isActivityInstant(at: unknown, now?: number): at is number;
113
+ /** The two activity facts of a row as a pair, for a row being BORN (an object literal cannot call {@link stampActivity}): the wall
114
+ * instant given (default now) and the monotonic one now. */
115
+ export declare function activityStamp(wall?: number): {
116
+ readonly updatedAt: number;
117
+ readonly lastActivityMono: number;
118
+ };
119
+ /** THE bump of a row's activity: `updatedAt` and `lastActivityMono` move together, here and nowhere else (both are `readonly` on the
120
+ * handle, so a direct write is a compile error). The monotonic fact never goes back: it is the later of what the row holds and
121
+ * the instant given. */
122
+ export declare function stampActivity(handle: SemaTaskHandle, wall?: number, mono?: number): void;
100
123
  export interface SemaTaskHandle {
101
124
  id: string;
102
125
  type: SemaTaskType;
@@ -106,13 +129,19 @@ export interface SemaTaskHandle {
106
129
  scope?: string;
107
130
  toolUseId?: string;
108
131
  createdAt: number;
109
- updatedAt: number;
132
+ /** The wall-clock instant of the row's last activity — a DISPLAY / audit fact (a clock that jumps, or a machine that slept, moves it
133
+ * with it). Written only by {@link stampActivity} / {@link activityStamp}, beside {@link SemaTaskHandle.lastActivityMono}. */
134
+ readonly updatedAt: number;
135
+ /** The SAME instant on the process-monotonic clock ({@link monotonicNow}): how long a row has been silent is measured here, so a
136
+ * wall-clock step or a sleep does not read as silence (or hide it). Meaningful only against this process's `monotonicNow()`;
137
+ * never persisted, never compared across processes. Written only beside `updatedAt`, by the one stamp. */
138
+ readonly lastActivityMono: number;
110
139
  outputFile?: string;
111
140
  /** The ref a background agent's or workflow's full result was stored under when its completion frame cut it
112
141
  * (`persistTaskArtifact`, recorded by {@link import("./task-registry.js").TaskRegistry.recordArtifactRef}). */
113
142
  artifactRef?: string;
114
143
  /** P1-3 — see {@link UnifiedTaskOutput.completionId}. Minted fill-once at this task's own settle
115
- * point ({@link mintCompletionId}); absent until the task reaches a terminal status. */
144
+ * point ({@link import("./completion-id.js").mintCompletionId}); absent until the task reaches a terminal status. */
116
145
  completionId?: string;
117
146
  }
118
147
  /** THE read handle of one background task, as every model-facing list of tasks names it: a command's output file
@@ -120,17 +149,6 @@ export interface SemaTaskHandle {
120
149
  * notification carried. One reading — the post-compaction table and a dropped-notification line both call it. A
121
150
  * blank path or ref (empty or all whitespace) names nothing, so it reads as no handle. */
122
151
  export declare function taskReadHandleText(h: Pick<SemaTaskHandle, "outputFile" | "artifactRef">): string | undefined;
123
- /** Mint a cross-channel completion correlation id ONCE per
124
- * handle/record, fill-once (first writer wins): every settle/direct-terminal-flip site calls this
125
- * instead of writing `completionId` directly, so no matter how many terminal-transition sites a lane
126
- * has (settle / TaskStop circumvention / backfill), the value is minted exactly once and every later caller
127
- * (including an idempotent re-call from a circumvention path that already ran) gets back the SAME id. `string`
128
- * is intentionally loose (any object with an optional `completionId` field) so the same helper serves
129
- * both a `RegisteredTaskHandle` and a `WorkflowRun` (orchestration/workflow.ts — a different module,
130
- * no shared base type, same fill-once shape). */
131
- export declare function mintCompletionId(target: {
132
- completionId?: string;
133
- }): string;
134
152
  export interface TaskAccess {
135
153
  owner?: string;
136
154
  scope?: string;
@@ -226,6 +244,8 @@ export interface WorkflowTaskHandle extends SemaTaskHandle {
226
244
  * session end — a would-be regression caught by cross-review before this shipped (see docs/
227
245
  * REVIEW-BACKLOG.md's "RB-215 复核" entry for the full incident). */
228
246
  sessionScoped?: true;
247
+ /** The run's yield intent — see {@link RegisterWorkflowInput.yieldIntent}. Absent ⇒ the run cannot park its legs. */
248
+ yieldIntent?: AbortController;
229
249
  /** The bounded return value, captured on the done-hook so the STORE-LESS in-memory lane's
230
250
  * terminal poll can hand it over too (the launch note promises it; without a store there was no result). */
231
251
  result?: string;
@@ -307,7 +327,22 @@ export interface BackgroundAgentTaskHandle extends SemaTaskHandle {
307
327
  * revive cycles identically whichever arm answered. Re-aligned to the settle's authoritative
308
328
  * `outcome.seq` at settle time (the ledger's cycleSeq is the mint; this is its projection). */
309
329
  cycleSeq?: number;
310
- /** design/153 §7.1 — the approval checkpoint this handle is parked on (`status:"parked"` only). */
330
+ /** The yield seat (see {@link RegisterBackgroundAgentInput.yieldLane} and {@link TaskRegistry.yieldBackground}): what the
331
+ * spawner can park (`lane`), the RUNNING leg's own yield controller and its readiness as its prepare reported them (`leg`,
332
+ * replaced by every leg — a revival or a parked-resume drive reports its own), and the one intent bit (`requested`, with
333
+ * what the requester does to work that cannot yield). The intent outlives a leg: a leg that reports after it was set is
334
+ * handed the yield at that report. */
335
+ yieldSeat: {
336
+ readonly lane: BackgroundYieldLane;
337
+ leg?: {
338
+ readonly controller: AbortController;
339
+ readonly ready: boolean;
340
+ };
341
+ requested?: {
342
+ readonly stopUnyieldable?: StopSource;
343
+ };
344
+ };
345
+ /** The checkpoint this handle is parked on (`status:"parked"` only; any gate). */
311
346
  parkedCheckpointToken?: string;
312
347
  /** design/153 §7.1 — in-process TaskStop arbitration closure, minted by the parking watcher
313
348
  * (captures the checkpoint store + token; the registry itself holds no durable stores — r4 F-06).
@@ -561,6 +596,11 @@ export interface RegisterWorkflowInput extends TaskAccess {
561
596
  * (its completion notification routes to the session) — deliberately unlike a background agent's
562
597
  * live handle, whose sibling-turn invisibility is a channel-discipline ruling (§3.1c). */
563
598
  originatingSessionId?: string;
599
+ /** The run's yield intent: the controller whose signal the run was started with as its
600
+ * `RunWorkflowOptions.preemptSignal` — present exactly when the run can park its legs (its park lane is armed). A
601
+ * whole-registry {@link TaskRegistry.yieldBackground} aborts it: each leg in flight parks at its own next clean
602
+ * boundary and the run suspends on its parks. ABSENT ⇒ the run cannot yield (`no_park_lane`). */
603
+ yieldIntent?: AbortController;
564
604
  }
565
605
  /** T2A-7 (2026-07-05 soak): one blocked-poll step, CLAMPED to the caller's deadline — a small timeoutMs
566
606
  * (e.g. 10ms) must not sleep the full 400ms step (~40× overshoot, and the overshoot window even served a
@@ -638,11 +678,27 @@ export declare function accountDroppedBytes(spool: {
638
678
  truncated?: boolean;
639
679
  bytesDroppedBeforeCursor?: number;
640
680
  }): void;
681
+ /** The machine-face reading of a drop account — the ONE place that decides which loss facts exist, read by every
682
+ * face that tells it: the `details` members, the poll banner ({@link spoolDropNote}) and the event-frame suffix
683
+ * ({@link droppedGapNote}). Two independent facts, because the account holds two independent things:
684
+ * - `bytesDroppedBeforeCursor` — bytes the env COUNTED as evicted (a lower bound when `dropUnknown` is also set);
685
+ * - `dropUnknown: true` — an eviction the env disclosed WITHOUT a figure: an amount nobody can count was lost.
686
+ * A run can hold both (a counted poll, then one that said only `truncated`), which is why this is two members and
687
+ * not one value: `number | "unknown"` cannot say "at least N, and more". Absence of a member is a fact: no
688
+ * counted loss / nothing uncounted. */
689
+ export declare function dropFactsOf(acct: {
690
+ droppedBytes?: number;
691
+ dropUnknown?: true;
692
+ }): {
693
+ bytesDroppedBeforeCursor?: number;
694
+ dropUnknown?: true;
695
+ };
641
696
  /** The POLL-FACE wording for env-side loss (the terminal/event-frame wording is
642
- * {@link droppedGapNote}'s; the two faces differ by design and always have). One function so the two
643
- * quantified/unquantified branches cannot drift between the three legs that render it: the monitor
644
- * re-readable spool, the bash re-readable spool, and the bash blocked wait. Trailing newline included
645
- * (it is a banner LINE above the stdout heading); "" when nothing was dropped. */
697
+ * {@link droppedGapNote}'s; the two faces differ by design and always have). One function so the
698
+ * quantified/unquantified/both branches cannot drift between the legs that render it: the monitor
699
+ * re-readable spool, the bash re-readable spool, and the bash blocked wait (including its poll-error
700
+ * salvage). Trailing newline included (it is a banner LINE above the stdout heading); "" when nothing was
701
+ * dropped. Reads {@link dropFactsOf}, the same facts the `details` members come from. */
646
702
  export declare function spoolDropNote(acct: {
647
703
  droppedBytes?: number;
648
704
  dropUnknown?: true;
@@ -796,6 +852,8 @@ export interface RegistryCore {
796
852
  markStopSource(id: string, source: StopSource): void;
797
853
  notifyTerminalOnce(handle: BackgroundBashTaskHandle | MonitorTaskHandle | BackgroundAgentTaskHandle, send: () => void): void;
798
854
  pokeBgQuiescence(owner: string | undefined): void;
855
+ /** Re-run every pending yield `drained()` check (a transition that is not an agent's — a workflow run's end). */
856
+ pokeYieldDrains(): void;
799
857
  }
800
858
  /** writer-lease renewal period for armed durable rows (see ensureDurableHeartbeat).
801
859
  * Exported so deployments size `staleRunningMaxAgeMs` against it (recommend ≥10× this). */
@@ -852,6 +910,16 @@ export declare function normalizeAgentName(s: string): string;
852
910
  * class cli/server just swept. Registration now REQUIRES both axes ({@link assertOwnership}), so a
853
911
  * missing axis here is a broken invariant, answered with denial, never a pass. */
854
912
  export declare function canAccess(handle: SemaTaskHandle, access: TaskAccess): boolean;
913
+ /** THE row judgement of "a session-scoped background agent whose child run is in flight": a `background_agent` row that is
914
+ * `running` and carries the explicit `sessionScoped` flag (never inferred from an owner key's shape). Three readers walk it — the
915
+ * session-release reap, the stall reap and the count of such rows — so none of them can differ from the others about which
916
+ * rows are session-resident agents. `parked` is a wait on a person, not a run in flight, and a settled row holds no run. No
917
+ * writer gives an agent row another live word (a registration is born `running`, or `parked` for a parked-resume handoff), so
918
+ * `pending` is not part of the reading. Reads three of the registry's own row fields: it cannot throw. */
919
+ export declare function isLiveSessionResidentAgent(handle: RegisteredTaskHandle): handle is BackgroundAgentTaskHandle & {
920
+ status: "running";
921
+ sessionScoped: true;
922
+ };
855
923
  /** design/157 B13 二期(B13 档预调研 §4.2/§4.3 定稿)— the durable-agent lane's widened core seam.
856
924
  * Extends {@link RegistryCore} with the extra members the AGENT lane's `this.*` census reached
857
925
  * (73 处/9 成员,扣车道内互调后落在 5 个上,见 B13 档「二期细察补充」;`reapedHandles` 是后加的
@@ -887,19 +955,85 @@ export interface ParkedClaimTicket {
887
955
  reservedRev: number;
888
956
  row: import("./background-agent-store.js").BackgroundAgentRecord;
889
957
  }
890
- /** Sibling of {@link mintCompletionId} for a caller that must compute the
891
- * value BEFORE it is safe to commit (a CAS not yet known to win): fill-once with an EXTERNALLY-chosen
892
- * value instead of generating a fresh one. Exists because `rollbackParkedClaim`'s original fix minted
893
- * directly onto the live handle before its durable CAS was confirmed — a losing CAS then left a
894
- * non-terminal ("parked") handle carrying a completionId nothing ever cleared, which a later legitimate
895
- * parked→running flip (`consumeParkedFlip`) silently carried into an unrelated real completion via
896
- * `mintCompletionId`'s own fill-once guard (independently reproduced end-to-end). The fix: compute the
897
- * candidate once, use it in the durable payload immediately (that write is fine — it only takes effect
898
- * if its own CAS wins), and commit it to the live handle ONLY from the call that already knows the CAS
899
- * won. */
900
- export declare function commitCompletionIdIfEmpty(target: {
901
- completionId?: string;
902
- }, value: string): string;
958
+ /**
959
+ * How a parked-resume reservation ENDED when its drive did not run to a result — the word
960
+ * {@link TaskRegistry.rollbackParkedClaim} answers and the one a drive reports. One word, one meaning:
961
+ *
962
+ * `rolled_back` = the reservation was cleared while the checkpoint read pending, and the park stands: the same approval
963
+ * may be redeemed again (a check read after the clear that fails keeps this word; see KNOWN-LIMITS). `failed` = the
964
+ * cycle ended on this attempt: the approval is no longer redeemable (its checkpoint expired or is gone, or it was
965
+ * resolved), and this attempt carries the cycle's terminal. `lost` = another transition owns the row (a newer claim,
966
+ * an earlier rollback, a stop or the stale-claim sweep): that transition, not this attempt, speaks for the cycle.
967
+ * `retry` = the rollback could not complete against the stores (a read failed, or a write's outcome is unknown): the
968
+ * ending is not known, and a reservation that still stands is cleared by the stale-claim sweep.
969
+ *
970
+ * A drive that already resolved the approval's checkpoint reports `failed` whatever the registry or its own row flip
971
+ * answered: past the resolve, the registry's `lost` names the drive's own resolve, not another owner.
972
+ */
973
+ export declare const PARKED_CLAIM_ROLLBACKS: readonly ["rolled_back", "failed", "lost", "retry"];
974
+ export type ParkedClaimRollback = (typeof PARKED_CLAIM_ROLLBACKS)[number];
975
+ /**
976
+ * The ONE table a drive's ending is read through: whether the attempt carries the cycle's terminal (frame and
977
+ * completion) and the sentence the attempt's failure opens with. A row per ending; the drive branches on no word
978
+ * outside it.
979
+ */
980
+ export declare const PARKED_CLAIM_ROLLBACK_FACE: {
981
+ readonly rolled_back: {
982
+ readonly carriesTerminal: false;
983
+ readonly lead: "parked resume rolled back — the approval is still pending (retryable)";
984
+ };
985
+ readonly failed: {
986
+ readonly carriesTerminal: true;
987
+ readonly lead: "parked resume failed — the approval is no longer redeemable";
988
+ };
989
+ readonly lost: {
990
+ readonly carriesTerminal: false;
991
+ readonly lead: "parked resume did not proceed — another transition owns this row and speaks for its cycle";
992
+ };
993
+ readonly retry: {
994
+ readonly carriesTerminal: false;
995
+ readonly lead: "parked resume did not proceed — its rollback could not complete against the stores (a reservation that still stands is cleared by the stale-claim sweep)";
996
+ };
997
+ };
998
+ export type ParkedClaimRollbackFaceCoversEveryEnding = AssertAllKeysHandled<Exclude<ParkedClaimRollback, keyof typeof PARKED_CLAIM_ROLLBACK_FACE>>;
999
+ /**
1000
+ * Why a yield cannot park a background agent or a workflow run: the spawner cannot hold its park (`no_park_lane` — no durable
1001
+ * row store, checkpoint store or session-durability capability; for a workflow run, no run store and checkpoint store;
1002
+ * `fork_child` — a fork child never parks), or the running leg
1003
+ * reported that it cannot suspend durably (`leg_not_ready` — its manifest's `suspendLane` is not ready).
1004
+ */
1005
+ export type BackgroundUnyieldableReason = "no_park_lane" | "fork_child" | "leg_not_ready";
1006
+ /** What a spawner can do with a yield of its agent, known at spawn ({@link RegisterBackgroundAgentInput.yieldLane}). */
1007
+ export type BackgroundYieldLane = "parkable" | "no_park_lane" | "fork_child";
1008
+ /** How a {@link TaskRegistry.yieldBackground} request treats the work it covers. */
1009
+ export interface BackgroundYieldOptions {
1010
+ /** Skip session-scoped agents (they outlive the request's owner — a parked leg's own end never reaches them). */
1011
+ readonly skipSessionScoped?: boolean;
1012
+ /** Stop the work that cannot yield, recorded as stopped by this source, instead of leaving it running — now, or when its
1013
+ * leg reports later that it cannot suspend. Absent ⇒ such work keeps running (a yield is a request, not a stop) and its
1014
+ * own leg says why, once, when it reaches a boundary. */
1015
+ readonly stopUnyieldable?: StopSource;
1016
+ }
1017
+ /** The receipt of one yield request: what it handed a yield, what it could not, and when it is over. */
1018
+ export interface BackgroundYieldReport {
1019
+ /** The running agents and workflow runs handed the yield: each agent parks at its own next clean turn boundary, each
1020
+ * run's legs at theirs (the run then suspends on its parks). */
1021
+ readonly yielding: readonly string[];
1022
+ /** The running agents and workflow runs that cannot yield, each with why (stopped when the request said so, else still
1023
+ * running; a workflow run's only reason is `no_park_lane`). */
1024
+ readonly notYieldable: ReadonlyArray<{
1025
+ readonly id: string;
1026
+ readonly reason: BackgroundUnyieldableReason;
1027
+ }>;
1028
+ /** Resolves once EVERY agent and workflow run the request covered — both lists, plus any that joined a whole-registry
1029
+ * request before this resolves — has left `running` AND its queued durable row writes have settled (a parked row with
1030
+ * its token, or a terminal row; a workflow run leaves `running` when it ends, after its terminal record write). `unpersisted` names the agents whose latest write did not land (the store refused it through every
1031
+ * retry; the heartbeat keeps re-driving it): until it lands their rows read their previous state, so a process that
1032
+ * exits now leaves those behind. Empty ⇔ every covered row is written. Never rejects. */
1033
+ drained(): Promise<{
1034
+ readonly unpersisted: readonly string[];
1035
+ }>;
1036
+ }
903
1037
  export interface RegisterBackgroundAgentInput extends TaskAccess {
904
1038
  /** The spawning tree's cross-boundary token (`RunInternals.crossBoundaryTree`, the tree the child joins): a poll of this handle
905
1039
  * from a leg of the SAME tree moves nothing across the device boundary — the child's bits are already in that tree. */
@@ -952,6 +1086,9 @@ export interface RegisterBackgroundAgentInput extends TaskAccess {
952
1086
  * persisted on the durable row beside the anchor (`BackgroundAgentRecord.rootSessionIncarnation`), so a revival addresses
953
1087
  * its subtree's escalations to the occupant the tree was born under. Written only together with {@link rootSessionId}. */
954
1088
  rootSessionIncarnation?: string;
1089
+ /** The scope the root's durable box mounts in (the spawner's `ctx.rootSessionScope`), persisted beside the anchor
1090
+ * (`BackgroundAgentRecord.rootSessionScope`). Written only together with {@link rootSessionId}. */
1091
+ rootSessionScope?: string;
955
1092
  /** design/151 S3b — the revival lookup key (CC meta-sidecar shape): the model RECORD KEY,
956
1093
  * persisted on the durable row so a tier-3 revival rebuilds the spec the way a fresh
957
1094
  * named-teammate spawn would. A lookup key only, never a serialized spec. `model` is NOT the
@@ -968,6 +1105,11 @@ export interface RegisterBackgroundAgentInput extends TaskAccess {
968
1105
  toolUseId?: string;
969
1106
  abort: AbortController;
970
1107
  now?: number;
1108
+ /** Whether a yield ({@link TaskRegistry.yieldBackground}) can park this agent's legs — the SPAWNER's answer, known at
1109
+ * spawn: `"parkable"` when it can hold the agent's park (a durable row store, a checkpoint store, the session-durability
1110
+ * capability) and hands every leg a yield signal; otherwise why not. ABSENT reads as `"no_park_lane"`: a registration
1111
+ * that does not say it can park a leg never had one handed to it. */
1112
+ yieldLane?: BackgroundYieldLane;
971
1113
  /** design/129: register as session-scoped (owner MUST be the sessionId; see the handle flag). */
972
1114
  sessionScoped?: true;
973
1115
  /** design/151 S1a (LOW-12): caller-supplied handle — the tier-3 revival leg (S3) re-registers the
@@ -1,9 +1,21 @@
1
- import { uuidv7 } from "../internal/harness.js";
2
1
  import { summarizeWorkflowRun } from "./workflow-run-store.js";
3
2
  import { delimitUntrusted } from "./untrusted-text.js";
4
3
  import { boundedRedactedSummary } from "./untrusted-egress.js";
5
4
  import { clipWithFilePointer, OUTPUT_BUDGET_MIN_CHARS } from "./tool-errors.js";
6
5
  import { resolveEnvBudget } from "./env-budget.js";
6
+ export function monotonicNow() {
7
+ return performance.now();
8
+ }
9
+ export const ACTIVITY_INSTANT_SLACK_MS = 1_000;
10
+ export function isActivityInstant(at, now = monotonicNow()) {
11
+ return typeof at === "number" && Number.isFinite(at) && at >= 0 && at <= now + ACTIVITY_INSTANT_SLACK_MS;
12
+ }
13
+ export function activityStamp(wall = Date.now()) {
14
+ return { updatedAt: wall, lastActivityMono: monotonicNow() };
15
+ }
16
+ export function stampActivity(handle, wall = Date.now(), mono = monotonicNow()) {
17
+ Object.assign(handle, { updatedAt: wall, lastActivityMono: Math.max(handle.lastActivityMono, mono) });
18
+ }
7
19
  export function taskReadHandleText(h) {
8
20
  const file = namedHandle(h.outputFile);
9
21
  if (file !== undefined)
@@ -16,11 +28,6 @@ export function taskReadHandleText(h) {
16
28
  function namedHandle(value) {
17
29
  return value !== undefined && value.trim() !== "" ? value : undefined;
18
30
  }
19
- export function mintCompletionId(target) {
20
- if (target.completionId === undefined)
21
- target.completionId = uuidv7();
22
- return target.completionId;
23
- }
24
31
  export const defaultMonitorTimers = {
25
32
  setInterval: (fn, ms) => {
26
33
  const h = setInterval(() => void fn(), ms);
@@ -103,10 +110,20 @@ export function accountDroppedBytes(spool, poll) {
103
110
  else if (poll.truncated === true)
104
111
  spool.dropUnknown = true;
105
112
  }
113
+ export function dropFactsOf(acct) {
114
+ return {
115
+ ...((acct.droppedBytes ?? 0) > 0 ? { bytesDroppedBeforeCursor: acct.droppedBytes } : {}),
116
+ ...(acct.dropUnknown === true ? { dropUnknown: true } : {}),
117
+ };
118
+ }
106
119
  export function spoolDropNote(acct) {
107
- if ((acct.droppedBytes ?? 0) > 0)
108
- return `[!] ${acct.droppedBytes} earlier byte(s) permanently dropped before this window (8MB buffer evicted)\n`;
109
- if (acct.dropUnknown === true)
120
+ const facts = dropFactsOf(acct);
121
+ const n = facts.bytesDroppedBeforeCursor;
122
+ if (n !== undefined && facts.dropUnknown === true)
123
+ return `[!] at least ${n} earlier byte(s) permanently dropped before this window, and an unknown further amount (8MB buffer evicted)\n`;
124
+ if (n !== undefined)
125
+ return `[!] ${n} earlier byte(s) permanently dropped before this window (8MB buffer evicted)\n`;
126
+ if (facts.dropUnknown === true)
110
127
  return "[!] an unknown amount of earlier output was permanently dropped before this window (buffer evicted)\n";
111
128
  return "";
112
129
  }
@@ -131,10 +148,15 @@ export function renderSpoolBody(spool, opts) {
131
148
  `--- ${REPLAY_FACE[SPOOL_REPLAY].stderr} ---\n${opts.shape(spool.stderr) || "(none)"}`);
132
149
  }
133
150
  export function droppedGapNote(spool) {
134
- if ((spool.droppedBytes ?? 0) > 0)
135
- return ` [!] ${spool.droppedBytes} earlier byte(s) of output were permanently dropped before this window (execution-environment tail buffer evicted) — the event stream and this spool are INCOMPLETE.`;
136
- if (spool.dropUnknown === true)
137
- return " [!] An unknown amount of earlier output was permanently dropped before this window (execution-environment tail buffer evicted) — the event stream and this spool are INCOMPLETE.";
151
+ const facts = dropFactsOf(spool);
152
+ const n = facts.bytesDroppedBeforeCursor;
153
+ const tail = "(execution-environment tail buffer evicted) — the event stream and this spool are INCOMPLETE.";
154
+ if (n !== undefined && facts.dropUnknown === true)
155
+ return ` [!] At least ${n} earlier byte(s) of output were permanently dropped before this window, and an unknown further amount ${tail}`;
156
+ if (n !== undefined)
157
+ return ` [!] ${n} earlier byte(s) of output were permanently dropped before this window ${tail}`;
158
+ if (facts.dropUnknown === true)
159
+ return ` [!] An unknown amount of earlier output was permanently dropped before this window ${tail}`;
138
160
  return "";
139
161
  }
140
162
  export function firstDropNote(spool) {
@@ -325,8 +347,13 @@ export function canAccess(handle, access) {
325
347
  return true;
326
348
  return false;
327
349
  }
328
- export function commitCompletionIdIfEmpty(target, value) {
329
- if (target.completionId === undefined)
330
- target.completionId = value;
331
- return target.completionId;
350
+ export function isLiveSessionResidentAgent(handle) {
351
+ return handle.type === "background_agent" && handle.status === "running" && handle.sessionScoped === true;
332
352
  }
353
+ export const PARKED_CLAIM_ROLLBACKS = Object.freeze(["rolled_back", "failed", "lost", "retry"]);
354
+ export const PARKED_CLAIM_ROLLBACK_FACE = {
355
+ rolled_back: { carriesTerminal: false, lead: "parked resume rolled back — the approval is still pending (retryable)" },
356
+ failed: { carriesTerminal: true, lead: "parked resume failed — the approval is no longer redeemable" },
357
+ lost: { carriesTerminal: false, lead: "parked resume did not proceed — another transition owns this row and speaks for its cycle" },
358
+ retry: { carriesTerminal: false, lead: "parked resume did not proceed — its rollback could not complete against the stores (a reservation that still stands is cleared by the stale-claim sweep)" },
359
+ };
@@ -2,7 +2,7 @@ import { boundedRedactedSummary } from "./untrusted-egress.js";
2
2
  import { delimitUntrusted } from "./untrusted-text.js";
3
3
  import { thrownText } from "./thrown-value.js";
4
4
  import { settledRunOf } from "./workflow-settled-run.js";
5
- import { assertOwnership, canAccessWorkflowRun, formatWorkflowRun, sleepPollStep, } from "./task-registry-shared.js";
5
+ import { assertOwnership, canAccessWorkflowRun, formatWorkflowRun, sleepPollStep, activityStamp, stampActivity, } from "./task-registry-shared.js";
6
6
  export function registerWorkflowLane(core, input) {
7
7
  assertOwnership(input, "registerWorkflow");
8
8
  const id = input.runId;
@@ -19,11 +19,12 @@ export function registerWorkflowLane(core, input) {
19
19
  ...(input.scope !== undefined ? { scope: input.scope } : {}),
20
20
  ...(input.toolUseId !== undefined ? { toolUseId: input.toolUseId } : {}),
21
21
  createdAt: now,
22
- updatedAt: now,
22
+ ...activityStamp(now),
23
23
  runId: id,
24
24
  handle: input.handle,
25
25
  ...(input.store !== undefined ? { store: input.store } : {}),
26
26
  ...(originatingSessionId !== undefined ? { originatingSessionId, sessionScoped: true } : {}),
27
+ ...(input.yieldIntent !== undefined ? { yieldIntent: input.yieldIntent } : {}),
27
28
  };
28
29
  core.handles.set(id, handle);
29
30
  void input.handle.done.then((res) => {
@@ -34,7 +35,8 @@ export function registerWorkflowLane(core, input) {
34
35
  handle.result = r;
35
36
  if (run?.completionId !== undefined)
36
37
  handle.completionId = run.completionId;
37
- handle.updatedAt = Date.now();
38
+ stampActivity(handle);
39
+ core.pokeYieldDrains();
38
40
  }, (err) => {
39
41
  if (handle.status !== "cancelled")
40
42
  handle.status = "failed";
@@ -43,7 +45,8 @@ export function registerWorkflowLane(core, input) {
43
45
  handle.error = boundedRedactedSummary(thrownText(err), 500);
44
46
  if (settleId !== undefined)
45
47
  handle.completionId = settleId;
46
- handle.updatedAt = Date.now();
48
+ stampActivity(handle);
49
+ core.pokeYieldDrains();
47
50
  });
48
51
  return id;
49
52
  }
@@ -112,7 +115,7 @@ export async function stopWorkflowLane(handle) {
112
115
  };
113
116
  }
114
117
  handle.status = "cancelled";
115
- handle.updatedAt = Date.now();
118
+ stampActivity(handle);
116
119
  handle.handle.cancel("TaskStop requested");
117
120
  return {
118
121
  content: JSON.stringify({
@@ -0,0 +1,32 @@
1
+ import type { BackgroundAgentTaskHandle, BackgroundUnyieldableReason, BackgroundYieldOptions, DurableAgentCore, RegisteredTaskHandle, TaskAccess, WorkflowTaskHandle } from "./task-registry-shared.js";
2
+ /** The handles a yield reaches: background agents and workflow runs. */
3
+ export type YieldableHandle = BackgroundAgentTaskHandle | WorkflowTaskHandle;
4
+ /**
5
+ * Hand ONE running agent or workflow run the yield. Answers why it cannot yield, or undefined when it was handed it (its
6
+ * leg parks at its own next clean boundary; a leg that has not reported yet is handed it at its report — a workflow run
7
+ * hands it to each of its legs the same way).
8
+ */
9
+ export declare function requestYieldLane(core: DurableAgentCore, handle: YieldableHandle, opts: BackgroundYieldOptions): BackgroundUnyieldableReason | undefined;
10
+ /** Whether a request already reached this handle (a whole-registry request covers a late joiner once). */
11
+ export declare function yieldRequested(handle: YieldableHandle): boolean;
12
+ /**
13
+ * A leg's prepare report: the leg's own yield controller and whether it can suspend durably. Replaces the previous leg's
14
+ * (every leg reports its own); an intent already set is handed to this leg now.
15
+ */
16
+ export declare function attachYieldLegLane(core: DurableAgentCore, id: string, controller: AbortController, ready: boolean): void;
17
+ /** Whether a request covers this handle — the ONE reading the request's first population and every late joiner of a
18
+ * whole-registry request share. A running background agent the request's `access` reaches (every one when absent); a
19
+ * running workflow run only for the whole registry (a run is never its launching leg's to decide: it outlives that leg,
20
+ * whose end does not reap it either); session-scoped work skipped when asked. */
21
+ export declare function yieldCovers(handle: RegisteredTaskHandle, access: TaskAccess | undefined, opts: BackgroundYieldOptions): handle is YieldableHandle;
22
+ /** The running work a request covers (see {@link yieldCovers}). */
23
+ export declare function yieldPopulationLane(core: DurableAgentCore, access: TaskAccess | undefined, opts: BackgroundYieldOptions): YieldableHandle[];
24
+ /** Whether every handle in `ids` has left `running` (a vanished handle has); the durable writes are awaited separately. A
25
+ * workflow run leaves `running` when it ends, after its terminal record write. */
26
+ export declare function yieldPopulationLeftRunning(core: DurableAgentCore, ids: ReadonlySet<string>): boolean;
27
+ /** Settle the durable writes queued for `ids` so far, and answer the agents whose latest write did NOT land — the store
28
+ * refused it through every retry (the heartbeat keeps re-driving it), so the row still reads its previous state. An agent's
29
+ * writes are its row chain (a park's or a settle's write is queued in the same synchronous stretch as the transition, so it
30
+ * is in the chain by the time the transition's poke is observed); a workflow run's are its run's end (`done` settles after
31
+ * its terminal record is written — a stopped run reads `cancelled` before that). Never rejects. */
32
+ export declare function yieldPopulationWrites(core: DurableAgentCore, ids: ReadonlySet<string>): Promise<string[]>;