@sema-agent/core 7.66.0 → 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 (903) hide show
  1. package/CHANGELOG.md +3498 -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 +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
  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.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -1,12 +1,12 @@
1
- import { appendFileSync, closeSync, constants as FS, existsSync, fstatSync, ftruncateSync, linkSync, mkdirSync, openSync, readFileSync, readSync, renameSync, statSync, truncateSync, unlinkSync, writeFileSync, writeSync, fsyncSync, } from "node:fs";
1
+ import { appendFileSync, closeSync, existsSync, fstatSync, ftruncateSync, linkSync, mkdirSync, openSync, readFileSync, readSync, renameSync, statSync, truncateSync, unlinkSync, writeFileSync, writeSync, fsyncSync, } from "node:fs";
2
2
  import { constants as bufferConstants } from "node:buffer";
3
- import { homedir, hostname, uptime } from "node:os";
4
- import { hrtime } from "node:process";
3
+ import { homedir } from "node:os";
5
4
  import { basename, dirname, join, resolve as resolvePath } from "node:path";
6
- import { createHash, randomBytes } from "node:crypto";
7
- import { execFileSync } from "node:child_process";
8
- import { inheritedHostEnv } from "../../core/secret-env.js";
5
+ import { createHash } from "node:crypto";
6
+ import { openExclusiveTemp, PRIVATE_FILE_MODE } from "../../core/exclusive-temp.js";
9
7
  import { physicalPathOf, physicalPathOfExisting } from "../../core/physical-path.js";
8
+ import { processCensus, processFingerprint, uncheckableProcessText, } from "../../core/process-identity.js";
9
+ export { processFingerprint, isProcessLive } from "../../core/process-identity.js";
10
10
  import { thrownText } from "../../core/thrown-value.js";
11
11
  const SAFE_COMPONENT = /^[A-Za-z0-9_.-]+$/;
