@sema-agent/core 7.59.0 → 7.61.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 (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -24,7 +24,7 @@ export declare class FileMemoryStore implements MemoryStore {
24
24
  /** Set by {@link close}: a background embed that resolves AFTER close must NOT writeSync to the (now closed)
25
25
  * vlog fd — a stray write on a recycled fd could corrupt an unrelated file. */
26
26
  private closed;
27
- constructor(root: string, opts?: {
27
+ constructor(root: string, options?: {
28
28
  embedder?: Embedder;
29
29
  embedTimeoutMs?: number;
30
30
  });
@@ -4,8 +4,10 @@ import { firstSentence, lexicalSearchMatch, parseNoteTimestamp, MemoryProjection
4
4
  import { cosineDistance, jaccardDistance, termSet } from "../../core/memory-vector.js";
5
5
  import { canonicalStoreKey, AppendLog, atomicWriteFile, ensureDir, readJsonlRecords, sanitizeScope, } from "./fs-atomic.js";
6
6
  import { assertAdoptionBootGate } from "./adoption/marker.js";
7
+ import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
7
8
  const MAX_OPEN_MEMORY_SCOPES = 64;
8
9
  const sharedMemoryDirs = new Map();
10
+ const FILE_MEMORY_STORE_OPTION_KEYS = optionKeys()({ embedder: 0, embedTimeoutMs: 0 });
9
11
  export class FileMemoryStore {
10
12
  root;
11
13
  embedder;
@@ -17,7 +19,8 @@ export class FileMemoryStore {
17
19
  sharedScopes;
18
20
  scopeKey;
19
21
  closed = false;
20
- constructor(root, opts = {}) {
22
+ constructor(root, options) {
23
+ const opts = receiveOptions(options, "FileMemoryStore", FILE_MEMORY_STORE_OPTION_KEYS);
21
24
  assertAdoptionBootGate(root, "FileMemoryStore");
22
25
  this.root = join(root, "memory");
23
26
  this.scopeKey = canonicalStoreKey(this.root);
@@ -6,40 +6,43 @@ import { principalNameOf } from "../../core/principal-name.js";
6
6
  import { createPermissionRuleStoreProvider } from "../../core/permission-rule-provider.js";
7
7
  import { syncPermissionRules } from "../../core/permission-rule-sync.js";
8
8
  import { thrownText } from "../../core/thrown-value.js";
9
+ import { optionKeys, receiveMembers } from "../../core/own-property-receipt.js";
9
10
  import { FileStoreLockError } from "./fs-atomic.js";
10
11
  import { FileDurableRulePartitionProvider, LOCAL_OWNER_FILE, principalRuleFileName, readRuleAdoptionFile, writeRuleAdoptionFile, } from "./permission-rule-store.js";
12
+ const ADOPT_OPTION_KEYS = optionKeys()({ dir: 0, from: 0, toPrincipal: 0, transport: 0, now: 0, onError: 0 });
11
13
  export async function adoptFilePermissionRuleStore(opts) {
12
- if (principalNameOf(opts.toPrincipal) === undefined) {
14
+ const o = receiveMembers(opts, { subject: "adoptFilePermissionRuleStore options", unit: "option", moment: "at adoptFilePermissionRuleStore" }, ADOPT_OPTION_KEYS);
15
+ if (principalNameOf(o.toPrincipal) === undefined) {
13
16
  throw new Error("adoptFilePermissionRuleStore requires the adopting principal, a principal name — adoption is the act of giving this bucket an identity");
14
17
  }
15
- const from = readRuleOwner(opts.from);
18
+ const from = readRuleOwner(o.from);
16
19
  if (from === undefined) {
17
20
  throw new Error("adoptFilePermissionRuleStore requires a source owner — a principal owner whose principal is a principal name, or the local owner");
18
21
  }
19
- if (from.kind === "principal" && from.principal === opts.toPrincipal) {
20
- throw new Error(`the bucket already belongs to "${opts.toPrincipal}" — there is nothing to adopt`);
22
+ if (from.kind === "principal" && from.principal === o.toPrincipal) {
23
+ throw new Error(`the bucket already belongs to "${o.toPrincipal}" — there is nothing to adopt`);
21
24
  }
22
- const sourceFile = join(opts.dir, from.kind === "local-owner" ? LOCAL_OWNER_FILE : principalRuleFileName(from.principal));
23
- const targetFile = join(opts.dir, principalRuleFileName(opts.toPrincipal));
24
- const existing = readRuleAdoptionFile(opts.dir);
25
+ const sourceFile = join(o.dir, from.kind === "local-owner" ? LOCAL_OWNER_FILE : principalRuleFileName(from.principal));
26
+ const targetFile = join(o.dir, principalRuleFileName(o.toPrincipal));
27
+ const existing = readRuleAdoptionFile(o.dir);
25
28
  if (existing !== undefined) {
26
29
  if ("adopted" in existing) {
27
- if (existing.adopted.toPrincipal === opts.toPrincipal && sameRuleOwner(existing.adopted.from, from))
30
+ if (existing.adopted.toPrincipal === o.toPrincipal && sameRuleOwner(existing.adopted.from, from))
28
31
  return { status: "adopted" };
29
32
  throw new Error(`this directory already carries a completed adoption (${ruleOwnerText(existing.adopted.from)} → "${existing.adopted.toPrincipal}") — a second adoption of the same directory is not a shape this helper supports`);
30
33
  }
31
- if (existing.marker.toPrincipal !== opts.toPrincipal || !sameRuleOwner(existing.marker.from, from)) {
34
+ if (existing.marker.toPrincipal !== o.toPrincipal || !sameRuleOwner(existing.marker.from, from)) {
32
35
  throw new Error(`an adoption toward "${existing.marker.toPrincipal}" is already in flight in this directory — refusing to start a different one (resume the original, or repair the marker by hand)`);
33
36
  }
34
37
  }
35
38
  else if (existsSync(targetFile)) {
36
- throw new Error(`the target bucket for "${opts.toPrincipal}" already exists — merging two existing buckets goes through an explicit sync join, not a rename`);
39
+ throw new Error(`the target bucket for "${o.toPrincipal}" already exists — merging two existing buckets goes through an explicit sync join, not a rename`);
37
40
  }
38
- const provider = new FileDurableRulePartitionProvider(opts.dir, opts.onError);
41
+ const provider = new FileDurableRulePartitionProvider(o.dir, o.onError);
39
42
  try {
40
43
  let lockProbe;
41
44
  try {
42
- lockProbe = writerOf(provider.forPrincipal(opts.toPrincipal));
45
+ lockProbe = writerOf(provider.forPrincipal(o.toPrincipal));
43
46
  }
44
47
  catch (err) {
45
48
  if (!(err instanceof FileStoreLockError))
@@ -50,7 +53,7 @@ export async function adoptFilePermissionRuleStore(opts) {
50
53
  throw new Error("the target store refused a write face");
51
54
  let phase = existing !== undefined && "marker" in existing ? existing.marker.phase : 2;
52
55
  if (existing === undefined) {
53
- writeRuleAdoptionFile(opts.dir, marker(from, opts.toPrincipal, 2));
56
+ writeRuleAdoptionFile(o.dir, marker(from, o.toPrincipal, 2));
54
57
  phase = 2;
55
58
  }
56
59
  if (phase < 3) {
@@ -61,11 +64,11 @@ export async function adoptFilePermissionRuleStore(opts) {
61
64
  }
62
65
  if (sourcePresent)
63
66
  renameSync(sourceFile, targetFile);
64
- writeRuleAdoptionFile(opts.dir, marker(from, opts.toPrincipal, 3));
67
+ writeRuleAdoptionFile(o.dir, marker(from, o.toPrincipal, 3));
65
68
  phase = 3;
66
69
  }
67
70
  if (phase < 4) {
68
- writeRuleAdoptionFile(opts.dir, marker(from, opts.toPrincipal, 4));
71
+ writeRuleAdoptionFile(o.dir, marker(from, o.toPrincipal, 4));
69
72
  phase = 4;
70
73
  }
71
74
  let syncResult;
@@ -73,9 +76,9 @@ export async function adoptFilePermissionRuleStore(opts) {
73
76
  try {
74
77
  syncResult = await syncPermissionRules({
75
78
  provider: createPermissionRuleStoreProvider({ durable: provider }),
76
- principal: opts.toPrincipal,
77
- transport: opts.transport,
78
- ...(opts.now !== undefined ? { now: opts.now } : {}),
79
+ principal: o.toPrincipal,
80
+ transport: o.transport,
81
+ ...(o.now !== undefined ? { now: o.now } : {}),
79
82
  });
80
83
  }
81
84
  catch (err) {
@@ -88,12 +91,12 @@ export async function adoptFilePermissionRuleStore(opts) {
88
91
  error: `the first sync round did not land clean (${(syncResult.warnings ?? []).join("; ") || `${syncResult.dropped.length} drop(s)`}) — resume when the endpoint is healthy`,
89
92
  };
90
93
  }
91
- writeRuleAdoptionFile(opts.dir, marker(from, opts.toPrincipal, 5));
94
+ writeRuleAdoptionFile(o.dir, marker(from, o.toPrincipal, 5));
92
95
  phase = 5;
93
96
  }
94
- writeRuleAdoptionFile(opts.dir, {
97
+ writeRuleAdoptionFile(o.dir, {
95
98
  schemaVersion: 1,
96
- adopted: { from, toPrincipal: opts.toPrincipal, atMs: (opts.now ?? Date.now)() },
99
+ adopted: { from, toPrincipal: o.toPrincipal, atMs: (o.now ?? Date.now)() },
97
100
  });
98
101
  return { status: "adopted", ...(syncResult !== undefined ? { syncResult } : {}) };
99
102
  }
@@ -11,6 +11,7 @@ import { SESSION_RULES_GRAMMAR, readRuleGrammarStamp } from "../../core/session-
11
11
  import { canonicalize } from "../../core/canonical-json.js";
12
12
  import { BootLock, FileStoreLockError } from "./fs-atomic.js";
13
13
  import { assertAdoptionBootGate } from "./adoption/marker.js";
14
+ import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
14
15
  import { thrownText } from "../../core/thrown-value.js";
15
16
  function isRuleFile(v) {
16
17
  const p = v;
@@ -402,6 +403,7 @@ class FileDurableRulePartition {
402
403
  }),
403
404
  };
404
405
  }
406
+ const FILE_DURABLE_RULE_PARTITION_PROVIDER_OPTION_KEYS = optionKeys()({ dataRoot: 0, platform: 0 });
405
407
  export class FileDurableRulePartitionProvider {
406
408
  dir;
407
409
  onError;
@@ -411,11 +413,12 @@ export class FileDurableRulePartitionProvider {
411
413
  constructor(dir, onError, opts) {
412
414
  this.dir = dir;
413
415
  this.onError = onError;
414
- if (opts?.dataRoot !== undefined)
415
- assertAdoptionBootGate(opts.dataRoot, "FileDurableRulePartitionProvider");
416
+ const options = receiveOptions(opts, "FileDurableRulePartitionProvider", FILE_DURABLE_RULE_PARTITION_PROVIDER_OPTION_KEYS);
417
+ if (options.dataRoot !== undefined)
418
+ assertAdoptionBootGate(options.dataRoot, "FileDurableRulePartitionProvider");
416
419
  let said = false;
417
420
  this.vetting = {
418
- platform: opts?.platform,
421
+ platform: options.platform,
419
422
  modeBitsUnjudged: (where) => {
420
423
  if (said)
421
424
  return;
@@ -146,7 +146,7 @@ export declare class FileSessionPolicyStore implements SessionPolicyStore {
146
146
  * identity, so on such a root the anonymous key IS the adopted principal — reads and writes
147
147
  * alike (a window-era anonymous write must not mint a fresh orphan row). */
148
148
  private readonly anonymousAlias;
149
- constructor(root: string, opts?: FileSessionPolicyStoreOptions);
149
+ constructor(root: string, options?: FileSessionPolicyStoreOptions);
150
150
  /** The one delivery point for {@link onCorruptRead}. */
151
151
  private disclose;
152
152
  /** The ONE refusal for a rules file that is PRESENT but cannot be served as rules — every damage grade lands
@@ -4,6 +4,8 @@ import { judgeSessionRulesWrite, readMountedToolNames, readSessionRulesShape, Se
4
4
  import { atomicWriteFile, ensureDir, sanitizeScope } from "./fs-atomic.js";
5
5
  import { guardCorruptSink } from "./corrupt-read-sink.js";
6
6
  import { assertAdoptionBootGate, readRootAdoptionFile } from "./adoption/marker.js";
7
+ import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
8
+ const FILE_SESSION_POLICY_STORE_OPTION_KEYS = optionKeys()({ mountedToolNames: 0, onCorruptRead: 0 });
7
9
  export const SESSION_POLICY_MARK_SUFFIX = ".hwm.json";
8
10
  const MARK_SUFFIX = SESSION_POLICY_MARK_SUFFIX;
9
11
  export function readSessionPolicyMark(path) {
@@ -73,7 +75,8 @@ export class FileSessionPolicyStore {
73
75
  onCorruptRead;
74
76
  mountedToolNames;
75
77
  anonymousAlias;
76
- constructor(root, opts) {
78
+ constructor(root, options) {
79
+ const opts = receiveOptions(options, "FileSessionPolicyStore", FILE_SESSION_POLICY_STORE_OPTION_KEYS);
77
80
  assertAdoptionBootGate(root, "FileSessionPolicyStore");
78
81
  this.mountedToolNames = readMountedToolNames(opts?.mountedToolNames);
79
82
  this.dir = join(root, "session-policy");
@@ -32,7 +32,7 @@ export declare class FileSessionRepo implements SessionRepo {
32
32
  * `dispose()` walks it and releases each holder share; the weak value is what makes the identity
33
33
  * check on the way out possible without pinning a storage the table itself only holds weakly. */
34
34
  private readonly joined;
35
- constructor(root: string, opts?: FileSessionRepoOptions);
35
+ constructor(root: string, options?: FileSessionRepoOptions);
36
36
  /** The one delivery point for {@link FileSessionRepoOptions.onCorruptRead}'s whole-file level; `sessionId` when the file is one session's log. */
37
37
  private disclose;
38
38
  private pathFor;
@@ -51,6 +51,13 @@ export declare class FileSessionRepo implements SessionRepo {
51
51
  * the row). `skipped` words the corrupt-header refusal's reading of the records around it, where the caller has one.
52
52
  */
53
53
  private headerOf;
54
+ /**
55
+ * The row's header record, where the log has one: its FIRST record, which must be the meta header every write path lays down. A log whose
56
+ * first record is anything else is no row this store wrote — `corrupt_session`, said once here for every reader of the row. The cells
57
+ * inside it are each read by their own reader ({@link headerOf} for the whole header, `placementOf` for the placement tuple alone):
58
+ * a reader of one cell does not answer for the others.
59
+ */
60
+ private metaLineOf;
54
61
  /**
55
62
  * The row's head in one read, without replaying the log: ONE descriptor on the session file, its first record for the owner and
56
63
  * occupant cells, and walking back from its end to the last entry record for the leaf. The three come from one inode — a file
@@ -73,9 +80,13 @@ export declare class FileSessionRepo implements SessionRepo {
73
80
  * `undefined` = no row; a row whose header cannot be read rejects (`corrupt_session`).
74
81
  */
75
82
  private rowOf;
76
- /** The one descriptor a by-id read of the row takes: its size and modification time and its header, from one inode (a file replaced
77
- * or removed while this reads is still the inode this descriptor opened); `undefined` = no file. */
83
+ /** The one descriptor a by-id read of the row takes: its size and modification time and its header decoded whole, from one inode (a
84
+ * file replaced or removed while this reads is still the inode this descriptor opened); `undefined` = no file. A reader of one cell
85
+ * alone takes {@link atFirstRecord}, which this is built on. */
78
86
  private atRow;
87
+ /** The descriptor under every by-id header read: the file's size and modification time and its first record, undecoded — the bytes
88
+ * each cell's reader decodes. One inode, bounded by the lines before the first record, never by the log; `undefined` = no file. */
89
+ private atFirstRecord;
79
90
  private storage;
80
91
  /**
81
92
  * RB-437 — release every shared authority this repo joined (LAST holder ⇒ evict + close the append fd).
@@ -119,7 +130,9 @@ export declare class FileSessionRepo implements SessionRepo {
119
130
  scope?: string;
120
131
  }): Promise<PlacedSessionRow[]>;
121
132
  /** Cheap placement probe for one id (the TtlSessionStore's cold-cache release consults it so the
122
- * placed real-deletion obligation holds after a restart). `undefined` = missing file OR unplaced; a row that cannot be read rejects. */
133
+ * placed real-deletion obligation holds after a restart), answered from the row's header record alone — never a replay of its log —
134
+ * and from the placement cell alone: a row whose owner cell cannot be read still says whether it is placed (the readers of the owner
135
+ * refuse that row; this probe is not one of them). `undefined` = missing file OR unplaced; a log with no header record rejects. */
123
136
  placementOf(sessionId: string): Promise<SessionPlacementRecord | undefined>;
124
137
  delete(metadata: SessionMetadata, expect?: SessionRowExpectation): Promise<void>;
125
138
  fork(sourceMetadata: SessionMetadata, options?: SessionForkOptions & SessionCreateOptions): Promise<Session>;
@@ -4,6 +4,7 @@ import { BaseSessionStorage, StoredSession, SessionError, assertForkTarget, comp
4
4
  import { canonicalStoreKey, AppendLog, atomicWriteFile, ensureDir, firstJsonlRecord, lastJsonlRecord, readJsonlRecords, sanitizePathComponent, writeThenLink } from "./fs-atomic.js";
5
5
  import { guardCorruptSink } from "./corrupt-read-sink.js";
6
6
  import { assertAdoptionBootGate } from "./adoption/marker.js";
7
+ import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
7
8
  import { thrownText } from "../../core/thrown-value.js";
8
9
  const SUFFIX = ".jsonl";
9
10
  const SESSION_LINE_JUDGE = {
@@ -71,12 +72,14 @@ class FileSessionStorage extends BaseSessionStorage {
71
72
  this.recordEntry(entry);
72
73
  }
73
74
  }
75
+ const FILE_SESSION_REPO_OPTION_KEYS = optionKeys()({ onCorruptRead: 0 });
74
76
  export class FileSessionRepo {
75
77
  dir;
76
78
  tmpDir;
77
79
  onCorruptRead;
78
80
  joined = new Map();
79
- constructor(root, opts) {
81
+ constructor(root, options) {
82
+ const opts = receiveOptions(options, "FileSessionRepo", FILE_SESSION_REPO_OPTION_KEYS);
80
83
  assertAdoptionBootGate(root, "FileSessionRepo");
81
84
  this.dir = join(root, "sessions");
82
85
  this.tmpDir = join(root, "tmp");
@@ -109,21 +112,25 @@ export class FileSessionRepo {
109
112
  return { meta, entries };
110
113
  }
111
114
  headerOf(id, path, first, skipped = () => "") {
112
- if (first === undefined || first.kind !== "meta")
113
- throw new SessionError("corrupt_session", `Session ${id} is unreadable: its log has no meta header${skipped()}`);
115
+ const head = this.metaLineOf(id, first, skipped);
114
116
  const said = (key) => (detail) => this.disclose(path, `session header ${key}: ${detail}`, id);
115
- const incarnation = readIncarnationCell(first.incarnation, said("incarnation"));
116
- const forkedFromIncarnation = readIncarnationCell(first.forkedFromIncarnation, said("forkedFromIncarnation"));
117
+ const incarnation = readIncarnationCell(head.incarnation, said("incarnation"));
118
+ const forkedFromIncarnation = readIncarnationCell(head.forkedFromIncarnation, said("forkedFromIncarnation"));
117
119
  return {
118
120
  id,
119
- createdAt: first.createdAt,
120
- ...(first.forkedFrom !== undefined ? { forkedFrom: first.forkedFrom } : {}),
121
- ...(first.placement !== undefined ? { placement: first.placement } : {}),
121
+ createdAt: head.createdAt,
122
+ ...(head.forkedFrom !== undefined ? { forkedFrom: head.forkedFrom } : {}),
123
+ ...(head.placement !== undefined ? { placement: head.placement } : {}),
122
124
  ...(incarnation !== undefined ? { incarnation } : {}),
123
125
  ...(forkedFromIncarnation !== undefined ? { forkedFromIncarnation } : {}),
124
- owner: readOwnerCell(first.owner, id),
126
+ owner: readOwnerCell(head.owner, id),
125
127
  };
126
128
  }
129
+ metaLineOf(id, first, skipped = () => "") {
130
+ if (first === undefined || first.kind !== "meta")
131
+ throw new SessionError("corrupt_session", `Session ${id} is unreadable: its log has no meta header${skipped()}`);
132
+ return first;
133
+ }
127
134
  async headOf(sessionId) {
128
135
  return this.headNow(sessionId);
129
136
  }
@@ -154,9 +161,12 @@ export class FileSessionRepo {
154
161
  }
155
162
  atRow(sessionId, read) {
156
163
  const path = this.pathFor(sessionId);
164
+ return this.atFirstRecord(sessionId, (fd, size, first, mtimeMs) => read(fd, size, this.headerOf(sessionId, path, first), mtimeMs));
165
+ }
166
+ atFirstRecord(sessionId, read) {
157
167
  let fd;
158
168
  try {
159
- fd = openSync(path, "r");
169
+ fd = openSync(this.pathFor(sessionId), "r");
160
170
  }
161
171
  catch (err) {
162
172
  if (err.code === "ENOENT")
@@ -165,7 +175,7 @@ export class FileSessionRepo {
165
175
  }
166
176
  try {
167
177
  const { size, mtimeMs } = fstatSync(fd);
168
- return read(fd, size, this.headerOf(sessionId, path, firstJsonlRecord(fd, size, SESSION_LINE_JUDGE)), mtimeMs);
178
+ return read(fd, size, firstJsonlRecord(fd, size, SESSION_LINE_JUDGE), mtimeMs);
169
179
  }
170
180
  finally {
171
181
  closeSync(fd);
@@ -290,14 +300,7 @@ export class FileSessionRepo {
290
300
  return out;
291
301
  }
292
302
  async placementOf(sessionId) {
293
- try {
294
- return this.read(sessionId).meta.placement;
295
- }
296
- catch (err) {
297
- if (err instanceof SessionError && err.code === "not_found")
298
- return undefined;
299
- throw err;
300
- }
303
+ return this.atFirstRecord(sessionId, (_fd, _size, first) => this.metaLineOf(sessionId, first).placement);
301
304
  }
302
305
  async delete(metadata, expect) {
303
306
  if (expect !== undefined && !sessionRowMatches(expect, this.headNow(metadata.id), () => sessionLogMarkOf(this.read(metadata.id).entries)))
@@ -92,6 +92,32 @@ export interface LedgerModel<Row, Ev> {
92
92
  judgeRow(x: unknown): boolean;
93
93
  judgeEvent(x: unknown): boolean;
94
94
  }
95
+ /**
96
+ * The ONE fold of a snapshot+ledger pair into its rows: the snapshot (the compacted base) row by row, then the live ledger's events in
97
+ * order (last-writer-wins, `model.apply`). A READ — it takes no writer fence, opens no append handle and creates nothing (a missing file
98
+ * reads as empty), so it is what both the authority's own bootstrap ({@link LedgerCore.bootstrap}, which takes the fence first) and a
99
+ * reader that must not contend for the directory ({@link readLedgerSettled}) run: a reader never carries a second copy of the fold.
100
+ */
101
+ export declare function replayLedger<Row, Ev>(paths: Pick<LedgerPaths, "snapshotPath" | "ledgerPath" | "onCorruptRead">, model: LedgerModel<Row, Ev>): {
102
+ rows: Map<string, Row>;
103
+ events: number;
104
+ };
105
+ /**
106
+ * {@link replayLedger} for a reader that takes NO writer fence, beside a writer that may be compacting. The pair is read snapshot-first, and
107
+ * compaction rewrites the snapshot and THEN empties the ledger, so a read that saw the old snapshot and the emptied ledger would miss every
108
+ * row that lives only in the new snapshot — a clean-looking state that never existed. Such a read is recognisable by the snapshot having
109
+ * changed version by the time the ledger was read, and is discarded and redone, at most {@link SETTLED_READ_ATTEMPTS} times; a snapshot that
110
+ * will not hold still yields `settled: false` — no reading at all — never the last read. (A compaction that has replaced the snapshot but not
111
+ * yet the ledger is a state a crashed writer leaves too, and the authority's own bootstrap replays exactly that pair.) Appends move nothing
112
+ * here: a ledger read ends at a record boundary, so the events it holds are a prefix of the writer's.
113
+ */
114
+ export declare function readLedgerSettled<Row, Ev>(paths: Pick<LedgerPaths, "snapshotPath" | "ledgerPath" | "onCorruptRead">, model: LedgerModel<Row, Ev>): {
115
+ settled: true;
116
+ rows: Map<string, Row>;
117
+ events: number;
118
+ } | {
119
+ settled: false;
120
+ };
95
121
  /**
96
122
  * One directory's authority: the replayed row map, the per-key async mutex, the append log and the
97
123
  * event counter. Created and owned by {@link SharedLedgerTable}; every store instance over the
@@ -1,4 +1,38 @@
1
+ import { statSync } from "node:fs";
1
2
  import { acquireStoreDirLock, AppendLog, atomicWriteFile, canonicalStoreKey, ensureDir, readJsonlRecords, } from "./fs-atomic.js";
3
+ export function replayLedger(paths, model) {
4
+ const rows = new Map();
5
+ const disclose = paths.onCorruptRead;
6
+ const judge = (accepts, what) => ({ accepts, what: `a ${what} carries none of this ${model.label}'s own members` });
7
+ for (const row of readJsonlRecords(paths.snapshotPath, disclose, judge(model.judgeRow, "snapshot row"))) {
8
+ rows.set(model.keyOf(row), row);
9
+ }
10
+ const events = readJsonlRecords(paths.ledgerPath, disclose, judge(model.judgeEvent, "ledger event"));
11
+ for (const ev of events)
12
+ model.apply(rows, ev);
13
+ return { rows, events: events.length };
14
+ }
15
+ function snapshotVersion(snapshotPath) {
16
+ try {
17
+ const st = statSync(snapshotPath, { bigint: true });
18
+ return `${st.dev}:${st.ino}:${st.size}:${st.mtimeNs}`;
19
+ }
20
+ catch (e) {
21
+ if (e.code === "ENOENT")
22
+ return "absent";
23
+ throw e;
24
+ }
25
+ }
26
+ const SETTLED_READ_ATTEMPTS = 3;
27
+ export function readLedgerSettled(paths, model) {
28
+ for (let attempt = 0; attempt < SETTLED_READ_ATTEMPTS; attempt++) {
29
+ const before = snapshotVersion(paths.snapshotPath);
30
+ const read = replayLedger(paths, model);
31
+ if (snapshotVersion(paths.snapshotPath) === before)
32
+ return { settled: true, ...read };
33
+ }
34
+ return { settled: false };
35
+ }
2
36
  export class LedgerCore {
3
37
  key;
4
38
  paths;
@@ -20,15 +54,10 @@ export class LedgerCore {
20
54
  bootstrap() {
21
55
  this.fence = acquireStoreDirLock(this.paths.dir, { label: this.model.label });
22
56
  try {
23
- const disclose = this.paths.onCorruptRead;
24
- const judge = (accepts, what) => ({ accepts, what: `a ${what} carries none of this ${this.model.label}'s own members` });
25
- for (const row of readJsonlRecords(this.paths.snapshotPath, disclose, judge(this.model.judgeRow, "snapshot row"))) {
26
- this.rows.set(this.model.keyOf(row), row);
27
- }
28
- const events = readJsonlRecords(this.paths.ledgerPath, disclose, judge(this.model.judgeEvent, "ledger event"));
29
- this.events = events.length;
30
- for (const ev of events)
31
- this.model.apply(this.rows, ev);
57
+ const replayed = replayLedger(this.paths, this.model);
58
+ for (const [key, row] of replayed.rows)
59
+ this.rows.set(key, row);
60
+ this.events = replayed.events;
32
61
  this.handle = new AppendLog(this.paths.ledgerPath);
33
62
  }
34
63
  catch (e) {
@@ -1,4 +1,4 @@
1
- import type { ToolResultDeletionReport, ToolResultProvenance, ToolResultSlice, ToolResultStore } from "../../core/tool-result-store.js";
1
+ import type { ToolResultDeletionReport, ToolResultProvenance, ToolResultSessionListing, ToolResultSlice, ToolResultStore } from "../../core/tool-result-store.js";
2
2
  import { type CorruptReadInfo } from "./corrupt-read-sink.js";
3
3
  /**
4
4
  * design/80 §2.5 — file {@link ToolResultStore}: write-once-idempotent, ONE file per ref.
@@ -36,7 +36,7 @@ export interface FileToolResultStoreOptions {
36
36
  export declare class FileToolResultStore implements ToolResultStore {
37
37
  private readonly dir;
38
38
  private readonly discloseCorrupt;
39
- constructor(root: string, opts?: FileToolResultStoreOptions);
39
+ constructor(root: string, options?: FileToolResultStoreOptions);
40
40
  /** The one delivery point for {@link FileToolResultStoreOptions.onCorruptRead}. */
41
41
  private disclose;
42
42
  /** The directory a ref's files live in, and their shared stem. See {@link encodeRefFilename} for why
@@ -105,4 +105,33 @@ export declare class FileToolResultStore implements ToolResultStore {
105
105
  * even with a damaged owner record, so removing one on a guess would destroy another session's output.
106
106
  */
107
107
  deleteBySession(sessionId: string): ToolResultDeletionReport;
108
+ /**
109
+ * Age out the entries stored more than `maxAgeMs` before `now` (interface: {@link ToolResultStore.reap}). An entry's
110
+ * age is its content file's modification time: the write-once publication sets it and nothing rewrites the file.
111
+ * Both namespaces are swept, and only names this store writes are judged. Removal is content then owner record, the order {@link deleteBySession} keeps; an owner
112
+ * record whose content is already gone — the leftover of an interrupted pass, or of a session sweep — is removed
113
+ * once it is past the cutoff too, and is not counted (it was not an entry). Synchronous: under the data root's single
114
+ * writer nothing interleaves with it.
115
+ */
116
+ reap(now: number, opts?: {
117
+ maxAgeMs?: number;
118
+ }): number;
119
+ /**
120
+ * The entries `sessionId` owns, as ref + recorded owner (interface: {@link ToolResultStore.listBySession}). The selection is
121
+ * {@link deleteBySession}'s own: it walks the same two namespaces and matches on the SIDECAR's `sessionId`, never on a file name; a
122
+ * sidecar that cannot be read, and content with no sidecar, are counted `unattributable` and not listed.
123
+ *
124
+ * Naming the ref is this backend's one extra step, because a folded name is a digest of the ref and cannot be read back. An entry
125
+ * written by this engine carries its ref in its sidecar; an identity-named entry (a ref inside the filename charset) is its own stem.
126
+ * The ref a record states is believed only when its own encoding is the very file the record sits beside — a record that names a ref
127
+ * stored somewhere else is not this entry's. An entry owned by the session whose ref can be named by neither is counted
128
+ * `unaddressable` (a folded entry written before the sidecar carried it): it is still removed by a sweep, and is never listed under a
129
+ * guessed ref. An entry is what the sweep counts: an owner record whose content file is gone (the leftover of an interrupted sweep, which
130
+ * the next sweep finishes) is listed like the sweep counts it, and `get` answers `undefined` for it — the honest absence a reader of a
131
+ * listing already handles.
132
+ */
133
+ listBySession(sessionId: string): ToolResultSessionListing;
134
+ /** The ref an entry stored at `dir`/`stem` is stored under, or `undefined` when none can be named: the ref its sidecar states when
135
+ * that ref's own location is this file, else — for an identity-named entry — the stem itself. */
136
+ private refOfEntry;
108
137
  }