@sema-agent/core 7.56.0 → 7.58.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 (319) hide show
  1. package/CHANGELOG.md +926 -0
  2. package/LICENSE +1 -1
  3. package/dist/agents/org-delivery-gate.js +3 -4
  4. package/dist/agents/peer-held-queue.d.ts +69 -49
  5. package/dist/agents/peer-held-queue.js +255 -106
  6. package/dist/agents/peer-session-drain.js +63 -43
  7. package/dist/agents/send-message-tool.js +3 -2
  8. package/dist/agents/subagent-steps.js +2 -4
  9. package/dist/agents/subagent.js +8 -8
  10. package/dist/brain/anthropic.js +16 -8
  11. package/dist/brain/open-responses.js +10 -8
  12. package/dist/brain/openai.js +11 -9
  13. package/dist/brain/provider-dialect.d.ts +3 -2
  14. package/dist/brain/provider-dialect.js +2 -2
  15. package/dist/brain/request-params.d.ts +6 -0
  16. package/dist/brain/request-params.js +14 -1
  17. package/dist/brain/route-adjudicator.js +2 -1
  18. package/dist/brain/stream-engine.d.ts +9 -0
  19. package/dist/brain/stream-engine.js +24 -10
  20. package/dist/brain/stream-shared.d.ts +5 -4
  21. package/dist/brain/stream-shared.js +4 -4
  22. package/dist/core/a2a.d.ts +2 -1
  23. package/dist/core/a2a.js +23 -10
  24. package/dist/core/allow-entry.d.ts +5 -11
  25. package/dist/core/allow-entry.js +19 -26
  26. package/dist/core/approval-object.d.ts +21 -5
  27. package/dist/core/approval-object.js +44 -17
  28. package/dist/core/ask-origin.d.ts +23 -4
  29. package/dist/core/ask-origin.js +5 -1
  30. package/dist/core/auto-compaction.d.ts +75 -6
  31. package/dist/core/auto-compaction.js +43 -27
  32. package/dist/core/auto-mode-directive.d.ts +29 -5
  33. package/dist/core/auto-mode-directive.js +38 -8
  34. package/dist/core/background-agent-store.d.ts +6 -2
  35. package/dist/core/background-agent-store.js +1 -1
  36. package/dist/core/checkpoint-requirements.d.ts +13 -1
  37. package/dist/core/checkpoint-requirements.js +4 -0
  38. package/dist/core/checkpoint-store.d.ts +44 -40
  39. package/dist/core/checkpoint-store.js +32 -14
  40. package/dist/core/cross-boundary-taint.js +4 -2
  41. package/dist/core/engine-notice.d.ts +4 -3
  42. package/dist/core/engine-notice.js +6 -0
  43. package/dist/core/file-history-store.d.ts +14 -8
  44. package/dist/core/file-history-store.js +14 -4
  45. package/dist/core/fs-write-gate-policy.d.ts +4 -2
  46. package/dist/core/fs-write-gate-policy.js +7 -3
  47. package/dist/core/gate-fold.js +6 -3
  48. package/dist/core/gate-lanes.js +13 -5
  49. package/dist/core/git-worktree-env.d.ts +53 -11
  50. package/dist/core/git-worktree-env.js +96 -12
  51. package/dist/core/hooks.d.ts +6 -3
  52. package/dist/core/hooks.js +12 -5
  53. package/dist/core/human-input-projection.d.ts +1 -0
  54. package/dist/core/human-input-projection.js +3 -0
  55. package/dist/core/locked-config.d.ts +15 -1
  56. package/dist/core/locked-config.js +38 -2
  57. package/dist/core/mailbox-store.d.ts +62 -1
  58. package/dist/core/mailbox-store.js +59 -0
  59. package/dist/core/mcp-call-meta.d.ts +66 -0
  60. package/dist/core/mcp-call-meta.js +103 -0
  61. package/dist/core/mcp-connection-pool.d.ts +3 -1
  62. package/dist/core/mcp-connection-pool.js +3 -1
  63. package/dist/core/mcp-failure.d.ts +7 -1
  64. package/dist/core/mcp-failure.js +10 -0
  65. package/dist/core/mcp-name-judge.d.ts +46 -0
  66. package/dist/core/mcp-name-judge.js +61 -0
  67. package/dist/core/mcp-probe.d.ts +5 -1
  68. package/dist/core/mcp-probe.js +3 -6
  69. package/dist/core/mcp-server-link.d.ts +5 -2
  70. package/dist/core/mcp-server-spec.d.ts +46 -18
  71. package/dist/core/mcp-server-spec.js +1 -18
  72. package/dist/core/mcp.d.ts +6 -14
  73. package/dist/core/mcp.js +85 -65
  74. package/dist/core/memory-engine/consolidation-driver.js +4 -3
  75. package/dist/core/memory-engine/distiller.js +26 -17
  76. package/dist/core/memory-engine/layout.js +5 -2
  77. package/dist/core/memory-engine/scope-contract.d.ts +45 -4
  78. package/dist/core/memory-engine/scope-contract.js +80 -11
  79. package/dist/core/mode-policy.d.ts +8 -5
  80. package/dist/core/mode-policy.js +5 -4
  81. package/dist/core/mods/host.js +1 -1
  82. package/dist/core/mods/kernel/dispatch.d.ts +3 -0
  83. package/dist/core/mods/kernel/dispatch.js +10 -8
  84. package/dist/core/mods/kernel/events.d.ts +5 -1
  85. package/dist/core/mods/kernel/events.js +1 -1
  86. package/dist/core/mods/kernel/registration.d.ts +5 -1
  87. package/dist/core/mods/kernel/site-rules.d.ts +3 -0
  88. package/dist/core/mods/kernel/site-rules.js +10 -0
  89. package/dist/core/mods/package.d.ts +23 -0
  90. package/dist/core/mods/package.js +118 -0
  91. package/dist/core/mods/stations.d.ts +2 -2
  92. package/dist/core/mods/stations.js +1 -1
  93. package/dist/core/mods/tool-call.d.ts +5 -1
  94. package/dist/core/mods/tool-call.js +12 -3
  95. package/dist/core/park-selfcheck.js +2 -0
  96. package/dist/core/path-guard-rows.d.ts +20 -0
  97. package/dist/core/path-guard-rows.js +11 -0
  98. package/dist/core/peer-seat.d.ts +186 -0
  99. package/dist/core/peer-seat.js +307 -0
  100. package/dist/core/permission-rule-consent.d.ts +5 -3
  101. package/dist/core/permission-rule-consent.js +20 -15
  102. package/dist/core/permission-rule-model.d.ts +43 -2
  103. package/dist/core/permission-rule-model.js +52 -8
  104. package/dist/core/permission-rule-org.js +1 -1
  105. package/dist/core/present-plan-tool.d.ts +10 -1
  106. package/dist/core/present-plan-tool.js +46 -2
  107. package/dist/core/protocol-http-auth.d.ts +56 -31
  108. package/dist/core/protocol-http-auth.js +71 -42
  109. package/dist/core/protocol-naming.d.ts +20 -0
  110. package/dist/core/protocol-naming.js +20 -3
  111. package/dist/core/read-only-shell.d.ts +20 -5
  112. package/dist/core/read-only-shell.js +29 -14
  113. package/dist/core/redaction-marks.d.ts +16 -0
  114. package/dist/core/redaction-marks.js +16 -0
  115. package/dist/core/redaction-passes.js +8 -9
  116. package/dist/core/remote-env.d.ts +37 -1
  117. package/dist/core/remote-env.js +11 -0
  118. package/dist/core/resume-startup-cause.d.ts +24 -2
  119. package/dist/core/resume-startup-cause.js +20 -1
  120. package/dist/core/retention.d.ts +41 -15
  121. package/dist/core/retention.js +59 -12
  122. package/dist/core/rewrite-rejudge.d.ts +37 -0
  123. package/dist/core/rewrite-rejudge.js +40 -0
  124. package/dist/core/roles.js +50 -7
  125. package/dist/core/run-origin.d.ts +40 -0
  126. package/dist/core/run-origin.js +37 -0
  127. package/dist/core/runner/advertised-writable-dirs.d.ts +57 -38
  128. package/dist/core/runner/advertised-writable-dirs.js +126 -0
  129. package/dist/core/runner/compact-session.d.ts +10 -0
  130. package/dist/core/runner/compact-session.js +202 -0
  131. package/dist/core/runner/compaction-call-options.d.ts +2 -2
  132. package/dist/core/runner/compaction-restate.d.ts +15 -6
  133. package/dist/core/runner/compaction-restate.js +28 -2
  134. package/dist/core/runner/compaction-seams.d.ts +21 -1
  135. package/dist/core/runner/compaction-seams.js +11 -8
  136. package/dist/core/runner/contracts.d.ts +36 -21
  137. package/dist/core/runner/derived-route-fallback.d.ts +13 -0
  138. package/dist/core/runner/derived-route-fallback.js +6 -0
  139. package/dist/core/runner/env-capability-census.d.ts +3 -2
  140. package/dist/core/runner/env-capability-census.js +9 -3
  141. package/dist/core/runner/gate-exit.d.ts +18 -4
  142. package/dist/core/runner/gate-exit.js +5 -1
  143. package/dist/core/runner/permission-rule-lanes.d.ts +7 -7
  144. package/dist/core/runner/permission-rule-lanes.js +17 -11
  145. package/dist/core/runner/prepare-acquire-reconcile.d.ts +3 -0
  146. package/dist/core/runner/prepare-acquire-reconcile.js +2 -1
  147. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  148. package/dist/core/runner/prepare-caps-and-workflow.js +1 -1
  149. package/dist/core/runner/prepare-config-doors.d.ts +14 -5
  150. package/dist/core/runner/prepare-config-doors.js +16 -13
  151. package/dist/core/runner/prepare-delegation-surface.d.ts +4 -0
  152. package/dist/core/runner/prepare-delegation-surface.js +15 -18
  153. package/dist/core/runner/prepare-gate-stations.js +1 -1
  154. package/dist/core/runner/prepare-hands-readface.d.ts +10 -4
  155. package/dist/core/runner/prepare-hands-readface.js +6 -1
  156. package/dist/core/runner/prepare-memory.d.ts +3 -0
  157. package/dist/core/runner/prepare-memory.js +19 -23
  158. package/dist/core/runner/prepare-park-ask.d.ts +2 -0
  159. package/dist/core/runner/prepare-park-ask.js +2 -2
  160. package/dist/core/runner/prepare-policy-chain.d.ts +4 -4
  161. package/dist/core/runner/prepare-policy-chain.js +4 -6
  162. package/dist/core/runner/prepare-protocol-tools.d.ts +4 -2
  163. package/dist/core/runner/prepare-protocol-tools.js +3 -3
  164. package/dist/core/runner/prepare-suspend-saga.d.ts +2 -0
  165. package/dist/core/runner/prepare-suspend-saga.js +2 -1
  166. package/dist/core/runner/prepare-task.d.ts +4 -1
  167. package/dist/core/runner/prepare-task.js +46 -37
  168. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +13 -0
  169. package/dist/core/runner/prepare-tool-disclosure-mount.js +13 -7
  170. package/dist/core/runner/prepare-wiring-manifest.d.ts +1 -0
  171. package/dist/core/runner/prepare-wiring-manifest.js +2 -2
  172. package/dist/core/runner/prepare-workspace-restore.d.ts +3 -0
  173. package/dist/core/runner/prepare-workspace-restore.js +4 -4
  174. package/dist/core/runner/resume-admission.js +1 -1
  175. package/dist/core/runner/resume-checkpoint-screen.js +2 -0
  176. package/dist/core/runner/rewind-files.d.ts +2 -5
  177. package/dist/core/runner/rewind-files.js +9 -51
  178. package/dist/core/runner/run-harness-handlers.d.ts +3 -4
  179. package/dist/core/runner/run-harness-handlers.js +1 -8
  180. package/dist/core/runner/run-identity-wiring.js +1 -0
  181. package/dist/core/runner/run-leg.js +15 -22
  182. package/dist/core/runner/run-notification-lane.d.ts +2 -0
  183. package/dist/core/runner/run-notification-lane.js +5 -2
  184. package/dist/core/runner/run-recovery-lanes.js +3 -4
  185. package/dist/core/runner/run-settle-and-teardown.js +5 -11
  186. package/dist/core/runner/run-terminal-adoption.js +3 -4
  187. package/dist/core/runner/run-turn-boundary.js +3 -5
  188. package/dist/core/runner/runtask.d.ts +8 -1
  189. package/dist/core/runner/runtask.js +28 -34
  190. package/dist/core/runner/send-message-continuation.js +1 -1
  191. package/dist/core/runner/session-verb-doors.d.ts +28 -0
  192. package/dist/core/runner/session-verb-doors.js +48 -0
  193. package/dist/core/runner/session-write-ledger.d.ts +30 -0
  194. package/dist/core/runner/session-write-ledger.js +101 -0
  195. package/dist/core/runner/stream-settle-backstop.js +11 -14
  196. package/dist/core/runner/sub-agent-deny-lists.d.ts +25 -3
  197. package/dist/core/runner/sub-agent-deny-lists.js +21 -10
  198. package/dist/core/runner/teardown-bounded.d.ts +1 -0
  199. package/dist/core/runner/teardown-bounded.js +1 -0
  200. package/dist/core/runner/terminal-account.js +3 -3
  201. package/dist/core/runner/tool-end-body.js +1 -0
  202. package/dist/core/runner/tool-occurrence.d.ts +4 -1
  203. package/dist/core/runner/tool-occurrence.js +2 -1
  204. package/dist/core/runner/write-protection-station.d.ts +8 -2
  205. package/dist/core/runner/write-protection-station.js +2 -0
  206. package/dist/core/runner-deps.d.ts +4 -4
  207. package/dist/core/secret-env.d.ts +4 -0
  208. package/dist/core/secret-env.js +3 -0
  209. package/dist/core/sensitive-path-policy.js +6 -7
  210. package/dist/core/session-log-transfer.d.ts +24 -0
  211. package/dist/core/session-log-transfer.js +166 -0
  212. package/dist/core/session-policy-store.d.ts +7 -2
  213. package/dist/core/session-policy-store.js +1 -1
  214. package/dist/core/session-store.d.ts +84 -19
  215. package/dist/core/session-store.js +162 -24
  216. package/dist/core/session.d.ts +92 -1
  217. package/dist/core/shell-read-silence.js +1 -0
  218. package/dist/core/shell-wrapper-projection.d.ts +1 -1
  219. package/dist/core/steer-replay.d.ts +4 -2
  220. package/dist/core/steer-replay.js +2 -1
  221. package/dist/core/store-contracts/background-agent-store-contract.js +1 -0
  222. package/dist/core/store-contracts/checkpoint-store-contract.js +19 -1
  223. package/dist/core/store-contracts/file-history-store-contract.js +9 -0
  224. package/dist/core/store-contracts/mailbox-store-contract.js +49 -1
  225. package/dist/core/store-contracts/session-repo-contract.js +112 -5
  226. package/dist/core/store-contracts/session-store-contract.d.ts +4 -1
  227. package/dist/core/store-contracts/session-store-contract.js +236 -2
  228. package/dist/core/task-event.d.ts +68 -8
  229. package/dist/core/task-registry-agent.d.ts +8 -4
  230. package/dist/core/task-registry-agent.js +14 -8
  231. package/dist/core/task-registry-shared.d.ts +36 -6
  232. package/dist/core/task-registry-shared.js +11 -0
  233. package/dist/core/task-registry.d.ts +1 -1
  234. package/dist/core/task-registry.js +1 -1
  235. package/dist/core/task-spec.d.ts +37 -0
  236. package/dist/core/task-stream.d.ts +2 -1
  237. package/dist/core/terminal-cause.d.ts +1 -1
  238. package/dist/core/tool-catalog-entries.d.ts +6 -0
  239. package/dist/core/tool-catalog-entries.js +2 -0
  240. package/dist/core/tool-name-aliases.d.ts +32 -2
  241. package/dist/core/tool-name-aliases.js +23 -0
  242. package/dist/core/tool-name-readings.d.ts +4 -0
  243. package/dist/core/tool-name-readings.js +1 -0
  244. package/dist/core/tool-policy.d.ts +10 -6
  245. package/dist/core/tool-policy.js +4 -7
  246. package/dist/core/tool-result-store.d.ts +17 -10
  247. package/dist/core/tool-result-store.js +3 -1
  248. package/dist/core/trace.d.ts +4 -1
  249. package/dist/core/trace.js +2 -1
  250. package/dist/core/types.d.ts +1 -1
  251. package/dist/core/untrusted-egress.d.ts +18 -0
  252. package/dist/core/untrusted-egress.js +82 -12
  253. package/dist/core/wiring-manifest.d.ts +12 -3
  254. package/dist/core/wiring-manifest.js +4 -3
  255. package/dist/core/workspace-snapshot.d.ts +44 -0
  256. package/dist/core/workspace-snapshot.js +34 -0
  257. package/dist/core/write-protect.d.ts +43 -3
  258. package/dist/core/write-protect.js +43 -16
  259. package/dist/engine/execution-env/node-execution-env.js +15 -11
  260. package/dist/engine/execution-env/symlink-chain.d.ts +7 -5
  261. package/dist/engine/harness/agent-harness.d.ts +12 -5
  262. package/dist/engine/harness/agent-harness.js +13 -2
  263. package/dist/engine/harness/types.d.ts +48 -7
  264. package/dist/engine/harness/types.js +5 -1
  265. package/dist/engine/llm/types.d.ts +12 -3
  266. package/dist/engine/llm/types.js +1 -1
  267. package/dist/engine/loop/agent-loop.d.ts +1 -4
  268. package/dist/engine/loop/agent-loop.js +26 -4
  269. package/dist/engine/session/import-validate.js +3 -0
  270. package/dist/engine/session/memory-repo.d.ts +17 -9
  271. package/dist/engine/session/memory-repo.js +44 -34
  272. package/dist/engine/session/repo-utils.d.ts +22 -4
  273. package/dist/engine/session/repo-utils.js +49 -1
  274. package/dist/engine/session/storage-base.d.ts +10 -1
  275. package/dist/engine/session/storage-base.js +7 -1
  276. package/dist/index.d.ts +23 -11
  277. package/dist/index.js +15 -6
  278. package/dist/internal/harness-types.d.ts +1 -1
  279. package/dist/internal/harness.d.ts +4 -3
  280. package/dist/internal/harness.js +3 -2
  281. package/dist/stores/file/checkpoint-store.d.ts +0 -4
  282. package/dist/stores/file/checkpoint-store.js +0 -1
  283. package/dist/stores/file/file-history-store.js +12 -4
  284. package/dist/stores/file/index.d.ts +4 -1
  285. package/dist/stores/file/index.js +4 -1
  286. package/dist/stores/file/mailbox-store.d.ts +2 -1
  287. package/dist/stores/file/mailbox-store.js +26 -1
  288. package/dist/stores/file/session-store.d.ts +15 -8
  289. package/dist/stores/file/session-store.js +28 -13
  290. package/dist/tools/fs/bash-readonly-classifier.d.ts +15 -19
  291. package/dist/tools/fs/bash-readonly-classifier.js +5 -10
  292. package/dist/tools/fs/fs-bash.js +10 -3
  293. package/dist/tools/fs/fs-write.d.ts +6 -3
  294. package/dist/tools/fs/fs-write.js +8 -7
  295. package/dist/tools/fs/index.d.ts +3 -0
  296. package/dist/tools/fs/index.js +1 -1
  297. package/dist/tools/fs/pattern-kill-guard.d.ts +3 -2
  298. package/dist/tools/fs/pattern-kill-guard.js +68 -36
  299. package/dist/tools/fs/safety.js +40 -8
  300. package/dist/tools/fs/search.js +6 -24
  301. package/dist/tools/fs/shell-read-check.d.ts +18 -1
  302. package/dist/tools/fs/shell-read-check.js +66 -16
  303. package/dist/tools/fs/shell-read-establish.js +2 -1
  304. package/dist/tools/fs/shell-read-identity.d.ts +12 -9
  305. package/dist/tools/fs/shell-read-identity.js +10 -5
  306. package/dist/tools/fs/shell-read-judge.d.ts +10 -1
  307. package/dist/tools/web.js +9 -7
  308. package/dist/tools/worktree.d.ts +42 -15
  309. package/dist/tools/worktree.js +60 -32
  310. package/package.json +4 -2
  311. package/test/export-surface.snapshot.json +141 -3
  312. package/wire-changes/core-stores-sql@7.57.0.json +29 -0
  313. package/wire-changes/core-stores-sql@7.58.0.json +29 -0
  314. package/wire-changes/core@7.57.0.json +1487 -0
  315. package/wire-changes/core@7.58.0.json +2188 -0
  316. package/wire-changes/mods-kernel@7.57.0.json +29 -0
  317. package/wire-changes/mods-kernel@7.58.0.json +81 -0
  318. package/wire-changes/primitives@7.57.0.json +245 -0
  319. package/wire-changes/primitives@7.58.0.json +29 -0
