@sema-agent/core 7.60.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/CHANGELOG.md +605 -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 +61 -10
  6. package/dist/agents/cascade.js +60 -20
  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-notice-route.d.ts +1 -1
  17. package/dist/agents/peer-notice-route.js +4 -3
  18. package/dist/agents/peer-notices.d.ts +4 -4
  19. package/dist/agents/peer-notices.js +8 -4
  20. package/dist/agents/peer-session-drain.d.ts +8 -1
  21. package/dist/agents/peer-session-drain.js +36 -7
  22. package/dist/agents/repair-loop.js +16 -6
  23. package/dist/agents/retain-ledger.js +3 -1
  24. package/dist/agents/roster-store.d.ts +1 -1
  25. package/dist/agents/roster-store.js +7 -4
  26. package/dist/agents/send-message-tool.d.ts +8 -10
  27. package/dist/agents/send-message-tool.js +43 -23
  28. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  29. package/dist/agents/subagent-completion-gate.js +62 -0
  30. package/dist/agents/subagent-steps.d.ts +7 -6
  31. package/dist/agents/subagent.d.ts +30 -40
  32. package/dist/agents/subagent.js +187 -196
  33. package/dist/agents/suspend-guard.d.ts +9 -0
  34. package/dist/agents/suspend-guard.js +4 -0
  35. package/dist/agents/verify.d.ts +41 -14
  36. package/dist/agents/verify.js +37 -27
  37. package/dist/brain/anthropic.js +1 -0
  38. package/dist/brain/errors.d.ts +7 -1
  39. package/dist/brain/errors.js +6 -0
  40. package/dist/brain/failover.js +2 -1
  41. package/dist/brain/open-responses.js +1 -0
  42. package/dist/brain/openai.js +1 -0
  43. package/dist/brain/provider-dialect.d.ts +10 -0
  44. package/dist/brain/provider-dialect.js +13 -2
  45. package/dist/brain/stream-engine.d.ts +3 -0
  46. package/dist/brain/stream-engine.js +4 -0
  47. package/dist/core/agent-state.d.ts +1 -1
  48. package/dist/core/allow-entry.d.ts +59 -23
  49. package/dist/core/allow-entry.js +131 -38
  50. package/dist/core/ask-origin.d.ts +79 -0
  51. package/dist/core/ask-origin.js +76 -0
  52. package/dist/core/ask-question.d.ts +19 -13
  53. package/dist/core/ask-question.js +8 -2
  54. package/dist/core/auto-compaction.d.ts +2 -0
  55. package/dist/core/auto-compaction.js +2 -1
  56. package/dist/core/auto-mode.js +3 -5
  57. package/dist/core/background-agent-store.d.ts +7 -5
  58. package/dist/core/background-agent-store.js +12 -11
  59. package/dist/core/checkpoint-requirements.d.ts +24 -3
  60. package/dist/core/checkpoint-requirements.js +9 -1
  61. package/dist/core/checkpoint-store.d.ts +78 -19
  62. package/dist/core/checkpoint-store.js +8 -4
  63. package/dist/core/child-clamp-seats.d.ts +3 -2
  64. package/dist/core/child-clamp-seats.js +4 -3
  65. package/dist/core/closest-name.d.ts +13 -0
  66. package/dist/core/closest-name.js +35 -0
  67. package/dist/core/context-settings.js +3 -5
  68. package/dist/core/cross-boundary-taint.d.ts +1 -1
  69. package/dist/core/decision-receipt.d.ts +14 -1
  70. package/dist/core/decision-receipt.js +6 -3
  71. package/dist/core/delegation-frames.d.ts +13 -9
  72. package/dist/core/effective-path-target.js +2 -3
  73. package/dist/core/engine-attestation.d.ts +11 -1
  74. package/dist/core/engine-attestation.js +2 -0
  75. package/dist/core/engine-notice.d.ts +49 -18
  76. package/dist/core/file-history-retention.d.ts +8 -0
  77. package/dist/core/file-history-retention.js +14 -11
  78. package/dist/core/file-history-store.d.ts +31 -1
  79. package/dist/core/file-history-store.js +31 -2
  80. package/dist/core/frame-settlement.d.ts +10 -0
  81. package/dist/core/frame-settlement.js +6 -1
  82. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  83. package/dist/core/fs-write-gate-policy.js +8 -7
  84. package/dist/core/gate-fold.js +2 -1
  85. package/dist/core/gate-lanes.js +7 -4
  86. package/dist/core/gate-outcome.d.ts +40 -1
  87. package/dist/core/gate-outcome.js +10 -0
  88. package/dist/core/git-worktree-env.d.ts +7 -3
  89. package/dist/core/git-worktree-env.js +16 -13
  90. package/dist/core/governance-codes.d.ts +12 -4
  91. package/dist/core/governance-codes.js +16 -4
  92. package/dist/core/hooks.d.ts +12 -4
  93. package/dist/core/hooks.js +11 -4
  94. package/dist/core/host-floor.js +3 -5
  95. package/dist/core/image-admission.d.ts +48 -8
  96. package/dist/core/image-admission.js +35 -4
  97. package/dist/core/input-author.d.ts +36 -0
  98. package/dist/core/input-author.js +39 -0
  99. package/dist/core/leg-identity.d.ts +62 -0
  100. package/dist/core/leg-identity.js +18 -0
  101. package/dist/core/locked-config.d.ts +2 -1
  102. package/dist/core/locked-config.js +5 -3
  103. package/dist/core/lsp.d.ts +5 -3
  104. package/dist/core/lsp.js +3 -2
  105. package/dist/core/mailbox-store.d.ts +85 -10
  106. package/dist/core/mailbox-store.js +31 -10
  107. package/dist/core/mcp-connection-pool.d.ts +6 -20
  108. package/dist/core/mcp-connection-pool.js +10 -28
  109. package/dist/core/mcp-failure.d.ts +76 -15
  110. package/dist/core/mcp-failure.js +60 -33
  111. package/dist/core/mcp-host-seat.d.ts +92 -53
  112. package/dist/core/mcp-host-seat.js +220 -46
  113. package/dist/core/mcp-probe.js +2 -2
  114. package/dist/core/mcp-server-link.d.ts +18 -6
  115. package/dist/core/mcp-server-link.js +19 -4
  116. package/dist/core/mcp-server-spec.d.ts +2 -1
  117. package/dist/core/mcp-session-end.d.ts +1 -2
  118. package/dist/core/mcp-session-end.js +1 -1
  119. package/dist/core/mcp.d.ts +6 -49
  120. package/dist/core/mcp.js +115 -111
  121. package/dist/core/media-byte-cap.d.ts +21 -46
  122. package/dist/core/media-byte-cap.js +55 -55
  123. package/dist/core/member-group.d.ts +7 -0
  124. package/dist/core/member-group.js +35 -0
  125. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  126. package/dist/core/memory-engine/consolidation.js +7 -1
  127. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  128. package/dist/core/memory-engine/dual-root.js +59 -11
  129. package/dist/core/memory-engine/engine.js +27 -24
  130. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  131. package/dist/core/memory-engine/file-backend.js +35 -15
  132. package/dist/core/memory-engine/layout.d.ts +3 -0
  133. package/dist/core/memory-engine/layout.js +13 -3
  134. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  135. package/dist/core/memory-engine/memory-deployment.js +182 -0
  136. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  137. package/dist/core/memory-engine/sync-client.js +72 -14
  138. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  139. package/dist/core/memory-engine/sync.d.ts +9 -1
  140. package/dist/core/mode-policy.d.ts +8 -8
  141. package/dist/core/mode-policy.js +7 -5
  142. package/dist/core/mods/agent-stations.d.ts +39 -4
  143. package/dist/core/mods/agent-stations.js +59 -10
  144. package/dist/core/mods/dollar.d.ts +62 -0
  145. package/dist/core/mods/extension-call.d.ts +15 -1
  146. package/dist/core/mods/extension-call.js +7 -2
  147. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  148. package/dist/core/mods/kernel/dispatch.js +4 -4
  149. package/dist/core/mods/kernel/events.d.ts +4 -1
  150. package/dist/core/mods/kernel/events.js +6 -6
  151. package/dist/core/mods/kernel/registration.d.ts +3 -0
  152. package/dist/core/mods/kernel/registration.js +5 -0
  153. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  154. package/dist/core/mods/kernel/site-rules.js +10 -2
  155. package/dist/core/mods/session-append.d.ts +115 -0
  156. package/dist/core/mods/session-append.js +311 -0
  157. package/dist/core/mods/session-compact.d.ts +48 -0
  158. package/dist/core/mods/session-compact.js +194 -0
  159. package/dist/core/mods/session-receive.d.ts +93 -0
  160. package/dist/core/mods/session-receive.js +141 -0
  161. package/dist/core/mods/session-send.d.ts +72 -0
  162. package/dist/core/mods/session-send.js +88 -0
  163. package/dist/core/mods/stations.d.ts +38 -16
  164. package/dist/core/mods/stations.js +25 -11
  165. package/dist/core/mods/tool-call.d.ts +2 -0
  166. package/dist/core/mods/tool-call.js +4 -4
  167. package/dist/core/output-style.js +3 -4
  168. package/dist/core/own-property-receipt.d.ts +61 -2
  169. package/dist/core/own-property-receipt.js +42 -2
  170. package/dist/core/park-selfcheck.js +4 -2
  171. package/dist/core/path-identity.d.ts +11 -0
  172. package/dist/core/path-identity.js +4 -0
  173. package/dist/core/path-rule-binding.d.ts +3 -1
  174. package/dist/core/path-rule-binding.js +3 -1
  175. package/dist/core/peer-seat.d.ts +3 -3
  176. package/dist/core/peer-seat.js +20 -8
  177. package/dist/core/permission-rule-consent.d.ts +21 -5
  178. package/dist/core/permission-rule-consent.js +21 -1
  179. package/dist/core/permission-rule-model.d.ts +34 -11
  180. package/dist/core/permission-rule-model.js +47 -10
  181. package/dist/core/permission-rule-org.d.ts +1 -1
  182. package/dist/core/permission-rule-provider.js +4 -1
  183. package/dist/core/permission-rules.d.ts +4 -0
  184. package/dist/core/permission-rules.js +11 -16
  185. package/dist/core/remote-env.d.ts +74 -26
  186. package/dist/core/remote-env.js +20 -0
  187. package/dist/core/retention-policy.d.ts +24 -23
  188. package/dist/core/retention-policy.js +36 -2
  189. package/dist/core/retention.d.ts +4 -1
  190. package/dist/core/retired-keys.d.ts +4 -4
  191. package/dist/core/row-admission.d.ts +10 -0
  192. package/dist/core/row-admission.js +5 -0
  193. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  194. package/dist/core/runner/advisor-instructions.js +2 -1
  195. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  196. package/dist/core/runner/assemble-result.d.ts +13 -3
  197. package/dist/core/runner/assemble-result.js +12 -7
  198. package/dist/core/runner/caller-roster.d.ts +12 -9
  199. package/dist/core/runner/caller-roster.js +5 -2
  200. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  201. package/dist/core/runner/checkpoint-scope.js +21 -0
  202. package/dist/core/runner/compact-session.js +14 -2
  203. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  204. package/dist/core/runner/compaction-restate.d.ts +2 -2
  205. package/dist/core/runner/compaction-restate.js +4 -3
  206. package/dist/core/runner/construction-doors.d.ts +2 -2
  207. package/dist/core/runner/construction-doors.js +2 -2
  208. package/dist/core/runner/contracts.d.ts +98 -26
  209. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  210. package/dist/core/runner/decide-continuation.d.ts +4 -2
  211. package/dist/core/runner/decide-continuation.js +7 -4
  212. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  213. package/dist/core/runner/denial-limit-arms.js +17 -10
  214. package/dist/core/runner/expire-settle.d.ts +44 -0
  215. package/dist/core/runner/expire-settle.js +55 -0
  216. package/dist/core/runner/git-status-frame.d.ts +3 -3
  217. package/dist/core/runner/git-status-frame.js +2 -1
  218. package/dist/core/runner/halt-attribution.d.ts +2 -1
  219. package/dist/core/runner/halt-attribution.js +2 -1
  220. package/dist/core/runner/local-claims.d.ts +17 -0
  221. package/dist/core/runner/local-claims.js +18 -0
  222. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  223. package/dist/core/runner/media-removed-seat.js +88 -0
  224. package/dist/core/runner/park-commit.d.ts +2 -2
  225. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  226. package/dist/core/runner/permission-rule-lanes.js +28 -9
  227. package/dist/core/runner/person-path-rows.js +1 -1
  228. package/dist/core/runner/placement-fence.d.ts +26 -0
  229. package/dist/core/runner/placement-fence.js +38 -0
  230. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  231. package/dist/core/runner/prepare-ask-lane.js +4 -4
  232. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  233. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  234. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  235. package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
  236. package/dist/core/runner/prepare-config-doors.js +16 -17
  237. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  238. package/dist/core/runner/prepare-context-lane.js +13 -13
  239. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  240. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  241. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  242. package/dist/core/runner/prepare-execution-env.js +7 -4
  243. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  244. package/dist/core/runner/prepare-gate-stations.js +6 -4
  245. package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
  246. package/dist/core/runner/prepare-hands-readface.js +4 -4
  247. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
  248. package/dist/core/runner/prepare-inherited-gate.js +3 -0
  249. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  250. package/dist/core/runner/prepare-lsp.js +2 -2
  251. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  252. package/dist/core/runner/prepare-park-ask.js +4 -5
  253. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  254. package/dist/core/runner/prepare-policy-chain.js +16 -25
  255. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  256. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  257. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  258. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  259. package/dist/core/runner/prepare-question-face.js +2 -2
  260. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  261. package/dist/core/runner/prepare-run-refs.js +2 -2
  262. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  263. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  264. package/dist/core/runner/prepare-task.d.ts +1 -1
  265. package/dist/core/runner/prepare-task.js +56 -28
  266. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  267. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  268. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  269. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  270. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  271. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  272. package/dist/core/runner/read-root-grant.d.ts +1 -1
  273. package/dist/core/runner/read-root-grant.js +2 -1
  274. package/dist/core/runner/resume-admission.d.ts +5 -3
  275. package/dist/core/runner/resume-admission.js +17 -3
  276. package/dist/core/runner/resume-apply.js +3 -1
  277. package/dist/core/runner/resume-claim.d.ts +8 -3
  278. package/dist/core/runner/resume-claim.js +28 -12
  279. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  280. package/dist/core/runner/resume-internals-and-config.js +10 -1
  281. package/dist/core/runner/resume-preflight.d.ts +3 -2
  282. package/dist/core/runner/resume-preflight.js +13 -26
  283. package/dist/core/runner/retired-runner-deps.js +2 -0
  284. package/dist/core/runner/run-git-lane.js +2 -1
  285. package/dist/core/runner/run-harness-handlers.js +2 -2
  286. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  287. package/dist/core/runner/run-identity-wiring.js +14 -5
  288. package/dist/core/runner/run-leg.d.ts +3 -3
  289. package/dist/core/runner/run-leg.js +40 -29
  290. package/dist/core/runner/run-notification-lane.js +20 -2
  291. package/dist/core/runner/run-recovery-lanes.js +3 -2
  292. package/dist/core/runner/run-settle-and-teardown.js +9 -7
  293. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  294. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  295. package/dist/core/runner/run-terminal-adoption.js +26 -17
  296. package/dist/core/runner/run-turn-boundary.js +27 -14
  297. package/dist/core/runner/runtask.d.ts +18 -3
  298. package/dist/core/runner/runtask.js +27 -11
  299. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  300. package/dist/core/runner/session-rule-policy.js +6 -1
  301. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  302. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  303. package/dist/core/runner/stream-halt-verbs.js +4 -3
  304. package/dist/core/runner/stream-reap.d.ts +7 -6
  305. package/dist/core/runner/stream-reap.js +13 -16
  306. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  307. package/dist/core/runner/stream-settle-backstop.js +5 -3
  308. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  309. package/dist/core/runner/stream-steer-verb.js +8 -7
  310. package/dist/core/runner/terminal-account.d.ts +11 -1
  311. package/dist/core/runner/terminal-account.js +20 -0
  312. package/dist/core/runner/terminal-projection.d.ts +8 -2
  313. package/dist/core/runner/terminal-projection.js +2 -2
  314. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  315. package/dist/core/runner/tool-disclosure.js +5 -2
  316. package/dist/core/runner/tool-end-body.d.ts +3 -3
  317. package/dist/core/runner/tool-end-body.js +1 -1
  318. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  319. package/dist/core/runner/tool-output-projection.js +7 -6
  320. package/dist/core/runner/tool-table-view.d.ts +56 -0
  321. package/dist/core/runner/tool-table-view.js +51 -0
  322. package/dist/core/runner/turn-attachments.d.ts +3 -2
  323. package/dist/core/runner/turn-attachments.js +1 -1
  324. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  325. package/dist/core/runner/void-verifier-pause.js +41 -0
  326. package/dist/core/runner-deps.d.ts +24 -25
  327. package/dist/core/secret-env.d.ts +11 -11
  328. package/dist/core/secret-env.js +8 -9
  329. package/dist/core/session-log-transfer.js +9 -10
  330. package/dist/core/session-policy-store.d.ts +1 -1
  331. package/dist/core/session-policy-store.js +5 -2
  332. package/dist/core/session-reconcile.d.ts +3 -2
  333. package/dist/core/session-reconcile.js +7 -4
  334. package/dist/core/session-store.d.ts +2 -0
  335. package/dist/core/session-store.js +5 -7
  336. package/dist/core/session.d.ts +2 -1
  337. package/dist/core/shell-confinement.d.ts +37 -0
  338. package/dist/core/shell-confinement.js +56 -0
  339. package/dist/core/skill-grant.js +1 -1
  340. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  341. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  342. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  343. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  344. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  345. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  346. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  347. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  348. package/dist/core/task-event.d.ts +17 -8
  349. package/dist/core/task-limits.d.ts +5 -0
  350. package/dist/core/task-notification.d.ts +89 -12
  351. package/dist/core/task-notification.js +87 -13
  352. package/dist/core/task-registry-agent.d.ts +5 -43
  353. package/dist/core/task-registry-agent.js +24 -51
  354. package/dist/core/task-registry-monitor.d.ts +1 -1
  355. package/dist/core/task-registry-monitor.js +15 -60
  356. package/dist/core/task-registry-shared.d.ts +15 -112
  357. package/dist/core/task-registry-shared.js +3 -41
  358. package/dist/core/task-registry-workflow.js +4 -21
  359. package/dist/core/task-registry.d.ts +19 -60
  360. package/dist/core/task-registry.js +19 -106
  361. package/dist/core/task-result.d.ts +24 -7
  362. package/dist/core/task-spec-members.d.ts +39 -0
  363. package/dist/core/task-spec-members.js +92 -0
  364. package/dist/core/task-spec.d.ts +10 -10
  365. package/dist/core/task-tool-shape.d.ts +7 -57
  366. package/dist/core/task-tool-shape.js +7 -66
  367. package/dist/core/terminal-cause.d.ts +30 -0
  368. package/dist/core/terminal-cause.js +1 -0
  369. package/dist/core/tool-catalog-entries.js +2 -5
  370. package/dist/core/tool-check-reading.js +16 -10
  371. package/dist/core/tool-conformance.js +1 -2
  372. package/dist/core/tool-errors.d.ts +6 -3
  373. package/dist/core/tool-errors.js +2 -0
  374. package/dist/core/tool-face-reader.js +3 -2
  375. package/dist/core/tool-face.d.ts +2 -3
  376. package/dist/core/tool-name-aliases.d.ts +5 -29
  377. package/dist/core/tool-name-aliases.js +9 -5
  378. package/dist/core/tool-name-readings.d.ts +14 -3
  379. package/dist/core/tool-name-readings.js +2 -0
  380. package/dist/core/tool-policy.d.ts +108 -18
  381. package/dist/core/tool-policy.js +84 -14
  382. package/dist/core/tool-result-store.d.ts +23 -0
  383. package/dist/core/tool-result-store.js +3 -2
  384. package/dist/core/tool-spec.d.ts +19 -6
  385. package/dist/core/trace.d.ts +18 -1
  386. package/dist/core/user-attachment.js +26 -21
  387. package/dist/core/workflow-journal-store.d.ts +1 -1
  388. package/dist/core/workflow-run-store.d.ts +2 -0
  389. package/dist/core/workflow-run-store.js +6 -5
  390. package/dist/core/workflow-settled-run.d.ts +5 -0
  391. package/dist/core/workflow-settled-run.js +7 -0
  392. package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
  393. package/dist/engine/execution-env/node-execution-env.js +213 -21
  394. package/dist/engine/harness/agent-harness.d.ts +65 -18
  395. package/dist/engine/harness/agent-harness.js +90 -23
  396. package/dist/engine/harness/messages.d.ts +4 -3
  397. package/dist/engine/harness/messages.js +2 -2
  398. package/dist/engine/harness/types.d.ts +41 -7
  399. package/dist/engine/llm/media-removed.d.ts +14 -0
  400. package/dist/engine/llm/media-removed.js +9 -0
  401. package/dist/engine/llm/rejected-images.d.ts +35 -25
  402. package/dist/engine/llm/rejected-images.js +59 -10
  403. package/dist/engine/llm/types.d.ts +24 -3
  404. package/dist/engine/llm/types.js +7 -3
  405. package/dist/engine/loop/agent-loop.d.ts +6 -1
  406. package/dist/engine/loop/agent-loop.js +20 -11
  407. package/dist/engine/loop/types.d.ts +12 -3
  408. package/dist/engine/session/import-validate.js +7 -0
  409. package/dist/fixtures/index.d.ts +7 -5
  410. package/dist/fixtures/index.js +5 -3
  411. package/dist/index.d.ts +21 -11
  412. package/dist/index.js +15 -7
  413. package/dist/internal/harness-types.d.ts +2 -0
  414. package/dist/internal/llm.d.ts +2 -1
  415. package/dist/internal/llm.js +1 -0
  416. package/dist/orchestration/goal.d.ts +6 -2
  417. package/dist/orchestration/goal.js +6 -3
  418. package/dist/orchestration/run-workflow-tool.d.ts +11 -17
  419. package/dist/orchestration/run-workflow-tool.js +19 -42
  420. package/dist/orchestration/workflow-governance.d.ts +1 -1
  421. package/dist/orchestration/workflow-types.d.ts +2 -2
  422. package/dist/orchestration/workflow.d.ts +4 -0
  423. package/dist/orchestration/workflow.js +8 -5
  424. package/dist/stores/file/background-agent-store.js +18 -15
  425. package/dist/stores/file/checkpoint-store.js +7 -4
  426. package/dist/stores/file/file-history-store.js +3 -2
  427. package/dist/stores/file/index.d.ts +5 -3
  428. package/dist/stores/file/index.js +23 -8
  429. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  430. package/dist/stores/file/ledger-tuning.js +21 -0
  431. package/dist/stores/file/mailbox-store.js +42 -22
  432. package/dist/stores/file/memory-store.js +3 -2
  433. package/dist/stores/file/permission-rule-adopt.js +24 -21
  434. package/dist/stores/file/permission-rule-store.js +6 -3
  435. package/dist/stores/file/session-policy-store.js +3 -2
  436. package/dist/stores/file/session-store.d.ts +16 -3
  437. package/dist/stores/file/session-store.js +21 -20
  438. package/dist/stores/file/tool-result-store.d.ts +11 -0
  439. package/dist/stores/file/tool-result-store.js +57 -3
  440. package/dist/stores/file/usage-window-store.js +3 -2
  441. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  442. package/dist/stores/file/workflow-journal-store.js +3 -18
  443. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  444. package/dist/stores/file/workflow-run-store.js +15 -10
  445. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  446. package/dist/tools/fs/dead-cwd.js +4 -11
  447. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  448. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  449. package/dist/tools/fs/fs-bash.d.ts +3 -18
  450. package/dist/tools/fs/fs-bash.js +37 -124
  451. package/dist/tools/fs/fs-pdf.js +8 -6
  452. package/dist/tools/fs/fs-read.js +2 -2
  453. package/dist/tools/fs/fs-shared.d.ts +28 -3
  454. package/dist/tools/fs/fs-shared.js +15 -0
  455. package/dist/tools/fs/index.d.ts +1 -1
  456. package/dist/tools/fs/index.js +4 -14
  457. package/dist/tools/fs/pdf.d.ts +4 -4
  458. package/dist/tools/fs/pdf.js +6 -6
  459. package/dist/tools/fs/read-deny-home.js +8 -1
  460. package/dist/tools/fs/read-deny.d.ts +26 -2
  461. package/dist/tools/fs/read-deny.js +9 -2
  462. package/dist/tools/fs/read-floor.d.ts +13 -5
  463. package/dist/tools/fs/read-floor.js +206 -2
  464. package/dist/tools/fs/search.d.ts +3 -2
  465. package/dist/tools/fs/search.js +6 -6
  466. package/dist/tools/fs/shell-read-establish.js +3 -1
  467. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  468. package/dist/tools/fs/shell-read-identity.js +4 -2
  469. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  470. package/dist/tools/fs/shell-read-judge.js +1 -1
  471. package/dist/tools/monitor.d.ts +8 -7
  472. package/dist/tools/monitor.js +12 -10
  473. package/dist/tools/worktree.d.ts +5 -1
  474. package/dist/tools/worktree.js +20 -17
  475. package/package.json +6 -3
  476. package/test/export-surface.snapshot.json +92 -10
  477. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  478. package/wire-changes/core@7.61.0.json +4405 -0
  479. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  480. package/wire-changes/primitives@7.61.0.json +30 -0
  481. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  482. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1,6 +1,7 @@
