@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
@@ -1,9 +1,12 @@
1
1
  import { SessionError, StreamingImportValidator, importRowCells, ownerCell, sessionLogMarkOf, uuidv7 } from "../internal/harness.js";
2
- import { receiptRefusal, receiveOwnProperties } from "./own-property-receipt.js";
2
+ import { optionKeys, receiptRefusal, receiveMembers } from "./own-property-receipt.js";
3
3
  import { thrownText } from "./thrown-value.js";
4
4
  const EXPORT_WORDS = { subject: "SessionLogExportOptions", unit: "member", moment: "at SessionLogTransfer.exportStream" };
5
5
  const BEGIN_WORDS = { subject: "SessionLogTransfer.beginReplace options", unit: "member", moment: "at SessionLogTransfer.beginReplace" };
6
6
  const COMMIT_WORDS = { subject: "SessionLogCommit", unit: "member", moment: "at SessionLogReplace.commit" };
7
+ const EXPORT_KEYS = optionKeys()({ afterSeq: 0, batchSize: 0 });
8
+ const BEGIN_KEYS = optionKeys()({ preserveActorAssertions: 0 });
9
+ const COMMIT_KEYS = optionKeys()({ owner: 0, decide: 0 });
7
10
  async function logOrNull(seat, sessionId) {
8
11
  return (await seat.readRow(sessionId))?.entries ?? null;
9
12
  }
@@ -15,14 +18,10 @@ function committedHead(sessionId, answer) {
15
18
  }
16
19
  throw new SessionError("storage", `the repo's importEntries wrote session ${sessionId}'s log but answered no head (got ${answer === null ? "null" : typeof answer}) — a repo behind SessionStore.logTransfer answers the head its write committed; read the row again`);
17
20
  }
