@sema-agent/core 7.60.0 → 7.62.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 (560) hide show
  1. package/CHANGELOG.md +917 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +71 -12
  6. package/dist/agents/cascade.js +61 -21
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-held-queue.d.ts +27 -4
  17. package/dist/agents/peer-held-queue.js +81 -36
  18. package/dist/agents/peer-notice-route.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.js +4 -3
  20. package/dist/agents/peer-notices.d.ts +4 -4
  21. package/dist/agents/peer-notices.js +8 -4
  22. package/dist/agents/peer-session-drain.d.ts +8 -1
  23. package/dist/agents/peer-session-drain.js +49 -10
  24. package/dist/agents/repair-loop.js +16 -6
  25. package/dist/agents/retain-ledger.js +3 -1
  26. package/dist/agents/roster-store.d.ts +1 -1
  27. package/dist/agents/roster-store.js +7 -4
  28. package/dist/agents/send-message-tool.d.ts +8 -10
  29. package/dist/agents/send-message-tool.js +43 -23
  30. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  31. package/dist/agents/subagent-completion-gate.js +62 -0
  32. package/dist/agents/subagent-steps.d.ts +7 -6
  33. package/dist/agents/subagent.d.ts +36 -41
  34. package/dist/agents/subagent.js +245 -200
  35. package/dist/agents/suspend-guard.d.ts +47 -16
  36. package/dist/agents/suspend-guard.js +13 -4
  37. package/dist/agents/verify.d.ts +41 -14
  38. package/dist/agents/verify.js +41 -30
  39. package/dist/brain/anthropic.js +1 -0
  40. package/dist/brain/errors.d.ts +7 -1
  41. package/dist/brain/errors.js +6 -0
  42. package/dist/brain/failover.js +2 -1
  43. package/dist/brain/open-responses.js +1 -0
  44. package/dist/brain/openai.js +1 -0
  45. package/dist/brain/provider-dialect.d.ts +10 -0
  46. package/dist/brain/provider-dialect.js +13 -2
  47. package/dist/brain/stream-engine.d.ts +3 -0
  48. package/dist/brain/stream-engine.js +4 -0
  49. package/dist/core/agent-state.d.ts +1 -1
  50. package/dist/core/allow-entry.d.ts +59 -23
  51. package/dist/core/allow-entry.js +131 -38
  52. package/dist/core/ask-origin.d.ts +79 -0
  53. package/dist/core/ask-origin.js +76 -0
  54. package/dist/core/ask-question.d.ts +19 -13
  55. package/dist/core/ask-question.js +8 -2
  56. package/dist/core/auto-compaction.d.ts +2 -0
  57. package/dist/core/auto-compaction.js +2 -1
  58. package/dist/core/auto-mode.js +3 -5
  59. package/dist/core/background-agent-store.d.ts +7 -5
  60. package/dist/core/background-agent-store.js +12 -11
  61. package/dist/core/checkpoint-features.d.ts +722 -0
  62. package/dist/core/checkpoint-features.js +98 -0
  63. package/dist/core/checkpoint-requirements.d.ts +33 -5
  64. package/dist/core/checkpoint-requirements.js +18 -5
  65. package/dist/core/checkpoint-row-verdict.d.ts +99 -0
  66. package/dist/core/checkpoint-row-verdict.js +225 -0
  67. package/dist/core/checkpoint-store.d.ts +107 -738
  68. package/dist/core/checkpoint-store.js +45 -143
  69. package/dist/core/child-clamp-seats.d.ts +3 -2
  70. package/dist/core/child-clamp-seats.js +4 -3
  71. package/dist/core/closest-name.d.ts +13 -0
  72. package/dist/core/closest-name.js +35 -0
  73. package/dist/core/context-settings.js +3 -5
  74. package/dist/core/cross-boundary-taint.d.ts +1 -1
  75. package/dist/core/decision-receipt.d.ts +14 -1
  76. package/dist/core/decision-receipt.js +6 -3
  77. package/dist/core/delegation-frames.d.ts +13 -9
  78. package/dist/core/effective-path-target.js +2 -3
  79. package/dist/core/engine-attestation.d.ts +11 -1
  80. package/dist/core/engine-attestation.js +2 -0
  81. package/dist/core/engine-notice.d.ts +68 -21
  82. package/dist/core/engine-notice.js +9 -2
  83. package/dist/core/file-history-retention.d.ts +8 -0
  84. package/dist/core/file-history-retention.js +14 -11
  85. package/dist/core/file-history-store.d.ts +31 -1
  86. package/dist/core/file-history-store.js +31 -2
  87. package/dist/core/frame-settlement.d.ts +10 -0
  88. package/dist/core/frame-settlement.js +6 -1
  89. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  90. package/dist/core/fs-write-gate-policy.js +8 -7
  91. package/dist/core/gate-fold.js +4 -3
  92. package/dist/core/gate-lanes.js +7 -4
  93. package/dist/core/gate-outcome.d.ts +40 -1
  94. package/dist/core/gate-outcome.js +10 -0
  95. package/dist/core/git-worktree-env.d.ts +7 -3
  96. package/dist/core/git-worktree-env.js +16 -13
  97. package/dist/core/governance-codes.d.ts +14 -4
  98. package/dist/core/governance-codes.js +19 -4
  99. package/dist/core/hooks.d.ts +25 -4
  100. package/dist/core/hooks.js +11 -4
  101. package/dist/core/host-floor.js +3 -5
  102. package/dist/core/human-input-projection.d.ts +1 -0
  103. package/dist/core/human-input-projection.js +3 -0
  104. package/dist/core/image-admission.d.ts +47 -7
  105. package/dist/core/image-admission.js +35 -4
  106. package/dist/core/input-author.d.ts +36 -0
  107. package/dist/core/input-author.js +39 -0
  108. package/dist/core/leg-identity.d.ts +62 -0
  109. package/dist/core/leg-identity.js +18 -0
  110. package/dist/core/locked-config.d.ts +4 -3
  111. package/dist/core/locked-config.js +5 -3
  112. package/dist/core/lsp.d.ts +5 -3
  113. package/dist/core/lsp.js +3 -2
  114. package/dist/core/mailbox-store.d.ts +85 -10
  115. package/dist/core/mailbox-store.js +31 -10
  116. package/dist/core/mcp-connection-pool.d.ts +6 -20
  117. package/dist/core/mcp-connection-pool.js +10 -28
  118. package/dist/core/mcp-failure.d.ts +76 -15
  119. package/dist/core/mcp-failure.js +60 -33
  120. package/dist/core/mcp-host-seat.d.ts +92 -53
  121. package/dist/core/mcp-host-seat.js +225 -46
  122. package/dist/core/mcp-probe.js +2 -2
  123. package/dist/core/mcp-server-link.d.ts +18 -6
  124. package/dist/core/mcp-server-link.js +19 -4
  125. package/dist/core/mcp-server-spec.d.ts +2 -1
  126. package/dist/core/mcp-session-end.d.ts +1 -2
  127. package/dist/core/mcp-session-end.js +1 -1
  128. package/dist/core/mcp.d.ts +6 -49
  129. package/dist/core/mcp.js +115 -111
  130. package/dist/core/media-byte-cap.d.ts +21 -46
  131. package/dist/core/media-byte-cap.js +55 -55
  132. package/dist/core/member-group.d.ts +7 -0
  133. package/dist/core/member-group.js +35 -0
  134. package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
  135. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  136. package/dist/core/memory-engine/consolidation.js +7 -1
  137. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  138. package/dist/core/memory-engine/dual-root.js +59 -11
  139. package/dist/core/memory-engine/engine.js +27 -24
  140. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  141. package/dist/core/memory-engine/file-backend.js +35 -15
  142. package/dist/core/memory-engine/layout.d.ts +3 -0
  143. package/dist/core/memory-engine/layout.js +13 -3
  144. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  145. package/dist/core/memory-engine/memory-deployment.js +182 -0
  146. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  147. package/dist/core/memory-engine/sync-client.js +72 -14
  148. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  149. package/dist/core/memory-engine/sync.d.ts +9 -1
  150. package/dist/core/memory-vector.d.ts +1 -1
  151. package/dist/core/memory.d.ts +10 -10
  152. package/dist/core/mode-policy.d.ts +8 -8
  153. package/dist/core/mode-policy.js +8 -6
  154. package/dist/core/mods/agent-stations.d.ts +39 -4
  155. package/dist/core/mods/agent-stations.js +59 -10
  156. package/dist/core/mods/classic-events.d.ts +9 -1
  157. package/dist/core/mods/dollar.d.ts +94 -1
  158. package/dist/core/mods/dollar.js +13 -1
  159. package/dist/core/mods/extension-call.d.ts +15 -1
  160. package/dist/core/mods/extension-call.js +7 -2
  161. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  162. package/dist/core/mods/kernel/dispatch.js +4 -4
  163. package/dist/core/mods/kernel/events.d.ts +14 -3
  164. package/dist/core/mods/kernel/events.js +18 -15
  165. package/dist/core/mods/kernel/registration.d.ts +3 -0
  166. package/dist/core/mods/kernel/registration.js +5 -0
  167. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  168. package/dist/core/mods/kernel/site-rules.js +10 -2
  169. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  170. package/dist/core/mods/lifecycle-stations.js +44 -9
  171. package/dist/core/mods/session-append.d.ts +118 -0
  172. package/dist/core/mods/session-append.js +318 -0
  173. package/dist/core/mods/session-compact.d.ts +48 -0
  174. package/dist/core/mods/session-compact.js +194 -0
  175. package/dist/core/mods/session-receive.d.ts +93 -0
  176. package/dist/core/mods/session-receive.js +138 -0
  177. package/dist/core/mods/session-send.d.ts +72 -0
  178. package/dist/core/mods/session-send.js +88 -0
  179. package/dist/core/mods/stations.d.ts +88 -21
  180. package/dist/core/mods/stations.js +149 -11
  181. package/dist/core/mods/tool-call.d.ts +2 -0
  182. package/dist/core/mods/tool-call.js +4 -4
  183. package/dist/core/output-style.js +3 -4
  184. package/dist/core/own-property-receipt.d.ts +68 -2
  185. package/dist/core/own-property-receipt.js +45 -2
  186. package/dist/core/park-selfcheck.js +4 -2
  187. package/dist/core/path-identity.d.ts +11 -0
  188. package/dist/core/path-identity.js +4 -0
  189. package/dist/core/path-rule-binding.d.ts +3 -1
  190. package/dist/core/path-rule-binding.js +3 -1
  191. package/dist/core/peer-seat.d.ts +3 -3
  192. package/dist/core/peer-seat.js +20 -8
  193. package/dist/core/permission-rule-consent.d.ts +21 -5
  194. package/dist/core/permission-rule-consent.js +21 -1
  195. package/dist/core/permission-rule-model.d.ts +34 -11
  196. package/dist/core/permission-rule-model.js +47 -10
  197. package/dist/core/permission-rule-org.d.ts +1 -1
  198. package/dist/core/permission-rule-provider.js +4 -1
  199. package/dist/core/permission-rules.d.ts +4 -0
  200. package/dist/core/permission-rules.js +11 -16
  201. package/dist/core/read-root-candidate.js +1 -1
  202. package/dist/core/remote-env.d.ts +74 -26
  203. package/dist/core/remote-env.js +20 -0
  204. package/dist/core/resume-startup-cause.d.ts +5 -4
  205. package/dist/core/retention-policy.d.ts +24 -23
  206. package/dist/core/retention-policy.js +36 -2
  207. package/dist/core/retention.d.ts +4 -1
  208. package/dist/core/retired-keys.d.ts +4 -4
  209. package/dist/core/row-admission.d.ts +10 -0
  210. package/dist/core/row-admission.js +5 -0
  211. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  212. package/dist/core/runner/advisor-instructions.js +2 -1
  213. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  214. package/dist/core/runner/assemble-result.d.ts +13 -3
  215. package/dist/core/runner/assemble-result.js +12 -7
  216. package/dist/core/runner/caller-roster.d.ts +12 -9
  217. package/dist/core/runner/caller-roster.js +5 -2
  218. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  219. package/dist/core/runner/checkpoint-scope.js +21 -0
  220. package/dist/core/runner/compact-session.js +18 -3
  221. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  222. package/dist/core/runner/compaction-restate.d.ts +2 -2
  223. package/dist/core/runner/compaction-restate.js +4 -3
  224. package/dist/core/runner/construction-doors.d.ts +2 -2
  225. package/dist/core/runner/construction-doors.js +2 -2
  226. package/dist/core/runner/contracts.d.ts +116 -34
  227. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  228. package/dist/core/runner/decide-continuation.d.ts +4 -2
  229. package/dist/core/runner/decide-continuation.js +7 -4
  230. package/dist/core/runner/delegation-owner.d.ts +43 -0
  231. package/dist/core/runner/delegation-owner.js +59 -0
  232. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  233. package/dist/core/runner/denial-limit-arms.js +17 -10
  234. package/dist/core/runner/expire-settle.d.ts +44 -0
  235. package/dist/core/runner/expire-settle.js +55 -0
  236. package/dist/core/runner/git-status-frame.d.ts +3 -3
  237. package/dist/core/runner/git-status-frame.js +2 -1
  238. package/dist/core/runner/halt-attribution.d.ts +2 -1
  239. package/dist/core/runner/halt-attribution.js +2 -1
  240. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  241. package/dist/core/runner/lineage-reroot-view.js +108 -0
  242. package/dist/core/runner/local-claims.d.ts +17 -0
  243. package/dist/core/runner/local-claims.js +18 -0
  244. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  245. package/dist/core/runner/media-removed-seat.js +88 -0
  246. package/dist/core/runner/park-commit.d.ts +2 -2
  247. package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
  248. package/dist/core/runner/permission-rule-lanes.js +28 -9
  249. package/dist/core/runner/person-path-rows.d.ts +15 -0
  250. package/dist/core/runner/person-path-rows.js +27 -4
  251. package/dist/core/runner/placement-fence.d.ts +26 -0
  252. package/dist/core/runner/placement-fence.js +38 -0
  253. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  254. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  255. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  256. package/dist/core/runner/prepare-ask-lane.js +4 -4
  257. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  258. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  259. package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
  260. package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
  261. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  262. package/dist/core/runner/prepare-config-doors.js +19 -21
  263. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  264. package/dist/core/runner/prepare-context-lane.js +13 -13
  265. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  266. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  267. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  268. package/dist/core/runner/prepare-execution-env.js +7 -4
  269. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  270. package/dist/core/runner/prepare-gate-stations.js +6 -4
  271. package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
  272. package/dist/core/runner/prepare-hands-readface.js +32 -11
  273. package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
  274. package/dist/core/runner/prepare-inherited-gate.js +10 -3
  275. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  276. package/dist/core/runner/prepare-lsp.js +2 -2
  277. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  278. package/dist/core/runner/prepare-park-ask.js +4 -5
  279. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  280. package/dist/core/runner/prepare-policy-chain.js +16 -25
  281. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  282. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  283. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  284. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  285. package/dist/core/runner/prepare-question-face.js +2 -2
  286. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  287. package/dist/core/runner/prepare-run-refs.js +2 -2
  288. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  289. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  290. package/dist/core/runner/prepare-task.d.ts +1 -1
  291. package/dist/core/runner/prepare-task.js +61 -30
  292. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  293. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  294. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  295. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  296. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  297. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  298. package/dist/core/runner/read-root-grant.d.ts +1 -1
  299. package/dist/core/runner/read-root-grant.js +2 -1
  300. package/dist/core/runner/resume-admission.d.ts +8 -6
  301. package/dist/core/runner/resume-admission.js +23 -6
  302. package/dist/core/runner/resume-apply.d.ts +4 -0
  303. package/dist/core/runner/resume-apply.js +14 -5
  304. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  305. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  306. package/dist/core/runner/resume-claim.d.ts +8 -3
  307. package/dist/core/runner/resume-claim.js +28 -12
  308. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  309. package/dist/core/runner/resume-internals-and-config.js +10 -1
  310. package/dist/core/runner/resume-preflight.d.ts +3 -2
  311. package/dist/core/runner/resume-preflight.js +13 -26
  312. package/dist/core/runner/retired-runner-deps.js +2 -0
  313. package/dist/core/runner/run-git-lane.d.ts +2 -0
  314. package/dist/core/runner/run-git-lane.js +6 -2
  315. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  316. package/dist/core/runner/run-harness-handlers.js +5 -4
  317. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  318. package/dist/core/runner/run-identity-wiring.js +14 -5
  319. package/dist/core/runner/run-leg.d.ts +3 -3
  320. package/dist/core/runner/run-leg.js +64 -36
  321. package/dist/core/runner/run-notification-lane.js +20 -2
  322. package/dist/core/runner/run-recovery-lanes.js +3 -2
  323. package/dist/core/runner/run-settle-and-teardown.js +12 -9
  324. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  325. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  326. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  327. package/dist/core/runner/run-terminal-adoption.js +26 -17
  328. package/dist/core/runner/run-turn-boundary.js +34 -18
  329. package/dist/core/runner/runtask.d.ts +18 -3
  330. package/dist/core/runner/runtask.js +33 -17
  331. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  332. package/dist/core/runner/session-rule-policy.js +6 -1
  333. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  334. package/dist/core/runner/steering-preview.d.ts +9 -0
  335. package/dist/core/runner/steering-preview.js +5 -0
  336. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  337. package/dist/core/runner/stream-halt-verbs.js +4 -3
  338. package/dist/core/runner/stream-reap.d.ts +7 -6
  339. package/dist/core/runner/stream-reap.js +13 -16
  340. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  341. package/dist/core/runner/stream-settle-backstop.js +5 -3
  342. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  343. package/dist/core/runner/stream-steer-verb.js +16 -7
  344. package/dist/core/runner/terminal-account.d.ts +11 -1
  345. package/dist/core/runner/terminal-account.js +20 -0
  346. package/dist/core/runner/terminal-projection.d.ts +8 -2
  347. package/dist/core/runner/terminal-projection.js +2 -2
  348. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  349. package/dist/core/runner/tool-disclosure.js +5 -2
  350. package/dist/core/runner/tool-end-body.d.ts +3 -3
  351. package/dist/core/runner/tool-end-body.js +1 -1
  352. package/dist/core/runner/tool-face-overlay.js +2 -0
  353. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  354. package/dist/core/runner/tool-output-projection.js +7 -6
  355. package/dist/core/runner/tool-table-view.d.ts +56 -0
  356. package/dist/core/runner/tool-table-view.js +51 -0
  357. package/dist/core/runner/turn-attachments.d.ts +8 -2
  358. package/dist/core/runner/turn-attachments.js +2 -2
  359. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  360. package/dist/core/runner/void-verifier-pause.js +41 -0
  361. package/dist/core/runner-deps.d.ts +26 -27
  362. package/dist/core/secret-env.d.ts +19 -16
  363. package/dist/core/secret-env.js +45 -27
  364. package/dist/core/session-log-transfer.js +9 -10
  365. package/dist/core/session-policy-store.d.ts +1 -1
  366. package/dist/core/session-policy-store.js +5 -2
  367. package/dist/core/session-reconcile.d.ts +3 -2
  368. package/dist/core/session-reconcile.js +7 -4
  369. package/dist/core/session-store.d.ts +3 -1
  370. package/dist/core/session-store.js +10 -8
  371. package/dist/core/session.d.ts +16 -5
  372. package/dist/core/shell-confinement.d.ts +37 -0
  373. package/dist/core/shell-confinement.js +56 -0
  374. package/dist/core/skill-grant.js +1 -1
  375. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
  376. package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
  377. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  378. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  379. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  380. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  381. package/dist/core/store-contracts/session-store-contract.js +22 -8
  382. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  383. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  384. package/dist/core/task-event.d.ts +24 -9
  385. package/dist/core/task-limits.d.ts +5 -0
  386. package/dist/core/task-notification.d.ts +89 -12
  387. package/dist/core/task-notification.js +89 -14
  388. package/dist/core/task-registry-agent.d.ts +32 -50
  389. package/dist/core/task-registry-agent.js +36 -56
  390. package/dist/core/task-registry-monitor.d.ts +1 -1
  391. package/dist/core/task-registry-monitor.js +15 -60
  392. package/dist/core/task-registry-shared.d.ts +22 -112
  393. package/dist/core/task-registry-shared.js +3 -41
  394. package/dist/core/task-registry-workflow.js +5 -21
  395. package/dist/core/task-registry.d.ts +32 -62
  396. package/dist/core/task-registry.js +30 -110
  397. package/dist/core/task-result.d.ts +29 -12
  398. package/dist/core/task-spec-members.d.ts +39 -0
  399. package/dist/core/task-spec-members.js +92 -0
  400. package/dist/core/task-spec.d.ts +11 -11
  401. package/dist/core/task-tool-shape.d.ts +7 -57
  402. package/dist/core/task-tool-shape.js +7 -66
  403. package/dist/core/terminal-cause.d.ts +36 -6
  404. package/dist/core/terminal-cause.js +1 -0
  405. package/dist/core/tool-catalog-entries.js +2 -5
  406. package/dist/core/tool-check-reading.js +16 -10
  407. package/dist/core/tool-conformance.js +1 -2
  408. package/dist/core/tool-errors.d.ts +6 -3
  409. package/dist/core/tool-errors.js +2 -0
  410. package/dist/core/tool-face-reader.js +3 -2
  411. package/dist/core/tool-face.d.ts +8 -5
  412. package/dist/core/tool-face.js +1 -1
  413. package/dist/core/tool-name-aliases.d.ts +5 -29
  414. package/dist/core/tool-name-aliases.js +9 -5
  415. package/dist/core/tool-name-readings.d.ts +14 -3
  416. package/dist/core/tool-name-readings.js +2 -0
  417. package/dist/core/tool-policy.d.ts +109 -18
  418. package/dist/core/tool-policy.js +84 -14
  419. package/dist/core/tool-result-store.d.ts +23 -0
  420. package/dist/core/tool-result-store.js +3 -2
  421. package/dist/core/tool-roster.d.ts +4 -4
  422. package/dist/core/tool-spec.d.ts +23 -6
  423. package/dist/core/trace.d.ts +18 -1
  424. package/dist/core/types.d.ts +1 -1
  425. package/dist/core/types.js +1 -1
  426. package/dist/core/user-attachment.js +26 -21
  427. package/dist/core/workflow-journal-store.d.ts +1 -1
  428. package/dist/core/workflow-run-store.d.ts +2 -0
  429. package/dist/core/workflow-run-store.js +6 -5
  430. package/dist/core/workflow-settled-run.d.ts +5 -0
  431. package/dist/core/workflow-settled-run.js +7 -0
  432. package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
  433. package/dist/engine/execution-env/node-execution-env.js +221 -22
  434. package/dist/engine/harness/agent-harness.d.ts +65 -18
  435. package/dist/engine/harness/agent-harness.js +90 -23
  436. package/dist/engine/harness/messages.d.ts +4 -3
  437. package/dist/engine/harness/messages.js +2 -2
  438. package/dist/engine/harness/types.d.ts +52 -7
  439. package/dist/engine/llm/media-removed.d.ts +14 -0
  440. package/dist/engine/llm/media-removed.js +9 -0
  441. package/dist/engine/llm/rejected-images.d.ts +35 -25
  442. package/dist/engine/llm/rejected-images.js +59 -10
  443. package/dist/engine/llm/types.d.ts +24 -3
  444. package/dist/engine/llm/types.js +7 -3
  445. package/dist/engine/loop/agent-loop.d.ts +6 -1
  446. package/dist/engine/loop/agent-loop.js +20 -11
  447. package/dist/engine/loop/types.d.ts +12 -3
  448. package/dist/engine/session/import-validate.js +7 -0
  449. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  450. package/dist/engine/session/parent-chain-guard.js +1 -1
  451. package/dist/engine/session/path-to-root.d.ts +18 -3
  452. package/dist/engine/session/path-to-root.js +15 -1
  453. package/dist/engine/session/repo-utils.d.ts +12 -1
  454. package/dist/engine/session/repo-utils.js +41 -0
  455. package/dist/engine/session/session.js +1 -1
  456. package/dist/engine/session/storage-base.d.ts +20 -0
  457. package/dist/engine/session/storage-base.js +28 -9
  458. package/dist/fixtures/index.d.ts +7 -5
  459. package/dist/fixtures/index.js +5 -3
  460. package/dist/index.d.ts +29 -18
  461. package/dist/index.js +19 -11
  462. package/dist/internal/harness-types.d.ts +2 -0
  463. package/dist/internal/harness.d.ts +4 -3
  464. package/dist/internal/harness.js +3 -2
  465. package/dist/internal/llm.d.ts +2 -1
  466. package/dist/internal/llm.js +1 -0
  467. package/dist/orchestration/goal.d.ts +6 -2
  468. package/dist/orchestration/goal.js +6 -3
  469. package/dist/orchestration/run-workflow-tool.d.ts +14 -17
  470. package/dist/orchestration/run-workflow-tool.js +43 -50
  471. package/dist/orchestration/workflow-types.d.ts +2 -2
  472. package/dist/orchestration/workflow.d.ts +7 -0
  473. package/dist/orchestration/workflow.js +10 -12
  474. package/dist/stores/file/background-agent-store.js +18 -15
  475. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  476. package/dist/stores/file/checkpoint-store.js +13 -9
  477. package/dist/stores/file/file-history-store.js +3 -2
  478. package/dist/stores/file/fs-atomic.d.ts +0 -22
  479. package/dist/stores/file/fs-atomic.js +0 -17
  480. package/dist/stores/file/index.d.ts +7 -12
  481. package/dist/stores/file/index.js +25 -12
  482. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  483. package/dist/stores/file/ledger-tuning.js +21 -0
  484. package/dist/stores/file/mailbox-store.js +42 -22
  485. package/dist/stores/file/memory-store.js +3 -2
  486. package/dist/stores/file/permission-rule-adopt.js +24 -21
  487. package/dist/stores/file/permission-rule-store.js +6 -3
  488. package/dist/stores/file/session-policy-store.js +3 -2
  489. package/dist/stores/file/session-store.d.ts +26 -7
  490. package/dist/stores/file/session-store.js +59 -35
  491. package/dist/stores/file/tool-result-store.d.ts +11 -0
  492. package/dist/stores/file/tool-result-store.js +57 -3
  493. package/dist/stores/file/usage-window-store.js +3 -2
  494. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  495. package/dist/stores/file/workflow-journal-store.js +3 -18
  496. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  497. package/dist/stores/file/workflow-run-store.js +15 -10
  498. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  499. package/dist/tools/fs/bash-program-position.js +7 -7
  500. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  501. package/dist/tools/fs/dead-cwd.js +4 -11
  502. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  503. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  504. package/dist/tools/fs/fs-bash.d.ts +3 -18
  505. package/dist/tools/fs/fs-bash.js +37 -124
  506. package/dist/tools/fs/fs-pdf.js +8 -6
  507. package/dist/tools/fs/fs-read.js +2 -2
  508. package/dist/tools/fs/fs-shared.d.ts +28 -3
  509. package/dist/tools/fs/fs-shared.js +15 -0
  510. package/dist/tools/fs/index.d.ts +1 -1
  511. package/dist/tools/fs/index.js +4 -14
  512. package/dist/tools/fs/pdf.d.ts +4 -4
  513. package/dist/tools/fs/pdf.js +6 -6
  514. package/dist/tools/fs/read-deny-home.js +8 -1
  515. package/dist/tools/fs/read-deny.d.ts +26 -2
  516. package/dist/tools/fs/read-deny.js +9 -2
  517. package/dist/tools/fs/read-floor.d.ts +13 -5
  518. package/dist/tools/fs/read-floor.js +206 -2
  519. package/dist/tools/fs/removal-targets.js +2 -2
  520. package/dist/tools/fs/search.d.ts +3 -2
  521. package/dist/tools/fs/search.js +6 -6
  522. package/dist/tools/fs/shell-read-argv.d.ts +4 -2
  523. package/dist/tools/fs/shell-read-argv.js +14 -3
  524. package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
  525. package/dist/tools/fs/shell-read-bindings.js +148 -68
  526. package/dist/tools/fs/shell-read-check.js +20 -4
  527. package/dist/tools/fs/shell-read-establish.js +25 -9
  528. package/dist/tools/fs/shell-read-functions.js +2 -2
  529. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  530. package/dist/tools/fs/shell-read-identity.js +4 -2
  531. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  532. package/dist/tools/fs/shell-read-judge.js +1 -1
  533. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  534. package/dist/tools/fs/shell-read-object-path.js +119 -0
  535. package/dist/tools/fs/shell-read-plan.d.ts +8 -0
  536. package/dist/tools/fs/shell-read-plan.js +47 -30
  537. package/dist/tools/fs/shell-read-start.d.ts +66 -13
  538. package/dist/tools/fs/shell-read-start.js +89 -17
  539. package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
  540. package/dist/tools/fs/shell-read-workdir.js +31 -8
  541. package/dist/tools/monitor.d.ts +8 -7
  542. package/dist/tools/monitor.js +12 -10
  543. package/dist/tools/worktree.d.ts +5 -1
  544. package/dist/tools/worktree.js +20 -17
  545. package/package.json +6 -3
  546. package/test/export-surface.snapshot.json +112 -42
  547. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  548. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  549. package/wire-changes/core@7.61.0.json +4405 -0
  550. package/wire-changes/core@7.62.0.json +2181 -0
  551. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  552. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  553. package/wire-changes/primitives@7.61.0.json +30 -0
  554. package/wire-changes/primitives@7.62.0.json +30 -0
  555. package/dist/core/consolidate-scope.d.ts +0 -93
  556. package/dist/core/consolidate-scope.js +0 -98
  557. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  558. package/dist/core/runner/image-removed-seat.js +0 -19
  559. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  560. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -40,25 +40,37 @@ export function createPeerHeldQueue(key, opts = {}) {
40
40
  catch {
41
41
  }
42
42
  };