1
1
  import { strict as assert } from "node:assert";
2
- import { MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_INVALID_PEER_META_CODE, MAILBOX_INVALID_DECISION_MOVE_CODE, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_TOMBSTONED_RECIPIENT_CODE } from "../mailbox-store.js";
2
+ import { MAILBOX_CONSUMED_ID_WINDOW, MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_INVALID_PEER_META_CODE, MAILBOX_INVALID_DECISION_MOVE_CODE, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_TOMBSTONED_RECIPIENT_CODE, mailboxRecipientLifecycleOf } from "../mailbox-store.js";
3
3
  import { beginContract } from "./contract-harness.js";
4
+ import { thrownText } from "../thrown-value.js";
4
5
  import { PRINCIPAL_INBOX_HANDLE } from "../../agents/cross-session-ref.js";
5
6
  import { mintCrossPrincipalRecord } from "../../agents/org-delivery-gate.js";
6
7
  export const MAILBOX_CONTRACT_SCOPE = "default";
@@ -50,7 +51,7 @@ export async function mailboxStoreContract(mk, runAssertion) {
50
51
  await s.ack(S, "a1", "w3", 1);
51
52
  assert.equal(await s.append(S, "a1", msg("m2")), 2);
52
53
  });
53
- run("记录身份:箱持有同 id 时 append = 同记录回原 seq 零写 / 异记录点名拒;坏 id 零副作用拒;id 往返;ack 后 id 自由", async (make) => {
54
+ run("记录身份:箱持有同 id 时 append = 同记录回原 seq 零写 / 异记录点名拒;坏 id 零副作用拒;id 往返;ack 后进已收窗", async (make) => {
54
55
  const s = make();
55
56
  const codeOf = async (p) => {
56
57
  try {
@@ -78,7 +79,89 @@ export async function mailboxStoreContract(mk, runAssertion) {
78
79
  const lease = await s.claimLease(S, "a1", "w1", 60_000, 10_000);
79
80
  assert.deepEqual(lease.messages.map((m) => m.id), ["frame-1", undefined], "id 往返,缺席仍缺席");
80
81
  await s.ack(S, "a1", "w1", lease.maxSeq);
81
- assert.equal(await s.append(S, "a1", rec), 3, "箱只为它持有的记录作答:ack 后同 id 是新记录");
82
+ assert.equal(await s.append(S, "a1", rec), 1, "箱为它收过的记录作答:ack 后同记录在已收窗内,回原 seq");
83
+ assert.equal(await s.peekCount(S, "a1"), 0, "窗内重放零写");
84
+ });
85
+ const K = MAILBOX_CONSUMED_ID_WINDOW;
86
+ const rec = (id, content = `body-${id}`) => ({ id, from: "w", content, sentAt: 1_000, hopChain: ["h"], peerMeta: { kind: "peer_message", fromRoot: "root" } });
87
+ const consume = async (s, handle, owner) => {
88
+ const l = await s.claimLease(S, handle, owner, 60_000, 10_000);
89
+ assert.notEqual(l, null);
90
+ assert.deepEqual(await s.ack(S, handle, owner, l.maxSeq), { acked: true });
91
+ };
92
+ const codeAndMessage = async (p) => {
93
+ try {
94
+ await p;
95
+ return {};
96
+ }
97
+ catch (e) {
98
+ return { code: e.code, message: thrownText(e) };
99
+ }
100
+ };
101
+ run("W1 窗内同记录:append(X) → claim → ack → 同面 append(X) ⇒ 首个 seq,零写,再 claim = null", async (make) => {
102
+ const s = make();
103
+ assert.equal(await s.append(S, "a1", rec("X")), 1);
104
+ await consume(s, "a1", "w1");
105
+ assert.equal(await s.append(S, "a1", { ...rec("X"), sentAt: 9_000 }), 1, "写入时刻不同仍是同一条(sentAt 不是面)");
106
+ assert.equal(await s.peekCount(S, "a1"), 0);
107
+ assert.equal(await s.claimLease(S, "a1", "w2", 60_000, 20_000), null);
108
+ });
109
+ run("W2 窗内异记录:同 id 换内容 ⇒ mailbox.duplicate_record_id,拒句点名 content,零写", async (make) => {
110
+ const s = make();
111
+ await s.append(S, "a1", rec("X"));
112
+ await consume(s, "a1", "w1");
113
+ const refused = await codeAndMessage(s.append(S, "a1", rec("X", "another body")));
114
+ assert.equal(refused.code, MAILBOX_DUPLICATE_RECORD_ID_CODE);
115
+ assert.match(refused.message ?? "", /content/);
116
+ assert.equal(await s.peekCount(S, "a1"), 0);
117
+ });
118
+ run("W3 窗外:X 收后再收 K 条带 id 记录 ⇒ append(X) = 高水位 + 1,箱里一条", async (make) => {
119
+ const s = make();
120
+ await s.append(S, "a1", rec("X"));
121
+ await consume(s, "a1", "w1");
122
+ for (let i = 0; i < K; i++)
123
+ await s.append(S, "a1", rec(`Y${i}`));
124
+ await consume(s, "a1", "w2");
125
+ assert.equal(await s.append(S, "a1", rec("X")), K + 2, "出窗的 id 是新记录");
126
+ assert.equal(await s.peekCount(S, "a1"), 1);
127
+ });
128
+ run("W4 窗只算带 id:X 收后再收 K 条无 id 记录 ⇒ append(X) 仍回首个 seq", async (make) => {
129
+ const s = make();
130
+ await s.append(S, "a1", rec("X"));
131
+ await consume(s, "a1", "w1");
132
+ for (let i = 0; i < K; i++)
133
+ await s.append(S, "a1", msg(`plain-${i}`));
134
+ await consume(s, "a1", "w2");
135
+ assert.equal(await s.append(S, "a1", rec("X")), 1);
136
+ assert.equal(await s.peekCount(S, "a1"), 0);
137
+ });
138
+ run("W5 寿命:drop 清窗(seq 从 1 重来);reap 留窗,且 reap 清掉的未投记录不进窗", async (make) => {
139
+ const s = make();
140
+ await s.append(S, "a1", rec("X"));
141
+ await consume(s, "a1", "w1");
142
+ await s.drop(S, "a1");
143
+ assert.equal(await s.append(S, "a1", rec("X")), 1, "drop 结束箱的一生:窗随之清,X 是新记录(seq 1)");
144
+ assert.equal(await s.peekCount(S, "a1"), 1);
145
+ const r = make();
146
+ await r.append(S, "b1", rec("X"));
147
+ await consume(r, "b1", "w1");
148
+ await r.append(S, "b1", rec("Z"));
149
+ assert.equal(await r.reap(S, 100_000, { maxAgeMs: 50_000 }), 1);
150
+ assert.equal(await r.append(S, "b1", rec("X")), 1, "reap 留窗:X 仍在窗内");
151
+ assert.equal(await r.append(S, "b1", rec("Z")), 3, "reap 清掉的 Z 从没被收过:新记录,高水位之后");
152
+ });
153
+ run("W8 窗序:第 K + 1 条更新的带 id 记录被收的那一刻最旧那条出窗(分两批 ack)", async (make) => {
154
+ const s = make();
155
+ await s.append(S, "a1", rec("X"));
156
+ await consume(s, "a1", "w1");
157
+ for (let i = 0; i < K - 1; i++)
158
+ await s.append(S, "a1", rec(`Y${i}`));
159
+ await consume(s, "a1", "w2");
160
+ assert.equal(await s.append(S, "a1", rec("X")), 1, "窗里恰 K 条,X 是最旧的一条,仍在");
161
+ await s.append(S, "a1", rec("Y-last"));
162
+ await consume(s, "a1", "w3");
163
+ assert.equal(await s.append(S, "a1", rec("Y0")), 2, "次旧的那条仍在窗内");
164
+ assert.equal(await s.append(S, "a1", rec("X")), K + 2, "第 K + 1 条进窗,X 出窗:新记录");
82
165
  });
83
166
  run("lease 窗内 append:后到消息在下次 claim 时可见(lease 只覆盖 claim 时刻快照)", async (make) => {
84
167
  const s = make();
@@ -427,6 +510,22 @@ export async function mailboxCrossProcessContract(hooks) {
427
510
  assert.equal(await peer.peekCount(S, H), 0);
428
511
  assert.equal(await peer.append(S, H, msg("after", 200_000)), 3, "高水位跨 reap 存活(对方视角)");
429
512
  });
513
+ run("W7 已收窗跨进程:一方 append + ack 带 id 的 X,另一方同记录 append(X) ⇒ 首个 seq 零写;异记录 ⇒ 带码拒", async (local, peer) => {
514
+ const x = { id: "frame-x", from: "w", content: "status", sentAt: 1_000, hopChain: ["h"], peerMeta: { kind: "peer_message", fromRoot: "root" } };
515
+ assert.equal(await local.append(S, H, x), 1);
516
+ const held = await local.claimLease(S, H, "cycle-local", 60_000, 10_000);
517
+ assert.deepEqual(await local.ack(S, H, "cycle-local", held.maxSeq), { acked: true });
518
+ assert.equal(await peer.append(S, H, { ...x, sentAt: 5_000 }), 1, "对方进程看得见本方收进窗的记录:同记录回首个 seq");
519
+ assert.equal(await peer.peekCount(S, H), 0, "零写");
520
+ let code;
521
+ try {
522
+ await peer.append(S, H, { ...x, content: "another" });
523
+ }
524
+ catch (e) {
525
+ code = e.code;
526
+ }
527
+ assert.equal(code, MAILBOX_DUPLICATE_RECORD_ID_CODE);
528
+ });
430
529
  run("reap 与 drop 的 seq 语义跨进程:一方 reap 后另一方继续高水位;一方 drop 后另一方从 1 重铸", async (local, peer) => {
431
530
  await peer.append(S, H, msg("old", 1_000));
432
531
  assert.equal(await local.reap(S, 100_000, { maxAgeMs: 50_000 }), 1, "本方 reap 必须看见对方写的旧消息");
@@ -444,9 +543,57 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
444
543
  const run = (name, fn) => runRaw(name, () => withStores(mk, fn));
445
544
  const S = MAILBOX_CONTRACT_SCOPE;
446
545
  const codeOf = (e) => e?.code;
546
+ const tombstone = async (s, scope, handle) => {
547
+ const pair = mailboxRecipientLifecycleOf(s);
548
+ if (pair === undefined) {
549
+ assert.notEqual(hooks.tombstone, undefined, "nothing puts a recipient into the pre-delete state: the store carries no retireRecipient and no tombstone hook was given");
550
+ return hooks.tombstone(s, scope, handle);
551
+ }
552
+ assert.equal(await pair.retireRecipient(scope, handle, 1_000_000, "label"), true, "retireRecipient answers true when it wrote the tombstone");
553
+ };
554
+ run("收件人生命周期一对成员是一项能力:要么都在、要么都缺;都在时不再另收 tombstone 钩子(同一个态不许两种写法)", async (make) => {
555
+ let carriesPair = false;
556
+ try {
557
+ carriesPair = mailboxRecipientLifecycleOf(make()) !== undefined;
558
+ }
559
+ catch (e) {
560
+ assert.fail(`the store's recipient-lifecycle pair cannot be read: ${thrownText(e)}`);
561
+ }
562
+ assert.equal(carriesPair && hooks.tombstone !== undefined, false, "the store writes its own pre-delete state (retireRecipient), so a tombstone hook is a second way to write it");
563
+ assert.equal(carriesPair || hooks.tombstone !== undefined, true, "nothing puts a recipient into the pre-delete state: no retireRecipient on the store and no tombstone hook");
564
+ });
565
+ run("收件人生命周期一对(可选成员):在则逐条验 —— 只打标、列表、重写、随箱亡;缺席如实上报,不算失败", async (make) => {
566
+ const pair = mailboxRecipientLifecycleOf(make());
567
+ if (pair === undefined) {
568
+ hooks.onOptionalMember?.({ member: "recipientLifecycle", status: "absent" });
569
+ return;
570
+ }
571
+ const listed = make();
572
+ const lp = mailboxRecipientLifecycleOf(listed);
573
+ assert.equal(await lp.retireRecipient(S, "session.a1", 5_000, "Plan"), true, "retireRecipient answers true when it wrote the tombstone");
574
+ await lp.retireRecipient(S, "agent.b1", 6_000);
575
+ await lp.retireRecipient("tenant-b", "session.c1", 7_000);
576
+ assert.deepEqual(await lp.listRetiredRecipients(S, "session."), [{ handle: "session.a1", retiredAt: 5_000, label: "Plan" }], "清单按 (scope, 前缀) 列出 handle / retiredAt / label");
577
+ assert.deepEqual(await lp.listRetiredRecipients(S, "agent."), [{ handle: "agent.b1", retiredAt: 6_000 }], "清单按 (scope, 前缀):no label ⇒ no label member");
578
+ assert.deepEqual(await lp.listRetiredRecipients("tenant-b", "agent."), [], "清单按 (scope, 前缀):a prefix lists only its own handles, in its own scope");
579
+ const again = make();
580
+ const ap = mailboxRecipientLifecycleOf(again);
581
+ await ap.retireRecipient(S, "session.a1", 5_000, "old");
582
+ await ap.retireRecipient(S, "session.a1", 9_000, "new");
583
+ assert.deepEqual(await ap.listRetiredRecipients(S, "session."), [{ handle: "session.a1", retiredAt: 9_000, label: "new" }], "重复 retire 更新时刻与名字,清单里仍是一行");
584
+ const dropped = make();
585
+ const dp = mailboxRecipientLifecycleOf(dropped);
586
+ await dropped.append(S, "session.a1", msg("before"));
587
+ await dp.retireRecipient(S, "session.a1", 5_000);
588
+ await assert.rejects(dropped.append(S, "session.a1", msg("refused")), (e) => codeOf(e) === MAILBOX_TOMBSTONED_RECIPIENT_CODE);
589
+ await dropped.drop(S, "session.a1");
590
+ assert.deepEqual(await dp.listRetiredRecipients(S, "session."), [], "墓碑随箱亡:drop removes the tombstone with the box");
591
+ assert.equal(await dropped.append(S, "session.a1", msg("registered again")), 1, "墓碑随箱亡:an id registered again is a new recipient (seq 1)");
592
+ hooks.onOptionalMember?.({ member: "recipientLifecycle", status: "verified" });
593
+ });
447
594
  run("预删除态的收件人:append 响亮拒且带码(既不静默收下级联即将删掉的消息,也不裸抛)", async (make) => {
448
595
  const s = make();
449
- await hooks.tombstone(s, S, "a1");
596
+ await tombstone(s, S, "a1");
450
597
  let thrown;
451
598
  try {
452
599
  await s.append(S, "a1", msg("m1"));
@@ -467,19 +614,19 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
467
614
  });
468
615
  run("拒的粒度是收件人,不是开关:同 scope 下另一个活收件人照常收信", async (make) => {
469
616
  const s = make();
470
- await hooks.tombstone(s, S, "a1");
617
+ await tombstone(s, S, "a1");
471
618
  assert.equal(await s.append(S, "a2", msg("still-live")), 1, "活收件人不受邻居的删除级联牵连");
472
619
  assert.equal(await s.peekCount(S, "a2"), 1);
473
620
  });
474
621
  run("收件人身份是 (scope, handle) 整体:A 租户的删除级联不得拒掉 B 租户的同名收件人", async (make) => {
475
622
  const s = make();
476
- await hooks.tombstone(s, "tenant-a", "a1");
623
+ await tombstone(s, "tenant-a", "a1");
477
624
  assert.equal(await s.append("tenant-b", "a1", msg("other-tenant")), 1, "同名 handle 在另一个租户下是另一个收件人");
478
625
  assert.equal(await s.peekCount("tenant-b", "a1"), 1);
479
626
  });
480
627
  run("两件套还得是单射的:把 (scope, handle) 拼成一个字符串记态,不得让两个不同收件人撞成一个", async (make) => {
481
628
  const s = make();
482
- await hooks.tombstone(s, "tenant a", "b");
629
+ await tombstone(s, "tenant a", "b");
483
630
  assert.equal(await s.append("tenant", "a b", msg("distinct-recipient")), 1, "拼键歧义不得把另一个收件人一起拒掉");
484
631
  assert.equal(await s.peekCount("tenant", "a b"), 1);
485
632
  });
@@ -488,7 +635,7 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
488
635
  await s.append(S, "a1", msg("in-flight"));
489
636
  const held = await s.claimLease(S, "a1", "consumer-A", 60_000, 10_000);
490
637
  assert.equal(held?.messages.length, 1);
491
- await hooks.tombstone(s, S, "a1");
638
+ await tombstone(s, S, "a1");
492
639
  await assert.rejects(s.append(S, "a1", msg("after-tombstone", 2_000)), "预删除态下的 append 必须拒");
493
640
  assert.equal(await s.claimLease(S, "a1", "rival", 60_000, 11_000), null, "A 的活租约必须仍然 fence 住别人");
494
641
  await s.ack(S, "a1", "consumer-A", held.maxSeq);
@@ -497,7 +644,7 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
497
644
  run("拒的是入口,不是清仓:被拒的 append 零副作用,已入箱的消息按原 seq/内容原封不动", async (make) => {
498
645
  const s = make();
499
646
  const seq = await s.append(S, "a1", msg("parked-before"));
500
- await hooks.tombstone(s, S, "a1");
647
+ await tombstone(s, S, "a1");
501
648
  let thrown;
502
649
  let refused = false;
503
650
  try {
@@ -20,6 +20,6 @@ import { type ContractAssertionRunner } from "./contract-harness.js";
20
20
  * exactly the divergence the two legs above exist to prevent.
21
21
  */
22
22
  export declare function toolResultStoreContract(make: () => ToolResultStore, runAssertion?: ContractAssertionRunner, onOptionalMember?: (report: {
23
- member: "deleteBySession" | "listBySession";
23
+ member: "deleteBySession" | "listBySession" | "reap";
24
24
  status: "verified" | "absent";
25
25
  }) => void): Promise<void>;
@@ -117,5 +117,35 @@ export async function toolResultStoreContract(make, runAssertion, onOptionalMemb
117
117
  }
118
118
  onOptionalMember?.({ member: "listBySession", status: "verified" });
119
119
  });
120
+ run("reap (optional): no bound removes nothing, a bad bound is refused, age alone decides; absence is REPORTED, not silently green", async () => {
121
+ const probe = make();
122
+ if (probe.reap === undefined) {
123
+ onOptionalMember?.({ member: "reap", status: "absent" });
124
+ return;
125
+ }
126
+ assert.equal(typeof probe.reap, "function", `reap is present but not callable (got ${typeof probe.reap}) — a garbage member is a DEFECT, not an optional-member absence`);
127
+ const store = make();
128
+ const reap = async (now, opts) => Promise.resolve(Reflect.apply(store.reap, store, [now, opts]));
129
+ await store.put("tr_age~owned", "OWNED-bytes", { sessionId: "sess-A" });
130
+ await store.put("tr_age~unowned", "UNOWNED-bytes");
131
+ const later = Date.now() + 3_600_000;
132
+ assert.equal(await reap(later), 0, "no opts ⇒ nothing is aged out");
133
+ assert.equal(await reap(later, {}), 0, "no maxAgeMs ⇒ nothing is aged out");
134
+ for (const bad of [Number.NaN, -1, Number.POSITIVE_INFINITY, "60000"]) {
135
+ await assert.rejects(reap(later, { maxAgeMs: bad }), (e) => e.code === "config.retention_policy_invalid", `maxAgeMs ${String(bad)} is refused, coded`);
136
+ }
137
+ await assert.rejects(reap(Number.NaN, { maxAgeMs: 1 }), (e) => e.code === "config.retention_policy_invalid", "a now that is not a number is refused, coded");
138
+ assert.equal((await store.get("tr_age~owned")).content, "OWNED-bytes", "a refused sweep removed nothing");
139
+ assert.equal(await reap(later, { maxAgeMs: 2 * 3_600_000 }), 0, "an entry younger than the bound is kept");
140
+ assert.equal((await store.get("tr_age~unowned")).content, "UNOWNED-bytes");
141
+ assert.equal(await reap(later, { maxAgeMs: 60_000 }), 2, "every entry older than the bound is removed, owned or not");
142
+ assert.equal(await store.get("tr_age~owned"), undefined);
143
+ assert.equal(await store.get("tr_age~unowned"), undefined);
144
+ assert.equal(await store.ownerOf("tr_age~owned"), undefined, "the owner record goes with the content");
145
+ assert.equal(await reap(later, { maxAgeMs: 60_000 }), 0, "idempotent");
146
+ await store.put("tr_age~owned", "NEW-bytes", { sessionId: "sess-B" });
147
+ assert.deepEqual(await store.ownerOf("tr_age~owned"), { sessionId: "sess-B" }, "a reaped ref is free for a new owner");
148
+ onOptionalMember?.({ member: "reap", status: "verified" });
149
+ });
120
150
  await settle();
121
151
  }
@@ -31,7 +31,8 @@ export interface TaskEventIdentity {
31
31
  /**
32
32
  * design/122 S2 (the `WorkflowRun.sourceTaskId` family, NOT a second `taskId` — that
33
33
  * field already exists on `task_progress` and a duplicate would bite consumers) — the ORIGINATING task's
34
- * canonical id (`spec.taskId ?? sessionId`), stamped ONLY on the content events of a task running AS A
34
+ * canonical id (the leg's single task id mint: a background sub-agent's registry task id, else the
35
+ * declared task id, else the session id), stamped ONLY on the content events of a task running AS A
35
36
  * SUB-AGENT (same condition as {@link parentToolCallId}). A consumer of the C1 forward channel
36
37
  * (`forwardSubagentEvents`) can key a child's content events by the child task directly, without an
37
38
  * alias table. A TOP-LEVEL task's own events carry NO `sourceTaskId` (absent = the consumer's current
@@ -457,8 +458,8 @@ export type TaskEvent = ({
457
458
  * text plus whatever else it carries) — with any block that is neither text nor an admitted image/document, at its
458
459
  * serialization — are one character stream under the text cap, cut IN
459
460
  * PLACE where the cap runs out (that block ends with the marker, the stream's later blocks leave); MEDIA blocks are not
460
- * measured against the text cap and ride AS-IS while the leg's media budget lasts (`RunnerDeps.mediaByteCapBytes`,
461
- * default `AGGREGATE_MEDIA_BUDGET_BYTES`: decoded bytes, spent as base64 on the wire — x 4/3 — after the text's
461
+ * measured against the text cap and ride AS-IS while the leg's media budget lasts (`RunnerDeps.mediaBudgetBase64Chars`,
462
+ * default `IMAGE_ADMISSION.request.budgetBase64Chars`: base64 characters, spent as wire bytes after the text's
462
463
  * serialized size), past which a block becomes `{ type, mimeType?, bytes, truncated: true }` in its slot (never a
463
464
  * string; a media type over 255 characters is not echoed), and when not even a descriptor fits, it and every later
464
465
  * media block fold into ONE `{ type: "omitted", blocks, bytes, truncated: true }` in its slot, so the media in an event
@@ -478,7 +479,7 @@ export type TaskEvent = ({
478
479
  /**
479
480
  * design/116 (b) — the tool's CC-shaped `toolUseResult` facts (`details.type` ∈ the known card
480
481
  * set: edit/create/update/bash/text/grep/glob/notebook-edit/notebook/file_unchanged/mcp/image/
481
- * document/worktree/todo/task/task-list/task-output/task-stop/agent/fork/workflow-run/web-fetch/
482
+ * document/worktree/todo/task/task-list/task-stop/agent/fork/workflow-run/web-fetch/
482
483
  * web-search/cron-create/cron-delete/cron-list/tool-search/repo-map/monitor-start/
483
484
  * enter-plan-mode/exit-plan-mode/report-findings/schedule-wakeup/send-message/agent-transcript/
484
485
  * a2a/path_not_in_root/readonly_out_of_root/read_unestablished/advisor), surfaced on the live wire so a CC-faithful shell
@@ -850,6 +851,10 @@ export type TaskEvent = ({
850
851
  * (summaryMs ?? 0) + persistMs === {@link durationMs} (exact tiling; `summaryMs` absent on a
851
852
  * provider-reuse pass — no summary LLM call happened). Absent on legacy emitters. */
852
853
  phaseDurations?: import("./auto-compaction.js").CompactionPhaseDurations;
854
+ /** Who asked for this pass when an extension did: present when the pass served a manual request an extension made
855
+ * (`$.session.compact`, by its registration name — the last such caller when several requests coalesced onto the
856
+ * pass); absent on every other pass, a `compact()` request of the host's included. A display and audit fact only. */
857
+ requestedBy?: ExtensionRequester;
853
858
  } & TaskEventIdentity) | ({
854
859
  /**
855
860
  * RB-398-b④: a compaction pass concluded WITHOUT landing — the non-landing outcomes
@@ -889,6 +894,9 @@ export type TaskEvent = ({
889
894
  * started — `blocked`, `suppressed`, `disabled`, `noop`, a `mooted` request no boundary served — and on the
890
895
  * rapid-refill `disabled` frame, which reports a state the landing before it caused, not that pass's end. */
891
896
  pass?: string;
897
+ /** Who asked for this pass when an extension did — the `compacted` frame's member of the same name, on the same
898
+ * condition: present when the outcome is a manual request's an extension made (`$.session.compact`). */
899
+ requestedBy?: ExtensionRequester;
892
900
  } & TaskEventIdentity) | ({
893
901
  /**
894
902
  * A compaction pass is under way: the engine has committed to it and is about to produce its summary.
@@ -1104,7 +1112,8 @@ export type TaskEvent = ({
1104
1112
  * `spawn_depth` (the nesting is the `parentTaskId` chain), and the shell/monitor-only members.
1105
1113
  */
1106
1114
  type: "task_started";
1107
- /** The child RUN's id (`spec.taskId ?? sessionId`) — the key its `task_progress` frames carry. */
1115
+ /** The child leg's task id (a background sub-agent's registry task id, else its session id) — the
1116
+ * key its `task_progress` frames carry. */
1108
1117
  taskId: string;
1109
1118
  /** The child run's session id — the handle its transcript is read by. */
1110
1119
  sessionId: string;
@@ -1145,9 +1154,9 @@ export type TaskEvent = ({
1145
1154
  * Live/ephemeral — NOT persisted (a resumable trace re-derives usage from the result), like `status`.
1146
1155
  * Maps to CC `SDKTaskProgress` (camelCase here → snake_case `task_id`/`total_tokens`/`tool_uses`/`duration_ms`
1147
1156
  * at the SDK/service projection, the same convention as `toolCallId`→`tool_use_id`).
1148
- * `taskId` is the child RUN's id (`spec.taskId ?? sessionId`), NOT the registry handle: the
1149
- * background lanes launch with no explicit `spec.taskId`, so it equals the child's session id and
1150
- * hence its `transcriptId`. Both domains are tabled in `docs/INTEGRATION-CORE.md` §1.6a.
1157
+ * `taskId` is the child leg's task id, minted once by the child's prepare: a background
1158
+ * sub-agent's is its registry task id (the `a…` handle TaskStop / TaskOutput / SendMessage take),
1159
+ * a foreground child's is its session id. One child, one id — `docs/INTEGRATION-CORE.md` §1.6a.
1151
1160
  */
1152
1161
  type: "task_progress";
1153
1162
  taskId: string;
@@ -23,6 +23,11 @@ import type { ModelRef } from "./model-seat.js";
23
23
  *
24
24
  * **Priority.** Several axes may be armed at once; the first to trip stops the run. When more than one
25
25
  * trips at the same turn boundary the attribution order is tokens > cost > turns > walltime.
26
+ *
27
+ * **One task, several legs.** The verification gate and the repair loop run one task as several `runTask` legs; they read
28
+ * the task's whole-task ceilings (these windows on a task that cannot suspend, the `resourceSuspend` totals on one that can)
29
+ * as the TASK's, and dispatch each later leg on what the legs before it left (`src/agents/composition-allowance.ts`).
30
+ * `runGoal` and the cascade keep a per-iteration / per-rung allowance.
26
31
  */
27
32
  export interface TaskLimits {
28
33
  /**
@@ -14,11 +14,13 @@ export type SystemInjectionPriority = "now" | "next" | "later";
14
14
  * session's next run in this process (a process restart loses it);
15
15
  * · `parked_durably` — no live lane; appended to the session's DURABLE box
16
16
  * ({@link PendingSessionNotifications.bindSessionBox}) — the next run drains it, in any process;
17
- * · `dropped_duplicate` — the session already delivered this exact frame.
17
+ * · `dropped_duplicate` — the session already delivered this exact frame;
18
+ * · `refused` — a live lane took it and the session's receiving station did not hand it over: an extension consumed it,
19
+ * or a handler there failed ({@link FrameReceiver}). The model never saw it, and it is not owed again.
18
20
  * The park backend is the seat's choice ({@link routeOrParkNotification}), never the producer's.
19
21
  */
20
- export type NotificationInjectionOutcome = "queued" | "parked" | "parked_durably" | "dropped_duplicate";
21
- export declare const NOTIFICATION_INJECTION_OUTCOMES: readonly ["queued", "parked", "parked_durably", "dropped_duplicate"];
22
+ export type NotificationInjectionOutcome = "queued" | "parked" | "parked_durably" | "dropped_duplicate" | "refused";
23
+ export declare const NOTIFICATION_INJECTION_OUTCOMES: readonly ["queued", "parked", "parked_durably", "dropped_duplicate", "refused"];
22
24
  /** Is `value` one of the injector's outcome words? A host-wired uplink may answer anything (a bare
23
25
  * `void`, an array's `push` count) — such an answer reads as "outcome not reported", never as a word. */
24
26
  export declare function isNotificationInjectionOutcome(value: unknown): value is NotificationInjectionOutcome;
@@ -207,7 +209,7 @@ export interface TaskNotificationPayload {
207
209
  resumable?: boolean;
208
210
  /** A cross-channel correlation key for ONE completion event — the same task's completion fans out
209
211
  * across several independent read faces (this live notification frame, a durable inbox entry, and the
210
- * `TaskOutput` poll projection). Minted ONCE per completion, fill-once (first writer wins), on the
212
+ * host task poll projection). Minted ONCE per completion, fill-once (first writer wins), on the
211
213
  * same task-registry handle/record every read face serves from — see
212
214
  * {@link "./task-registry.js".UnifiedTaskOutput.completionId} for the shared contract (open-shape
213
215
  * `string`, absent until terminal settle, absent on a pre-P1-3 core build). Deliberately ABSENT on
@@ -285,7 +287,38 @@ export interface TaskNotificationPayload {
285
287
  * and the record's typed peer metadata rides in `peerMeta` (on a notice frame its `notice` is THE typed notice).
286
288
  */
287
289
  _sema_provenance?: SemaProvenance;
290
+ /**
291
+ * The text a receiving extension handed the model in place of this frame's rendering (the `session.receive` station,
292
+ * {@link FrameReceiver}), and who changed it. Set only on the copy a delivery carries — never on the frame a producer,
293
+ * a park or a box holds — and {@link renderTaskNotificationXml} returns it verbatim: every face that renders the frame
294
+ * (the live lane, the turn-open redelivery, a `ReadInbox` result, its receipt ask) reads the one rendering.
295
+ */
296
+ received?: {
297
+ readonly text: string;
298
+ readonly rewrittenBy: readonly string[];
299
+ };
288
300
  }
301
+ /**
302
+ * The session's one receiving station (`session.receive`): every face a frame reaches the model by — the live lane (a
303
+ * producer's injection, a frame routed in from another run of the session, a peer letter the box drain pushes), the
304
+ * turn-open redelivery of what was parked, and the box's `ReadInbox` pull — hands the frame to it before the hand-over, and
305
+ * hands over what it answers. Awaited; with no handler listening, nothing is raised and a caller keeps its own path.
306
+ */
307
+ export interface FrameReceiver {
308
+ /** Does a handler listen? `false` ⇒ the frame passes as made, and nothing is raised. */
309
+ listens(): boolean;
310
+ /** What becomes of `payload`: handed over (the frame, or a copy carrying {@link TaskNotificationPayload.received}), or
311
+ * consumed — not handed over, by the extension `by` (or the engine, when the station could not judge), for `reason`. */
312
+ receive(payload: TaskNotificationPayload): Promise<ReceivedFrame>;
313
+ }
314
+ export type ReceivedFrame = {
315
+ readonly kind: "arrived";
316
+ readonly payload: TaskNotificationPayload;
317
+ } | {
318
+ readonly kind: "consumed";
319
+ readonly by: string;
320
+ readonly reason: string;
321
+ };
289
322
  /** design/385 §1.4 d1 / §4.1 — see {@link TaskNotificationPayload._sema_provenance}. `kind` is a
290
323
  * closed set of the engine carriers that mint the record; a future carrier adds a member, never a
291
324
  * second key. */
@@ -515,16 +548,22 @@ export declare function terminalFrameFacets(facts: {
515
548
  warning?: string | undefined;
516
549
  compaction?: TaskNotificationPayload["compaction"] | undefined;
517
550
  }): Pick<TaskNotificationPayload, "spawnName" | "handback" | "compaction">;
551
+ /** What the deployment hears when a report the frame carried whole could not be stored: the task row keeps no read handle. */
552
+ export declare const SHORT_REPORT_UNSTORED = "a background task's report could not be stored (the write failed or went unconfirmed): its completion frame carried the whole report, but its task row keeps no read handle for a later list";
518
553
  /**
519
554
  * A delegated child's report as its completion frame carries it — the one value the parent's notification and the fleet
520
555
  * terminal projected from that frame both read: redacted BEFORE the cut, with the pass the task row's copy uses (a token
521
- * across the cut is never half-shown), then cut with an honest total. A report longer than the frame carries is the task's
522
- * result artifact: `persist` stores the whole redacted report and the cut line names what it answered — awaited first, so
523
- * the frame never names a ref whose write has not landed. `ref` = the stored ref, for the task row. Absent in ⇒ absent out.
556
+ * across the cut is never half-shown), then cut with an honest total. The report is the task's result artifact whatever its
557
+ * length: `persist` stores the whole redacted report and `record` hands the stored ref to the task row as its read handle
558
+ * (a list of tasks names it when the frame itself is lost) — only after the write landed. A report longer than the frame
559
+ * carries is cut, and its cut line names that ref, so the frame waits for the write; a report the frame carries whole does
560
+ * not wait (its write lands on its own and records the ref then — a stalled store never holds a complete answer back).
561
+ * That unawaited write still has a failure path: a write that went unconfirmed, or anything thrown on the way, reaches the
562
+ * caller's `notifier` (its first failure per site is disclosed on the deployment's channel), never the floor. `record`
563
+ * names the settle the result belongs to, so a write landing after the row moved on records nothing. Absent in ⇒ absent out.
524
564
  */
525
- export declare function completionResultField(result: string | undefined, persist: (report: string) => Promise<import("./tool-result-store.js").TaskArtifact>): Promise<{
565
+ export declare function completionResultField(result: string | undefined, persist: (report: string) => Promise<import("./tool-result-store.js").TaskArtifact>, record: (ref: string) => void, notifier: Pick<import("./safe-notify.js").SafeNotifier, "notifyAsync">): Promise<{
526
566
  readonly text: string;
527
- readonly ref?: string;
528
567
  } | undefined>;
529
568
  /** The codec version this engine writes into an `engine_frame` record and the highest it reads. */
530
569
  export declare const ENGINE_FRAME_CODEC_VERSION = 1;
@@ -593,6 +632,18 @@ export declare function isTerminalTaskNotification(n: Pick<TaskNotificationPaylo
593
632
  * another for the delivery.
594
633
  */
595
634
  export declare function resolveCompletionSink<C, M>(callSink: C | undefined, mountSink: M | undefined): C | M | undefined;
635
+ /**
636
+ * THE background admission every producer applies at launch — a background command, a Monitor watch, a background
637
+ * agent, a workflow run, a continued agent: the launch is made only when its completion will come back — the one
638
+ * resolved completion sink ({@link resolveCompletionSink}) is there, or the deployment wired a channel of its own for
639
+ * this producer outside the engine (a workflow's durable notifier; a host that announces a continued agent itself).
640
+ * No channel ⇒ no background launch: an agent runs synchronously instead, every other producer refuses before any
641
+ * side effect. Judged at the call, never at the mount — a mount cannot know the run lane a call will carry (a
642
+ * caller-mounted tool gets its run's lane on the call's context only) — so a mount offers its background option on its
643
+ * own capability, and every "you will be notified" a face says holds for any launch this admits.
644
+ */
645
+ export declare function admitsBackgroundLaunch<S>(sink: S | undefined): sink is S;
646
+ export declare function admitsBackgroundLaunch(sink: unknown, deploymentChannel: boolean): boolean;
596
647
  /**
597
648
  * The terminal frames a run's notification lane is still OWED — the one book a one-shot submission's ending waits on.
598
649
  * A loop-type background task (a background agent, a continued agent, a workflow run) whose completion sink is a run's
@@ -668,7 +719,7 @@ export interface DrainedPendingNotifications {
668
719
  * key, which put a session-level fact into a per-task ledger and broke twice for it: the key could
669
720
  * collide with a real, free-form external `task_id` (merging two unrelated counts and mislabelling the
670
721
  * lane — design/144 X1 already ruled that the external lane needs its own key space), and the
671
- * survivors-none renderer told the model to call `TaskOutput("(evicted-session)")`, an instruction with
722
+ * survivors-none renderer told the model to poll a task id `"(evicted-session)"`, an instruction with
672
723
  * nothing behind it. The count is a session fact; it now has a session field.
673
724
  */
674
725
  droppedWholeSession?: number;
@@ -767,6 +818,16 @@ export declare class SessionLiveNotificationLanes {
767
818
  /** Sessions holding at least one live lane (observability + the tests' rollback detector). */
768
819
  get size(): number;
769
820
  }
821
+ /**
822
+ * What a double fault at the park seat leaves beside its in-process copy: the box the record was meant for (the binding
823
+ * the seat asked, as it was then — the store object, scope and handle) and the record it asked with. The copy is a debt
824
+ * owed to THAT box, settled by asking it again ({@link PendingSessionNotifications.settleBoxDebts}) — never by comparing
825
+ * it with whatever box the session binds later.
826
+ */
827
+ export interface SessionBoxDebt {
828
+ readonly box: SessionBoxBinding;
829
+ readonly record: MailboxAppendMessage;
830
+ }
770
831
  export declare class PendingSessionNotifications {
771
832
  private readonly sessions;
772
833
  /**
@@ -800,8 +861,24 @@ export declare class PendingSessionNotifications {
800
861
  bindSessionBox(sessionId: string, box: SessionBoxBinding | undefined): void;
801
862
  /** The session's durable box, when a leg of it mounted the drain in this process. */
802
863
  sessionBoxFor(sessionId: string): SessionBoxBinding | undefined;
803
- pend(sessionId: string, n: TaskNotificationPayload, priority?: SystemInjectionPriority): void;
804
- /** Remove and return the session's pendings (one-shot — the next run consumes them exactly once).
864
+ /**
865
+ * Settle what the session's pending copies owe their boxes ({@link SessionBoxDebt}): each is asked of its own box once
866
+ * more, under its record, in pend order. A box that answers took the record — it holds it, or received it already —
867
+ * so the delivery is the box's and the copy is dropped (the box then owns the key, as after a durable park). A box
868
+ * that refuses, whatever the refusal, is disclosed once on that binding and the copy stays an ordinary pending
869
+ * notification. Never rejects. `undefined` when nothing is owed: a leg with no debt takes no store round trip. ONE
870
+ * pass over what is owed when it starts, stopped by `signal`: a debt that arrives meanwhile, or one an abort left
871
+ * unasked, stays owed — and a copy that owes its box is never drained ({@link drain} keeps it back) — until a later
872
+ * leg's settlement asks.
873
+ */
874
+ settleBoxDebts(sessionId: string, signal?: AbortSignal): Promise<void> | undefined;
875
+ /** What a drain hands out of a parked record: everything but the copies that still owe their box — those go back
876
+ * into the store as the session's record (with their keys, tiers and debts) for the leg that settles them. */
877
+ private keepBackOwing;
878
+ private settleBoxDebt;
879
+ pend(sessionId: string, n: TaskNotificationPayload, priority?: SystemInjectionPriority, debt?: SessionBoxDebt): void;
880
+ /** Remove and return the session's pendings (one-shot — the next run consumes them exactly once); a copy that
881
+ * still owes its box stays parked for the leg that settles it ({@link settleBoxDebts}).
805
882
  * design/373 §3.5: the batch comes out PRIORITY-MAJOR (stable sort — pend order within a class;
806
883
  * a no-priority record ranks as later), the idle-dequeue min-value-first form. */
807
884
  drain(sessionId: string): DrainedPendingNotifications | undefined;