@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -11,7 +11,7 @@ import type { RepairBundle } from "../agents/repair-loop.js";
11
11
  import type { WorkspaceHandle } from "./remote-env.js";
12
12
  import type { SessionPermissionRules } from "./session-policy-store.js";
13
13
  import type { NestedUsageAccum, PermissionMode, ShellGateDoctrine, TaskResult } from "./types.js";
14
- import type { ActiveWorktreeSession } from "../internal/harness-types.js";
14
+ import type { ActiveWorktreeSession, AgentMessage } from "../internal/harness-types.js";
15
15
  import type { ReopenReason } from "./resume-startup-cause.js";
16
16
  import { type RetentionDeclaration } from "./retention.js";
17
17
  /**
@@ -587,7 +587,7 @@ export type ResumeOutcome = {
587
587
  * no persisted hash → the resume skips this check, binding on `boundCallId` alone; new mints enforce.)
588
588
  */
589
589
  boundInputHash: string;
590
- /** `allow` → execute the pending tool call; `deny` → inject a denial result and continue. */
590
+ /** `allow` → execute the pending tool call; `deny` → inject a denial result, then: a person's deny with no (or an empty) `reason` on a leg that is not a delegated child ends the turn awaiting the user (the run completes with `haltedOnUserRejection`) unless the resume also delivers a parked steer, which the model answers; any other deny continues. */
591
591
  decision: "allow" | "deny";
592
592
  /** A re-written arg payload (design/37 policy `allow` rewrite); re-validated on execute. */
593
593
  updatedInput?: unknown;