43
- const clearDeadline = (seq) => {
44
- const h = deadlines.get(seq);
43
+ const clearDeadline = (entry) => {
44
+ const h = deadlines.get(entry.seq);
45
45
  if (h !== undefined) {
46
46
  clock.clearTimeout(h);
47
- deadlines.delete(seq);
47
+ deadlines.delete(entry.seq);
48
48
  }
49
+ delete entry.deadlineAt;
49
50
  };
50
51
  const remove = (entry) => {
51
52
  const i = entries.indexOf(entry);
52
53
  if (i !== -1)
53
54
  entries.splice(i, 1);
54
- clearDeadline(entry.seq);
55
+ clearDeadline(entry);
56
+ };
57
+ const sendReceipt = (sink, entry, state) => {
58
+ let landed;
59
+ try {
60
+ landed = Promise.resolve(sink.receipt(entry, state));
61
+ }
62
+ catch (e) {
63
+ landed = Promise.reject(e);
64
+ }
65
+ landed.catch(() => undefined);
66
+ return landed;
55
67
  };
56
68
  const leave = (entry, settlement, reason, receipt) => {
57
69
  const sink = sinkOrThrow();
58
70
  remove(entry);
59
- if (receipt !== undefined)
60
- safe(() => sink.receipt(entry, receipt));
71
+ const landed = receipt !== undefined ? sendReceipt(sink, entry, receipt) : undefined;
61
72
  safe(() => sink.onSettled?.(entry, settlement, reason, entries.length));
73
+ return landed;
62
74
  };
63
75
  const move = async (entry, next) => {
64
76
  const sink = sinkOrThrow();
@@ -78,13 +90,17 @@ export function createPeerHeldQueue(key, opts = {}) {
78
90
  const adoptCurrent = (entry, current) => {
79
91
  if (!entries.includes(entry))
80
92
  return;
81
- if (current === "gone" || current === "unset")
82
- return leave(entry, "retired", "superseded", undefined);
83
- if (isMailboxDecisionFinal(current))
84
- return leave(entry, current, "decided_elsewhere", undefined);
93
+ if (current === "gone" || current === "unset") {
94
+ leave(entry, "retired", "superseded", undefined);
95
+ return;
96
+ }
97
+ if (isMailboxDecisionFinal(current)) {
98
+ leave(entry, current, "decided_elsewhere", undefined);
99
+ return;
100
+ }
85
101
  if (isMailboxDecisionDeliverable(current) && entry.decision !== current) {
86
102
  entry.decision = current;
87
- clearDeadline(entry.seq);
103
+ clearDeadline(entry);
88
104
  }
89
105
  };
90
106
  const settleLocal = async (entry, settlement, reason) => {
@@ -97,13 +113,16 @@ export function createPeerHeldQueue(key, opts = {}) {
97
113
  tells = false;
98
114
  }
99
115
  const from = settlement === "expired" ? "held" : "delivered";
100
- if (!tells || entry.decision !== from)
101
- return leave(entry, "retired", reason, undefined);
116
+ if (!tells || entry.decision !== from) {
117
+ leave(entry, "retired", reason, undefined);
118
+ return {};
119
+ }
102
120
  const r = await move(entry, settlement);
103
121
  if (r === "won")
104
- leave(entry, settlement, reason, settlement);
105
- else if (r === "fault")
122
+ return { landed: leave(entry, settlement, reason, settlement) };
123
+ if (r === "fault")
106
124
  leave(entry, "retired", reason, undefined);
125
+ return {};
107
126
  };
108
127
  const armDeadline = (entry) => {
109
128
  if (cfg === undefined || cfg.dialogExpiryMs === null || deadlines.has(entry.seq))
@@ -112,8 +131,9 @@ export function createPeerHeldQueue(key, opts = {}) {
112
131
  return;
113
132
  if (!PEER_HELD_REVIEW_CAUSES.includes(entry.cause))
114
133
  return;
134
+ entry.deadlineAt = clock.now() + cfg.dialogExpiryMs;
115
135
  const h = clock.setTimeout(() => {
116
- deadlines.delete(entry.seq);
136
+ clearDeadline(entry);
117
137
  void (async () => {
118
138
  if (!entries.includes(entry))
119
139
  return;
@@ -150,7 +170,7 @@ export function createPeerHeldQueue(key, opts = {}) {
150
170
  if (r === "fault")
151
171
  return "no_leg";
152
172
  entry.decision = "delivered";
153
- clearDeadline(entry.seq);
173
+ clearDeadline(entry);
154
174
  }
155
175
  try {
156
176
  if (sink.inject(entry) === "deferred")
@@ -191,7 +211,7 @@ export function createPeerHeldQueue(key, opts = {}) {
191
211
  if (verdict.verdict === "hold" && verdict.cause !== entry.cause) {
192
212
  entry.cause = verdict.cause;
193
213
  reannounce.push([entry, verdict.cause]);
194
- clearDeadline(entry.seq);
214
+ clearDeadline(entry);
195
215
  armDeadline(entry);
196
216
  }
197
217
  return "held";
@@ -253,7 +273,7 @@ export function createPeerHeldQueue(key, opts = {}) {
253
273
  cfg = next;
254
274
  for (const entry of entries) {
255
275
  if (next.dialogExpiryMs === null)
256
- clearDeadline(entry.seq);
276
+ clearDeadline(entry);
257
277
  else
258
278
  armDeadline(entry);
259
279
  }
@@ -266,8 +286,10 @@ export function createPeerHeldQueue(key, opts = {}) {
266
286
  cfg = { ...cfg, sink: rest };
267
287
  },
268
288
  configured: () => cfg !== undefined,
269
- async hold(input, known) {
289
+ async hold(held, known) {
270
290
  const sink = sinkOrThrow();
291
+ const { deadlineAt: _callerDeadline, ...input } = held;
292
+ void _callerDeadline;
271
293
  if (entries.some((e) => e.box === input.box && e.seq === input.seq))
272
294
  return "adopted";
273
295
  let state = known ?? "held";
@@ -294,7 +316,7 @@ export function createPeerHeldQueue(key, opts = {}) {
294
316
  return fresh ? "held" : "adopted";
295
317
  if (!(await makeRoom())) {
296
318
  if (fresh)
297
- safe(() => sink.receipt({ ...input, heldAt: clock.now(), decision: state }, "held"));
319
+ void sendReceipt(sink, { ...input, heldAt: clock.now(), decision: state }, "held");
298
320
  return "uncarded";
299
321
  }
300
322
  const entry = { ...input, heldAt: clock.now(), decision: state };
@@ -303,7 +325,7 @@ export function createPeerHeldQueue(key, opts = {}) {
303
325
  if (state === "held")
304
326
  safe(() => sink.onHeld?.(entry, entries.length, entry.cause, false));
305
327
  if (fresh)
306
- safe(() => sink.receipt(entry, "held"));
328
+ void sendReceipt(sink, entry, "held");
307
329
  return fresh ? "held" : "adopted";
308
330
  },
309
331
  rejudge,
@@ -322,12 +344,25 @@ export function createPeerHeldQueue(key, opts = {}) {
322
344
  deadlines.clear();
323
345
  return;
324
346
  }
347
+ const owed = [];
325
348
  for (const entry of [...entries]) {
326
349
  await onCard(entry.seq, async () => {
327
- if (entries.includes(entry))
328
- await settleLocal(entry, "expired", "shutdown");
350
+ if (!entries.includes(entry))
351
+ return;
352
+ const { landed } = await settleLocal(entry, "expired", "shutdown");
353
+ if (landed !== undefined)
354
+ owed.push({ seq: entry.seq, landed });
329
355
  });
330
356
  }
357
+ const outcomes = await Promise.allSettled(owed.map((o) => o.landed));
358
+ const unlanded = [];
359
+ outcomes.forEach((outcome, i) => {
360
+ if (outcome.status === "rejected")
361
+ unlanded.push({ seq: owed[i].seq, reason: outcome.reason });
362
+ });
363
+ if (unlanded.length > 0) {
364
+ throw new AggregateError(unlanded.map((u) => u.reason), `PeerHeldQueue.shutdown: every held card was settled, but the expired receipt of seq ${unlanded.map((u) => u.seq).join(", ")} did not reach its sender's box`);
365
+ }
331
366
  },
332
367
  };
333
368
  async function settleCard(seq, decision) {
@@ -371,7 +406,7 @@ export function createPeerHeldQueue(key, opts = {}) {
371
406
  if (r === "lost")
372
407
  return "decided_elsewhere";
373
408
  entry.decision = "approved";
374
- clearDeadline(entry.seq);
409
+ clearDeadline(entry);
375
410
  }
376
411
  if (verdict === undefined)
377
412
  return "released_pending";
@@ -386,25 +421,35 @@ export function createPeerHeldQueue(key, opts = {}) {
386
421
  });
387
422
  return queue;
388
423
  }
424
+ function peerHeldQueueSeat(scope, sessionId, box) {
425
+ const own = peerSessionBoxHandle(sessionId);
426
+ const at = box ?? own;
427
+ return { scope, sessionId, box: at, key: JSON.stringify(at === own ? [scope, own] : [scope, own, at]) };
428
+ }
389
429
  const heldQueues = new Map();
390
430
  export function peerHeldQueueKey(scope, sessionId, box) {
391
- const own = peerSessionBoxHandle(sessionId);
392
- return JSON.stringify(box === undefined || box === own ? [scope, own] : [scope, own, box]);
431
+ return peerHeldQueueSeat(scope, sessionId, box).key;
393
432
  }
394
433
  export function peerHeldQueueFor(scope, sessionId, opts = {}) {
395
- const key = peerHeldQueueKey(scope, sessionId, opts.box);
396
- let q = heldQueues.get(key);
397
- if (q === undefined) {
398
- q = createPeerHeldQueue(key, opts);
399
- heldQueues.set(key, q);
434
+ const seat = peerHeldQueueSeat(scope, sessionId, opts.box);
435
+ let row = heldQueues.get(seat.key);
436
+ if (row === undefined) {
437
+ row = { seat, queue: createPeerHeldQueue(seat.key, opts) };
438
+ heldQueues.set(seat.key, row);
400
439
  }
401
- return q;
440
+ return row.queue;
402
441
  }
403
442
  export function peerHeldQueueIfAny(scope, sessionId, box) {
404
- return heldQueues.get(peerHeldQueueKey(scope, sessionId, box));
443
+ return heldQueues.get(peerHeldQueueKey(scope, sessionId, box))?.queue;
444
+ }
445
+ export function listPeerHeldQueues() {
446
+ return [...heldQueues.values()].map(({ seat, queue }) => {
447
+ const entries = queue.list();
448
+ return { scope: seat.scope, sessionId: seat.sessionId, box: seat.box, size: entries.length, entries };
449
+ });
405
450
  }
406
451
  export function resetPeerHeldQueuesForTests() {
407
- for (const q of heldQueues.values())
408
- crashHandlers.get(q)?.();
452
+ for (const { queue } of heldQueues.values())
453
+ crashHandlers.get(queue)?.();
409
454
  heldQueues.clear();
410
455
  }
@@ -20,7 +20,7 @@ export interface PeerNoticeRoute {
20
20
  }
21
21
  /** A delivery RECEIPT to the sender of one message this session judged (held / expired / delivered /
22
22
  * refused / denied). `refSeq` = the seq of the sender's message in THIS session's box. */
23
- export declare function routePeerDeliveryReceipt(route: PeerNoticeRoute, toSession: string, state: Exclude<PeerDeliveryReceiptState, "dropped">, refSeq: number): Promise<boolean>;
23
+ export declare function routePeerDeliveryReceipt(route: PeerNoticeRoute, toSession: string, state: Exclude<PeerDeliveryReceiptState, "dropped">, refSeq: number, detail?: string): Promise<boolean>;
24
24
  /** A `dropped` receipt (the ingress guard's arm). */
25
25
  export declare function routePeerDroppedReceipt(route: PeerNoticeRoute, toSession: string, refSeq: number, dropReason?: PeerDropReason): Promise<boolean>;
26
26
  /** An idle NOTICE to a requester (`idle` / `exited` / `unavailable` from the target; `expired` from the
@@ -28,10 +28,11 @@ async function appendNotice(route, toSession, content, peerMeta, classification)
28
28
  return false;
29
29
  }
30
30
  }
31
- export function routePeerDeliveryReceipt(route, toSession, state, refSeq) {
31
+ export function routePeerDeliveryReceipt(route, toSession, state, refSeq, detail) {
32
32
  const recipient = route.self.name ?? peerSessionBoxHandle(route.self.sessionId);
33
- const notice = { state, refSeq, recipient };
34
- return appendNotice(route, toSession, renderCrossSessionDeliveryNotice(state, 1, [recipient]), noticeMeta(route, "delivery_notice", notice), "peer-receipt-route");
33
+ const said = state === "refused" && detail !== undefined ? peerIdleNoticeLabel(detail) : undefined;
34
+ const notice = { state, refSeq, recipient, ...(said !== undefined ? { detail: said } : {}) };
35
+ return appendNotice(route, toSession, renderCrossSessionDeliveryNotice(state, 1, [recipient], said), noticeMeta(route, "delivery_notice", notice), "peer-receipt-route");
35
36
  }
36
37
  export function routePeerDroppedReceipt(route, toSession, refSeq, dropReason) {
37
38
  const recipient = route.self.name ?? peerSessionBoxHandle(route.self.sessionId);
@@ -65,7 +65,7 @@ export declare function peerRecipientSuffix(recipients: readonly string[]): stri
65
65
  * CC `y$e` — the model-face delivery receipt for the five non-drop states. `count` folds several
66
66
  * receipts of one state into one line (the requester's drain may fold; a single record renders as 1).
67
67
  */
68
- export declare function renderCrossSessionDeliveryNotice(state: Exclude<PeerDeliveryReceiptState, "dropped">, count: number, recipients?: readonly string[]): string;
68
+ export declare function renderCrossSessionDeliveryNotice(state: Exclude<PeerDeliveryReceiptState, "dropped">, count: number, recipients?: readonly string[], detail?: string): string;
69
69
  /** CC `S$e` — the drop reasons, rendered. */
70
70
  export declare function describePeerDropReasons(reasons: readonly (PeerDropReason | undefined)[]): string;
71
71
  /** CC `b$e` — the model-face receipt for messages DROPPED at the recipient's ingress guard. */
@@ -79,9 +79,9 @@ export declare function isPeerIdleNoticeKind(v: unknown): v is PeerIdleNoticeKin
79
79
  export declare const PEER_IDLE_UNAVAILABLE_CAUSES = "it is shutting down, its subscription table is full, a newer subscription displaced this one, or it answered in a form this version does not recognize";
80
80
  /**
81
81
  * CC `nYt` — a label or detail line made safe for the notice text: format/control characters and the
82
- * envelope-ish punctuation (`<>«»"[]`) become spaces, whitespace collapses, the notice's own prefix
83
- * phrase cannot be smuggled in, and the result is capped at {@link PEER_IDLE_LABEL_MAX}. `undefined`
84
- * when nothing printable is left.
82
+ * envelope-ish punctuation (`<>«»"[]`) become spaces, whitespace collapses, neither notice's own prefix
83
+ * phrase can be smuggled in (the idle notice's, and the delivery notice's a `refused` receipt's detail
84
+ * rides), and the result is capped at {@link PEER_IDLE_LABEL_MAX}. `undefined` when nothing printable is left.
85
85
  */
86
86
  export declare function peerIdleNoticeLabel(raw: string): string | undefined;
87
87
  export interface PeerIdleNoticeFields {
@@ -33,7 +33,7 @@ export function peerRecipientSuffix(recipients) {
33
33
  return ` (recipient: ${uniq[0]})`;
34
34
  return ` (recipients: ${uniq.slice(0, 3).join(", ")}${uniq.length > 3 ? ", …" : ""})`;
35
35
  }
36
- export function renderCrossSessionDeliveryNotice(state, count, recipients = []) {
36
+ export function renderCrossSessionDeliveryNotice(state, count, recipients = [], detail) {
37
37
  const n = Math.max(1, Math.floor(count));
38
38
  const P = n === 1 ? "Your message to another session" : `${n} of your messages to another session`;
39
39
  const J = n === 1 ? "was" : "were";
@@ -47,8 +47,12 @@ export function renderCrossSessionDeliveryNotice(state, count, recipients = [])
47
47
  return `[Cross-session delivery notice] ${P} ${J} not approved before expiry${R}. Not delivered to that session's assistant. Do not wait for a reply; continue, or choose another approach.`;
48
48
  case "delivered":
49
49
  return `[Cross-session delivery notice] ${P} ${J} approved and released to that session${R}.`;
50
- case "refused":
51
- return `[Cross-session delivery notice] ${P} ${J} refused${R}: that session is not accepting cross-session messages (the feature is off there, or a setting or policy there refuses them). Not delivered to that session's assistant. Do not wait for a reply and do not resend; tell the user, or choose another approach.`;
50
+ case "refused": {
51
+ const said = detail !== undefined ? peerIdleNoticeLabel(detail) : undefined;
52
+ return said !== undefined
53
+ ? `[Cross-session delivery notice] ${P} ${J} refused${R} by ${said}. Not delivered to that session's assistant. Do not wait for a reply and do not resend; tell the user, or choose another approach.`
54
+ : `[Cross-session delivery notice] ${P} ${J} refused${R}: that session is not accepting cross-session messages (the feature is off there, or a setting or policy there refuses them). Not delivered to that session's assistant. Do not wait for a reply and do not resend; tell the user, or choose another approach.`;
55
+ }
52
56
  default: {
53
57
  const _exhaustive = state;
54
58
  void _exhaustive;
@@ -98,7 +102,7 @@ export function peerIdleNoticeLabel(raw) {
98
102
  .replace(/[\p{Cc}\p{Cf}<>«»"[\]]/gu, " ")
99
103
  .replace(/[\s\p{Z}]+/gu, " ");
100
104
  for (;;) {
101
- const r = t.replace(/cross-session idle notice/giu, " ").replace(/ {2,}/g, " ");
105
+ const r = t.replace(/cross-session (?:idle|delivery) notice/giu, " ").replace(/ {2,}/g, " ");
102
106
  if (r === t)
103
107
  break;
104
108
  t = r;
@@ -1,5 +1,5 @@
1
1
  import { type MailboxCrossProcessVerdict, type MailboxStore } from "../core/mailbox-store.js";
2
- import { type SessionBoxBinding, type SystemInjectionPriority, type TaskNotificationPayload } from "../core/task-notification.js";
2
+ import { type FrameReceiver, type SessionBoxBinding, type SystemInjectionPriority, type TaskNotificationPayload } from "../core/task-notification.js";
3
3
  import { type FrameSettlement } from "../core/frame-settlement.js";
4
4
  import { type EngineNotice, type RunnerDeps } from "../core/types.js";
5
5
  import { type PermissionModeClass } from "./cross-session-envelope.js";
@@ -140,6 +140,11 @@ export interface PeerSessionDrainOptions {
140
140
  * private one, which is honest but inert: nothing fills it, so every delivered record waits for a
141
141
  * receipt that never comes and stays parked (at-least-once). Every production binding supplies it. */
142
142
  settlement?: FrameSettlement;
143
+ /** The leg's receiving station (`session.receive`): every record the PULL face hands back passes it first, and a
144
+ * record it consumed is settled as that decision (its sender told `refused`). A record the drain injects passes it on
145
+ * the live lane, which answers a consume through the settlement seam ({@link FrameSettlement.consumed}). Absent ⇒ no
146
+ * station: every record is handed over as made. */
147
+ receive?: FrameReceiver;
143
148
  leaseTtlMs?: number;
144
149
  /** Tests: a virtual clock for the held deadlines and idle timers (honored when this process first sees the session). */
145
150
  clock?: PeerClock;
@@ -318,6 +323,8 @@ export declare function bindPeerLaneDrain(harness: PeerDrainHarness, args: {
318
323
  /** #1036 — the leg's settlement seam (receipts + compaction effects), minted by the
319
324
  * orchestrator and shared with the harness sink and the compaction commit beat. */
320
325
  settlement?: FrameSettlement;
326
+ /** The leg's receiving station ({@link PeerSessionDrainOptions.receive}). */
327
+ receive?: FrameReceiver;
321
328
  selfName?: () => string | undefined;
322
329
  parked?: () => boolean;
323
330
  lastTurnText?: () => string | undefined;
@@ -147,14 +147,31 @@ export function createPeerSessionDrain(opts) {
147
147
  _sema_provenance: { kind: "cross_session_notice", from: encodePeerAddress(storedSessionAddress(m.peerMeta?.fromSession) ?? (m.from ?? "unknown")), taskId: boxHandle, seq: m.seq, ...(m.peerMeta !== undefined ? { peerMeta: { ...m.peerMeta } } : {}) },
148
148
  });
149
149
  const receiptAddress = (lane, entry) => (lane.kind === "session" ? entry.peerMeta?.fromSession : undefined);
150
- const receipt = (lane) => (entry, state) => {
150
+ const receipt = (lane) => async (entry, state) => {
151
151
  const to = receiptAddress(lane, entry);
152
152
  if (to === undefined)
153
153
  return;
154
+ const faults = [];
155
+ const via = {
156
+ ...route(),
157
+ onError: (error, ctx) => {
158
+ faults.push(error);
159
+ opts.onError?.(error, ctx);
160
+ },
161
+ };
154
162
  if (state === "dropped")
155
- void routePeerDroppedReceipt(route(), to, entry.seq);
163
+ await routePeerDroppedReceipt(via, to, entry.seq);
156
164
  else
157
- void routePeerDeliveryReceipt(route(), to, state, entry.seq);
165
+ await routePeerDeliveryReceipt(via, to, state, entry.seq);
166
+ if (faults.length > 0)
167
+ throw faults[0];
168
+ };
169
+ const settleConsumed = (lane, seq, payload, by, reason) => {
170
+ lane.ledger.set(seq, { kind: "terminal", why: "consumed" });
171
+ const peerMeta = payload._sema_provenance?.kind === "cross_session_message" ? payload._sema_provenance.peerMeta : undefined;
172
+ const to = peerMeta !== undefined ? receiptAddress(lane, { peerMeta }) : undefined;
173
+ if (to !== undefined)
174
+ void routePeerDeliveryReceipt(route(), to, "refused", seq, by === "engine" ? "the receiving engine (it could not judge the message)" : `extension ${by} of that session: ${reason}`);
158
175
  };
159
176
  const heldSink = (lane, live) => ({
160
177
  judge: (entry) => judgeMeta(readFacts(), entry.peerMeta),
@@ -164,6 +181,10 @@ export function createPeerSessionDrain(opts) {
164
181
  if (currentRound === undefined || !currentRound.holds(lane))
165
182
  return "deferred";
166
183
  const payload = buildPeerMessagePayload(lane, entry);
184
+ if (currentRound.out !== undefined && opts.receive?.listens() === true) {
185
+ currentRound.batch.push({ lane, payload, priority: "next", urgent: false, seq: entry.seq, attempt: 1 });
186
+ return undefined;
187
+ }
167
188
  if (currentRound.deliver(payload, "next") === "deferred")
168
189
  return "deferred";
169
190
  noteDelivered(lane, entry.seq, 1, payload, currentRound.carrier);
@@ -253,7 +274,7 @@ export function createPeerSessionDrain(opts) {
253
274
  return true;
254
275
  return false;
255
276
  };
256
- const noteDelivered = (lane, seq, attempt, payload, carrier) => {
277
+ const noteDelivered = (lane, seq, attempt, payload, carrier, shown = payload) => {
257
278
  const own = taskNotificationDedupKey(payload);
258
279
  const key = carrier === undefined ? own : `${carrier}|${own}`;
259
280
  lane.ledger.set(seq, { kind: "delivered", attempt, key, payload });
@@ -266,7 +287,7 @@ export function createPeerSessionDrain(opts) {
266
287
  opts.onError?.(e, { phase: "degraded", sessionId, classification: "peer-external-mark" });
267
288
  }
268
289
  }
269
- seam.awaiting.set(key, carrier === undefined ? { carrier: own } : { carrier, frameText: renderTaskNotificationXml(payload) });
290
+ seam.awaiting.set(key, carrier === undefined ? { carrier: own } : { carrier, frameText: renderTaskNotificationXml(shown) });
270
291
  };
271
292
  const deriveAckPrefix = (lane, messages) => {
272
293
  let prefix;
@@ -287,10 +308,16 @@ export function createPeerSessionDrain(opts) {
287
308
  const settleLaneLocally = (lane, landed) => {
288
309
  const { ledger, boxHandle } = lane;
289
310
  const hostWithheldSeqs = [];
290
- if (seam.receipts.size > 0 || seam.withheld.size > 0 || seam.hostWithheld.size > 0) {
311
+ if (seam.receipts.size > 0 || seam.withheld.size > 0 || seam.hostWithheld.size > 0 || seam.consumed.size > 0) {
291
312
  for (const [seq, d] of ledger) {
292
313
  if (d.kind !== "delivered")
293
314
  continue;
315
+ const consumed = seam.consumed.get(d.key);
316
+ if (consumed !== undefined) {
317
+ seam.consumed.delete(d.key);
318
+ settleConsumed(lane, seq, d.payload, consumed.by, consumed.reason);
319
+ continue;
320
+ }
294
321
  if (seam.hostWithheld.delete(d.key)) {
295
322
  ledger.set(seq, { kind: "terminal", why: "host_withheld" });
296
323
  hostWithheldSeqs.push(seq);
@@ -311,7 +338,7 @@ export function createPeerSessionDrain(opts) {
311
338
  }
312
339
  }
313
340
  if (hostWithheldSeqs.length > 0) {
314
- opts.onError?.(new Error(`${hostWithheldSeqs.length} cross-session message frame(s) (seq ${hostWithheldSeqs.join(", ")}) could not be found in this session's ReadInbox result as a postToolUse hook rewrote it (removed, truncated or reshaped beyond whitespace) — settled as the host's decision: they leave ${boxHandle} and are not handed over again`), { phase: "degraded", sessionId, classification: "peer-inbox-host-withheld" });
341
+ opts.onError?.(new Error(`${hostWithheldSeqs.length} cross-session message frame(s) (seq ${hostWithheldSeqs.join(", ")}) could not be found in this session's ReadInbox result as the host side rewrote it (a postToolUse hook or an extension's session.append handler: removed, truncated or reshaped beyond whitespace) — settled as the host's decision: they leave ${boxHandle} and are not handed over again`), { phase: "degraded", sessionId, classification: "peer-inbox-host-withheld" });
315
342
  }
316
343
  for (const effect of landed) {
317
344
  for (const [seq, d] of ledger) {
@@ -373,7 +400,7 @@ export function createPeerSessionDrain(opts) {
373
400
  else {
374
401
  const state = notice.state;
375
402
  const recipients = [notice.recipient ?? m.from ?? ""];
376
- text = state === "dropped" ? renderCrossSessionDroppedNotice(1, recipients, [notice.dropReason]) : renderCrossSessionDeliveryNotice(state, 1, recipients);
403
+ text = state === "dropped" ? renderCrossSessionDroppedNotice(1, recipients, [notice.dropReason]) : renderCrossSessionDeliveryNotice(state, 1, recipients, notice.detail);
377
404
  }
378
405
  const judged = judgeMeta(facts, meta);
379
406
  if (judged.verdict === "refuse") {
@@ -647,15 +674,26 @@ export function createPeerSessionDrain(opts) {
647
674
  finally {
648
675
  const ordered = round.batch.splice(0).sort((a, b) => Number(b.urgent) - Number(a.urgent));
649
676
  for (const item of ordered) {
677
+ let shown = item.payload;
678
+ if (round.out !== undefined && opts.receive?.listens() === true) {
679
+ if (round.spent)
680
+ continue;
681
+ const verdict = await opts.receive.receive(item.payload);
682
+ if (verdict.kind === "consumed") {
683
+ settleConsumed(item.lane, item.seq, item.payload, verdict.by, verdict.reason);
684
+ continue;
685
+ }
686
+ shown = verdict.payload;
687
+ }
650
688
  try {
651
- if (round.deliver(item.payload, item.priority) === "deferred")
689
+ if (round.deliver(shown, item.priority) === "deferred")
652
690
  continue;
653
691
  }
654
692
  catch (e) {
655
693
  opts.onError?.(e, { phase: "degraded", sessionId, classification: "peer-box-inject" });
656
694
  break;
657
695
  }
658
- noteDelivered(item.lane, item.seq, item.attempt, item.payload, round.carrier);
696
+ noteDelivered(item.lane, item.seq, item.attempt, item.payload, round.carrier, shown);
659
697
  }
660
698
  }
661
699
  for (const { lane, lease } of leased) {
@@ -872,6 +910,7 @@ export function bindPeerLaneDrain(harness, args) {
872
910
  selfName: () => rowName ?? args.selfName?.(),
873
911
  warmup: lookupRowName,
874
912
  ...(args.settlement !== undefined ? { settlement: args.settlement } : {}),
913
+ ...(args.receive !== undefined ? { receive: args.receive } : {}),
875
914
  ...(args.parked !== undefined ? { parked: args.parked } : {}),
876
915
  ...(args.lastTurnText !== undefined ? { lastTurnText: args.lastTurnText } : {}),
877
916
  ...(args.markExternalContent !== undefined ? { markExternalContent: args.markExternalContent } : {}),
@@ -1,7 +1,9 @@
1
1
  import { isDurablePause, pauseFamily } from "./suspend-guard.js";
2
2
  import { delimitUntrusted, sanitizeUntrustedText } from "../core/untrusted-text.js";
3
+ import { recipeContinuationLeg } from "../core/input-author.js";
3
4
  import { assertOracleIsolation } from "../core/oracle-isolation.js";
4
5
  import { buildCumulativeStats } from "./cumulative-stats.js";
6
+ import { laterLegAllowance } from "./composition-allowance.js";
5
7
  export function isolationPermitsAutoAccept(verdict) {
6
8
  return verdict.protected && verdict.isolationClass === "out_of_process";
7
9
  }
@@ -154,8 +156,11 @@ export async function runRepairLoop(runner, implSpec, config) {
154
156
  });
155
157
  let restartedOnce = false;
156
158
  let restartUsed = false;
159
+ let firstAttempt = true;
160
+ let laterAttemptSpec = implSpec;
161
+ const ownSpend = () => ({ costMicroUsd: anyAttemptUnpriced ? undefined : ownCostMicro, tokens: ownTokens, turns: ownTurns });
157
162
  const cleanRestartSpec = () => {
158
- const { sessionId: _drop, ...rest } = implSpec;
163
+ const { sessionId: _drop, ...rest } = laterAttemptSpec;
159
164
  return { ...rest, objective: `${implSpec.objective}\n\n${repairObjective(bundle)}` };
160
165
  };
161
166
  const exhaustedBeforeDispatch = (message, errorCode) => ({
@@ -188,7 +193,7 @@ export async function runRepairLoop(runner, implSpec, config) {
188
193
  const spec = restartedOnce
189
194
  ? cleanRestartSpec()
190
195
  : isRepair
191
- ? { ...implSpec, sessionId: lastResult.sessionId, objective: repairObjective(bundle) }
196
+ ? { ...laterAttemptSpec, sessionId: lastResult.sessionId, objective: repairObjective(bundle) }
192
197
  : isSeededResume
193
198
  ? {
194
199
  ...implSpec,
@@ -200,10 +205,11 @@ export async function runRepairLoop(runner, implSpec, config) {
200
205
  liveStamp.unref?.();
201
206
  let result;
202
207
  try {
203
- result = await runner.runTask(spec, { repairBundle: bundle });
208
+ result = await runner.runTask(spec, firstAttempt ? { repairBundle: bundle } : recipeContinuationLeg({ repairBundle: bundle }));
204
209
  }
205
210
  finally {
206
211
  clearInterval(liveStamp);
212
+ firstAttempt = false;
207
213
  }
208
214
  spend += (result.stats.costMicroUsd ?? 0) + (result.stats.nested?.costMicroUsd ?? 0);
209
215
  stampAccount();
@@ -258,8 +264,12 @@ export async function runRepairLoop(runner, implSpec, config) {
258
264
  }
259
265
  const overTime = config.totalTimeoutMs != null && priorActiveMs + (Date.now() - startedAt) >= config.totalTimeoutMs;
260
266
  const overCost = config.costCeilingMicroUsd != null && spend >= config.costCeilingMicroUsd;
261
- if (bundle.attemptCount >= maxAttempts || overTime || overCost) {
262
- if (bundle.attemptCount >= maxAttempts && !overTime && !overCost && lastResult !== undefined && !restartUsed) {
267
+ const allowance = laterLegAllowance(implSpec, ownSpend());
268
+ if (allowance.spec !== undefined)
269
+ laterAttemptSpec = allowance.spec;
270
+ const overAllowance = allowance.exhausted;
271
+ if (bundle.attemptCount >= maxAttempts || overTime || overCost || overAllowance !== undefined) {
272
+ if (bundle.attemptCount >= maxAttempts && !overTime && !overCost && overAllowance === undefined && lastResult !== undefined && !restartUsed) {
263
273
  restartUsed = true;
264
274
  restartedOnce = true;
265
275
  continue;
@@ -272,7 +282,7 @@ export async function runRepairLoop(runner, implSpec, config) {
272
282
  bundle,
273
283
  ...(isolationClass ? { isolationClass } : {}),
274
284
  oracleCostMicroUsd,
275
- verification: outcomeFor(terminal, lastOracle, bundle.attemptCount),
285
+ verification: { ...outcomeFor(terminal, lastOracle, bundle.attemptCount), ...(overAllowance !== undefined ? { allowanceExhausted: overAllowance } : {}) },
276
286
  };
277
287
  }
278
288
  }
@@ -3,6 +3,8 @@ import { PEER_MESSAGE_NOTICE } from "./peer-admission.js";
3
3
  import { createSafeNotifier } from "../core/safe-notify.js";
4
4
  import { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX } from "../config/defaults.js";
5
5
  import { asThrownError } from "../core/thrown-value.js";
6
+ import { optionKeys, receiveMembers } from "../core/own-property-receipt.js";
7
+ const RETAIN_CONFIG_KEYS = optionKeys()({ ttlMs: 0, max: 0 });
6
8
  export const SUBAGENT_RESUME_CAP = 8;
7
9
  export function holdChildDeclarations(runner, declared) {
8
10
  if (typeof runner.holdDeclarations !== "function") {
@@ -24,7 +26,7 @@ export class SubagentRetainLedger {
24
26
  lastFailure;
25
27
  notifier = createSafeNotifier();
26
28
  constructor(config, hooks) {
27
- const cfg = config === true ? {} : config;
29
+ const cfg = config === true ? {} : receiveMembers(config, { subject: "TaskSpec.retainSubagentSessions", unit: "member", moment: "when the retain ledger is made" }, RETAIN_CONFIG_KEYS);
28
30
  this.ttlMs = cfg.ttlMs ?? RETAIN_DEFAULT_TTL_MS;
29
31
  this.max = cfg.max ?? RETAIN_DEFAULT_MAX;
30
32
  this.hooks = hooks;
@@ -133,7 +133,7 @@ export declare class MemoryRosterStore implements RosterStore {
133
133
  private entries;
134
134
  private readonly maxAgeMs;
135
135
  private readonly gc;
136
- constructor(opts?: RosterGcOptions);
136
+ constructor(options?: RosterGcOptions);
137
137
  record(entry: RosterEntry): void;
138
138
  resolve(name: string, access: RosterAccess): RosterEntry | undefined;
139
139
  list(): RosterEntry[];
@@ -1,6 +1,6 @@
1
1
  import { mkdirSync, readFileSync } from "node:fs";
2
2
  import { assertRetentionPolicy } from "../core/retention-policy.js";
3
- import { receiveOptions } from "../core/own-property-receipt.js";
3
+ import { optionKeys, receiveOptions } from "../core/own-property-receipt.js";
4
4
  import { atomicWriteFile } from "../stores/file/fs-atomic.js";
5
5
  import { dirname } from "node:path";
6
6
  import { normalizeAgentName } from "../core/task-registry.js";
@@ -29,6 +29,8 @@ function resolveIn(entries, name, access) {
29
29
  return undefined;
30
30
  return latestOf(entries.filter((e) => normalizeAgentName(e.name) === key && entryAccessible(e, access)));
31
31
  }
32
+ const ROSTER_GC_OPTION_KEYS = optionKeys()({ onNotifyError: 0, maxAgeMs: 0, maxEntries: 0, onEvicted: 0 });
33
+ const FILE_ROSTER_STORE_OPTION_KEYS = optionKeys()({ onNotifyError: 0, maxAgeMs: 0, maxEntries: 0, onEvicted: 0, onCorruptRead: 0 });
32
34
  function freshOnly(entries, maxAgeMs, now = Date.now()) {
33
35
  if (maxAgeMs === undefined)
34
36
  return entries;
@@ -51,9 +53,10 @@ export class MemoryRosterStore {
51
53
  entries = [];
52
54
  maxAgeMs;
53
55
  gc;
54
- constructor(opts) {
56
+ constructor(options) {
57
+ const opts = receiveOptions(options, "MemoryRosterStore", ROSTER_GC_OPTION_KEYS);
55
58
  assertRetentionPolicy("RosterStore", opts);
56
- this.maxAgeMs = opts?.maxAgeMs;
59
+ this.maxAgeMs = opts.maxAgeMs;
57
60
  this.gc = opts;
58
61
  }
59
62
  record(entry) {
@@ -81,7 +84,7 @@ export class FileRosterStore {
81
84
  gc;
82
85
  onCorruptRead;
83
86
  constructor(path, options) {
84
- const opts = options === undefined ? undefined : receiveOptions(options, "FileRosterStore");
87
+ const opts = receiveOptions(options, "FileRosterStore", FILE_ROSTER_STORE_OPTION_KEYS);
85
88
  assertRetentionPolicy("RosterStore", opts);
86
89
  this.path = path;
87
90
  this.maxAgeMs = opts?.maxAgeMs;