12
12
  export function sanitizePathComponent(raw) {
@@ -19,17 +19,17 @@ export function sanitizeScope(scope) {
19
19
  const base = scope.replace(/[^A-Za-z0-9]/g, "-");
20
20
  return `${(base || "_").slice(0, 120)}-${createHash("sha256").update(scope, "utf8").digest("hex")}`;
21
21
  }
22
+ const PRIVATE_DIR_MODE = 0o700;
22
23
  export function resolveDataRoot(explicit) {
23
24
  const raw = (explicit ?? process.env.AGENT_DATA_DIR ?? join(homedir(), ".ai-agent")).normalize("NFC");
24
- mkdirSync(raw, { recursive: true, mode: 0o700 });
25
+ mkdirSync(raw, { recursive: true, mode: PRIVATE_DIR_MODE });
25
26
  return physicalPathOf(raw);
26
27
  }
27
28
  export function writeThenLink(target, content) {
28
29
  ensureDir(dirnameOf(target));
29
- const tmp = `${target}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
30
+ const { fd, path: tmp } = openExclusiveTemp(target);
30
31
  let linked = false;
31
32
  try {
32
- const fd = openSync(tmp, FS.O_CREAT | FS.O_EXCL | FS.O_WRONLY, 0o600);
33
33
  try {
34
34
  writeFileSync(fd, content);
35
35
  fsyncSync(fd);
@@ -51,14 +51,14 @@ export function writeThenLink(target, content) {
51
51
  fsyncDir(dirnameOf(target));
52
52
  }
53
53
  export function ensureDir(dir) {
54
- mkdirSync(dir, { recursive: true, mode: 0o700 });
54
+ mkdirSync(dir, { recursive: true, mode: PRIVATE_DIR_MODE });
55
55
  }
56
56
  export function atomicWriteFile(tmpDir, target, bytes) {
57
57
  ensureDir(tmpDir);
58
- const tmp = join(tmpDir, `${basenameOf(target)}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`);
59
- let fd;
58
+ const opened = openExclusiveTemp(join(tmpDir, basenameOf(target)));
59
+ const tmp = opened.path;
60
+ let fd = opened.fd;
60
61
  try {
61
- fd = openSync(tmp, "w", 0o600);
62
62
  writeFileSync(fd, bytes);
63
63
  fsyncSync(fd);
64
64
  closeSync(fd);
@@ -248,7 +248,7 @@ export class AppendLog {
248
248
  this.path = path;
249
249
  ensureDir(dirnameOf(path));
250
250
  repairJsonlTail(path);
251
- this.fd = openSync(path, "a+", 0o600);
251
+ this.fd = openSync(path, "a+", PRIVATE_FILE_MODE);
252
252
  this.boundary = this.sizeOrUnknown();
253
253
  }
254
254
  sizeOrUnknown() {
@@ -288,7 +288,7 @@ export class AppendLog {
288
288
  append(record, fsync) {
289
289
  if (this.fd < 0 && !this.disposed) {
290
290
  repairJsonlTail(this.path);
291
- this.fd = openSync(this.path, "a+", 0o600);
291
+ this.fd = openSync(this.path, "a+", PRIVATE_FILE_MODE);
292
292
  this.boundary = this.sizeOrUnknown();
293
293
  }
294
294
  if (this.fd < 0) {
@@ -431,14 +431,22 @@ export class FileStoreLockError extends Error {
431
431
  code;
432
432
  lockPath;
433
433
  ownerPid;
434
+ ownerUncheckable;
434
435
  name = "FileStoreLockError";
435
- constructor(code, message, lockPath, ownerPid) {
436
+ constructor(code, message, lockPath, ownerPid, ownerUncheckable) {
436
437
  super(message);
437
438
  this.code = code;
438
439
  this.lockPath = lockPath;
439
440
  this.ownerPid = ownerPid;
441
+ this.ownerUncheckable = ownerUncheckable;
440
442
  }
441
443
  }
444
+ export function uncheckableOwnerClause(err) {
445
+ if (err.ownerUncheckable === undefined)
446
+ return undefined;
447
+ return (`its owner${err.ownerPid !== undefined ? ` (pid ${err.ownerPid})` : ""} cannot be checked from here — ` +
448
+ `${uncheckableProcessText(err.ownerUncheckable)} — so it may still be running; if no process uses it, remove ${err.lockPath}`);
449
+ }
442
450
  const MAX_RECLAIM_DEPTH = 8;
443
451
  const MAX_ACQUIRE_ATTEMPTS = 4;
444
452
  const abandonedLocks = new Set();
@@ -451,13 +459,14 @@ function serializeLockRecord() {
451
459
  startedAtMs: fp.startedAtMs,
452
460
  startedSinceBootMs: fp.startedSinceBootMs,
453
461
  host: fp.host,
462
+ ...(fp.pidNs !== undefined ? { pidNs: fp.pidNs } : {}),
454
463
  });
455
464
  }
456
465
  function parseLockRecord(raw) {
457
466
  if (/^[1-9][0-9]*$/.test(raw)) {
458
467
  const barePid = Number.parseInt(raw, 10);
459
468
  return Number.isSafeInteger(barePid) && barePid > 0
460
- ? { pid: barePid, startedAtMs: null, startedSinceBootMs: null, host: null }
469
+ ? { pid: barePid, startedAtMs: null, startedSinceBootMs: null, host: null, pidNs: null }
461
470
  : null;
462
471
  }
463
472
  if (!raw.startsWith("{"))
@@ -481,6 +490,7 @@ function parseLockRecord(raw) {
481
490
  startedAtMs: measure(rec.startedAtMs),
482
491
  startedSinceBootMs: measure(rec.startedSinceBootMs),
483
492
  host: known && typeof rec.host === "string" && rec.host !== "" ? rec.host : null,
493
+ pidNs: known && typeof rec.pidNs === "string" && rec.pidNs !== "" ? rec.pidNs : null,
484
494
  };
485
495
  }
486
496
  function readLockRecord(lockPath) {
@@ -498,7 +508,8 @@ function sameOwner(a, b) {
498
508
  return (a.pid === b.pid &&
499
509
  a.startedAtMs === b.startedAtMs &&
500
510
  a.startedSinceBootMs === b.startedSinceBootMs &&
501
- a.host === b.host);
511
+ a.host === b.host &&
512
+ a.pidNs === b.pidNs);
502
513
  }
503
514
  export class BootLock {
504
515
  lockPath;
@@ -532,9 +543,14 @@ export class BootLock {
532
543
  this.pruneOwnAbandoned();
533
544
  return;
534
545
  }
535
- if (isProcessLive(owner)) {
546
+ const verdict = processCensus().verdict(owner);
547
+ if (verdict.state === "running") {
536
548
  throw new FileStoreLockError("store.dir_in_use", `file store: another instance (pid ${owner.pid}) owns this data dir (${dirnameOf(this.lockPath)})`, this.lockPath, owner.pid);
537
549
  }
550
+ if (verdict.state === "uncheckable") {
551
+ const clause = uncheckableOwnerClause({ lockPath: this.lockPath, ownerPid: owner.pid, ownerUncheckable: verdict.why });
552
+ throw new FileStoreLockError("store.dir_in_use", `file store: the lock on this data dir (${dirnameOf(this.lockPath)}): ${clause}`, this.lockPath, owner.pid, verdict.why);
553
+ }
538
554
  if (depth >= MAX_RECLAIM_DEPTH) {
539
555
  throw new FileStoreLockError("store.lock_unreadable", `file store: lock file at ${this.lockPath} is buried under ${depth} nested stale reclaim gates ` +
540
556
  `(repeated crashes mid-reclaim); remove the ${basenameOf(this.lockPath)}.claim.* files manually`, this.lockPath);
@@ -544,7 +560,10 @@ export class BootLock {
544
560
  gate.acquireWithin(depth + 1);
545
561
  }
546
562
  catch (err) {
547
- if (err instanceof FileStoreLockError && err.code === "store.dir_in_use" && err.ownerPid !== undefined) {
563
+ if (err instanceof FileStoreLockError &&
564
+ err.code === "store.dir_in_use" &&
565
+ err.ownerPid !== undefined &&
566
+ err.ownerUncheckable === undefined) {
548
567
  throw new FileStoreLockError("store.dir_claiming", `file store: another instance${err.ownerPid !== undefined ? ` (pid ${err.ownerPid})` : ""} is claiming ` +
549
568
  `this data dir (${dirnameOf(this.lockPath)}) from a stale lock`, this.lockPath, err.ownerPid);
550
569
  }
@@ -699,17 +718,21 @@ export function acquireStoreDirLock(dir, opts) {
699
718
  const who = err.ownerPid !== undefined ? ` (pid ${err.ownerPid})` : "";
700
719
  const single = `This backend is SINGLE-WRITER per directory: a second process replays a private view (both sides can ` +
701
720
  `win a once-only decision) and its next compaction erases the records it never loaded.`;
702
- throw new FileStoreLockError(err.code, err.code === "store.lock_unreadable"
721
+ const unchecked = uncheckableOwnerClause(err);
722
+ throw new FileStoreLockError(err.code, unchecked !== undefined
703
723
  ?
704
- `file store: the ${opts.label} directory (${dir}) cannot be opened — ${err.message}`
705
- : err.code === "store.dir_claiming"
724
+ `file store: the ${opts.label} directory (${dir}) is locked and ${unchecked}. ${single}`
725
+ : err.code === "store.lock_unreadable"
706
726
  ?
707
- `file store: another OS process${who} is claiming this data dir — it is reclaiming the ${opts.label} ` +
708
- `directory (${dir}) from a lock a crashed owner left behind. ${single} Retry in a moment: either that ` +
709
- `process finishes and owns the directory, or it dies and the next start reclaims it.`
710
- : `file store: another OS process${who} is using the ${opts.label} directory (${dir}). ${single} Stop the ` +
711
- `other process, point this one at a different data root, or use the pg/tidb backend for real ` +
712
- `multi-process concurrency.`, err.code === "store.lock_unreadable" ? err.lockPath : lockPath, err.ownerPid);
727
+ `file store: the ${opts.label} directory (${dir}) cannot be opened — ${err.message}`
728
+ : err.code === "store.dir_claiming"
729
+ ?
730
+ `file store: another OS process${who} is claiming this data dir — it is reclaiming the ${opts.label} ` +
731
+ `directory (${dir}) from a lock a crashed owner left behind. ${single} Retry in a moment: either that ` +
732
+ `process finishes and owns the directory, or it dies and the next start reclaims it.`
733
+ : `file store: another OS process${who} is using the ${opts.label} directory (${dir}). ${single} Stop the ` +
734
+ `other process, point this one at a different data root, or use the pg/tidb backend for real ` +
735
+ `multi-process concurrency.`, err.code === "store.lock_unreadable" || unchecked !== undefined ? err.lockPath : lockPath, err.ownerPid, err.ownerUncheckable);
713
736
  }
714
737
  throw err;
715
738
  }
@@ -717,122 +740,3 @@ export function acquireStoreDirLock(dir, opts) {
717
740
  heldStoreDirLocks.set(key, entry);
718
741
  return lease(entry);
719
742
  }
720
- function isProcessRunning(pid) {
721
- try {
722
- process.kill(pid, 0);
723
- return true;
724
- }
725
- catch (err) {
726
- return err.code === "EPERM";
727
- }
728
- }
729
- const START_TIME_TOLERANCE_MS = 2_000;
730
- const START_TIME_PROBE_TIMEOUT_MS = 2_000;
731
- const START_TIME_PROBE_PRECISION_MS = 250;
732
- const ETIME_PATTERN = /^(?:(\d+)-)?(?:(\d+):)?(\d+):(\d+)$/;
733
- let cachedHostname;
734
- let selfFingerprint;
735
- let startTimeProbeUnavailable = false;
736
- function thisHost() {
737
- return (cachedHostname ??= hostname());
738
- }
739
- function announceStartTimeDegrade(reason) {
740
- if (startTimeProbeUnavailable)
741
- return;
742
- startTimeProbeUnavailable = true;
743
- console.warn(`[sema] file store: this host cannot report process start times (${reason}), so a directory lock's owner ` +
744
- `is judged by PID ALONE. A lock left behind by a crashed owner whose pid the OS has since handed to an ` +
745
- `unrelated process then reads as a LIVE owner, and that directory stays refused until the lock file is ` +
746
- `removed by hand.`);
747
- }
748
- const START_TIME_PROBE_ATTEMPTS = 3;
749
- function probeStartTimes(pid) {
750
- for (let attempt = 0; attempt < START_TIME_PROBE_ATTEMPTS; attempt++) {
751
- const reading = probeStartTimesOnce(pid);
752
- if (reading !== "imprecise")
753
- return reading;
754
- }
755
- return null;
756
- }
757
- function probeStartTimesOnce(pid) {
758
- if (startTimeProbeUnavailable)
759
- return null;
760
- const knownToExist = pid === process.pid;
761
- if (process.platform === "win32") {
762
- announceStartTimeDegrade("no ps(1) on win32");
763
- return null;
764
- }
765
- const monotonicBefore = hrtime.bigint();
766
- const wallBefore = Date.now();
767
- const uptimeBefore = Math.round(uptime() * 1000);
768
- let raw;
769
- try {
770
- raw = execFileSync("ps", ["-p", String(pid), "-o", "etime="], {
771
- encoding: "utf8",
772
- timeout: START_TIME_PROBE_TIMEOUT_MS,
773
- stdio: ["ignore", "pipe", "ignore"],
774
- env: { ...inheritedHostEnv("scrub"), LC_ALL: "C", LANG: "C" },
775
- });
776
- }
777
- catch (err) {
778
- if (typeof err.status === "number") {
779
- if (knownToExist)
780
- announceStartTimeDegrade("ps refused a query about this very process");
781
- return null;
782
- }
783
- announceStartTimeDegrade(`ps failed (${err.code ?? "unknown"})`);
784
- return null;
785
- }
786
- const latency = Number(hrtime.bigint() - monotonicBefore) / 1e6;
787
- const wallDelta = Date.now() - wallBefore;
788
- const trimmed = raw.trim();
789
- const parts = ETIME_PATTERN.exec(trimmed);
790
- if (parts === null) {
791
- if (trimmed !== "" || knownToExist)
792
- announceStartTimeDegrade("ps produced no elapsed time");
793
- return null;
794
- }
795
- if (latency > START_TIME_PROBE_PRECISION_MS)
796
- return "imprecise";
797
- if (Math.abs(wallDelta - latency) > START_TIME_PROBE_PRECISION_MS)
798
- return "imprecise";
799
- const elapsedMs = (Number(parts[1] ?? "0") * 86_400 + Number(parts[2] ?? "0") * 3_600 + Number(parts[3] ?? "0") * 60 + Number(parts[4] ?? "0")) *
800
- 1000;
801
- return {
802
- startedAtMs: Math.round((wallBefore - elapsedMs) / 1000) * 1000,
803
- startedSinceBootMs: Math.round((uptimeBefore - elapsedMs) / 1000) * 1000,
804
- };
805
- }
806
- export function processFingerprint(pid) {
807
- const host = thisHost();
808
- const of = (id, probed) => ({
809
- pid: id,
810
- startedAtMs: probed?.startedAtMs ?? null,
811
- startedSinceBootMs: probed?.startedSinceBootMs ?? null,
812
- host,
813
- });
814
- if (pid === undefined || pid === process.pid) {
815
- if (selfFingerprint === undefined || selfFingerprint.startedAtMs === null) {
816
- const answer = of(process.pid, probeStartTimes(process.pid));
817
- if (answer.startedAtMs === null)
818
- return answer;
819
- selfFingerprint = answer;
820
- }
821
- return selfFingerprint;
822
- }
823
- if (processFingerprint().startedAtMs === null)
824
- return of(pid, null);
825
- return of(pid, probeStartTimes(pid));
826
- }
827
- export function isProcessLive(record) {
828
- if (!isProcessRunning(record.pid))
829
- return false;
830
- if (record.host !== undefined && record.host !== null && record.host !== thisHost())
831
- return true;
832
- const observed = processFingerprint(record.pid);
833
- const falsified = (was, now) => was !== undefined && was !== null && now !== null && now - was > START_TIME_TOLERANCE_MS;
834
- const bootIsOver = (was) => was !== undefined && was !== null && was - Math.round(uptime() * 1000) > START_TIME_TOLERANCE_MS;
835
- const wallSaysGone = falsified(record.startedAtMs, observed.startedAtMs);
836
- const uptimeSaysGone = falsified(record.startedSinceBootMs, observed.startedSinceBootMs) || bootIsOver(record.startedSinceBootMs);
837
- return !(wallSaysGone && uptimeSaysGone);
838
- }
@@ -113,6 +113,18 @@ export interface FileStorageBackendOptions {
113
113
  /** The deployment's hooks on the session store's row deletions ({@link SessionStoreHooks}) — the File lane has no foreign keys, so a
114
114
  * deployment's own records keyed by session id are cleaned here, before each row the session store deletes. */
115
115
  sessions?: SessionStoreHooks;
116
+ /**
117
+ * The caller's admission of this data root: the one seat between "this process holds the root's lock" and "this backend has
118
+ * written under it", for a host that must refuse a root it is not fit to serve while the refusal still leaves the root as found.
119
+ * 1. Called exactly once, synchronously, after the boot lock on `<root>/LOCK` is held and before any store is constructed (the
120
+ * checkpoint ledger's torn-tail repair included), with the resolved canonical root ({@link FileStorageBackend.root}).
121
+ * 2. A throw refuses the root: the lock is released, no store of this backend has written under the root, and the thrown value
122
+ * propagates as the same object, neither wrapped nor retyped (a host branches on its own class). Any return but `undefined`
123
+ * refuses the same way (`config.invalid_argument`); a returned promise's later rejection is absorbed, never left unhandled.
124
+ * A refused open leaves only what taking the lock did: a root that did not exist is created, a dead owner's stale lock is gone.
125
+ * Not a function ⇒ `config.invalid_argument` before the root is touched. While it runs the root is locked to every other opener.
126
+ */
127
+ admit?: (root: string) => void;
116
128
  }
