@sema-agent/core 7.59.0 → 7.60.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 (360) hide show
  1. package/CHANGELOG.md +564 -0
  2. package/dist/agents/agent-definition.d.ts +7 -0
  3. package/dist/agents/agent-definition.js +12 -0
  4. package/dist/agents/agent-transcript-tool.d.ts +2 -1
  5. package/dist/agents/agent-transcript-tool.js +3 -1
  6. package/dist/agents/child-model-seat.js +6 -3
  7. package/dist/agents/cumulative-stats.js +0 -1
  8. package/dist/agents/inherited-tool-pool.d.ts +26 -1
  9. package/dist/agents/inherited-tool-pool.js +22 -0
  10. package/dist/agents/retain-ledger.d.ts +11 -1
  11. package/dist/agents/retain-ledger.js +13 -2
  12. package/dist/agents/roster-store.d.ts +1 -1
  13. package/dist/agents/roster-store.js +3 -1
  14. package/dist/agents/send-message-tool.d.ts +8 -19
  15. package/dist/agents/send-message-tool.js +11 -38
  16. package/dist/agents/subagent.d.ts +51 -17
  17. package/dist/agents/subagent.js +117 -78
  18. package/dist/agents/tool-filter.d.ts +1 -3
  19. package/dist/agents/tool-filter.js +4 -12
  20. package/dist/bench/metrics.d.ts +3 -5
  21. package/dist/bench/metrics.js +0 -1
  22. package/dist/brain/degrading.js +3 -1
  23. package/dist/brain/route-adjudicator.js +3 -1
  24. package/dist/brain/status-sink.d.ts +7 -1
  25. package/dist/brain/status-sink.js +6 -0
  26. package/dist/brain/timeout.d.ts +3 -1
  27. package/dist/brain/timeout.js +18 -5
  28. package/dist/core/a2a.d.ts +15 -5
  29. package/dist/core/a2a.js +34 -19
  30. package/dist/core/agent-definition.d.ts +20 -0
  31. package/dist/core/allow-entry.d.ts +2 -0
  32. package/dist/core/allow-entry.js +3 -1
  33. package/dist/core/artifact-host.d.ts +0 -2
  34. package/dist/core/artifact-host.js +0 -1
  35. package/dist/core/auto-mode-defaults.d.ts +8 -0
  36. package/dist/core/auto-mode-defaults.js +1 -0
  37. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  38. package/dist/core/auto-mode.d.ts +39 -4
  39. package/dist/core/auto-mode.js +63 -12
  40. package/dist/core/background-agent-store.d.ts +10 -1
  41. package/dist/core/background-agent-store.js +3 -2
  42. package/dist/core/background-shell.d.ts +12 -1
  43. package/dist/core/background-shell.js +12 -0
  44. package/dist/core/checkpoint-store.d.ts +8 -13
  45. package/dist/core/checkpoint-store.js +4 -3
  46. package/dist/core/compliance.d.ts +1 -1
  47. package/dist/core/credential-echo.d.ts +52 -0
  48. package/dist/core/credential-echo.js +65 -0
  49. package/dist/core/credential-vocabulary.d.ts +13 -3
  50. package/dist/core/credential-vocabulary.js +12 -4
  51. package/dist/core/cross-boundary-taint.d.ts +4 -5
  52. package/dist/core/engine-notice.d.ts +58 -15
  53. package/dist/core/frame-settlement.d.ts +5 -0
  54. package/dist/core/frame-settlement.js +4 -0
  55. package/dist/core/gate-fold.js +7 -5
  56. package/dist/core/gate-lanes.js +39 -8
  57. package/dist/core/governance-codes.d.ts +9 -1
  58. package/dist/core/governance-codes.js +12 -0
  59. package/dist/core/hands-band-screen.js +0 -1
  60. package/dist/core/hands-band.d.ts +0 -3
  61. package/dist/core/hooks.d.ts +39 -56
  62. package/dist/core/hooks.js +123 -77
  63. package/dist/core/image-admission.d.ts +104 -51
  64. package/dist/core/image-admission.js +170 -46
  65. package/dist/core/image-downsample.d.ts +36 -69
  66. package/dist/core/image-downsample.js +111 -73
  67. package/dist/core/integer-option.d.ts +21 -0
  68. package/dist/core/integer-option.js +13 -0
  69. package/dist/core/locked-config.d.ts +54 -3
  70. package/dist/core/locked-config.js +81 -50
  71. package/dist/core/mcp-call-meta.d.ts +2 -2
  72. package/dist/core/mcp-call-meta.js +9 -10
  73. package/dist/core/mcp-failure.d.ts +9 -3
  74. package/dist/core/mcp-failure.js +10 -0
  75. package/dist/core/mcp-host-seat.d.ts +92 -0
  76. package/dist/core/mcp-host-seat.js +131 -0
  77. package/dist/core/mcp-probe.d.ts +7 -2
  78. package/dist/core/mcp-probe.js +7 -2
  79. package/dist/core/mcp-server-spec.d.ts +38 -9
  80. package/dist/core/mcp-server-spec.js +55 -21
  81. package/dist/core/mcp.d.ts +17 -6
  82. package/dist/core/mcp.js +67 -55
  83. package/dist/core/memory-admission.d.ts +23 -6
  84. package/dist/core/memory-admission.js +19 -9
  85. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  86. package/dist/core/memory-engine/content-origin.js +21 -3
  87. package/dist/core/memory-engine/index.d.ts +2 -1
  88. package/dist/core/memory-engine/index.js +2 -1
  89. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  90. package/dist/core/memory-engine/scope-contract.js +2 -2
  91. package/dist/core/memory-engine/sync-client.d.ts +45 -11
  92. package/dist/core/memory-engine/sync-client.js +82 -11
  93. package/dist/core/memory-engine/sync-report.d.ts +103 -0
  94. package/dist/core/memory-engine/sync-report.js +119 -0
  95. package/dist/core/memory-engine/sync.d.ts +4 -2
  96. package/dist/core/mode-policy.d.ts +9 -1
  97. package/dist/core/mode-policy.js +11 -1
  98. package/dist/core/model-receipt.d.ts +39 -0
  99. package/dist/core/model-receipt.js +139 -0
  100. package/dist/core/mods/agent-stations.d.ts +65 -0
  101. package/dist/core/mods/agent-stations.js +105 -0
  102. package/dist/core/mods/kernel/dispatch.d.ts +5 -1
  103. package/dist/core/mods/kernel/dispatch.js +4 -4
  104. package/dist/core/mods/kernel/events.d.ts +10 -4
  105. package/dist/core/mods/kernel/events.js +10 -6
  106. package/dist/core/mods/kernel/receive.d.ts +5 -0
  107. package/dist/core/mods/kernel/receive.js +10 -0
  108. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  109. package/dist/core/mods/lifecycle-stations.js +35 -0
  110. package/dist/core/mods/stations.d.ts +51 -59
  111. package/dist/core/mods/stations.js +32 -42
  112. package/dist/core/mods/tool-call.d.ts +10 -4
  113. package/dist/core/mods/tool-call.js +28 -12
  114. package/dist/core/mounted-mcp.d.ts +5 -0
  115. package/dist/core/mounted-mcp.js +2 -2
  116. package/dist/core/namespaced-rule-name.d.ts +7 -1
  117. package/dist/core/namespaced-rule-name.js +13 -2
  118. package/dist/core/oracle-isolation.js +1 -1
  119. package/dist/core/own-property-receipt.d.ts +3 -0
  120. package/dist/core/own-property-receipt.js +3 -0
  121. package/dist/core/park-selfcheck.js +8 -8
  122. package/dist/core/peer-seat.d.ts +63 -8
  123. package/dist/core/peer-seat.js +179 -34
  124. package/dist/core/permission-rule-consent.d.ts +0 -21
  125. package/dist/core/permission-rule-consent.js +1 -2
  126. package/dist/core/permission-rule-model.d.ts +4 -2
  127. package/dist/core/permission-rule-model.js +7 -6
  128. package/dist/core/protocol-http-auth.d.ts +14 -2
  129. package/dist/core/protocol-http-auth.js +16 -7
  130. package/dist/core/read-face-seats.d.ts +7 -5
  131. package/dist/core/read-face-seats.js +4 -1
  132. package/dist/core/redaction-marks.d.ts +4 -3
  133. package/dist/core/redaction-marks.js +2 -2
  134. package/dist/core/remote-env.d.ts +146 -98
  135. package/dist/core/remote-env.js +113 -14
  136. package/dist/core/retention.js +37 -12
  137. package/dist/core/retired-keys.d.ts +6 -1
  138. package/dist/core/retired-keys.js +4 -1
  139. package/dist/core/rewrite-rejudge.d.ts +12 -5
  140. package/dist/core/rewrite-rejudge.js +9 -5
  141. package/dist/core/roles.d.ts +37 -3
  142. package/dist/core/roles.js +126 -78
  143. package/dist/core/rule-owner.d.ts +3 -0
  144. package/dist/core/runner/assemble-result.d.ts +0 -5
  145. package/dist/core/runner/assemble-result.js +0 -1
  146. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  147. package/dist/core/runner/call-hook-stations.js +21 -10
  148. package/dist/core/runner/child-tree.d.ts +7 -8
  149. package/dist/core/runner/child-tree.js +6 -6
  150. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  151. package/dist/core/runner/classifier-ladder.js +39 -8
  152. package/dist/core/runner/construction-doors.js +5 -0
  153. package/dist/core/runner/contracts.d.ts +62 -41
  154. package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
  155. package/dist/core/runner/cross-boundary-lane.js +11 -2
  156. package/dist/core/runner/env-capability-census.d.ts +15 -20
  157. package/dist/core/runner/env-capability-census.js +25 -34
  158. package/dist/core/runner/file-history-request.d.ts +2 -2
  159. package/dist/core/runner/file-history-request.js +0 -8
  160. package/dist/core/runner/gate-exit.d.ts +75 -7
  161. package/dist/core/runner/gate-exit.js +20 -1
  162. package/dist/core/runner/git-status-frame.d.ts +5 -2
  163. package/dist/core/runner/git-status-frame.js +3 -4
  164. package/dist/core/runner/image.d.ts +7 -2
  165. package/dist/core/runner/image.js +14 -8
  166. package/dist/core/runner/inline-image.d.ts +10 -8
  167. package/dist/core/runner/inline-image.js +11 -9
  168. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  169. package/dist/core/runner/permission-rule-lanes.js +1 -1
  170. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  171. package/dist/core/runner/prepare-boundary-parks.js +3 -3
  172. package/dist/core/runner/prepare-caps-and-workflow.d.ts +4 -0
  173. package/dist/core/runner/prepare-caps-and-workflow.js +4 -3
  174. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  175. package/dist/core/runner/prepare-config-doors.js +14 -9
  176. package/dist/core/runner/prepare-delegation-surface.d.ts +5 -3
  177. package/dist/core/runner/prepare-delegation-surface.js +4 -4
  178. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  179. package/dist/core/runner/prepare-file-history.js +3 -12
  180. package/dist/core/runner/prepare-gate-stations.d.ts +4 -3
  181. package/dist/core/runner/prepare-gate-stations.js +4 -3
  182. package/dist/core/runner/prepare-hands-readface.d.ts +3 -1
  183. package/dist/core/runner/prepare-hands-readface.js +15 -7
  184. package/dist/core/runner/prepare-inherited-gate.d.ts +5 -4
  185. package/dist/core/runner/prepare-inherited-gate.js +9 -5
  186. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  187. package/dist/core/runner/prepare-memory.d.ts +2 -2
  188. package/dist/core/runner/prepare-memory.js +2 -2
  189. package/dist/core/runner/prepare-park-ask.d.ts +3 -5
  190. package/dist/core/runner/prepare-park-ask.js +3 -8
  191. package/dist/core/runner/prepare-policy-chain.d.ts +5 -4
  192. package/dist/core/runner/prepare-policy-chain.js +120 -108
  193. package/dist/core/runner/prepare-project-context.js +8 -5
  194. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -1
  195. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  196. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  197. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  198. package/dist/core/runner/prepare-suspend-saga.d.ts +0 -2
  199. package/dist/core/runner/prepare-suspend-saga.js +5 -7
  200. package/dist/core/runner/prepare-task.js +41 -27
  201. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  202. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  203. package/dist/core/runner/prepare-wiring-manifest.d.ts +4 -3
  204. package/dist/core/runner/prepare-wiring-manifest.js +32 -18
  205. package/dist/core/runner/prepare-workspace-restore.js +3 -3
  206. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  207. package/dist/core/runner/retired-runner-deps.js +4 -1
  208. package/dist/core/runner/run-attachment-seats.js +3 -3
  209. package/dist/core/runner/run-brain-sinks.js +1 -0
  210. package/dist/core/runner/run-git-lane.d.ts +3 -1
  211. package/dist/core/runner/run-git-lane.js +1 -1
  212. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  213. package/dist/core/runner/run-harness-handlers.js +3 -1
  214. package/dist/core/runner/run-identity-wiring.js +1 -1
  215. package/dist/core/runner/run-leg.js +26 -28
  216. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  217. package/dist/core/runner/run-notification-lane.js +16 -10
  218. package/dist/core/runner/run-settle-and-teardown.js +5 -1
  219. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  220. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  221. package/dist/core/runner/run-turn-boundary.js +12 -7
  222. package/dist/core/runner/runtask.d.ts +7 -4
  223. package/dist/core/runner/runtask.js +19 -11
  224. package/dist/core/runner/skills-seat.js +2 -2
  225. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  226. package/dist/core/runner/synthetic-tools.js +2 -2
  227. package/dist/core/runner/tool-disclosure.js +0 -2
  228. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  229. package/dist/core/runner/tool-face-overlay.js +26 -19
  230. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  231. package/dist/core/runner/tool-result-media-seat.js +17 -1
  232. package/dist/core/runner/turn-attachments.d.ts +3 -5
  233. package/dist/core/runner/turn-attachments.js +3 -16
  234. package/dist/core/runner-deps.d.ts +31 -18
  235. package/dist/core/secret-env.d.ts +3 -2
  236. package/dist/core/session-policy-store.d.ts +9 -2
  237. package/dist/core/session-policy-store.js +16 -1
  238. package/dist/core/session-store.d.ts +3 -2
  239. package/dist/core/session-store.js +50 -11
  240. package/dist/core/skill-grant.d.ts +9 -0
  241. package/dist/core/skill-grant.js +18 -0
  242. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  243. package/dist/core/store-contracts/tool-result-store-contract.js +37 -0
  244. package/dist/core/stub-env.d.ts +5 -5
  245. package/dist/core/stub-env.js +11 -1
  246. package/dist/core/swappable-deps.d.ts +17 -43
  247. package/dist/core/swappable-deps.js +15 -5
  248. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  249. package/dist/core/task-event.d.ts +18 -2
  250. package/dist/core/task-notification.d.ts +88 -5
  251. package/dist/core/task-notification.js +130 -7
  252. package/dist/core/task-registry-agent.d.ts +18 -12
  253. package/dist/core/task-registry-agent.js +18 -6
  254. package/dist/core/task-registry-monitor.d.ts +7 -0
  255. package/dist/core/task-registry-monitor.js +28 -1
  256. package/dist/core/task-registry-shared.d.ts +38 -3
  257. package/dist/core/task-registry-shared.js +21 -7
  258. package/dist/core/task-registry-workflow.js +1 -1
  259. package/dist/core/task-registry.d.ts +50 -35
  260. package/dist/core/task-registry.js +64 -23
  261. package/dist/core/task-result.d.ts +3 -12
  262. package/dist/core/task-spec.d.ts +3 -6
  263. package/dist/core/task-stream.d.ts +1 -1
  264. package/dist/core/tool-catalog-entries.js +1 -1
  265. package/dist/core/tool-face-reader.d.ts +7 -6
  266. package/dist/core/tool-face-reader.js +4 -3
  267. package/dist/core/tool-name-aliases.d.ts +19 -0
  268. package/dist/core/tool-name-aliases.js +54 -2
  269. package/dist/core/tool-policy.d.ts +5 -4
  270. package/dist/core/tool-policy.js +1 -1
  271. package/dist/core/tool-registry.d.ts +5 -5
  272. package/dist/core/tool-registry.js +2 -2
  273. package/dist/core/tool-result-store.d.ts +88 -5
  274. package/dist/core/tool-result-store.js +51 -12
  275. package/dist/core/tool-spec.d.ts +20 -4
  276. package/dist/core/trace.d.ts +0 -1
  277. package/dist/core/types.d.ts +3 -3
  278. package/dist/core/types.js +1 -1
  279. package/dist/core/untrusted-text.js +1 -1
  280. package/dist/core/user-attachment.d.ts +10 -5
  281. package/dist/core/user-attachment.js +14 -6
  282. package/dist/engine/execution-env/node-execution-env.d.ts +7 -2
  283. package/dist/engine/execution-env/node-execution-env.js +12 -1
  284. package/dist/engine/harness/agent-harness.d.ts +1 -1
  285. package/dist/engine/harness/agent-harness.js +8 -4
  286. package/dist/engine/harness/types.d.ts +112 -29
  287. package/dist/engine/loop/agent-loop.d.ts +12 -12
  288. package/dist/engine/loop/agent-loop.js +153 -21
  289. package/dist/engine/loop/types.d.ts +9 -2
  290. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  291. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  292. package/dist/index.d.ts +22 -14
  293. package/dist/index.js +15 -10
  294. package/dist/internal/harness-types.d.ts +1 -1
  295. package/dist/orchestration/run-workflow-tool.d.ts +9 -3
  296. package/dist/orchestration/run-workflow-tool.js +59 -29
  297. package/dist/orchestration/workflow-governance.d.ts +1 -1
  298. package/dist/orchestration/workflow-governance.js +2 -1
  299. package/dist/orchestration/workflow.d.ts +4 -0
  300. package/dist/orchestration/workflow.js +25 -4
  301. package/dist/prompts/default.d.ts +1 -10
  302. package/dist/prompts/default.js +0 -2
  303. package/dist/stores/file/background-agent-store.d.ts +1 -1
  304. package/dist/stores/file/background-agent-store.js +3 -1
  305. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  306. package/dist/stores/file/checkpoint-store.js +19 -14
  307. package/dist/stores/file/file-history-store.d.ts +1 -1
  308. package/dist/stores/file/file-history-store.js +3 -1
  309. package/dist/stores/file/index.d.ts +4 -3
  310. package/dist/stores/file/index.js +17 -8
  311. package/dist/stores/file/mailbox-store.d.ts +1 -1
  312. package/dist/stores/file/mailbox-store.js +3 -1
  313. package/dist/stores/file/memory-store.d.ts +1 -1
  314. package/dist/stores/file/memory-store.js +3 -1
  315. package/dist/stores/file/session-policy-store.d.ts +1 -1
  316. package/dist/stores/file/session-policy-store.js +3 -1
  317. package/dist/stores/file/session-store.d.ts +1 -1
  318. package/dist/stores/file/session-store.js +3 -1
  319. package/dist/stores/file/shared-ledger.d.ts +26 -0
  320. package/dist/stores/file/shared-ledger.js +38 -9
  321. package/dist/stores/file/tool-result-store.d.ts +20 -2
  322. package/dist/stores/file/tool-result-store.js +74 -6
  323. package/dist/stores/file/usage-window-store.d.ts +1 -1
  324. package/dist/stores/file/usage-window-store.js +3 -1
  325. package/dist/stores/file/workflow-journal-store.d.ts +1 -11
  326. package/dist/stores/file/workflow-journal-store.js +3 -2
  327. package/dist/tools/fs/containment-face.d.ts +5 -0
  328. package/dist/tools/fs/encoding.d.ts +13 -4
  329. package/dist/tools/fs/encoding.js +17 -2
  330. package/dist/tools/fs/fs-bash-background-text.d.ts +7 -0
  331. package/dist/tools/fs/fs-bash-background-text.js +1 -0
  332. package/dist/tools/fs/fs-bash.d.ts +8 -4
  333. package/dist/tools/fs/fs-bash.js +26 -35
  334. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  335. package/dist/tools/fs/fs-pdf.js +26 -21
  336. package/dist/tools/fs/fs-read.d.ts +5 -4
  337. package/dist/tools/fs/fs-read.js +35 -18
  338. package/dist/tools/fs/fs-search-tools.js +4 -1
  339. package/dist/tools/fs/fs-shared.d.ts +11 -13
  340. package/dist/tools/fs/fs-shared.js +11 -7
  341. package/dist/tools/fs/fs-write.js +5 -5
  342. package/dist/tools/fs/index.d.ts +14 -8
  343. package/dist/tools/fs/index.js +8 -4
  344. package/dist/tools/fs/read-floor.d.ts +44 -1
  345. package/dist/tools/fs/read-floor.js +35 -0
  346. package/dist/tools/fs/removal-targets.d.ts +9 -4
  347. package/dist/tools/fs/removal-targets.js +17 -9
  348. package/dist/tools/fs/search.d.ts +3 -3
  349. package/dist/tools/fs/search.js +4 -4
  350. package/dist/tools/monitor.d.ts +5 -4
  351. package/dist/tools/monitor.js +15 -8
  352. package/dist/tools/scheduler-tools.js +42 -4
  353. package/dist/tools/web.d.ts +0 -10
  354. package/dist/tools/web.js +1 -4
  355. package/package.json +4 -2
  356. package/test/export-surface.snapshot.json +75 -21
  357. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  358. package/wire-changes/core@7.60.0.json +3274 -0
  359. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  360. package/wire-changes/primitives@7.60.0.json +30 -0
