@sema-agent/core 7.58.0 → 7.60.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 (519) hide show
  1. package/CHANGELOG.md +1340 -0
  2. package/README.md +6 -4
  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 +2 -1
  6. package/dist/agents/agent-transcript-tool.js +3 -1
  7. package/dist/agents/cc-peer-directory.js +8 -8
  8. package/dist/agents/child-model-seat.d.ts +4 -2
  9. package/dist/agents/child-model-seat.js +9 -4
  10. package/dist/agents/cumulative-stats.js +0 -1
  11. package/dist/agents/inherited-tool-pool.d.ts +26 -1
  12. package/dist/agents/inherited-tool-pool.js +22 -0
  13. package/dist/agents/peer-directory.d.ts +9 -0
  14. package/dist/agents/peer-directory.js +6 -2
  15. package/dist/agents/retain-ledger.d.ts +11 -1
  16. package/dist/agents/retain-ledger.js +13 -2
  17. package/dist/agents/roster-store.d.ts +1 -1
  18. package/dist/agents/roster-store.js +3 -1
  19. package/dist/agents/send-message-tool.d.ts +8 -19
  20. package/dist/agents/send-message-tool.js +32 -50
  21. package/dist/agents/subagent.d.ts +51 -17
  22. package/dist/agents/subagent.js +150 -112
  23. package/dist/agents/tool-filter.d.ts +1 -3
  24. package/dist/agents/tool-filter.js +4 -12
  25. package/dist/bench/metrics.d.ts +3 -5
  26. package/dist/bench/metrics.js +0 -1
  27. package/dist/brain/anthropic.js +161 -45
  28. package/dist/brain/degrading.js +3 -1
  29. package/dist/brain/errors.d.ts +9 -3
  30. package/dist/brain/errors.js +7 -1
  31. package/dist/brain/failover.js +2 -1
  32. package/dist/brain/open-responses.js +3 -3
  33. package/dist/brain/openai.js +103 -53
  34. package/dist/brain/provider-dialect.d.ts +11 -0
  35. package/dist/brain/provider-dialect.js +5 -2
  36. package/dist/brain/reasoning-request.js +5 -4
  37. package/dist/brain/reasoning.d.ts +19 -0
  38. package/dist/brain/reasoning.js +17 -2
  39. package/dist/brain/request-route.d.ts +4 -1
  40. package/dist/brain/request-route.js +4 -1
  41. package/dist/brain/route-adjudicator.d.ts +84 -18
  42. package/dist/brain/route-adjudicator.js +90 -22
  43. package/dist/brain/route-conformance.js +1 -1
  44. package/dist/brain/status-sink.d.ts +7 -1
  45. package/dist/brain/status-sink.js +6 -0
  46. package/dist/brain/stream-engine.js +84 -49
  47. package/dist/brain/stream-shared.d.ts +30 -0
  48. package/dist/brain/stream-shared.js +34 -1
  49. package/dist/brain/timeout.d.ts +65 -6
  50. package/dist/brain/timeout.js +111 -11
  51. package/dist/core/a2a.d.ts +15 -5
  52. package/dist/core/a2a.js +34 -19
  53. package/dist/core/account-row.d.ts +61 -0
  54. package/dist/core/account-row.js +51 -0
  55. package/dist/core/advisor-verdict.d.ts +2 -1
  56. package/dist/core/advisor-verdict.js +1 -1
  57. package/dist/core/agent-definition.d.ts +20 -0
  58. package/dist/core/allow-entry.d.ts +20 -6
  59. package/dist/core/allow-entry.js +17 -7
  60. package/dist/core/approval-object.d.ts +29 -15
  61. package/dist/core/approval-object.js +47 -19
  62. package/dist/core/artifact-host.d.ts +0 -2
  63. package/dist/core/artifact-host.js +0 -1
  64. package/dist/core/auto-compaction.js +1 -1
  65. package/dist/core/auto-mode-defaults.d.ts +8 -0
  66. package/dist/core/auto-mode-defaults.js +1 -0
  67. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  68. package/dist/core/auto-mode.d.ts +39 -4
  69. package/dist/core/auto-mode.js +63 -12
  70. package/dist/core/background-agent-store.d.ts +26 -4
  71. package/dist/core/background-agent-store.js +3 -2
  72. package/dist/core/background-shell.d.ts +12 -1
  73. package/dist/core/background-shell.js +12 -0
  74. package/dist/core/checkpoint-requirements.d.ts +13 -1
  75. package/dist/core/checkpoint-requirements.js +3 -1
  76. package/dist/core/checkpoint-store.d.ts +66 -25
  77. package/dist/core/checkpoint-store.js +22 -9
  78. package/dist/core/child-clamp-seats.d.ts +29 -0
  79. package/dist/core/child-clamp-seats.js +56 -1
  80. package/dist/core/compliance.d.ts +3 -3
  81. package/dist/core/compliance.js +1 -1
  82. package/dist/core/credential-echo.d.ts +52 -0
  83. package/dist/core/credential-echo.js +65 -0
  84. package/dist/core/credential-vocabulary.d.ts +13 -3
  85. package/dist/core/credential-vocabulary.js +12 -4
  86. package/dist/core/cross-boundary-taint.d.ts +4 -5
  87. package/dist/core/effective-path-target.d.ts +8 -2
  88. package/dist/core/effective-path-target.js +8 -3
  89. package/dist/core/engine-notice.d.ts +156 -23
  90. package/dist/core/engine-notice.js +19 -5
  91. package/dist/core/frame-settlement.d.ts +5 -0
  92. package/dist/core/frame-settlement.js +4 -0
  93. package/dist/core/gate-fold.js +8 -6
  94. package/dist/core/gate-lanes.js +47 -12
  95. package/dist/core/gate-outcome.d.ts +32 -3
  96. package/dist/core/gate-outcome.js +19 -1
  97. package/dist/core/governance-codes.d.ts +17 -1
  98. package/dist/core/governance-codes.js +25 -0
  99. package/dist/core/hands-band-screen.js +0 -1
  100. package/dist/core/hands-band.d.ts +0 -3
  101. package/dist/core/hooks.d.ts +70 -59
  102. package/dist/core/hooks.js +125 -80
  103. package/dist/core/image-admission.d.ts +106 -52
  104. package/dist/core/image-admission.js +184 -56
  105. package/dist/core/image-downsample.d.ts +36 -69
  106. package/dist/core/image-downsample.js +111 -73
  107. package/dist/core/integer-option.d.ts +21 -0
  108. package/dist/core/integer-option.js +13 -0
  109. package/dist/core/locked-config.d.ts +59 -5
  110. package/dist/core/locked-config.js +82 -50
  111. package/dist/core/mailbox-store.d.ts +45 -1
  112. package/dist/core/mailbox-store.js +53 -9
  113. package/dist/core/mcp-call-meta.d.ts +2 -2
  114. package/dist/core/mcp-call-meta.js +9 -10
  115. package/dist/core/mcp-failure.d.ts +122 -20
  116. package/dist/core/mcp-failure.js +73 -5
  117. package/dist/core/mcp-host-seat.d.ts +92 -0
  118. package/dist/core/mcp-host-seat.js +131 -0
  119. package/dist/core/mcp-probe.d.ts +7 -2
  120. package/dist/core/mcp-probe.js +7 -2
  121. package/dist/core/mcp-server-link.d.ts +22 -1
  122. package/dist/core/mcp-server-link.js +25 -1
  123. package/dist/core/mcp-server-spec.d.ts +38 -9
  124. package/dist/core/mcp-server-spec.js +55 -21
  125. package/dist/core/mcp.d.ts +27 -12
  126. package/dist/core/mcp.js +105 -76
  127. package/dist/core/memory-admission.d.ts +23 -6
  128. package/dist/core/memory-admission.js +19 -9
  129. package/dist/core/memory-engine/consolidation-driver.d.ts +2 -4
  130. package/dist/core/memory-engine/consolidation-driver.js +3 -3
  131. package/dist/core/memory-engine/consolidation.d.ts +4 -0
  132. package/dist/core/memory-engine/consolidation.js +1 -0
  133. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  134. package/dist/core/memory-engine/content-origin.js +21 -3
  135. package/dist/core/memory-engine/delegation-settlement.js +5 -12
  136. package/dist/core/memory-engine/distiller.js +2 -2
  137. package/dist/core/memory-engine/dual-root.d.ts +50 -1
  138. package/dist/core/memory-engine/dual-root.js +44 -1
  139. package/dist/core/memory-engine/engine.d.ts +67 -14
  140. package/dist/core/memory-engine/engine.js +384 -212
  141. package/dist/core/memory-engine/export-bundle.d.ts +23 -0
  142. package/dist/core/memory-engine/export-bundle.js +23 -4
  143. package/dist/core/memory-engine/file-backend.d.ts +128 -55
  144. package/dist/core/memory-engine/file-backend.js +290 -117
  145. package/dist/core/memory-engine/index.d.ts +3 -2
  146. package/dist/core/memory-engine/index.js +2 -1
  147. package/dist/core/memory-engine/layout.d.ts +59 -11
  148. package/dist/core/memory-engine/layout.js +190 -40
  149. package/dist/core/memory-engine/memory-backend-contract.d.ts +1 -1
  150. package/dist/core/memory-engine/memory-backend-contract.js +39 -2
  151. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  152. package/dist/core/memory-engine/scope-contract.js +2 -2
  153. package/dist/core/memory-engine/sync-client.d.ts +51 -9
  154. package/dist/core/memory-engine/sync-client.js +107 -13
  155. package/dist/core/memory-engine/sync-report.d.ts +103 -0
  156. package/dist/core/memory-engine/sync-report.js +119 -0
  157. package/dist/core/memory-engine/sync.d.ts +8 -1
  158. package/dist/core/memory-engine/types.d.ts +6 -0
  159. package/dist/core/mode-policy.d.ts +9 -1
  160. package/dist/core/mode-policy.js +11 -1
  161. package/dist/core/model-receipt.d.ts +39 -0
  162. package/dist/core/model-receipt.js +139 -0
  163. package/dist/core/mods/agent-stations.d.ts +65 -0
  164. package/dist/core/mods/agent-stations.js +105 -0
  165. package/dist/core/mods/classic-events.d.ts +5 -1
  166. package/dist/core/mods/kernel/dispatch.d.ts +5 -1
  167. package/dist/core/mods/kernel/dispatch.js +6 -5
  168. package/dist/core/mods/kernel/events.d.ts +11 -4
  169. package/dist/core/mods/kernel/events.js +11 -7
  170. package/dist/core/mods/kernel/receive.d.ts +5 -0
  171. package/dist/core/mods/kernel/receive.js +10 -0
  172. package/dist/core/mods/kernel/registration.d.ts +4 -0
  173. package/dist/core/mods/kernel/registration.js +3 -0
  174. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  175. package/dist/core/mods/lifecycle-stations.js +35 -0
  176. package/dist/core/mods/stations.d.ts +73 -60
  177. package/dist/core/mods/stations.js +64 -40
  178. package/dist/core/mods/tool-call.d.ts +10 -4
  179. package/dist/core/mods/tool-call.js +28 -12
  180. package/dist/core/mounted-mcp.d.ts +5 -0
  181. package/dist/core/mounted-mcp.js +2 -2
  182. package/dist/core/namespaced-rule-name.d.ts +7 -1
  183. package/dist/core/namespaced-rule-name.js +13 -2
  184. package/dist/core/oracle-isolation.js +1 -1
  185. package/dist/core/own-property-receipt.d.ts +3 -0
  186. package/dist/core/own-property-receipt.js +3 -0
  187. package/dist/core/parent-spec-seat.d.ts +8 -3
  188. package/dist/core/parent-spec-seat.js +2 -0
  189. package/dist/core/park-selfcheck.js +14 -8
  190. package/dist/core/peer-seat.d.ts +133 -16
  191. package/dist/core/peer-seat.js +319 -42
  192. package/dist/core/permission-rule-consent.d.ts +0 -21
  193. package/dist/core/permission-rule-consent.js +11 -6
  194. package/dist/core/permission-rule-model.d.ts +20 -2
  195. package/dist/core/permission-rule-model.js +8 -7
  196. package/dist/core/present-plan-tool.d.ts +11 -3
  197. package/dist/core/present-plan-tool.js +2 -2
  198. package/dist/core/protocol-http-auth.d.ts +14 -2
  199. package/dist/core/protocol-http-auth.js +16 -7
  200. package/dist/core/read-face-seats.d.ts +7 -5
  201. package/dist/core/read-face-seats.js +4 -1
  202. package/dist/core/redaction-marks.d.ts +4 -3
  203. package/dist/core/redaction-marks.js +2 -2
  204. package/dist/core/remote-env.d.ts +146 -98
  205. package/dist/core/remote-env.js +113 -14
  206. package/dist/core/resume-startup-cause.js +1 -0
  207. package/dist/core/retention.js +37 -12
  208. package/dist/core/retired-keys.d.ts +6 -1
  209. package/dist/core/retired-keys.js +4 -1
  210. package/dist/core/rewrite-rejudge.d.ts +13 -5
  211. package/dist/core/rewrite-rejudge.js +9 -5
  212. package/dist/core/roles.d.ts +69 -3
  213. package/dist/core/roles.js +167 -80
  214. package/dist/core/rule-owner.d.ts +3 -0
  215. package/dist/core/runner/announce-once-ledger.d.ts +5 -4
  216. package/dist/core/runner/announce-once-ledger.js +4 -2
  217. package/dist/core/runner/assemble-result.d.ts +0 -5
  218. package/dist/core/runner/assemble-result.js +0 -1
  219. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  220. package/dist/core/runner/call-hook-stations.js +23 -12
  221. package/dist/core/runner/child-tree.d.ts +7 -8
  222. package/dist/core/runner/child-tree.js +6 -6
  223. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  224. package/dist/core/runner/classifier-ladder.js +39 -8
  225. package/dist/core/runner/construction-doors.js +5 -0
  226. package/dist/core/runner/contracts.d.ts +82 -57
  227. package/dist/core/runner/credential-origin-seat.js +4 -3
  228. package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
  229. package/dist/core/runner/cross-boundary-lane.js +11 -2
  230. package/dist/core/runner/cwd-alignment-probe.d.ts +20 -0
  231. package/dist/core/runner/cwd-alignment-probe.js +21 -0
  232. package/dist/core/runner/decide-continuation.d.ts +2 -2
  233. package/dist/core/runner/env-capability-census.d.ts +15 -20
  234. package/dist/core/runner/env-capability-census.js +25 -34
  235. package/dist/core/runner/file-history-request.d.ts +2 -2
  236. package/dist/core/runner/file-history-request.js +0 -8
  237. package/dist/core/runner/gate-exit.d.ts +87 -11
  238. package/dist/core/runner/gate-exit.js +30 -8
  239. package/dist/core/runner/git-status-frame.d.ts +5 -2
  240. package/dist/core/runner/git-status-frame.js +3 -4
  241. package/dist/core/runner/image-removed-seat.d.ts +12 -0
  242. package/dist/core/runner/image-removed-seat.js +19 -0
  243. package/dist/core/runner/image.d.ts +7 -2
  244. package/dist/core/runner/image.js +14 -8
  245. package/dist/core/runner/inline-image.d.ts +10 -8
  246. package/dist/core/runner/inline-image.js +11 -9
  247. package/dist/core/runner/memory-consolidation-driver.js +5 -5
  248. package/dist/core/runner/park-commit.d.ts +1 -1
  249. package/dist/core/runner/park-commit.js +3 -0
  250. package/dist/core/runner/permission-rule-lanes.js +1 -1
  251. package/dist/core/runner/prepare-ask-lane.d.ts +1 -1
  252. package/dist/core/runner/prepare-ask-lane.js +2 -1
  253. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  254. package/dist/core/runner/prepare-boundary-parks.js +5 -5
  255. package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -5
  256. package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
  257. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  258. package/dist/core/runner/prepare-config-doors.js +16 -9
  259. package/dist/core/runner/prepare-context-lane.js +2 -0
  260. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -3
  261. package/dist/core/runner/prepare-delegation-surface.js +5 -4
  262. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  263. package/dist/core/runner/prepare-file-history.js +3 -12
  264. package/dist/core/runner/prepare-gate-stations.d.ts +4 -3
  265. package/dist/core/runner/prepare-gate-stations.js +4 -3
  266. package/dist/core/runner/prepare-hands-readface.d.ts +7 -1
  267. package/dist/core/runner/prepare-hands-readface.js +19 -6
  268. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -7
  269. package/dist/core/runner/prepare-inherited-gate.js +22 -31
  270. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  271. package/dist/core/runner/prepare-memory.d.ts +2 -2
  272. package/dist/core/runner/prepare-memory.js +12 -19
  273. package/dist/core/runner/prepare-park-ask.d.ts +4 -6
  274. package/dist/core/runner/prepare-park-ask.js +5 -9
  275. package/dist/core/runner/prepare-policy-chain.d.ts +8 -7
  276. package/dist/core/runner/prepare-policy-chain.js +136 -121
  277. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  278. package/dist/core/runner/prepare-project-context.js +10 -7
  279. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -2
  280. package/dist/core/runner/prepare-prompt-inputs.js +10 -20
  281. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  282. package/dist/core/runner/prepare-protocol-tools.js +17 -2
  283. package/dist/core/runner/prepare-run-refs.d.ts +2 -3
  284. package/dist/core/runner/prepare-run-refs.js +4 -1
  285. package/dist/core/runner/prepare-suspend-saga.d.ts +0 -2
  286. package/dist/core/runner/prepare-suspend-saga.js +5 -7
  287. package/dist/core/runner/prepare-task.js +44 -28
  288. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  289. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  290. package/dist/core/runner/prepare-wiring-manifest.d.ts +5 -4
  291. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  292. package/dist/core/runner/prepare-workspace-restore.js +3 -3
  293. package/dist/core/runner/reply-pricing.d.ts +30 -0
  294. package/dist/core/runner/reply-pricing.js +19 -0
  295. package/dist/core/runner/resume-admission.js +4 -2
  296. package/dist/core/runner/resume-apply.js +6 -1
  297. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  298. package/dist/core/runner/resume-policy-outcome.js +5 -5
  299. package/dist/core/runner/retired-runner-deps.js +4 -1
  300. package/dist/core/runner/role-seat-defaulted.d.ts +44 -0
  301. package/dist/core/runner/role-seat-defaulted.js +40 -0
  302. package/dist/core/runner/run-attachment-seats.js +3 -3
  303. package/dist/core/runner/run-brain-sinks.js +3 -0
  304. package/dist/core/runner/run-git-lane.d.ts +3 -1
  305. package/dist/core/runner/run-git-lane.js +1 -1
  306. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  307. package/dist/core/runner/run-harness-handlers.js +3 -1
  308. package/dist/core/runner/run-identity-wiring.d.ts +2 -5
  309. package/dist/core/runner/run-identity-wiring.js +6 -5
  310. package/dist/core/runner/run-leg.d.ts +2 -0
  311. package/dist/core/runner/run-leg.js +63 -56
  312. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  313. package/dist/core/runner/run-notification-lane.js +16 -10
  314. package/dist/core/runner/run-settle-and-teardown.js +5 -1
  315. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  316. package/dist/core/runner/run-stop-and-final-verify.js +14 -6
  317. package/dist/core/runner/run-terminal-adoption.d.ts +2 -5
  318. package/dist/core/runner/run-terminal-adoption.js +9 -3
  319. package/dist/core/runner/run-turn-boundary.js +89 -77
  320. package/dist/core/runner/runtask.d.ts +8 -5
  321. package/dist/core/runner/runtask.js +21 -13
  322. package/dist/core/runner/side-call-account.d.ts +1 -1
  323. package/dist/core/runner/side-call-account.js +3 -18
  324. package/dist/core/runner/skills-seat.js +2 -2
  325. package/dist/core/runner/sub-agent-deny-lists.d.ts +24 -0
  326. package/dist/core/runner/sub-agent-deny-lists.js +20 -7
  327. package/dist/core/runner/synthetic-tools.js +2 -2
  328. package/dist/core/runner/tool-disclosure.js +0 -2
  329. package/dist/core/runner/tool-end-body.js +2 -2
  330. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  331. package/dist/core/runner/tool-face-overlay.js +26 -19
  332. package/dist/core/runner/tool-occurrence.d.ts +1 -1
  333. package/dist/core/runner/tool-occurrence.js +2 -2
  334. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  335. package/dist/core/runner/tool-result-media-seat.js +17 -1
  336. package/dist/core/runner/turn-attachments.d.ts +29 -27
  337. package/dist/core/runner/turn-attachments.js +27 -42
  338. package/dist/core/runner-deps.d.ts +32 -19
  339. package/dist/core/secret-env.d.ts +35 -4
  340. package/dist/core/secret-env.js +65 -3
  341. package/dist/core/sensitive-path-policy.js +3 -3
  342. package/dist/core/session-policy-store.d.ts +12 -3
  343. package/dist/core/session-policy-store.js +29 -10
  344. package/dist/core/session-store.d.ts +5 -7
  345. package/dist/core/session-store.js +50 -11
  346. package/dist/core/side-query.d.ts +11 -1
  347. package/dist/core/side-query.js +9 -0
  348. package/dist/core/skill-grant-binding.d.ts +31 -2
  349. package/dist/core/skill-grant-binding.js +31 -1
  350. package/dist/core/skill-grant.d.ts +17 -5
  351. package/dist/core/skill-grant.js +24 -6
  352. package/dist/core/store-contracts/background-agent-store-contract.js +27 -0
  353. package/dist/core/store-contracts/checkpoint-store-contract.js +3 -2
  354. package/dist/core/store-contracts/mailbox-store-contract.js +31 -1
  355. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  356. package/dist/core/store-contracts/tool-result-store-contract.js +37 -0
  357. package/dist/core/stub-env.d.ts +5 -5
  358. package/dist/core/stub-env.js +11 -1
  359. package/dist/core/swappable-deps.d.ts +17 -43
  360. package/dist/core/swappable-deps.js +15 -5
  361. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  362. package/dist/core/synthetic-read-verdict.js +2 -1
  363. package/dist/core/task-event.d.ts +50 -10
  364. package/dist/core/task-notification.d.ts +88 -5
  365. package/dist/core/task-notification.js +146 -17
  366. package/dist/core/task-registry-agent.d.ts +18 -12
  367. package/dist/core/task-registry-agent.js +19 -6
  368. package/dist/core/task-registry-monitor.d.ts +7 -0
  369. package/dist/core/task-registry-monitor.js +28 -1
  370. package/dist/core/task-registry-shared.d.ts +43 -3
  371. package/dist/core/task-registry-shared.js +21 -7
  372. package/dist/core/task-registry-workflow.js +1 -1
  373. package/dist/core/task-registry.d.ts +50 -35
  374. package/dist/core/task-registry.js +64 -23
  375. package/dist/core/task-result.d.ts +3 -12
  376. package/dist/core/task-spec.d.ts +15 -7
  377. package/dist/core/task-stream.d.ts +1 -1
  378. package/dist/core/terminal-cause.d.ts +10 -0
  379. package/dist/core/tool-catalog-entries.js +1 -1
  380. package/dist/core/tool-check-reading.d.ts +1 -0
  381. package/dist/core/tool-check-reading.js +3 -3
  382. package/dist/core/tool-face-reader.d.ts +7 -6
  383. package/dist/core/tool-face-reader.js +4 -3
  384. package/dist/core/tool-name-aliases.d.ts +19 -0
  385. package/dist/core/tool-name-aliases.js +54 -2
  386. package/dist/core/tool-policy.d.ts +21 -4
  387. package/dist/core/tool-policy.js +1 -1
  388. package/dist/core/tool-registry.d.ts +5 -5
  389. package/dist/core/tool-registry.js +2 -2
  390. package/dist/core/tool-result-store.d.ts +88 -5
  391. package/dist/core/tool-result-store.js +51 -12
  392. package/dist/core/tool-roster.d.ts +112 -5
  393. package/dist/core/tool-roster.js +42 -1
  394. package/dist/core/tool-spec.d.ts +23 -5
  395. package/dist/core/trace.d.ts +0 -1
  396. package/dist/core/types.d.ts +5 -5
  397. package/dist/core/types.js +2 -2
  398. package/dist/core/untrusted-text.js +1 -1
  399. package/dist/core/user-attachment.d.ts +10 -5
  400. package/dist/core/user-attachment.js +15 -7
  401. package/dist/core/wiring-manifest.d.ts +6 -3
  402. package/dist/engine/compaction/compaction.js +29 -3
  403. package/dist/engine/execution-env/node-execution-env.d.ts +11 -5
  404. package/dist/engine/execution-env/node-execution-env.js +21 -13
  405. package/dist/engine/harness/agent-harness.d.ts +26 -3
  406. package/dist/engine/harness/agent-harness.js +49 -16
  407. package/dist/engine/harness/messages.d.ts +3 -1
  408. package/dist/engine/harness/messages.js +3 -2
  409. package/dist/engine/harness/types.d.ts +119 -28
  410. package/dist/engine/llm/rejected-images.d.ts +46 -0
  411. package/dist/engine/llm/rejected-images.js +54 -0
  412. package/dist/engine/llm/tool-turns.d.ts +2 -1
  413. package/dist/engine/llm/types.d.ts +18 -7
  414. package/dist/engine/loop/agent-loop.d.ts +20 -12
  415. package/dist/engine/loop/agent-loop.js +205 -36
  416. package/dist/engine/loop/types.d.ts +12 -3
  417. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  418. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  419. package/dist/engine/session/path-to-root.d.ts +38 -0
  420. package/dist/engine/session/path-to-root.js +39 -0
  421. package/dist/engine/session/storage-base.js +4 -21
  422. package/dist/index.d.ts +35 -21
  423. package/dist/index.js +26 -17
  424. package/dist/internal/harness-types.d.ts +1 -1
  425. package/dist/internal/harness.d.ts +1 -0
  426. package/dist/internal/llm.d.ts +1 -0
  427. package/dist/orchestration/run-workflow-tool.d.ts +9 -3
  428. package/dist/orchestration/run-workflow-tool.js +59 -29
  429. package/dist/orchestration/workflow-governance.d.ts +1 -1
  430. package/dist/orchestration/workflow-governance.js +2 -1
  431. package/dist/orchestration/workflow-observe.d.ts +17 -1
  432. package/dist/orchestration/workflow-observe.js +20 -0
  433. package/dist/orchestration/workflow-types.d.ts +32 -7
  434. package/dist/orchestration/workflow.d.ts +4 -0
  435. package/dist/orchestration/workflow.js +762 -491
  436. package/dist/prompts/default.d.ts +1 -10
  437. package/dist/prompts/default.js +0 -2
  438. package/dist/shell/counting-pass.d.ts +50 -0
  439. package/dist/shell/counting-pass.js +502 -0
  440. package/dist/shell/lex.d.ts +4 -2
  441. package/dist/shell/lex.js +93 -34
  442. package/dist/shell/shell-words.d.ts +1 -1
  443. package/dist/shell/shell-words.js +7 -6
  444. package/dist/stores/file/background-agent-store.d.ts +1 -1
  445. package/dist/stores/file/background-agent-store.js +3 -1
  446. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  447. package/dist/stores/file/checkpoint-store.js +19 -14
  448. package/dist/stores/file/file-history-store.d.ts +1 -1
  449. package/dist/stores/file/file-history-store.js +3 -1
  450. package/dist/stores/file/index.d.ts +4 -3
  451. package/dist/stores/file/index.js +17 -8
  452. package/dist/stores/file/mailbox-store.d.ts +1 -1
  453. package/dist/stores/file/mailbox-store.js +9 -11
  454. package/dist/stores/file/memory-store.d.ts +1 -1
  455. package/dist/stores/file/memory-store.js +3 -1
  456. package/dist/stores/file/session-policy-store.d.ts +1 -1
  457. package/dist/stores/file/session-policy-store.js +3 -1
  458. package/dist/stores/file/session-store.d.ts +1 -1
  459. package/dist/stores/file/session-store.js +3 -1
  460. package/dist/stores/file/shared-ledger.d.ts +26 -0
  461. package/dist/stores/file/shared-ledger.js +38 -9
  462. package/dist/stores/file/tool-result-store.d.ts +20 -2
  463. package/dist/stores/file/tool-result-store.js +74 -6
  464. package/dist/stores/file/usage-window-store.d.ts +1 -1
  465. package/dist/stores/file/usage-window-store.js +3 -1
  466. package/dist/stores/file/workflow-journal-store.d.ts +1 -11
  467. package/dist/stores/file/workflow-journal-store.js +3 -2
  468. package/dist/tools/fs/containment-face.d.ts +5 -0
  469. package/dist/tools/fs/encoding.d.ts +13 -4
  470. package/dist/tools/fs/encoding.js +17 -2
  471. package/dist/tools/fs/fs-bash-background-text.d.ts +7 -0
  472. package/dist/tools/fs/fs-bash-background-text.js +1 -0
  473. package/dist/tools/fs/fs-bash.d.ts +14 -4
  474. package/dist/tools/fs/fs-bash.js +29 -35
  475. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  476. package/dist/tools/fs/fs-pdf.js +26 -21
  477. package/dist/tools/fs/fs-read.d.ts +5 -4
  478. package/dist/tools/fs/fs-read.js +35 -18
  479. package/dist/tools/fs/fs-search-tools.js +4 -1
  480. package/dist/tools/fs/fs-shared.d.ts +11 -13
  481. package/dist/tools/fs/fs-shared.js +11 -7
  482. package/dist/tools/fs/fs-write.js +5 -5
  483. package/dist/tools/fs/index.d.ts +14 -8
  484. package/dist/tools/fs/index.js +13 -5
  485. package/dist/tools/fs/program-read-model.d.ts +13 -0
  486. package/dist/tools/fs/program-read-model.js +15 -0
  487. package/dist/tools/fs/program-read-model.rows.js +1 -1
  488. package/dist/tools/fs/read-deny.d.ts +13 -10
  489. package/dist/tools/fs/read-deny.js +25 -5
  490. package/dist/tools/fs/read-floor.d.ts +62 -0
  491. package/dist/tools/fs/read-floor.js +58 -0
  492. package/dist/tools/fs/removal-targets.d.ts +9 -4
  493. package/dist/tools/fs/removal-targets.js +17 -9
  494. package/dist/tools/fs/search.d.ts +3 -3
  495. package/dist/tools/fs/search.js +4 -4
  496. package/dist/tools/fs/shell-read-check.d.ts +1 -1
  497. package/dist/tools/fs/shell-read-check.js +2 -1
  498. package/dist/tools/fs/shell-read-judge.d.ts +16 -8
  499. package/dist/tools/fs/shell-read-judge.js +10 -6
  500. package/dist/tools/fs/shell-read-plan.d.ts +6 -1
  501. package/dist/tools/fs/shell-read-plan.js +22 -15
  502. package/dist/tools/fs/shell-read-start.js +1 -0
  503. package/dist/tools/fs/shell-reentry-text.d.ts +15 -1
  504. package/dist/tools/fs/shell-reentry-text.js +25 -3
  505. package/dist/tools/monitor.d.ts +9 -4
  506. package/dist/tools/monitor.js +17 -8
  507. package/dist/tools/scheduler-tools.js +42 -4
  508. package/dist/tools/web.d.ts +0 -10
  509. package/dist/tools/web.js +1 -4
  510. package/package.json +5 -2
  511. package/test/export-surface.snapshot.json +161 -21
  512. package/wire-changes/core-stores-sql@7.59.0.json +29 -0
  513. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  514. package/wire-changes/core@7.59.0.json +2459 -0
  515. package/wire-changes/core@7.60.0.json +3274 -0
  516. package/wire-changes/mods-kernel@7.59.0.json +29 -0
  517. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  518. package/wire-changes/primitives@7.59.0.json +29 -0
  519. package/wire-changes/primitives@7.60.0.json +30 -0