@@ -649,6 +649,9 @@ export type ResumeOutcome = {
649
649
  * characters, refused pre-CAS (`checkpoint.invalid_outcome`) otherwise — refused rather than dropped,
650
650
  * because a settlement that silently lost its attributed party reads as unattributed.
651
651
  *
652
+ * `decidedVia` — which machine seat answered a `"policy"` decision ({@link import("./gate-outcome.js").DECIDED_VIA}); the
653
+ * captured facts carry it to the resumed leg (refusal sentence, reminder's decider); refused pre-CAS outside the set or beside another decider.
654
+ *
652
655
  * SCOPE — the facts ride the settlement, not the persisted winner: `winnerFromOutcome` records what an
653
656
  * `env_failed` replay must reproduce exactly, and who reported a settlement is not part of that
654
657
  * authorization; a replay states its own facts.
@@ -857,6 +860,9 @@ export type PendingAction = {
857
860
  /** The PARK twin of `AskRequest.classes`: every class of the parked ask, in `ASK_CLASSES` order
858
861
  * (`classes[0] === askClass`). Present exactly when {@link askClass} is. */
859
862
  classes?: readonly import("./ask-origin.js").AskClass[];
863
+ /** The PARK twin of `AskRequest.askReasons` (the synchronous card's value, through the park's one carry): written only as a
864
+ * list of well-formed entries; a row parked before it reads ABSENT. Display metadata — no gate, CAS or resume path reads it. */
865
+ askReasons?: readonly import("./ask-origin.js").AskReason[];
860
866
  /**
861
867
  * design/80 D-1 §2 (slice 1a.2): the server-minted **opaque** boundInputHash of {@link args} — a
862
868
  * SHA-256 (hex) via {@link import("./canonical-json.js").boundInputHashOf}, computed ONCE here at
@@ -1126,8 +1132,8 @@ export interface CheckpointState {
1126
1132
  * alive in the resume leg's registry is an ORPHAN — aggregated into ONE "The container
1127
1133
  * was restarted…" reminder appended to the resume continuation (single message: header +
1128
1134
  * `- description (task id)` list + re-create instruction; never a per-task barrage). A survivor
1129
- * (session-resident shell / in-window monitor) is excluded — still reachable via TaskOutput/
1130
- * TaskStop, it needs no obituary. CC's per-orphan `Ku(task_id,"stopped")` status write (:707399)
1135
+ * (session-resident shell / in-window monitor) is excluded — its output file and TaskStop
1136
+ * still reach it, it needs no obituary. CC's per-orphan `Ku(task_id,"stopped")` status write (:707399)
1131
1137
  * is N/A here: the suspend teardown already settled them killed with receipts. Absent for a run
1132
1138
  * with no live background tasks at suspend, and for pre-1.262 checkpoints (deserialized without
1133
1139
  * the field) — both resume silently, exactly like CC with an empty list.
@@ -1343,6 +1349,9 @@ export interface CheckpointState {
1343
1349
  * delegated child (never `false` — presence-coded like the other monotonic bits here).
1344
1350
  */
1345
1351
  isDelegatedChild?: true;
1352
+ /** The registry row the suspended leg ran as (`RunInternals.rowTaskId`), stamped at every mint and restored by a resume that
1353
+ * hands no internals. Present only on a row-lane leg's park, which then requires `row_task_id` (an older engine refuses it). */
1354
+ rowTaskId?: string;
1346
1355
  /**
1347
1356
  * design/380 O1③ — the run TREE's placement fixed point at suspend: the SAME three-segment fold the
1348
1357
  * env-factory ctx mint uses (explicit `RunInternals.placementRoot` > the delegation lanes'
@@ -1365,9 +1374,21 @@ export interface CheckpointState {
1365
1374
  * resolved empty on a factory-less run (never persisted as garbage).
1366
1375
  */
1367
1376
  placementRootSessionId?: string;
1377
+ /**
1378
+ * Which composition leg parked this row and which host session it belongs to
1379
+ * ({@link import("./runner/contracts.js").CompositionLeg}): stamped at every mint from the ONE value the leg's prepare resolved
1380
+ * (the live `RunInternals.compositionLeg`, else this member restored from the row being resumed), so a re-suspend chain carries
1381
+ * it unchanged. A host links the row to its run by `hostSessionId` — the row's own {@link Checkpoint.sessionId} is the leg's
1382
+ * session, not the host's — and settles it by `entry`: a `cascade` card goes back to the cascade's resume entry, which reads
1383
+ * `leg` to know which rung it continues; a `verify` card is a verifier's own pause (resume it by its token, or void it with
1384
+ * `Runner.voidVerifierPause`). A resume that hands a CONTRADICTING live value is refused pre-CAS (`resume.composition_mismatch`); a live value
1385
+ * over a row without this member is that row's first record. Absent ⇒ the leg was not handed out by a composition entry, its
1386
+ * composition minted none (a cascade whose caller named no session), or the row was minted before the member.
1387
+ */
1388
+ compositionLeg?: import("./runner/contracts.js").CompositionLeg;
1368
1389
  /**
1369
1390
  * design/380 O9a — MONOTONIC presence bit: this run's hand-tool content fold was EXTERNAL-TARGET
1370
- * armed (the env declared `ExecutionEnv.externalContentTarget`, or an earlier leg of this suspend
1391
+ * armed (the env declared `capabilities.externalContentTarget`, or an earlier leg of this suspend
1371
1392
  * chain did). Stamped at the suspend mint from the run's RESOLVED fold state — never from first
1372
1393
  * tool use, so a park landing BEFORE the first hand call is covered too. Presence-coded like
1373
1394
  * {@link isDelegatedChild} (absent = never armed; never `false`). The resume side folds
@@ -1775,6 +1796,12 @@ export interface CheckpointRow {
1775
1796
  sessionId: string;
1776
1797
  /** The session leaf the suspend happened at — the resume point (CAS write base, §5). */
1777
1798
  leafId: string;
1799
+ /** The conversation rows the leg had admitted but not yet stored when it parked (a note an extension added while the turn
1800
+ * ran), in the order they were admitted — what the conversation owes after {@link leafId}. Written by the park's commit
1801
+ * alone, in the same step as the row; the resumed leg writes each once, at its transcript's first legal point (after the
1802
+ * parked batch's last result, before the continuation), never through the admission seat again. Absent ⇒ none were held;
1803
+ * present ⇒ the row carries the `held_rows` requirement word. */
1804
+ heldRows?: readonly AgentMessage[];
1778
1805
  state: CheckpointState;
1779
1806
  /** design/74 R3-B: cross-slice resource accounting. Present for a `resource_limit` gate (debited at the
1780
1807
  * suspend's `put`; read on resume to size the next slice + aggregate the final stats). **design/80 D-E-core
@@ -1865,26 +1892,28 @@ export interface CheckpointRow {
1865
1892
  */
1866
1893
  rev?: number;
1867
1894
  /**
1868
- * design S1d (source-tag persistence): the issuing task's session id, stamped at the
1869
- * APPROVAL suspend mint so a supervisor inbox can attribute a paused/awaiting checkpoint to the worker that
1870
- * raised it (the durable analog of {@link import("./tool-policy.js").AskRequest}.sourceTaskId — the durable
1895
+ * design S1d (source-tag persistence): the issuing leg's session id, stamped at the APPROVAL and the
1896
+ * plan_review suspend mints so a supervisor inbox can attribute a paused/awaiting checkpoint to the worker that
1897
+ * raised it (the durable analog of {@link import("./tool-policy.js").AskRequest}.sourceSessionId — the durable
1871
1898
  * suspend path does NOT invoke `onAsk`, so the synchronous source identity is captured here instead). It is
1872
- * the SAME value the synchronous ask carries: `= sessionId` at the mint.
1899
+ * the SAME value the synchronous ask carries, read from the same one mint. It names a conversation, never a
1900
+ * task: the parked leg's agent id is {@link CheckpointSummary.agentId}, derived from the row.
1873
1901
  *
1874
1902
  * **Security invariant (carried verbatim from the 1.113.0 ask-bubbling contract):** for a Runner-created
1875
1903
  * DELEGATED subagent this is **worker-unforgeable** (a child never sets its own sessionId — the Runner mints
1876
1904
  * it); a top-level caller MAY continue its own session id via {@link import("./types.js").TaskSpec.sessionId},
1877
1905
  * so this is NOT a global "never forgeable" run id — aggregation only aggregates delegated workers, where it
1878
1906
  * holds. **ECHO-ONLY triage metadata, NEVER a gate input:** no gate / CAS / winner / resume-validation path
1879
- * reads it (a contract-test pins this). Absent ⇒ no source task id (a non-ask gate, or a legacy checkpoint).
1907
+ * reads it (a contract-test pins this). A row that carries it requires `source_session` (an older engine
1908
+ * refuses it). Absent ⇒ a non-ask gate, or a row an earlier engine parked (it named the member `sourceTaskId`).
1880
1909
  */
1881
- sourceTaskId?: string;
1910
+ sourceSessionId?: string;
1882
1911
  /**
1883
1912
  * design S1d (source-tag persistence): the issuing task's authenticated end-user {@link
1884
1913
  * import("./types.js").TaskSpec.principal} (design/62), stamped at the APPROVAL suspend mint — and, since
1885
1914
  * #449 G2, at the `resource_limit` mint too — so an aggregating inbox can attribute a paused checkpoint
1886
1915
  * per-user — the durable analog of {@link import("./tool-policy.js").AskRequest}.principal. Caller-set
1887
- * (never a tool/worker arg), and like {@link sourceTaskId} it is **NEVER a gate input**: no gate / CAS /
1916
+ * (never a tool/worker arg), and like {@link sourceSessionId} it is **NEVER a gate input**: no gate / CAS /
1888
1917
  * winner path reads it. The RESUME ENTRY however does read it as the row's identity record (#449 G2):
1889
1918
  * a resume config that omits `principal` inherits this value for the resumed leg (usage-ledger bucket,
1890
1919
  * later mints' scope derivation, ask attribution — a dropped field must not silently move the leg onto
@@ -2013,10 +2042,15 @@ export interface CheckpointSummary {
2013
2042
  spentMicroUsd?: number;
2014
2043
  /** The awaiting-human SLA / abandonment deadline ({@link Checkpoint.deadline}, epoch ms) when present. */
2015
2044
  deadline?: number;
2016
- /** design S1d (source-tag): the issuing worker's session id ({@link Checkpoint.sourceTaskId}) — projected so
2045
+ /** design S1d (source-tag): the issuing worker's session id ({@link Checkpoint.sourceSessionId}) — projected so
2017
2046
  * a supervisor inbox attributes each pending checkpoint to its worker in ONE `listByScope` call (no N+1
2018
- * `getCheckpoint`). ECHO-ONLY display/triage; absent on a non-ask gate / legacy checkpoint. */
2019
- sourceTaskId?: string;
2047
+ * `getCheckpoint`). ECHO-ONLY display/triage; absent on a non-ask gate and on a row an earlier engine parked. */
2048
+ sourceSessionId?: string;
2049
+ /** The parked leg's agent id when it is a delegated child (the parked twin of {@link import("./tool-policy.js").AskRequest}.agentId),
2050
+ * derived from the row by the live ask's predicate — nothing more is stored: its registry row ({@link CheckpointState.rowTaskId}) when
2051
+ * it ran as one, else its session id; absent on a host's row. The row does not record a task id the leg's spec declared, so a workflow
2052
+ * agent whose spec names a `taskId` summarizes as its session id while its live ask said the declared id. ECHO-ONLY display/triage. */
2053
+ agentId?: string;
2020
2054
  /** design S1d (source-tag): the issuing task's end-user principal ({@link Checkpoint.principal}) for per-user
2021
2055
  * inbox attribution. ECHO-ONLY display/triage; absent when the checkpoint carries no principal. */
2022
2056
  principal?: string;
@@ -2069,7 +2103,7 @@ export interface CheckpointSummary {
2069
2103
  * `toolInput` is the raw-data sibling for a consumer that wants the actual args.)
2070
2104
  * - **same data as the full {@link Checkpoint}** — it is a projection of `pendingAction.args`, which the
2071
2105
  * caller could already read via `get`; this adds NO new exposure, it only saves the round-trip.
2072
- * - **ECHO-ONLY, like {@link sourceTaskId}** — NO gate / CAS / resume / {@link winnerFromOutcome} path reads
2106
+ * - **ECHO-ONLY, like {@link sourceSessionId}** — NO gate / CAS / resume / {@link winnerFromOutcome} path reads
2073
2107
  * it (a contract test pins this); it is pure display/triage metadata, never a control input.
2074
2108
  */
2075
2109
  toolInput?: string;
@@ -2168,7 +2202,7 @@ export interface CheckpointSummary {
2168
2202
  * itself a TOTAL, bounded traversal (cycle-safe, per-type output forms, throwing getters to a
2169
2203
  * placeholder, depth/node/char budgets with a truncation marker — never "full `JSON.stringify` then
2170
2204
  * truncate", which does all the work and takes all the throws before the cap). ECHO-ONLY, like
2171
- * {@link sourceTaskId}: a warning to a person, never a control input — resume/gate/CAS never read it.
2205
+ * {@link sourceSessionId}: a warning to a person, never a control input — resume/gate/CAS never read it.
2172
2206
  */
2173
2207
  hasBidiControls?: true;
2174
2208
  }
@@ -2246,9 +2280,8 @@ export type CheckpointErrorReason = "version_newer" | "env_factory_missing" | "g
2246
2280
  | "not_a_list" | "not_a_string" | "unknown_name" | "unsupported_pattern" | "invalid_record" | "renamed_mount" | "registry_occupied"
2247
2281
  /** On `config.unknown_role` (a fresh run's terminal `detail.detail.reason`; on a resume, `detail.reason` of `checkpoint.config_refused` with `detail.code` `config.unknown_role`)
2248
2282
  * — a model binding or a role word the engine cannot read: a word the model catalog does not hold (`"unknown_model_ref"`), a value that is
2249
- * no model reference at all — a number, a boolean, a list (`"not_a_model_ref"`), or a role word outside the vocabulary — a `roles` key, a
2250
- * `modelRole` value (`"unknown_role_word"`). The sentence names the seat the refusal's `field` names (`roles.consolidate`, `tiers.pro`, `TaskSpec.model`). */
2251
- | "unknown_model_ref" | "not_a_model_ref" | "unknown_role_word";
2283
+ * no model reference at all — a number, a boolean, a list (`"not_a_model_ref"`), or a role word outside the vocabulary — a `roles` key, a `modelRole` value (`"unknown_role_word"`) — or a task naming no model whose requested role and fallback chain supply none (`"no_model_for_role"`, `field` the requested role's seat). The sentence names the seat the refusal's `field` names (`roles.consolidate`, `tiers.pro`, `TaskSpec.model`). */
2284
+ | "unknown_model_ref" | "not_a_model_ref" | "unknown_role_word" | "no_model_for_role";
2252
2285
  /**
2253
2286
  * The codes a RESUME's pre-claim configuration screen carries as `detail.code` of a `checkpoint.config_refused` — the words prepare's
2254
2287
  * doors throw, held unchanged so one refusal reads the same on a fresh run (`TaskResult.errorCode`) and on a resume: the mode, output-style,
@@ -2265,8 +2298,11 @@ export type CheckpointErrorReason = "version_newer" | "env_factory_missing" | "g
2265
2298
  * retired `null` spelling, a store that declares no execution outcome), and the skills seat and the hands band (`config.invalid_argument`;
2266
2299
  * a skill's `baseDir` by its own reader, `config.skill_base_dir_invalid`). A door not entered here (the leg's model, its rebuilt
2267
2300
  * roster, its answer face, the approval seat's value) still refuses after the claim, each for a stated reason (INTEGRATION-CORE, "A resume's two doors").
2301
+ * The re-supplied config's one read (`readCallerSpec`, the read a run takes of its spec) refuses with its own two words, last in the set:
2302
+ * a member whose read throws (`config.spec_member_unreadable`) and a key the engine does not read (`config.spec_unknown_key`); its third,
2303
+ * a retired key, is `config.spec_retired_key` (first).
2268
2304
  */
2269
- export declare const CHECKPOINT_CONFIG_REFUSAL_CODES: readonly ["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing"];
2305
+ export declare const CHECKPOINT_CONFIG_REFUSAL_CODES: readonly ["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"];
2270
2306
  export type CheckpointConfigRefusalCode = (typeof CHECKPOINT_CONFIG_REFUSAL_CODES)[number];
2271
2307
  export declare const isCheckpointConfigRefusalCode: (word: unknown) => word is CheckpointConfigRefusalCode;
2272
2308
  /** The words of a {@link CheckpointError}'s optional `detail.field` (what each means: the `detail` member's doc). A CLOSED SET with one home, registered in
@@ -2332,6 +2368,9 @@ export declare class CheckpointError extends Error {
2332
2368
  * checkpoint exists. Surfaced instead of silently treating the failed reopen as committed, so the
2333
2369
  * caller's compensation path settles the token as terminally consumed. */
2334
2370
  | "checkpoint.reopen_failed"
2371
+ /** `Runner.voidVerifierPause` voided the card — the row IS expired and its env duty ran — but releasing the verifier
2372
+ * session's pin threw or did not settle within the teardown bound: the session stays pinned until it is unpinned. */
2373
+ | "checkpoint.void_unpin_failed"
2335
2374
  /** {@link CheckpointStore.recordExecutionOutcome} met a row that already carries a DIFFERENT
2336
2375
  * execution record — see `ExecutionOutcomeConflictError` (checkpoint-execution-record.ts), the
2337
2376
  * in-tree form of this code. Never a retry condition. */
@@ -2415,6 +2454,14 @@ export declare class CheckpointError extends Error {
2415
2454
  * side absent (an older row / a claim-less resume) skips the check, and `""` reads as absence
2416
2455
  * — the honest degradation arm. */
2417
2456
  | "resume.placement_mismatch"
2457
+ /** The composition-leg twin of `resume.placement_mismatch`: the resume supplied trusted internals whose
2458
+ * `compositionLeg` differs from the {@link CheckpointState.compositionLeg} recorded at the suspend mint — the
2459
+ * composition's resume entry was handed another card's identity, and continuing would run this leg as a rung it is
2460
+ * not, file its next card under another host session, or both. Rejected PRE-CAS (the checkpoint stays `pending`);
2461
+ * re-resume with the recorded value, or omit `internals.compositionLeg` to inherit it. A row that records none skips
2462
+ * the check (the live value becomes its first record). The same code refuses `Runner.voidVerifierPause` a card whose
2463
+ * recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was. */
2464
+ | "resume.composition_mismatch"
2418
2465
  /** design/380 O2: the deployment's `RunnerDeps.resumePreflight` refused this resume — an
2419
2466
  * explicit refusal verdict, a throw, a timeout past its bounded deadline, or an unreadable
2420
2467
  * answer (all fail-closed). The LAST rung before the CAS, so nothing was consumed. Two arms,
@@ -2548,6 +2595,9 @@ export declare class CheckpointError extends Error {
2548
2595
  * checkpoint exists. Surfaced instead of silently treating the failed reopen as committed, so the
2549
2596
  * caller's compensation path settles the token as terminally consumed. */
2550
2597
  | "checkpoint.reopen_failed"
2598
+ /** `Runner.voidVerifierPause` voided the card — the row IS expired and its env duty ran — but releasing the verifier
2599
+ * session's pin threw or did not settle within the teardown bound: the session stays pinned until it is unpinned. */
2600
+ | "checkpoint.void_unpin_failed"
2551
2601
  /** {@link CheckpointStore.recordExecutionOutcome} met a row that already carries a DIFFERENT
2552
2602
  * execution record — see `ExecutionOutcomeConflictError` (checkpoint-execution-record.ts), the
2553
2603
  * in-tree form of this code. Never a retry condition. */
@@ -2631,6 +2681,14 @@ export declare class CheckpointError extends Error {
2631
2681
  * side absent (an older row / a claim-less resume) skips the check, and `""` reads as absence
2632
2682
  * — the honest degradation arm. */
2633
2683
  | "resume.placement_mismatch"
2684
+ /** The composition-leg twin of `resume.placement_mismatch`: the resume supplied trusted internals whose
2685
+ * `compositionLeg` differs from the {@link CheckpointState.compositionLeg} recorded at the suspend mint — the
2686
+ * composition's resume entry was handed another card's identity, and continuing would run this leg as a rung it is
2687
+ * not, file its next card under another host session, or both. Rejected PRE-CAS (the checkpoint stays `pending`);
2688
+ * re-resume with the recorded value, or omit `internals.compositionLeg` to inherit it. A row that records none skips
2689
+ * the check (the live value becomes its first record). The same code refuses `Runner.voidVerifierPause` a card whose
2690
+ * recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was. */
2691
+ | "resume.composition_mismatch"
2634
2692
  /** design/380 O2: the deployment's `RunnerDeps.resumePreflight` refused this resume — an
2635
2693
  * explicit refusal verdict, a throw, a timeout past its bounded deadline, or an unreadable
2636
2694
  * answer (all fail-closed). The LAST rung before the CAS, so nothing was consumed. Two arms,
@@ -2974,8 +3032,8 @@ export interface CheckpointStore {
2974
3032
  * **Load-bearing contract (design/51 §2/§4):** `expire` and {@link resolve} race the **same `pending`
2975
3033
  * row**, so the store serializes them — exactly one wins. This is what makes {@link TaskStream.destroy}
2976
3034
  * a correct *fence-then-reap*: `destroy` calls `expire` FIRST to fence any concurrent `resume` (which
2977
- * goes through `resolve`); only the `expire` winner then destroys the paused env, so the same checkpoint
2978
- * is **never both reaped and resumed**. `scope` is in the WHERE for multi-tenant isolation, like
3035
+ * goes through `resolve`); the paused env is destroyed only once the row is `expired` (this call won, or a loser
3036
+ * reads it so), so the same checkpoint is **never both reaped and resumed**. `scope` is in the WHERE for multi-tenant isolation, like
2979
3037
  * `resolve`/`reap`.
2980
3038
  */
2981
3039
  expire(token: CheckpointToken, scope: string): Promise<boolean>;
@@ -3076,12 +3134,9 @@ export interface CheckpointStore {
3076
3134
  * full {@link Checkpoint} payloads. Read-only — it never mutates a row, takes no CAS, and has ZERO effect on
3077
3135
  * the once-only resolve. The PENDING predicate is byte-for-byte the {@link resolve} CAS's (`scope === scope &&
3078
3136
  * status === 'pending'`), so the list reflects exactly the rows that are still resumable. Order is unspecified
3079
- * (the inbox sorts by `severity`/`deadline` itself). An empty scope returns `[]`.
3080
- *
3081
- * **OPTIONAL** for backward-compat (RL-1336-checkpoint-listbyscope) with external {@link CheckpointStore} impls (a caller probes
3082
- * `store.listByScope?.(scope) ?? []`); ALL THREE first-party impls (in-memory, file, Pg) provide it.
3137
+ * (the inbox sorts by `severity`/`deadline` itself). An empty scope returns `[]`. Required: every store answers it.
3083
3138
  */
3084
- listByScope?(scope: string): Promise<CheckpointSummary[]>;
3139
+ listByScope(scope: string): Promise<CheckpointSummary[]>;
3085
3140
  /**
3086
3141
  * Deployment seam: the DISTINCT scopes that currently have at least one PENDING checkpoint — the
3087
3142
  * enumeration face `listByScope` lacks. A host keeping its own scope registry (e.g. a sidecar file for a
@@ -3090,7 +3145,7 @@ export interface CheckpointStore {
3090
3145
  * it matches `listByScope`'s visible surface, so `listScopes() × listByScope()` is exactly the full inbox,
3091
3146
  * and a member the summary does not project is read with `get(token)` on the listed token — the composition
3092
3147
  * a deployment's approval queue is, rather than a query of its own over the store's rows.
3093
- * **OPTIONAL** like {@link listByScope}; the in-memory and file first-party impls provide it.
3148
+ * **OPTIONAL** (unlike the required {@link listByScope}); the in-memory and file first-party impls provide it.
3094
3149
  */
3095
3150
  listScopes?(): Promise<string[]>;
3096
3151
  /** The PENDING rows of every scope past their deadline, one facet per call ({@link CheckpointOverdueQuery}; read by
@@ -3250,9 +3305,8 @@ export declare class InMemoryCheckpointStore implements CheckpointStore {
3250
3305
  readonly deleteSessionCheckpoints?: (sessionId: string, guard: CheckpointDeleteGuard) => Promise<number>;
3251
3306
  /** `disclose` is the listing projections' own seat ({@link summarizeCheckpoint}'s and the listing faces'): this store has no
3252
3307
  * path, so it forwards each sentence for a row read past a damage, called synchronously by the listing that read it.
3253
- * `sessionHeadOf` (a session store's `headOf`) is what {@link CheckpointStore.deleteSessionCheckpoints} judges its guard by.
3254
- * `holderIsCurrent` ({@link HolderJudge}) is what a resolve's `expect.holder` is judged by. */
3255
- constructor(opts?: {
3308
+ * `sessionHeadOf` (a session store's `headOf`) is what {@link CheckpointStore.deleteSessionCheckpoints} judges its guard by; `holderIsCurrent` ({@link HolderJudge}), a resolve's `expect.holder`. */
3309
+ constructor(options?: {
3256
3310
  disclose?: (sentence: string) => void;
3257
3311
  sessionHeadOf?: (sessionId: string) => Promise<{
3258
3312
  readonly owner: string | null;
@@ -2,8 +2,9 @@ import { randomBytes, randomUUID } from "node:crypto";
2
2
  import { uuidv7 } from "../internal/harness.js";
3
3
  import { PROBE_CAUSE_PATH_MAX, PROBE_REASON_MAX, inlineUntrusted, sanitizeUntrustedText } from "./untrusted-text.js";
4
4
  import { carriesBidiControls } from "./tool-policy.js";
5
+ import { agentIdOf, legTaskIdOf } from "./leg-identity.js";
5
6
  import { isAutoModeFallbackCause, readDenialLimitFallback } from "./auto-mode.js";
6
- import { isAskOrigin, isPersistedRuleMandate } from "./ask-origin.js";
7
+ import { isAskOrigin, isPermissionMode, isPersistedRuleMandate } from "./ask-origin.js";
7
8
  import { isRunOrigin, RUN_ORIGINS } from "./run-origin.js";
8
9
  import { describeRejectedValue } from "./tool-search-setting.js";
9
10
  import { readBoundBinding } from "./skill-grant-binding.js";
@@ -14,8 +15,8 @@ import { checkpointDeadlinePassed, deleteSessionRowsAtStart, readCheckpointOverd
14
15
  import { renderUntrustedCommandText, stripFormatCharacters } from "./permission-rule-model.js";
15
16
  import { egressText } from "./untrusted-egress.js";
16
17
  import { steerReplayRefusal } from "./steer-replay.js";
17
- import { isPermissionMode } from "./ask-origin.js";
18
18
  import { readRetentionDeclaration } from "./retention.js";
19
+ import { optionKeys, receiveOptions } from "./own-property-receipt.js";
19
20
  export function mintCheckpointToken() {
20
21
  return randomBytes(16).toString("hex");
21
22
  }
@@ -307,6 +308,7 @@ export function summarizeCheckpoint(cp, disclose) {
307
308
  const hasBidi = tool !== undefined &&
308
309
  (facts.hasBidiControls === true ||
309
310
  carriesBidiControls([toolInput, tool.preview], { maxNodes: BIDI_BACKFILL_MAX_NODES, maxChars: BIDI_BACKFILL_MAX_CHARS }));
311
+ const agentId = agentIdOf({ taskId: legTaskIdOf({}, cp.state, cp.sessionId), isDelegatedChild: cp.state.isDelegatedChild === true });
310
312
  return {
311
313
  token: facts.token,
312
314
  ...(cp.checkpointId !== undefined ? { checkpointId: cp.checkpointId } : {}),
@@ -317,7 +319,8 @@ export function summarizeCheckpoint(cp, disclose) {
317
319
  ...(cp.resourceLedger !== undefined ? { spentMicroUsd: cp.resourceLedger.spentMicroUsd } : {}),
318
320
  ...(facts.deadline !== null ? { deadline: facts.deadline } : {}),
319
321
  createdAt: facts.createdAt,
320
- ...(cp.sourceTaskId !== undefined ? { sourceTaskId: cp.sourceTaskId } : {}),
322
+ ...(cp.sourceSessionId !== undefined ? { sourceSessionId: cp.sourceSessionId } : {}),
323
+ ...(agentId !== undefined ? { agentId } : {}),
321
324
  ...(cp.principal !== undefined ? { principal: cp.principal } : {}),
322
325
  ...(facts.toolCallId !== null ? { toolCallId: facts.toolCallId } : {}),
323
326
  ...(requestedByCallId !== undefined ? { requestedByCallId } : {}),
@@ -347,7 +350,7 @@ export function summarizeCheckpoint(cp, disclose) {
347
350
  ...(hasBidi ? { hasBidiControls: true } : {}),
348
351
  };
349
352
  }
350
- export const CHECKPOINT_CONFIG_REFUSAL_CODES = Object.freeze(["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing"]);
353
+ export const CHECKPOINT_CONFIG_REFUSAL_CODES = Object.freeze(["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"]);
351
354
  export const isCheckpointConfigRefusalCode = (word) => CHECKPOINT_CONFIG_REFUSAL_CODES.some((w) => w === word);
352
355
  export class CheckpointError extends Error {
353
356
  code;
@@ -574,6 +577,7 @@ export function appendPendingSteer(state, entry) {
574
577
  export function checkpointRowMatches(cp, scope, status) {
575
578
  return cp !== undefined && cp.scope === scope && cp.status === status;
576
579
  }
580
+ const IN_MEMORY_CHECKPOINT_STORE_OPTION_KEYS = optionKeys()({ disclose: 0, sessionHeadOf: 0, holderIsCurrent: 0, retention: 0 });
577
581
  export class InMemoryCheckpointStore {
578
582
  retention;
579
583
  durability = "process-local";
@@ -583,7 +587,8 @@ export class InMemoryCheckpointStore {
583
587
  fault = null;
584
588
  disclose;
585
589
  holderIsCurrent;
586
- constructor(opts = {}) {
590
+ constructor(options) {
591
+ const opts = receiveOptions(options, "InMemoryCheckpointStore", IN_MEMORY_CHECKPOINT_STORE_OPTION_KEYS);
587
592
  this.retention = readRetentionDeclaration("InMemoryCheckpointStore.retention", opts.retention);
588
593
  this.disclose = opts.disclose;
589
594
  this.holderIsCurrent = opts.holderIsCurrent;
@@ -259,8 +259,9 @@ export declare function clampRecordError(message: string): Error & {
259
259
  /**
260
260
  * Refuse a caller-supplied clamp record that names a seat the table does not have (or, with `carrier`, a row another
261
261
  * carrier hands on): a name nobody reads would sit on the record as if wired — the silent drop the retired-key door
262
- * exists to prevent. `extra` names the record's own members that are not rows. Absent ⇒ nothing to judge; a member
263
- * whose value is `undefined` carries nothing and is read as absent (the retired-key door's presence rule).
262
+ * exists to prevent. `extra` names the record's own members that are not rows. Absent ⇒ nothing to judge. The record is
263
+ * judged by the engine's one name judgment (every own key a row's name, whatever its value: a stray key holding `undefined`
264
+ * is a stray key); no value is read here — the readers read the record itself.
264
265
  */
265
266
  export declare function assertClampRecord(record: unknown, owner: string, carrier?: ClampCarrier, extra?: readonly string[]): void;
266
267
  /**
@@ -1,5 +1,6 @@
1
1
  import { readDenyEntryProblem } from "../tools/fs/read-deny.js";
2
2
  import { COMPLIANCE_CAPABILITIES, complianceCapabilityProblem } from "./compliance.js";
3
+ import { strayMembersOf } from "./own-property-receipt.js";
3
4
  import { writeProtectedEntryIdentity, writeProtectedEntryProblem } from "./write-protect.js";
4
5
  function readDenyIdentity(entry) {
5
6
  return typeof entry === "string" ? `i:${entry}` : `${entry.caseSensitive === true ? "s" : "i"}:${entry.pattern}`;
@@ -235,9 +236,9 @@ export function assertClampRecord(record, owner, carrier, extra = []) {
235
236
  if (record === null || typeof record !== "object")
236
237
  throw clampRecordError(`${owner} must be a record of clamp seats, got ${record === null ? "null" : typeof record}`);
237
238
  const legal = [...ROWS.filter(([, row]) => carrier === undefined || row.carrier === carrier).map(([seat]) => seat), ...extra];
238
- const unknown = Object.keys(record).filter((k) => record[k] !== undefined && !legal.includes(k));
239
- if (unknown.length > 0) {
240
- throw clampRecordError(`${owner} names ${unknown.map((k) => JSON.stringify(k)).join(", ")}, which the clamp table does not carry there — the legal seats are ${legal.join(", ")}. Refused rather than ignored: a seat nobody reads would read to the caller as wired.`);
239
+ const unknown = strayMembersOf(record, { subject: owner, unit: "clamp seat", moment: "when the record is handed in" }, legal)?.names;
240
+ if (unknown !== undefined) {
241
+ throw clampRecordError(`${owner} names ${unknown.map((k) => JSON.stringify(String(k))).join(", ")}, which the clamp table does not carry there — the legal seats are ${legal.join(", ")}. Refused rather than ignored: a seat nobody reads would read to the caller as wired.`);
241
242
  }
242
243
  }
243
244
  export function readClampFloor(floor) {
@@ -0,0 +1,13 @@
1
+ /**
2
+ * The engine's one "did you mean" reading: the nearest name to a misspelled one, within two edits. A leaf (it imports
3
+ * nothing), so a low-level door — the options receipt — can name the near miss without depending on the task registry
4
+ * that first needed it.
5
+ */
6
+ /** CC `gtr` (fable 复审 F1 — 亲核 @16169850: NOT plain Levenshtein but OSA / restricted
7
+ * Damerau-Levenshtein, WITH the adjacent-transposition term `o[i][s]=min(o[i][s], o[i-2][s-2]+1)`
8
+ * when `e[i-1]===t[s-2] && e[i-2]===t[s-1]`). The transposition matters: a typo like "tset"→"test"
9
+ * is distance 1 (CC has a Did-you-mean), plain Levenshtein would call it 2. */
10
+ export declare function editDistance(a: string, b: string): number;
11
+ /** CC `htr` shape (206:519814-519827): candidates within Levenshtein ≤2 (length-diff ≤2 pre-filter),
12
+ * best-first; the single best is the "Did you mean" suggestion (`htr(e, keys, 1)[0]`, 206:575196). */
13
+ export declare function closestName(query: string, candidates: Iterable<string>): string | undefined;
@@ -0,0 +1,35 @@
1
+ export function editDistance(a, b) {
2
+ if (a === b)
3
+ return 0;
4
+ const m = a.length;
5
+ const n = b.length;
6
+ const d = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
7
+ for (let i = 1; i <= m; i++) {
8
+ for (let j = 1; j <= n; j++) {
9
+ const cost = a[i - 1] === b[j - 1] ? 0 : 1;
10
+ d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
11
+ if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
12
+ d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
13
+ }
14
+ }
15
+ }
16
+ return d[m][n];
17
+ }
18
+ export function closestName(query, candidates) {
19
+ let best;
20
+ let bestDist = 3;
21
+ const seen = new Set();
22
+ for (const c of candidates) {
23
+ if (seen.has(c))
24
+ continue;
25
+ seen.add(c);
26
+ if (Math.abs(c.length - query.length) > 2)
27
+ continue;
28
+ const dist = editDistance(query, c);
29
+ if (dist <= 2 && dist < bestDist) {
30
+ bestDist = dist;
31
+ best = c;
32
+ }
33
+ }
34
+ return best;
35
+ }
@@ -32,7 +32,7 @@ export declare function resolveComplianceDenies(posture: CompliancePosture): Rea
32
32
  /** One deny list member's refusal under the closed capability set, labelled with the list that carried it, or
33
33
  * `undefined` when it is a member. */
34
34
  export declare function complianceCapabilityProblem(cap: unknown, owner: string): string | undefined;
35
- /** The core web-fetch tool face's canonical mounted name (`createWebFetchTool` in tools/web.ts). */
35
+ /** The core web-fetch tool face's canonical mounted name (`webFetchToolSpec` in tools/web.ts). */
36
36
  export declare const WEB_FETCH_TOOL_NAME = "WebFetch";
37
37
  /**
38
38
  * The CALL-TIME half of the `web_fetch` double point (CC form — mount check + call guard): given the
@@ -1,4 +1,6 @@
1
1
  import { tierAliasVia } from "./roles.js";
2
+ import { optionKeys, receiveMembers } from "./own-property-receipt.js";
3
+ const OVERLAY_KEYS = optionKeys()({ contextTokens: 0, autoCompactTokens: 0, enabled: 0 });
2
4
  export function contextOverlayFor(settings, ref, catalog) {
3
5
  if (settings === undefined || typeof ref !== "string")
4
6
  return undefined;
@@ -26,11 +28,7 @@ export function assertContextSettingsValue(v, where) {
26
28
  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
27
29
  throw new Error(`${where}: contextSettings[${JSON.stringify(word)}] must be a plain object (got ${raw === null ? "null" : Array.isArray(raw) ? "array" : typeof raw})`);
28
30
  }
29
- const o = raw;
30
- const unknown = Object.keys(o).filter((k) => k !== "contextTokens" && k !== "autoCompactTokens" && k !== "enabled");
31
- if (unknown.length > 0) {
32
- throw new Error(`${where}: contextSettings[${JSON.stringify(word)}] carries ${unknown.map((k) => JSON.stringify(k)).join(", ")} — this seat declares window geometry only (contextTokens | autoCompactTokens | enabled); routing, pricing and fencing stay on the model card`);
33
- }
31
+ const o = receiveMembers(raw, { subject: `${where}: contextSettings[${JSON.stringify(word)}]`, unit: "member", moment: "when the overlay is read" }, OVERLAY_KEYS, (_, unknown) => new Error(`${where}: contextSettings[${JSON.stringify(word)}] carries ${unknown.map((k) => JSON.stringify(String(k))).join(", ")} — this seat declares window geometry only (contextTokens | autoCompactTokens | enabled); routing, pricing and fencing stay on the model card`));
34
32
  for (const k of ["contextTokens", "autoCompactTokens"]) {
35
33
  const n = o[k];
36
34
  if (n !== undefined && (typeof n !== "number" || !Number.isFinite(n) || n <= 0)) {
@@ -0,0 +1,52 @@
1
+ /**
2
+ * A protocol peer's account of itself, read without the credentials its connection's requests carried — the MCP server's `serverInfo`,
3
+ * its instructions and its tool listing, the A2A peer's agent card. The needle is the connection's credentials (`PeerCarrier.credentials`:
4
+ * what the seat answered that the withheld table holds) and the one eraser is `eraseSentCredentials` (protocol-http-auth.ts, beside the
5
+ * failure text's). Free text holding the needle is erased in place; a NAME holding it (a tool's name or input schema, the server's own
6
+ * name, a skill's id, the card's name) is never rewritten — what it names is refused instead. Either way the site is announced, once per
7
+ * (materialization, peer, site), as `mcp.credential_echoed` (operator) through {@link credentialEchoNotice}.
8
+ */
9
+ import { type EngineNotice } from "./engine-notice.js";
10
+ import type { PeerCarrier } from "./peer-seat.js";
11
+ /** Where a peer echoed its connection's credentials into what it said about itself — the closed set `mcp.credential_echoed` names
12
+ * (`detail.where`). */
13
+ export declare const CREDENTIAL_ECHO_SITES: readonly ["server_info", "instructions", "tool_listing", "agent_card"];
14
+ export type CredentialEchoSite = (typeof CREDENTIAL_ECHO_SITES)[number];
15
+ /** What a peer's account is read with: the needle, and who hears that a site held it. */
16
+ export interface CredentialEcho {
17
+ readonly credentials: readonly string[];
18
+ readonly announce: (where: CredentialEchoSite) => void;
19
+ }
20
+ export declare const NO_CREDENTIAL_ECHO: CredentialEcho;
21
+ /** The drop reason of a tool whose name or input schema holds its connection's credential. */
22
+ export declare const CREDENTIAL_ECHO_DROP_REASON = "its name or input schema holds a credential this connection's requests carried (the server echoed it back); neither is rewritten, so the tool is not mounted";
23
+ /** A free text of the peer's with the needle erased in place (absent stays absent); a text that held it announces `where`. */
24
+ export declare function erasedEcho(text: string | undefined, echo: CredentialEcho, where: CredentialEchoSite): string | undefined;
25
+ /** Whether a NAME the peer gave holds the needle (announced as `where` when it does): such a name is refused, never rewritten. */
26
+ export declare function nameEchoes(name: string, echo: CredentialEcho, where: CredentialEchoSite): boolean;
27
+ /** A listed input schema as one text for the needle (its keys and values, JSON-escaped as the echo spellings expect); a schema JSON cannot
28
+ * carry reads as nothing (the schema gate refuses it on its own). */
29
+ export declare function schemaText(schema: unknown): string;
30
+ /** A listed tool the needle refuses — named with it, or its input schema holding it (the schema is the tool's structure: its property
31
+ * names are what the model sends, not prose to edit) — as its drop record, the name erased; `undefined` for a tool the needle leaves. */
32
+ export declare function echoedToolDrop(name: string, inputSchema: unknown, echo: CredentialEcho): {
33
+ tool: string;
34
+ reason: string;
35
+ } | undefined;
36
+ /** How a connection's account is read: its carrier's credentials, a site that held one announced through `announce`. */
37
+ export declare function carrierEcho(carrier: {
38
+ readonly credentials: PeerCarrier["credentials"] | readonly string[];
39
+ }, announce: ((where: CredentialEchoSite) => void) | undefined): CredentialEcho;
40
+ /** The server's `serverInfo` as its status projects it: `name` is a name (holding the needle, the record is not projected — never
41
+ * rewritten), `version` free text (erased in place). */
42
+ export declare function serverInfoOf(info: {
43
+ name: string;
44
+ version: string;
45
+ } | undefined, echo: CredentialEcho): {
46
+ name: string;
47
+ version: string;
48
+ } | undefined;
49
+ /** One materialization's announcer: each (peer, site) heard once, a throwing listener never a fault of the dial it describes. */
50
+ export declare function echoAnnouncer(onCredentialEchoed: ((peer: string, where: CredentialEchoSite) => void) | undefined): (peer: string, where: CredentialEchoSite) => void;
51
+ /** The runner's listener → `mcp.credential_echoed` (engine-notice.ts): the peer and the site, never a value; operator audience. */
52
+ export declare function credentialEchoNotice(onNotice: ((notice: EngineNotice) => void) | undefined, sessionId: string, runId: string, protocol: "mcp" | "a2a"): (server: string, where: CredentialEchoSite) => void;
@@ -0,0 +1,65 @@
1
+ import { deliverEngineNotice } from "./engine-notice.js";
2
+ import { eraseSentCredentials } from "./protocol-http-auth.js";
3
+ import { inlineUntrusted } from "./untrusted-text.js";
4
+ export const CREDENTIAL_ECHO_SITES = Object.freeze(["server_info", "instructions", "tool_listing", "agent_card"]);
5
+ export const NO_CREDENTIAL_ECHO = Object.freeze({ credentials: Object.freeze([]), announce: () => undefined });
6
+ export const CREDENTIAL_ECHO_DROP_REASON = "its name or input schema holds a credential this connection's requests carried (the server echoed it back); neither is rewritten, so the tool is not mounted";
7
+ export function erasedEcho(text, echo, where) {
8
+ if (typeof text !== "string")
9
+ return text;
10
+ const erased = eraseSentCredentials(text, echo.credentials);
11
+ if (erased !== text)
12
+ echo.announce(where);
13
+ return erased;
14
+ }
15
+ export function nameEchoes(name, echo, where) {
16
+ const echoed = typeof name === "string" && eraseSentCredentials(name, echo.credentials) !== name;
17
+ if (echoed)
18
+ echo.announce(where);
19
+ return echoed;
20
+ }
21
+ export function schemaText(schema) {
22
+ try {
23
+ return JSON.stringify(schema) ?? "";
24
+ }
25
+ catch {
26
+ return "";
27
+ }
28
+ }
29
+ export function echoedToolDrop(name, inputSchema, echo) {
30
+ if (!nameEchoes(name, echo, "tool_listing") && !nameEchoes(schemaText(inputSchema), echo, "tool_listing"))
31
+ return undefined;
32
+ return { tool: inlineUntrusted(eraseSentCredentials(name, echo.credentials)), reason: CREDENTIAL_ECHO_DROP_REASON };
33
+ }
34
+ export function carrierEcho(carrier, announce) {
35
+ return { credentials: carrier.credentials, announce: announce ?? NO_CREDENTIAL_ECHO.announce };
36
+ }
37
+ export function serverInfoOf(info, echo) {
38
+ if (info === undefined)
39
+ return undefined;
40
+ if (nameEchoes(info.name, echo, "server_info"))
41
+ return undefined;
42
+ return { name: info.name, version: erasedEcho(info.version, echo, "server_info") ?? info.version };
43
+ }
44
+ export function echoAnnouncer(onCredentialEchoed) {
45
+ const announced = new Set();
46
+ return (peer, where) => {
47
+ const key = `${peer}\u0000${where}`;
48
+ if (onCredentialEchoed === undefined || announced.has(key))
49
+ return;
50
+ announced.add(key);
51
+ try {
52
+ onCredentialEchoed(peer, where);
53
+ }
54
+ catch {
55
+ }
56
+ };
57
+ }
58
+ const SITE_WORDS = { server_info: "serverInfo", instructions: "instructions", tool_listing: "tool listing", agent_card: "agent card" };
59
+ export function credentialEchoNotice(onNotice, sessionId, runId, protocol) {
60
+ return (server, where) => deliverEngineNotice(onNotice, {
61
+ code: "mcp.credential_echoed",
62
+ message: `${protocol === "mcp" ? "MCP server" : "A2A peer"} "${inlineUntrusted(server, 120)}" echoed a credential its requests carried into its ${SITE_WORDS[where]} — the engine erased it there (a name holding it was refused, not rewritten); the endpoint repeats what it is sent, so check what it logs and publishes.`,
63
+ detail: { protocol, server, where, sessionId, runId },
64
+ });
65
+ }