@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
@@ -12,12 +12,14 @@ export type SystemInjectionPriority = "now" | "next" | "later";
12
12
  * The outcome an injection entry settles with — what the session did with the frame:
13
13
  * · `queued` — a live lane took it (it rides that run's next turn boundary; accepted, not yet consumed);
14
14
  * · `parked` — no live lane; pended IN PROCESS on {@link PendingSessionNotifications} for the
15
- * session's next run in this process (a process restart loses it);
15
+ * session's next run on this runner (a process restart loses it);
16
16
  * · `parked_durably` — no live lane; appended to the session's DURABLE box
17
17
  * ({@link PendingSessionNotifications.admit}) — the next run drains it, in any process;
18
18
  * · `dropped_duplicate` — the session already delivered this exact frame;
19
19
  * · `refused` — a live lane took it and the session's receiving station did not hand it over: an extension consumed it,
20
- * or a handler there failed ({@link FrameReceiver}). The model never saw it, and it is not owed again.
20
+ * or a handler there failed ({@link FrameReceiver}); or it was addressed to an occupant the session no longer holds
21
+ * (discarded, announced); or the durable box of a session this runner holds no seat for failed it twice (disclosed, and
22
+ * nothing is kept here — no leg of that session reads this runner's park). The model never saw it, and it is not owed again.
21
23
  * The park backend is the seat's choice ({@link routeOrParkNotification}), never the producer's.
22
24
  */
23
25
  export type NotificationInjectionOutcome = "queued" | "parked" | "parked_durably" | "dropped_duplicate" | "refused";
@@ -405,6 +407,18 @@ export interface SystemInjection<TPayload = unknown> {
405
407
  * `seq` (the documented repeat discipline); silently migrating a queued frame between lanes on a
406
408
  * repeat, or refusing the repeat typed, would each turn a dedup fold into a delivery mutation. */
407
409
  export declare function taskNotificationDedupKey(n: Pick<TaskNotificationPayload, "task_id" | "task_type" | "status" | "seq" | "attempt">): string;
410
+ /**
411
+ * The one set of options a task notification is handed to the model under, on every road it takes — the live lane (a running
412
+ * leg's steer / follow-up) and the turn-open redelivery (a frame parked while the session sat idle): engine-note provenance
413
+ * (visible to the model and to derived views, never the user's speech), the frame itself as the payload sidecar, and its
414
+ * {@link taskNotificationDedupKey} as the durable key on the transcript entry it becomes — the key the entry's
415
+ * `message_committed` frame states as `noteKey`, so a frame and its row join by key whichever road the frame took.
416
+ */
417
+ export declare function taskNotificationNoteOptions(payload: TaskNotificationPayload): {
418
+ readonly provenance: "engine-note";
419
+ readonly enginePayload: TaskNotificationPayload;
420
+ readonly engineNoteKey: string;
421
+ };
408
422
  /**
409
423
  * The lane-scoped identity of a task, extracted from {@link taskNotificationDedupKey} so every
410
424
  * place that treats "same task" as one bucket applies the SAME lane rule.
@@ -516,6 +530,10 @@ export interface SessionAddress {
516
530
  * takes the leg as no admission, drains it nothing, registers no live lane for it, and discards (announced) what is routed
517
531
  * to it ({@link PendingSessionNotifications.admit}, {@link PendingSessionNotifications.discardsStale}). */
518
532
  readonly unread?: true;
533
+ /** The scope the session's legs mount its durable box in, as the address's minter recorded it (a delegation tree's root
534
+ * anchor carries the one its root leg mounted). Read only where the store holds no seat for the session: the box is then the
535
+ * one {@link PendingSessionNotifications}' unseated box seat judges at this scope. Absent ⇒ no box is judged for it. */
536
+ readonly scope?: string;
519
537
  }
520
538
  /** A run leg's own session address — the session it prepared and the occupant its acquire read (the one construction). */
521
539
  export declare function sessionAddressOf(leg: {
@@ -565,9 +583,50 @@ export interface SessionBoxBinding {
565
583
  /** The deployment's engine-frame floor (`RunnerDeps.sessionBoxEngineFrames`): `true` ⇒ an engine
566
584
  * frame parks in this box as an `engine_frame` record; otherwise it parks in process. */
567
585
  engineFrames?: boolean;
568
- /** Where an append fault is disclosed (the frame then takes the in-process park — never lost). */
586
+ /** Where an append fault is disclosed. For a session the store holds a seat for, a second fault leaves the frame on the
587
+ * in-process park its next leg on this runner settles with the box; for one it holds none for, the second fault is disclosed
588
+ * here too and nothing is kept — no leg of that session would read it. */
569
589
  onError?: (e: unknown) => void;
570
590
  }
591
+ /** Why no durable box is judged for a session id at a scope ({@link SessionBoxVerdict}): the deployment wires no mailbox store;
592
+ * the mailbox, or the session store's by-id read, is not safe to share across processes (`reason` = the mount verdict's own
593
+ * sentence); the id is outside the box address grammar. */
594
+ export type SessionBoxRefusal = {
595
+ readonly code: "no_mailbox";
596
+ } | {
597
+ readonly code: "mailbox_unsafe";
598
+ readonly reason: string;
599
+ } | {
600
+ readonly code: "ungrammatical";
601
+ };
602
+ /** The one judgment of a session's durable box at a scope: its binding, or why there is none. */
603
+ export type SessionBoxVerdict = {
604
+ readonly ok: true;
605
+ readonly box: SessionBoxBinding;
606
+ } | {
607
+ readonly ok: false;
608
+ readonly cause: SessionBoxRefusal;
609
+ };
610
+ /** A completion sink: a background producer's frame and its tier, the shape a mount's `notify` takes. */
611
+ export type TaskNotificationSink = (n: TaskNotificationPayload, opts?: {
612
+ priority?: SystemInjectionPriority;
613
+ }) => void;
614
+ /** Why a completion addressed to a session does not take the route ({@link PendingSessionNotifications.completionLaneOf}): the box
615
+ * judgment's refusal ({@link SessionBoxRefusal}); the deployment declares no durable engine frames (`floor_off`); the address names
616
+ * no scope its box lives in (`no_root_scope`). Engine-internal: it picks a sentence, it never rides the wire. */
617
+ export type SessionCompletionLaneCause = SessionBoxRefusal | {
618
+ readonly code: "floor_off";
619
+ } | {
620
+ readonly code: "no_root_scope";
621
+ };
622
+ /** The route's sink for a completion addressed to a session, or why there is none. */
623
+ export type SessionCompletionLane = {
624
+ readonly ok: true;
625
+ readonly sink: TaskNotificationSink;
626
+ } | {
627
+ readonly ok: false;
628
+ readonly cause: SessionCompletionLaneCause;
629
+ };
571
630
  /** The hand-back contract's three words (see {@link TaskNotificationPayload.handback}). */
572
631
  export declare const HANDBACK_STATES: readonly ["send", "flagged", "withheld"];
573
632
  export type HandbackState = (typeof HANDBACK_STATES)[number];
@@ -897,14 +956,20 @@ export interface SessionBoxDebt {
897
956
  * another occupant, and an occupant once replaced never stands again. So from an admission on, whatever is addressed to,
898
957
  * or kept for, another occupant of that id is discarded — announced `delegation.delivery_discarded` (operator), never
899
958
  * delivered and never silent. A session no leg of which was admitted here (or whose seat aged out of the bound) has no
900
- * current occupant on record: its frames park under their own address and are judged by the leg that drains them.
959
+ * current occupant on record: its frames park under their own address and are judged by the leg that drains them — in the
960
+ * durable box the unseated box seat judges for an address that names its box's scope, else in process.
901
961
  */
902
962
  export declare class PendingSessionNotifications {
903
963
  private readonly sessions;
904
964
  /** Where a discard is announced: the deployment's notice sink, read when the discard happens (absent ⇒ the process default seat). */
905
965
  private readonly noticeSeat;
966
+ /** The durable box of a session this store holds no seat for, judged by the deployment as it stands when asked (absent ⇒ none). */
967
+ private readonly unseatedBoxSeat;
906
968
  constructor(seats?: {
907
969
  readonly onNotice?: () => ((notice: EngineNotice) => void) | undefined;
970
+ readonly boxFor?: (address: SessionAddress & {
971
+ readonly scope: string;
972
+ }) => SessionBoxVerdict;
908
973
  });
909
974
  /**
910
975
  * The LIVE half of the same question this store answers. Together they are one seat — "where does a
@@ -940,8 +1005,21 @@ export declare class PendingSessionNotifications {
940
1005
  * so a parked record is always judged against the occupant that parked it, never against whichever frame arrives next.
941
1006
  */
942
1007
  admit(address: SessionAddress, box: SessionBoxBinding | undefined): void;
943
- /** The addressed occupant's durable box: the one its own leg in this process bound, never another occupant's. */
1008
+ /** The addressed occupant's durable box. A session a leg of which this store admitted answers by its seat alone: the box that
1009
+ * leg bound, never another occupant's. One it holds no seat for answers by {@link boxVerdictOf} — a judgment, not an
1010
+ * admission: it writes no seat, and the occupant the box's drain hands the record to is judged there. */
944
1011
  sessionBoxFor(address: SessionAddress): SessionBoxBinding | undefined;
1012
+ /** Does a leg of the session hold a seat here — so its next leg on this runner reads what this store parks for it? */
1013
+ holdsSeat(sessionId: string): boolean;
1014
+ /** The deployment's judgment of the address's durable box at the scope the address names (the unseated box seat, read now) —
1015
+ * what the route reads for a session no leg of which is seated here; `undefined` when the address names no scope or the
1016
+ * store was handed no seat. */
1017
+ boxVerdictOf(address: SessionAddress): SessionBoxVerdict | undefined;
1018
+ /** A completion addressed to `address` (a delegation tree's root, by a drive with no run lane of its own) through this store's
1019
+ * route ({@link routeOrParkNotification}): its sink while the deployment judges the address a durable box that takes engine
1020
+ * frames ({@link boxVerdictOf}) — the route then reaches its live run here, else its seat here, else that box — or why not.
1021
+ * `unkept` takes a frame the box of a session seated nowhere here failed twice (the route keeps no copy of it). */
1022
+ completionLaneOf(address: SessionAddress, unkept?: TaskNotificationSink): SessionCompletionLane;
945
1023
  /**
946
1024
  * Is `address` an earlier occupant of a session whose current occupant is another? Then the frame is discarded here —
947
1025
  * announced with the seat it would have reached under the current occupant — and the answer is `true`: nothing routes,
@@ -1041,7 +1119,8 @@ export declare class DurableAppendObligations {
1041
1119
  }
1042
1120
  /**
1043
1121
  * WHERE A FRAME ADDRESSED TO ONE SESSION GOES — the single decision, so the two addresses that ask it
1044
- * (a run's own session, and the delegation tree's root anchor) cannot drift apart. Three outcomes:
1122
+ * (a run's own session, and the delegation tree's root anchor — a revived run's lane, a lane-less drive's completion) cannot
1123
+ * drift apart. Three outcomes:
1045
1124
  * · the session ALREADY OWNS the key (parked, or routed onto a live lane) ⇒ fold — neither route it
1046
1125
  * nor park a second copy; `"parked"` is the word a folded repeat has always been given;
1047
1126
  * · a live lane takes it ⇒ it rides that run's next turn boundary. This decision records NOTHING in
@@ -1051,9 +1130,10 @@ export declare class DurableAppendObligations {
1051
1130
  * · nothing can take it ⇒ park, carrying the tier, for the session's next run.
1052
1131
  * The address names the session's occupant ({@link SessionAddress}): every one of the three is that occupant's — its keys,
1053
1132
  * its live lanes, its box, its record — and a frame addressed to an occupant the session no longer holds is discarded
1054
- * before any of them ({@link PendingSessionNotifications.discardsStale}); its receipt says `"refused"`.
1133
+ * before any of them ({@link PendingSessionNotifications.discardsStale}); its receipt says `"refused"`. `onUnkept` is told,
1134
+ * before that receipt, when the refusal is the one that keeps nothing: the box of a session seated nowhere here failed twice.
1055
1135
  */
1056
- export declare function routeOrParkNotification(store: PendingSessionNotifications, address: SessionAddress, payload: TaskNotificationPayload, priority: SystemInjectionPriority, onDisposition?: (d: NotificationDisposition) => void): void;
1136
+ export declare function routeOrParkNotification(store: PendingSessionNotifications, address: SessionAddress, payload: TaskNotificationPayload, priority: SystemInjectionPriority, onDisposition?: (d: NotificationDisposition) => void, onUnkept?: () => void): void;
1057
1137
  /**
1058
1138
  * The durable form of a parked peer-words frame: the SAME `peer_message` record the cross-session lane
1059
1139
  * appends (the recipient's drain renders it through the one envelope and judges it through the one
@@ -1,5 +1,6 @@
1
1
  import { AsyncLocalStorage } from "node:async_hooks";
2
2
  import { escapeEnvelopeTag, inlineUntrusted, sanitizeUntrustedText } from "./untrusted-text.js";
3
+ import { describeRejectedValue } from "./tool-search-setting.js";
3
4
  import { egressText } from "./untrusted-egress.js";
4
5
  import { redactThenCut } from "../agents/subagent-steps.js";
5
6
  import { PEER_MESSAGE_NOTICE } from "../agents/peer-admission.js";
@@ -18,8 +19,7 @@ export function isSystemInjectionPriority(value) {
18
19
  function requireSystemInjectionPriority(value) {
19
20
  if (isSystemInjectionPriority(value))
20
21
  return value;
21
- const shown = typeof value === "string" ? JSON.stringify(value.length > 24 ? `${value.slice(0, 24)}…` : value) : value === null ? "null" : typeof value;
22
- const refusal = new Error(`a steer priority must be one of ${SYSTEM_INJECTION_PRIORITIES.join("/")}, got ${shown}`);
22
+ const refusal = new Error(`a steer priority must be one of ${SYSTEM_INJECTION_PRIORITIES.join("/")}, got ${describeRejectedValue(value)}`);
23
23
  refusal.code = "steering.invalid_content";
24
24
  throw refusal;
25
25
  }
@@ -77,6 +77,9 @@ export function taskNotificationDedupKey(n) {
77
77
  const attempt = n.attempt !== undefined && Number.isInteger(n.attempt) && n.attempt > 1 ? `:a${n.attempt}` : "";
78
78
  return `task_notification:${taskNotificationLaneKey(n)}:${n.status}${n.seq !== undefined ? `:${n.seq}` : ""}${attempt}`;
79
79
  }
80
+ export function taskNotificationNoteOptions(payload) {
81
+ return { provenance: "engine-note", enginePayload: payload, engineNoteKey: taskNotificationDedupKey(payload) };
82
+ }
80
83
  export function taskNotificationLaneKey(n) {
81
84
  return n.task_type === "external" ? `external:${n.task_id}` : n.task_id;
82
85
  }
@@ -286,6 +289,8 @@ function malformedFacet(f) {
286
289
  return "spawnName outside the spawn-name grammar";
287
290
  if (f["handback"] !== undefined && !(typeof f["handback"] === "string" && HANDBACK_STATES.includes(f["handback"])))
288
291
  return "handback outside its closed set";
292
+ if (f["completionId"] !== undefined && !(typeof f["completionId"] === "string" && f["completionId"] !== ""))
293
+ return "completionId is not a non-empty string";
289
294
  const steps = f["recentSteps"];
290
295
  if (steps !== undefined && !(Array.isArray(steps) && steps.every((s) => s !== null && typeof s === "object" && typeof s.tool === "string" && typeof s.target === "string" && typeof s.outcome === "string")))
291
296
  return "recentSteps is not a list of steps";
@@ -521,8 +526,10 @@ function addOccupantKey(held, address, dedupKey) {
521
526
  export class PendingSessionNotifications {
522
527
  sessions = new Map();
523
528
  noticeSeat;
529
+ unseatedBoxSeat;
524
530
  constructor(seats) {
525
531
  this.noticeSeat = seats?.onNotice ?? (() => undefined);
532
+ this.unseatedBoxSeat = seats?.boxFor;
526
533
  }
527
534
  liveLanes = new SessionLiveNotificationLanes();
528
535
  droppedSessions = 0;
@@ -551,7 +558,26 @@ export class PendingSessionNotifications {
551
558
  }
552
559
  sessionBoxFor(address) {
553
560
  const seat = this.seats.get(address.sessionId);
554
- return seat !== undefined && sameOccupant(seat.occupant, address.occupant) ? seat.box : undefined;
561
+ if (seat !== undefined)
562
+ return sameOccupant(seat.occupant, address.occupant) ? seat.box : undefined;
563
+ const verdict = this.boxVerdictOf(address);
564
+ return verdict?.ok === true ? verdict.box : undefined;
565
+ }
566
+ holdsSeat(sessionId) {
567
+ return this.seats.has(sessionId);
568
+ }
569
+ boxVerdictOf(address) {
570
+ return address.scope !== undefined ? this.unseatedBoxSeat?.({ ...address, scope: address.scope }) : undefined;
571
+ }
572
+ completionLaneOf(address, unkept) {
573
+ const verdict = this.boxVerdictOf(address);
574
+ if (verdict === undefined)
575
+ return { ok: false, cause: { code: "no_root_scope" } };
576
+ if (!verdict.ok)
577
+ return verdict;
578
+ if (verdict.box.engineFrames !== true)
579
+ return { ok: false, cause: { code: "floor_off" } };
580
+ return { ok: true, sink: (n, o) => routeOrParkNotification(this, address, n, o?.priority ?? "next", undefined, unkept !== undefined ? () => unkept(n, o) : undefined) };
555
581
  }
556
582
  discardsStale(address, payload) {
557
583
  const stale = this.staleAgainst(address);
@@ -772,7 +798,7 @@ export class DurableAppendObligations {
772
798
  await Promise.allSettled([...this.inFlight]);
773
799
  }
774
800
  }
775
- export function routeOrParkNotification(store, address, payload, priority, onDisposition) {
801
+ export function routeOrParkNotification(store, address, payload, priority, onDisposition, onUnkept) {
776
802
  if (store.discardsStale(address, payload)) {
777
803
  onDisposition?.("refused");
778
804
  return;
@@ -805,8 +831,22 @@ export function routeOrParkNotification(store, address, payload, priority, onDis
805
831
  }
806
832
  return ask();
807
833
  });
808
- const settled = appended.then(() => onDisposition?.("parked_durably"), () => {
834
+ const settled = appended.then(() => onDisposition?.("parked_durably"), (second) => {
809
835
  store.forgetDurablePark(address, dedupKey);
836
+ if (!store.holdsSeat(address.sessionId)) {
837
+ try {
838
+ box.onError?.(new Error(`the ${inlineUntrusted(String(payload.task_type), 40)} frame of task ${inlineUntrusted(String(payload.task_id), 120)} could not be written to session ${inlineUntrusted(address.sessionId, 120)}'s durable box (asked twice), and no leg of that session is seated on this runner to read a copy kept here: it was not kept`, { cause: second }));
839
+ }
840
+ catch {
841
+ }
842
+ try {
843
+ onUnkept?.();
844
+ }
845
+ catch {
846
+ }
847
+ onDisposition?.("refused");
848
+ return;
849
+ }
810
850
  const parked = store.pend(address, payload, priority, { box, record });
811
851
  onDisposition?.(parked ? "parked" : "refused");
812
852
  });
@@ -1,5 +1,5 @@
1
1
  import { type BackgroundAgentRecord, type BackgroundAgentStore } from "./background-agent-store.js";
2
- import { type StopSource, type TaskAccess, type TaskRetrievalStatus, type UnifiedTaskOutput, type UnifiedTaskResult, type BackgroundAgentTaskHandle, type ChildSessionStore, type RegisteredTaskHandle, type DurableAgentCore, type ParkedClaimTicket, type RegisterBackgroundAgentInput, type LandedAgentTerminal } from "./task-registry-shared.js";
2
+ import { type StopSource, type TaskAccess, type TaskRetrievalStatus, type UnifiedTaskOutput, type UnifiedTaskResult, type BackgroundAgentTaskHandle, type ChildSessionStore, type RegisteredTaskHandle, type DurableAgentCore, type ParkedClaimTicket, type ParkedClaimRollback, type RegisterBackgroundAgentInput, type LandedAgentTerminal } from "./task-registry-shared.js";
3
3
  import type { ExtensionRequester } from "./task-event.js";
4
4
  import { type AgentState } from "./agent-state.js";
5
5
  import type { CheckpointSeat } from "./checkpoint-seat.js";
@@ -27,6 +27,15 @@ export interface DelegationOccupant {
27
27
  /** The rows {@link activeDelegationHandlesLane} counts, with the name each is addressed by — the one selection, read in the same
28
28
  * synchronous segment. `caller` is the access the asking leg's own tools hold (`scope` is the pool's); without one no row is reachable. */
29
29
  export declare function activeDelegationOccupantsLane(core: DurableAgentCore, scope: string, rootSessionId: string, caller?: TaskAccess): DelegationOccupant[];
30
+ /** Where one active row of a delegation tree lives: its task id and the scope it is registered in. */
31
+ export interface DelegationRowAddress {
32
+ readonly handle: string;
33
+ readonly scope: string;
34
+ }
35
+ /** The ACTIVE (running / pending) rows of one delegation tree in THIS process, in EVERY scope — the live twin of
36
+ * `BackgroundAgentStore.listByRoot`: the same tree reading ({@link delegationRootOf}) and the same root judge
37
+ * ({@link assertDelegationRoot}), each row with the scope a follow-up addresses it in. */
38
+ export declare function activeDelegationHandlesByRootLane(core: DurableAgentCore, rootSessionId: string): DelegationRowAddress[];
30
39
  export declare function ensureDurableHeartbeatLane(core: DurableAgentCore): void;
31
40
  /** design/151 S1a — enqueue one durable-row write (see {@link DurableAgentLane} for the lane
32
41
  * contract). `patch` is captured at CALL time (the settle-site values), applied in chain order.
@@ -268,7 +277,7 @@ export declare function claimParkedAgentLane(stores: {
268
277
  export declare function rollbackParkedClaimLane(core: DurableAgentCore, stores: {
269
278
  agentStore: import("./background-agent-store.js").BackgroundAgentStore;
270
279
  checkpointStore: Pick<import("./checkpoint-store.js").CheckpointStore, "get">;
271
- }, ticket: ParkedClaimTicket): Promise<"rolled_back" | "failed" | "lost" | "retry">;
280
+ }, ticket: ParkedClaimTicket): Promise<ParkedClaimRollback>;
272
281
  /**
273
282
  * design/153 §7.2d (件3c 3c H-1) — the CONSUME FLIP, SERIALIZED THROUGH THE DURABLE LANE:
274
283
  * the guarded parked→running store CAS runs INSIDE the lane chain (ordered after every seeded
@@ -431,9 +440,12 @@ export declare function settleRevivedAgentLane(core: DurableAgentCore, id: strin
431
440
  * through a two-hour job looked exactly like one whose lane died. This is that signal — the same
432
441
  * tool-lifecycle beat the fleet view already samples, recorded on the row.
433
442
  *
434
- * Cheap and idempotent: a timestamp write on a running row, no-op for anything else.
443
+ * Cheap and idempotent: a timestamp write on a running row, no-op for anything else. The row's silence is read on the process-monotonic
444
+ * clock, so the beat records that clock (`atMono`, `performance.now()` milliseconds; default now) beside the wall-clock `updatedAt`. An instant
445
+ * that is no reading of this process's clock (negative, non-finite, or past its now by more than a second) is refused, whatever the row;
446
+ * one earlier than the row's stamp does not take the stamp back ({@link stampActivity}).
435
447
  */
436
- export declare function noteBackgroundAgentActivityLane(core: DurableAgentCore, id: string, now?: number): void;
448
+ export declare function noteBackgroundAgentActivityLane(core: DurableAgentCore, id: string, atMono?: number): void;
437
449
  /**
438
450
  * design/164 — collect SESSION-SCOPED background agents that have gone SILENT, the replacement for the
439
451
  * retired 30-minute wall-clock ceiling on that lane.
@@ -444,11 +456,16 @@ export declare function noteBackgroundAgentActivityLane(core: DurableAgentCore,
444
456
  * (`maxAgeMs` / `keep` / `staleRunningMaxAgeMs` are all caller-supplied). Size it well above the child's
445
457
  * expected quiet stretches; the durable twin's guidance (≥10× the heartbeat) is the reference point.
446
458
  *
459
+ * Silence is measured on the PROCESS-MONOTONIC clock (`lastActivityMono`, `nowMono` = `performance.now()` milliseconds): a wall-clock
460
+ * step — an NTP correction, a manual change — or a machine that slept would otherwise read as silence on one row and hide it on
461
+ * another. `updatedAt` stays the displayed wall instant. The durable sweep (`staleRunningMaxAgeMs`) is a different question — a row
462
+ * another process wrote — and stays on the wall clock, which is the only one two processes share.
463
+ *
447
464
  * A collected row is settled `killed` with attribution `"system"` and the SAME wording the durable
448
465
  * stale-running sweep writes, so an operator reading either face sees one explanation, and its run is
449
466
  * aborted. Returns how many rows were collected.
450
467
  */
451
- export declare function reapStaleSessionBackgroundAgentsLane(core: DurableAgentCore, staleMs: number, now?: number): number;
468
+ export declare function reapStaleSessionBackgroundAgentsLane(core: DurableAgentCore, staleMs: number, nowMono?: number): number;
452
469
  /**
453
470
  * THE announcement of a background agent's terminal the REGISTRY landed without the cycle's attempt — the session or stale
454
471
  * reap of a running cycle (its attempt's unwind would report only once the in-flight tool honored the abort), a TaskStop
@@ -578,7 +595,7 @@ export declare function serveDurableAgentRowLane(row: BackgroundAgentRecord,
578
595
  * carried as `details.agentState`. Absent ⇒ neither appears (a serving layer that does not read it). */
579
596
  agentState?: AgentState): UnifiedTaskResult;
580
597
  export declare function pollBackgroundAgentLane(handle: BackgroundAgentTaskHandle, deadline?: number, signal?: AbortSignal,
581
- /** The run's checkpoint seat — the store a parked row's approval card is read from
582
- * ({@link import("./agent-state.js").readAgentState}). Absent ⇒ a parked row reads `approval unreadable`. */
598
+ /** The run's checkpoint seat — the store a parked row's park card is read from
599
+ * ({@link import("./agent-state.js").readAgentState}). Absent ⇒ a parked row reads `park unreadable`. */
583
600
  checkpointSeat?: CheckpointSeat): Promise<UnifiedTaskResult>;
584
601
  export declare function stopBackgroundAgentLane(core: DurableAgentCore, handle: BackgroundAgentTaskHandle): Promise<UnifiedTaskResult>;
@@ -1,11 +1,12 @@
1
1
  import { randomBytes } from "node:crypto";
2
+ import { describeRejectedValue } from "./tool-search-setting.js";
2
3
  import { receiveRetentionPolicy } from "./retention-policy.js";
3
- import { uuidv7 } from "../internal/harness.js";
4
- import { BACKGROUND_AGENT_REAP_KNOBS, canAccessAgentRecord, BackgroundAgentStoreError, clearRevivedRowTerminalPayload, REVIVED_ROW_CLEARED_FIELDS, STALE_RUNNING_REAP_ATTRIBUTION, } from "./background-agent-store.js";
4
+ import { commitCompletionIdIfEmpty, completionIdCandidate, mintCompletionId } from "./completion-id.js";
5
+ import { assertDelegationRoot, BACKGROUND_AGENT_REAP_KNOBS, canAccessAgentRecord, delegationRootOf, BackgroundAgentStoreError, clearRevivedRowTerminalPayload, REVIVED_ROW_CLEARED_FIELDS, STALE_RUNNING_REAP_ATTRIBUTION, } from "./background-agent-store.js";
5
6
  import { shutdownDebug } from "./shutdown-debug.js";
6
7
  import { delimitUntrusted } from "./untrusted-text.js";
7
8
  import { boundedRedactedSummary } from "./untrusted-egress.js";
8
- import { mintCompletionId, commitCompletionIdIfEmpty, clipTaskOutput, assertOwnership, sleepPollStep, alreadyTerminalStopNote, canAccess, normalizeAgentName, engineAgentName, chosenAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, } from "./task-registry-shared.js";
9
+ import { clipTaskOutput, assertOwnership, sleepPollStep, alreadyTerminalStopNote, canAccess, isLiveSessionResidentAgent, normalizeAgentName, engineAgentName, chosenAgentName, DURABLE_AGENT_HEARTBEAT_MS, DURABLE_AGENT_HANDLE_RE, BG_AGENT_REAP_STOP_ERROR, activityStamp, isActivityInstant, monotonicNow, stampActivity, } from "./task-registry-shared.js";
9
10
  import { thrownLabel } from "./thrown-value.js";
10
11
  import { readExtensionRequester } from "./extension-requester.js";
11
12
  import { closestName } from "./closest-name.js";
@@ -14,20 +15,34 @@ export function activeDelegationHandlesLane(core, scope, rootSessionId) {
14
15
  return activeDelegationOccupantsLane(core, scope, rootSessionId).map((o) => o.id);
15
16
  }
16
17
  export function activeDelegationOccupantsLane(core, scope, rootSessionId, caller) {
18
+ const out = [];
19
+ for (const bh of activeDelegationTreeLane(core, rootSessionId)) {
20
+ if (bh.scope !== scope)
21
+ continue;
22
+ const requestedBy = readExtensionRequester(bh.requestedBy);
23
+ out.push({ id: bh.id, name: bh.name, ...(requestedBy !== undefined ? { requestedBy } : {}), reachable: caller !== undefined && canAccess(bh, { ...caller, scope }) });
24
+ }
25
+ return out;
26
+ }
27
+ export function activeDelegationHandlesByRootLane(core, rootSessionId) {
28
+ assertDelegationRoot(rootSessionId);
29
+ const out = [];
30
+ for (const bh of activeDelegationTreeLane(core, rootSessionId)) {
31
+ if (bh.scope !== undefined)
32
+ out.push({ handle: bh.id, scope: bh.scope });
33
+ }
34
+ return out;
35
+ }
36
+ function activeDelegationTreeLane(core, rootSessionId) {
17
37
  const out = [];
18
38
  for (const h of core.handles.values()) {
19
39
  if (h.type !== "background_agent")
20
40
  continue;
21
41
  if (h.status !== "running" && h.status !== "pending")
22
42
  continue;
23
- if (h.scope !== scope)
24
- continue;
25
43
  const bh = h;
26
- const root = bh.rootSessionId ?? bh.parentSessionId ?? (bh.sessionScoped ? bh.owner : undefined);
27
- if (root !== rootSessionId)
28
- continue;
29
- const requestedBy = readExtensionRequester(bh.requestedBy);
30
- out.push({ id: h.id, name: bh.name, ...(requestedBy !== undefined ? { requestedBy } : {}), reachable: caller !== undefined && canAccess(h, { ...caller, scope }) });
44
+ if (delegationRootOf(bh) === rootSessionId)
45
+ out.push(bh);
31
46
  }
32
47
  return out;
33
48
  }
@@ -195,7 +210,7 @@ export async function reapDurableAgentsLane(core, scope, deps, policy) {
195
210
  }
196
211
  if (knobs.maxAgeMs === undefined && knobs.keep === undefined)
197
212
  return { rowsReaped: 0, sessionsReleased: 0, skippedNoSessions: 0, orphanPlacedReleased: 0 };
198
- const terminal = (await deps.store.listByScope(scope)).filter((r) => r.status !== "running" && r.status !== "parked");
213
+ const terminal = (await deps.store.listByScope(scope)).filter((r) => !("rowVerdict" in r) && r.status !== "running" && r.status !== "parked");
199
214
  terminal.sort((a, b) => b.spawnedAt - a.spawnedAt);
200
215
  const doomed = new Map();
201
216
  if (knobs.maxAgeMs !== undefined) {
@@ -394,7 +409,7 @@ export function registerBackgroundAgentLane(core, input) {
394
409
  throw new Error(`TaskRegistry: task id already registered: ${id}`);
395
410
  const now = input.now ?? Date.now();
396
411
  if (input.name !== undefined && (typeof input.name !== "string" || input.name === "")) {
397
- throw new Error(`TaskRegistry: background-agent name must be a non-empty string (got ${JSON.stringify(input.name)}); omit it to take the derived one`);
412
+ throw new Error(`TaskRegistry: background-agent name must be a non-empty string (got ${describeRejectedValue(input.name)}); omit it to take the derived one`);
398
413
  }
399
414
  const name = input.name ?? engineAgentName(id);
400
415
  const requestedBy = readExtensionRequester(input.requestedBy);
@@ -421,8 +436,9 @@ export function registerBackgroundAgentLane(core, input) {
421
436
  ...(input.toolUseId !== undefined ? { toolUseId: input.toolUseId } : {}),
422
437
  cycleSeq: input.durableSeed !== undefined ? (input.durableSeed.record.seq ?? 1) : 1,
423
438
  createdAt: now,
424
- updatedAt: now,
439
+ ...activityStamp(now),
425
440
  abort: input.abort,
441
+ yieldSeat: { lane: input.yieldLane ?? "no_park_lane" },
426
442
  });
427
443
  if (input.store) {
428
444
  const handle = core.handles.get(id);
@@ -451,6 +467,7 @@ export function registerBackgroundAgentLane(core, input) {
451
467
  ...(input.parentSessionId !== undefined ? { parentSessionId: input.parentSessionId } : {}),
452
468
  ...(input.rootSessionId !== undefined ? { rootSessionId: input.rootSessionId } : {}),
453
469
  ...(input.rootSessionId !== undefined && input.rootSessionIncarnation !== undefined ? { rootSessionIncarnation: input.rootSessionIncarnation } : {}),
470
+ ...(input.rootSessionId !== undefined && input.rootSessionScope !== undefined ? { rootSessionScope: input.rootSessionScope } : {}),
454
471
  ...(input.parentTaskId !== undefined ? { parentTaskId: input.parentTaskId } : {}),
455
472
  name,
456
473
  ...(input.agentType !== undefined ? { agentType: input.agentType } : {}),
@@ -492,7 +509,7 @@ export function parkBackgroundAgentLane(core, id, park) {
492
509
  for (const r of [...(handle.inFlightDirect ?? [])])
493
510
  r({ ok: false, reason: "not_running" });
494
511
  handle.inFlightDirect = undefined;
495
- handle.updatedAt = Date.now();
512
+ stampActivity(handle);
496
513
  if (park.seq !== undefined)
497
514
  handle.cycleSeq = park.seq;
498
515
  core.pokeBgQuiescence(handle.owner);
@@ -560,7 +577,7 @@ export async function reconcileParkedAgentsLane(core, stores, scope, now, opts)
560
577
  held.error = error;
561
578
  held.parkedCheckpointToken = undefined;
562
579
  held.resolveParkedStop = undefined;
563
- held.updatedAt = now;
580
+ stampActivity(held, now);
564
581
  mintCompletionId(held);
565
582
  core.pokeBgQuiescence(held.owner);
566
583
  announceParkedEnding(core, held, { status: "failed", error });
@@ -639,7 +656,7 @@ export async function rollbackParkedClaimLane(core, stores, ticket) {
639
656
  return "retry";
640
657
  }
641
658
  const now = Date.now();
642
- const rollbackCompletionIdCandidate = uuidv7();
659
+ const rollbackCompletionIdCandidate = completionIdCandidate();
643
660
  const settleLocalParkedHandle = (error) => {
644
661
  const h = core.handles.get(ticket.handle);
645
662
  if (h !== undefined && h.type === "background_agent" && h.status === "parked") {
@@ -649,7 +666,7 @@ export async function rollbackParkedClaimLane(core, stores, ticket) {
649
666
  h.resolveParkedStop = undefined;
650
667
  h.parkedCompletionSink = undefined;
651
668
  h.terminalNotifier = undefined;
652
- h.updatedAt = now;
669
+ stampActivity(h, now);
653
670
  commitCompletionIdIfEmpty(h, rollbackCompletionIdCandidate);
654
671
  core.pokeBgQuiescence(h.owner);
655
672
  }
@@ -803,7 +820,7 @@ export async function consumeParkedFlipLane(core, id, stores, ticket) {
803
820
  handle.parkedCheckpointToken = undefined;
804
821
  handle.resolveParkedStop = undefined;
805
822
  handle.parkedCompletionSink = undefined;
806
- handle.updatedAt = Date.now();
823
+ stampActivity(handle);
807
824
  handle.completionId = undefined;
808
825
  handle.terminalNotified = undefined;
809
826
  if (flipped.seq !== undefined)
@@ -841,7 +858,7 @@ export function settleBackgroundAgentLane(core, id, outcome) {
841
858
  backfilled = true;
842
859
  }
843
860
  if (backfilled) {
844
- handle.updatedAt = Date.now();
861
+ stampActivity(handle);
845
862
  durableAgentWriteLane(handle, {
846
863
  ...(handle.result !== undefined ? { finalOutput: handle.result } : {}),
847
864
  ...(handle.resultFull !== undefined ? { finalOutputFull: handle.resultFull } : {}),
@@ -884,7 +901,7 @@ export function settleBackgroundAgentLane(core, id, outcome) {
884
901
  if (outcome.retryAfterMs !== undefined)
885
902
  handle.errorRetryAfterMs = outcome.retryAfterMs;
886
903
  }
887
- handle.updatedAt = Date.now();
904
+ stampActivity(handle);
888
905
  if (outcome.seq !== undefined)
889
906
  handle.cycleSeq = outcome.seq;
890
907
  core.pokeBgQuiescence(handle.owner);
@@ -1139,9 +1156,10 @@ export async function reviveBackgroundAgentLane(core, id, access, abort) {
1139
1156
  handle.stoppedBy = undefined;
1140
1157
  handle.completionId = undefined;
1141
1158
  handle.terminalNotified = undefined;
1159
+ handle.yieldSeat = { lane: "no_park_lane" };
1142
1160
  handle.reviveCycle = (handle.reviveCycle ?? 0) + 1;
1143
1161
  handle.cycleSeq = (handle.cycleSeq ?? 1) + 1;
1144
- handle.updatedAt = Date.now();
1162
+ stampActivity(handle);
1145
1163
  if (plainDurableWrite)
1146
1164
  durableAgentWriteLane(handle, { status: "running" }, REVIVED_ROW_CLEARED_FIELDS);
1147
1165
  return { ok: true, cycle: handle.reviveCycle };
@@ -1149,21 +1167,26 @@ export async function reviveBackgroundAgentLane(core, id, access, abort) {
1149
1167
  export function settleRevivedAgentLane(core, id, cycle, outcome) {
1150
1168
  return settleBackgroundAgentLane(core, id, { ...outcome, cycle });
1151
1169
  }
1152
- export function noteBackgroundAgentActivityLane(core, id, now = Date.now()) {
1170
+ export function noteBackgroundAgentActivityLane(core, id, atMono = monotonicNow()) {
1171
+ if (!isActivityInstant(atMono))
1172
+ throw new Error(`noteBackgroundAgentActivity: the instant must be a finite monotonic reading in milliseconds, from 0 to this process's clock (got ${String(atMono)})`);
1153
1173
  const handle = core.handles.get(id);
1154
1174
  if (!handle || handle.type !== "background_agent" || handle.status !== "running")
1155
1175
  return;
1156
- handle.updatedAt = now;
1176
+ stampActivity(handle, Date.now(), atMono);
1157
1177
  }
1158
- export function reapStaleSessionBackgroundAgentsLane(core, staleMs, now = Date.now()) {
1178
+ export function reapStaleSessionBackgroundAgentsLane(core, staleMs, nowMono = monotonicNow()) {
1159
1179
  if (!Number.isFinite(staleMs) || staleMs <= 0) {
1160
1180
  throw new Error(`reapStaleSessionBackgroundAgents: staleMs must be a positive finite number of milliseconds (got ${String(staleMs)})`);
1161
1181
  }
1182
+ if (!Number.isFinite(nowMono)) {
1183
+ throw new Error(`reapStaleSessionBackgroundAgents: the instant must be a finite monotonic reading in milliseconds (got ${String(nowMono)})`);
1184
+ }
1162
1185
  let reaped = 0;
1163
1186
  for (const handle of core.handles.values()) {
1164
- if (handle.type !== "background_agent" || handle.status !== "running" || handle.sessionScoped !== true)
1187
+ if (!isLiveSessionResidentAgent(handle))
1165
1188
  continue;
1166
- if (now - handle.updatedAt <= staleMs)
1189
+ if (nowMono - handle.lastActivityMono <= staleMs)
1167
1190
  continue;
1168
1191
  core.markStopSource(handle.id, "system");
1169
1192
  const reapTerminalNote = handle.terminalNotifier;
@@ -1496,7 +1519,7 @@ export async function stopBackgroundAgentLane(core, handle) {
1496
1519
  core.markStopSource(handle.id, "parent");
1497
1520
  handle.status = "killed";
1498
1521
  handle.stoppedBy = handle.stopSource ?? "parent";
1499
- handle.updatedAt = Date.now();
1522
+ stampActivity(handle);
1500
1523
  mintCompletionId(handle);
1501
1524
  handle.parkedCheckpointToken = undefined;
1502
1525
  handle.resolveParkedStop = undefined;
@@ -1561,7 +1584,7 @@ export async function stopBackgroundAgentLane(core, handle) {
1561
1584
  handle.abort.abort();
1562
1585
  handle.status = "killed";
1563
1586
  handle.stoppedBy = handle.stopSource ?? "parent";
1564
- handle.updatedAt = Date.now();
1587
+ stampActivity(handle);
1565
1588
  mintCompletionId(handle);
1566
1589
  handle.notify = undefined;
1567
1590
  for (const [, , qResolve] of handle.preAttachQueue ?? [])