@@ -172,6 +172,29 @@ export declare function computeBundleSectionHashes(bundle: Pick<MemoryExportBund
172
172
  * a tampered package fails integrity before its hash ever matters.
173
173
  */
174
174
  export declare function computeMemoryBundleHash(sectionHashes: Record<string, string>): string;
175
+ /**
176
+ * The SCOPE AUTHORIZATION SEAT (`expectedScopes`) — ONE reading for every host verb that takes it
177
+ * (`importMemoryBundle(bundle, { expectedScopes })` and `eraseMemoryEntries({ …, expectedScopes })`).
178
+ * A service endpoint pins its principal's grant set here. Present ⇒ every scope the request NAMES or
179
+ * RESOLVES TO must be a member of the set, and a touch that cannot be attributed to a scope is not a
180
+ * member. Absent ⇒ the host is the authorizer (no narrowing). The seat authorizes the verb only; it
181
+ * never widens or narrows a session's memory scopes or write scope.
182
+ *
183
+ * This is the seat's shape rule: an array (read once by the caller's capture) of non-empty strings.
184
+ * Duplicates are tolerated (the set is a set — {@link canonicalExpectedScopes}); anything else is a
185
+ * bad value and refused loudly, never read as "no narrowing" or as some other set.
186
+ */
187
+ export declare function expectedScopesInvalid(v: unknown): string | undefined;
188
+ /** The grant set's canonical form — sorted, de-duplicated (the form an erasure anchor records and a
189
+ * replay compares; two spellings of one set are one authorization). */
190
+ export declare function canonicalExpectedScopes(grant: readonly string[]): string[];
191
+ /**
192
+ * The seat's ONE membership judgment: the index of the first touched scope that is NOT a member of
193
+ * `grant` (an `undefined` touch — a scope the store cannot attribute — is never a member), or -1 when
194
+ * every touch is a member. The caller decides what a refusal may say (the import names its own
195
+ * bundle scope; the erasure lane names nothing).
196
+ */
197
+ export declare function firstOutsideExpectedScopes(grant: readonly string[], touched: readonly (string | undefined)[]): number;
175
198
  /**
176
199
  * design/178 v2-c §1-2① — the PURE bundle validation (integrity/structure/self-consistency; zero
177
200
  * store reads, zero side effects). Returns the FIRST violation, or undefined (valid). Every
@@ -33,6 +33,23 @@ function stringArrayInvalid(v, what) {
33
33
  function countInvalid(v, what) {
34
34
  return typeof v === "number" && Number.isInteger(v) && v >= 0 ? undefined : `${what} is not a non-negative integer`;
35
35
  }
36
+ export function expectedScopesInvalid(v) {
37
+ if (!Array.isArray(v))
38
+ return "expectedScopes is not an array (the grant set is a list of scope names)";
39
+ for (let i = 0; i < v.length; i++) {
40
+ const s = v[i];
41
+ if (typeof s !== "string" || s.length === 0)
42
+ return "expectedScopes carries a non-string or empty scope name";
43
+ }
44
+ return undefined;
45
+ }
46
+ export function canonicalExpectedScopes(grant) {
47
+ return [...new Set(grant)].sort();
48
+ }
49
+ export function firstOutsideExpectedScopes(grant, touched) {
50
+ const members = new Set(grant);
51
+ return touched.findIndex((s) => s === undefined || !members.has(s));
52
+ }
36
53
  function entryInvalid(raw, scopes) {
37
54
  if (!isRecord(raw))
38
55
  return "entry is not an object";
@@ -119,10 +136,12 @@ export function memoryBundleInvalid(raw, opts = {}) {
119
136
  if (typeof b.storeId !== "string" || b.storeId.length === 0)
120
137
  return "bundle.storeId is missing";
121
138
  if (opts.expectedScopes !== undefined) {
122
- const allowed = new Set(opts.expectedScopes);
123
- const outside = scopes.find((s) => !allowed.has(s));
124
- if (outside !== undefined)
125
- return `bundle scope ${JSON.stringify(outside)} is outside the expected scope set — whole package refused`;
139
+ const grantBad = expectedScopesInvalid(opts.expectedScopes);
140
+ if (grantBad !== undefined)
141
+ return grantBad;
142
+ const outside = firstOutsideExpectedScopes(opts.expectedScopes, scopes);
143
+ if (outside >= 0)
144
+ return `bundle scope ${JSON.stringify(scopes[outside])} is outside the expected scope set — whole package refused`;
126
145
  }
127
146
  const entriesArr = Array.isArray(b.entries) && b.entries;
128
147
  if (entriesArr === false)
@@ -11,15 +11,41 @@ export type ErasureSelect = {
11
11
  } | {
12
12
  sessionId: string;
13
13
  };
14
- /** design/178 v2-b §3.3(c) — one erased row's coordinates (the snapshot's tagged binding law,
15
- * without the account-trace extras: a wire validator refuses hybrid objects). */
14
+ /** design/178 v2-b §3.3(c) — one erased row's coordinates: the scope it was bound in, never its slug
15
+ * (a model-chosen file name can restate the content being erased; attestation v2). */
16
16
  export type ErasedBinding = {
17
17
  state: "bound";
18
18
  scope: string;
19
- slug: string;
20
19
  } | {
21
20
  state: "unbound";
22
21
  };
22
+ /**
23
+ * The closed set of places a copy of an erased entry can live in one store (attestation v2,
24
+ * `residuals.carriers`). `complete` means every one of them answers `remaining: 0`:
25
+ * - `projection` — the entry's files under its scope home (bound path + every census copy);
26
+ * - `shadow` — the control plane's committed copy;
27
+ * - `indexLine` — MEMORY.md pointer lines (name + description) naming a deleted projection path;
28
+ * - `quarantineCopy` — quarantine files whose frontmatter id is the erased id;
29
+ * - `planArchive` / `planWorkbook` — the consolidation plane's mint archive and plan workbook;
30
+ * - `evidenceBinding` — evidence-chain rows that still spell the entry's slug;
31
+ * - `backendDerived` — anything a backend derives privately (vectors, summaries).
32
+ */
33
+ export declare const ERASURE_CARRIER_CLASSES: readonly ["projection", "shadow", "indexLine", "quarantineCopy", "planArchive", "planWorkbook", "evidenceBinding", "backendDerived"];
34
+ export type ErasureCarrierClass = (typeof ERASURE_CARRIER_CLASSES)[number];
35
+ /** One carrier class's answer: what this call removed and what is known to remain, or `unverified`
36
+ * when the answering lane cannot read that class (which never reads as clean). */
37
+ export type ErasureCarrierAnswer = {
38
+ removed: number;
39
+ remaining: number;
40
+ } | {
41
+ unverified: true;
42
+ };
43
+ /** A store-level count that does not decide `status`; `unverified` when the lane cannot count. */
44
+ export type ErasureCountAnswer = {
45
+ count: number;
46
+ } | {
47
+ unverified: true;
48
+ };
23
49
  /** The input of the erasure lane (engine host API `eraseMemoryEntries` and the File capability face
24
50
  * `eraseWithEvidence` share it; the File face ignores `allowUnevidenced` — with the evidence
25
51
  * capability present there is nothing to degrade to). */
@@ -29,20 +55,47 @@ export interface EraseMemoryEntriesInput {
29
55
  select: ErasureSelect;
30
56
  /** Evidence-capability-ABSENT degradation opt-in (engine lane only; default = loud refusal). */
31
57
  allowUnevidenced?: boolean;
58
+ /**
59
+ * The scope AUTHORIZATION seat `importMemoryBundle` takes — one shape rule and one membership
60
+ * predicate ({@link expectedScopesInvalid} / {@link firstOutsideExpectedScopes}). Present ⇒ a
61
+ * `{ scope }` selector's own scope and the BINDING scope of every resolved id must be members (an id
62
+ * with no binding — no account row, unbound, a non-entry-id key, unledgered file — is not); any violation
63
+ * refuses the whole request (`config.memory_erasure_scope`) naming no count, id or scope, with
64
+ * nothing deleted or recorded. The evidence lane judges in its lock and records the canonical set on
65
+ * the anchor; a replay must carry the same set and is judged against the scopes its first execution
66
+ * recorded (the request's projection rows), never the live account. A face honours the seat only when
67
+ * its backend declares {@link FileMemoryEngineBackend.judgesErasureScopes}. The degraded lane judges
68
+ * the read faces' answer with no lock before its CAS'd deletes (an entry moved to another scope with
69
+ * unchanged content in that window is not seen). Absent ⇒ the host is the authorizer.
70
+ */
71
+ expectedScopes?: readonly string[];
32
72
  }
33
73
  /**
34
74
  * design/178 v2-b §3.3(c) — the erasure attestation (the deliverable a compliance caller archives).
35
75
  * Every claim is black-box re-checkable: an `erased` row is verified by `committedSnapshotOf(id)`
36
76
  * answering `"absent"`, the chain containing its `evidenceEv` delete row, and `getByIds([id])`
37
- * answering empty.
77
+ * answering empty. It names ids, scopes, revs, sessions and counts — never a slug, a file name or
78
+ * entry text.
79
+ *
80
+ * Contract (version 2): the evidence chain is append-only and a delete row never expires with any
81
+ * retention period; on the evidence lane (`replay: "converges"`) a replay of the same requestId
82
+ * converges with no time limit (so a ≥ 24 h replay window holds); the degraded lane promises no
83
+ * replay convergence and says so (`replay: "unsupported"`).
38
84
  */
39
85
  export interface MemoryErasureAttestation {
40
- /** Version envelope — a consumer reading `v > 1` must refuse, never reinterpret. */
41
- v: 1;
86
+ /** Version envelope — a consumer reading `v > 2` must refuse, never reinterpret. Version 2 dropped
87
+ * every slug (`erased[].binding`, `erasedPreviously[].from`) and replaced the residual name lists
88
+ * with the carrier table. */
89
+ v: 2;
42
90
  requestId: string;
43
91
  at: number;
44
92
  /** `"complete"` ⇔ conflicts empty ∧ every pinned id ∈ erased ∪ erasedPreviously ∪ (notFound with
45
- * `custodyState === "complete"`). Everything else is `"partial"` (replay converges it). */
93
+ * `custodyState === "complete"`) ∧ every `residuals.carriers` class answers `remaining: 0`
94
+ * ({@link erasureStatusOf} — one predicate for every lane). Its reach is THIS store and the
95
+ * selected ids: another entry that restates an erased one is counted on `residuals.derivedEntries`
96
+ * and does not decide it. Everything else is `"partial"`; a replay converges the classes the lane
97
+ * can clear, and says when it cannot (`unverified`, or `evidenceBinding.remaining` — rows the
98
+ * append-only chain keeps). */
46
99
  status: "complete" | "partial";
47
100
  /** `"journal"` = the File evidence path; `"none"` = the explicit `allowUnevidenced` degradation
48
101
  * lane (always present — a silent downgrade is the forbidden shape). */
@@ -86,18 +139,6 @@ export interface MemoryErasureAttestation {
86
139
  id: string;
87
140
  ev: string;
88
141
  at: number;
89
- /** The pre-delete binding from the most recent same-request delete row that RECORDED one —
90
- * carried so a REPLAY can still run the index-line sweep (the ledger row is gone; the evidence
91
- * row is the only surviving source of the projection path). `ev`/`at` come from the MOST RECENT
92
- * same-request delete row (which may be a later, binding-less re-erase). Absent in THREE cases:
93
- * no same-request delete row ever recorded a binding (unbound / pre-v2-form), or the recorded
94
- * path is OCCUPIED now (a live account row binds that scope+slug, or bytes exist at the path —
95
- * the binding is known but suppressed: the index line there belongs to the occupant, and a
96
- * consumer must not read absence as "no residue possible"). */
97
- from?: {
98
- scope: string;
99
- slug: string;
100
- };
101
142
  }>;
102
143
  /** Per-id planning-stage faults (io/plan errors under the lock — there is no CAS loser inside a
103
144
  * single lock span). Non-fatal; a replay converges them. */
@@ -106,26 +147,44 @@ export interface MemoryErasureAttestation {
106
147
  reason: string;
107
148
  }>;
108
149
  residuals: {
109
- /** Quarantine files whose frontmatter id is in the pinned set (preserve-not-delete: the
110
- * attestation enumerates, an explicit second action clears). */
111
- quarantineHits: string[];
112
- /** Quarantine files that could not be attributed (fragments / non-entry shapes) — the honest
113
- * bound of the enumeration. */
114
- quarantineOpaque: number;
115
- /** Derived MEMORY.md index files that may STILL carry a line naming an erased entry, because
116
- * the erase-time index sweep could not read or rewrite them (a non-file at the index path, a
117
- * non-ENOENT read failure, or a refused write — an entry may carry a parenthesized failure
118
- * detail). Present only when non-empty. Minted by the ENGINE lane
119
- * (`MemoryEngine.eraseMemoryEntries` — the derived index is the engine's plane; this backend
120
- * face answers without the seat). The next successful materialize's rebuild also clears
121
- * orphaned lines, but a one-off compliance erasure cannot count on one — hence the disclosure
122
- * instead of a silent clean residual set. */
123
- indexUncleared?: string[];
150
+ /** Every class of {@link ERASURE_CARRIER_CLASSES}, each answered. The derived-index class
151
+ * (`indexLine`) is the ENGINE's plane: the File face answers it `unverified` while the deleted
152
+ * projection paths wait in its transient sweep record, and `MemoryEngine.eraseMemoryEntries`
153
+ * sweeps the index lines naming those paths (whoever holds the path now — an occupant's line
154
+ * comes back in mechanical form at the next materialize), drops the record, and answers it.
155
+ * `evidenceBinding.remaining` counts rows minted before slugs left the chain (pre-version-2
156
+ * delete rows, and move / migration-bind rows) — the append-only chain keeps them, so they keep
157
+ * the request `partial` and a replay cannot clear them. */
158
+ carriers: Record<ErasureCarrierClass, ErasureCarrierAnswer>;
159
+ /** Quarantine files no id could be read from (fragments / non-entry shapes) — the honest bound of
160
+ * the quarantine read; a store-level count that does not decide `status`. */
161
+ quarantineUnattributed: ErasureCountAnswer;
162
+ /** Committed entries outside the selection whose consolidation lineage names an erased id (they
163
+ * may restate it) — counted, not erased; their closure is the caller's to compute. */
164
+ derivedEntries: ErasureCountAnswer;
165
+ /** Whether a replay of this requestId converges (the evidence lane) or is a new request (the
166
+ * degraded lane). */
167
+ replay: "converges" | "unsupported";
124
168
  /** Propagation boundary, self-declared always: deletion is a THIS-store fact; remote-peer
125
169
  * convergence is the sync deployment's half to prove. */
126
170
  propagation: "local-store-only";
127
171
  };
128
172
  }
