@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
@@ -1,18 +1,21 @@
1
- import { refuseRetentionPolicy } from "./retention-policy.js";
1
+ import { optionKeys, receiveMembers } from "./own-property-receipt.js";
2
+ import { refuseRetentionPolicy, retentionKnobRefusal } from "./retention-policy.js";
2
3
  export const DEFAULT_FILE_HISTORY_BOUNDARY_KEEP = 100;
3
- const KNOWN_KNOBS = new Set(["keep"]);
4
- export function resolveFileHistoryRetention(label, policy) {
4
+ const FILE_HISTORY_RETENTION_KNOBS = optionKeys()({ keep: 0 });
5
+ export function receiveFileHistoryRetention(label, policy) {
5
6
  if (policy === undefined)
6
- return DEFAULT_FILE_HISTORY_BOUNDARY_KEEP;
7
+ return undefined;
7
8
  if (typeof policy !== "object" || policy === null || Array.isArray(policy)) {
8
- refuseRetentionPolicy(label, "retention", policy, `an object of retention knobs (${[...KNOWN_KNOBS].join(", ")}) or omitted`);
9
- }
10
- const unknown = Object.keys(policy).filter((k) => !KNOWN_KNOBS.has(k));
11
- if (unknown.length > 0) {
12
- const first = unknown[0];
13
- refuseRetentionPolicy(label, `retention.${first}`, policy[first], `omitted — ${JSON.stringify(first)} is not a retention knob (the only knob is "keep"), and a misspelled one would leave the engine default in force while the operator believes their own number is`);
9
+ refuseRetentionPolicy(label, "retention", policy, `an object of retention knobs (${FILE_HISTORY_RETENTION_KNOBS.join(", ")}) or omitted`);
14
10
  }
15
- const keep = policy.keep;
11
+ const copy = receiveMembers(policy, { subject: `${label}.retention`, unit: "retention knob", moment: "at construction" }, FILE_HISTORY_RETENTION_KNOBS, retentionKnobRefusal);
12
+ boundaryKeepOf(label, copy.keep);
13
+ return copy;
14
+ }
15
+ export function resolveFileHistoryRetention(label, policy) {
16
+ return boundaryKeepOf(label, receiveFileHistoryRetention(label, policy)?.keep);
17
+ }
18
+ function boundaryKeepOf(label, keep) {
16
19
  if (keep === undefined)
17
20
  return DEFAULT_FILE_HISTORY_BOUNDARY_KEEP;
18
21
  if (keep === "unbounded")
@@ -597,7 +597,37 @@ export interface FileHistoryStore {
597
597
  */
598
598
  exportHistory?(scope: string): Promise<FileHistoryExportResult>;
599
599
  importHistory?(scope: string, data: FileHistoryExport, srcGetBlob: (hash: string) => Promise<Uint8Array | undefined>): Promise<FileHistoryResult>;
600
+ /**
601
+ * The store's blob exchange — how another machine's bytes come in ahead of an import, go out to a puller, and are
602
+ * asked about — as one optional member group ({@link FileHistoryBlobExchange}): present ⇒ all three of its members;
603
+ * absent ⇒ this store exchanges no blobs (it can still import, from a source the caller reads). Read through
604
+ * {@link fileHistoryBlobExchangeOf}, which refuses a group with a member missing. A puller hands
605
+ * `blobExchange.get` to {@link importHistory} as its `srcGetBlob`.
606
+ */
607
+ readonly blobExchange?: FileHistoryBlobExchange;
608
+ }
609
+ /**
610
+ * {@link FileHistoryStore.blobExchange}: one capability, three members.
611
+ *
612
+ * - `put(hash, bytes)` stores bytes under their content address. The store checks the address itself — bytes whose
613
+ * sha256 is not `hash` are refused (`adopt_failed`, `permanence: "terminal"`) and nothing is stored — and records
614
+ * the blob present the same way a capture records one, so bytes no history references yet are kept like any other
615
+ * unreferenced blob: until the orphan sweep's grace window runs out. Idempotent.
616
+ * - `get(hash)` answers the bytes, or `undefined` when the store does not hold them.
617
+ * - `has(hashes)` answers which of `hashes` the store holds, from its own index — no bytes are read.
618
+ */
619
+ export interface FileHistoryBlobExchange {
620
+ put(hash: string, bytes: Uint8Array): Promise<FileHistoryResult>;
621
+ get(hash: string): Promise<Uint8Array | undefined>;
622
+ has(hashes: readonly string[]): Promise<ReadonlySet<string>>;
600
623
  }
624
+ /**
625
+ * The store's blob exchange, read as one capability: `undefined` when the store carries no `blobExchange`; its three
626
+ * members, bound, when it carries the whole group; a refusal (`config.invalid_argument`) when the group is not an
627
+ * object or a member is missing or not a function. A store that still carries the retired `syncBlobFaces` marker is
628
+ * refused too: the capability is the group's presence, and a second word for it is a second reading.
629
+ */
630
+ export declare function fileHistoryBlobExchangeOf(store: FileHistoryStore): FileHistoryBlobExchange | undefined;
601
631
  /**
602
632
  * design/381 §3 + §10 T-5 — the FENCING judge for a boundary-capture attempt, exposed as a
603
633
  * direct-callable function (the G6b grey-box seat) and used by every in-tree backend as the single
@@ -852,7 +882,7 @@ export declare class InMemoryFileHistoryStore implements FileHistoryStore {
852
882
  * (adversarial round): two concurrent captures can lease the same new hash, and the first
853
883
  * attempt's release must not strip the second attempt's liveness. */
854
884
  private readonly inFlightBlobs;
855
- constructor(opts?: InMemoryFileHistoryStoreOptions);
885
+ constructor(options?: InMemoryFileHistoryStoreOptions);
856
886
  /**
857
887
  * The RETENTION pass, run after a boundary commits (design/381 §片2 — see {@link FileHistoryStore.reap}
858
888
  * for why the backend owns this rather than the host). Boundaries are an insertion-ordered map
@@ -1,7 +1,9 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { readMember, thrownText } from "./thrown-value.js";
3
+ import { readMemberGroup } from "./member-group.js";
3
4
  import { isAbsoluteForFamily, isWinFormPath, pathFamilyOf, relativeInEveryFamily } from "../tools/fs/safety.js";
4
5
  import { fileHistoryBoundariesToKeep, resolveFileHistoryRetention } from "./file-history-retention.js";
6
+ import { optionKeys, receiveOptions } from "./own-property-receipt.js";
5
7
  const normSlash = (p) => p.replace(/\\/g, "/");
6
8
  const stripTrailSep = (p) => (isWinFormPath(p) ? p.replace(/[\\/]+$/, "") : p.replace(/\/+$/, ""));
7
9
  const foldDrive = (p) => (/^[A-Za-z]:(\/|$)/.test(p) ? p[0].toLowerCase() + p.slice(1) : p);
@@ -244,6 +246,31 @@ function judgeFileHistoryEnvelope(data) {
244
246
  }
245
247
  return { ok: true };
246
248
  }
249
+ const BLOB_EXCHANGE_MEMBERS = Object.freeze(["put", "get", "has"]);
250
+ export function fileHistoryBlobExchangeOf(store) {
251
+ const owner = "FileHistoryStore.blobExchange";
252
+ let marker;
253
+ let group;
254
+ try {
255
+ marker = Reflect.get(store, "syncBlobFaces");
256
+ group = store.blobExchange;
257
+ }
258
+ catch (cause) {
259
+ throw invalidBlobExchange(`${owner} could not be read (${thrownText(cause)}).`);
260
+ }
261
+ if (marker !== undefined)
262
+ throw invalidBlobExchange(`FileHistoryStore carries the retired syncBlobFaces marker — the blob exchange is the ${owner} group (put / get / has): present means the capability, absent means none.`);
263
+ if (group === undefined)
264
+ return undefined;
265
+ if (typeof group !== "object" || group === null)
266
+ throw invalidBlobExchange(`${owner} must be an object with put / get / has (got ${group === null ? "null" : typeof group}).`);
267
+ return readMemberGroup(owner, group, BLOB_EXCHANGE_MEMBERS, true);
268
+ }
269
+ function invalidBlobExchange(message) {
270
+ const e = new Error(message);
271
+ e.code = "config.invalid_argument";
272
+ return e;
273
+ }
247
274
  export function boundaryPublishVerdict(attempt) {
248
275
  return attempt.aborted ? { publish: false, reason: "aborted" } : { publish: true };
249
276
  }
@@ -412,13 +439,15 @@ async function applyRecordedMode(env, absPath, opts, currentMode) {
412
439
  const r = await env.setFileMode(absPath, want & 0o7777, opts.signal);
413
440
  return r.ok ? "applied" : "unpreserved";
414
441
  }
442
+ const IN_MEMORY_FILE_HISTORY_STORE_OPTION_KEYS = optionKeys()({ retention: 0 });
415
443
  export class InMemoryFileHistoryStore {
416
444
  scopes = new Map();
417
445
  boundaryKeep;
418
446
  blobs = new Map();
419
447
  inFlightBlobs = new Map();
420
- constructor(opts) {
421
- this.boundaryKeep = resolveFileHistoryRetention("InMemoryFileHistoryStore", opts?.retention);
448
+ constructor(options) {
449
+ const opts = receiveOptions(options, "InMemoryFileHistoryStore", IN_MEMORY_FILE_HISTORY_STORE_OPTION_KEYS);
450
+ this.boundaryKeep = resolveFileHistoryRetention("InMemoryFileHistoryStore", opts.retention);
422
451
  }
423
452
  applyBoundaryRetention(scope, justCommitted) {
424
453
  if (this.boundaryKeep === null)
@@ -40,6 +40,13 @@ export interface FrameSettlement {
40
40
  * host decided what the model reads, so the consumer settles the record as the host's decision (terminal),
41
41
  * discloses it loudly, and never hands it over again. */
42
42
  readonly hostWithheld: Set<string>;
43
+ /** Awaited keys whose frame the session's receiving station did not hand over ({@link settleConsumedFrame}): an
44
+ * extension consumed it, or a handler there failed — key → who (an extension's name, or `engine`) and why. The consumer
45
+ * settles the record as that decision (terminal), tells its sender, and never hands it over again. */
46
+ readonly consumed: Map<string, {
47
+ readonly by: string;
48
+ readonly reason: string;
49
+ }>;
43
50
  /** Compactions that LANDED this run and have not been consumed by a settlement pass yet, in landing
44
51
  * order. Recorded only while {@link FrameSettlement.wantsEffects} says a record could still be
45
52
  * broken by one, and cleared by the consumer's LOCAL settlement half — which needs no lease, so an
@@ -63,6 +70,9 @@ export interface FrameSettlement {
63
70
  wantsEffects?: () => boolean;
64
71
  }
65
72
  export declare function createFrameSettlement(): FrameSettlement;
73
+ /** The receiving station did not hand the frame keyed `key` over: its ask is answered now, as consumed (only an ask some
74
+ * consumer registered is answered — a frame nobody awaits leaves nothing behind). */
75
+ export declare function settleConsumedFrame(seam: FrameSettlement, key: string, by: string, reason: string): void;
66
76
  /** The carrier key of a TOOL RESULT (the `ReadInbox` pull face): its own domain, so it can never
67
77
  * collide with an injection queue dedup key. One tool result can carry SEVERAL frames, each asked for
68
78
  * under its own key with this carrier. */
@@ -81,6 +91,11 @@ export declare function frameSurvivesInToolResult(committedContent: unknown, fra
81
91
  /** The station that applies a HOST hook's `updatedOutput` marks the carrier — only when an ask rides it, so an
82
92
  * ordinary rewritten result leaves nothing behind. */
83
93
  export declare function noteHostRewrite(seam: FrameSettlement, toolCallId: string): void;
94
+ /** A station WITHHELD a call's result in place of what it produced (a checking extension could not hand back its answer):
95
+ * the host side decided what the model reads, so the carrier is marked as rewritten and its asks are answered now,
96
+ * against the content that replaces the result, through the one writer below — a call whose result no transcript commit
97
+ * follows (an extension's own call) is settled all the same, and the commit of one that does follow finds nothing left. */
98
+ export declare function settleWithheldResult(seam: FrameSettlement, toolCallId: string, content: unknown): void;
84
99
  /** The receipt sink's ONE writer: every ask riding `carrier` is answered — a receipt when its frame is in
85
100
  * the committed content (or it is its own carrier); when it is not, host-withheld if a host hook rewrote the
86
101
  * carrier (the host's decision), withheld otherwise (owed again). */
@@ -1,5 +1,10 @@
1
1
  export function createFrameSettlement() {
2
- return { awaiting: new Map(), receipts: new Map(), withheld: new Set(), hostRewritten: new Set(), hostWithheld: new Set(), compactions: [] };
2
+ return { awaiting: new Map(), receipts: new Map(), withheld: new Set(), hostRewritten: new Set(), hostWithheld: new Set(), consumed: new Map(), compactions: [] };
3
+ }
4
+ export function settleConsumedFrame(seam, key, by, reason) {
5
+ if (!seam.awaiting.delete(key))
6
+ return;
7
+ seam.consumed.set(key, Object.freeze({ by, reason }));
3
8
  }
4
9
  export function toolResultReceiptKey(toolCallId) {
5
10
  return `tool_result:${toolCallId}`;
@@ -22,6 +27,10 @@ export function noteHostRewrite(seam, toolCallId) {
22
27
  }
23
28
  }
24
29
  }
30
+ export function settleWithheldResult(seam, toolCallId, content) {
31
+ noteHostRewrite(seam, toolCallId);
32
+ recordFrameReceipt(seam, toolResultReceiptKey(toolCallId), content, "");
33
+ }
25
34
  export function recordFrameReceipt(seam, carrier, committedContent, entryId) {
26
35
  const hostRewrote = seam.hostRewritten.delete(carrier);
27
36
  for (const [key, ask] of seam.awaiting) {
@@ -1,5 +1,5 @@
1
1
  import type { ExecutionEnv } from "../internal/harness-types.js";
2
- import type { PermissionResult, ToolPolicy } from "./tool-policy.js";
2
+ import type { PermissionResult, ToolCallRequest, ToolPolicy } from "./tool-policy.js";
3
3
  import { type PathGuardRow } from "./path-guard-rows.js";
4
4
  /** One write domain SOURCE as an allow row of the one table: it reaches every location at or below one of its admitted keys.
5
5
  * The write gate's three sources, and a session rule's `allowDirs` (the confinement that admits a write only inside them). */
@@ -39,8 +39,8 @@ export interface FsWriteGatePolicyOptions {
39
39
  defaultWrite: "ask" | "allow";
40
40
  /** The ask the default verdict mints in place of the gate's ordinary write question — a permission mode's own
41
41
  * sentence over the resolved `path`, with the gate's domain note (a configured domain that was not honored) to
42
- * append when there is one. Read only where `defaultWrite` is `"ask"`. */
43
- defaultAsk?: (path: string, note: string | undefined) => PermissionResult;
42
+ * append when there is one, and the call it answers. Read only where `defaultWrite` is `"ask"`. */
43
+ defaultAsk?: (path: string, note: string | undefined, call: ToolCallRequest) => PermissionResult;
44
44
  /**
45
45
  * Session-exemption lookup ("allow all for this session" grants recorded by the deployment's approval
46
46
  * surface). Consulted ONCE per covered write, after the domain checks and immediately BEFORE the gate
@@ -1,4 +1,5 @@
1
1
  import { canonicalizeTarget, lexicalViewOf, pathFamilyOf, writeTargetPath } from "../tools/fs/safety.js";
2
+ import { attest } from "./engine-attestation.js";
2
3
  import { isWithin } from "./runner/session-rule-policy.js";
3
4
  import { swallowedFenceRoot } from "./runner/advertised-writable-dirs.js";
4
5
  import { declaredPathTargetOf, isProtectedWrite } from "./tool-registry.js";
@@ -51,9 +52,6 @@ export function createFsWriteGatePolicy(opts) {
51
52
  const rootLexical = absoluteRootOf(rootPath, env.cwd);
52
53
  assertExemptDirsDoNotCoverRoot(exemptDirs, rootLexical);
53
54
  const guardedCapable = env.writeFileGuarded !== undefined;
54
- const advisory = guardedCapable
55
- ? ""
56
- : " (advisory adjudication: this environment provides no guarded write, so approval is judged before a separate, non-atomic write step)";
57
55
  return {
58
56
  async check(req, signal) {
59
57
  if (!isProtectedWrite(req))
@@ -68,11 +66,11 @@ export function createFsWriteGatePolicy(opts) {
68
66
  const declared = declaredPathTargetOf(req);
69
67
  const path = declared === undefined ? undefined : writeTargetPath(req, declared);
70
68
  if (path === undefined) {
71
- return ask(`write tool "${req.toolName}" requires approval: the call has no resolvable path target to confine${declared === undefined ? " (the tool declares no path target)" : ""}${advisory}`);
69
+ return ask(`write tool "${req.toolName}" requires approval: the call has no resolvable path target to confine${declared === undefined ? " (the tool declares no path target)" : ""}`);
72
70
  }
73
71
  const canon = await canonicalizeTarget(env, path, signal, pathFamilyOf({ root: rootPath, cwd: req.cwd ?? env.cwd }), pathTargetBaseOf(declared, { root: rootPath, cwd: req.cwd }));
74
72
  if (!canon.ok) {
75
- return ask(`write to "${path}" requires approval: its real target could not be resolved (${canon.message})${advisory}`);
73
+ return ask(`write to "${path}" requires approval: its real target could not be resolved (${canon.message})`);
76
74
  }
77
75
  const advertised = req.advertisedWritableRoots ?? [];
78
76
  const targetViews = { views: [{ path: canon.key, kind: "canonical" }] };
@@ -132,8 +130,11 @@ export function createFsWriteGatePolicy(opts) {
132
130
  return { action: "allow" };
133
131
  const note = refusedDomain === undefined ? undefined : ` — note: the configured write domain ${refusedDomain} was not honored; a domain that holds the root would exempt every write under it`;
134
132
  if (opts.defaultAsk !== undefined)
135
- return opts.defaultAsk(path, note);
136
- return ask(`approve write to "${path}"?${advisory}${note ?? ""}`);
133
+ return opts.defaultAsk(path, note, req);
134
+ if (note !== undefined)
135
+ return ask(`approve write to "${path}"?${note}`);
136
+ const generic = `approve write to "${path}"?`;
137
+ return attest(ask(generic), req, { genericQuestion: generic });
137
138
  },
138
139
  };
139
140
  }
@@ -2,7 +2,7 @@ import { inlineUntrusted } from "./untrusted-text.js";
2
2
  import { markTightenMessage } from "./safety-axis-vocab.js";
3
3
  import { PROBE_REASON_MAX, normalizeProbeCause } from "./checkpoint-store.js";
4
4
  import { normalizeReadRootCandidate } from "./read-root-candidate.js";
5
- import { engineFailClosedExit, hookDenyExit } from "./runner/gate-exit.js";
5
+ import { engineFailClosedExit, hookDenyExit, settledScreenExit, takeInheritedScreen } from "./runner/gate-exit.js";
6
6
  import { noteRewrite, POLICY_AUTHOR, readRejudge, screenRewrite } from "./rewrite-rejudge.js";
7
7
  import { traceHookCrash } from "./gate-crash-trace.js";
8
8
  import { writeProtectionMandated, writeProtectionReachOf, writeProtectionTightenDecision } from "./write-protect.js";
@@ -12,7 +12,7 @@ import { failedJudgmentDeny } from "./runner/policy-throw.js";
12
12
  import { thrownText } from "./thrown-value.js";
13
13
  import { argsAsTheToolReads } from "./effective-path-target.js";
14
14
  import { foldHookAsk, refuseOutOfContractDecision } from "./tool-policy.js";
15
- import { withProbeMandate } from "./ask-origin.js";
15
+ import { withChainAskReasons, withProbeMandate } from "./ask-origin.js";
16
16
  import { applyUnansweredSilence, readStationAnswer, silencedBy } from "./shell-read-silence.js";
17
17
  import { asksUnstated, permissionSeatAt, unstatedAskMessage } from "./mode-policy.js";
18
18
  export async function runGateFold(pass) {
@@ -40,17 +40,20 @@ export async function runGateFold(pass) {
40
40
  if (attributed !== undefined)
41
41
  pass.classifierRound = attributed;
42
42
  }
43
+ pass.decision = withChainAskReasons(pass.decision, pass.req);
43
44
  const rewritten = pass.screening !== undefined && pass.decision.action !== "deny" ? readRejudge(pass.req, pass.currentInput, pass.decision) : undefined;
44
45
  if (pass.screening !== undefined && rewritten?.kind === "rewritten") {
45
46
  const second = await screenRewrite(pass.screening, pass.req, rewritten.form, `the rewritten call to "${toolName}"`);
46
- if (second.kind === "refused") {
47
- pass.currentInput = rewritten.form;
47
+ if (second.kind === "refused" || second.kind === "settled") {
48
+ pass.currentInput = second.judged !== undefined ? second.judged : rewritten.form;
49
+ if (second.kind === "settled")
50
+ return await settledScreenExit(pass, second);
48
51
  return second.by === "hook" ? hookDenyExit(pass, second.reason, second.extension) : await engineFailClosedExit(pass, second.reason, second.extension);
49
52
  }
50
- if (second.answer?.additionalContext)
51
- pass.preToolContext.push(second.answer.additionalContext);
53
+ pass.preToolContext.push(...second.contexts);
52
54
  pass.hookAsk = second.answer?.action === "ask" ? second.answer : undefined;
53
55
  pass.hookAllowedBy = second.answer?.action === "allow" ? (second.answeredBy !== undefined ? [second.answeredBy] : []) : undefined;
56
+ takeInheritedScreen(pass, second.inherited);
54
57
  }
55
58
  if ((pass.decision.action === "allow" || pass.decision.action === "ask") && pass.decision.updatedInput !== undefined) {
56
59
  pass.policyRewrite = argsAsTheToolReads(pass.req, pass.decision.updatedInput);
@@ -1,7 +1,7 @@
1
1
  import { argsAsTheToolReads, withArgsReading } from "./effective-path-target.js";
2
2
  import { attest, attestationOf, bindableArgsOf, decisionText, foldHookAsk, refusalOf, refuseOutOfContractDecision } from "./tool-policy.js";
3
3
  import { APPROVER_AUTHOR, extensionAuthors, noteRewrite, outletAsk, POLICY_AUTHOR, readRejudge, rewriteChasedSentence, screenRewrite } from "./rewrite-rejudge.js";
4
- import { arbitrateByMode, classifyAsk, decisionAskClassesOf, dontAskRefusalMessage, fileCommandOptionsSentence, persistedRuleMandateOf, safetyAxisOf, stampAskOrigin } from "./ask-origin.js";
4
+ import { arbitrateByMode, askReasonsOf, classifyAsk, joinAskReasons, decisionAskClassesOf, dontAskRefusalMessage, fileCommandOptionsSentence, persistedRuleMandateOf, safetyAxisOf, stampAskOrigin, withChainAskReasons } from "./ask-origin.js";
5
5
  import { classifierParseFailureDenyMessage, denialLimitFallbackMessage, rungDidNotRule, unarmedWindow } from "./auto-mode.js";
6
6
  import { classifierNoRulingArm, settleNoRulingAsk } from "./classifier-unavailable-arm.js";
7
7
  import { SETTLEMENT_NOBODY_JUDGED } from "./gate-outcome.js";
@@ -19,12 +19,13 @@ import { callFaceSeat } from "./tool-roster.js";
19
19
  import { wireOf } from "./tool-name-readings.js";
20
20
  import { modeAcceptsFileCommand } from "./mode-policy.js";
21
21
  import { ORG_RULE_DECISION_REASON, ORG_UNAVAILABLE_DECISION_REASON, orgUnreadableClause } from "./permission-rule-org.js";
22
- import { exitGate, passAskFace, untakenValueExit } from "./runner/gate-exit.js";
22
+ import { exitGate, passAskFace, takeSettledScreen, untakenValueExit } from "./runner/gate-exit.js";
23
23
  import { readOrgRuleLane, readPersistedRuleLane } from "./rule-lane-reads.js";
24
24
  import { traceHookCrash } from "./gate-crash-trace.js";
25
25
  import { createGateDeadline, awaitWriteProtectionJudgment, withGateTimeout } from "./gate-bounded-await.js";
26
26
  import { readStationAnswer } from "./shell-read-silence.js";
27
- import { agentIdOf, judgedInputOf, raiseToolCheck } from "./mods/stations.js";
27
+ import { judgedInputOf, raiseToolCheck } from "./mods/stations.js";
28
+ import { agentIdOf } from "./leg-identity.js";
28
29
  import { extensionAllowOf, readToolChecks } from "./tool-check-reading.js";
29
30
  import { policyThrowLine, reportPolicyThrow } from "./runner/policy-throw.js";
30
31
  function parkWith(suspendAsk, parkArgs, carry) {
@@ -60,6 +61,7 @@ export async function runGateLanes(pass) {
60
61
  ...(d.action === "ask" && d.askClass !== undefined && d.classes !== undefined ? { askClass: d.askClass, classes: d.classes } : {}),
61
62
  ...(d.action === "ask" && d.mandated === true ? { mandated: true, ...(d.mandate !== undefined ? { mandate: d.mandate } : {}) } : {}),
62
63
  ...(d.action === "ask" && d.authoredBy === "deployment" ? { authoredBy: "deployment" } : {}),
64
+ ...askReasonsOf(d),
63
65
  });
64
66
  const parkAsk = async (d, req, args, safety, liveFaceUnavailable, org) => {
65
67
  if (suspendAsk === undefined || d.action !== "ask")
@@ -193,7 +195,7 @@ export async function runGateLanes(pass) {
193
195
  };
194
196
  const chains = [
195
197
  ...(own !== undefined ? [{ raise: (p) => raiseToolCheck(own, { ...e }, p, signal), ...(mayClear !== undefined ? { mayClear } : {}) }] : []),
196
- ...(input.inheritedToolChecks ?? []).map((c) => ({ raise: (p) => raiseToolCheck(c.bus, { ...e }, p, signal, c.judges), settle: settleThroughLedger(c.settle) })),
198
+ ...(input.inheritedInstallations ?? []).map((c) => ({ raise: (p) => raiseToolCheck(c.bus, { ...e }, p, signal, c.judges), settle: settleThroughLedger(c.settle) })),
197
199
  ];
198
200
  const project = (current, clears) => {
199
201
  const reason = decisionText(current);
@@ -208,7 +210,9 @@ export async function runGateLanes(pass) {
208
210
  pass.deniedExtension = settledRefusal === undefined ? by : undefined;
209
211
  pass.denyCause = settledRefusal?.cause;
210
212
  };
211
- if (pass.decision.action === "allow") {
213
+ if (pass.screenApproval !== undefined && pass.decision.action !== "deny")
214
+ takeApprovedEdit({ kind: "approved", allow: pass.screenApproval });
215
+ if (pass.decision.action === "allow" && !approvedWithArgs) {
212
216
  const read = await checkTool(pass.decision, finalArgs, orgAnswer.org, pass.policyRewrite);
213
217
  if (read !== undefined)
214
218
  pass.toolCheckRaised = true;
@@ -274,6 +278,7 @@ export async function runGateLanes(pass) {
274
278
  const storedAllows = laneAnswer?.hit?.behavior === "allow" ? laneAnswer.hit.rules : undefined;
275
279
  const members = [
276
280
  ["hook", () => (pass.hookAllowedBy !== undefined ? { entries: pass.hookAllowedBy, clear: () => extensionAllowOf(pass.hookAllowedBy ?? [], pass.policyRewrite), afterClear: async () => undefined } : undefined)],
281
+ ["hook", () => (pass.inheritedAllowedBy !== undefined ? { entries: pass.inheritedAllowedBy, clear: () => extensionAllowOf(pass.inheritedAllowedBy ?? [], pass.policyRewrite), afterClear: async () => undefined, discloseOnly: true } : undefined)],
277
282
  ["deployment", () => {
278
283
  const hit = input.deploymentAllows?.allowing(pass.req, mode);
279
284
  return hit && { entries: hit.entries, ...(hit.positions !== undefined ? { positions: hit.positions } : {}), clear: () => listAllow("deployment_rule", "the deployment's", hit.entries), afterClear: () => notifier.notifyAsync(() => input.deploymentAllows?.onAllowed?.({ toolName: pass.req.toolName, toolCallId, entries: hit.entries }), "toolGate.allowedToolsResolved") };
@@ -309,7 +314,7 @@ export async function runGateLanes(pass) {
309
314
  const hit = match();
310
315
  if (hit === undefined)
311
316
  continue;
312
- if (allowMayClear()) {
317
+ if (hit.discloseOnly !== true && allowMayClear()) {
313
318
  pass.decision = await clearAs(member, hit);
314
319
  break;
315
320
  }
@@ -585,16 +590,27 @@ export async function runGateLanes(pass) {
585
590
  let rewrittenEdit = false;
586
591
  if (screening !== undefined) {
587
592
  const screened = await screening.screen(editArgs, `the approved edit for "${toolName}"`, pass.req);
593
+ if ((screened.kind !== "answered" || screened.answer?.action === "deny") && screened.judged !== undefined)
594
+ editArgs = screened.judged;
588
595
  if (screened.kind === "refused") {
589
596
  editDenied = { action: "deny", message: screened.reason };
590
597
  pass.deniedBy = "hook";
591
598
  pass.deniedExtension = screened.extension;
592
599
  break;
593
600
  }
601
+ if (screened.kind === "settled") {
602
+ editDenied = takeSettledScreen(pass, screened);
603
+ break;
604
+ }
605
+ pass.preToolContext.push(...screened.contexts);
606
+ if (screened.inherited?.approved !== undefined) {
607
+ shownToApprover = { bytes: editArgs };
608
+ editArgs = screened.inherited.approved.updatedInput;
609
+ editAnswer = screened.inherited.approved;
610
+ continue;
611
+ }
594
612
  const hr = screened.answer;
595
613
  if (hr) {
596
- if (hr.additionalContext)
597
- pass.preToolContext.push(hr.additionalContext);
598
614
  if (hr.action === "deny") {
599
615
  editDenied = { action: "deny", message: decisionText(hr) ?? `the approved edit for "${toolName}" was blocked by a PreToolUse hook` };
600
616
  pass.deniedBy = "hook";
@@ -612,6 +628,9 @@ export async function runGateLanes(pass) {
612
628
  rewrittenEdit = true;
613
629
  }
614
630
  }
631
+ const floatedAsk = screened.inherited?.floated;
632
+ if (floatedAsk !== undefined)
633
+ editHookAsk = editHookAsk !== undefined ? foldHookAsk(editHookAsk, floatedAsk) : floatedAsk;
615
634
  }
616
635
  let recheck = { action: "allow" };
617
636
  if (adjudicate) {
@@ -632,7 +651,7 @@ export async function runGateLanes(pass) {
632
651
  if (attributed !== undefined)
633
652
  pass.classifierRound = attributed;
634
653
  const read = ledger.fromDecision(recheck);
635
- recheck = read.decision;
654
+ recheck = withChainAskReasons(read.decision, { toolCallId, toolName });
636
655
  if (recheck.action === "deny" && read.deniedBy !== undefined) {
637
656
  editDenied = recheck;
638
657
  pass.deniedBy = read.deniedBy;
@@ -655,16 +674,30 @@ export async function runGateLanes(pass) {
655
674
  editArgs = policyRead.form;
656
675
  rewrittenEdit = true;
657
676
  const second = screening !== undefined ? await screenRewrite(screening, pass.req, editArgs, `the rewritten edit for "${toolName}"`) : undefined;
677
+ if ((second?.kind === "refused" || second?.kind === "settled") && second.judged !== undefined)
678
+ editArgs = second.judged;
658
679
  if (second?.kind === "refused") {
659
680
  editDenied = { action: "deny", message: second.reason };
660
681
  pass.deniedBy = "hook";
661
682
  pass.deniedExtension = second.extension;
662
683
  break;
663
684
  }
685
+ if (second?.kind === "settled") {
686
+ editDenied = takeSettledScreen(pass, second);
687
+ break;
688
+ }
664
689
  if (second?.kind === "stands") {
665
- if (second.answer?.additionalContext)
666
- pass.preToolContext.push(second.answer.additionalContext);
690
+ pass.preToolContext.push(...second.contexts);
667
691
  editHookAsk = second.answer?.action === "ask" ? second.answer : undefined;
692
+ const floatedAsk = second.inherited?.floated;
693
+ if (floatedAsk !== undefined)
694
+ editHookAsk = editHookAsk !== undefined ? foldHookAsk(editHookAsk, floatedAsk) : floatedAsk;
695
+ if (second.inherited?.approved !== undefined) {
696
+ shownToApprover = { bytes: editArgs };
697
+ editArgs = second.inherited.approved.updatedInput;
698
+ editAnswer = second.inherited.approved;
699
+ continue;
700
+ }
668
701
  }
669
702
  }
670
703
  const editOrg = await applyOrgLayer(recheck, editArgs);
@@ -720,7 +753,8 @@ export async function runGateLanes(pass) {
720
753
  const rra = carried.requiresRealApproval === true ? { requiresRealApproval: true } : {};
721
754
  const call = { toolCallId, toolName };
722
755
  const folded = new Set([...(editDecision.action === "ask" ? (attestationOf(editDecision, call)?.foldedClasses ?? []) : []), ...decisionAskClassesOf(carried, call), ...(carried.classes ?? [])]);
723
- editDecision = stampEditAsk(editDecision.action === "ask" ? attest({ ...editDecision, ...rra }, call, { foldedClasses: [...folded] }) : carried);
756
+ const askReasons = editDecision.action === "ask" ? joinAskReasons(editDecision.askReasons, carried.askReasons) : undefined;
757
+ editDecision = stampEditAsk(editDecision.action === "ask" ? attest({ ...editDecision, ...rra, ...(askReasons !== undefined ? { askReasons } : {}) }, call, { foldedClasses: [...folded] }) : carried);
724
758
  carriedOwnAsk = undefined;
725
759
  }
726
760
  const editRead = await checkTool(editDecision, editArgs, editOrg.org, undefined);
@@ -135,12 +135,51 @@ export declare function isSettlementParty(v: unknown): v is SettlementParty;
135
135
  export declare const HOST_DECIDERS: readonly ["person", "sla_timeout", "policy"];
136
136
  export type HostDecider = (typeof HOST_DECIDERS)[number];
137
137
  export declare const isHostDecider: (word: unknown) => word is HostDecider;
138
+ /**
139
+ * WHICH MACHINE SEAT answered when the deployment's policy decided an ask — the closed set of the `decidedVia` member
140
+ * (`AskOutcome.decidedVia` on the synchronous leg, `hostDecision.decidedVia` on a durable decide; one word set, one
141
+ * name, both faces). It refines the policy decider and nothing else: a person, an elapsed window and the host's SLA
142
+ * sweep are not machines that answered, so the member beside any other decider word is refused, never ignored.
143
+ * - `policy` — the deployment's own policy answered (an unattended lane answering by class, a headless lane whose
144
+ * seat can show nobody a prompt). ABSENT reads the same: an unrevised host is unchanged.
145
+ * - `permission_request_hook` — a PermissionRequest hook answered the ask on the deployment's behalf (the
146
+ * reference's `decisionReason.type: "hook"` with `hookName: "PermissionRequest"`, `iPt` (cli309.js:288208) /
147
+ * `runHooks` (cli309.js:295883)). A hook's refusal is not "this run has no approval channel": something DID answer,
148
+ * and the model reads that the hook declined, with the hook's own words.
149
+ * The record is unchanged by it (`policy_allowed` / `policy_refused`, `who.party: "policy"`): the member decides which
150
+ * sentence the model reads ({@link import("./tool-policy.js").policyRefusalMessage}), not which party the record names.
151
+ */
152
+ export declare const DECIDED_VIA: readonly ["policy", "permission_request_hook"];
153
+ export type DecidedVia = (typeof DECIDED_VIA)[number];
154
+ export declare const isDecidedVia: (word: unknown) => word is DecidedVia;
155
+ /** The model-facing NAME of each machine seat a policy decision can come from ({@link policyDeciderOf}). */
156
+ declare const POLICY_DECIDER_NAMES: Readonly<{
157
+ readonly policy: "this deployment's own policy";
158
+ readonly permission_request_hook: "a PermissionRequest hook";
159
+ }>;
160
+ /** The fence over the name table: `never` while every seat word has a name. */
161
+ export type PolicyDeciderNamesCoverEverySeat = AssertAllKeysHandled<Exclude<DecidedVia, keyof typeof POLICY_DECIDER_NAMES>>;
162
+ /**
163
+ * THE reading of `decidedVia` — the one place its absence folds ("absent ⇒ the deployment's own policy") and the one
164
+ * place each seat is NAMED to the model. Every sentence that names who REFUSED a tool approval for the policy reads it:
165
+ * the refusal composer ({@link import("./tool-policy.js").policyRefusalMessage}, all three legs) and the durable
166
+ * resume's continuation reminder, so the tool result and the reminder about the same refusal can never name two
167
+ * different deciders. A sentence about a policy's ALLOW that a later check refuses names the party alone ("not a
168
+ * person"), and so does a plan pause's reminder.
169
+ */
170
+ export declare function policyDeciderOf(decidedVia: DecidedVia | undefined): {
171
+ readonly seat: DecidedVia;
172
+ readonly name: string;
173
+ };
138
174
  /** The host's DECISION FACTS on a durable decide — who ended the wait, and the attribution the approval channel
139
175
  * reported for that party. ONE shape for every decide that records its decider (a tool approval's and a plan
140
- * pause's); core mints the settlement word from it ({@link settlementOfHostDecision}), the host never supplies one. */
176
+ * pause's); core mints the settlement word from it ({@link settlementOfHostDecision}), the host never supplies one.
177
+ * `decidedVia` — which machine seat answered for a `"policy"` decider ({@link DECIDED_VIA}); legal only beside
178
+ * `decidedBy: "policy"`, absent ⇒ the deployment's policy. */
141
179
  export interface HostDecisionFacts {
142
180
  decidedBy: HostDecider;
143
181
  approver?: string;
182
+ decidedVia?: DecidedVia;
144
183
  }
145
184
  /** The DECIDER arms of {@link Settlement} — a person's and the deployment policy's, the two parties that
146
185
  * answer an ask either way. Named so a site that both composes one and quotes its note can read the seat
@@ -28,6 +28,16 @@ export function isSettlementParty(v) {
28
28
  }
29
29
  export const HOST_DECIDERS = Object.freeze(["person", "sla_timeout", "policy"]);
30
30
  export const isHostDecider = (word) => HOST_DECIDERS.some((w) => w === word);
31
+ export const DECIDED_VIA = Object.freeze(["policy", "permission_request_hook"]);
32
+ export const isDecidedVia = (word) => DECIDED_VIA.some((w) => w === word);
33
+ const POLICY_DECIDER_NAMES = Object.freeze({
34
+ policy: "this deployment's own policy",
35
+ permission_request_hook: "a PermissionRequest hook",
36
+ });
37
+ export function policyDeciderOf(decidedVia) {
38
+ const seat = decidedVia ?? "policy";
39
+ return { seat, name: POLICY_DECIDER_NAMES[seat] };
40
+ }
31
41
  export function decidersNote(text) {
32
42
  return text === "" ? undefined : text;
33
43
  }
@@ -1,4 +1,4 @@
1
- import type { ExecutionEnv } from "../internal/harness-types.js";
1
+ import type { ExecutionEnv, ReadFloor } from "../internal/harness-types.js";
2
2
  /** The managed parent (under the repository root) that holds every managed worktree — the reference implementation's
3
3
  * `.claude/worktrees/` under this project's brand — so {@link pruneWorktrees} and a userland reaper find orphans by one known
4
4
  * location. Every tree the engine mints lives at `<repoRoot>/.sema/worktrees/<slug>` (see {@link managedWorktreeDir}). */
@@ -31,6 +31,10 @@ export interface AddWorktreeOptions {
31
31
  rootEnvAt: (worktreeDir: string) => ExecutionEnv | Promise<ExecutionEnv>;
32
32
  /** Base commit/ref for the worktree (default `HEAD` at creation time). */
33
33
  commit?: string;
34
+ /** The byte floor (`ExecutionEnvExecOptions.readFloor`) of every start the mint and the tree's removal make, read as each
35
+ * start begins: a run's git bookkeeping is the run's own start and carries the run's table. A read that throws is that
36
+ * step's failure (the add's refuses the mint before anything exists). Absent ⇒ the starts carry none (no run). */
37
+ readFloor?: () => ReadFloor | undefined;
34
38
  }
35
39
  /**
36
40
  * Remove a managed worktree and — by the ONE branch rule — its branch: the branch is deleted only when its tip is still the
@@ -46,7 +50,7 @@ export interface AddWorktreeOptions {
46
50
  export declare function removeManagedWorktree(baseEnv: ExecutionEnv, repoRoot: string, worktreeDir: string, branch?: {
47
51
  readonly name: string;
48
52
  readonly baseSha: string;
49
- }): Promise<{
53
+ }, readFloor?: () => ReadFloor | undefined): Promise<{
50
54
  ok: true;
51
55
  branchDeleted?: string;
52
56
  branchKept?: string;
@@ -85,7 +89,7 @@ export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOpti
85
89
  * on a claim it could not have checked. Same fail-loud treatment {@link removeManagedWorktree} already got
86
90
  * Report the outcome, let the caller decide what to say. Never throws (a throwing env
87
91
  * lands on the same `{ok:false}`), so a caller that ignores the value behaves exactly as before. */
88
- export declare function pruneWorktrees(baseEnv: ExecutionEnv, repoRoot: string): Promise<{
92
+ export declare function pruneWorktrees(baseEnv: ExecutionEnv, repoRoot: string, readFloor?: ReadFloor): Promise<{
89
93
  ok: true;
90
94
  } | {
91
95
  ok: false;