@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -54,7 +54,7 @@ export interface MailboxCrossProcessContractHooks {
54
54
  /**
55
55
  * T2 可选能力层(cross-process 分册,design/385 §1.2⑥ / G11)—— 声明 `crossProcessSafe: true` 的后端必须
56
56
  * 过的全套判据。钉的是**整套**(跨进程 seq 单铸 + lease/ack 不交叉 + 一方的 housekeeping 不丢另一方的
57
- * 已落盘 append + reap/drop 的 seq 语义跨进程成立),不是「有锁」:一把锁配一份陈旧缓存照样在锁内铸
57
+ * 已落盘 append + reap/drop 的 seq 语义跨进程成立 + 已收窗跨进程共享),不是「有锁」:一把锁配一份陈旧缓存照样在锁内铸
58
58
  * 重号、照样把别人的消息压缩掉——所以每一条都从**对方进程的视角**回读。
59
59
  *
60
60
  * 受众:文件后端(本仓捆绑)、SQL 后端(事务天然过)。进程内 Map 的参照实现与 CC inbox 适配器不声明,
@@ -63,11 +63,18 @@ export interface MailboxCrossProcessContractHooks {
63
63
  */
64
64
  export declare function mailboxCrossProcessContract(hooks: MailboxCrossProcessContractHooks): Promise<void>;
65
65
  export interface MailboxTombstonedRecipientContractHooks {
66
- /** Put `(scope, handle)` into the deployment's PRE-DELETE state — whatever that is for this
67
- * backend (a cascade marking the session row, a `deleting` column, a tombstone table). Core does
68
- * not name the mechanism, only what `append` must then do. */
69
- tombstone: (store: MailboxStore, scope: string, handle: string) => Promise<void>;
66
+ /** Put `(scope, handle)` into the deployment's PRE-DELETE state, for a backend that keeps the state
67
+ * outside the store face (a cascade marking the session row, a `deleting` column). A store that
68
+ * carries the recipient-lifecycle pair (`retireRecipient` / `listRetiredRecipients`) is retired
69
+ * through its own `retireRecipient` instead, and then this hook is refused: two ways to write one
70
+ * state are two readings of it. */
71
+ tombstone?: (store: MailboxStore, scope: string, handle: string) => Promise<void>;
70
72
  runAssertion?: ContractAssertionRunner;
73
+ /** The observable channel for the optional pair: a case name cannot carry "verified" vs "absent". */
74
+ onOptionalMember?: (report: {
75
+ member: "recipientLifecycle";
76
+ status: "verified" | "absent";
77
+ }) => void;
71
78
  }
72
79
  /**
73
80
  * T2 可选能力层(pre-delete 分册)—— 只挂**看得见收件人生命周期**的后端:它的 mailbox 行与某个
@@ -1,6 +1,7 @@
1
1
  import { strict as assert } from "node:assert";
2
- import { MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_INVALID_PEER_META_CODE, MAILBOX_INVALID_DECISION_MOVE_CODE, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_TOMBSTONED_RECIPIENT_CODE } from "../mailbox-store.js";
2
+ import { MAILBOX_CONSUMED_ID_WINDOW, MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_INVALID_PEER_META_CODE, MAILBOX_INVALID_DECISION_MOVE_CODE, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_TOMBSTONED_RECIPIENT_CODE, mailboxRecipientLifecycleOf } from "../mailbox-store.js";
3
3
  import { beginContract } from "./contract-harness.js";
4
+ import { thrownText } from "../thrown-value.js";
4
5
  import { PRINCIPAL_INBOX_HANDLE } from "../../agents/cross-session-ref.js";
5
6
  import { mintCrossPrincipalRecord } from "../../agents/org-delivery-gate.js";
6
7
  export const MAILBOX_CONTRACT_SCOPE = "default";
@@ -50,7 +51,7 @@ export async function mailboxStoreContract(mk, runAssertion) {
50
51
  await s.ack(S, "a1", "w3", 1);
51
52
  assert.equal(await s.append(S, "a1", msg("m2")), 2);
52
53
  });
53
- run("记录身份:箱持有同 id 时 append = 同记录回原 seq 零写 / 异记录点名拒;坏 id 零副作用拒;id 往返;ack 后 id 自由", async (make) => {
54
+ run("记录身份:箱持有同 id 时 append = 同记录回原 seq 零写 / 异记录点名拒;坏 id 零副作用拒;id 往返;ack 后进已收窗", async (make) => {
54
55
  const s = make();
55
56
  const codeOf = async (p) => {
56
57
  try {
@@ -78,7 +79,89 @@ export async function mailboxStoreContract(mk, runAssertion) {
78
79
  const lease = await s.claimLease(S, "a1", "w1", 60_000, 10_000);
79
80
  assert.deepEqual(lease.messages.map((m) => m.id), ["frame-1", undefined], "id 往返,缺席仍缺席");
80
81
  await s.ack(S, "a1", "w1", lease.maxSeq);
81
- assert.equal(await s.append(S, "a1", rec), 3, "箱只为它持有的记录作答:ack 后同 id 是新记录");
82
+ assert.equal(await s.append(S, "a1", rec), 1, "箱为它收过的记录作答:ack 后同记录在已收窗内,回原 seq");
83
+ assert.equal(await s.peekCount(S, "a1"), 0, "窗内重放零写");
84
+ });
85
+ const K = MAILBOX_CONSUMED_ID_WINDOW;
86
+ const rec = (id, content = `body-${id}`) => ({ id, from: "w", content, sentAt: 1_000, hopChain: ["h"], peerMeta: { kind: "peer_message", fromRoot: "root" } });
87
+ const consume = async (s, handle, owner) => {
88
+ const l = await s.claimLease(S, handle, owner, 60_000, 10_000);
89
+ assert.notEqual(l, null);
90
+ assert.deepEqual(await s.ack(S, handle, owner, l.maxSeq), { acked: true });
91
+ };
92
+ const codeAndMessage = async (p) => {
93
+ try {
94
+ await p;
95
+ return {};
96
+ }
97
+ catch (e) {
98
+ return { code: e.code, message: thrownText(e) };
99
+ }
100
+ };
101
+ run("W1 窗内同记录:append(X) → claim → ack → 同面 append(X) ⇒ 首个 seq,零写,再 claim = null", async (make) => {
102
+ const s = make();
103
+ assert.equal(await s.append(S, "a1", rec("X")), 1);
104
+ await consume(s, "a1", "w1");
105
+ assert.equal(await s.append(S, "a1", { ...rec("X"), sentAt: 9_000 }), 1, "写入时刻不同仍是同一条(sentAt 不是面)");
106
+ assert.equal(await s.peekCount(S, "a1"), 0);
107
+ assert.equal(await s.claimLease(S, "a1", "w2", 60_000, 20_000), null);
108
+ });
109
+ run("W2 窗内异记录:同 id 换内容 ⇒ mailbox.duplicate_record_id,拒句点名 content,零写", async (make) => {
110
+ const s = make();
111
+ await s.append(S, "a1", rec("X"));
112
+ await consume(s, "a1", "w1");
113
+ const refused = await codeAndMessage(s.append(S, "a1", rec("X", "another body")));
114
+ assert.equal(refused.code, MAILBOX_DUPLICATE_RECORD_ID_CODE);
115
+ assert.match(refused.message ?? "", /content/);
116
+ assert.equal(await s.peekCount(S, "a1"), 0);
117
+ });
118
+ run("W3 窗外:X 收后再收 K 条带 id 记录 ⇒ append(X) = 高水位 + 1,箱里一条", async (make) => {
119
+ const s = make();
120
+ await s.append(S, "a1", rec("X"));
121
+ await consume(s, "a1", "w1");
122
+ for (let i = 0; i < K; i++)
123
+ await s.append(S, "a1", rec(`Y${i}`));
124
+ await consume(s, "a1", "w2");
125
+ assert.equal(await s.append(S, "a1", rec("X")), K + 2, "出窗的 id 是新记录");
126
+ assert.equal(await s.peekCount(S, "a1"), 1);
127
+ });
128
+ run("W4 窗只算带 id:X 收后再收 K 条无 id 记录 ⇒ append(X) 仍回首个 seq", async (make) => {
129
+ const s = make();
130
+ await s.append(S, "a1", rec("X"));
131
+ await consume(s, "a1", "w1");
132
+ for (let i = 0; i < K; i++)
133
+ await s.append(S, "a1", msg(`plain-${i}`));
134
+ await consume(s, "a1", "w2");
135
+ assert.equal(await s.append(S, "a1", rec("X")), 1);
136
+ assert.equal(await s.peekCount(S, "a1"), 0);
137
+ });
138
+ run("W5 寿命:drop 清窗(seq 从 1 重来);reap 留窗,且 reap 清掉的未投记录不进窗", async (make) => {
139
+ const s = make();
140
+ await s.append(S, "a1", rec("X"));
141
+ await consume(s, "a1", "w1");
142
+ await s.drop(S, "a1");
143
+ assert.equal(await s.append(S, "a1", rec("X")), 1, "drop 结束箱的一生:窗随之清,X 是新记录(seq 1)");
144
+ assert.equal(await s.peekCount(S, "a1"), 1);
145
+ const r = make();
146
+ await r.append(S, "b1", rec("X"));
147
+ await consume(r, "b1", "w1");
148
+ await r.append(S, "b1", rec("Z"));
149
+ assert.equal(await r.reap(S, 100_000, { maxAgeMs: 50_000 }), 1);
150
+ assert.equal(await r.append(S, "b1", rec("X")), 1, "reap 留窗:X 仍在窗内");
151
+ assert.equal(await r.append(S, "b1", rec("Z")), 3, "reap 清掉的 Z 从没被收过:新记录,高水位之后");
152
+ });
153
+ run("W8 窗序:第 K + 1 条更新的带 id 记录被收的那一刻最旧那条出窗(分两批 ack)", async (make) => {
154
+ const s = make();
155
+ await s.append(S, "a1", rec("X"));
156
+ await consume(s, "a1", "w1");
157
+ for (let i = 0; i < K - 1; i++)
158
+ await s.append(S, "a1", rec(`Y${i}`));
159
+ await consume(s, "a1", "w2");
160
+ assert.equal(await s.append(S, "a1", rec("X")), 1, "窗里恰 K 条,X 是最旧的一条,仍在");
161
+ await s.append(S, "a1", rec("Y-last"));
162
+ await consume(s, "a1", "w3");
163
+ assert.equal(await s.append(S, "a1", rec("Y0")), 2, "次旧的那条仍在窗内");
164
+ assert.equal(await s.append(S, "a1", rec("X")), K + 2, "第 K + 1 条进窗,X 出窗:新记录");
82
165
  });
83
166
  run("lease 窗内 append:后到消息在下次 claim 时可见(lease 只覆盖 claim 时刻快照)", async (make) => {
84
167
  const s = make();
@@ -427,6 +510,22 @@ export async function mailboxCrossProcessContract(hooks) {
427
510
  assert.equal(await peer.peekCount(S, H), 0);
428
511
  assert.equal(await peer.append(S, H, msg("after", 200_000)), 3, "高水位跨 reap 存活(对方视角)");
429
512
  });
513
+ run("W7 已收窗跨进程:一方 append + ack 带 id 的 X,另一方同记录 append(X) ⇒ 首个 seq 零写;异记录 ⇒ 带码拒", async (local, peer) => {
514
+ const x = { id: "frame-x", from: "w", content: "status", sentAt: 1_000, hopChain: ["h"], peerMeta: { kind: "peer_message", fromRoot: "root" } };
515
+ assert.equal(await local.append(S, H, x), 1);
516
+ const held = await local.claimLease(S, H, "cycle-local", 60_000, 10_000);
517
+ assert.deepEqual(await local.ack(S, H, "cycle-local", held.maxSeq), { acked: true });
518
+ assert.equal(await peer.append(S, H, { ...x, sentAt: 5_000 }), 1, "对方进程看得见本方收进窗的记录:同记录回首个 seq");
519
+ assert.equal(await peer.peekCount(S, H), 0, "零写");
520
+ let code;
521
+ try {
522
+ await peer.append(S, H, { ...x, content: "another" });
523
+ }
524
+ catch (e) {
525
+ code = e.code;
526
+ }
527
+ assert.equal(code, MAILBOX_DUPLICATE_RECORD_ID_CODE);
528
+ });
430
529
  run("reap 与 drop 的 seq 语义跨进程:一方 reap 后另一方继续高水位;一方 drop 后另一方从 1 重铸", async (local, peer) => {
431
530
  await peer.append(S, H, msg("old", 1_000));
432
531
  assert.equal(await local.reap(S, 100_000, { maxAgeMs: 50_000 }), 1, "本方 reap 必须看见对方写的旧消息");
@@ -444,9 +543,57 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
444
543
  const run = (name, fn) => runRaw(name, () => withStores(mk, fn));
445
544
  const S = MAILBOX_CONTRACT_SCOPE;
446
545
  const codeOf = (e) => e?.code;
546
+ const tombstone = async (s, scope, handle) => {
547
+ const pair = mailboxRecipientLifecycleOf(s);
548
+ if (pair === undefined) {
549
+ assert.notEqual(hooks.tombstone, undefined, "nothing puts a recipient into the pre-delete state: the store carries no retireRecipient and no tombstone hook was given");
550
+ return hooks.tombstone(s, scope, handle);
551
+ }
552
+ assert.equal(await pair.retireRecipient(scope, handle, 1_000_000, "label"), true, "retireRecipient answers true when it wrote the tombstone");
553
+ };
554
+ run("收件人生命周期一对成员是一项能力:要么都在、要么都缺;都在时不再另收 tombstone 钩子(同一个态不许两种写法)", async (make) => {
555
+ let carriesPair = false;
556
+ try {
557
+ carriesPair = mailboxRecipientLifecycleOf(make()) !== undefined;
558
+ }
559
+ catch (e) {
560
+ assert.fail(`the store's recipient-lifecycle pair cannot be read: ${thrownText(e)}`);
561
+ }
562
+ assert.equal(carriesPair && hooks.tombstone !== undefined, false, "the store writes its own pre-delete state (retireRecipient), so a tombstone hook is a second way to write it");
563
+ assert.equal(carriesPair || hooks.tombstone !== undefined, true, "nothing puts a recipient into the pre-delete state: no retireRecipient on the store and no tombstone hook");
564
+ });
565
+ run("收件人生命周期一对(可选成员):在则逐条验 —— 只打标、列表、重写、随箱亡;缺席如实上报,不算失败", async (make) => {
566
+ const pair = mailboxRecipientLifecycleOf(make());
567
+ if (pair === undefined) {
568
+ hooks.onOptionalMember?.({ member: "recipientLifecycle", status: "absent" });
569
+ return;
570
+ }
571
+ const listed = make();
572
+ const lp = mailboxRecipientLifecycleOf(listed);
573
+ assert.equal(await lp.retireRecipient(S, "session.a1", 5_000, "Plan"), true, "retireRecipient answers true when it wrote the tombstone");
574
+ await lp.retireRecipient(S, "agent.b1", 6_000);
575
+ await lp.retireRecipient("tenant-b", "session.c1", 7_000);
576
+ assert.deepEqual(await lp.listRetiredRecipients(S, "session."), [{ handle: "session.a1", retiredAt: 5_000, label: "Plan" }], "清单按 (scope, 前缀) 列出 handle / retiredAt / label");
577
+ assert.deepEqual(await lp.listRetiredRecipients(S, "agent."), [{ handle: "agent.b1", retiredAt: 6_000 }], "清单按 (scope, 前缀):no label ⇒ no label member");
578
+ assert.deepEqual(await lp.listRetiredRecipients("tenant-b", "agent."), [], "清单按 (scope, 前缀):a prefix lists only its own handles, in its own scope");
579
+ const again = make();
580
+ const ap = mailboxRecipientLifecycleOf(again);
581
+ await ap.retireRecipient(S, "session.a1", 5_000, "old");
582
+ await ap.retireRecipient(S, "session.a1", 9_000, "new");
583
+ assert.deepEqual(await ap.listRetiredRecipients(S, "session."), [{ handle: "session.a1", retiredAt: 9_000, label: "new" }], "重复 retire 更新时刻与名字,清单里仍是一行");
584
+ const dropped = make();
585
+ const dp = mailboxRecipientLifecycleOf(dropped);
586
+ await dropped.append(S, "session.a1", msg("before"));
587
+ await dp.retireRecipient(S, "session.a1", 5_000);
588
+ await assert.rejects(dropped.append(S, "session.a1", msg("refused")), (e) => codeOf(e) === MAILBOX_TOMBSTONED_RECIPIENT_CODE);
589
+ await dropped.drop(S, "session.a1");
590
+ assert.deepEqual(await dp.listRetiredRecipients(S, "session."), [], "墓碑随箱亡:drop removes the tombstone with the box");
591
+ assert.equal(await dropped.append(S, "session.a1", msg("registered again")), 1, "墓碑随箱亡:an id registered again is a new recipient (seq 1)");
592
+ hooks.onOptionalMember?.({ member: "recipientLifecycle", status: "verified" });
593
+ });
447
594
  run("预删除态的收件人:append 响亮拒且带码(既不静默收下级联即将删掉的消息,也不裸抛)", async (make) => {
448
595
  const s = make();
449
- await hooks.tombstone(s, S, "a1");
596
+ await tombstone(s, S, "a1");
450
597
  let thrown;
451
598
  try {
452
599
  await s.append(S, "a1", msg("m1"));
@@ -467,19 +614,19 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
467
614
  });
468
615
  run("拒的粒度是收件人,不是开关:同 scope 下另一个活收件人照常收信", async (make) => {
469
616
  const s = make();
470
- await hooks.tombstone(s, S, "a1");
617
+ await tombstone(s, S, "a1");
471
618
  assert.equal(await s.append(S, "a2", msg("still-live")), 1, "活收件人不受邻居的删除级联牵连");
472
619
  assert.equal(await s.peekCount(S, "a2"), 1);
473
620
  });
474
621
  run("收件人身份是 (scope, handle) 整体:A 租户的删除级联不得拒掉 B 租户的同名收件人", async (make) => {
475
622
  const s = make();
476
- await hooks.tombstone(s, "tenant-a", "a1");
623
+ await tombstone(s, "tenant-a", "a1");
477
624
  assert.equal(await s.append("tenant-b", "a1", msg("other-tenant")), 1, "同名 handle 在另一个租户下是另一个收件人");
478
625
  assert.equal(await s.peekCount("tenant-b", "a1"), 1);
479
626
  });
480
627
  run("两件套还得是单射的:把 (scope, handle) 拼成一个字符串记态,不得让两个不同收件人撞成一个", async (make) => {
481
628
  const s = make();
482
- await hooks.tombstone(s, "tenant a", "b");
629
+ await tombstone(s, "tenant a", "b");
483
630
  assert.equal(await s.append("tenant", "a b", msg("distinct-recipient")), 1, "拼键歧义不得把另一个收件人一起拒掉");
484
631
  assert.equal(await s.peekCount("tenant", "a b"), 1);
485
632
  });
@@ -488,7 +635,7 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
488
635
  await s.append(S, "a1", msg("in-flight"));
489
636
  const held = await s.claimLease(S, "a1", "consumer-A", 60_000, 10_000);
490
637
  assert.equal(held?.messages.length, 1);
491
- await hooks.tombstone(s, S, "a1");
638
+ await tombstone(s, S, "a1");
492
639
  await assert.rejects(s.append(S, "a1", msg("after-tombstone", 2_000)), "预删除态下的 append 必须拒");
493
640
  assert.equal(await s.claimLease(S, "a1", "rival", 60_000, 11_000), null, "A 的活租约必须仍然 fence 住别人");
494
641
  await s.ack(S, "a1", "consumer-A", held.maxSeq);
@@ -497,7 +644,7 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
497
644
  run("拒的是入口,不是清仓:被拒的 append 零副作用,已入箱的消息按原 seq/内容原封不动", async (make) => {
498
645
  const s = make();
499
646
  const seq = await s.append(S, "a1", msg("parked-before"));
500
- await hooks.tombstone(s, S, "a1");
647
+ await tombstone(s, S, "a1");
501
648
  let thrown;
502
649
  let refused = false;
503
650
  try {
@@ -20,6 +20,6 @@ import { type ContractAssertionRunner } from "./contract-harness.js";
20
20
  * exactly the divergence the two legs above exist to prevent.
21
21
  */
22
22
  export declare function toolResultStoreContract(make: () => ToolResultStore, runAssertion?: ContractAssertionRunner, onOptionalMember?: (report: {
23
- member: "deleteBySession";
23
+ member: "deleteBySession" | "listBySession" | "reap";
24
24
  status: "verified" | "absent";
25
25
  }) => void): Promise<void>;
@@ -80,5 +80,72 @@ export async function toolResultStoreContract(make, runAssertion, onOptionalMemb
80
80
  assert.equal((await store.get("tr_sweep~other")).content, "OTHER-bytes");
81
81
  onOptionalMember?.({ member: "deleteBySession", status: "verified" });
82
82
  });