173
+ /** The status law of {@link MemoryErasureAttestation.status} — every lane answers through it. */
174
+ export declare function erasureStatusOf(att: Pick<MemoryErasureAttestation, "conflicts" | "resolvedIds" | "erased" | "erasedPreviously" | "notFound" | "custodyState" | "residuals">): "complete" | "partial";
175
+ /** The paths the request's index sweep still owes at `storeRoot`, or `[]` when it owes none. */
176
+ export declare function readErasureSweep(controlDir: string, storeRoot: string, requestId: string): string[];
177
+ /**
178
+ * Run an index sweep as a transaction of the store — under its transaction lock (the lock its commits,
179
+ * recoveries and a re-anchor of its root take, so none of them lands inside a sweep) and under the
180
+ * record's lock — handed the paths `requestId` owes at `storeRoot` (`[]` without a request — the
181
+ * degraded lane sweeps its own deletes the same way); when `sweep` answers that every owed line is
182
+ * gone, the request's row goes. Two sweeps never interleave their read-filter-write of one index (a
183
+ * lost update would otherwise put a swept line back after its obligation was settled). The lock is
184
+ * proved still this holder's before the sweep acts and again before its answer is acted on, as at a
185
+ * commit ({@link assertStoreTxnLockOwnership}): a holder stolen from throws, and the row stays.
186
+ */
187
+ export declare function sweepUnderErasureRecord(controlDir: string, storeRoot: string, requestId: string | undefined, sweep: (owed: readonly string[]) => boolean): Promise<void>;
129
188
  /** sha256 hex over the selector's canonical JSON + LF — the replay-identity judge (§4.6) and the
130
189
  * anchor validator's recomputation basis (a 64-hex shape check alone would let a forged anchor swap
131
190
  * the selector under a kept hash). */