117
129
  /**
118
130
  * The payload of {@link FileStorageBackendOptions.onCorruptRead} — the widest shape any store this
@@ -1,4 +1,5 @@
1
1
  import { join } from "node:path";
2
+ import { types } from "node:util";
2
3
  import { STORE_HOOK_KEYS, TtlSessionStore } from "../../core/session-store.js";
3
4
  import { BootLock, resolveDataRoot } from "./fs-atomic.js";
4
5
  import { assertAdoptionBootGate } from "./adoption/marker.js";
@@ -14,7 +15,8 @@ import { FileMailboxStore } from "./mailbox-store.js";
14
15
  import { FileRosterStore } from "../../agents/roster-store.js";
15
16
  import { FileFileHistoryStore } from "./file-history-store.js";
16
17
  import { readMountedToolNames } from "../../core/session-policy-store.js";
17
- import { optionKeys, receiveMembers, receiveOptions, refuseStrayMembers } from "../../core/own-property-receipt.js";
18
+ import { optionKeys, receiptRefusal, receiveMembers, receiveOptions, refuseStrayMembers } from "../../core/own-property-receipt.js";
19
+ import { describeRejectedValue } from "../../core/tool-search-setting.js";
18
20
  import { receiveFileHistoryRetention } from "../../core/file-history-retention.js";
19
21
  import { readRetentionDeclaration } from "../../core/retention.js";
20
22
  function nestedOptions(value, member, keys) {
@@ -34,7 +36,27 @@ export { atomicWriteFile, writeThenLink, ensureDir, readJsonlRecords, AppendLog
34
36
  export { processFingerprint, isProcessLive } from "./fs-atomic.js";
35
37
  export { AdoptionError, assertAdoptionBootGate, readRootAdoptionFile, writeRootAdoptionFile, ROOT_ADOPTION_FILE, } from "./adoption/marker.js";
36
38
  export { adoptLocalDataRoot, ackAdoptionConfig, witnessAdoptionConfig, listAdoptionQuarantine, readAdoptionStatus, } from "./adoption/adopt.js";
37
- const FILE_STORAGE_BACKEND_OPTION_KEYS = optionKeys()({ root: 0, evict: 0, checkpoint: 0, retention: 0, fileHistory: 0, sessionPolicy: 0, onCorruptRead: 0, sessions: 0 });
39
+ const FILE_STORAGE_BACKEND_OPTION_KEYS = optionKeys()({ root: 0, evict: 0, checkpoint: 0, retention: 0, fileHistory: 0, sessionPolicy: 0, onCorruptRead: 0, sessions: 0, admit: 0 });
40
+ function readAdmit(value) {
41
+ if (value === undefined || typeof value === "function")
42
+ return value;
43
+ throw receiptRefusal(`FileStorageBackendOptions.admit must be a function when given (got ${describeRejectedValue(value)})`);
44
+ }
45
+ function admitRoot(admit, root) {
46
+ const answer = Reflect.apply(admit, undefined, [root]);
47
+ if (answer !== undefined) {
48
+ if (types.isPromise(answer)) {
49
+ try {
50
+ Promise.prototype.then.call(answer, undefined, () => {
51
+ });
52
+ }
53
+ catch {
54
+ }
55
+ }
56
+ throw receiptRefusal(`file store: the data root ${root} is refused — FileStorageBackendOptions.admit returned ${describeRejectedValue(answer)}, but it admits by ` +
57
+ `returning nothing and refuses by throwing, and this open is synchronous, so a returned value (a promise included) is not an admission`);
58
+ }
59
+ }
38
60
  const NESTED_FILE_HISTORY_OPTION_KEYS = optionKeys()({ retention: 0 });
39
61
  const NESTED_SESSION_POLICY_OPTION_KEYS = optionKeys()({ mountedToolNames: 0 });
40
62
  const NESTED_CHECKPOINT_OPTION_KEYS = optionKeys()({ fsync: 0, compactEvery: 0, holderIsCurrent: 0 });
@@ -68,12 +90,15 @@ export class FileStorageBackend {
68
90
  const fileHistoryOptions = fileHistoryRecord === undefined ? undefined : { ...fileHistoryRecord, retention: receiveFileHistoryRetention("FileStorageBackendOptions.fileHistory", fileHistoryRecord.retention) };
69
91
  if (opts.sessions !== undefined)
70
92
  refuseStrayMembers(opts.sessions, { subject: "FileStorageBackendOptions.sessions", unit: "hook", moment: "at new FileStorageBackend" }, STORE_HOOK_KEYS);
93
+ const admit = readAdmit(opts.admit);
71
94
  this.root = resolveDataRoot(opts.root);
72
95
  assertAdoptionBootGate(this.root, "FileStorageBackend");
73
96
  this.lock = new BootLock(join(this.root, "LOCK"));
74
97
  this.lock.acquire();
75
98
  const built = [];
76
99
  try {
100
+ if (admit !== undefined)
101
+ admitRoot(admit, this.root);
77
102
  const corruptRead = opts.onCorruptRead !== undefined ? { onCorruptRead: opts.onCorruptRead } : undefined;
78
103
  const repo = new FileSessionRepo(this.root, corruptRead);
79
104
  this.fileSessions = repo;
@@ -113,9 +113,18 @@ export declare class FileMailboxStore implements MailboxStore {
113
113
  append(scope: string, handle: string, msg: MailboxAppendMessage): Promise<number>;
114
114
  claimLease(scope: string, handle: string, owner: string, ttlMs: number, now?: number): Promise<MailboxLease | null>;
115
115
  ack(scope: string, handle: string, owner: string, upToSeq: number): Promise<MailboxAckResult>;
116
- moveDecision(scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision): Promise<MailboxDecisionOutcome>;
116
+ moveDecision(scope: string, handle: string, seq: number, expect: MailboxDecision | undefined, next: MailboxDecision, holder?: string): Promise<MailboxDecisionOutcome>;
117
117
  releaseLease(scope: string, handle: string, owner: string): Promise<void>;
118
+ /**
119
+ * ONE read of a box that creates nothing (RB-148: a pure READ must not create durable state — `load()` creates the
120
+ * scope directory, the box file AND an append descriptor, so an observation face that went through it materialized a
121
+ * box for every handle anyone merely ASKED about). An already-loaded box answers from its live state; an unknown one
122
+ * is replayed from disk without opening anything, and a box that does not exist answers `absent`.
123
+ */
124
+ private readBox;
118
125
  peekCount(scope: string, handle: string): Promise<number>;