@@ -1,11 +1,11 @@
1
1
  import type { ActorAssertion, DocumentContent, ImageContent, TextContent } from "../internal/llm.js";
2
2
  import type { ExecutionEnv, FileError, Result, SessionTreeEntry } from "../internal/harness-types.js";
3
- import type { DecisionReason, PermissionResult, ResolvedAsk, ToolCallFace, ToolCallRequest, ToolPolicy } from "./tool-policy.js";
3
+ import type { DecisionReason, PermissionResult, ResolvedAsk, ToolCallFace, ToolCallRequest } from "./tool-policy.js";
4
4
  import { type CallTargetStamp } from "./effective-path-target.js";
5
- import type { GateOutcome } from "./gate-outcome.js";
5
+ import type { ClassifierDenyCause, DeniedBy, GateOutcome } from "./gate-outcome.js";
6
6
  import { type PreToolUseScreening } from "./runner/gate-exit.js";
7
7
  export { normalizeOrgGateVerdict, normalizePersistedRuleHit } from "./rule-lane-reads.js";
8
- import { type AskClass } from "./ask-class.js";
8
+ import type { AskClass } from "./ask-class.js";
9
9
  import { type PermissionMode } from "./ask-origin.js";
10
10
  import { type AutoModeDenialTracker } from "./auto-mode.js";