83
+ run("listBySession (optional): the sweep's selection, read-only; absence is REPORTED, not silently green", async () => {
84
+ const probe = make();
85
+ if (probe.listBySession === undefined) {
86
+ onOptionalMember?.({ member: "listBySession", status: "absent" });
87
+ return;
88
+ }
89
+ assert.equal(typeof probe.listBySession, "function", `listBySession is present but not callable (got ${typeof probe.listBySession}) — a garbage member is a DEFECT, not an optional-member absence`);
90
+ const store = make();
91
+ const list = async (sessionId) => Promise.resolve(store.listBySession(sessionId));
92
+ const refsOf = (l) => l.entries.map((e) => e.ref).sort();
93
+ await store.put("tr_list~a", "A-bytes", { sessionId: "sess-L", taskId: "t1" });
94
+ await store.put("tr_list~b", "B-bytes", { sessionId: "sess-L" });
95
+ await store.put("tr_list~other", "OTHER-bytes", { sessionId: "sess-M" });
96
+ await store.put("tr_list~unowned", "UNOWNED-bytes");
97
+ const first = await list("sess-L");
98
+ assert.deepEqual(refsOf(first), ["tr_list~a", "tr_list~b"], "the session's rows, and only those, are listed");
99
+ const byRef = new Map(first.entries.map((e) => [e.ref, e.provenance]));
100
+ assert.deepEqual(byRef.get("tr_list~a"), { sessionId: "sess-L", taskId: "t1" }, "the recorded owner rides the entry, taskId included");
101
+ assert.deepEqual(byRef.get("tr_list~b"), { sessionId: "sess-L" }, "a session-only owner carries no taskId");
102
+ assert.equal(first.unaddressable, 0, "every row here was written by this store: none is unaddressable (the count is for rows written before the ref was recorded, never a second kind)");
103
+ assert.equal((await store.get("tr_list~a")).content, "A-bytes");
104
+ assert.deepEqual(await store.ownerOf("tr_list~a"), byRef.get("tr_list~a"), "the listed owner is the one ownerOf answers");
105
+ assert.equal(refsOf(first).includes("tr_list~other"), false, "another session's row is not listed");
106
+ assert.equal(refsOf(first).includes("tr_list~unowned"), false, "an unowned row is never listed");
107
+ assert.equal(first.unattributable >= 1, true, "an unowned row is counted unattributable");
108
+ const none = await list("sess-nobody");
109
+ assert.deepEqual(none.entries, [], "a session with no entries lists none");
110
+ assert.deepEqual(refsOf(await list("sess-L")), refsOf(first), "listing deletes and changes nothing");
111
+ assert.equal((await store.get("tr_list~b")).content, "B-bytes", "a listing leaves the bytes where they were");
112
+ if (store.deleteBySession !== undefined) {
113
+ const swept = await Promise.resolve(store.deleteBySession("sess-L"));
114
+ assert.equal(swept.deleted, first.entries.length + first.unaddressable, "the sweep deletes exactly the listed rows and the ones the listing counted but could not name");
115
+ assert.deepEqual((await list("sess-L")).entries, [], "a swept session lists nothing");
116
+ assert.equal((await store.get("tr_list~other")).content, "OTHER-bytes", "another session's row survives the sweep");
117
+ }
118
+ onOptionalMember?.({ member: "listBySession", status: "verified" });
119
+ });
120
+ run("reap (optional): no bound removes nothing, a bad bound is refused, age alone decides; absence is REPORTED, not silently green", async () => {
121
+ const probe = make();
122
+ if (probe.reap === undefined) {
123
+ onOptionalMember?.({ member: "reap", status: "absent" });
124
+ return;
125
+ }
126
+ assert.equal(typeof probe.reap, "function", `reap is present but not callable (got ${typeof probe.reap}) — a garbage member is a DEFECT, not an optional-member absence`);
127
+ const store = make();
128
+ const reap = async (now, opts) => Promise.resolve(Reflect.apply(store.reap, store, [now, opts]));
129
+ await store.put("tr_age~owned", "OWNED-bytes", { sessionId: "sess-A" });
130
+ await store.put("tr_age~unowned", "UNOWNED-bytes");
131
+ const later = Date.now() + 3_600_000;
132
+ assert.equal(await reap(later), 0, "no opts ⇒ nothing is aged out");
133
+ assert.equal(await reap(later, {}), 0, "no maxAgeMs ⇒ nothing is aged out");
134
+ for (const bad of [Number.NaN, -1, Number.POSITIVE_INFINITY, "60000"]) {
135
+ await assert.rejects(reap(later, { maxAgeMs: bad }), (e) => e.code === "config.retention_policy_invalid", `maxAgeMs ${String(bad)} is refused, coded`);
136
+ }
137
+ await assert.rejects(reap(Number.NaN, { maxAgeMs: 1 }), (e) => e.code === "config.retention_policy_invalid", "a now that is not a number is refused, coded");
138
+ assert.equal((await store.get("tr_age~owned")).content, "OWNED-bytes", "a refused sweep removed nothing");
139
+ assert.equal(await reap(later, { maxAgeMs: 2 * 3_600_000 }), 0, "an entry younger than the bound is kept");
140
+ assert.equal((await store.get("tr_age~unowned")).content, "UNOWNED-bytes");
141
+ assert.equal(await reap(later, { maxAgeMs: 60_000 }), 2, "every entry older than the bound is removed, owned or not");
142
+ assert.equal(await store.get("tr_age~owned"), undefined);
143
+ assert.equal(await store.get("tr_age~unowned"), undefined);
144
+ assert.equal(await store.ownerOf("tr_age~owned"), undefined, "the owner record goes with the content");
145
+ assert.equal(await reap(later, { maxAgeMs: 60_000 }), 0, "idempotent");
146
+ await store.put("tr_age~owned", "NEW-bytes", { sessionId: "sess-B" });
147
+ assert.deepEqual(await store.ownerOf("tr_age~owned"), { sessionId: "sess-B" }, "a reaped ref is free for a new owner");
148
+ onOptionalMember?.({ member: "reap", status: "verified" });
149
+ });
83
150
  await settle();