@@ -134,6 +193,11 @@ export declare function erasureSelectHash(select: ErasureSelect): string;
134
193
  * set — the selector the anchor row echoes verbatim must pass the anchor's own validator, so the
135
194
  * entry check and the chain check are the same predicate). Returns the violation, or undefined. */
136
195
  export declare function erasureRequestInvalid(input: EraseMemoryEntriesInput): string | undefined;
196
+ /** The authorization refusal, one text for both lanes; it names no count, id or scope (saying which
197
+ * id sits where would answer the very question the seat withholds). */
198
+ export declare function erasureScopeRefusal(where: string): Error & {
199
+ code: string;
200
+ };
137
201
  /**
138
202
  * Snapshot the erasure input into PLAIN data by reading every accessor exactly once (round-2 #3/#5):
139
203
  * validation and use must observe the SAME value, so an accessor-backed (getter/Proxy) selector or
@@ -457,8 +521,12 @@ export declare class FileMemoryEngineBackend implements MemoryBackend {
457
521
  /** Fail-open announcement convenience (S2-B queue posture — an unwritable queue never fails the
458
522
  * operation that had something to say; the fail-CLOSED evidence lane is `transfers.jsonl`). */
459
523
  private enqueueExternalItems;
524
+ /** The operator half of {@link enqueueExternalItems}: said to the host only. */
525
+ private withholdNotice;
460
526
  /** One-shot dedup for adopting-face notices (see {@link adoptionNoticeKeys}). */