11
11
  export { formatHookFeedback } from "./reminder-mint.js";
@@ -438,9 +438,8 @@ export declare function createHookEnvCapabilities(env: ExecutionEnv): HookEnvCap
438
438
  * ({@link mintHookInvocationIdentity} — single mint home) and every station reuses it.
439
439
  * · HONESTLY ABSENT (no fabrication) where the engine structurally cannot know:
440
440
  * 1. a HOST driving the exported {@link runToolGate} directly without supplying `ToolGateInput.identity`;
441
- * 2. an ancestor's chain riding a DESCENDANT's constraint fold ({@link createPreToolUseConstraintPolicy}) — the
442
- * fold's request carries no leg identity, and stamping the INSTALL-site leg would name the wrong run;
443
- * 3. a deployment driving the compaction module directly with its own `preCompact`/`postCompact` options.
441
+ * 2. a deployment driving the compaction module directly with its own `preCompact`/`postCompact` options.
442
+ * (An ancestor's installation judging a DESCENDANT's call carries the descendant's envelope: the e is the judged leg's.)
444
443
  *
445
444
  * CONSUMER NOTE — the minted object is FROZEN and carries a NULL PROTOTYPE (same rule and same
446
445
  * trade as {@link HookEnvCapabilities}: absence must be a fact about this object, not about what
@@ -530,8 +529,9 @@ export interface HookToolOutput {
530
529
  * whole hook result; the concurrent arm never carried it, so the two arms disagreed on a member neither
531
530
  * of them reads. Nothing in the engine reads it off a decision.
532
531
  *
533
- * PreToolUse lane × settlement table (the gate's phase 1 in {@link runToolGate}; the delegated twin in
534
- * {@link createPreToolUseConstraintPolicy} speaks the same words as a policy layer). "Held" = the ask survives to a person:
532
+ * PreToolUse lane × settlement table (the gate's phase 1 in {@link runToolGate}, for the leg's own bus; an inherited
533
+ * installation's words are read in {@link createPreToolUseScreening}: its ask goes to its own frozen regime, its allow is no
534
+ * objection, its deny and its failure are as below). "Held" = the ask survives to a person:
535
535
  * neither an allow rule (`decisionReason: "hook"` is outside the allow layer) nor the classifier (hook asks are
536
536
  * never classifier-answerable) clears it.
537
537
  * · returns `allow` (± `updatedInput` / `additionalContext`) → the face's own word (`hookAllowedBy`, naming the registration); the policy
@@ -783,12 +783,14 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
783
783
  * the call fail-closed (the event's failure column), and so does a cancel; an observe handler never decides.
784
784
  */
785
785
  modBus?: Pick<import("./mods/kernel/index.js").ModBus, "hasHandlers" | "dispatch">;
786
- /** The inherited installations whose `tool.check` judges this leg's calls too (`inheritedToolChecks`, the rule's one home):
787
- * raised after {@link modBus}, each over the verdict the previous left standing, read by the one comparison — their `allow`
788
- * never clears an ask (a constraint only tightens), and their `ask` goes to each installation's own `settle` (where its
789
- * installation froze the question), never to this gate's resolver; an approval there that edits the call takes this gate's
790
- * approved-edit pass. Absent ⇒ only {@link modBus} is raised. */
791
- inheritedToolChecks?: readonly import("./mods/stations.js").InheritedToolCheck[];
786
+ /** The inherited installations that judge this leg's calls too (`inheritedInstallations`, the rule's one home), each on its
787
+ * own bus after {@link modBus}: `classic.PreToolUse` at phase 1 (and at every re-screen), with this leg's identity and the
788
+ * installation's environment; `tool.check` at the verdict read, each over the verdict the previous left standing. On both
789
+ * events their `deny` is the hook's own refusal, their `allow` never clears an ask (an installation answers only its own
790
+ * leg's questions; it is disclosed as the `hook` member's shadow), and their `ask` goes to each installation's own `settle`
791
+ * (where its installation froze the question), never to this gate's resolver; an approval there that edits the call takes
792
+ * this gate's approved-edit pass. Absent ⇒ only {@link modBus} is raised. */
793
+ inheritedInstallations?: readonly import("./mods/stations.js").InheritedInstallation[];
792
794
  /** The leg's observed permission mode, carried on every `classic.PreToolUse` e this gate call raises. Absent ⇒ the e
793
795
  * carries none (a host-driven gate with no leg seat). */
794
796
  observedPermissionMode?: () => PermissionMode;
@@ -1282,7 +1284,7 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
1282
1284
  };
1283
1285
  /**
1284
1286
  * F-012 L2 — the SANDBOX ADMISSION leg. Present ONLY when the runner armed the mode: the execution
1285
- * env DECLARES isolation (`RemoteExecutionEnv.capabilities.isolation === true` — a Runner-resolved
1287
+ * env DECLARES isolation (`capabilities.isolation === true`, read through `isIsolated` — a Runner-resolved
1286
1288
  * fact, never caller self-report) AND the park prerequisites hold (durable park configured + a wired
1287
1289
  * checkpoint store — every store carries the required `reopen`, read at its seat). Absent ⇒ the whole step does not
1288
1290
  * exist and the decision path is byte-identical to a build without it.
@@ -1320,52 +1322,33 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
1320
1322
  };
1321
1323
  }
1322
1324
  /**
1323
- * The PreToolUse screening face ({@link PreToolUseScreening}) for ONE call — `classic.PreToolUse` raised on the leg's
1324
- * bus, the per-screening e and the fail-closed sentences, built in ONE place for every site that screens a call: the
1325
- * gate's phase 1 and approved-edit re-screen (through {@link runToolGate}'s pass) and the resumed leg's re-screen of an
1326
- * approved call. Undefined when no handler hangs on the event.
1325
+ * The PreToolUse screening face ({@link PreToolUseScreening}) for ONE call — `classic.PreToolUse` raised on the leg's own
1326
+ * bus and then on each inherited installation's ({@link ToolGateInput.inheritedInstallations}), the per-screening e and the
1327
+ * fail-closed sentences, built in ONE place for every site that screens a call: the gate's phase 1, the fold's second look
1328
+ * and the approved-edit re-screens (through {@link runToolGate}'s pass) and the resumed leg's re-screen of an approved call.
1329
+ * Undefined when no handler hangs on the event on any of those buses.
1327
1330
  *
1328
1331
  * The e: `tool` (the call's wire name), `tool_use_id`, `input` — a deep-frozen copy of the args, so what a handler
1329
1332
  * judges is what runs (`input` is pinned; a rewrite is the answer's `updatedInput`) — `agentId` on a delegated leg,
1330
- * `cwd` (the task's tracked cwd, read per screening), `env` (the capability face), `identity`, `permissionMode`.
1331
- */
1332
- export declare function createPreToolUseScreening(input: Pick<ToolGateInput, "event" | "modBus" | "observedPermissionMode" | "trackedCwd" | "hookEnv" | "identity" | "abortSignal">): PreToolUseScreening | undefined;
1333
- /**
1334
- * Fold a leg's `classic.PreToolUse` chain into a {@link ToolPolicy} layer, so the screening a task installed can also
1335
- * travel down a delegation chain as one more inherited constraint — the constraint MINT. `chain` is the installing
1336
- * leg's bus; the policy raises `classic.PreToolUse` on it with the handlers that JUDGE (an observe handler never enters
1337
- * a constraint — the participant filter below is that rule's one home).
1338
- *
1339
- * Why a policy and not a second channel: a delegated child already folds each ancestor's caller policy
1340
- * (`InheritedGate.parentConstraints`), and that fold is where `deny > ask > allow`, the rewrite cascade, the
1341
- * ancestor-frozen approver and the durable mandate all already live. Expressing the screening in the same shape means
1342
- * the child gains no new decision channel — the existing fold consumes it — and the tighten-only property is
1343
- * structural rather than restated.
1344
- *
1345
- * The mapping mirrors the gate's own phase 1 decision for decision:
1346
- * - no opinion, and an `allow` → `allow`, contributing nothing (a constraint only tightens: it clears no question);
1347
- * - `deny` → `deny` in the fold's own words;
1348
- * - `ask` → `ask`, stamped `decisionReason:"hook"` (and the mandate, when the answer set it) so every consumer that
1349
- * distinguishes a screening ask from a policy ask reads the same fact one level down;
1350
- * - `allow`/`ask` with `updatedInput` → the same rewrite, which the fold cascades and re-checks;
1351
- * - a failed screening (a handler that threw, ran past its budget or broke the site's contract) or a cancel → the
1352
- * fail-closed deny, because a screening that cannot answer must not pass the call. The installing leg's bus
1353
- * already reported a crash or a timeout on that leg's error lane.
1354
- *
1355
- * **Idempotency** ({@link combinePolicies}): a layer's `check` may run more than once for a single tool call (the fold
1356
- * scans past an `ask`, a later rewrite re-runs the prefix, an approved edit is re-adjudicated), so a handler with a side
1357
- * effect sees that call more than once on those paths. Its own leg's phase 1 has always had the third of these.
1358
- *
1359
- * Not carried, and not reconstructible in this shape: `additionalContext` (a policy verdict has no channel for
1360
- * model-facing text — the context belongs to the run whose gate ran it), the leg identity and the tracked cwd (the
1361
- * fold's request carries neither, and the installing leg's would name the wrong run), and the phase-1 observer
1362
- * exclusion (a deny raised here is a fold deny: the descendant's deny observer sees it as `source:"policy"`). `env` is
1363
- * the capability face of the environment the chain was installed against, captured at the install site.
1333
+ * `cwd` (the task's tracked cwd, read per screening), `env` (the capability face), `identity`, `permissionMode`. On an
1334
+ * inherited installation the e is THIS leg's (its identity, its mode, its cwd — the call being judged) and the `env` is the
1335
+ * environment that installation was installed against; only its judging handlers take part.
1364
1336
  *
1365
- * The chain travels on the minted policy: a descendant's gate raises the installation's `tool.check` on it (a verdict read is
1366
- * not a fold layer). A host re-supplying the entry hands back the policy minted here, as it is.
1337
+ * Every installation is one judge of the call, under one answer reading: a failure or a cancel refuses the call
1338
+ * fail-closed, a `deny` refuses it as the hook's own refusal, a rewrite is adopted (an installation that judged the earlier
1339
+ * bytes judges the rewrite once — a verdict covers the bytes it was given; a deny or yet another form there refuses), the
1340
+ * context lines are collected. Its other words differ by WHOSE installation it is: the leg's own `ask` / `allow` is the
1341
+ * leg's (folded by the gate as before); an inherited installation's `ask` is settled under the regime it froze
1342
+ * (`InheritedInstallation.settle`, read through `readSettled` — the pass's ledger): refused ⇒ the call is refused,
1343
+ * approved ⇒ that question is answered, approved with an edit ⇒ the screen ends and the gate's approved-edit pass takes the
1344
+ * edit, floated ⇒ the question stands marked; its `allow` is no objection (an installation answers only its own leg's
1345
+ * questions), disclosed beside the leg's own hook member.
1367
1346
  */
1368
- export declare function createPreToolUseConstraintPolicy(chain: Pick<import("./mods/kernel/index.js").ModBus, "hasHandlers" | "dispatch">, env?: HookEnvCapabilities): ToolPolicy;
1347
+ export declare function createPreToolUseScreening(input: Pick<ToolGateInput, "event" | "modBus" | "inheritedInstallations" | "observedPermissionMode" | "trackedCwd" | "hookEnv" | "identity" | "abortSignal" | "callSignal">, readSettled?: (settled: PermissionResult) => {
1348
+ readonly decision: PermissionResult;
1349
+ readonly deniedBy?: DeniedBy;
1350
+ readonly cause?: ClassifierDenyCause;
1351
+ }): PreToolUseScreening | undefined;
1369
1352
  /**
1370
1353
  * The park closure's ONE structural seat — what the gate hands the durable park beyond the twelve
1371
1354
  * positional seats. Every member is optional and read by name, so a new thing the park must know
@@ -1,12 +1,12 @@
1
1
  import { argsAsTheToolReads, stampArgsReading } from "./effective-path-target.js";
2
- import { extensionAuthors, noteRewrite, screeningAuthorship } from "./rewrite-rejudge.js";
3
- import { abortedSeatDeny, decisionText, describeThrown, isEngineRefusal, ownArgs, ownedReading, refuseOutOfContractDecision, unaskedSeatAnswer } from "./tool-policy.js";
4
- import { createSettlementLedger, engineFailClosedExit, hookDenyExit, unownedArgsExit } from "./runner/gate-exit.js";
5
- import { classicEventBase, dispatchClassic, ENGINE_CORE_ANSWER, engineCore, failedHandlerClause, judgedInputOf, observePermissionDenied, withInstallation } from "./mods/stations.js";
2
+ import { extensionAuthors, noteRewrite, readRejudge, rewriteChasedSentence, screeningAuthorship } from "./rewrite-rejudge.js";
3
+ import { decisionText, describeThrown, foldHookAsk, isEngineRefusal, ownArgs, ownedReading, refuseOutOfContractDecision } from "./tool-policy.js";
4
+ import { createSettlementLedger, engineFailClosedExit, hookDenyExit, settledScreen, settledScreenExit, takeInheritedScreen, unownedArgsExit } from "./runner/gate-exit.js";
5
+ import { composeCallSignal } from "./runner/abort-race.js";
6
+ import { classicEventBase, dispatchClassic, ENGINE_CORE_ANSWER, failedHandlerClause, judgedInputOf, observePermissionDenied } from "./mods/stations.js";
6
7
  import { runGateFold } from "./gate-fold.js";
7
8
  import { runGateLanes } from "./gate-lanes.js";
8
9
  export { normalizeOrgGateVerdict, normalizePersistedRuleHit } from "./rule-lane-reads.js";
9
- import { brandPolicyAskClass } from "./ask-class.js";
10
10
  import { isAskOrigin, screenAskClassMembers } from "./ask-origin.js";
11
11
  import { isAutoModeFallbackCause } from "./auto-mode.js";
12
12
  import { inlineUntrusted } from "./untrusted-text.js";
@@ -111,13 +111,14 @@ function preToolUseRefusedReason(subject, failed) {
111
111
  : "";
112
112
  return `a PreToolUse hook ${failedHandlerClause(failed)} while screening ${subject}; the call was NOT executed (fail-closed).${tail}`;
113
113
  }
114
- export function createPreToolUseScreening(input) {
115
- const bus = input.modBus;
116
- if (bus === undefined || !bus.hasHandlers("classic.PreToolUse"))
114
+ export function createPreToolUseScreening(input, readSettled = (decision) => ({ decision })) {
115
+ const own = input.modBus !== undefined && input.modBus.hasHandlers("classic.PreToolUse") ? input.modBus : undefined;
116
+ const inherited = (input.inheritedInstallations ?? []).filter((i) => i.bus.hasHandlers("classic.PreToolUse", i.judges));
117
+ if (own === undefined && inherited.length === 0)
117
118
  return undefined;
118
119
  const { toolCallId, toolName } = input.event;
119
120
  const screenedName = wireOf("gate.preToolUse", input.event);
120
- const eventOf = (args) => {
121
+ const eventOf = (args, env) => {
121
122
  const cwd = input.trackedCwd?.();
122
123
  return {
123
124
  ...classicEventBase(input.identity, input.observedPermissionMode?.()),
@@ -125,77 +126,114 @@ export function createPreToolUseScreening(input) {
125
126
  tool_use_id: toolCallId,
126
127
  input: judgedInputOf(args),
127
128
  ...(typeof cwd === "string" ? { cwd } : {}),
128
- ...(input.hookEnv !== undefined ? { env: input.hookEnv } : {}),
129
+ ...(env !== undefined ? { env } : {}),
129
130
  };
130
131
  };
132
+ const raise = async (bus, participant, env, args, subject, readAs, signal) => {
133
+ let outcome;
134
+ const authorship = screeningAuthorship(readAs);
135
+ try {
136
+ outcome = await dispatchClassic(bus, "classic.PreToolUse", eventOf(args, env), { ...(signal !== undefined ? { signal } : {}), ...(participant !== undefined ? { participant } : {}), checkAnswer: (a, e, by, below) => preToolUseAnswerViolation(a) ?? authorship.record(a, e, by, below), ranks: PRE_TOOL_USE_RANKS });
137
+ }
138
+ catch (err) {
139
+ return { kind: "refused", reason: preToolUseRefusedReason(subject, { kind: "failed", registration: "engine", cause: "threw", reason: `could not raise the screening: ${describeThrown(err)}`, skipped: [] }) };
140
+ }
141
+ if (outcome === undefined || outcome.kind === "aborted")
142
+ return { kind: "refused", reason: preToolUseRefusedReason(subject, undefined) };
143
+ if (outcome.kind === "failed")
144
+ return { kind: "refused", reason: preToolUseRefusedReason(subject, outcome), extension: outcome.registration };
145
+ const r = screenPreToolUseResult(outcome.answer);
146
+ const answer = r === null || r === false ? undefined : r;
147
+ const rewrittenBy = authorship.of(outcome.answer);
148
+ return { kind: "answered", answer, ...(outcome.answeredBy !== undefined ? { answeredBy: outcome.answeredBy } : {}), rewrittenBy: answer?.updatedInput === undefined ? [] : rewrittenBy.length > 0 || outcome.answeredBy === undefined ? rewrittenBy : [outcome.answeredBy] };
149
+ };
150
+ const seats = [
151
+ ...(own !== undefined ? [{ look: ((args, subject, readAs, signal) => raise(own, undefined, input.hookEnv, args, subject, readAs, signal)) }] : []),
152
+ ...inherited.map((installation) => ({ installation, look: ((args, subject, readAs, signal) => raise(installation.bus, installation.judges, installation.env, args, subject, readAs, signal)) })),
153
+ ];
154
+ const deniedReason = (answer) => decisionText(answer) ?? `tool "${toolName}" blocked by a PreToolUse hook`;
131
155
  return {
132
156
  screen: async (args, subject, readAs) => {
133
- let outcome;
134
- const authorship = screeningAuthorship(readAs ?? {});
135
- try {
136
- outcome = await dispatchClassic(bus, "classic.PreToolUse", eventOf(args), { ...(input.abortSignal !== undefined ? { signal: input.abortSignal } : {}), checkAnswer: (a, e, by, below) => preToolUseAnswerViolation(a) ?? authorship.record(a, e, by, below), ranks: PRE_TOOL_USE_RANKS });
137
- }
138
- catch (err) {
139
- return { kind: "refused", reason: preToolUseRefusedReason(subject, { kind: "failed", registration: "engine", cause: "threw", reason: `could not raise the screening: ${describeThrown(err)}`, skipped: [] }) };
140
- }
141
- if (outcome === undefined || outcome.kind === "aborted")
142
- return { kind: "refused", reason: preToolUseRefusedReason(subject, undefined) };
143
- if (outcome.kind === "failed")
144
- return { kind: "refused", reason: preToolUseRefusedReason(subject, outcome), extension: outcome.registration };
145
- const r = screenPreToolUseResult(outcome.answer);
146
- const answer = r === null || r === false ? undefined : r;
147
- const rewrittenBy = authorship.of(outcome.answer);
148
- return { kind: "answered", answer, ...(outcome.answeredBy !== undefined ? { answeredBy: outcome.answeredBy } : {}), ...(answer?.updatedInput !== undefined ? { rewrittenBy: rewrittenBy.length > 0 || outcome.answeredBy === undefined ? rewrittenBy : [outcome.answeredBy] } : {}) };
149
- },
150
- deniedReason: (answer) => decisionText(answer) ?? `tool "${toolName}" blocked by a PreToolUse hook`,
151
- };
152
- }
153
- export function createPreToolUseConstraintPolicy(chain, env) {
154
- const judges = (p) => !p.observe;
155
- const minted = brandPolicyAskClass({
156
- check: async (req, signal) => {
157
- if (!chain.hasHandlers("classic.PreToolUse", judges))
158
- return { action: "allow" };
159
- const unasked = unaskedSeatAnswer(req, signal, { aborted: `the inherited PreToolUse screening of "${req.toolName}" was not consulted: the run or turn was already interrupted`, unreachable: `the inherited PreToolUse screening of "${req.toolName}" was not consulted: nobody can be asked about this call` }, "hook");
160
- if (unasked !== undefined)
161
- return unasked;
162
- const subject = `this call to "${req.toolName}"`;
163
- let outcome;
164
- try {
165
- outcome = await chain.dispatch("classic.PreToolUse", { tool: req.toolName, tool_use_id: req.toolCallId, input: judgedInputOf(req.args), ...(env !== undefined ? { env } : {}) }, {
166
- bottom: engineCore,
167
- participant: judges,
168
- ...(signal !== undefined ? { signal } : {}),
169
- checkAnswer: (a) => (a === ENGINE_CORE_ANSWER ? undefined : preToolUseAnswerViolation(a)),
170
- ranks: PRE_TOOL_USE_RANKS,
171
- });
172
- }
173
- catch (err) {
174
- return { action: "deny", message: preToolUseRefusedReason(subject, { kind: "failed", registration: "engine", cause: "threw", reason: `could not raise the screening: ${describeThrown(err)}`, skipped: [] }), decisionReason: "hook" };
175
- }
176
- if (outcome.kind === "aborted")
177
- return abortedSeatDeny(req, `the inherited PreToolUse screening of "${req.toolName}" ended when the run or turn was interrupted`, "hook");
178
- if (outcome.kind === "failed")
179
- return { action: "deny", message: preToolUseRefusedReason(subject, outcome), decisionReason: "hook" };
180
- const r = screenPreToolUseResult(outcome.answer);
181
- if (r === undefined || r === null || r === false)
182
- return { action: "allow" };
183
- if (r.action === "deny") {
184
- return { action: "deny", message: decisionText(r) ?? `tool "${req.toolName}" blocked by a PreToolUse hook`, decisionReason: "hook" };
185
- }
186
- if (r.action === "ask") {
157
+ const as = readAs ?? {};
158
+ const signal = input.abortSignal !== undefined ? composeCallSignal(input.abortSignal, input.callSignal) : input.callSignal;
159
+ let bytes = args;
160
+ let form;
161
+ const authors = [];
162
+ const contexts = [];
163
+ let ownAnswer;
164
+ let ownBy;
165
+ const allowedBy = new Map();
166
+ const floated = new Map();
167
+ const answered = (answer, answeredBy, approved) => {
168
+ const shown = form !== undefined && answer?.action !== "deny" ? { ...answer, updatedInput: form.raw } : answer;
169
+ const asks = [...floated.values()];
187
170
  return {
188
- action: "ask",
189
- message: decisionText(r) ?? `approval required for "${req.toolName}" (inherited PreToolUse hook)`,
190
- decisionReason: "hook",
191
- ...(r.requiresRealApproval === true ? { requiresRealApproval: true } : {}),
192
- ...(r.updatedInput !== undefined ? { updatedInput: r.updatedInput } : {}),
171
+ kind: "answered",
172
+ answer: shown,
173
+ ...(answeredBy !== undefined ? { answeredBy } : {}),
174
+ ...(form !== undefined && answer?.action !== "deny" ? { rewrittenBy: authors } : {}),
175
+ contexts,
176
+ ...(inherited.length > 0 ? { inherited: { allowedBy: [...allowedBy.values()], ...(asks.length > 0 ? { floated: asks.reduce((a, b) => foldHookAsk(a, b)) } : {}), ...(approved !== undefined ? { approved } : {}) } } : {}),
193
177
  };
178
+ };
179
+ const judgedOf = () => (bytes !== args ? { judged: bytes } : {});
180
+ const lookAt = async (i, second) => {
181
+ const seat = seats[i];
182
+ const r = await seat.look(bytes, subject, as, signal);
183
+ if (r.kind === "refused")
184
+ return { ...r, ...judgedOf() };
185
+ const a = r.answer;
186
+ if (a?.additionalContext)
187
+ contexts.push(a.additionalContext);
188
+ if (a?.action === "deny")
189
+ return { ...answered(a, r.answeredBy), ...judgedOf() };
190
+ const read = readRejudge(as, bytes, a);
191
+ if (second && read.kind === "rewritten")
192
+ return { kind: "refused", reason: rewriteChasedSentence(toolName), ...judgedOf() };
193
+ if (a?.updatedInput !== undefined) {
194
+ form = { raw: a.updatedInput };
195
+ authors.push(...r.rewrittenBy.filter((by) => !authors.includes(by)));
196
+ }
197
+ if (read.kind === "rewritten") {
198
+ bytes = read.form;
199
+ for (let j = 0; j < i; j++) {
200
+ const ended = await lookAt(j, true);
201
+ if (ended !== undefined)
202
+ return ended;
203
+ }
204
+ }
205
+ const verdict = a === undefined ? undefined : (({ updatedInput: _form, ...v }) => v)(a);
206
+ if (seat.installation === undefined) {
207
+ ownAnswer = verdict;
208
+ ownBy = r.answeredBy;
209
+ return undefined;
210
+ }
211
+ allowedBy.delete(i);
212
+ floated.delete(i);
213
+ if (verdict?.action === "allow" && r.answeredBy !== undefined)
214
+ allowedBy.set(i, r.answeredBy);
215
+ if (verdict?.action !== "ask")
216
+ return undefined;
217
+ const ask = { action: "ask", message: decisionText(verdict) ?? `approval required for "${toolName}" (an inherited PreToolUse hook)`, decisionReason: "hook", ...(verdict.requiresRealApproval === true ? { requiresRealApproval: true } : {}) };
218
+ const call = Object.freeze({ toolName, toolCallId, args: bytes, ...(as.face !== undefined ? { face: as.face } : {}) });
219
+ const settled = readSettled(await seat.installation.settle(ask, call, signal));
220
+ if (settled.decision.action === "deny")
221
+ return settledScreen(settled, judgedOf());
222
+ if (settled.decision.action === "allow" && settled.decision.updatedInput !== undefined)
223
+ return answered(ownAnswer, ownBy, { ...settled.decision, updatedInput: settled.decision.updatedInput });
224
+ if (settled.decision.action === "ask")
225
+ floated.set(i, settled.decision);
226
+ return undefined;
227
+ };
228
+ for (let i = 0; i < seats.length; i++) {
229
+ const ended = await lookAt(i, false);
230
+ if (ended !== undefined)
231
+ return ended;
194
232
  }
195
- return r.updatedInput !== undefined ? { action: "allow", updatedInput: r.updatedInput } : { action: "allow" };
233
+ return answered(ownAnswer, ownBy);
196
234
  },
197
- }, "hook");
198
- return withInstallation(minted, chain);
235
+ deniedReason,
236
+ };
199
237
  }
200
238
  export function askCarryRowMembers(carry) {
201
239
  if (carry === undefined)
@@ -224,7 +262,12 @@ export async function runToolGate(input) {
224
262
  const onHostObserverFailure = (err) => void notifier.notify(() => { throw err; }, "toolGate.permissionDenied");
225
263
  return observePermissionDenied({ legBus: input.modBus, hostObserver: input.permissionDenied, payload: seen, signal: input.abortSignal, onHostObserverFailure });
226
264
  };
227
- const screening = createPreToolUseScreening(input);
265
+ const ledger = createSettlementLedger({ toolCallId, toolName });
266
+ const screening = createPreToolUseScreening(input, (settled) => {
267
+ const read = ledger.fromDecision(settled);
268
+ const cause = ledger.causeOf(read.decision);
269
+ return { ...read, ...(cause !== undefined ? { cause } : {}) };
270
+ });
228
271
  const pass = {
229
272
  input,
230
273
  event,
@@ -235,7 +278,7 @@ export async function runToolGate(input) {
235
278
  toolCallId,
236
279
  callSignal,
237
280
  notifier,
238
- ledger: createSettlementLedger({ toolCallId, toolName }),
281
+ ledger,
239
282
  notifyPermissionDenied: notifyPermissionDeniedSeat,
240
283
  screening,
241
284
  afterFold: runGateLanes,
@@ -256,14 +299,16 @@ export async function runToolGate(input) {
256
299
  return await unownedArgsExit(pass, owned.reason);
257
300
  if (screening !== undefined) {
258
301
  const screened = await screening.screen(pass.currentInput, `this call to "${toolName}"`, pass.req);
302
+ if ((screened.kind !== "answered" || screened.answer?.action === "deny") && screened.judged !== undefined)
303
+ pass.currentInput = screened.judged;
259
304
  if (screened.kind === "refused") {
260
305
  return await engineFailClosedExit(pass, screened.reason, screened.extension);
261
306
  }
307
+ if (screened.kind === "settled")
308
+ return await settledScreenExit(pass, screened);
309
+ pass.preToolContext.push(...screened.contexts);
262
310
  const r = screened.answer;
263
311
  if (r) {
264
- if (r.additionalContext) {
265
- pass.preToolContext.push(r.additionalContext);
266
- }
267
312
  if (r.action === "deny") {
268
313
  return hookDenyExit(pass, screening.deniedReason(r), screened.answeredBy);
269
314
  }
@@ -278,6 +323,7 @@ export async function runToolGate(input) {
278
323
  if (r.action === "allow")
279
324
  pass.hookAllowedBy = screened.answeredBy !== undefined ? [screened.answeredBy] : [];
280
325
  }
326
+ takeInheritedScreen(pass, screened.inherited);
281
327
  }
282
328
  return await runGateFold(pass);
283
329
  }