84
151
  }
@@ -1,4 +1,4 @@
1
- import { type ExecResult, type ExecutionEnv, ExecutionError, FileError, type FileInfo, type Result } from "../internal/harness.js";
1
+ import { type ExecResult, type ExecutionEnv, type ExecutionEnvCapabilities, ExecutionError, FileError, type FileInfo, type Result } from "../internal/harness.js";
2
2
  /**
3
3
  * A no-op ExecutionEnv for tool/MCP-only deployments (no shell, no filesystem).
4
4
  *
@@ -8,10 +8,10 @@ import { type ExecResult, type ExecutionEnv, ExecutionError, FileError, type Fil
8
8
  */
9
9
  export declare class StubExecutionEnv implements ExecutionEnv {
10
10
  cwd: string;
11
- /** design/380 O9a — declared on the class so the prepare fold can read the optional interface
12
- * member off a `ExecutionEnv | StubExecutionEnv` union; the no-I/O stub produces no target
13
- * content, so it never declares (always `undefined` — the trusted-side default). */
14
- readonly externalContentTarget?: boolean;
11
+ /** `ExecutionEnv.capabilities`: no target at all (`io: false`) — every operation refuses, so it produces no outside
12
+ * content, names no path that is not the engine host's, and keeps the byte floor by refusing every start
13
+ * (`keepsReadFloor: true`). A subclass that overrides operations with real I/O states its own block. */
14
+ readonly capabilities: ExecutionEnvCapabilities;
15
15
  /** `ExecutionEnv.cdPath`: the stub runs no shell, so no shell receives a `CDPATH`. */
16
16
  readonly cdPath: readonly string[];
17
17
  /** `ExecutionEnv.withheldEnv`: no shell child, so nothing is withheld from one. */
@@ -1,7 +1,17 @@
1
1
  import { ExecutionError, FileError, err, } from "../internal/harness.js";
2
+ const STUB_ENV_CAPABILITIES = Object.freeze({
3
+ isolation: false,
4
+ suspendable: false,
5
+ sharesProcessTable: true,
6
+ canonicalPathAuthoritative: false,
7
+ hostLocalPaths: true,
8
+ externalContentTarget: false,
9
+ io: false,
10
+ keepsReadFloor: true,
11
+ });
2
12
  export class StubExecutionEnv {
3
13
  cwd;
4
- externalContentTarget;
14
+ capabilities = STUB_ENV_CAPABILITIES;
5
15
  cdPath = [];
6
16
  withheldEnv = [];
7
17
  constructor(cwd = "/") {
@@ -1,41 +1,3 @@
1
- /**
2
- * The deployment seats a Runner may HOT-SWAP after construction — the vocabulary behind the ONE door,
3
- * `Runner.swapDeps` (runtask.ts).
4
- *
5
- * WHY ONE DOOR. Each hot-swappable seat used to be a verb of its own (`swapModels` was the first), and a
6
- * verb per seat restates the same three laws every time — validate the candidate BEFORE anything is
7
- * written, write the deps object ONCE (a swap is atomic: a refused candidate leaves the current deps
8
- * byte-identical), announce the change under a notice code — while the question "which seats may be
9
- * swapped at all" was answered by the list of verbs, i.e. by nothing a compiler could see. With one door
10
- * the laws are stated once, the swappable set is THIS closed list, and every seat carries its rows in
11
- * the tables beside it: the compiler refuses a member without its rows ({@link AssertAllKeysHandled}),
12
- * the door refuses a key outside the set at run time (never a silent ignore — a hot-config driver
13
- * handing `{ brain }` must learn that the brain is not a swappable seat, not watch nothing happen).
14
- *
15
- * WHAT A SWAP MEANS — the natural snapshot, one sentence for every ROUTING seat: a running task reads the
16
- * deps object it was handed at its prepare and holds that reference; a swap replaces the Runner's object, so
17
- * every LATER prepare reads the new seat and every in-flight leg keeps the value it prepared under.
18
- * Nothing is re-routed, re-priced or re-fenced mid-run; the divergence window is exactly the in-flight
19
- * legs' lifetime, by design (the `swapModels` precedent).
20
- *
21
- * …WITH ONE SEAT OUTSIDE IT, and the boundary is the point rather than the exception: `contextSettings` is
22
- * read LIVE by in-flight legs. The snapshot law protects the routing CARD — a request already in flight must
23
- * reach the endpoint it was priced, credentialed and fenced for, and re-reading any of that mid-run buys
24
- * nothing and breaks the request. A leg's usable WINDOW is not on that card: it is a setting about how much
25
- * conversation may accumulate before the leg summarizes, the reference implementation keeps it off the model
26
- * object for exactly this reason and re-reads it on every request (clamped to the model's physical window),
27
- * and an operator who lowers it is asking the legs running RIGHT NOW to compact sooner — which is the whole
28
- * request. So the window declarations live on their own seat (`context-settings.ts`), keyed by catalog word,
29
- * and the legs read them at every boundary, every recovery pass, the end-of-task summary and every request
30
- * build. Routing stays snapshotted; geometry follows the operator. The two are not the same question, and
31
- * one law over both could only be wrong about one of them.
32
- *
33
- * KEY PRESENCE IS THE INSTRUCTION: a key present on the candidate is REPLACED (an explicit `undefined`
34
- * CLEARS an optional seat back to its engine default — `readFace: undefined` ⇒ the deployment declares
35
- * no read face, `tiers: undefined` ⇒ no tier bindings); a key absent is KEPT. `Object.hasOwn`, never
36
- * truthiness, so the two spellings cannot be confused. An EMPTY candidate is refused: a swap that names
37
- * no seat is a caller defect, not a no-op.
38
- */
39
1
  import type { AssertAllKeysHandled } from "./ask-origin.js";
40
2
  import type { RunnerDeps } from "./runner-deps.js";
41
3
  import { type ReadDenyDeploymentSeat } from "./read-face-seats.js";
@@ -60,12 +22,13 @@ import { type ReadDenyDeploymentSeat } from "./read-face-seats.js";
60
22
  * - `contextSettings` — the per-model context-window overlay ({@link RunnerDeps.contextSettings}); screened
61
23
  * by the same value gate construction applies (`assertContextSettingsValue`). THE ONE SEAT
62
24
  * IN-FLIGHT LEGS RE-READ — see the header: it carries geometry, not route.
63
- * - `readDenyPatterns` / `readDenyBuiltinTiers` / `readDenyBuiltinExclude` — the deployment's read-deny
64
- * declaration (additions, built-in tier selection, built-in row removal); screened by the
65
- * gates a prepare applies ({@link screenReadDenySeat}). A resumed leg compiles against the
66
- * seats in force at its prepare (the checkpoint keeps additions only, stricter-wins).
25
+ * - `readDenyPatterns` / `readDenyBuiltinTiers` / `readDenyBuiltinExclude` / `readDenyFloorRequired` — the
26
+ * deployment's read-deny declaration (additions, built-in tier selection, built-in row removal,
27
+ * whether the byte floor must be kept); screened by the gates a prepare applies
28
+ * ({@link screenReadDenySeat}). A resumed leg compiles against the seats in force at its prepare
29
+ * (the checkpoint keeps additions only, stricter-wins).
67
30
  */
68
- export declare const SWAPPABLE_DEP_SEATS: readonly ["models", "tiers", "readFace", "writeFace", "contextSettings", "readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude"];
31
+ export declare const SWAPPABLE_DEP_SEATS: readonly ["models", "tiers", "readFace", "writeFace", "contextSettings", "readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude", "readDenyFloorRequired"];
69
32
  export type SwappableDepSeat = (typeof SWAPPABLE_DEP_SEATS)[number];
70
33
  /** The candidate a swap takes: the swappable seats of {@link RunnerDeps}, each optional (presence = instruction). */
71
34
  export type SwappableDeps = Pick<RunnerDeps, SwappableDepSeat>;
@@ -85,6 +48,7 @@ export declare const SWAP_SEAT_NOTICE: {
85
48
  readonly readDenyPatterns: "config.read_deny_swapped";
86
49
  readonly readDenyBuiltinTiers: "config.read_deny_swapped";
87
50
  readonly readDenyBuiltinExclude: "config.read_deny_swapped";
51
+ readonly readDenyFloorRequired: "config.read_deny_swapped";
88
52
  };
89
53
  /** The fence over the notice table: `never` while every seat has a row. */
90
54
  export type SwapNoticeTableCoversEverySeat = AssertAllKeysHandled<Exclude<SwappableDepSeat, keyof typeof SWAP_SEAT_NOTICE>>;
@@ -114,6 +78,16 @@ export interface ScreenedSwappableDeps {
114
78
  * `assertContainmentFaceValue`), so a value the door admits is a value every later prepare admits.
115
79
  */
116
80
  export declare function screenSwappableDeps(next: unknown): ScreenedSwappableDeps;
81
+ /**
82
+ * The identity of a model-catalog generation as the swap announces it: a digest of the catalog's KEY MATERIAL — the model names the
83
+ * candidate declares and the tier bindings over them (each tier word, and the catalog word it binds; a binding that is a `Model` object
84
+ * has no word, so it stands as `null`) — never the catalog's content. Names and tier words are sorted, so the digest does not depend on
85
+ * the order a driver spelled them in; it depends on nothing but those two tables, so every Runner a driver swaps to the SAME model names
86
+ * under the SAME tier bindings announces the SAME generation (each notice still mints its own `occurrenceId`), and a swap that ends on
87
+ * another model name or another tier binding announces another. Two generations with equal key material read as one; the digest names what a consumer can tell apart
88
+ * from the line, which is the keys — the line is an operator breadcrumb, not a content fingerprint.
89
+ */
90
+ export declare function catalogGenerationOf(models: Readonly<Record<string, unknown>>, tiers: Readonly<Record<string, unknown>> | undefined): string;
117
91
  /**
118
92
  * Announce a swap of the deployment's read-deny declaration, after the write: ONE `config.read_deny_swapped`
119
93
  * line however many of its three seats the swap named (the line's contract lives at the notice catalog,
@@ -1,9 +1,11 @@
1
+ import { createHash } from "node:crypto";
1
2
  import { assertContainmentFaceValue } from "../tools/fs/containment-face.js";
2
3
  import { assertContextSettingsValue } from "./context-settings.js";
3
4
  import { READ_DENY_DEPLOYMENT_SEATS, screenReadDenySeat } from "./read-face-seats.js";
4
5
  import { deliverEngineNotice } from "./engine-notice.js";
5
6
  import { uuidv7 } from "../internal/harness.js";
6
- export const SWAPPABLE_DEP_SEATS = Object.freeze(["models", "tiers", "readFace", "writeFace", "contextSettings", "readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude"]);
7
+ import { receiveOwnProperties } from "./own-property-receipt.js";
8
+ export const SWAPPABLE_DEP_SEATS = Object.freeze(["models", "tiers", "readFace", "writeFace", "contextSettings", "readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude", "readDenyFloorRequired"]);
7
9
  const SWAPPABLE_DEP_SEAT_SET = new Set(SWAPPABLE_DEP_SEATS);
8
10
  export function isSwappableDepSeat(k) {
9
11
  return SWAPPABLE_DEP_SEAT_SET.has(k);
@@ -17,6 +19,7 @@ export const SWAP_SEAT_NOTICE = {
17
19
  readDenyPatterns: "config.read_deny_swapped",
18
20
  readDenyBuiltinTiers: "config.read_deny_swapped",
19
21
  readDenyBuiltinExclude: "config.read_deny_swapped",
22
+ readDenyFloorRequired: "config.read_deny_swapped",
20
23
  };
21
24
  export function screenSwappableDeps(next) {
22
25
  if (next === null || typeof next !== "object" || Array.isArray(next)) {
@@ -40,7 +43,7 @@ export function screenSwappableDeps(next) {
40
43
  if (v === null || typeof v !== "object" || Array.isArray(v)) {
41
44
  throw new Error(`swapDeps: models must be a plain Record<string, Model> (got ${v === null ? "null" : Array.isArray(v) ? "array" : typeof v}) — the current generation stays in force`);
42
45
  }
43
- candidate.models = { ...v };
46
+ candidate.models = receiveOwnProperties(v, { subject: "swapDeps.models", unit: "entry", moment: "at swapDeps" });
44
47
  break;
45
48
  case "tiers":
46
49
  if (!present.includes("models")) {
@@ -49,7 +52,7 @@ export function screenSwappableDeps(next) {
49
52
  if (v !== undefined && (v === null || typeof v !== "object" || Array.isArray(v))) {
50
53
  throw new Error(`swapDeps: tiers must be a plain Record<string, ModelRef> or undefined (got ${v === null ? "null" : Array.isArray(v) ? "array" : typeof v}) — the current generation stays in force`);
51
54
  }
52
- candidate.tiers = v === undefined ? undefined : { ...v };
55
+ candidate.tiers = v === undefined ? undefined : receiveOwnProperties(v, { subject: "swapDeps.tiers", unit: "binding", moment: "at swapDeps" });
53
56
  break;
54
57
  case "readFace":
55
58
  candidate.readFace = assertContainmentFaceValue(v, "read", "deps");
@@ -63,6 +66,7 @@ export function screenSwappableDeps(next) {
63
66
  case "readDenyPatterns":
64
67
  case "readDenyBuiltinTiers":
65
68
  case "readDenyBuiltinExclude":
69
+ case "readDenyFloorRequired":
66
70
  candidate[seat] = screenReadDenySeat(seat, v);
67
71
  break;
68
72
  default: {
@@ -73,6 +77,11 @@ export function screenSwappableDeps(next) {
73
77
  }
74
78
  return { seats: present, candidate: candidate };
75
79
  }
80
+ export function catalogGenerationOf(models, tiers) {
81
+ const names = Object.keys(models).sort();
82
+ const bindings = tiers === undefined ? [] : Object.keys(tiers).sort().map((tier) => [tier, typeof tiers[tier] === "string" ? tiers[tier] : null]);
83
+ return `cgv1:${createHash("sha256").update(JSON.stringify([names, bindings])).digest("hex")}`;
84
+ }
76
85
  export function announceReadDenySwap(onNotice, seats, inForce) {
77
86
  const named = READ_DENY_DEPLOYMENT_SEATS.filter((s) => seats.includes(s));
78
87
  if (named.length === 0)
@@ -80,9 +89,10 @@ export function announceReadDenySwap(onNotice, seats, inForce) {
80
89
  const patterns = inForce.readDenyPatterns?.length ?? null;
81
90
  const tiers = inForce.readDenyBuiltinTiers !== undefined ? [...inForce.readDenyBuiltinTiers] : null;
82
91
  const exclude = inForce.readDenyBuiltinExclude?.length ?? null;
92
+ const floorRequired = inForce.readDenyFloorRequired ?? null;
83
93
  deliverEngineNotice(onNotice, {
84
94
  code: "config.read_deny_swapped",
85
- message: `deployment read-deny declaration swapped (${named.join(", ")}): ${patterns ?? "no"} addition(s), built-in tiers ${tiers === null ? "(default)" : `[${tiers.join(", ")}]`}, ${exclude ?? "no"} built-in row removal(s); in-flight legs keep the deny face they prepared under, new legs compile against the new declaration`,
86
- detail: { seats: named, patterns, tiers, exclude, occurrenceId: uuidv7() },
95
+ message: `deployment read-deny declaration swapped (${named.join(", ")}): ${patterns ?? "no"} addition(s), built-in tiers ${tiers === null ? "(default)" : `[${tiers.join(", ")}]`}, ${exclude ?? "no"} built-in row removal(s), byte floor ${floorRequired === true ? "required" : "not required"}; in-flight legs keep the deny face they prepared under, new legs compile against the new declaration`,
96
+ detail: { seats: named, patterns, tiers, exclude, floorRequired, occurrenceId: uuidv7() },
87
97
  });
88
98
  }
@@ -57,7 +57,7 @@
57
57
  * waiting for that layer (the layer answered, or its share of the judgment's budget is spent) or when the run's signal ends.
58
58
  * An abort means only that: the task ended, or the judge no longer waits — never "there is no approver". Every engine
59
59
  * policy factory reads the statement before reaching a seat (the approval factory answers a deny attested `no_approver`,
60
- * read here as `approval_seat`; the inherited PreToolUse constraint does the same before invoking its hook), and the
60
+ * read here as `approval_seat`; an inherited screening installation is no policy layer here, as a leg's own PreToolUse is not), and the
61
61
  * engine's own guards composed into a deployment's policy judge the probe as they judge a call — a lookup bounded by a
62
62
  * live deadline answers. A deny that carries no engine settlement is a rule's deny and stands. RESIDUALS (stated, not
63
63
  * closed): a deployment closure that ignores the statement and reaches an approver IS asked — the judge waits for it at