18
- function readRecord(raw, words, names) {
21
+ function readRecord(raw, words, keys) {
19
22
  if (typeof raw !== "object" || raw === null)
20
23
  throw receiptRefusal(`${words.subject} must be an object, got ${raw === null ? "null" : typeof raw}`);
21
- const got = receiveOwnProperties(raw, words);
22
- for (const name of Object.keys(got))
23
- if (!names.includes(name))
24
- throw receiptRefusal(`${words.subject} carries "${name}" — not a member this face reads`);
25
- return got;
24
+ return receiveMembers(raw, words, keys, (_, [stray]) => receiptRefusal(`${words.subject} carries "${String(stray)}" — not a member this face reads`));
26
25
  }
27
26
  function isIntegerFrom(value, floor) {
28
27
  return typeof value === "number" && Number.isSafeInteger(value) && value >= floor;
@@ -30,7 +29,7 @@ function isIntegerFrom(value, floor) {
30
29
  function readExportOptions(raw) {
31
30
  if (raw === undefined)
32
31
  return { afterSeq: -1 };
33
- const got = readRecord(raw, EXPORT_WORDS, ["afterSeq", "batchSize"]);
32
+ const got = readRecord(raw, EXPORT_WORDS, EXPORT_KEYS);
34
33
  const afterSeq = got["afterSeq"];
35
34
  if (afterSeq !== undefined && !isIntegerFrom(afterSeq, -1))
36
35
  throw receiptRefusal("SessionLogExportOptions.afterSeq must be an integer ≥ -1 when present");
@@ -41,7 +40,7 @@ function readExportOptions(raw) {
41
40
  function readBeginOptions(raw) {
42
41
  if (raw === undefined)
43
42
  return {};
44
- const preserveActorAssertions = readRecord(raw, BEGIN_WORDS, ["preserveActorAssertions"])["preserveActorAssertions"];
43
+ const preserveActorAssertions = readRecord(raw, BEGIN_WORDS, BEGIN_KEYS)["preserveActorAssertions"];
45
44
  if (preserveActorAssertions === undefined)
46
45
  return {};
47
46
  if (typeof preserveActorAssertions !== "boolean")
@@ -49,7 +48,7 @@ function readBeginOptions(raw) {
49
48
  return { preserveActorAssertions };
50
49
  }
51
50
  function readCommit(raw) {
52
- const { owner, decide } = readRecord(raw, COMMIT_WORDS, ["owner", "decide"]);
51
+ const { owner, decide } = readRecord(raw, COMMIT_WORDS, COMMIT_KEYS);
53
52
  if (owner === undefined)
54
53
  throw receiptRefusal("SessionLogCommit.owner must be a principal name or null (anonymous), got undefined");
55
54
  try {
@@ -409,7 +409,7 @@ export declare class InMemorySessionPolicyStore implements SessionPolicyStore {
409
409
  private readonly map;
410
410
  /** {@link SessionPolicyStoreOptions.mountedToolNames}, read once at construction. */
411
411
  private readonly mountedToolNames;
412
- constructor(opts?: SessionPolicyStoreOptions);
412
+ constructor(options?: SessionPolicyStoreOptions);
413
413
  /**
414
414
  * The per-key mark {@link SessionPolicyStore.deleteBySession} may not erase: the largest `rev` this key has
415
415
  * ever been stamped with, kept outside the row so removing the row cannot roll the counter back. Written by
@@ -8,6 +8,7 @@ import { NAME_RULE_FACES, noticeRuleText } from "./permission-rule-model.js";
8
8
  import { parsePermissionRule, ruleSpellingOf } from "./permission-rule-syntax.js";
9
9
  import { splitNamespacedName } from "./tool-name-aliases.js";
10
10
  import { namesASetOfTools } from "./namespaced-rule-name.js";
11
+ import { optionKeys, receiveOptions } from "./own-property-receipt.js";
11
12
  const SESSION_RULE_BUCKETS = { toolAllow: "allow", toolDeny: "deny", allowDirs: "dirs" };
12
13
  const BUCKETS = Object.keys(SESSION_RULE_BUCKETS);
13
14
  const ENTRY_FIELDS = BUCKETS.filter((f) => SESSION_RULE_BUCKETS[f] !== "dirs");
@@ -25,6 +26,7 @@ export class SessionPolicyError extends Error {
25
26
  }
26
27
  }
27
28
  const NO_DECLARED_TOOLS = new Set();
29
+ const SESSION_POLICY_STORE_OPTION_KEYS = optionKeys()({ mountedToolNames: 0 });
28
30
  export function readMountedToolNames(value) {
29
31
  if (value === undefined)
30
32
  return NO_DECLARED_TOOLS;
@@ -525,8 +527,9 @@ export function continuesLineage(a, b) {
525
527
  export class InMemorySessionPolicyStore {
526
528
  map = new Map();
527
529
  mountedToolNames;
528
- constructor(opts) {
529
- this.mountedToolNames = readMountedToolNames(opts?.mountedToolNames);
530
+ constructor(options) {
531
+ const opts = receiveOptions(options, "InMemorySessionPolicyStore", SESSION_POLICY_STORE_OPTION_KEYS);
532
+ this.mountedToolNames = readMountedToolNames(opts.mountedToolNames);
530
533
  }
531
534
  highWater = new Map();
532
535
  key(sessionId, principal) {
@@ -1,4 +1,4 @@
1
- import type { AgentMessage } from "../internal/harness-types.js";
1
+ import type { AgentMessage, RowAdmission } from "../internal/harness-types.js";
2
2
  import type { ToolResultMessage } from "../internal/llm.js";
3
3
  import type { Session } from "./session.js";
4
4
  import type { ToolEffect } from "./types.js";
@@ -122,6 +122,7 @@ export declare const INTERRUPTED_BY_USER_FOR_TOOL_USE_MARKER = "[Request interru
122
122
  */
123
123
  export declare function appendInterruptionMarker(session: Session, opts: {
124
124
  toolUseInFlight: boolean;
125
+ admitRows?: RowAdmission;
125
126
  }): Promise<string>;
126
127
  /** One synthetic interrupted result: what a call with no recorded result is closed with. */
127
128
  export interface InterruptedResult {
@@ -172,4 +173,4 @@ export declare function interruptedResultMessage(result: InterruptedResult, time
172
173
  * never started: it is closed with a "never executed — safe to re-issue" result instead of the
173
174
  * conservative unknown-outcome wording. When omitted, every orphan keeps the conservative texts.
174
175
  */
175
- export declare function reconcileInterruptedSession(session: Session, toolEffects?: Map<string, ToolEffect>, suspendedBatch?: ReadonlySet<string>, startedToolCallIds?: ReadonlySet<string>): Promise<ReconcileReport>;
176
+ export declare function reconcileInterruptedSession(session: Session, toolEffects?: Map<string, ToolEffect>, suspendedBatch?: ReadonlySet<string>, startedToolCallIds?: ReadonlySet<string>, admitRows?: RowAdmission): Promise<ReconcileReport>;
@@ -1,3 +1,4 @@
1
+ import { appendAdmittedRow } from "./row-admission.js";
1
2
  import { readMember } from "./thrown-value.js";
2
3
  export const closeNeverExecuted = (errorKind) => errorKind === "interrupted_never_started";
3
4
  const INTERRUPTED_UNKNOWN = "[INTERRUPTED] The previous run ended before this tool call's result was recorded. Its outcome " +
@@ -86,7 +87,7 @@ export function findOrphanToolCalls(messages, suspendedBatch) {
86
87
  export const INTERRUPTED_BY_USER_MARKER = "[Request interrupted by user]";
87
88
  export const INTERRUPTED_BY_USER_FOR_TOOL_USE_MARKER = "[Request interrupted by user for tool use]";
88
89
  export async function appendInterruptionMarker(session, opts) {
89
- return await session.appendMessage({
90
+ return await appendAdmittedRow(opts.admitRows, session, {
90
91
  role: "user",
91
92
  content: [
92
93
  {
@@ -145,14 +146,16 @@ function closableByAppend(messages, suspendedBatch) {
145
146
  .sort((a, b) => a[1].order - b[1].order)
146
147
  .map(([toolCallId, site]) => ({ toolCallId, toolName: site.toolName, args: site.args }));
147
148
  }
148
- export async function reconcileInterruptedSession(session, toolEffects, suspendedBatch, startedToolCallIds) {
149
+ export async function reconcileInterruptedSession(session, toolEffects, suspendedBatch, startedToolCallIds, admitRows) {
149
150
  const { messages } = await session.buildContext();
150
151
  const orphans = closableByAppend(messages, suspendedBatch);
151
152
  const recovered = [];
152
153
  const results = interruptedResults(orphans, toolEffects, startedToolCallIds);
153
154
  for (const [i, result] of results.entries()) {
154
- const entryId = await session.appendMessage(interruptedResultMessage(result, Date.now()));
155
- recovered.push({ toolCallId: result.toolCallId, toolName: result.toolName, entryId, text: result.text, errorKind: result.errorKind, args: orphans[i].args });
155
+ const row = interruptedResultMessage(result, Date.now());
156
+ const entryId = await appendAdmittedRow(admitRows, session, row);
157
+ const text = row.content.flatMap((b) => (b.type === "text" ? [b.text] : [])).join("\n");
158
+ recovered.push({ toolCallId: result.toolCallId, toolName: result.toolName, entryId, text, errorKind: result.errorKind, args: orphans[i].args });
156
159
  }
157
160
  return { recovered };
158
161
  }
@@ -96,6 +96,8 @@ export declare function admitSessionPlacement(sessionId: string, persisted: Sess
96
96
  }, capability: {
97
97
  subagentPlacement: boolean;
98
98
  }): void;
99
+ /** The hooks {@link TtlSessionStore} runs — a member of `hooks` outside it is refused by name. */
100
+ export declare const STORE_HOOK_KEYS: import("./own-property-receipt.js").OptionKeys<SessionStoreHooks>;
99
101
  /**
100
102
  * TTL-cached {@link SessionStore} over a pluggable {@link SessionRepo}.
101
103
  *
@@ -338,6 +340,6 @@ export declare class TtlSessionStore implements SessionStore {
338
340
  * Exported at the package root: the bundled store's `fork` and any other store's `fork` are the same question and must give the same
339
341
  * answer — a backend reads the source session (`SessionRepo.open`), asks this, and hands the answer to `SessionRepo.fork` with the id
340
342
  * and owner it mints. Forking the whole log instead copies the in-flight turn. The walk is one of the parent-chain walks, so it takes the
341
- * shared guard: a leaf on a loop of tool-result messages is refused `invalid_session` (the sentence of `getPathToRoot`) instead of followed.
343
+ * shared guard: a leaf on a loop of tool-result messages is refused `corrupt_session` (the sentence of `getPathToRoot`) instead of followed.
342
344
  */
343
345
  export declare function settledForkOptions(source: Session): Promise<ForkPoint>;
@@ -3,7 +3,7 @@ import { isSessionConflict, readSessionListQuery } from "./session.js";
3
3
  import { readRetentionDeclaration } from "./retention.js";
4
4
  import { readMember } from "./thrown-value.js";
5
5
  import { principalNameFault, principalNameOf } from "./principal-name.js";
6
- import { DECLARATION_RECEIPT_MODE, receiptRefusal, receiveOptions, receiveOwnProperties } from "./own-property-receipt.js";
6
+ import { DECLARATION_RECEIPT_MODE, optionKeys, receiptRefusal, receiveMembers, receiveOptions } from "./own-property-receipt.js";
7
7
  import { describeFault, receive } from "./mods/kernel/receive.js";
8
8
  import { describeRejectedValue } from "./tool-search-setting.js";
9
9
  import { readIntegerOption, TIMER_DELAY_MS } from "./integer-option.js";
@@ -25,6 +25,12 @@ export function admitSessionPlacement(sessionId, persisted, request, capability)
25
25
  }
26
26
  }
27
27
  }
28
+ function placedRowCells(placement) {
29
+ const { owner, ...tuple } = placement;
30
+ return { placement: tuple, owner };
31
+ }
32
+ const TTL_SESSION_STORE_OPTION_KEYS = optionKeys()({ defaultTtlDays: 0, sweepIntervalMs: 0, repo: 0, evict: 0, durability: 0, placements: 0, retention: 0, hooks: 0 });
33
+ export const STORE_HOOK_KEYS = optionKeys()({ beforeSessionDelete: 0 });
28
34
  export class TtlSessionStore {
29
35
  retention;
30
36
  durability;
@@ -47,7 +53,7 @@ export class TtlSessionStore {
47
53
  evictPolicy;
48
54
  sweepTimer;
49
55
  constructor(options) {
50
- const opts = receiveOptions(options, "TtlSessionStore");
56
+ const opts = receiveOptions(options, "TtlSessionStore", TTL_SESSION_STORE_OPTION_KEYS);
51
57
  this.retention = readRetentionDeclaration("TtlSessionStoreOptions.retention", opts.retention);
52
58
  const givenRepo = opts.repo;
53
59
  this.repo = givenRepo ?? new InMemorySessionRepo();
@@ -195,7 +201,7 @@ export class TtlSessionStore {
195
201
  async createAndStore(id, placement) {
196
202
  let session;
197
203
  try {
198
- session = await this.repo.create({ ...(id !== undefined ? { id } : {}), ...(placement !== undefined ? { placement } : {}) });
204
+ session = await this.repo.create({ ...(id !== undefined ? { id } : {}), ...(placement !== undefined ? placedRowCells(placement) : {}) });
199
205
  }
200
206
  catch (err) {
201
207
  if (id === undefined || !isSessionConflict(err))
@@ -535,11 +541,7 @@ function readStoreHooks(hooks) {
535
541
  return undefined;
536
542
  if (typeof hooks !== "object" || hooks === null)
537
543
  throw receiptRefusal(`TtlSessionStoreOptions.hooks must be an object when given, got ${hooks === null ? "null" : typeof hooks}`);
538
- const got = receiveOwnProperties(hooks, { subject: "TtlSessionStoreOptions.hooks", unit: "hook", moment: "at construction" });
539
- for (const name of Object.keys(got)) {
540
- if (name !== "beforeSessionDelete")
541
- throw receiptRefusal(`TtlSessionStoreOptions.hooks.${name} is not a hook this store runs (it runs beforeSessionDelete)`);
542
- }
544
+ const got = receiveMembers(hooks, { subject: "TtlSessionStoreOptions.hooks", unit: "hook", moment: "at construction" }, STORE_HOOK_KEYS);
543
545
  const hook = got["beforeSessionDelete"];
544
546
  if (hook !== undefined && typeof hook !== "function")
545
547
  throw receiptRefusal(`TtlSessionStoreOptions.hooks.beforeSessionDelete must be a function when given, got ${hook === null ? "null" : typeof hook}`);
@@ -33,6 +33,10 @@ export interface SessionPlacement {
33
33
  rootSessionId?: string;
34
34
  /** The durable agent row key (`a…`) — the store-side join key for orphan GC. */
35
35
  handle?: string;
36
+ /** The delegation tree's owner: the owner of the tree root's row as the root run read it, carried unchanged to every descendant
37
+ * (`null` = the root is anonymous). The placing write records exactly it in the row's owner cell — never in the tuple
38
+ * ({@link SessionPlacementRecord} has no owner); a re-open ignores it (first-write immutable). */
39
+ owner: string | null;
36
40
  }
37
41
  /**
38
42
  * One row of {@link SessionStore.listPlaced}. The row-store join key is the FULL `(scope, handle)`
@@ -83,7 +87,8 @@ export interface SessionStoreSummary {
83
87
  /**
84
88
  * An ENGINE-minted run identity for this session ({@link import("./types.js").TaskResult.runId}),
85
89
  * recorded by the most recent {@link SessionStore.noteTaskRun} write to LAND.
86
- * {@link lastTaskId} above is `spec.taskId ?? sessionId`, so on the ordinary deployment that supplies no
90
+ * {@link lastTaskId} above is the leg's task id (a background row's id, else the declared one, else the
91
+ * session id), so on the ordinary deployment that supplies no
87
92
  * host task id it answers the SESSION's own id: a "last run" handle that names the session it hangs off
88
93
  * cannot say WHICH run it means. This one names a specific run — read the ORDERING clause below for
89
94
  * exactly how strong "most recent" is here, which is weaker than the sibling field's wording implies.
@@ -206,7 +211,10 @@ export interface SessionStore<S extends SessionStoreSummary = SessionStoreSummar
206
211
  * placement argument) returns the same session and never rewrites the tuple;
207
212
  * 6. a placed id cannot be CLAIMED: a later claim-form acquire (no `requireExisting`, no
208
213
  * creation placement) of an existing placed id refuses loudly
209
- * (`SessionError("placement_refused")`) instead of attaching.
214
+ * (`SessionError("placement_refused")`) instead of attaching;
215
+ * 7. the placing write records exactly `placement.owner` in the row's owner cell (no owner of its own derived), and the store
216
+ * answers {@link headOf} for every session it holds — with the row's `incarnation`, the same token the acquired session's
217
+ * metadata carries for a row this store created (a revived child reads its tree's owner off its own row through it).
210
218
  */
211
219
  readonly placements?: {
212
220
  subagent?: {
@@ -322,9 +330,12 @@ export interface SessionStore<S extends SessionStoreSummary = SessionStoreSummar
322
330
  * from `acquire`, only a session of the occupant it names — a cached view of an occupant the row no longer holds (the row deleted,
323
331
  * or deleted and created again, through another writer — on the File lane a writer in another process too) is not served — so its `incarnation` and the acquired session's metadata agree (the kit pins both); a run's own memory seat reads the session it ACQUIRED instead, never this lookup. The owner is a cell of the row: `null` = anonymous (admitted to every principal) — a row created
324
332
  * with no owner (`acquire` names none), or a row written before the cell existed; a principal name = owned (a cell holding a blank string
325
- * names nobody and is a read fault, never an owner). A placed row carries the owner its placing write recorded: the bundled stores'
326
- * placing write names none (`acquire`'s options and {@link SessionPlacement} carry no principal), so their placed rows read `null`; a
327
- * store's own placing write may record a principal (e.g. a delegation tree's owner), and a reader takes the row's owner as it reads. **Optional**: absent ⇒ no by-id read,
333
+ * names nobody and is a read fault, never an owner). A placed row carries the owner of its delegation tree: the placing write records
334
+ * exactly `placement.owner` ({@link SessionPlacement.owner} — minted by the engine from the tree root's row, as the root run read it, and
335
+ * carried unchanged down the tree), and no store derives an owner of its own; the child's owner VALUE is its root's (`null` when the
336
+ * root is anonymous) — a deployment's gate may still admit an ownerless placed row more narrowly than an ownerless root row, because a
337
+ * row placed before 7.62.0 keeps what its placing write recorded (`null` on the bundled stores, whatever its root's owner), and a
338
+ * descendant spawned from such a row after a revival records that `null` too. **Optional**: absent ⇒ no by-id read,
328
339
  * and a deployment's authorizer, which needs this and {@link register} together, takes its fail-closed arm.
329
340
  */
330
341
  headOf?(sessionId: string): Promise<SessionHead | undefined>;
@@ -0,0 +1,37 @@
1
+ /**
2
+ * The seatbelt confinement a shell start runs under on the engine's macOS host: the launcher, the deny-default base every
3
+ * confined start runs under, the one assembly of a profile from the reads it refuses and the locations it holds in place,
4
+ * and the one wrapping of a start in its floor's profile. Below the engine and the tools both: an environment spawns
5
+ * through {@link confineShellStart} and probes with {@link SEATBELT_PROBE_PROFILE}; the floor's adapter translates its
6
+ * table into the expressions {@link seatbeltProfile} assembles (`ReadFloor.confinement`).
7
+ */
8
+ import type { ReadFloor } from "../internal/harness-types.js";
9
+ /** The seatbelt launcher, by its absolute path (a PATH lookup could run another program in its place). */
10
+ export declare const SANDBOX_EXEC = "/usr/bin/sandbox-exec";
11
+ /** A profile: the base; reads open but for each of `reads` (an expression in the dialect's regex syntax), directory metadata
12
+ * still readable; writes open, and no unlink or create at any of `holds` (a rename cannot carry a refused file out from
13
+ * under its row). No expression on a side ⇒ no block for it. */
14
+ export declare function seatbeltProfile(reads: readonly string[], holds: readonly string[]): string;
15
+ /** The profile of no row: what an environment applies once to learn whether confinement works on this host at all. */
16
+ export declare const SEATBELT_PROBE_PROFILE: string;
17
+ /** A shell start as an environment spawns it: the shell and its arguments, the command last. */
18
+ export interface ShellStart {
19
+ readonly command: string;
20
+ readonly args: readonly string[];
21
+ }
22
+ /**
23
+ * The start confined to `floor` — the one wrapping every environment that spawns on the engine's host takes: no floor ⇒
24
+ * the start as it is (`profile` undefined); a floor ⇒ `sandbox-exec -p <the floor's seatbelt profile>` running the start,
25
+ * with that profile; a floor whose profile cannot be made ⇒ the row and why, and the start must not run. Pure: whether the
26
+ * host can apply a profile at all is the environment's probe, and an apply that fails at the start is the environment's to
27
+ * refuse.
28
+ */
29
+ export declare function confineShellStart(start: ShellStart, floor: ReadFloor | undefined): {
30
+ readonly ok: true;
31
+ readonly start: ShellStart;
32
+ readonly profile: string | undefined;
33
+ } | {
34
+ readonly ok: false;
35
+ readonly row: string;
36
+ readonly reason: string;
37
+ };
@@ -0,0 +1,56 @@
1
+ export const SANDBOX_EXEC = "/usr/bin/sandbox-exec";
2
+ const SEATBELT_BASE = [
3
+ "(version 1)", "(deny default)", "(allow process-exec)", "(allow process-fork)", "(allow process-info* (target same-sandbox))",
4
+ "(allow signal (target same-sandbox))", "(allow mach-priv-task-port (target same-sandbox))", "(allow user-preference-read)", "(allow mach-lookup",
5
+ "(global-name \"com.apple.audio.systemsoundserver\")", "(global-name \"com.apple.distributed_notifications@Uv3\")",
6
+ "(global-name \"com.apple.FontObjectsServer\")", "(global-name \"com.apple.fonts\")", "(global-name \"com.apple.logd\")",
7
+ "(global-name \"com.apple.lsd.mapdb\")", "(global-name \"com.apple.PowerManagement.control\")", "(global-name \"com.apple.system.logger\")",
8
+ "(global-name \"com.apple.system.notification_center\")", "(global-name \"com.apple.system.opendirectoryd.libinfo\")",
9
+ "(global-name \"com.apple.system.opendirectoryd.membership\")", "(global-name \"com.apple.bsd.dirhelper\")",
10
+ "(global-name \"com.apple.securityd.xpc\")", "(global-name \"com.apple.coreservices.launchservicesd\")", ")", "(allow ipc-posix-shm)",
11
+ "(allow ipc-posix-sem)", "(allow iokit-open", "(iokit-registry-entry-class \"IOSurfaceRootUserClient\")",
12
+ "(iokit-registry-entry-class \"RootDomainUserClient\")", "(iokit-user-client-class \"IOSurfaceSendRight\")", ")", "(allow iokit-get-properties)",
13
+ "(allow system-socket (require-all (socket-domain AF_SYSTEM) (socket-protocol 2)))", "(allow sysctl-read", "(sysctl-name \"hw.activecpu\")",
14
+ "(sysctl-name \"hw.busfrequency_compat\")", "(sysctl-name \"hw.byteorder\")", "(sysctl-name \"hw.cacheconfig\")",
15
+ "(sysctl-name \"hw.cachelinesize_compat\")", "(sysctl-name \"hw.cpufamily\")", "(sysctl-name \"hw.cpufrequency\")",
16
+ "(sysctl-name \"hw.cpufrequency_compat\")", "(sysctl-name \"hw.cputype\")", "(sysctl-name \"hw.l1dcachesize_compat\")",
17
+ "(sysctl-name \"hw.l1icachesize_compat\")", "(sysctl-name \"hw.l2cachesize_compat\")", "(sysctl-name \"hw.l3cachesize_compat\")",
18
+ "(sysctl-name \"hw.logicalcpu\")", "(sysctl-name \"hw.logicalcpu_max\")", "(sysctl-name \"hw.machine\")", "(sysctl-name \"hw.memsize\")",
19
+ "(sysctl-name \"hw.ncpu\")", "(sysctl-name \"hw.nperflevels\")", "(sysctl-name \"hw.packages\")", "(sysctl-name \"hw.pagesize_compat\")",
20
+ "(sysctl-name \"hw.pagesize\")", "(sysctl-name \"hw.physicalcpu\")", "(sysctl-name \"hw.physicalcpu_max\")",
21
+ "(sysctl-name \"hw.tbfrequency_compat\")", "(sysctl-name \"hw.vectorunit\")", "(sysctl-name \"kern.argmax\")", "(sysctl-name \"kern.bootargs\")",
22
+ "(sysctl-name \"kern.hostname\")", "(sysctl-name \"kern.maxfiles\")", "(sysctl-name \"kern.maxfilesperproc\")", "(sysctl-name \"kern.maxproc\")",
23
+ "(sysctl-name \"kern.ngroups\")", "(sysctl-name \"kern.osproductversion\")", "(sysctl-name \"kern.osrelease\")", "(sysctl-name \"kern.ostype\")",
24
+ "(sysctl-name \"kern.osvariant_status\")", "(sysctl-name \"kern.osversion\")", "(sysctl-name \"kern.secure_kernel\")",
25
+ "(sysctl-name \"kern.tcsm_available\")", "(sysctl-name \"kern.tcsm_enable\")", "(sysctl-name \"kern.usrstack64\")", "(sysctl-name \"kern.version\")",
26
+ "(sysctl-name \"kern.willshutdown\")", "(sysctl-name \"machdep.cpu.brand_string\")", "(sysctl-name \"machdep.ptrauth_enabled\")",
27
+ "(sysctl-name \"security.mac.lockdown_mode_state\")", "(sysctl-name \"sysctl.proc_cputype\")", "(sysctl-name \"vm.loadavg\")",
28
+ "(sysctl-name-prefix \"hw.optional.arm\")", "(sysctl-name-prefix \"hw.optional.arm.\")", "(sysctl-name-prefix \"hw.optional.armv8_\")",
29
+ "(sysctl-name-prefix \"hw.perflevel\")", "(sysctl-name-prefix \"kern.proc.all\")", "(sysctl-name-prefix \"kern.proc.pgrp.\")",
30
+ "(sysctl-name-prefix \"kern.proc.pid.\")", "(sysctl-name-prefix \"machdep.cpu.\")", "(sysctl-name-prefix \"net.routetable.\")", ")",
31
+ "(allow sysctl-write", "(sysctl-name \"kern.tcsm_enable\")", ")", "(allow distributed-notification-post)",
32
+ "(allow mach-lookup (global-name \"com.apple.SecurityServer\"))", "(allow file-ioctl (literal \"/dev/null\"))",
33
+ "(allow file-ioctl (literal \"/dev/zero\"))", "(allow file-ioctl (literal \"/dev/random\"))", "(allow file-ioctl (literal \"/dev/urandom\"))",
34
+ "(allow file-ioctl (literal \"/dev/dtracehelper\"))", "(allow file-ioctl (literal \"/dev/tty\"))",
35
+ "(allow file-ioctl file-read-data file-write-data", "(require-all", "(literal \"/dev/null\")", "(vnode-type CHARACTER-DEVICE)", ")", ")",
36
+ "(allow network*)",
37
+ ];
38
+ export function seatbeltProfile(reads, holds) {
39
+ const filters = (xs) => xs.map((x) => `(regex ${JSON.stringify(x)})`);
40
+ const lines = [...SEATBELT_BASE, "(allow file-read*)"];
41
+ if (reads.length > 0)
42
+ lines.push("(deny file-read*", ...filters(reads), ")", "(allow file-read-metadata (vnode-type DIRECTORY))");
43
+ lines.push("(allow file-write*)");
44
+ if (holds.length > 0)
45
+ lines.push("(deny file-write-unlink file-write-create", ...filters(holds), ")");
46
+ return lines.join("\n");
47
+ }
48
+ export const SEATBELT_PROBE_PROFILE = seatbeltProfile([], []);
49
+ export function confineShellStart(start, floor) {
50
+ if (floor === undefined)
51
+ return { ok: true, start, profile: undefined };
52
+ const c = floor.confinement("seatbelt");
53
+ if (!c.ok)
54
+ return c;
55
+ return { ok: true, start: { command: SANDBOX_EXEC, args: ["-p", c.profile, start.command, ...start.args] }, profile: c.profile };
56
+ }
@@ -5,7 +5,7 @@ import { inlineUntrusted } from "./untrusted-text.js";
5
5
  import { boundInputHashOf } from "./canonical-json.js";
6
6
  import { NOT_BINDABLE } from "./skill-grant-binding.js";
7
7
  import { readToolNameList } from "./tool-name-list.js";
8
- import { closestName } from "./task-registry-shared.js";
8
+ import { closestName } from "./closest-name.js";
9
9
  import { allowingRows, strippedInAuto, compileAllowList, readRuleEntry, inertEntryPhrase, judgeAllowEntries, nonListValueLabel, renderListEntry, spelledListEntry } from "./allow-entry.js";
10
10
  export const SKILL_GRANT_ORIGINS = Object.freeze(["model", "user", "inherited"]);
11
11
  const FROZEN_SKILL_GRANT_ORIGINS = new Set(["model", "inherited"]);
@@ -57,13 +57,16 @@ export declare function checkpointListByScopeSummaries(store: CheckpointStore):
57
57
  /** The canonical expected summary projection (what `summarizeCheckpoint` must yield for the fixture above). */
58
58
  export declare const EXPECTED_LISTBYSCOPE_SUMMARIES: ({
59
59
  token: string;
60
+ rowVerdict: {
61
+ kind: string;
62
+ };
60
63
  sessionId: string;
61
64
  scope: string;
62
65
  gateKind: string;
63
66
  severity: number;
64
67
  deadline: number;
65
68
  createdAt: number;
66
- sourceTaskId: string;
69
+ sourceSessionId: string;
67
70
  principal: string;
68
71
  toolCallId: string;
69
72
  toolName: string;
@@ -75,6 +78,9 @@ export declare const EXPECTED_LISTBYSCOPE_SUMMARIES: ({
75
78
  spentMicroUsd?: undefined;
76
79
  } | {
77
80
  token: string;
81
+ rowVerdict: {
82
+ kind: string;
83
+ };
78
84
  sessionId: string;
79
85
  scope: string;
80
86
  gateKind: string;
@@ -82,7 +88,7 @@ export declare const EXPECTED_LISTBYSCOPE_SUMMARIES: ({
82
88
  createdAt: number;
83
89
  severity?: undefined;
84
90
  deadline?: undefined;
85
- sourceTaskId?: undefined;
91
+ sourceSessionId?: undefined;
86
92
  principal?: undefined;
87
93
  toolCallId?: undefined;
88
94
  toolName?: undefined;
@@ -1,6 +1,8 @@
1
1
  import { strict as assert } from "node:assert";
2
2
  import { executionVerdict } from "../checkpoint-execution-record.js";
3
3
  import { MAX_PENDING_STEER_ENTRIES, checkpointIndexFacts, mintCheckpointToken, readPendingSteerQueue, } from "../checkpoint-store.js";
4
+ import { judgeCheckpointRow } from "../checkpoint-row-verdict.js";
5
+ import { memberPresent } from "../own-property-receipt.js";
4
6
  import { checkpointFrom } from "../pause-registry.js";
5
7
  import { beginContract } from "./contract-harness.js";
6
8
  export function createCheckpointFixture(over = {}) {
@@ -31,6 +33,11 @@ export function createCheckpointFixture(over = {}) {
31
33
  ...over,
32
34
  });
33
35
  }
36
+ function damagedWriteFaceFixture(over) {
37
+ const cp = createCheckpointFixture(over);
38
+ Reflect.set(cp.state, "writeFace", { face: "neither" });
39
+ return cp;
40
+ }
34
41
  export const ALLOW = {
35
42
  gate: "policy_ask",
36
43
  decision: "allow",
@@ -275,6 +282,48 @@ export async function checkpointStoreContract(make, runAssertion, options = {})
275
282
  assert.equal(list[0].token, pending.token);
276
283
  assert.equal((await store.get(pending.token)).status, "pending");
277
284
  });
285
+ run("rowVerdict: every listed summary's verdict equals judgeCheckpointRow of the row get hands back (an ok row, a damaged row), and editing a listed summary's preview leaves the stored row as it was", async () => {
286
+ const store = make();
287
+ const okRow = createCheckpointFixture({
288
+ sessionId: "verdict-ok",
289
+ pendingAction: { kind: "tool_approval", origin: "policy", toolCallId: "call-3", toolName: "Write", args: { path: "/x", content: "y" }, preview: { lines: ["a"] }, boundInputHash: "h0", boundGrantAbsence: "not_bindable", batchToolCallIds: ["call-3"], completedCallIds: [] },
290
+ });
291
+ const damagedRow = damagedWriteFaceFixture({ sessionId: "verdict-damaged" });
292
+ for (const cp of [okRow, damagedRow])
293
+ await store.put(cp.token, cp);
294
+ const listed = await store.listByScope("tenant-a");
295
+ assert.equal(listed.length, 2);
296
+ assert.equal(judgeCheckpointRow(okRow).kind, "ok");
297
+ assert.equal(judgeCheckpointRow(damagedRow).kind, "damaged");
298
+ for (const s of listed)
299
+ assert.deepEqual(s.rowVerdict, judgeCheckpointRow((await store.get(s.token))), `the listing and the get judge one row (${s.sessionId})`);
300
+ const byId = new Map(listed.map((s) => [s.sessionId, s]));
301
+ byId.get("verdict-ok").preview.lines.push("edited on the summary");
302
+ const stored = (await store.get(okRow.token)).pendingAction;
303
+ assert.deepEqual(stored.preview, { lines: ["a"] }, "a summary's preview is a copy: editing it does not edit the stored row");
304
+ const relisted = new Map((await store.listByScope("tenant-a")).map((s) => [s.sessionId, s]));
305
+ assert.deepEqual(relisted.get("verdict-ok").preview, { lines: ["a"] });
306
+ });
307
+ run("rowVerdict: a listed verdict is the verdict judged now — on a second listing, and (deleteSessionCheckpoints offered) after a token's row is replaced by a damaged one", async () => {
308
+ const store = make();
309
+ const row = createCheckpointFixture({ sessionId: "memo-row" });
310
+ await store.put(row.token, row);
311
+ const first = (await store.listByScope("tenant-a")).find((s) => s.token === row.token);
312
+ const second = (await store.listByScope("tenant-a")).find((s) => s.token === row.token);
313
+ assert.deepEqual(first.rowVerdict, judgeCheckpointRow((await store.get(row.token))));
314
+ assert.deepEqual(second.rowVerdict, first.rowVerdict);
315
+ const heads = options.sessionHeads;
316
+ if (store.deleteSessionCheckpoints === undefined || heads === undefined)
317
+ return;
318
+ heads.set("memo-row", { owner: null });
319
+ if ((await store.deleteSessionCheckpoints("memo-row", { owner: null })) !== 1)
320
+ return;
321
+ const replaced = damagedWriteFaceFixture({ token: row.token, sessionId: "memo-row" });
322
+ await store.put(replaced.token, replaced);
323
+ const after = (await store.listByScope("tenant-a")).find((s) => s.token === row.token);
324
+ assert.equal(after.rowVerdict.kind, "damaged", "a replaced row is judged again, never answered from the verdict its predecessor had");
325
+ assert.deepEqual(after.rowVerdict, judgeCheckpointRow((await store.get(row.token))));
326
+ });
278
327
  run("#438 hasBidiControls three-form matrix: a row's `true` survives + projects; absent stays absent (clean args); an out-of-contract `false` reads as absent; a bit-less marked row backfills at projection", async () => {
279
328
  const store = make();
280
329
  const RLO = String.fromCodePoint(0x202e);
@@ -430,6 +479,19 @@ export async function checkpointStoreContract(make, runAssertion, options = {})
430
479
  const bareBack = (await store.get(bare.token));
431
480
  assert.equal("requires" in bareBack || "requirementsDigest" in bareBack, false, "a row without a list or digest must stay without (never [] / null / \"\")");
432
481
  });
482
+ run("held rows: a row's `heldRows` (the conversation rows owed after its leaf) survive the round-trip verbatim — every row, in its order, each member of each (text blocks, a string content, `provenance`, `rewrittenBy`); a row without them stays without", async () => {
483
+ const store = make();
484
+ const heldRows = [
485
+ { role: "user", content: "first note", timestamp: 1, provenance: "engine-note" },
486
+ { role: "user", content: [{ type: "text", text: "second note, rewritten" }], timestamp: 2, provenance: "engine-note", rewrittenBy: ["scrubber", "tagger"] },
487
+ ];
488
+ const held = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "held-rows", heldRows });
489
+ const bare = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "held-none" });
490
+ for (const cp of [held, bare])
491
+ await store.put(cp.token, cp);
492
+ assert.deepEqual((await store.get(held.token)).heldRows, heldRows, "the held rows must survive the round-trip as the same rows, in the same order, every member kept");
493
+ assert.equal("heldRows" in (await store.get(bare.token)), false, "a row without held rows must stay without (never [] / null)");
494
+ });
433
495
  run("run origin: a row's `state.runOrigin` survives the round-trip verbatim and rides the listing; absent stays absent; a word outside the set is kept on the row and reads as absent in the listing", async () => {
434
496
  const store = make();
435
497
  const member = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "ro-member" });
@@ -447,6 +509,23 @@ export async function checkpointStoreContract(make, runAssertion, options = {})
447
509
  assert.equal((await store.get(bogus.token)).state.runOrigin, "weekly", "a word outside the set must be kept on the row verbatim");
448
510
  assert.equal("runOrigin" in byId.get("ro-bogus"), false, "a word outside the closed set must read as absent in the listing, never project verbatim");
449
511
  });
512
+ run("member presence: a row whose top level and `state` carry members holding undefined reads them absent — the value undefined (`memberPresent` false), the listing without them — and judges as its twin without the keys", async () => {
513
+ const store = make();
514
+ const holding = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "mp-holding" });
515
+ Object.assign(holding, { deadline: undefined, humanReview: undefined });
516
+ Object.assign(holding.state, { compositionLeg: undefined, rowTaskId: undefined });
517
+ const omitted = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "mp-omitted" });
518
+ for (const cp of [holding, omitted])
519
+ await store.put(cp.token, cp);
520
+ const got = (await store.get(holding.token));
521
+ for (const name of ["deadline", "humanReview"])
522
+ assert.equal(memberPresent(got, name), false, `a top-level ${name} holding undefined must read absent`);
523
+ for (const name of ["compositionLeg", "rowTaskId"])
524
+ assert.equal(memberPresent(got.state, name), false, `a state.${name} holding undefined must read absent`);
525
+ const listed = (await store.listByScope("tenant-a")).find((s) => s.sessionId === "mp-holding");
526
+ assert.equal("deadline" in listed, false, "the listing must leave out a deadline that holds undefined");
527
+ assert.deepEqual(judgeCheckpointRow(got), judgeCheckpointRow((await store.get(omitted.token))), "a member holding undefined must judge as the member left out");
528
+ });
450
529
  run("decider pair: a policy-decided allow resolves like a person's — its `policy_allowed` record (party `policy`, the attribution) round-trips verbatim on the resolved winner and as the execution record; the same record is already_recorded, a person's record for that row conflicts", async () => {
451
530
  const store = make();
452
531
  const cp = createCheckpointFixture();
@@ -633,7 +712,7 @@ export async function checkpointListByScopeSummaries(store) {
633
712
  sessionId: "needs-approval",
634
713
  deadline: 1_999_999_999_999,
635
714
  createdAt: 1_700_000_000_000,
636
- sourceTaskId: "needs-approval",
715
+ sourceSessionId: "needs-approval",
637
716
  principal: "alice@corp",
638
717
  gate: {
639
718
  kind: "human",
@@ -675,13 +754,14 @@ export async function checkpointListByScopeSummaries(store) {
675
754
  export const EXPECTED_LISTBYSCOPE_SUMMARIES = [
676
755
  {
677
756
  token: "tok-escalation",
757
+ rowVerdict: { kind: "ok" },
678
758
  sessionId: "needs-approval",
679
759
  scope: "tenant-a",
680
760
  gateKind: "human",
681
761
  severity: 5,
682
762
  deadline: 1_999_999_999_999,
683
763
  createdAt: 1_700_000_000_000,
684
- sourceTaskId: "needs-approval",
764
+ sourceSessionId: "needs-approval",
685
765
  principal: "alice@corp",
686
766
  toolCallId: "call-pr",
687
767
  toolName: "open_pr",
@@ -693,6 +773,7 @@ export const EXPECTED_LISTBYSCOPE_SUMMARIES = [
693
773
  },
694
774
  {
695
775
  token: "tok-resource",
776
+ rowVerdict: { kind: "ok" },
696
777
  sessionId: "out-of-budget",
697
778
  scope: "tenant-a",
698
779
  gateKind: "resource_limit",
@@ -1,3 +1,6 @@
1
- import type { FileHistoryStore } from "../file-history-store.js";
1
+ import { type FileHistoryStore } from "../file-history-store.js";
2
2
  import { type ContractAssertionRunner } from "./contract-harness.js";
3
- export declare function fileHistoryStoreContract(make: () => FileHistoryStore, runAssertion?: ContractAssertionRunner): Promise<void>;
3
+ export declare function fileHistoryStoreContract(make: () => FileHistoryStore, runAssertion?: ContractAssertionRunner, onOptionalMember?: (report: {
4
+ member: "blobExchange";
5
+ status: "verified" | "absent";
6
+ }) => void): Promise<void>;
@@ -3,6 +3,7 @@ import { createHash } from "node:crypto";
3
3
  import { chmod, mkdtemp, mkdir, rm, stat, symlink, writeFile, readFile } from "node:fs/promises";
4
4
  import { tmpdir } from "node:os";
5
5
  import { join } from "node:path";
6
+ import { fileHistoryBlobExchangeOf } from "../file-history-store.js";
6
7
  import { isGovernanceRetryClass } from "../governance-codes.js";
7
8
  import { NodeExecutionEnv } from "../../internal/harness.js";
8
9
  import { beginContract } from "./contract-harness.js";
@@ -51,8 +52,31 @@ async function withTree(fn) {
51
52
  await rm(dir, { recursive: true, force: true });
52
53
  }
53
54
  }
54
- export async function fileHistoryStoreContract(make, runAssertion) {
55
+ export async function fileHistoryStoreContract(make, runAssertion, onOptionalMember) {
55
56
  const { run, settle } = beginContract(runAssertion);
57
+ run("blobExchange (optional member group): read as one group; put checks the address and stores nothing it refuses; has answers from the index; get round-trips; absence is REPORTED", async () => {
58
+ const exchange = fileHistoryBlobExchangeOf(make());
59
+ if (exchange === undefined) {
60
+ onOptionalMember?.({ member: "blobExchange", status: "absent" });
61
+ return;
62
+ }
63
+ const bytes = new TextEncoder().encode("bytes another machine sent ahead of its import");
64
+ const other = new TextEncoder().encode("different bytes");
65
+ const hash = createHash("sha256").update(bytes).digest("hex");
66
+ const otherHash = createHash("sha256").update(other).digest("hex");
67
+ assert.deepEqual([...(await exchange.has([hash]))], [], "nothing is held before the put");
68
+ assert.equal(await exchange.get(hash), undefined, "get answers undefined for bytes the store does not hold");
69
+ const wrong = await exchange.put(otherHash, bytes);
70
+ assert.equal(wrong.ok, false, "bytes that do not hash to the address are refused");
71
+ assert.equal(!wrong.ok && wrong.error.code, "adopt_failed", "the refusal is the adoption family's word");
72
+ assert.equal(!wrong.ok && wrong.error.permanence, "terminal", "no retry makes the bytes hash differently");
73
+ assert.deepEqual([...(await exchange.has([otherHash, hash]))], [], "a refused put stores nothing under either address");
74
+ assert.deepEqual(await exchange.put(hash, bytes), { ok: true });
75
+ assert.deepEqual(await exchange.put(hash, bytes), { ok: true }, "a repeat put is idempotent");
76
+ assert.deepEqual([...(await exchange.has([hash, otherHash]))], [hash], "has names the held ones only");
77
+ assert.deepEqual([...((await exchange.get(hash)) ?? [])], [...bytes], "get round-trips the bytes");
78
+ onOptionalMember?.({ member: "blobExchange", status: "verified" });
79
+ });
56
80
  run("absent everything: canRestore=false, restore=failed/not_found with an empty ledger, reap=0 — and none of it throws", async () => {
57
81
  await withTree(async (dir, env) => {
58
82
  const store = make();