461
527
  private announceAdoptionNotice;
528
+ /** The last unbound-row reading said to the host (the operator face is told when it changes). */
529
+ private unboundReadingSaid;
462
530
  /**
463
531
  * §3.4 — the standing unbound-row disclosure, in ONE spelling for BOTH faces that carry it (the
464
532
  * harvest preflight `checkControlPlane` and the restricted sweep `auditRestrictedDivergence` used
@@ -466,27 +534,11 @@ export declare class FileMemoryEngineBackend implements MemoryBackend {
466
534
  * clause, which is if anything MORE apt there — a restricted session has no write channel of its
467
535
  * own to converge the row).
468
536
  *
469
- * De-duplicated against what is ALREADY QUEUED, not against a per-instance latch. The repeat this
470
- * closes was not merely noise: the queue is bounded ({@link MEMORY_ANNOUNCEMENTS_MAX}), so a
471
- * long-lived instance with one stuck row folded REAL notices out of it to make room for copies of
472
- * this one. But the latch the sibling adoption notices use ({@link announceAdoptionNotice}) is the
473
- * wrong instrument HERE, twice over, and both were found in review:
474
- * · a backend instance is a RUNNER-level dependency reused across every session it serves, so a
475
- * per-instance latch would announce the standing condition to the first session and then hold
476
- * its peace forever — turning a flood into silence, against this disclosure's own contract
477
- * (「the STATE does not go silent」). The queue is DRAINED at each session's first injection, so
478
- * "is an identical line still pending?" is exactly the right question: no repeat within a
479
- * session, one fresh statement in every session that has not yet been told.
480
- * · a latch key would have to encode the id set, and ledger row ids are arbitrary external
481
- * strings (a comma is legal) — `join(",")` makes `["a,b","c"]` and `["a","b,c"]` the same key,
482
- * so a real change of state could be suppressed. Comparing the RENDERED LINE has no such seam:
483
- * two states that render the same sentence are, to every consumer, the same statement.
484
- *
485
- * The test runs INSIDE the queue's own locked read-modify-write
486
- * ({@link enqueueMemoryAnnouncement}'s `supersedesPrefix`), not as a peek followed by an append: a
487
- * peek-then-enqueue would race a concurrent drain, and two processes could both peek-miss and both
488
- * append. Fail-open like every announce site — an unwritable queue never fails an operation that
489
- * had something to say.
537
+ * An unbound row is one whose scope cannot be derived, and the sentence counts rows over the whole
538
+ * store — so it is no session's to read and goes to the host's incident sink only. It is said when
539
+ * the reading changes (compared as the RENDERED LINE: ledger row ids are arbitrary external strings,
540
+ * so a key built by joining them could make two different states look the same), not at every
541
+ * preflight that re-derives it.
490
542
  */