126
+ private discloseBox;
127
+ replayOf(scope: string, handle: string, msg: MailboxAppendMessage): Promise<number | undefined>;
119
128
  drop(scope: string, handle: string): Promise<void>;
120
129
  reap(scope: string, now: number, opts?: {
121
130
  maxAgeMs?: number;
@@ -1,8 +1,10 @@
1
1
  import { join, resolve, sep } from "node:path";
2
+ import { describeRejectedValue } from "../../core/tool-search-setting.js";
2
3
  import { createHash, randomBytes } from "node:crypto";
3
4
  import { receiveRetentionPolicy } from "../../core/retention-policy.js";
4
5
  import { existsSync, linkSync, readdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
5
- import { assertMailboxDecisionMove, detachMailboxMessage, foldMailboxConsumed, MAILBOX_REAP_KNOBS, MAILBOX_REPLAY_FACETS, newestSentAt, readStoredMailboxDecision, readMailboxAppend, judgeMailboxAppendById, } from "../../core/mailbox-store.js";
6
+ import { assertMailboxDecisionMove, assertMailboxLeaseOwner, detachMailboxMessage, foldMailboxConsumed, MAILBOX_REAP_KNOBS, MAILBOX_REPLAY_FACETS, newestSentAt, readStoredMailboxDecision, readMailboxAppend, judgeMailboxAppendById, mailboxDecisionMoveFenced, mailboxAckBlockedRefusal, mailboxBlockedSentence, mailboxDecisionOnUnreadableRefusal, mailboxReadablePrefix, MAILBOX_MESSAGE_ROW_SHAPE, } from "../../core/mailbox-store.js";
7
+ import { isRowCorrupt } from "../../core/row-shape.js";
6
8
  import { AppendLog, atomicWriteFile, canonicalStoreKey, ensureDir, readJsonlRecords, sanitizeScope, sanitizePathComponent } from "./fs-atomic.js";
7
9
  import { guardCorruptSink } from "./corrupt-read-sink.js";
8
10
  import { physicalPathOf } from "../../core/physical-path.js";
@@ -343,7 +345,7 @@ export class FileMailboxStore {
343
345
  this.compactEvery = tuning.compactEvery;
344
346
  const lockWaitMs = opts.lockWaitMs ?? 10_000;
345
347
  if (typeof lockWaitMs !== "number" || !Number.isFinite(lockWaitMs) || lockWaitMs <= 0) {
346
- throw new Error(`FileMailboxStore: lockWaitMs must be a finite number > 0, got ${JSON.stringify(opts.lockWaitMs)}`);
348
+ throw new Error(`FileMailboxStore: lockWaitMs must be a finite number > 0, got ${describeRejectedValue(opts.lockWaitMs)}`);
347
349
  }
348
350
  this.lockWaitMs = lockWaitMs;
349
351
  this.discloseCorrupt = guardCorruptSink(opts.onCorruptRead);
@@ -454,15 +456,19 @@ export class FileMailboxStore {
454
456
  });
455
457
  }
456
458
  async claimLease(scope, handle, owner, ttlMs, now = Date.now()) {
459
+ assertMailboxLeaseOwner(owner);
457
460
  return this.withBox(this.lockKey(scope, handle), this.boxPath(scope, handle), () => {
458
461
  const b = this.load(scope, handle);
459
- if (b.messages.length === 0)
462
+ const { prefix, blocked } = mailboxReadablePrefix(b.messages);
463
+ if (blocked !== undefined)
464
+ this.discloseBox(scope, handle, mailboxBlockedSentence(scope, handle, blocked));
465
+ if (prefix.length === 0)
460
466
  return null;
461
467
  if (b.lease !== undefined && b.lease.expiresAt > now && b.lease.owner !== owner)
462
468
  return null;
463
- const maxSeq = b.messages[b.messages.length - 1].seq;
469
+ const maxSeq = prefix[prefix.length - 1].seq;
464
470
  this.commit(b, this.boxPath(scope, handle), { t: "lease", owner, expiresAt: now + ttlMs, maxSeq });
465
- return { messages: b.messages.map((m) => detachMailboxMessage(m)), maxSeq };
471
+ return { messages: prefix.map((m) => detachMailboxMessage(m)), maxSeq };
466
472
  });
467
473
  }
468
474
  async ack(scope, handle, owner, upToSeq) {
@@ -470,19 +476,29 @@ export class FileMailboxStore {
470
476
  const b = this.load(scope, handle);
471
477
  if (b.lease === undefined || b.lease.owner !== owner)
472
478
  return { acked: false };
479
+ const { blocked } = mailboxReadablePrefix(b.messages);
480
+ if (blocked !== undefined && upToSeq >= blocked.seq) {
481
+ this.discloseBox(scope, handle, mailboxBlockedSentence(scope, handle, blocked));
482
+ throw mailboxAckBlockedRefusal(blocked);
483
+ }
473
484
  this.commit(b, this.boxPath(scope, handle), { t: "ack", upToSeq });
474
485
  return { acked: true };
475
486
  });
476
487
  }
477
- async moveDecision(scope, handle, seq, expect, next) {
478
- assertMailboxDecisionMove(seq, expect, next);
488
+ async moveDecision(scope, handle, seq, expect, next, holder) {
489
+ assertMailboxDecisionMove(seq, expect, next, holder);
479
490
  return this.withBox(this.lockKey(scope, handle), this.boxPath(scope, handle), () => {
480
491
  const b = this.load(scope, handle);
481
492
  const m = b.messages.find((x) => x.seq === seq);
482
493
  if (m === undefined)
483
494
  return { ok: false, current: "gone" };
495
+ const read = MAILBOX_MESSAGE_ROW_SHAPE.read(m, { key: String(m.seq) });
496
+ if (isRowCorrupt(read))
497
+ throw mailboxDecisionOnUnreadableRefusal(read);
484
498
  if (m.decision !== expect)
485
499
  return { ok: false, current: m.decision ?? "unset" };
500
+ if (mailboxDecisionMoveFenced(expect, b.lease?.owner, holder))
501
+ return { ok: false, current: m.decision ?? "unset" };
486
502
  this.commit(b, this.boxPath(scope, handle), { t: "decision", seq, state: next });
487
503
  return { ok: true };
488
504
  });
@@ -494,21 +510,33 @@ export class FileMailboxStore {
494
510
  this.commit(b, this.boxPath(scope, handle), { t: "release", owner });
495
511
  });
496
512
  }
497
- async peekCount(scope, handle) {
513
+ async readBox(scope, handle, read, absent) {
498
514
  const path = this.boxPath(scope, handle);
499
515
  const loaded = sharedBoxes.get(canonicalStoreKey(path));
500
516
  if (loaded !== undefined && sameDiskMark(diskMarkOf(path), loaded.mark)) {
501
- return withPathLock(this.lockKey(scope, handle), () => loaded.messages.length);
517
+ return withPathLock(this.lockKey(scope, handle), () => read(loaded));
502
518
  }
503
519
  if (!existsSync(path))
504
- return 0;
520
+ return absent;
505
521
  return withPathLock(this.lockKey(scope, handle), () => {
506
522
  const b = { messages: [], nextSeq: 1, consumed: [] };
507
523
  for (const ev of readJsonlRecords(path, this.discloseCorrupt, MAILBOX_EVENT_JUDGE))
508
524
  applyEvent(b, ev);
509
- return b.messages.length;
525
+ return read(b);
510
526
  });
511
527
  }
528
+ async peekCount(scope, handle) {
529
+ return this.readBox(scope, handle, (b) => mailboxReadablePrefix(b.messages).prefix.length, 0);
530
+ }
531
+ discloseBox(scope, handle, reason) {
532
+ this.discloseCorrupt?.({ kind: "file", path: this.boxPath(scope, handle), reason });
533
+ }
534
+ async replayOf(scope, handle, msg) {
535
+ if (scope === undefined || scope === "")
536
+ throw new Error("MailboxStore.replayOf: refusing a message without a scope");
537
+ const record = readMailboxAppend(msg);
538
+ return this.readBox(scope, handle, (b) => judgeMailboxAppendById({ held: b.messages, consumed: b.consumed }, record), undefined);
539
+ }
512
540
  async drop(scope, handle) {
513
541
  const path = this.boxPath(scope, handle);
514
542
  const key = canonicalStoreKey(path);
@@ -612,7 +640,7 @@ const MAILBOX_EVENT_JUDGE = {
612
640
  accepts: (r) => {
613
641
  const ev = r;
614
642
  if (ev.t === "append")
615
- return ev.m !== null && typeof ev.m === "object" && num(ev.m.seq);
643
+ return MAILBOX_MESSAGE_ROW_SHAPE.rowKey(ev.m);
616
644
  if (ev.t === "lease")
617
645
  return typeof ev.owner === "string" && num(ev.maxSeq) && num(ev.expiresAt);
618
646
  if (ev.t === "ack")
@@ -7,7 +7,7 @@ import { createPermissionRuleStoreProvider } from "../../core/permission-rule-pr
7
7
  import { syncPermissionRules } from "../../core/permission-rule-sync.js";
8
8
  import { thrownText } from "../../core/thrown-value.js";
9
9
  import { optionKeys, receiveMembers } from "../../core/own-property-receipt.js";
10
- import { FileStoreLockError } from "./fs-atomic.js";
10
+ import { FileStoreLockError, uncheckableOwnerClause } from "./fs-atomic.js";
11
11
  import { FileDurableRulePartitionProvider, LOCAL_OWNER_FILE, principalRuleFileName, readRuleAdoptionFile, writeRuleAdoptionFile, } from "./permission-rule-store.js";
12
12
  const ADOPT_OPTION_KEYS = optionKeys()({ dir: 0, from: 0, toPrincipal: 0, transport: 0, now: 0, onError: 0 });
13
13
  export async function adoptFilePermissionRuleStore(opts) {
@@ -47,7 +47,10 @@ export async function adoptFilePermissionRuleStore(opts) {
47
47
  catch (err) {
48
48
  if (!(err instanceof FileStoreLockError))
49
49
  throw err;
50
- throw new FileStoreLockError(err.code, `the permission-rule writer lock ${err.lockPath} refuses the adoption (${err.code}${err.ownerPid !== undefined ? `, held by pid ${err.ownerPid}` : ""}) — stop the live writer, then run the adoption again`, err.lockPath, err.ownerPid);
50
+ const unchecked = uncheckableOwnerClause(err);
51
+ throw new FileStoreLockError(err.code, unchecked !== undefined
52
+ ? `the permission-rule writer lock ${err.lockPath} refuses the adoption (${err.code}): ${unchecked}, then run the adoption again`
53
+ : `the permission-rule writer lock ${err.lockPath} refuses the adoption (${err.code}${err.ownerPid !== undefined ? `, held by pid ${err.ownerPid}` : ""}) — stop the live writer, then run the adoption again`, err.lockPath, err.ownerPid, err.ownerUncheckable);
51
54
  }
52
55
  if (lockProbe === undefined)
53
56
  throw new Error("the target store refused a write face");