@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
@@ -2,7 +2,7 @@ export { MemoryEngine, buildMemoryInstruction, truncateIndex, MEMORY_INSTRUCTION
2
2
  export { MEMORY_SEARCH_TOOL_NAME, MEMORY_GET_TOOL_NAME, MEMORY_INDEX_TOOL_NAME, MEMORY_ENGINE_TOOL_NAMES, type MemorySearchDetails, type MemorySearchHit, type CleanMemorySearchHit, type ExposedMemorySearchHit, type MemoryGetDetails, type MemoryIndexDetails, type MemoryIndexRow, type CleanMemoryIndexRow, type ExposedMemoryIndexRow, } from "./tools.js";
3
3
  export { MEMORY_EXPOSURE_BANNER, MEMORY_EXPOSURE_HANDLE_TAG, MEMORY_PROVENANCE_RECALL_SENTENCE, MEMORY_PROVENANCE_SEARCH_SENTENCE, memoryExposureIndexRow, parseMemoryExposureIndexRow, } from "./provenance-wording.js";
4
4
  export { scanMemoryWrite, scanMemoryFileName, scanRemediation, MEMORY_FILENAME_SEGMENT_RE } from "./scan.js";
5
- export { FileMemoryEngineBackend, scanEntryFiles, MEMORY_INDEX_FILENAME, DEFAULT_MAX_ENTRY_DEPTH, type ScannedEntryFile, type TransferEvidence, type CommittedBinding, type CommittedEntrySnapshot, type CommittedScopeSnapshots, type EntryCustodyReport, erasureSelectHash, type EraseMemoryEntriesInput, type ErasureSelect, type ErasedBinding, type MemoryErasureAttestation, type MemoryExportSnapshot, } from "./file-backend.js";
5
+ export { FileMemoryEngineBackend, scanEntryFiles, MEMORY_INDEX_FILENAME, DEFAULT_MAX_ENTRY_DEPTH, type ScannedEntryFile, type TransferEvidence, type CommittedBinding, type CommittedEntrySnapshot, type CommittedScopeSnapshots, type EntryCustodyReport, erasureSelectHash, type EraseMemoryEntriesInput, type ErasureCarrierAnswer, type ErasureCarrierClass, type ErasureCountAnswer, type ErasureSelect, type ErasedBinding, type MemoryErasureAttestation, type MemoryExportSnapshot, } from "./file-backend.js";
6
6
  export { computeBundleSectionHashes, computeMemoryBundleHash, memoryBundleInvalid, type MemoryExportBundle, type MemoryImportReport, type MemoryBundleImportPlan, type BundleChallengeRow, type BundleLineageRow, type BundlePollutedSession, } from "./export-bundle.js";
7
7
  export { ControlPlaneCorruptError, deriveControlPlaneDir, deriveRepoControlPlaneDir, deriveRepoKey, deriveRepoMemoryDir, deriveProjectMemoryDir, deriveProjectControlDir, recordProjectIdHint, lookupProjectIdHint, PROJECT_ID_HINTS_FILE, resolveMemoryEngineRoot, scopeDirFor, scopeDirName, scopeRegistryShape, layoutNeedsAdoption, adoptRootScopeLayout, v1MemoryPathKeyResolver, unresolvedProjectionDebts, scanFuseKey, type AdoptRootScopeLayoutOptions, type ScopeRegistryShape, enqueueMemoryAnnouncement, drainMemoryAnnouncements, peekMemoryAnnouncements, bumpScanFuse, scanFuseCount, clearScanFuse, ANNOUNCEMENTS_FILE, MEMORY_ANNOUNCEMENTS_MAX, SCAN_FUSE_FILE, SCAN_FUSE_THRESHOLD, LINEAGE_FILE, CHALLENGES_FILE, CHALLENGED_HISTORY_FILE, CHALLENGE_LEDGER_MAX_EVENTS, rebuildStrictControlPlaneLedger, type ControlPlaneRebuildReceipt, type StrictControlPlaneLedger, type ChallengeAppendResult, type ChallengeAssignment, type ChallengeEvent, type ChallengedHistoryRow, type LineagePendingTxn, type LineagePromotion, SESSION_CAPTURE_OPTOUT_DIR, markSessionCaptureOptOut, readSessionCaptureOptOut, listSessionCaptureOptOut, fileSessionCaptureRecordStore, type SessionCaptureOptOutRecord, type SessionCaptureOptOutMarkOutcome, type SessionCaptureRecordStore, } from "./layout.js";
8
8
  export { readV2HeaderHints, isInstructionEntry, type V2HeaderHints } from "./header-hints.js";
@@ -21,4 +21,5 @@ export { SCOPE_SEGMENT_MAX_ENCODED, PROJECT_MARKER_PATH, encodeScopeSegment, dec
21
21
  export { migrateScope, type MigrateScopeReport } from "./migrate.js";
22
22
  export { materializeEntriesToFiles, harvestFilesToPatches, projectionsToWriteBack, screenInboundEntries, REMOTE_HARVEST_PER_FILE_BYTES, REMOTE_MASS_DELETION_FUSE_RATIO, type RemoteMemoryFile, type RemoteMemoryBaseline, type RemoteMaterialization, type RemoteHarvestResult, type InboundEntryFinding, } from "./data-plane.js";
23
23
  export { reconcileMemoryEntries, nextSyncBaseline, mergeRecallHits, type MemorySyncCursor, type MemorySyncConflict, type MemorySyncPlan, type RecallSource, } from "./sync.js";
24
- export { syncMemoryScope, type MemorySyncTransport, type MemorySyncRequestBody, type MemorySyncResponseBody, type MemorySyncClientConflict, type SyncMemoryScopeOptions, type MemorySyncClientResult, } from "./sync-client.js";
24
+ export { syncMemoryScope, memorySyncStoreOf, carriesCredential, type MemorySyncTransport, type MemorySyncRequestBody, type MemorySyncResponseBody, type MemorySyncClientConflict, type SyncMemoryScopeOptions, type MemorySyncClientResult, } from "./sync-client.js";
25
+ export { memorySyncReportOf, memoryTravelGapOf, type MemorySyncLayerReport, type MemorySyncRoundReport } from "./sync-report.js";
@@ -19,4 +19,5 @@ export { SCOPE_SEGMENT_MAX_ENCODED, PROJECT_MARKER_PATH, encodeScopeSegment, dec
19
19
  export { migrateScope } from "./migrate.js";
20
20
  export { materializeEntriesToFiles, harvestFilesToPatches, projectionsToWriteBack, screenInboundEntries, REMOTE_HARVEST_PER_FILE_BYTES, REMOTE_MASS_DELETION_FUSE_RATIO, } from "./data-plane.js";
21
21
  export { reconcileMemoryEntries, nextSyncBaseline, mergeRecallHits, } from "./sync.js";
22
- export { syncMemoryScope, } from "./sync-client.js";
22
+ export { syncMemoryScope, memorySyncStoreOf, carriesCredential, } from "./sync-client.js";
23
+ export { memorySyncReportOf, memoryTravelGapOf } from "./sync-report.js";
@@ -433,6 +433,32 @@ export interface StoreRootReanchor {
433
433
  /** The control plane the anchor lives in. */
434
434
  readonly controlDir: string;
435
435
  }
436
+ /**
437
+ * The TRANSIENT sweep record: per erasure requestId, the projection paths it deleted, kept in the
438
+ * control plane only until the derived-index sweep has cleared every MEMORY.md line naming them (the
439
+ * paths spell slugs, so the durable chain and the attestation never hold them). Written from the
440
+ * request's journal right after its commit point, and by recovery from a journal it rolls forward;
441
+ * swept and settled by `MemoryEngine.eraseMemoryEntries` under this file's lock. A request with a
442
+ * record is `partial` on `indexLine`. A row's paths are relative to the store root
443
+ * ({@link erasureSweepRecordPathOf}) and are read at the root the store is opened at now
444
+ * ({@link erasureSweepOwedAt}), so a row binds no root and follows a re-anchor. A record that cannot
445
+ * be read or written, or a row path that is absolute or leaves the root, refuses like every strict
446
+ * control-plane file (fail-closed).
447
+ */
448
+ export declare const ERASURE_SWEEP_RECORD_FILE = "erasure-sweeps.json";
449
+ export declare const ERASURE_SWEEP_RECORD_WHAT = "memory erasure sweep record";
450
+ export interface ErasureSweepRecordFile {
451
+ v: 1;
452
+ requests: Record<string, string[]>;
453
+ }
454
+ export declare function coerceErasureSweepRecord(raw: unknown): ErasureSweepRecordFile;
455
+ /** The row path of `target`, a projection `requestId` deleted under `storeRoot`: relative to the root's
456
+ * physical form, the target placed as the act gate places a delete ({@link landsOutsideStore}: its directory
457
+ * where it lands, the final component as spelled) — so every spelling of one root records one row. A target
458
+ * that does not land under the root is refused (fail-closed; the text names no path — paths spell slugs). */
459
+ export declare function erasureSweepRecordPathOf(storeRoot: string, requestId: string, target: string): string;
460
+ /** The paths `requestId`'s row owes, at the root the store is opened at now (`[]` without a row). */
461
+ export declare function erasureSweepOwedAt(file: ErasureSweepRecordFile, storeRoot: string, requestId: string): string[];
436
462
  /**
437
463
  * The ONE way a recorded root anchor changes: point it at where `dir` resolves now — a store moved on
438
464
  * purpose, or an anchor that is damaged. `opts.controlDir` names the store's control plane exactly as its
@@ -442,9 +468,10 @@ export interface StoreRootReanchor {
442
468
  * mistaken `controlDir` would otherwise record an anchor no opener reads. Moves nothing and says nothing
443
469
  * about whether the directory holds the same store. A re-anchor is a transaction of the store: it holds the
444
470
  * store's transaction lock ({@link acquireStoreTxnLock}; a commit in progress is waited for, never crossed) and
445
- * is refused while a committed transaction is pending recovery (its journal names paths under the recorded
446
- * root: replayed there first, never carried over). Every live holder judges against the new anchor at its
447
- * next face. Discloses `memory.root_reanchored` on `opts.onIncident`.
471
+ * is refused while the control plane owes anything at the recorded root ({@link rootBoundObligationOf}: a
472
+ * committed transaction pending recovery — its journal names paths under the recorded root and is replayed
473
+ * there first, never carried over). Every live holder judges against the new anchor at its next face.
474
+ * Discloses `memory.root_reanchored` on `opts.onIncident`.
448
475
  */
449
476
  export declare function reanchorMemoryStoreRoot(dir: string, opts?: {
450
477
  controlDir?: string;
@@ -598,9 +625,12 @@ export declare function dropStagingSecondNames(seat: string, opened: {
598
625
  */
599
626
  export declare function restoreContainedBaseline(path: string, committed: string, leftOnPlane: string | undefined): "written" | "kept" | "failed";
600
627
  export declare function quarantineAndTombstone(path: string, content: string, quarantineDir: string, now: () => number): QuarantineOutcome;
601
- /** S2-B — the queued memory-change announcements (control plane; drained at session-first inject). */
628
+ /** S2-B — the queued memory-change announcements (control plane; drained at session-first inject).
629
+ * One file, one bounded queue PER SCOPE inside it (see {@link enqueueMemoryAnnouncement}). */
602
630
  export declare const ANNOUNCEMENTS_FILE = "announcements.json";
603
- /** S2-B — bounded queue: overflow FOLDS (oldest dropped, counted) instead of growing unbounded. */
631
+ /** S2-B — bounded queue, per scope: overflow FOLDS (oldest dropped, counted) instead of growing
632
+ * unbounded. The bound, the fold count and the standing-condition sweep are all one scope's —
633
+ * a scope that floods its own queue never pushes another scope's notices out. */
604
634
  export declare const MEMORY_ANNOUNCEMENTS_MAX = 20;
605
635
  /** S2-C — per-file write-rejection counts (the beforeWrite silent-reject fuse; O-F9/C-F7: scoped
606
636
  * state in `.engine/`, so the count survives suspend/resume and backend re-construction). */
@@ -640,10 +670,17 @@ export declare function acquireSidecarLock(lockDir: string, opts?: SidecarLockOp
640
670
  * locked update) keeps the leniency, because its token writes are best-effort and an absent owner
641
671
  * file there is the documented pre-token degraded shape, not evidence of a steal. */
642
672
  export declare function assertSidecarLockOwnership(lockDir: string, token: string, what: string, mode?: "strict" | "lenient"): void;
643
- interface AnnouncementsRecord {
644
- /** How many announcements were dropped by the bounded-queue fold (disclosed at render). */
673
+ /** What a drain or a peek answers for the scopes it was asked about. */
674
+ export interface DrainedMemoryAnnouncements {
675
+ /** The asked scopes' fold counts, summed. */
645
676
  folded: number;
677
+ /** The asked scopes' announcements, in enqueue-time order. */
646
678
  queue: MemoryAnnouncement[];
679
+ /** Notices found in the queue file WITHOUT a scope (the pre-per-scope file form, or a hand-written
680
+ * line): they belong to no queue, so no session ever reads them — they are discarded on the first
681
+ * locked rewrite and only their number is kept, for the operator face. A drain hands the number
682
+ * over once and resets it; a peek reports it without resetting. */
683
+ unscopedDiscarded: number;
647
684
  }
648
685
  /**
649
686
  * S2-B — enqueue one announcement (journaled + locked; bounded with overflow folding).
@@ -670,10 +707,21 @@ interface AnnouncementsRecord {
670
707
  export declare function enqueueMemoryAnnouncement(controlDir: string, ann: MemoryAnnouncement, opts?: {
671
708
  supersedesPrefix?: string;
672
709
  }): void;
673
- /** S2-B — drain the queue (session-first inject, 时机①). Returns what was queued and resets it. */
674
- export declare function drainMemoryAnnouncements(controlDir: string): AnnouncementsRecord;
675
- /** Test/observability peek (journal-aware, non-destructive). */
676
- export declare function peekMemoryAnnouncements(controlDir: string): AnnouncementsRecord;
710
+ /**
711
+ * S2-B — drain the queues of `scopes` (session-first inject, 时机①): returns what those scopes had
712
+ * queued and resets exactly them. Every other scope's queue is left as it was, for the session that
713
+ * mounts it — the drain that empties a queue is a reader of that queue, never a bystander.
714
+ */
715
+ export declare function drainMemoryAnnouncements(controlDir: string, scopes: readonly string[]): DrainedMemoryAnnouncements;
716
+ /** Test/observability peek of `scopes` (journal-aware, non-destructive). */
717
+ export declare function peekMemoryAnnouncements(controlDir: string, scopes: readonly string[]): DrainedMemoryAnnouncements;
718
+ /**
719
+ * Move every scope's queue from one control plane to another (a mount-key switch re-homes the control
720
+ * plane, and the notices queued under the old key must not be orphaned). Each line keeps its scope; the
721
+ * destination's per-scope bounds apply as each line lands. The only whole-file read there is: it hands
722
+ * lines to the same scopes' queues elsewhere, never to a reader.
723
+ */
724
+ export declare function transferMemoryAnnouncements(fromControlDir: string, toControlDir: string): void;
677
725
  /** The fuse key for a memory file: the ledger form `(scope, rel)` (`rel` relative to the scope's
678
726
  * home, `/`-separated) — location-free, so a home move never re-keys a count. */
679
727
  export declare function scanFuseKey(scope: string, rel: string): string;
@@ -2,7 +2,7 @@ import { closeSync, constants as fsConstants, copyFileSync, existsSync, fstatSyn
2
2
  const { O_WRONLY, O_RDONLY, O_CREAT, O_NOFOLLOW, O_NONBLOCK, O_EXCL } = fsConstants;
3
3
  import { homedir } from "node:os";
4
4
  import { createHash, randomUUID } from "node:crypto";
5
- import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";
5
+ import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
6
6
  import { MEMORY_ORIGIN_CAUSES } from "./types.js";
7
7
  import { physicalPathOf, physicalPathOfExisting, priorCallerCasedPathOf } from "../physical-path.js";
8
8
  import { thrownLabel, thrownText } from "../thrown-value.js";
@@ -1063,6 +1063,40 @@ function reanchorDestination(dir) {
1063
1063
  throw reanchorRefusal(`the store root ${JSON.stringify(dir)} resolves to ${to}, which is not a directory`);
1064
1064
  return to;
1065
1065
  }
1066
+ export const ERASURE_SWEEP_RECORD_FILE = "erasure-sweeps.json";
1067
+ export const ERASURE_SWEEP_RECORD_WHAT = "memory erasure sweep record";
1068
+ function isStoreRelativePath(p) {
1069
+ return p.length > 0 && !isAbsolute(p) && !p.split(sep === "/" ? "/" : /[\\/]/).includes("..");
1070
+ }
1071
+ export function coerceErasureSweepRecord(raw) {
1072
+ if (raw === undefined)
1073
+ return { v: 1, requests: Object.create(null) };
1074
+ const requests = raw?.requests;
1075
+ if (typeof raw !== "object" || raw === null || raw.v !== 1 || typeof requests !== "object" || requests === null || Array.isArray(requests)) {
1076
+ throw new ControlPlaneCorruptError(`${ERASURE_SWEEP_RECORD_WHAT} has an unrecognized shape (fail-closed sidecar)`);
1077
+ }
1078
+ const out = Object.create(null);
1079
+ for (const [req, paths] of Object.entries(requests)) {
1080
+ if (!Array.isArray(paths) || paths.some((p) => typeof p !== "string" || !isStoreRelativePath(p)))
1081
+ throw new ControlPlaneCorruptError(`${ERASURE_SWEEP_RECORD_WHAT} row for request ${JSON.stringify(req.slice(0, 80))} is malformed — a row names paths relative to the store root (fail-closed sidecar)`);
1082
+ out[req] = paths;
1083
+ }
1084
+ return { v: 1, requests: out };
1085
+ }
1086
+ export function erasureSweepRecordPathOf(storeRoot, requestId, target) {
1087
+ const rel = join(relative(landingPathOf(storeRoot), landingPathOf(dirname(target))), basename(target));
1088
+ if (!isStoreRelativePath(rel))
1089
+ throw new ControlPlaneCorruptError(`${ERASURE_SWEEP_RECORD_WHAT}: a path request ${JSON.stringify(requestId.slice(0, 80))} deleted is not under the store root ${storeRoot} — a row names paths relative to the root (fail-closed sidecar)`);
1090
+ return rel;
1091
+ }
1092
+ export function erasureSweepOwedAt(file, storeRoot, requestId) {
1093
+ return (file.requests[requestId] ?? []).map((rel) => join(storeRoot, rel));
1094
+ }
1095
+ function rootBoundObligationOf(controlDir) {
1096
+ if (lstatOrAbsent(join(controlDir, STORE_JOURNAL_FILE)) === undefined)
1097
+ return undefined;
1098
+ return { owed: "a committed transaction is still pending recovery", remedy: "open it once so the journal replays" };
1099
+ }
1066
1100
  function reanchorRefusal(sentence) {
1067
1101
  const e = new Error(`reanchorMemoryStoreRoot: ${sentence}`);
1068
1102
  e.code = "config.memory_reanchor";
@@ -1092,8 +1126,9 @@ export async function reanchorMemoryStoreRoot(dir, opts = {}) {
1092
1126
  catch {
1093
1127
  throw reanchorRefusal(`the store's transaction lock was lost while re-anchoring (held past its stale line and taken by another writer) — nothing changed; retry (control plane ${controlDir})`);
1094
1128
  }
1095
- if (lstatOrAbsent(join(controlDir, STORE_JOURNAL_FILE)) !== undefined) {
1096
- throw reanchorRefusal(`a committed transaction is still pending recovery at the recorded root — put the store back at ${from ?? "the root it was last opened at"}, open it once so the journal replays, then re-anchor (control plane ${controlDir})`);
1129
+ const obligation = rootBoundObligationOf(controlDir);
1130
+ if (obligation !== undefined) {
1131
+ throw reanchorRefusal(`${obligation.owed} at the recorded root — put the store back at ${from ?? "the root it was last opened at"}, ${obligation.remedy}, then re-anchor (control plane ${controlDir})`);
1097
1132
  }
1098
1133
  let still;
1099
1134
  try {
@@ -1468,75 +1503,190 @@ function readSidecarJson(controlDir, fileName) {
1468
1503
  }
1469
1504
  return undefined;
1470
1505
  }
1506
+ const ANNOUNCEMENTS_FORM = 2;
1507
+ function emptyAnnouncements() {
1508
+ return { scopes: Object.create(null), unscopedDiscarded: 0 };
1509
+ }
1510
+ function wholeCount(v) {
1511
+ return typeof v === "number" && Number.isFinite(v) && v > 0 ? Math.floor(v) : 0;
1512
+ }
1513
+ function coerceAnnouncement(e, scope) {
1514
+ const a = e;
1515
+ if (!a ||
1516
+ typeof a !== "object" ||
1517
+ (a.kind !== "gate" && a.kind !== "external") ||
1518
+ typeof a.at !== "number" ||
1519
+ !Array.isArray(a.items) ||
1520
+ !a.items.every((i) => typeof i === "string") ||
1521
+ a.scope !== scope) {
1522
+ return undefined;
1523
+ }
1524
+ return {
1525
+ kind: a.kind,
1526
+ scope,
1527
+ at: a.at,
1528
+ ...(typeof a.sessionId === "string" ? { sessionId: a.sessionId } : {}),
1529
+ ...(typeof a.reportId === "string" ? { reportId: a.reportId } : {}),
1530
+ items: mintedItems(a.items),
1531
+ };
1532
+ }
1471
1533
  const mintedItems = (items) => items.map((item) => egressText("same-principal", item));
1472
1534
  function coerceAnnouncements(raw) {
1473
- const rec = { folded: 0, queue: [] };
1535
+ const rec = emptyAnnouncements();
1474
1536
  if (!raw || typeof raw !== "object" || Array.isArray(raw))
1475
1537
  return rec;
1476
1538
  const r = raw;
1477
- if (typeof r.folded === "number" && Number.isFinite(r.folded) && r.folded > 0)
1478
- rec.folded = Math.floor(r.folded);
1479
- if (Array.isArray(r.queue)) {
1480
- for (const e of r.queue) {
1481
- const a = e;
1482
- if (a &&
1483
- typeof a === "object" &&
1484
- (a.kind === "gate" || a.kind === "external") &&
1485
- typeof a.at === "number" &&
1486
- Array.isArray(a.items) &&
1487
- a.items.every((i) => typeof i === "string")) {
1488
- rec.queue.push({
1489
- kind: a.kind,
1490
- at: a.at,
1491
- ...(typeof a.sessionId === "string" ? { sessionId: a.sessionId } : {}),
1492
- ...(typeof a.reportId === "string" ? { reportId: a.reportId } : {}),
1493
- items: mintedItems(a.items),
1494
- });
1539
+ if (r.v !== ANNOUNCEMENTS_FORM) {
1540
+ rec.unscopedDiscarded = (Array.isArray(r.queue) ? r.queue.length : 0) + wholeCount(r.folded);
1541
+ return rec;
1542
+ }
1543
+ rec.unscopedDiscarded = wholeCount(r.unscopedDiscarded);
1544
+ if (!r.scopes || typeof r.scopes !== "object" || Array.isArray(r.scopes))
1545
+ return rec;
1546
+ for (const scope of Object.keys(r.scopes)) {
1547
+ const q = r.scopes[scope];
1548
+ if (scope === "" || !q || typeof q !== "object")
1549
+ continue;
1550
+ const queue = [];
1551
+ if (Array.isArray(q.queue)) {
1552
+ for (const e of q.queue) {
1553
+ const a = coerceAnnouncement(e, scope);
1554
+ if (a !== undefined)
1555
+ queue.push(a);
1556
+ else
1557
+ rec.unscopedDiscarded += 1;
1495
1558
  }
1496
1559
  }
1560
+ const folded = wholeCount(q.folded);
1561
+ if (queue.length > 0 || folded > 0)
1562
+ rec.scopes[scope] = { folded, queue };
1497
1563
  }
1498
1564
  return rec;
1499
1565
  }
1566
+ function persistedAnnouncements(rec) {
1567
+ return { v: ANNOUNCEMENTS_FORM, scopes: rec.scopes, ...(rec.unscopedDiscarded > 0 ? { unscopedDiscarded: rec.unscopedDiscarded } : {}) };
1568
+ }
1569
+ function askedScopes(scopes, verb) {
1570
+ if (!Array.isArray(scopes) || !scopes.every((s) => typeof s === "string" && s !== "")) {
1571
+ throw new TypeError(`${verb}: scopes must be an array of non-empty scope keys — the queue is read per scope`);
1572
+ }
1573
+ return [...new Set(scopes)];
1574
+ }
1575
+ function mergeScopeQueues(rec, scopes) {
1576
+ let folded = 0;
1577
+ const lines = [];
1578
+ scopes.forEach((scope, s) => {
1579
+ const q = Object.prototype.hasOwnProperty.call(rec.scopes, scope) ? rec.scopes[scope] : undefined;
1580
+ if (q === undefined)
1581
+ return;
1582
+ folded += q.folded;
1583
+ q.queue.forEach((a, i) => lines.push({ a, s, i }));
1584
+ });
1585
+ lines.sort((x, y) => x.a.at - y.a.at || x.s - y.s || x.i - y.i);
1586
+ return { folded, queue: lines.map((l) => l.a) };
1587
+ }
1500
1588
  export function enqueueMemoryAnnouncement(controlDir, ann, opts) {
1589
+ if (typeof ann.scope !== "string" || ann.scope === "") {
1590
+ throw new TypeError("enqueueMemoryAnnouncement: announcement.scope is required — each notice is filed under the one scope it reports on");
1591
+ }
1592
+ const scope = ann.scope;
1501
1593
  ann = { ...ann, items: mintedItems(ann.items) };
1502
1594
  const family = opts?.supersedesPrefix === undefined ? undefined : egressText("same-principal", opts.supersedesPrefix);
1503
1595
  if (ann.items.length === 0 && family === undefined)
1504
1596
  return;
1505
1597
  lockedJournaledUpdate(controlDir, ANNOUNCEMENTS_FILE, (current) => {
1506
1598
  const rec = coerceAnnouncements(current);
1599
+ const own = Object.prototype.hasOwnProperty.call(rec.scopes, scope) ? rec.scopes[scope] : { folded: 0, queue: [] };
1507
1600
  if (family !== undefined) {
1508
- const queued = rec.queue.flatMap((a) => a.items.filter((i) => i.startsWith(family)));
1601
+ const queued = own.queue.flatMap((a) => a.items.filter((i) => i.startsWith(family)));
1509
1602
  if (queued.length === ann.items.length && ann.items.every((i) => queued.includes(i)))
1510
1603
  return undefined;
1511
- for (const a of rec.queue)
1604
+ for (const a of own.queue)
1512
1605
  a.items = a.items.filter((i) => !i.startsWith(family));
1513
- rec.queue = rec.queue.filter((a) => a.items.length > 0);
1514
- if (ann.items.length === 0)
1515
- return rec;
1606
+ own.queue = own.queue.filter((a) => a.items.length > 0);
1516
1607
  }
1517
- rec.queue.push(ann);
1518
- if (rec.queue.length > MEMORY_ANNOUNCEMENTS_MAX) {
1519
- rec.folded += rec.queue.length - MEMORY_ANNOUNCEMENTS_MAX;
1520
- rec.queue = rec.queue.slice(-MEMORY_ANNOUNCEMENTS_MAX);
1608
+ if (ann.items.length > 0)
1609
+ own.queue.push({ ...ann, scope });
1610
+ if (own.queue.length > MEMORY_ANNOUNCEMENTS_MAX) {
1611
+ own.folded += own.queue.length - MEMORY_ANNOUNCEMENTS_MAX;
1612
+ own.queue = own.queue.slice(-MEMORY_ANNOUNCEMENTS_MAX);
1521
1613
  }
1522
- return rec;
1614
+ if (own.queue.length > 0 || own.folded > 0)
1615
+ rec.scopes[scope] = own;
1616
+ else
1617
+ delete rec.scopes[scope];
1618
+ return persistedAnnouncements(rec);
1523
1619
  });
1524
1620
  }
1525
- export function drainMemoryAnnouncements(controlDir) {
1621
+ export function drainMemoryAnnouncements(controlDir, scopes) {
1622
+ const asked = askedScopes(scopes, "drainMemoryAnnouncements");
1526
1623
  const file = join(controlDir, ANNOUNCEMENTS_FILE);
1527
1624
  if (!existsSync(file) && !existsSync(`${file}.journal`))
1528
- return { folded: 0, queue: [] };
1529
- let drained = { folded: 0, queue: [] };
1625
+ return { folded: 0, queue: [], unscopedDiscarded: 0 };
1626
+ let drained = { folded: 0, queue: [], unscopedDiscarded: 0 };
1530
1627
  lockedJournaledUpdate(controlDir, ANNOUNCEMENTS_FILE, (current) => {
1531
- drained = coerceAnnouncements(current);
1532
- if (drained.queue.length === 0 && drained.folded === 0)
1628
+ const rec = coerceAnnouncements(current);
1629
+ const mine = mergeScopeQueues(rec, asked);
1630
+ drained = { ...mine, unscopedDiscarded: rec.unscopedDiscarded };
1631
+ const otherForm = !current || typeof current !== "object" || current.v !== ANNOUNCEMENTS_FORM;
1632
+ if (mine.queue.length === 0 && mine.folded === 0 && rec.unscopedDiscarded === 0 && !otherForm)
1533
1633
  return undefined;
1534
- return { folded: 0, queue: [] };
1634
+ for (const scope of asked)
1635
+ delete rec.scopes[scope];
1636
+ rec.unscopedDiscarded = 0;
1637
+ return persistedAnnouncements(rec);
1535
1638
  });
1536
1639
  return drained;
1537
1640
  }
1538
- export function peekMemoryAnnouncements(controlDir) {
1539
- return coerceAnnouncements(readSidecarJson(controlDir, ANNOUNCEMENTS_FILE));
1641
+ export function peekMemoryAnnouncements(controlDir, scopes) {
1642
+ const asked = askedScopes(scopes, "peekMemoryAnnouncements");
1643
+ const rec = coerceAnnouncements(readSidecarJson(controlDir, ANNOUNCEMENTS_FILE));
1644
+ return { ...mergeScopeQueues(rec, asked), unscopedDiscarded: rec.unscopedDiscarded };
1645
+ }
1646
+ export function transferMemoryAnnouncements(fromControlDir, toControlDir) {
1647
+ const file = join(fromControlDir, ANNOUNCEMENTS_FILE);
1648
+ if (!existsSync(file) && !existsSync(`${file}.journal`))
1649
+ return;
1650
+ const taken = coerceAnnouncements(readSidecarJson(fromControlDir, ANNOUNCEMENTS_FILE));
1651
+ const carried = Object.keys(taken.scopes).flatMap((scope) => taken.scopes[scope].queue);
1652
+ carried.sort((x, y) => x.at - y.at);
1653
+ for (const ann of carried)
1654
+ enqueueMemoryAnnouncement(toControlDir, ann);
1655
+ const extraFolded = Object.keys(taken.scopes).map((scope) => ({ scope, folded: taken.scopes[scope].folded })).filter((x) => x.folded > 0);
1656
+ if (extraFolded.length > 0 || taken.unscopedDiscarded > 0) {
1657
+ lockedJournaledUpdate(toControlDir, ANNOUNCEMENTS_FILE, (current) => {
1658
+ const rec = coerceAnnouncements(current);
1659
+ for (const { scope, folded } of extraFolded) {
1660
+ const own = Object.prototype.hasOwnProperty.call(rec.scopes, scope) ? rec.scopes[scope] : { folded: 0, queue: [] };
1661
+ own.folded += folded;
1662
+ rec.scopes[scope] = own;
1663
+ }
1664
+ rec.unscopedDiscarded += taken.unscopedDiscarded;
1665
+ return persistedAnnouncements(rec);
1666
+ });
1667
+ }
1668
+ const moved = new Map();
1669
+ for (const ann of carried)
1670
+ moved.set(JSON.stringify(ann), (moved.get(JSON.stringify(ann)) ?? 0) + 1);
1671
+ lockedJournaledUpdate(fromControlDir, ANNOUNCEMENTS_FILE, (current) => {
1672
+ const rec = coerceAnnouncements(current);
1673
+ for (const scope of Object.keys(rec.scopes)) {
1674
+ const own = rec.scopes[scope];
1675
+ own.queue = own.queue.filter((a) => {
1676
+ const key = JSON.stringify(a);
1677
+ const n = moved.get(key) ?? 0;
1678
+ if (n === 0)
1679
+ return true;
1680
+ moved.set(key, n - 1);
1681
+ return false;
1682
+ });
1683
+ own.folded = Math.max(0, own.folded - (taken.scopes[scope]?.folded ?? 0));
1684
+ if (own.queue.length === 0 && own.folded === 0)
1685
+ delete rec.scopes[scope];
1686
+ }
1687
+ rec.unscopedDiscarded = Math.max(0, rec.unscopedDiscarded - taken.unscopedDiscarded);
1688
+ return persistedAnnouncements(rec);
1689
+ });
1540
1690
  }
1541
1691
  export function scanFuseKey(scope, rel) {
1542
1692
  return JSON.stringify([scope, rel.split(sep).join("/")]);
@@ -22,7 +22,7 @@ export interface MemoryBackendContractHooks {
22
22
  * assembly answers it as capability-absent.
23
23
  */
24
24
  onOptionalMember?: (report: {
25
- member: "committedSnapshotOf" | "committedSnapshotsOfScopes" | "custodyOf" | "eraseWithEvidence" | "exportSnapshotOf" | "governanceExport" | "custodyImport" | "importBundleCommit";
25
+ member: "committedSnapshotOf" | "committedSnapshotsOfScopes" | "custodyOf" | "eraseWithEvidence" | "judgesErasureScopes" | "exportSnapshotOf" | "governanceExport" | "custodyImport" | "importBundleCommit";
26
26
  status: "verified" | "absent";
27
27
  }) => void;
28
28
  }
@@ -728,10 +728,16 @@ export async function memoryBackendContract(hooks) {
728
728
  return;
729
729
  }
730
730
  const erase = seat;
731
- const e = entry("id-erase-0001", "s1", "erasable", "erasable body", { name: "Erasable" });
731
+ const e = entry("id-erase-0001", "s1", "erasable-slugword", "erasable body", { name: "Erasable" });
732
732
  await b.applyPatches([{ op: "add", id: e.id, entry: e }]);
733
733
  const att = await erase.call(b, { requestId: "req-contract-1", select: { ids: [e.id, "id-ghost-8888"] } });
734
- assert.strictEqual(att.v, 1, "the attestation rides the v:1 envelope");
734
+ assert.strictEqual(att.v, 2, "the attestation rides the v:2 envelope");
735
+ for (const cls of ["projection", "shadow", "indexLine", "quarantineCopy", "planArchive", "planWorkbook", "evidenceBinding", "backendDerived"]) {
736
+ const answer = att.residuals.carriers[cls];
737
+ assert.ok(answer !== undefined && (answer.unverified === true || (typeof answer.removed === "number" && typeof answer.remaining === "number")), `carrier class ${cls} is answered (removed/remaining counts, or unverified)`);
738
+ }
739
+ assert.strictEqual(att.residuals.replay, "converges", "an evidence face's replay converges (no time limit)");
740
+ assert.ok(!JSON.stringify(att).includes("slugword") && !JSON.stringify(att).includes("erasable body"), "the attestation names no slug and no entry text");
735
741
  assert.strictEqual(att.evidenceCapability, "journal", "a face-claiming backend answers the evidenced capability");
736
742
  assert.deepStrictEqual(att.erased.map((r) => r.id), [e.id], "the existing id is erased");
737
743
  assert.ok(typeof att.erased[0]?.evidenceEv === "string" && att.erased[0].evidenceEv.length > 0, "an evidenced erase names its evidence row");
@@ -743,6 +749,37 @@ export async function memoryBackendContract(hooks) {
743
749
  await assert.rejects(async () => erase.call(b, { requestId: "req-contract-1", select: { ids: ["id-other-7777"] } }), (err) => err.code === "memory.erasure_selector_mismatch", "a reused requestId with a different selector refuses loudly");
744
750
  hooks.onOptionalMember?.({ member: "eraseWithEvidence", status: "verified" });
745
751
  });
752
+ defer("design/1068 S1a optional erasure authorization seat: post-resolution judgment, whole-request refusal, replay bound to its set (undeclared ⇒ reported)", async () => {
753
+ const b = await hooks.make();
754
+ const seat = b.eraseWithEvidence;
755
+ const declared = b.judgesErasureScopes;
756
+ assert.ok(declared === undefined || declared === true, "judgesErasureScopes must be absent or the literal true — any other occupant is a defect, not absence");
757
+ assert.ok(declared !== true || typeof seat === "function", "a backend declaring judgesErasureScopes must offer eraseWithEvidence");
758
+ if (declared !== true) {
759
+ hooks.onOptionalMember?.({ member: "judgesErasureScopes", status: "absent" });
760
+ return;
761
+ }
762
+ const erase = seat;
763
+ const mine = entry("id-grant-mine-0001", "tenant-mine", "mine", "mine body", { name: "Mine" });
764
+ const theirs = entry("id-grant-theirs-0001", "tenant-theirs", "theirs", "theirs body", { name: "Theirs" });
765
+ await b.applyPatches([
766
+ { op: "add", id: mine.id, entry: mine },
767
+ { op: "add", id: theirs.id, entry: theirs },
768
+ ]);
769
+ const refusedBySeat = (err) => err.code === "config.memory_erasure_scope";
770
+ await assert.rejects(async () => erase.call(b, { requestId: "req-grant-1", select: { ids: [mine.id, theirs.id] }, expectedScopes: ["tenant-mine"] }), refusedBySeat, "an id resolving outside the set refuses the WHOLE request");
771
+ await assert.rejects(async () => erase.call(b, { requestId: "req-grant-2", select: { ids: [mine.id, "id-grant-ghost-0001"] }, expectedScopes: ["tenant-mine"] }), refusedBySeat, "an id the store cannot attribute to a scope is not a member — refused the same way");
772
+ await assert.rejects(async () => erase.call(b, { requestId: "req-grant-3", select: { scope: "tenant-empty" }, expectedScopes: ["tenant-mine"] }), refusedBySeat, "a place selector naming a scope outside the set refuses — even when that scope resolves to nothing");
773
+ assert.deepStrictEqual((await b.getByIds([mine.id, theirs.id])).map((e) => e.id).sort(), [mine.id, theirs.id].sort(), "refused requests erase nothing");
774
+ const att = await erase.call(b, { requestId: "req-grant-4", select: { ids: [mine.id] }, expectedScopes: ["tenant-mine", "tenant-mine"] });
775
+ assert.deepStrictEqual(att.erased.map((r) => r.id), [mine.id], "inside the set the request erases");
776
+ const replay = await erase.call(b, { requestId: "req-grant-4", select: { ids: [mine.id] }, expectedScopes: ["tenant-mine"] });
777
+ assert.deepStrictEqual((replay.erasedPreviously ?? []).map((r) => r.id), [mine.id], "a replay under the same set (another spelling) converges — judged against the first resolution, not the live account");
778
+ await assert.rejects(async () => erase.call(b, { requestId: "req-grant-4", select: { ids: [mine.id] }, expectedScopes: ["tenant-mine", "tenant-theirs"] }), (err) => err.code === "config.memory_erasure_scope", "a replay under another set refuses");
779
+ await assert.rejects(async () => erase.call(b, { requestId: "req-grant-4", select: { ids: [mine.id] } }), (err) => err.code === "config.memory_erasure_scope", "a replay with no set refuses (absent and present are different authorizations)");
780
+ assert.deepStrictEqual((await b.getByIds([theirs.id])).map((e) => e.id), [theirs.id], "the other scope's entry survives every call");
781
+ hooks.onOptionalMember?.({ member: "judgesErasureScopes", status: "verified" });
782
+ });
746
783
  defer("design/178 v2-c optional export/import faces: export composite / governance slice / custody carriage (absent ⇒ reported)", async () => {
747
784
  const b = await hooks.make();
748
785
  const seats = [
@@ -64,7 +64,16 @@ export declare function isPersonalScope(parsed: ParsedScopeKey): boolean;
64
64
  /** True when the key's AUTHORITY is central (design/142 §2 表: user/userproj/org rows) — these keys
65
65
  * must never project into an in-repo memory dir (they would leak to every collaborator AND enter
66
66
  * commit history; extended the F9 gate from personal to org). `proj:`/legacy stay
67
- * repo-planed. */
67
+ * repo-planed.
68
+ *
69
+ * @contract memory.identity_absence.opaque_key — the memory of an owner with no identity is keyed by an opaque,
70
+ * unprefixed key the deployment chooses (such as `local`) and never by a sentinel principal: no `user:` key stands for
71
+ * identity absence (a `user:local` key is the key of a principal named `local`), so this function answers `false`
72
+ * for that layer — its authority is not central. The engine mints no key for identity absence. Read as an
73
+ * owner, it is the `local-owner` arm of `RuleOwner` (core/rule-owner.ts), not a principal. A principal's memory is
74
+ * keyed by that principal's keys (`user:<P>` and the principal's project layers); moving this layer to a principal
75
+ * is a re-keying of its entries (`migrateScope`), and the engine never reads the opaque name as a principal.
76
+ * Admission authorizes by the caller's principal (`MemoryScopeAdmissionInput`), never by a layer's owner. */
68
77
  export declare function isCentralAuthorityScope(parsed: ParsedScopeKey): boolean;
69
78
  /**
70
79
  * design/142 §7 S1 hard gate (复审 F9): until S1b per-scope physical roots land, ALL scopes of a
@@ -105,8 +114,9 @@ export type ProjectMarkerFs = Pick<ExecutionEnv, "exists" | "readTextFile">;
105
114
  * other failure is an error, never an absence. Read synchronously, as the memory phase always read the marker: a leg
106
115
  * with no I/O of its own gains no event-loop turn from its project read (its scheduling against sibling legs stays). */
107
116
  export declare const hostProjectMarkerFs: ProjectMarkerFs;
108
- /** The filesystem a leg's task root names: its execution env, or the host's when the env is the no-I/O placeholder (a leg
109
- * with no env, or one handed none — the hands band's own "is there a filesystem" reading). */
117
+ /** The filesystem a leg's task root names: its execution env — its read limits included — or the host's only when the env
118
+ * declares it is the no-I/O placeholder (`performsIo` is `false`: a leg with no env, or one handed none). An undeclared env
119
+ * is read through, never past. */
110
120
  export declare function projectMarkerFsOf(env: ExecutionEnv): ProjectMarkerFs;
111
121
  /**
112
122
  * design/142 §1.1 — resolve a project's identity. READS ONLY THE MARKER (复审 F2: never derives an
@@ -1,7 +1,7 @@
1
1
  import { lstatSync, readFileSync } from "node:fs";
2
2
  import { dirname, join, resolve } from "node:path";
3
3
  import { err, FileError, ok } from "../../internal/harness.js";
4
- import { StubExecutionEnv } from "../stub-env.js";
4
+ import { performsIo } from "../remote-env.js";
5
5
  import { thrownText } from "../thrown-value.js";
6
6
  import { canonicalize } from "./layout.js";
7
7
  function pathSegmentsDualFamily(p) {
@@ -201,7 +201,7 @@ export const hostProjectMarkerFs = {
201
201
  },
202
202
  };
203
203
  export function projectMarkerFsOf(env) {
204
- return env instanceof StubExecutionEnv ? hostProjectMarkerFs : env;
204
+ return performsIo(env) === false ? hostProjectMarkerFs : env;
205
205
  }
206
206
  function identityError(code, message) {
207
207
  const e = new Error(message);