491
543
  private announceUnboundRows;
492
544
  /** Resolve a binding's absolute projection path WITHOUT registering anything (probes must stay
@@ -975,6 +1027,10 @@ export declare class FileMemoryEngineBackend implements MemoryBackend {
975
1027
  applyPatches(patches: readonly NotePatch[], opts?: Parameters<MemoryBackend["applyPatches"]>[1]): Promise<PatchReport>;
976
1028
  /** The caller's `admit` is honored: every add's final spelling is resolved under the lock and admitted before it is written. */
977
1029
  readonly admitsLandings: true;
1030
+ /** {@link eraseWithEvidence} judges `EraseMemoryEntriesInput.expectedScopes` in its lock. A
1031
+ * declaration, never duck-typing: the engine refuses a grant-bearing erasure over an evidence face
1032
+ * that does not state it (a face that ignored the set would erase outside it). */
1033
+ readonly judgesErasureScopes: true;
978
1034
  private txnLockDir;
979
1035
  /** The store's transaction lock, waited for ({@link acquireStoreTxnLock} — the one mkdir mutex, shared with a re-anchor of the root). */
980
1036
  private acquireTxnLock;
@@ -1031,6 +1087,23 @@ export declare class FileMemoryEngineBackend implements MemoryBackend {
1031
1087
  * converges them); everything before the journal write refuses cleanly (F-1); every crash window