@@ -1,3 +1,4 @@
1
+ import { isMailboxDecisionDeliverable, isMailboxDecisionFinal } from "../core/mailbox-store.js";
1
2
  import { PEER_HELD_QUEUE_CAP, PEER_HELD_REVIEW_CAUSES } from "./peer-notices.js";
2
3
  import { peerSessionBoxHandle } from "./peer-directory.js";
3
4
  export const realPeerClock = {
@@ -10,14 +11,23 @@ export const realPeerClock = {
10
11
  clearTimeout: (h) => clearTimeout(h),
11
12
  };
12
13
  const crashHandlers = new WeakMap();
13
- export const PEER_HELD_DECISION_MEMORY = PEER_HELD_QUEUE_CAP * 4;
14
14
  export function createPeerHeldQueue(key, opts = {}) {
15
15
  const cap = opts.cap ?? PEER_HELD_QUEUE_CAP;
16
16
  const clock = opts.clock ?? realPeerClock;
17
17
  const entries = [];
18
18
  const deadlines = new Map();
19
- const decisions = new Map();
20
19
  let cfg;
20
+ const cardChains = new Map();
21
+ const onCard = (seq, f) => {
22
+ const run = (cardChains.get(seq) ?? Promise.resolve()).then(f);
23
+ const tail = run.then(() => undefined, () => undefined);
24
+ cardChains.set(seq, tail);
25
+ void tail.then(() => {
26
+ if (cardChains.get(seq) === tail)
27
+ cardChains.delete(seq);
28
+ });
29
+ return run;
30
+ };
21
31
  const sinkOrThrow = () => {
22
32
  if (cfg === undefined)
23
33
  throw new Error("PeerHeldQueue: not configured — bind a run (configure) before holding messages");
@@ -43,103 +53,199 @@ export function createPeerHeldQueue(key, opts = {}) {
43
53
  entries.splice(i, 1);
44
54
  clearDeadline(entry.seq);
45
55
  };
46
- const settleOut = (entry, settlement, reason, receipt) => {
56
+ const leave = (entry, settlement, reason, receipt) => {
47
57
  const sink = sinkOrThrow();
48
58
  remove(entry);
49
- if (settlement !== "delivered") {
50
- decisions.set(entry.seq, settlement);
51
- while (decisions.size > PEER_HELD_DECISION_MEMORY) {
52
- const oldest = decisions.keys().next();
53
- if (oldest.done === true)
54
- break;
55
- decisions.delete(oldest.value);
56
- }
57
- }
58
59
  if (receipt !== undefined)
59
60
  safe(() => sink.receipt(entry, receipt));
60
61
  safe(() => sink.onSettled?.(entry, settlement, reason, entries.length));
61
62
  };
63
+ const move = async (entry, next) => {
64
+ const sink = sinkOrThrow();
65
+ let outcome;
66
+ try {
67
+ outcome = await sink.decide(entry, entry.decision, next);
68
+ }
69
+ catch (e) {
70
+ safe(() => sink.onFault?.(entry, e));
71
+ return "fault";
72
+ }
73
+ if (outcome.ok)
74
+ return "won";
75
+ adoptCurrent(entry, outcome.current);
76
+ return "lost";
77
+ };
78
+ const adoptCurrent = (entry, current) => {
79
+ if (!entries.includes(entry))
80
+ 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);
85
+ if (isMailboxDecisionDeliverable(current) && entry.decision !== current) {
86
+ entry.decision = current;
87
+ clearDeadline(entry.seq);
88
+ }
89
+ };
90
+ const settleLocal = async (entry, settlement, reason) => {
91
+ const sink = sinkOrThrow();
92
+ let tells = false;
93
+ try {
94
+ tells = sink.tellsSender(entry);
95
+ }
96
+ catch {
97
+ tells = false;
98
+ }
99
+ const from = settlement === "expired" ? "held" : "delivered";
100
+ if (!tells || entry.decision !== from)
101
+ return leave(entry, "retired", reason, undefined);
102
+ const r = await move(entry, settlement);
103
+ if (r === "won")
104
+ leave(entry, settlement, reason, settlement);
105
+ else if (r === "fault")
106
+ leave(entry, "retired", reason, undefined);
107
+ };
62
108
  const armDeadline = (entry) => {
63
109
  if (cfg === undefined || cfg.dialogExpiryMs === null || deadlines.has(entry.seq))
64
110
  return;
65
- if (entry.released === true)
111
+ if (entry.decision !== "held")
66
112
  return;
67
113
  if (!PEER_HELD_REVIEW_CAUSES.includes(entry.cause))
68
114
  return;
69
115
  const h = clock.setTimeout(() => {
70
116
  deadlines.delete(entry.seq);
71
- if (!entries.includes(entry))
72
- return;
73
- rejudge();
74
- if (!entries.includes(entry))
75
- return;
76
- settleOut(entry, "expired", "deadline", "expired");
117
+ void (async () => {
118
+ if (!entries.includes(entry))
119
+ return;
120
+ await rejudge();
121
+ await onCard(entry.seq, async () => {
122
+ if (!entries.includes(entry) || entry.decision !== "held")
123
+ return;
124
+ if ((await move(entry, "expired")) === "won")
125
+ leave(entry, "expired", "deadline", "expired");
126
+ });
127
+ })().catch(() => undefined);
77
128
  }, cfg.dialogExpiryMs);
78
129
  deadlines.set(entry.seq, h);
79
130
  };
80
- const tryDeliver = (entry, reason) => {
131
+ const mayHandOver = (entry) => {
81
132
  const sink = sinkOrThrow();
82
133
  if (sink.inject === undefined)
134
+ return false;
135
+ try {
136
+ return sink.canInject === undefined || sink.canInject(entry);
137
+ }
138
+ catch {
139
+ return false;
140
+ }
141
+ };
142
+ const tryDeliver = async (entry, reason) => {
143
+ const sink = sinkOrThrow();
144
+ if (sink.inject === undefined || !mayHandOver(entry))
83
145
  return "no_leg";
146
+ if (entry.decision !== "delivered") {
147
+ const r = await move(entry, "delivered");
148
+ if (r === "lost")
149
+ return "lost";
150
+ if (r === "fault")
151
+ return "no_leg";
152
+ entry.decision = "delivered";
153
+ clearDeadline(entry.seq);
154
+ }
84
155
  try {
85
156
  if (sink.inject(entry) === "deferred")
86
157
  return "no_leg";
87
158
  }
88
159
  catch {
89
- settleOut(entry, "dropped", "inject_failed", "dropped");
160
+ await settleLocal(entry, "dropped", "inject_failed");
90
161
  return "dropped";
91
162
  }
92
- settleOut(entry, "delivered", reason, "delivered");
163
+ leave(entry, "delivered", reason, "delivered");
93
164
  return "delivered";
94
165
  };
95
- const reconcile = (present) => {
166
+ const refuseCard = async (entry, reason) => {
167
+ const owed = entry.decision === "delivered";
168
+ if (owed && !mayHandOver(entry))
169
+ return "waits";
170
+ const word = owed ? "dropped" : "refused";
171
+ const r = await move(entry, word);
172
+ if (r === "won")
173
+ leave(entry, word, reason, word);
174
+ return r;
175
+ };
176
+ const rejudgeOne = async (entry, reannounce) => {
177
+ const sink = sinkOrThrow();
178
+ let verdict;
179
+ try {
180
+ verdict = sink.judge(entry);
181
+ }
182
+ catch {
183
+ return "held";
184
+ }
185
+ if (verdict.verdict === "refuse")
186
+ return (await refuseCard(entry, "rejudge")) === "won" ? "refused" : "held";
187
+ if (verdict.verdict === "deliver" || isMailboxDecisionDeliverable(entry.decision)) {
188
+ const r = await tryDeliver(entry, entry.decision === "approved" ? "approved" : "rejudge");
189
+ return r === "delivered" ? "released" : "held";
190
+ }
191
+ if (verdict.verdict === "hold" && verdict.cause !== entry.cause) {
192
+ entry.cause = verdict.cause;
193
+ reannounce.push([entry, verdict.cause]);
194
+ clearDeadline(entry.seq);
195
+ armDeadline(entry);
196
+ }
197
+ return "held";
198
+ };
199
+ const rejudge = async () => {
200
+ sinkOrThrow();
201
+ let released = 0;
202
+ let refused = 0;
203
+ const reannounce = [];
204
+ for (const entry of [...entries]) {
205
+ const r = await onCard(entry.seq, async () => (entries.includes(entry) ? rejudgeOne(entry, reannounce) : "held"));
206
+ if (r === "released")
207
+ released += 1;
208
+ else if (r === "refused")
209
+ refused += 1;
210
+ }
96
211
  const sink = sinkOrThrow();
212
+ for (const [entry, cause] of reannounce)
213
+ if (entries.includes(entry))
214
+ safe(() => sink.onHeld?.(entry, entries.length, cause, true));
215
+ return { released, refused, held: entries.length };
216
+ };
217
+ const reconcile = (snapshot) => {
218
+ sinkOrThrow();
97
219
  let retired = 0;
98
220
  for (const entry of [...entries]) {
99
- if (present.has(entry.seq))
221
+ if (cardChains.has(entry.seq))
100
222
  continue;
101
- remove(entry);
102
- retired += 1;
103
- safe(() => sink.onSettled?.(entry, "expired", "superseded", entries.length));
223
+ const present = snapshot.has(entry.seq);
224
+ const before = entries.length;
225
+ adoptCurrent(entry, present ? (snapshot.get(entry.seq) ?? "unset") : "gone");
226
+ if (entries.length < before)
227
+ retired += 1;
104
228
  }
105
229
  return retired;
106
230
  };
107
- const rejudge = () => {
231
+ const makeRoom = async () => {
232
+ if (entries.length < cap)
233
+ return true;
108
234
  const sink = sinkOrThrow();
109
- let released = 0;
110
- let refused = 0;
111
- const reannounce = [];
112
- for (const entry of [...entries]) {
113
- let verdict;
235
+ const victim = entries.find((e) => {
236
+ if (e.decision !== "held")
237
+ return false;
114
238
  try {
115
- verdict = sink.judge(entry);
239
+ return sink.tellsSender(e);
116
240
  }
117
241
  catch {
118
- continue;
242
+ return false;
119
243
  }
120
- if (verdict.verdict === "refuse") {
121
- settleOut(entry, "refused", "rejudge", "refused");
122
- refused += 1;
123
- continue;
124
- }
125
- if (verdict.verdict === "deliver" || entry.released === true) {
126
- const r = tryDeliver(entry, entry.released === true ? "approved" : "rejudge");
127
- if (r === "no_leg")
128
- entry.released = true;
129
- else if (r === "delivered")
130
- released += 1;
131
- continue;
132
- }
133
- if (verdict.cause !== entry.cause) {
134
- entry.cause = verdict.cause;
135
- reannounce.push([entry, verdict.cause]);
136
- clearDeadline(entry.seq);
137
- armDeadline(entry);
138
- }
139
- }
140
- for (const [entry, cause] of reannounce)
141
- safe(() => sink.onHeld?.(entry, entries.length, cause, true));
142
- return { released, refused, held: entries.length };
244
+ });
245
+ if (victim === undefined)
246
+ return false;
247
+ await onCard(victim.seq, async () => (entries.includes(victim) ? settleLocal(victim, "expired", "evicted") : undefined));
248
+ return entries.length < cap;
143
249
  };
144
250
  const queue = {
145
251
  key,
@@ -160,63 +266,55 @@ export function createPeerHeldQueue(key, opts = {}) {
160
266
  cfg = { ...cfg, sink: rest };
161
267
  },
162
268
  configured: () => cfg !== undefined,
163
- hold(input) {
269
+ async hold(input, known) {
164
270
  const sink = sinkOrThrow();
165
271
  if (entries.some((e) => e.box === input.box && e.seq === input.seq))
166
- return;
167
- const entry = { ...input, heldAt: clock.now() };
168
- if (entries.length >= cap) {
169
- const oldest = entries[0];
170
- settleOut(oldest, "expired", "evicted", "expired");
272
+ return "adopted";
273
+ let state = known ?? "held";
274
+ let fresh = false;
275
+ if (known === undefined) {
276
+ let outcome;
277
+ try {
278
+ outcome = await sink.decide({ ...input, heldAt: clock.now(), decision: "held" }, undefined, "held");
279
+ }
280
+ catch (e) {
281
+ safe(() => sink.onFault?.({ ...input, heldAt: clock.now(), decision: "held" }, e));
282
+ return "fault";
283
+ }
284
+ if (outcome.ok)
285
+ fresh = true;
286
+ else if (outcome.current === "gone" || outcome.current === "unset")
287
+ return "gone";
288
+ else if (isMailboxDecisionFinal(outcome.current))
289
+ return outcome.current;
290
+ else
291
+ state = outcome.current;
292
+ }
293
+ if (entries.some((e) => e.box === input.box && e.seq === input.seq))
294
+ return fresh ? "held" : "adopted";
295
+ if (!(await makeRoom())) {
296
+ if (fresh)
297
+ safe(() => sink.receipt({ ...input, heldAt: clock.now(), decision: state }, "held"));
298
+ return "uncarded";
171
299
  }
300
+ const entry = { ...input, heldAt: clock.now(), decision: state };
172
301
  entries.push(entry);
173
302
  armDeadline(entry);
174
- safe(() => sink.onHeld?.(entry, entries.length, entry.cause, false));
175
- safe(() => sink.receipt(entry, "held"));
303
+ if (state === "held")
304
+ safe(() => sink.onHeld?.(entry, entries.length, entry.cause, false));
305
+ if (fresh)
306
+ safe(() => sink.receipt(entry, "held"));
307
+ return fresh ? "held" : "adopted";
176
308
  },
177
309
  rejudge,
178
310
  reconcile,
179
311
  settle(seq, decision) {
180
- const sink = sinkOrThrow();
181
- const entry = entries.find((e) => e.seq === seq);
182
- if (entry === undefined)
183
- return "gone";
184
- if (decision === "deny") {
185
- settleOut(entry, "denied", "denied", "denied");
186
- return "denied";
187
- }
188
- if (decision === "cancel") {
189
- settleOut(entry, "expired", "cancelled", "expired");
190
- return "expired";
191
- }
192
- let verdict;
193
- try {
194
- verdict = sink.judge(entry);
195
- }
196
- catch {
197
- entry.released = true;
198
- return "released_pending";
199
- }
200
- if (verdict.verdict === "refuse") {
201
- settleOut(entry, "refused", "approved", "refused");
202
- return "dropped_by_policy";
203
- }
204
- const r = tryDeliver(entry, "approved");
205
- if (r === "no_leg") {
206
- entry.released = true;
207
- clearDeadline(entry.seq);
208
- return "released_pending";
209
- }
210
- return r;
312
+ return onCard(seq, () => settleCard(seq, decision));
211
313
  },
314
+ has: (seq) => entries.some((e) => e.seq === seq),
212
315
  list: () => entries.map((e) => ({ ...e, ...(e.hopChain !== undefined ? { hopChain: [...e.hopChain] } : {}), ...(e.peerMeta !== undefined ? { peerMeta: { ...e.peerMeta } } : {}) })),
213
316
  size: () => entries.length,
214
- decisions: () => decisions,
215
- forgetDecisions(seqs) {
216
- for (const seq of seqs)
217
- decisions.delete(seq);
218
- },
219
- shutdown() {
317
+ async shutdown() {
220
318
  if (cfg === undefined) {
221
319
  entries.length = 0;
222
320
  for (const h of deadlines.values())
@@ -224,12 +322,63 @@ export function createPeerHeldQueue(key, opts = {}) {
224
322
  deadlines.clear();
225
323
  return;
226
324
  }
227
- for (const entry of [...entries])
228
- settleOut(entry, "expired", "shutdown", "expired");
325
+ for (const entry of [...entries]) {
326
+ await onCard(entry.seq, async () => {
327
+ if (entries.includes(entry))
328
+ await settleLocal(entry, "expired", "shutdown");
329
+ });
330
+ }
229
331
  },
230
332
  };
333
+ async function settleCard(seq, decision) {
334
+ const sink = sinkOrThrow();
335
+ const entry = entries.find((e) => e.seq === seq);
336
+ if (entry === undefined)
337
+ return "gone";
338
+ const handedOver = entry.decision === "delivered";
339
+ if (decision === "deny" || decision === "cancel") {
340
+ if (handedOver)
341
+ return "delivered";
342
+ const word = decision === "deny" ? "denied" : "expired";
343
+ const r = await move(entry, word);
344
+ if (r === "fault")
345
+ throw new Error(`PeerHeldQueue.settle: the ${decision} of seq ${seq} could not be recorded (the store refused the move); nothing was decided`);
346
+ if (r === "lost")
347
+ return "decided_elsewhere";
348
+ leave(entry, word, decision === "deny" ? "denied" : "cancelled", word);
349
+ return word;
350
+ }
351
+ let verdict;
352
+ try {
353
+ verdict = sink.judge(entry);
354
+ }
355
+ catch {
356
+ verdict = undefined;
357
+ }
358
+ if (verdict?.verdict === "refuse") {
359
+ const r = await refuseCard(entry, "approved");
360
+ if (r === "fault")
361
+ throw new Error(`PeerHeldQueue.settle: the refusal of seq ${seq} could not be recorded (the store refused the move)`);
362
+ if (r !== "waits")
363
+ return r === "lost" ? "decided_elsewhere" : "dropped_by_policy";
364
+ }
365
+ if (handedOver)
366
+ return "delivered";
367
+ if (entry.decision === "held") {
368
+ const r = await move(entry, "approved");
369
+ if (r === "fault")
370
+ throw new Error(`PeerHeldQueue.settle: the approval of seq ${seq} could not be recorded (the store refused the move); nothing was decided`);
371
+ if (r === "lost")
372
+ return "decided_elsewhere";
373
+ entry.decision = "approved";
374
+ clearDeadline(entry.seq);
375
+ }
376
+ if (verdict === undefined)
377
+ return "released_pending";
378
+ const d = await tryDeliver(entry, "approved");
379
+ return d === "no_leg" ? "released_pending" : d === "lost" ? "decided_elsewhere" : d;
380
+ }
231
381
  crashHandlers.set(queue, () => {
232
- decisions.clear();
233
382
  entries.length = 0;
234
383
  for (const h of deadlines.values())
235
384
  clock.clearTimeout(h);