@sema-agent/core 7.66.1 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (899) hide show
  1. package/CHANGELOG.md +3483 -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 +145 -0
  71. package/dist/brain/model-lane.js +444 -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 +161 -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 +103 -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 +6 -0
  362. package/dist/core/roles.js +65 -4
  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 +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -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 +13 -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 +115 -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 +63 -34
  730. package/dist/index.js +44 -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 +330 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
package/dist/shell/lex.js CHANGED
@@ -617,7 +617,7 @@ const BARE_PARAMETER = /^(?:[A-Za-z_][A-Za-z0-9_]*|\d|[@*#?$!0-])/;
617
617
  const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
618
618
  const PER_ELEMENT_BODY = /^!?@|\[@\]|^![^}]*@$/;
619
619
  const NAME_HEAD = /^[A-Za-z_][A-Za-z0-9_]*/;
620
- function backtickBody(source, open) {
620
+ function backtickBody(source, open, inDouble = false) {
621
621
  let body = "";
622
622
  for (let j = open + 1; j < source.length; j++) {
623
623
  const c = source[j];
@@ -627,7 +627,7 @@ function backtickBody(source, open) {
627
627
  j++;
628
628
  continue;
629
629
  }
630
- body += next === "$" || next === "`" || next === "\\" ? next : c + next;
630
+ body += next === "$" || next === "`" || next === "\\" || (inDouble && next === '"') ? next : c + next;
631
631
  j++;
632
632
  continue;
633
633
  }
@@ -642,6 +642,7 @@ export function expansionsInHeredocBody(body) {
642
642
  }
643
643
  function expansionsInBody(body) {
644
644
  const out = [];
645
+ const push = (x, start, last) => (out.push({ ...x, span: [start, last + 1] }), last);
645
646
  for (let i = 0; i < body.length; i++) {
646
647
  const ch = body[i];
647
648
  if (ch === "\\") {
@@ -652,8 +653,7 @@ function expansionsInBody(body) {
652
653
  const tick = backtickBody(body, i);
653
654
  if (tick === undefined)
654
655
  return undefined;
655
- out.push({ expansion: { kind: "command", yields: "one", body: tick.body } });
656
- i = tick.close;
656
+ i = push({ expansion: { kind: "command", yields: "one", body: tick.body } }, i, tick.close);
657
657
  continue;
658
658
  }
659
659
  if (ch !== "$")
@@ -663,23 +663,20 @@ function expansionsInBody(body) {
663
663
  const close = substitutionBodyEnd(body, i + 1, true, 0, "document");
664
664
  if (typeof close !== "object" || !("end" in close))
665
665
  return undefined;
666
- out.push({ expansion: { kind: close.arithmetic ? "arithmetic" : "command", yields: "one", body: body.slice(i + 2, close.end - 1) } });
667
- i = close.end - 1;
666
+ i = push({ expansion: { kind: close.arithmetic ? "arithmetic" : "command", yields: "one", body: body.slice(i + 2, close.end - 1) } }, i, close.end - 1);
668
667
  }
669
668
  else if (open === "[") {
670
669
  const end = bracketExpansionEnd(body, i + 1);
671
670
  if (end === undefined)
672
671
  return undefined;
673
- out.push({ expansion: { kind: "arithmetic", yields: "one", body: body.slice(i + 2, end - 1) } });
674
- i = end - 1;
672
+ i = push({ expansion: { kind: "arithmetic", yields: "one", body: body.slice(i + 2, end - 1) } }, i, end - 1);
675
673
  }
676
674
  else if (open === "{") {
677
675
  if (opensCurrentShellSubstitution(body, i + 1)) {
678
676
  const run = currentShellSubstitutionEnd(body, i + 1, 1);
679
677
  if (typeof run !== "object" || !("end" in run))
680
678
  return undefined;
681
- out.push({ expansion: { kind: "command", yields: "one", body: body.slice(run.from, run.end - 1) }, currentShell: true });
682
- i = run.end - 1;
679
+ i = push({ expansion: { kind: "command", yields: "one", body: body.slice(run.from, run.end - 1) }, currentShell: true }, i, run.end - 1);
683
680
  continue;
684
681
  }
685
682
  const end = braceExpansionEnd(body, i + 1);
@@ -687,15 +684,13 @@ function expansionsInBody(body) {
687
684
  return undefined;
688
685
  const text = body.slice(i + 2, end - 1);
689
686
  const name = EXPANSION_NAME.exec(text)?.[1];
690
- out.push({ expansion: { kind: "parameter", yields: "one", body: text, ...(name !== undefined ? { name } : {}) }, ...(UNREADABLE_EXPANSION_TEXT.test(text) ? { unresolved: "parameter_text" } : {}) });
691
- i = end - 1;
687
+ i = push({ expansion: { kind: "parameter", yields: "one", body: text, ...(name !== undefined ? { name } : {}) }, ...(UNREADABLE_EXPANSION_TEXT.test(text) ? { unresolved: "parameter_text" } : {}) }, i, end - 1);
692
688
  }
693
689
  else {
694
690
  const head = BARE_PARAMETER.exec(body.slice(i + 1, i + 65))?.[0];
695
691
  if (head === undefined)
696
692
  continue;
697
- out.push({ expansion: { kind: "parameter", yields: "one", name: head } });
698
- i += head.length;
693
+ i = push({ expansion: { kind: "parameter", yields: "one", name: head } }, i, i + head.length);
699
694
  }
700
695
  }
701
696
  return out;
@@ -706,9 +701,14 @@ export function substitutionsInHeredocBody(body) {
706
701
  return undefined;
707
702
  return all.flatMap(({ expansion: e, currentShell }) => (e.kind === "command" || e.kind === "arithmetic" ? [{ body: e.body ?? "", kind: e.kind, ...(currentShell === true ? { currentShell } : {}) }] : []));
708
703
  }
709
- export function heredocBodyHidesRun(body) {
704
+ export function heredocRunsOf(body) {
710
705
  const all = expansionsInHeredocBody(body);
711
- return all === undefined || /[<>]\(/.test(body) || all.some((x) => x.unresolved !== undefined || expansionHidesRun(x.expansion));
706
+ if (all === undefined)
707
+ return HIDDEN_RUNS;
708
+ return joinRuns([/[<>]\(/.test(body) ? HIDDEN_RUNS : NO_RUNS, ...all.map((x) => (x.unresolved !== undefined ? joinRuns([HIDDEN_RUNS, expansionRunsOf(x.expansion)]) : expansionRunsOf(x.expansion)))]);
709
+ }
710
+ export function heredocBodyHidesRun(body) {
711
+ return runsAny(heredocRunsOf(body));
712
712
  }
713
713
  const SUBSTITUTION_OPENER = /\$\(|`|<\(|>\(|\$\[/;
714
714
  export function parameterArithmeticTexts(body) {
@@ -740,15 +740,32 @@ const TRANSFORM_FORM = new RegExp(String.raw `^${PARAMETER}(?:\[(?:'[^']*'|"(?:[
740
740
  const RESPELLING_TRANSFORMS = new Set(["Q", "E", "A", "K", "k", "a", "U", "u", "L"]);
741
741
  const NAME_OR_KEY_LIST = /^![A-Za-z_][A-Za-z0-9_]*(?:[*@]|\[[@*]\])$/;
742
742
  const PLAIN_ARITHMETIC = /^[\s\d+\-*/%&|^~!<>=?:,()]*$/;
743
- export function expansionHidesRun(e) {
744
- if (e.kind === "command" || e.kind === "process" || e.inner?.some(expansionHidesRun) === true)
745
- return true;
743
+ const NO_RUNS = { lines: [], hidden: false };
744
+ const HIDDEN_RUNS = { lines: [], hidden: true };
745
+ function joinRuns(parts) {
746
+ return { lines: parts.flatMap((p) => p.lines), hidden: parts.some((p) => p.hidden) };
747
+ }
748
+ const runsAny = (r) => r.hidden || r.lines.length > 0;
749
+ export function expansionRunsOf(e) {
750
+ const inner = joinRuns((e.inner ?? []).map(expansionRunsOf));
751
+ if (e.kind === "command" || e.kind === "process")
752
+ return joinRuns([e.body === undefined ? HIDDEN_RUNS : { lines: [e.body], hidden: false }, inner]);
746
753
  const body = e.body?.replace(/\\\n/g, "");
747
754
  if (body === undefined)
748
- return false;
755
+ return inner;
749
756
  if (e.kind === "arithmetic")
750
- return !PLAIN_ARITHMETIC.test(body);
751
- return SUBSTITUTION_OPENER.test(body) || (e.kind === "parameter" && (bodyEvaluatesText(body) || parameterRereadsValue(body))) || nestedBodyEvaluatesText(body);
757
+ return joinRuns([arithmeticTextRunsOf(body), inner]);
758
+ const hidden = SUBSTITUTION_OPENER.test(body) || (e.kind === "parameter" && (bodyEvaluatesText(body) || parameterRereadsValue(body))) || nestedBodyEvaluatesText(body);
759
+ return hidden ? joinRuns([HIDDEN_RUNS, inner]) : inner;
760
+ }
761
+ export function arithmeticTextRunsOf(text) {
762
+ if (arithmeticTextIsPlain(text))
763
+ return NO_RUNS;
764
+ const all = expansionsInHeredocBody(text);
765
+ return all === undefined ? HIDDEN_RUNS : joinRuns([HIDDEN_RUNS, ...all.map((x) => expansionRunsOf(x.expansion))]);
766
+ }
767
+ export function expansionHidesRun(e) {
768
+ return runsAny(expansionRunsOf(e));
752
769
  }
753
770
  export function assignedWords(w) {
754
771
  const elements = w.assignment?.form === "compound" ? w.assignment.elements : undefined;
@@ -786,8 +803,11 @@ export function arithmeticTextIsPlain(text) {
786
803
  export function subscriptHidesRun(w) {
787
804
  return w.assignment?.subscript !== undefined && !arithmeticTextIsPlain(w.assignment.subscript.raw);
788
805
  }
806
+ export function wordRunsOf(w) {
807
+ return joinRuns(assignedWords(w).flatMap((e) => [e.assignment?.form === "compound" || subscriptHidesRun(e) ? HIDDEN_RUNS : NO_RUNS, ...e.expansions.flatMap((p) => (p.expansion !== undefined ? [expansionRunsOf(p.expansion)] : []))]));
808
+ }
789
809
  export function wordHidesRun(w) {
790
- return assignedWords(w).some((e) => e.assignment?.form === "compound" || e.expansions.some((p) => p.expansion !== undefined && expansionHidesRun(p.expansion)) || subscriptHidesRun(e));
810
+ return runsAny(wordRunsOf(w));
791
811
  }
792
812
  export function namesRedirectDescriptor(next) {
793
813
  return (next?.kind === "redirect" || next?.kind === "heredoc") && next.allocated === true;
@@ -799,18 +819,38 @@ export function literalTextOf(pieces) {
799
819
  return pieces.every((q) => q.literal !== undefined) ? pieces.map((q) => q.literal).join("") : undefined;
800
820
  }
801
821
  export function literalHeredocBody(body) {
822
+ const run = heredocLiteralRun(body);
823
+ return run.expands ? undefined : run.text;
824
+ }
825
+ function heredocLiteralRun(text) {
802
826
  let out = "";
803
- for (let i = 0; i < body.length; i++) {
804
- const ch = body[i];
827
+ let expands = false;
828
+ for (let i = 0; i < text.length; i++) {
829
+ const ch = text[i];
805
830
  if (ch === "$" || ch === "`")
806
- return undefined;
807
- if (ch === "\\" && i + 1 < body.length && "$`\\".includes(body[i + 1])) {
808
- out += body[++i];
831
+ expands = true;
832
+ if (ch === "\\" && i + 1 < text.length && "$`\\".includes(text[i + 1])) {
833
+ out += text[++i];
809
834
  continue;
810
835
  }
811
836
  out += ch;
812
837
  }
813
- return out;
838
+ return { text: out, expands };
839
+ }
840
+ export function heredocBodyPieces(body) {
841
+ const expansions = expansionsInHeredocBody(body);
842
+ if (expansions === undefined)
843
+ return undefined;
844
+ const pieces = [];
845
+ let at = 0;
846
+ const literalTo = (end) => void (end > at && pieces.push({ span: [at, end], quotedBy: '"', literal: heredocLiteralRun(body.slice(at, end)).text }));
847
+ for (const x of expansions) {
848
+ literalTo(x.span[0]);
849
+ pieces.push({ span: x.span, quotedBy: '"', expansion: x.expansion });
850
+ at = x.span[1];
851
+ }
852
+ literalTo(body.length);
853
+ return pieces;
814
854
  }
815
855
  const BLANK = /[ \t]/;
816
856
  const fail = (reason, at) => ({ parseFailure: { reason, at } });
@@ -1504,7 +1544,7 @@ function scanText(source, connectorsAreText, segments, level, list) {
1504
1544
  continue;
1505
1545
  }
1506
1546
  if (ch === "`") {
1507
- const tick = backtickBody(source, i);
1547
+ const tick = backtickBody(source, i, inDouble);
1508
1548
  if (tick === undefined)
1509
1549
  return fail("unterminated_command_substitution", i);
1510
1550
  substitution(i, tick.close + 1, tick.body, "command");
@@ -16,6 +16,7 @@ export declare class FileBackgroundAgentStore implements BackgroundAgentStore {
16
16
  private readonly ledger;
17
17
  /** RB-145: this instance's own close latch — the refcount belongs to the DIRECTORY, not to callers. */
18
18
  private closed;
19
+ private readonly disclose;
19
20
  private get rows();
20
21
  constructor(root: string, options?: FileBackgroundAgentStoreOptions);
21
22
  /**
@@ -50,6 +51,10 @@ export declare class FileBackgroundAgentStore implements BackgroundAgentStore {
50
51
  status?: BackgroundAgentRecord["status"];
51
52
  limit?: number;
52
53
  }): Promise<BackgroundAgentRowSummary[]>;
54
+ listByRoot(rootSessionId: string, opts?: {
55
+ status?: BackgroundAgentRecord["status"];
56
+ limit?: number;
57
+ }): Promise<BackgroundAgentRowSummary[]>;
53
58
  listScopes(): Promise<string[]>;
54
59
  delete(handle: string, scope: string, expect?: {
55
60
  rev: number;
@@ -1,12 +1,12 @@
1
1
  import { join } from "node:path";
2
- import { BackgroundAgentStoreError, STALE_RUNNING_REAP_ATTRIBUTION, receiveBackgroundAgentReapOptions, queryBackgroundAgents, } from "../../core/background-agent-store.js";
2
+ import { BACKGROUND_AGENT_ROW_SHAPE, BackgroundAgentStoreError, admitBackgroundAgent, backgroundAgentReapCandidates, nextBackgroundAgentOnUpdate, receiveBackgroundAgentReapOptions, queryBackgroundAgents, readStoredBackgroundAgent, staleRunningFlip, } from "../../core/background-agent-store.js";
3
3
  import { SharedLedgerTable } from "./shared-ledger.js";
4
4
  import { guardCorruptSink } from "./corrupt-read-sink.js";
5
5
  import { assertAdoptionBootGate } from "./adoption/marker.js";
6
6
  import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
7
7
  import { readLedgerTuning } from "./ledger-tuning.js";
8
8
  const FILE_BACKGROUND_AGENT_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0, fsync: 0, compactEvery: 0 });
9
- const isAgentRow = (x) => x !== null && typeof x === "object" && typeof x.handle === "string" && typeof x.scope === "string";
9
+ const isAgentRow = (x) => BACKGROUND_AGENT_ROW_SHAPE.rowKey(x);
10
10
  const agentLedgers = new SharedLedgerTable({
11
11
  label: "background-agent ledger",
12
12
  keyOf: (r) => FileBackgroundAgentStore.key(r.handle, r.scope),
@@ -30,6 +30,7 @@ export class FileBackgroundAgentStore {
30
30
  compactEvery;
31
31
  ledger;
32
32
  closed = false;
33
+ disclose;
33
34
  get rows() {
34
35
  return this.ledger.rows;
35
36
  }
@@ -40,11 +41,14 @@ export class FileBackgroundAgentStore {
40
41
  this.fsyncEnabled = tuning.fsync;
41
42
  this.compactEvery = tuning.compactEvery;
42
43
  const dir = join(root, "background-agents");
44
+ const sink = guardCorruptSink(opts.onCorruptRead);
45
+ const ledgerPath = join(dir, "agents.jsonl");
46
+ this.disclose = sink === undefined ? undefined : (reason) => sink({ kind: "file", path: ledgerPath, reason });
43
47
  this.ledger = agentLedgers.acquire({
44
48
  dir,
45
49
  tmpDir: join(root, "tmp"),
46
- ...(opts.onCorruptRead !== undefined ? { onCorruptRead: guardCorruptSink(opts.onCorruptRead) } : {}),
47
- ledgerPath: join(dir, "agents.jsonl"),
50
+ ...(sink !== undefined ? { onCorruptRead: sink } : {}),
51
+ ledgerPath,
48
52
  snapshotPath: join(dir, "agents.snapshot.jsonl"),
49
53
  });
50
54
  }
@@ -58,62 +62,43 @@ export class FileBackgroundAgentStore {
58
62
  this.ledger.commit(ev, this.fsyncEnabled, this.compactEvery);
59
63
  }
60
64
  async put(record) {
61
- if (record.scope === undefined || record.scope === "") {
62
- throw new Error("BackgroundAgentStore.put: refusing a row without a scope (world-readable through the fallback)");
63
- }
65
+ const stored = structuredClone(record);
66
+ stored.rev = record.rev ?? 0;
64
67
  const k = FileBackgroundAgentStore.key(record.handle, record.scope);
68
+ const admitted = admitBackgroundAgent(stored, { key: k });
65
69
  return this.withLock(k, () => {
66
70
  if (this.rows.has(k)) {
67
71
  throw new BackgroundAgentStoreError("agent_record.already_exists", "agent record already exists");
68
72
  }
69
- const stored = structuredClone(record);
70
- stored.rev = record.rev ?? 0;
71
- this.commit({ t: "put", k, r: stored });
73
+ this.commit({ t: "put", k, r: admitted });
72
74
  });
73
75
  }
74
76
  async get(handle, scope) {
75
- const row = this.rows.get(FileBackgroundAgentStore.key(handle, scope));
76
- return row ? structuredClone(row) : null;
77
+ const k = FileBackgroundAgentStore.key(handle, scope);
78
+ const row = this.rows.get(k);
79
+ return row ? structuredClone(readStoredBackgroundAgent(row, { key: k }, this.disclose)) : null;
77
80
  }
78
81
  async update(handle, scope, record, expect) {
79
- const k = FileBackgroundAgentStore.key(handle, scope);
80
- return this.withLock(k, () => {
81
- const live = this.rows.get(k);
82
- if (!live || live.scope !== scope || live.rev !== expect.rev)
83
- return false;
84
- const stored = structuredClone(record);
85
- stored.handle = handle;
86
- stored.scope = scope;
87
- stored.rev = live.rev + 1;
88
- this.commit({ t: "update", k, r: stored });
89
- return true;
90
- });
82
+ return this.updateIf(handle, scope, record, { rev: expect.rev });
91
83
  }
92
84
  async updateIf(handle, scope, record, expect) {
93
85
  const k = FileBackgroundAgentStore.key(handle, scope);
94
86
  return this.withLock(k, async () => {
95
- const live = this.rows.get(k);
96
- if (!live || live.scope !== scope || live.rev !== expect.rev)
97
- return false;
98
- if (expect.status !== undefined && live.status !== expect.status)
87
+ const next = nextBackgroundAgentOnUpdate(this.rows.get(k), k, handle, scope, record, expect, this.disclose);
88
+ if (next === null)
99
89
  return false;
100
- if (expect.parkedCheckpointToken !== undefined && (expect.parkedCheckpointToken === null ? live.parkedCheckpointToken !== undefined : live.parkedCheckpointToken !== expect.parkedCheckpointToken))
101
- return false;
102
- if (expect.parkClaimId !== undefined && (expect.parkClaimId === null ? live.parkClaimId !== undefined : live.parkClaimId !== expect.parkClaimId))
103
- return false;
104
- const stored = structuredClone(record);
105
- stored.handle = handle;
106
- stored.scope = scope;
107
- stored.rev = live.rev + 1;
108
- this.commit({ t: "update", k, r: stored });
90
+ this.commit({ t: "update", k, r: next });
109
91
  return true;
110
92
  });
111
93
  }
112
94
  async listBySession(scope, sessionId, opts) {
113
- return queryBackgroundAgents(this.rows.values(), { scope, sessionId, status: opts?.status, limit: opts?.limit });
95
+ return queryBackgroundAgents(this.rows.values(), { scope, sessionId, status: opts?.status, limit: opts?.limit }, this.disclose);
114
96
  }
115
97
  async listByScope(scope, opts) {
116
- return queryBackgroundAgents(this.rows.values(), { scope, status: opts?.status, limit: opts?.limit });
98
+ return queryBackgroundAgents(this.rows.values(), { scope, status: opts?.status, limit: opts?.limit }, this.disclose);
99
+ }
100
+ async listByRoot(rootSessionId, opts) {
101
+ return queryBackgroundAgents(this.rows.values(), { root: rootSessionId, status: opts?.status, limit: opts?.limit });
117
102
  }
118
103
  async listScopes() {
119
104
  return [...new Set([...this.rows.values()].map((r) => r.scope))].sort();
@@ -136,22 +121,13 @@ export class FileBackgroundAgentStore {
136
121
  return 0;
137
122
  const changed = new Set();
138
123
  if (policy.staleRunningMaxAgeMs !== undefined) {
139
- const staleCandidates = [...this.rows.entries()]
140
- .filter(([, r]) => r.scope === scope && r.status === "running" && now - r.updatedAt > policy.staleRunningMaxAgeMs)
141
- .map(([k]) => k);
124
+ const staleMs = policy.staleRunningMaxAgeMs;
125
+ const staleCandidates = [...this.rows.entries()].filter(([k, r]) => staleRunningFlip(r, k, scope, now, staleMs, this.disclose) !== undefined).map(([k]) => k);
142
126
  for (const k of staleCandidates) {
143
127
  const flipped = await this.withLock(k, () => {
144
- const live = this.rows.get(k);
145
- if (!live || live.status !== "running" || now - live.updatedAt <= policy.staleRunningMaxAgeMs)
128
+ const next = staleRunningFlip(this.rows.get(k), k, scope, now, staleMs);
129
+ if (next === undefined)
146
130
  return false;
147
- const next = structuredClone(live);
148
- next.status = "failed";
149
- next.stoppedBy = "system";
150
- next.summary = next.summary ?? STALE_RUNNING_REAP_ATTRIBUTION;
151
- next.error = next.error ?? STALE_RUNNING_REAP_ATTRIBUTION;
152
- next.settledAt = now;
153
- next.updatedAt = now;
154
- next.rev = live.rev + 1;
155
131
  this.commit({ t: "update", k, r: next });
156
132
  return true;
157
133
  });
@@ -159,20 +135,18 @@ export class FileBackgroundAgentStore {
159
135
  changed.add(k);
160
136
  }
161
137
  }
162
- const terminal = [...this.rows.entries()]
163
- .filter(([, r]) => r.scope === scope && r.status !== "running" && r.status !== "parked")
164
- .sort(([, a], [, b]) => b.spawnedAt - a.spawnedAt);
138
+ const terminal = backgroundAgentReapCandidates(this.rows.entries(), scope, this.disclose);
165
139
  const doomed = new Map();
166
140
  if (policy.maxAgeMs !== undefined) {
167
- for (const [k, r] of terminal) {
168
- if ((r.settledAt ?? r.spawnedAt) < now - policy.maxAgeMs)
169
- doomed.set(k, { byAge: true });
141
+ for (const r of terminal) {
142
+ if (r.age < now - policy.maxAgeMs)
143
+ doomed.set(r.key, { byAge: true });
170
144
  }
171
145
  }
172
146
  if (policy.keep !== undefined) {
173
- for (const [k] of terminal.slice(Math.max(0, policy.keep))) {
174
- if (!doomed.has(k))
175
- doomed.set(k, { byAge: false });
147
+ for (const r of terminal.slice(Math.max(0, policy.keep))) {
148
+ if (!doomed.has(r.key))
149
+ doomed.set(r.key, { byAge: false });
176
150
  }
177
151
  }
178
152
  for (const [k, why] of doomed) {
@@ -96,8 +96,8 @@ export interface FileCheckpointStoreOptions {
96
96
  fsync?: boolean;
97
97
  /** Compact the ledger into a snapshot once it exceeds this many events (then truncate). Default 1000. */
98
98
  compactEvery?: number;
99
- /** The session head read (a session store's `headOf`) {@link FileCheckpointStore.deleteSessionCheckpoints} judges its guard by;
100
- * without it the store has no `deleteSessionCheckpoints` member. */
99
+ /** The session head read (a session store's `headOf`) {@link FileCheckpointStore.deleteSessionCheckpoints} judges its guard by and
100
+ * `deleteUnreadableSessionCheckpoints` judges unreadability by; without it the store has neither member. */
101
101
  sessionHeadOf?: (sessionId: string) => Promise<{
102
102
  readonly owner: string | null;
103
103
  } | undefined>;
@@ -189,6 +189,8 @@ export declare class FileCheckpointStore implements CheckpointStore {
189
189
  private readonly ledgerPath;
190
190
  /** Present exactly when the store was built with a session head read (`FileCheckpointStoreOptions.sessionHeadOf`). */
191
191
  readonly deleteSessionCheckpoints?: (sessionId: string, guard: CheckpointDeleteGuard) => Promise<number>;
192
+ /** Present exactly when {@link deleteSessionCheckpoints} is. */
193
+ readonly deleteUnreadableSessionCheckpoints?: (sessionId: string) => Promise<number>;
192
194
  constructor(root: string, options?: FileCheckpointStoreOptions);
193
195
  /** Serialize an op behind any in-flight op on the same token (the in-process per-token async mutex). */
194
196
  private withLock;
@@ -207,7 +209,7 @@ export declare class FileCheckpointStore implements CheckpointStore {
207
209
  get(token: CheckpointToken): Promise<Checkpoint | null>;
208
210
  resolve(token: CheckpointToken, scope: string, outcome: ResumeOutcome, expect?: ResolveExpectation): Promise<boolean>;
209
211
  recordExecutionOutcome(token: CheckpointToken, scope: string, gate: GateOutcome): Promise<ExecutionOutcomeRecordWord>;
210
- reopen(token: CheckpointToken, scope: string, reason: ReopenReason): Promise<boolean>;
212
+ reopen(token: CheckpointToken, scope: string, reason: ReopenReason, expect?: Pick<ResolveExpectation, "rev">): Promise<boolean>;
211
213
  setPendingSteer(token: CheckpointToken, scope: string, steer: PendingSteerInput): Promise<boolean>;
212
214
  expire(token: CheckpointToken, scope: string): Promise<boolean>;
213
215
  reap(scope: string, cutoff: number): Promise<number>;
@@ -6,7 +6,7 @@ import { readRetentionDeclaration } from "../../core/retention.js";
6
6
  import { checkpointExecutionRecorded, executionRecordDisposition, ExecutionOutcomeConflictError, } from "../../core/checkpoint-execution-record.js";
7
7
  import { checkpointHolderMatches, checkpointOccMatches, checkpointRevOf } from "../../core/checkpoint-generation.js";
8
8
  import { appendPendingSteer, CheckpointError, checkpointRowMatches, encodeAtFidelity, summarizeStoredCheckpoint, validatePendingSteer, winnerFromOutcome, } from "../../core/checkpoint-store.js";
9
- import { checkpointDeadlinePassed, deleteSessionRowsAtStart, readCheckpointOverdueQuery, readCheckpointSessionQuery, selectOverduePage, selectSessionPage, } from "../../core/checkpoint-queries.js";
9
+ import { CHECKPOINT_ROW_SHAPE, checkpointDeadlinePassed, deleteSessionRowsAtStart, ownerSessionRowsDelete, unreadableSessionRowsDelete, readCheckpointOverdueQuery, readCheckpointSessionQuery, selectOverduePage, selectSessionPage, } from "../../core/checkpoint-queries.js";
10
10
  import { readLedgerSettled, SharedLedgerTable } from "./shared-ledger.js";
11
11
  import { guardCorruptSink } from "./corrupt-read-sink.js";
12
12
  const FILE_CHECKPOINT_STORE_OPTION_KEYS = optionKeys()({ onCorruptRead: 0, fsync: 0, compactEvery: 0, sessionHeadOf: 0, holderIsCurrent: 0, retention: 0 });
@@ -60,11 +60,7 @@ function applyCheckpointEvent(cps, ev) {
60
60
  }
61
61
  }
62
62
  }
63
- const isCheckpointRow = (x) => x !== null &&
64
- typeof x === "object" &&
65
- typeof x.token === "string" &&
66
- typeof x.scope === "string" &&
67
- typeof x.status === "string";
63
+ const isCheckpointRow = (x) => CHECKPOINT_ROW_SHAPE.rowKey(x);
68
64
  const checkpointLedgerModel = {
69
65
  label: "checkpoint ledger",
70
66
  keyOf: (cp) => cp.token,
@@ -131,12 +127,14 @@ export class FileCheckpointStore {
131
127
  });
132
128
  const headOf = opts.sessionHeadOf;
133
129
  if (headOf !== undefined) {
134
- this.deleteSessionCheckpoints = (sessionId, guard) => deleteSessionRowsAtStart(this.cps, sessionId, guard, headOf, (token, row) => this.withLock(token, () => {
130
+ const remove = (token, row) => this.withLock(token, () => {
135
131
  if (this.cps.get(token) !== row)
136
132
  return false;
137
133
  this.commit({ t: "delete", token }, true);
138
134
  return true;
139
- }));
135
+ });
136
+ this.deleteSessionCheckpoints = async (sessionId, guard) => deleteSessionRowsAtStart(this.cps, ownerSessionRowsDelete(sessionId, guard, headOf), remove);
137
+ this.deleteUnreadableSessionCheckpoints = async (sessionId) => deleteSessionRowsAtStart(this.cps, unreadableSessionRowsDelete(sessionId, headOf), remove);
140
138
  }
141
139
  }
142
140
  withLock(token, fn) {
@@ -199,10 +197,10 @@ export class FileCheckpointStore {
199
197
  return "recorded";
200
198
  });
201
199
  }
202
- async reopen(token, scope, reason) {
200
+ async reopen(token, scope, reason, expect) {
203
201
  return this.withLock(token, () => {
204
202
  const cp = this.cps.get(token);
205
- if (!checkpointRowMatches(cp, scope, "resolved") || checkpointExecutionRecorded(cp)) {
203
+ if (!checkpointRowMatches(cp, scope, "resolved") || !checkpointOccMatches(cp, expect) || checkpointExecutionRecorded(cp)) {
206
204
  return false;
207
205
  }
208
206
  const rev = checkpointRevOf(cp) + 1;
@@ -1,3 +1,5 @@
1
+ import { type ProcessUncheckable } from "../../core/process-identity.js";
2
+ export { processFingerprint, isProcessLive, type ProcessFingerprint } from "../../core/process-identity.js";
1
3
  import type { CorruptRecordRead, CorruptReplayTally } from "./corrupt-read-sink.js";
2
4
  /**
3
5
  * Validate an engine-minted id (sessionId / tool-result ref) before using it as a path component. These are
@@ -15,7 +17,6 @@ export declare function sanitizeScope(scope: string): string;
15
17
  /** Resolve the data root (CC `getClaudeConfigHomeDir` analog): `$AGENT_DATA_DIR ?? ~/.ai-agent`,
16
18
  * NFC-normalized, canonicalized once the dir exists. Creates the dir (0o700) if absent. */
17
19
  export declare function resolveDataRoot(explicit?: string): string;
18
- /** Ensure a directory exists with 0o700 perms (idempotent). */
19
20
  /**
20
21
  * Atomically CREATE `target` carrying `content` — it appears in ONE step already fully written, no empty/partial
21
22
  * window. Fixes the create-then-write race: a reader/pruner can see a half-written
@@ -23,6 +24,7 @@ export declare function resolveDataRoot(explicit?: string): string;
23
24
  * OWN dir (same FS → `link` is atomic) + fsync, then `linkSync`-publishes it; throws `EEXIST` if `target` exists.
24
25
  */
25
26
  export declare function writeThenLink(target: string, content: string | Uint8Array): void;
27
+ /** Ensure a directory exists with 0o700 perms (idempotent). */
26
28
  export declare function ensureDir(dir: string): void;
27
29
  /**
28
30
  * The 5-step atomic whole-file replace (§2.1). Skipping any of steps 3/5/6 is the classic corruption bug:
@@ -236,13 +238,36 @@ export declare class FileStoreLockError extends Error {
236
238
  readonly lockPath: string;
237
239
  /** The live owner's pid when the lock named one (absent for an unreadable lock or a lost race). */
238
240
  readonly ownerPid?: number | undefined;
241
+ /**
242
+ * Present when the owner was NOT proven running but could not be proven gone either — the lock names a
243
+ * process this host cannot check (another host, another pid namespace, a record that names no namespace,
244
+ * no comparable start time, a process table that refused the question). The owner may still be running;
245
+ * nothing proves it is, so the refusal is the same `store.dir_in_use` with the cause attached, and the
246
+ * remedy is a person's: remove {@link lockPath} if no process uses the directory.
247
+ */
248
+ readonly ownerUncheckable?: ProcessUncheckable | undefined;
239
249
  readonly name = "FileStoreLockError";
240
250
  constructor(code: FileStoreLockErrorCode, message: string,
241
251
  /** The lock file whose acquisition was refused. */
242
252
  lockPath: string,
243
253
  /** The live owner's pid when the lock named one (absent for an unreadable lock or a lost race). */
244
- ownerPid?: number | undefined);
254
+ ownerPid?: number | undefined,
255
+ /**
256
+ * Present when the owner was NOT proven running but could not be proven gone either — the lock names a
257
+ * process this host cannot check (another host, another pid namespace, a record that names no namespace,
258
+ * no comparable start time, a process table that refused the question). The owner may still be running;
259
+ * nothing proves it is, so the refusal is the same `store.dir_in_use` with the cause attached, and the
260
+ * remedy is a person's: remove {@link lockPath} if no process uses the directory.
261
+ */
262
+ ownerUncheckable?: ProcessUncheckable | undefined);
245
263
  }
264
+ /** The clause every refusal of an uncheckable lock owner says, whichever store words the rest — `undefined`
265
+ * for a refusal whose owner was proven running (or that names no owner). */
266
+ export declare function uncheckableOwnerClause(err: {
267
+ readonly lockPath: string;
268
+ readonly ownerPid?: number;
269
+ readonly ownerUncheckable?: ProcessUncheckable;
270
+ }): string | undefined;
246
271
  /**
247
272
  * The coarse boot guard (§2.4): an `O_EXCL` owner file (`root/LOCK` for the whole data dir; one per store
248
273
  * ledger directory via {@link acquireStoreDirLock}) that forbids two processes sharing it. A second
@@ -374,71 +399,3 @@ export declare function acquireStoreDirLock(dir: string, opts: {
374
399
  label: string;
375
400
  fileName?: string;
376
401
  }): StoreDirLockLease;
377
- /**
378
- * A process identity that survives PID REUSE: a pid, WHEN that pid's process started, and the host the
379
- * observation was made on.
380
- *
381
- * A pid alone is not an identity. The OS hands the same number out again once its holder exits, so a lock
382
- * (or lease, or any other durable "who owns this" record) carrying only a pid says no more than "somebody
383
- * with that number" — and after a crash, an unrelated process that inherits the number makes the dead
384
- * owner's record read as a LIVE owner for as long as that process lives. Adding the START TIME makes the
385
- * record falsifiable: the pid narrows the candidate to one process, the start time decides whether it is
386
- * still the SAME one.
387
- *
388
- * The start time is carried TWICE, against two different clocks, and that is the whole robustness of the
389
- * thing. Both numbers come from ONE reading of the process's elapsed time, but one is subtracted from the
390
- * WALL clock and the other from the host's UPTIME — and a platform that leaves one of them unmoved when
391
- * the wall clock is corrected moves the other. (Where `ps` measures elapsed time against the boot clock, a
392
- * corrected wall clock shifts the derived wall-clock start and leaves the uptime-relative one alone; where
393
- * it measures against a stored absolute start, it is the other way round.) A comparison that insists on
394
- * BOTH before calling a record stale therefore cannot be talked into a reclaim by a clock correction —
395
- * which matters because that reclaim would be of a LIVE writer's lock. See {@link isProcessLive}.
396
- *
397
- * Both are `null` when this host cannot produce a start time (no `ps`, a cut-down `ps` that rejects the
398
- * query, a probe too slow for its own reading to be worth anything). That is a plain "unknown" — never a
399
- * zero and never a guess — and every consumer treats an unobtainable fingerprint as UNFALSIFIABLE, keeping
400
- * the pid-only verdict: the degrade lands on yesterday's behaviour rather than on a wrong reclaim, and
401
- * says so out loud once.
402
- */
403
- export interface ProcessFingerprint {
404
- /** The process id the rest of the record is about. */
405
- readonly pid: number;
406
- /** Start of that pid's process against the WALL clock, to the second; `null` when unobtainable here. */
407
- readonly startedAtMs: number | null;
408
- /** The same start against this host's UPTIME (ms after boot), to the second; `null` likewise. */
409
- readonly startedSinceBootMs: number | null;
410
- /** The host both were read on — a fingerprint from ANOTHER host is comparable to nothing here. */
411
- readonly host: string;
412
- }
413
- /**
414
- * The fingerprint of a process: this one when called with no pid, any other pid when named.
415
- *
416
- * ONE derivation for both halves of the mechanism — the record a holder WRITES and the probe a later reader
417
- * verifies it with — on purpose. Deriving our own start time from `process.uptime()` instead would be
418
- * cheaper, but it measures from Node's own initialisation rather than from the kernel's `exec`, so a busy
419
- * machine can put the two derivations seconds apart. A reader comparing across them would then read a
420
- * healthy holder as stale and RECLAIM A LIVE LOCK — a strictly worse failure than the pid reuse this fixes.
421
- * One derivation makes the tolerance a rounding allowance instead of a guess about bootstrap latency.
422
- *
423
- * The self case is memoized: our start time cannot change, the probe is a subprocess, and a lock publish is
424
- * the only place that needs it — so a process pays for it at most once, whatever it opens.
425
- */
426
- export declare function processFingerprint(pid?: number): ProcessFingerprint;
427
- /**
428
- * Is the process a record names still the one that wrote it? ONE predicate, two terms: the pid is running,
429
- * AND the fingerprint has not been falsified.
430
- *
431
- * "Not falsified" is the load-bearing wording, and it is what every degrade lands on. A record with no
432
- * `startedAtMs` (the pre-fingerprint spelling, or a host that cannot produce one), a record written on
433
- * ANOTHER host (its start time was measured against a different boot — comparing it here would be
434
- * arithmetic on unrelated numbers), and a probe that cannot answer all reach the same verdict: LIVE. The
435
- * asymmetry is deliberate and is the whole safety argument — a false "dead" reclaims a directory out from
436
- * under a working process (two writers, and the ledger loses whichever rows the loser never loaded), while
437
- * a false "live" costs a refusal an operator can act on.
438
- */
439
- export declare function isProcessLive(record: {
440
- readonly pid: number;
441
- readonly startedAtMs?: number | null;
442
- readonly startedSinceBootMs?: number | null;
443
- readonly host?: string | null;
444
- }): boolean;