1032
1088
  * after it converges through the shared recovery leg (F-2..F-5, F-13).
1033
1089
  */
1090
+ /** The sweep-record row an erasure journal owes: its request's physical projection deletes, relative
1091
+ * to this store's root. One derivation for the commit path and for recovery rolling the same journal
1092
+ * forward — including a journal an older binary wrote, which never had a record (an erasure journal
1093
+ * carries exactly one request's delete rows; a journal with none owes none). The commit path derives
1094
+ * it before its commit point, so a target the row cannot name refuses with nothing committed. */
1095
+ private journalSweepRow;
1096
+ /** Write the journal's sweep-record row ({@link journalSweepRow}; idempotent — a union). */
1097
+ private recordJournalSweep;
1098
+ /** Delete every quarantine file whose frontmatter id is in `ids` (a quarantined copy is a copy of the
1099
+ * entry). Runs under the erasure's lock after its commit; a file that cannot be removed stays
1100
+ * counted as `remaining` and a replay retries it. Files no id can be read from are counted, not
1101
+ * touched. An unreadable quarantine directory refuses the attestation (the deletions themselves
1102
+ * are committed; a replay converges). */
1103
+ private eraseQuarantineCopiesLocked;
1104
+ /** Does the control-plane directory `name` hold any entry? ENOENT ⇒ no; any other read failure ⇒
1105
+ * yes (an unreadable directory may hold anything). */
1106
+ private controlDirHoldsAnything;
1034
1107
  eraseWithEvidence(input: EraseMemoryEntriesInput): Promise<MemoryErasureAttestation>;
1035
1108
  /** Bounded journal-quiescence fence (attempt count × retry pause). Constants, not knobs: the
1036
1109
  * contended window is the commit tail of one transaction (milliseconds); a store where it stays