@sema-agent/core 7.58.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 (519) hide show
  1. package/CHANGELOG.md +1340 -0
  2. package/README.md +6 -4
  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 +2 -1
  6. package/dist/agents/agent-transcript-tool.js +3 -1
  7. package/dist/agents/cc-peer-directory.js +8 -8
  8. package/dist/agents/child-model-seat.d.ts +4 -2
  9. package/dist/agents/child-model-seat.js +9 -4
  10. package/dist/agents/cumulative-stats.js +0 -1
  11. package/dist/agents/inherited-tool-pool.d.ts +26 -1
  12. package/dist/agents/inherited-tool-pool.js +22 -0
  13. package/dist/agents/peer-directory.d.ts +9 -0
  14. package/dist/agents/peer-directory.js +6 -2
  15. package/dist/agents/retain-ledger.d.ts +11 -1
  16. package/dist/agents/retain-ledger.js +13 -2
  17. package/dist/agents/roster-store.d.ts +1 -1
  18. package/dist/agents/roster-store.js +3 -1
  19. package/dist/agents/send-message-tool.d.ts +8 -19
  20. package/dist/agents/send-message-tool.js +32 -50
  21. package/dist/agents/subagent.d.ts +51 -17
  22. package/dist/agents/subagent.js +150 -112
  23. package/dist/agents/tool-filter.d.ts +1 -3
  24. package/dist/agents/tool-filter.js +4 -12
  25. package/dist/bench/metrics.d.ts +3 -5
  26. package/dist/bench/metrics.js +0 -1
  27. package/dist/brain/anthropic.js +161 -45
  28. package/dist/brain/degrading.js +3 -1
  29. package/dist/brain/errors.d.ts +9 -3
  30. package/dist/brain/errors.js +7 -1
  31. package/dist/brain/failover.js +2 -1
  32. package/dist/brain/open-responses.js +3 -3
  33. package/dist/brain/openai.js +103 -53
  34. package/dist/brain/provider-dialect.d.ts +11 -0
  35. package/dist/brain/provider-dialect.js +5 -2
  36. package/dist/brain/reasoning-request.js +5 -4
  37. package/dist/brain/reasoning.d.ts +19 -0
  38. package/dist/brain/reasoning.js +17 -2
  39. package/dist/brain/request-route.d.ts +4 -1
  40. package/dist/brain/request-route.js +4 -1
  41. package/dist/brain/route-adjudicator.d.ts +84 -18
  42. package/dist/brain/route-adjudicator.js +90 -22
  43. package/dist/brain/route-conformance.js +1 -1
  44. package/dist/brain/status-sink.d.ts +7 -1
  45. package/dist/brain/status-sink.js +6 -0
  46. package/dist/brain/stream-engine.js +84 -49
  47. package/dist/brain/stream-shared.d.ts +30 -0
  48. package/dist/brain/stream-shared.js +34 -1
  49. package/dist/brain/timeout.d.ts +65 -6
  50. package/dist/brain/timeout.js +111 -11
  51. package/dist/core/a2a.d.ts +15 -5
  52. package/dist/core/a2a.js +34 -19
  53. package/dist/core/account-row.d.ts +61 -0
  54. package/dist/core/account-row.js +51 -0
  55. package/dist/core/advisor-verdict.d.ts +2 -1
  56. package/dist/core/advisor-verdict.js +1 -1
  57. package/dist/core/agent-definition.d.ts +20 -0
  58. package/dist/core/allow-entry.d.ts +20 -6
  59. package/dist/core/allow-entry.js +17 -7
  60. package/dist/core/approval-object.d.ts +29 -15
  61. package/dist/core/approval-object.js +47 -19
  62. package/dist/core/artifact-host.d.ts +0 -2
  63. package/dist/core/artifact-host.js +0 -1
  64. package/dist/core/auto-compaction.js +1 -1
  65. package/dist/core/auto-mode-defaults.d.ts +8 -0
  66. package/dist/core/auto-mode-defaults.js +1 -0
  67. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  68. package/dist/core/auto-mode.d.ts +39 -4
  69. package/dist/core/auto-mode.js +63 -12
  70. package/dist/core/background-agent-store.d.ts +26 -4
  71. package/dist/core/background-agent-store.js +3 -2
  72. package/dist/core/background-shell.d.ts +12 -1
  73. package/dist/core/background-shell.js +12 -0
  74. package/dist/core/checkpoint-requirements.d.ts +13 -1
  75. package/dist/core/checkpoint-requirements.js +3 -1
  76. package/dist/core/checkpoint-store.d.ts +66 -25
  77. package/dist/core/checkpoint-store.js +22 -9
  78. package/dist/core/child-clamp-seats.d.ts +29 -0
  79. package/dist/core/child-clamp-seats.js +56 -1
  80. package/dist/core/compliance.d.ts +3 -3
  81. package/dist/core/compliance.js +1 -1
  82. package/dist/core/credential-echo.d.ts +52 -0
  83. package/dist/core/credential-echo.js +65 -0
  84. package/dist/core/credential-vocabulary.d.ts +13 -3
  85. package/dist/core/credential-vocabulary.js +12 -4
  86. package/dist/core/cross-boundary-taint.d.ts +4 -5
  87. package/dist/core/effective-path-target.d.ts +8 -2
  88. package/dist/core/effective-path-target.js +8 -3
  89. package/dist/core/engine-notice.d.ts +156 -23
  90. package/dist/core/engine-notice.js +19 -5
  91. package/dist/core/frame-settlement.d.ts +5 -0
  92. package/dist/core/frame-settlement.js +4 -0
  93. package/dist/core/gate-fold.js +8 -6
  94. package/dist/core/gate-lanes.js +47 -12
  95. package/dist/core/gate-outcome.d.ts +32 -3
  96. package/dist/core/gate-outcome.js +19 -1
  97. package/dist/core/governance-codes.d.ts +17 -1
  98. package/dist/core/governance-codes.js +25 -0
  99. package/dist/core/hands-band-screen.js +0 -1
  100. package/dist/core/hands-band.d.ts +0 -3
  101. package/dist/core/hooks.d.ts +70 -59
  102. package/dist/core/hooks.js +125 -80
  103. package/dist/core/image-admission.d.ts +106 -52
  104. package/dist/core/image-admission.js +184 -56
  105. package/dist/core/image-downsample.d.ts +36 -69
  106. package/dist/core/image-downsample.js +111 -73
  107. package/dist/core/integer-option.d.ts +21 -0
  108. package/dist/core/integer-option.js +13 -0
  109. package/dist/core/locked-config.d.ts +59 -5
  110. package/dist/core/locked-config.js +82 -50
  111. package/dist/core/mailbox-store.d.ts +45 -1
  112. package/dist/core/mailbox-store.js +53 -9
  113. package/dist/core/mcp-call-meta.d.ts +2 -2
  114. package/dist/core/mcp-call-meta.js +9 -10
  115. package/dist/core/mcp-failure.d.ts +122 -20
  116. package/dist/core/mcp-failure.js +73 -5
  117. package/dist/core/mcp-host-seat.d.ts +92 -0
  118. package/dist/core/mcp-host-seat.js +131 -0
  119. package/dist/core/mcp-probe.d.ts +7 -2
  120. package/dist/core/mcp-probe.js +7 -2
  121. package/dist/core/mcp-server-link.d.ts +22 -1
  122. package/dist/core/mcp-server-link.js +25 -1
  123. package/dist/core/mcp-server-spec.d.ts +38 -9
  124. package/dist/core/mcp-server-spec.js +55 -21
  125. package/dist/core/mcp.d.ts +27 -12
  126. package/dist/core/mcp.js +105 -76
  127. package/dist/core/memory-admission.d.ts +23 -6
  128. package/dist/core/memory-admission.js +19 -9
  129. package/dist/core/memory-engine/consolidation-driver.d.ts +2 -4
  130. package/dist/core/memory-engine/consolidation-driver.js +3 -3
  131. package/dist/core/memory-engine/consolidation.d.ts +4 -0
  132. package/dist/core/memory-engine/consolidation.js +1 -0
  133. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  134. package/dist/core/memory-engine/content-origin.js +21 -3
  135. package/dist/core/memory-engine/delegation-settlement.js +5 -12
  136. package/dist/core/memory-engine/distiller.js +2 -2
  137. package/dist/core/memory-engine/dual-root.d.ts +50 -1
  138. package/dist/core/memory-engine/dual-root.js +44 -1
  139. package/dist/core/memory-engine/engine.d.ts +67 -14
  140. package/dist/core/memory-engine/engine.js +384 -212
  141. package/dist/core/memory-engine/export-bundle.d.ts +23 -0
  142. package/dist/core/memory-engine/export-bundle.js +23 -4
  143. package/dist/core/memory-engine/file-backend.d.ts +128 -55
  144. package/dist/core/memory-engine/file-backend.js +290 -117
  145. package/dist/core/memory-engine/index.d.ts +3 -2
  146. package/dist/core/memory-engine/index.js +2 -1
  147. package/dist/core/memory-engine/layout.d.ts +59 -11
  148. package/dist/core/memory-engine/layout.js +190 -40
  149. package/dist/core/memory-engine/memory-backend-contract.d.ts +1 -1
  150. package/dist/core/memory-engine/memory-backend-contract.js +39 -2
  151. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  152. package/dist/core/memory-engine/scope-contract.js +2 -2
  153. package/dist/core/memory-engine/sync-client.d.ts +51 -9
  154. package/dist/core/memory-engine/sync-client.js +107 -13
  155. package/dist/core/memory-engine/sync-report.d.ts +103 -0
  156. package/dist/core/memory-engine/sync-report.js +119 -0
  157. package/dist/core/memory-engine/sync.d.ts +8 -1
  158. package/dist/core/memory-engine/types.d.ts +6 -0
  159. package/dist/core/mode-policy.d.ts +9 -1
  160. package/dist/core/mode-policy.js +11 -1
  161. package/dist/core/model-receipt.d.ts +39 -0
  162. package/dist/core/model-receipt.js +139 -0
  163. package/dist/core/mods/agent-stations.d.ts +65 -0
  164. package/dist/core/mods/agent-stations.js +105 -0
  165. package/dist/core/mods/classic-events.d.ts +5 -1
  166. package/dist/core/mods/kernel/dispatch.d.ts +5 -1
  167. package/dist/core/mods/kernel/dispatch.js +6 -5
  168. package/dist/core/mods/kernel/events.d.ts +11 -4
  169. package/dist/core/mods/kernel/events.js +11 -7
  170. package/dist/core/mods/kernel/receive.d.ts +5 -0
  171. package/dist/core/mods/kernel/receive.js +10 -0
  172. package/dist/core/mods/kernel/registration.d.ts +4 -0
  173. package/dist/core/mods/kernel/registration.js +3 -0
  174. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  175. package/dist/core/mods/lifecycle-stations.js +35 -0
  176. package/dist/core/mods/stations.d.ts +73 -60
  177. package/dist/core/mods/stations.js +64 -40
  178. package/dist/core/mods/tool-call.d.ts +10 -4
  179. package/dist/core/mods/tool-call.js +28 -12
  180. package/dist/core/mounted-mcp.d.ts +5 -0
  181. package/dist/core/mounted-mcp.js +2 -2
  182. package/dist/core/namespaced-rule-name.d.ts +7 -1
  183. package/dist/core/namespaced-rule-name.js +13 -2
  184. package/dist/core/oracle-isolation.js +1 -1
  185. package/dist/core/own-property-receipt.d.ts +3 -0
  186. package/dist/core/own-property-receipt.js +3 -0
  187. package/dist/core/parent-spec-seat.d.ts +8 -3
  188. package/dist/core/parent-spec-seat.js +2 -0
  189. package/dist/core/park-selfcheck.js +14 -8
  190. package/dist/core/peer-seat.d.ts +133 -16
  191. package/dist/core/peer-seat.js +319 -42
  192. package/dist/core/permission-rule-consent.d.ts +0 -21
  193. package/dist/core/permission-rule-consent.js +11 -6
  194. package/dist/core/permission-rule-model.d.ts +20 -2
  195. package/dist/core/permission-rule-model.js +8 -7
  196. package/dist/core/present-plan-tool.d.ts +11 -3
  197. package/dist/core/present-plan-tool.js +2 -2
  198. package/dist/core/protocol-http-auth.d.ts +14 -2
  199. package/dist/core/protocol-http-auth.js +16 -7
  200. package/dist/core/read-face-seats.d.ts +7 -5
  201. package/dist/core/read-face-seats.js +4 -1
  202. package/dist/core/redaction-marks.d.ts +4 -3
  203. package/dist/core/redaction-marks.js +2 -2
  204. package/dist/core/remote-env.d.ts +146 -98
  205. package/dist/core/remote-env.js +113 -14
  206. package/dist/core/resume-startup-cause.js +1 -0
  207. package/dist/core/retention.js +37 -12
  208. package/dist/core/retired-keys.d.ts +6 -1
  209. package/dist/core/retired-keys.js +4 -1
  210. package/dist/core/rewrite-rejudge.d.ts +13 -5
  211. package/dist/core/rewrite-rejudge.js +9 -5
  212. package/dist/core/roles.d.ts +69 -3
  213. package/dist/core/roles.js +167 -80
  214. package/dist/core/rule-owner.d.ts +3 -0
  215. package/dist/core/runner/announce-once-ledger.d.ts +5 -4
  216. package/dist/core/runner/announce-once-ledger.js +4 -2
  217. package/dist/core/runner/assemble-result.d.ts +0 -5
  218. package/dist/core/runner/assemble-result.js +0 -1
  219. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  220. package/dist/core/runner/call-hook-stations.js +23 -12
  221. package/dist/core/runner/child-tree.d.ts +7 -8
  222. package/dist/core/runner/child-tree.js +6 -6
  223. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  224. package/dist/core/runner/classifier-ladder.js +39 -8
  225. package/dist/core/runner/construction-doors.js +5 -0
  226. package/dist/core/runner/contracts.d.ts +82 -57
  227. package/dist/core/runner/credential-origin-seat.js +4 -3
  228. package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
  229. package/dist/core/runner/cross-boundary-lane.js +11 -2
  230. package/dist/core/runner/cwd-alignment-probe.d.ts +20 -0
  231. package/dist/core/runner/cwd-alignment-probe.js +21 -0
  232. package/dist/core/runner/decide-continuation.d.ts +2 -2
  233. package/dist/core/runner/env-capability-census.d.ts +15 -20
  234. package/dist/core/runner/env-capability-census.js +25 -34
  235. package/dist/core/runner/file-history-request.d.ts +2 -2
  236. package/dist/core/runner/file-history-request.js +0 -8
  237. package/dist/core/runner/gate-exit.d.ts +87 -11
  238. package/dist/core/runner/gate-exit.js +30 -8
  239. package/dist/core/runner/git-status-frame.d.ts +5 -2
  240. package/dist/core/runner/git-status-frame.js +3 -4
  241. package/dist/core/runner/image-removed-seat.d.ts +12 -0
  242. package/dist/core/runner/image-removed-seat.js +19 -0
  243. package/dist/core/runner/image.d.ts +7 -2
  244. package/dist/core/runner/image.js +14 -8
  245. package/dist/core/runner/inline-image.d.ts +10 -8
  246. package/dist/core/runner/inline-image.js +11 -9
  247. package/dist/core/runner/memory-consolidation-driver.js +5 -5
  248. package/dist/core/runner/park-commit.d.ts +1 -1
  249. package/dist/core/runner/park-commit.js +3 -0
  250. package/dist/core/runner/permission-rule-lanes.js +1 -1
  251. package/dist/core/runner/prepare-ask-lane.d.ts +1 -1
  252. package/dist/core/runner/prepare-ask-lane.js +2 -1
  253. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  254. package/dist/core/runner/prepare-boundary-parks.js +5 -5
  255. package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -5
  256. package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
  257. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  258. package/dist/core/runner/prepare-config-doors.js +16 -9
  259. package/dist/core/runner/prepare-context-lane.js +2 -0
  260. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -3
  261. package/dist/core/runner/prepare-delegation-surface.js +5 -4
  262. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  263. package/dist/core/runner/prepare-file-history.js +3 -12
  264. package/dist/core/runner/prepare-gate-stations.d.ts +4 -3
  265. package/dist/core/runner/prepare-gate-stations.js +4 -3
  266. package/dist/core/runner/prepare-hands-readface.d.ts +7 -1
  267. package/dist/core/runner/prepare-hands-readface.js +19 -6
  268. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -7
  269. package/dist/core/runner/prepare-inherited-gate.js +22 -31
  270. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  271. package/dist/core/runner/prepare-memory.d.ts +2 -2
  272. package/dist/core/runner/prepare-memory.js +12 -19
  273. package/dist/core/runner/prepare-park-ask.d.ts +4 -6
  274. package/dist/core/runner/prepare-park-ask.js +5 -9
  275. package/dist/core/runner/prepare-policy-chain.d.ts +8 -7
  276. package/dist/core/runner/prepare-policy-chain.js +136 -121
  277. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  278. package/dist/core/runner/prepare-project-context.js +10 -7
  279. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -2
  280. package/dist/core/runner/prepare-prompt-inputs.js +10 -20
  281. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  282. package/dist/core/runner/prepare-protocol-tools.js +17 -2
  283. package/dist/core/runner/prepare-run-refs.d.ts +2 -3
  284. package/dist/core/runner/prepare-run-refs.js +4 -1
  285. package/dist/core/runner/prepare-suspend-saga.d.ts +0 -2
  286. package/dist/core/runner/prepare-suspend-saga.js +5 -7
  287. package/dist/core/runner/prepare-task.js +44 -28
  288. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  289. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  290. package/dist/core/runner/prepare-wiring-manifest.d.ts +5 -4
  291. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  292. package/dist/core/runner/prepare-workspace-restore.js +3 -3
  293. package/dist/core/runner/reply-pricing.d.ts +30 -0
  294. package/dist/core/runner/reply-pricing.js +19 -0
  295. package/dist/core/runner/resume-admission.js +4 -2
  296. package/dist/core/runner/resume-apply.js +6 -1
  297. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  298. package/dist/core/runner/resume-policy-outcome.js +5 -5
  299. package/dist/core/runner/retired-runner-deps.js +4 -1
  300. package/dist/core/runner/role-seat-defaulted.d.ts +44 -0
  301. package/dist/core/runner/role-seat-defaulted.js +40 -0
  302. package/dist/core/runner/run-attachment-seats.js +3 -3
  303. package/dist/core/runner/run-brain-sinks.js +3 -0
  304. package/dist/core/runner/run-git-lane.d.ts +3 -1
  305. package/dist/core/runner/run-git-lane.js +1 -1
  306. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  307. package/dist/core/runner/run-harness-handlers.js +3 -1
  308. package/dist/core/runner/run-identity-wiring.d.ts +2 -5
  309. package/dist/core/runner/run-identity-wiring.js +6 -5
  310. package/dist/core/runner/run-leg.d.ts +2 -0
  311. package/dist/core/runner/run-leg.js +63 -56
  312. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  313. package/dist/core/runner/run-notification-lane.js +16 -10
  314. package/dist/core/runner/run-settle-and-teardown.js +5 -1
  315. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  316. package/dist/core/runner/run-stop-and-final-verify.js +14 -6
  317. package/dist/core/runner/run-terminal-adoption.d.ts +2 -5
  318. package/dist/core/runner/run-terminal-adoption.js +9 -3
  319. package/dist/core/runner/run-turn-boundary.js +89 -77
  320. package/dist/core/runner/runtask.d.ts +8 -5
  321. package/dist/core/runner/runtask.js +21 -13
  322. package/dist/core/runner/side-call-account.d.ts +1 -1
  323. package/dist/core/runner/side-call-account.js +3 -18
  324. package/dist/core/runner/skills-seat.js +2 -2
  325. package/dist/core/runner/sub-agent-deny-lists.d.ts +24 -0
  326. package/dist/core/runner/sub-agent-deny-lists.js +20 -7
  327. package/dist/core/runner/synthetic-tools.js +2 -2
  328. package/dist/core/runner/tool-disclosure.js +0 -2
  329. package/dist/core/runner/tool-end-body.js +2 -2
  330. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  331. package/dist/core/runner/tool-face-overlay.js +26 -19
  332. package/dist/core/runner/tool-occurrence.d.ts +1 -1
  333. package/dist/core/runner/tool-occurrence.js +2 -2
  334. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  335. package/dist/core/runner/tool-result-media-seat.js +17 -1
  336. package/dist/core/runner/turn-attachments.d.ts +29 -27
  337. package/dist/core/runner/turn-attachments.js +27 -42
  338. package/dist/core/runner-deps.d.ts +32 -19
  339. package/dist/core/secret-env.d.ts +35 -4
  340. package/dist/core/secret-env.js +65 -3
  341. package/dist/core/sensitive-path-policy.js +3 -3
  342. package/dist/core/session-policy-store.d.ts +12 -3
  343. package/dist/core/session-policy-store.js +29 -10
  344. package/dist/core/session-store.d.ts +5 -7
  345. package/dist/core/session-store.js +50 -11
  346. package/dist/core/side-query.d.ts +11 -1
  347. package/dist/core/side-query.js +9 -0
  348. package/dist/core/skill-grant-binding.d.ts +31 -2
  349. package/dist/core/skill-grant-binding.js +31 -1
  350. package/dist/core/skill-grant.d.ts +17 -5
  351. package/dist/core/skill-grant.js +24 -6
  352. package/dist/core/store-contracts/background-agent-store-contract.js +27 -0
  353. package/dist/core/store-contracts/checkpoint-store-contract.js +3 -2
  354. package/dist/core/store-contracts/mailbox-store-contract.js +31 -1
  355. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  356. package/dist/core/store-contracts/tool-result-store-contract.js +37 -0
  357. package/dist/core/stub-env.d.ts +5 -5
  358. package/dist/core/stub-env.js +11 -1
  359. package/dist/core/swappable-deps.d.ts +17 -43
  360. package/dist/core/swappable-deps.js +15 -5
  361. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  362. package/dist/core/synthetic-read-verdict.js +2 -1
  363. package/dist/core/task-event.d.ts +50 -10
  364. package/dist/core/task-notification.d.ts +88 -5
  365. package/dist/core/task-notification.js +146 -17
  366. package/dist/core/task-registry-agent.d.ts +18 -12
  367. package/dist/core/task-registry-agent.js +19 -6
  368. package/dist/core/task-registry-monitor.d.ts +7 -0
  369. package/dist/core/task-registry-monitor.js +28 -1
  370. package/dist/core/task-registry-shared.d.ts +43 -3
  371. package/dist/core/task-registry-shared.js +21 -7
  372. package/dist/core/task-registry-workflow.js +1 -1
  373. package/dist/core/task-registry.d.ts +50 -35
  374. package/dist/core/task-registry.js +64 -23
  375. package/dist/core/task-result.d.ts +3 -12
  376. package/dist/core/task-spec.d.ts +15 -7
  377. package/dist/core/task-stream.d.ts +1 -1
  378. package/dist/core/terminal-cause.d.ts +10 -0
  379. package/dist/core/tool-catalog-entries.js +1 -1
  380. package/dist/core/tool-check-reading.d.ts +1 -0
  381. package/dist/core/tool-check-reading.js +3 -3
  382. package/dist/core/tool-face-reader.d.ts +7 -6
  383. package/dist/core/tool-face-reader.js +4 -3
  384. package/dist/core/tool-name-aliases.d.ts +19 -0
  385. package/dist/core/tool-name-aliases.js +54 -2
  386. package/dist/core/tool-policy.d.ts +21 -4
  387. package/dist/core/tool-policy.js +1 -1
  388. package/dist/core/tool-registry.d.ts +5 -5
  389. package/dist/core/tool-registry.js +2 -2
  390. package/dist/core/tool-result-store.d.ts +88 -5
  391. package/dist/core/tool-result-store.js +51 -12
  392. package/dist/core/tool-roster.d.ts +112 -5
  393. package/dist/core/tool-roster.js +42 -1
  394. package/dist/core/tool-spec.d.ts +23 -5
  395. package/dist/core/trace.d.ts +0 -1
  396. package/dist/core/types.d.ts +5 -5
  397. package/dist/core/types.js +2 -2
  398. package/dist/core/untrusted-text.js +1 -1
  399. package/dist/core/user-attachment.d.ts +10 -5
  400. package/dist/core/user-attachment.js +15 -7
  401. package/dist/core/wiring-manifest.d.ts +6 -3
  402. package/dist/engine/compaction/compaction.js +29 -3
  403. package/dist/engine/execution-env/node-execution-env.d.ts +11 -5
  404. package/dist/engine/execution-env/node-execution-env.js +21 -13
  405. package/dist/engine/harness/agent-harness.d.ts +26 -3
  406. package/dist/engine/harness/agent-harness.js +49 -16
  407. package/dist/engine/harness/messages.d.ts +3 -1
  408. package/dist/engine/harness/messages.js +3 -2
  409. package/dist/engine/harness/types.d.ts +119 -28
  410. package/dist/engine/llm/rejected-images.d.ts +46 -0
  411. package/dist/engine/llm/rejected-images.js +54 -0
  412. package/dist/engine/llm/tool-turns.d.ts +2 -1
  413. package/dist/engine/llm/types.d.ts +18 -7
  414. package/dist/engine/loop/agent-loop.d.ts +20 -12
  415. package/dist/engine/loop/agent-loop.js +205 -36
  416. package/dist/engine/loop/types.d.ts +12 -3
  417. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  418. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  419. package/dist/engine/session/path-to-root.d.ts +38 -0
  420. package/dist/engine/session/path-to-root.js +39 -0
  421. package/dist/engine/session/storage-base.js +4 -21
  422. package/dist/index.d.ts +35 -21
  423. package/dist/index.js +26 -17
  424. package/dist/internal/harness-types.d.ts +1 -1
  425. package/dist/internal/harness.d.ts +1 -0
  426. package/dist/internal/llm.d.ts +1 -0
  427. package/dist/orchestration/run-workflow-tool.d.ts +9 -3
  428. package/dist/orchestration/run-workflow-tool.js +59 -29
  429. package/dist/orchestration/workflow-governance.d.ts +1 -1
  430. package/dist/orchestration/workflow-governance.js +2 -1
  431. package/dist/orchestration/workflow-observe.d.ts +17 -1
  432. package/dist/orchestration/workflow-observe.js +20 -0
  433. package/dist/orchestration/workflow-types.d.ts +32 -7
  434. package/dist/orchestration/workflow.d.ts +4 -0
  435. package/dist/orchestration/workflow.js +762 -491
  436. package/dist/prompts/default.d.ts +1 -10
  437. package/dist/prompts/default.js +0 -2
  438. package/dist/shell/counting-pass.d.ts +50 -0
  439. package/dist/shell/counting-pass.js +502 -0
  440. package/dist/shell/lex.d.ts +4 -2
  441. package/dist/shell/lex.js +93 -34
  442. package/dist/shell/shell-words.d.ts +1 -1
  443. package/dist/shell/shell-words.js +7 -6
  444. package/dist/stores/file/background-agent-store.d.ts +1 -1
  445. package/dist/stores/file/background-agent-store.js +3 -1
  446. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  447. package/dist/stores/file/checkpoint-store.js +19 -14
  448. package/dist/stores/file/file-history-store.d.ts +1 -1
  449. package/dist/stores/file/file-history-store.js +3 -1
  450. package/dist/stores/file/index.d.ts +4 -3
  451. package/dist/stores/file/index.js +17 -8
  452. package/dist/stores/file/mailbox-store.d.ts +1 -1
  453. package/dist/stores/file/mailbox-store.js +9 -11
  454. package/dist/stores/file/memory-store.d.ts +1 -1
  455. package/dist/stores/file/memory-store.js +3 -1
  456. package/dist/stores/file/session-policy-store.d.ts +1 -1
  457. package/dist/stores/file/session-policy-store.js +3 -1
  458. package/dist/stores/file/session-store.d.ts +1 -1
  459. package/dist/stores/file/session-store.js +3 -1
  460. package/dist/stores/file/shared-ledger.d.ts +26 -0
  461. package/dist/stores/file/shared-ledger.js +38 -9
  462. package/dist/stores/file/tool-result-store.d.ts +20 -2
  463. package/dist/stores/file/tool-result-store.js +74 -6
  464. package/dist/stores/file/usage-window-store.d.ts +1 -1
  465. package/dist/stores/file/usage-window-store.js +3 -1
  466. package/dist/stores/file/workflow-journal-store.d.ts +1 -11
  467. package/dist/stores/file/workflow-journal-store.js +3 -2
  468. package/dist/tools/fs/containment-face.d.ts +5 -0
  469. package/dist/tools/fs/encoding.d.ts +13 -4
  470. package/dist/tools/fs/encoding.js +17 -2
  471. package/dist/tools/fs/fs-bash-background-text.d.ts +7 -0
  472. package/dist/tools/fs/fs-bash-background-text.js +1 -0
  473. package/dist/tools/fs/fs-bash.d.ts +14 -4
  474. package/dist/tools/fs/fs-bash.js +29 -35
  475. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  476. package/dist/tools/fs/fs-pdf.js +26 -21
  477. package/dist/tools/fs/fs-read.d.ts +5 -4
  478. package/dist/tools/fs/fs-read.js +35 -18
  479. package/dist/tools/fs/fs-search-tools.js +4 -1
  480. package/dist/tools/fs/fs-shared.d.ts +11 -13
  481. package/dist/tools/fs/fs-shared.js +11 -7
  482. package/dist/tools/fs/fs-write.js +5 -5
  483. package/dist/tools/fs/index.d.ts +14 -8
  484. package/dist/tools/fs/index.js +13 -5
  485. package/dist/tools/fs/program-read-model.d.ts +13 -0
  486. package/dist/tools/fs/program-read-model.js +15 -0
  487. package/dist/tools/fs/program-read-model.rows.js +1 -1
  488. package/dist/tools/fs/read-deny.d.ts +13 -10
  489. package/dist/tools/fs/read-deny.js +25 -5
  490. package/dist/tools/fs/read-floor.d.ts +62 -0
  491. package/dist/tools/fs/read-floor.js +58 -0
  492. package/dist/tools/fs/removal-targets.d.ts +9 -4
  493. package/dist/tools/fs/removal-targets.js +17 -9
  494. package/dist/tools/fs/search.d.ts +3 -3
  495. package/dist/tools/fs/search.js +4 -4
  496. package/dist/tools/fs/shell-read-check.d.ts +1 -1
  497. package/dist/tools/fs/shell-read-check.js +2 -1
  498. package/dist/tools/fs/shell-read-judge.d.ts +16 -8
  499. package/dist/tools/fs/shell-read-judge.js +10 -6
  500. package/dist/tools/fs/shell-read-plan.d.ts +6 -1
  501. package/dist/tools/fs/shell-read-plan.js +22 -15
  502. package/dist/tools/fs/shell-read-start.js +1 -0
  503. package/dist/tools/fs/shell-reentry-text.d.ts +15 -1
  504. package/dist/tools/fs/shell-reentry-text.js +25 -3
  505. package/dist/tools/monitor.d.ts +9 -4
  506. package/dist/tools/monitor.js +17 -8
  507. package/dist/tools/scheduler-tools.js +42 -4
  508. package/dist/tools/web.d.ts +0 -10
  509. package/dist/tools/web.js +1 -4
  510. package/package.json +5 -2
  511. package/test/export-surface.snapshot.json +161 -21
  512. package/wire-changes/core-stores-sql@7.59.0.json +29 -0
  513. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  514. package/wire-changes/core@7.59.0.json +2459 -0
  515. package/wire-changes/core@7.60.0.json +3274 -0
  516. package/wire-changes/mods-kernel@7.59.0.json +29 -0
  517. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  518. package/wire-changes/primitives@7.59.0.json +29 -0
  519. 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";
@@ -100,8 +100,11 @@ export interface PostToolBatchEvent extends ClassicEventBase {
100
100
  readonly injectedThisTurn?: "final_verification" | "finalize";
101
101
  }
102
102
  /**
103
- * `classic.UserPromptSubmit`'s `e` — EVERY user-lane entrance: the objective, a live steer, a wake resume's message
104
- * (pre-claim, at the verb) and a parked steer's redelivery, discriminated by {@link source}. Pinned: `source`,
103
+ * `classic.UserPromptSubmit`'s `e` — EVERY user-lane entrance: a top-level leg's objective, a live steer, a wake resume's
104
+ * message (pre-claim, at the verb) and a parked steer's redelivery, discriminated by {@link source}. A delegated child's
105
+ * objective is one only when it carries an operator's words (a retained child resumed through its steer handle);
106
+ * otherwise its delegator wrote it, the screen that can refuse it is the delegator's `classic.PreToolUse` on the call that
107
+ * delegates (its `input.prompt`), and the child opens on `classic.SubagentStart` ({@link SubagentStartEvent}). Pinned: `source`,
105
108
  * `inputId`, `actor`. A handler that blocks unconditionally therefore refuses steers too — branch on `source` (and
106
109
  * `actor`). Answer: {@link UserPromptSubmitResult}. Block per entrance: objective ⇒ the task ends `blocked`; live steer
107
110
  * ⇒ typed `steering.blocked_by_hook`; resume message ⇒ typed pre-claim refusal (the checkpoint stays pending); parked
@@ -114,7 +117,7 @@ export interface UserPromptSubmitEvent extends ClassicEventBase {
114
117
  /** The caller's text, raw. */
115
118
  readonly prompt: string;
116
119
  /**
117
- * WHICH entrance: `"objective"` (the task's opening prompt), `"steer"` (a live mid-run steer), `"resume_message"`
120
+ * WHICH entrance: `"objective"` (a top-level task's opening prompt), `"steer"` (a live mid-run steer), `"resume_message"`
118
121
  * (a wake resume's message, screened pre-claim), `"parked_redelivery"` (a parked steer re-screened on the CURRENT
119
122
  * process when any resume kind that drains parked steers redelivers it). ⚠️ DOUBLE ARRIVAL IS CONTRACTUAL: one input
120
123
  * can arrive twice (screened live as `"steer"`, parked, re-screened as `"parked_redelivery"`) — idempotency is the
@@ -140,6 +143,31 @@ export interface UserPromptSubmitEvent extends ClassicEventBase {
140
143
  */
141
144
  readonly userAttachments?: readonly import("./user-attachment.js").UserAttachmentDeclaration[];
142
145
  }
146
+ /**
147
+ * `classic.SubagentStart`'s `e` — raised on a delegated child's own leg when it opens on its objective (a first spawn,
148
+ * a revival, a retained child's next prompt; every lane — synchronous, background, fork, workflow), before its first
149
+ * request; never on a top-level leg and never on a checkpoint resume (that continues a turn it already opened). The
150
+ * child's prompt is not here: its parent's model wrote it, and the parent's `classic.PreToolUse` on the delegating call
151
+ * is where it is judged. Pinned: `agentId`, `agentType`. Context only — it NEVER keeps a subagent from starting: a
152
+ * handler that fails (throws, overruns its budget, answers what the station cannot take) is skipped and reported.
153
+ * Answer: {@link SubagentStartResult}.
154
+ */
155
+ export interface SubagentStartEvent extends ClassicEventBase {
156
+ /** The child's id (its task id) — always present on this event. */
157
+ readonly agentId: string;
158
+ /** The resolved subagent type the child was spawned as ({@link HookInvocationIdentity.agentType}; the word a handler
159
+ * matches on). Absent when the spawner threaded none (a workflow-lane agent). */
160
+ readonly agentType?: string;
161
+ }
162
+ /**
163
+ * What a `classic.SubagentStart` handler answers. There is no refusal member: an answer carrying `block` is one the
164
+ * station cannot take (the handler is skipped and reported, the child starts) — a deployment that must keep a child from
165
+ * starting denies the delegating call at `classic.PreToolUse`.
166
+ */
167
+ export interface SubagentStartResult {
168
+ /** Delivered ahead of the child's prompt in its first request (wrapped as a `<system-reminder>`). */
169
+ additionalContext?: string;
170
+ }
143
171
  /**
144
172
  * `classic.Stop`'s `e` — raised when the agent WOULD OTHERWISE END its run (no more tool calls, steering and follow-up
145
173
  * queues dry). Answer: {@link StopHookResult}; `{ block }` pushes back (the reason is injected and the run continues one
@@ -410,9 +438,8 @@ export declare function createHookEnvCapabilities(env: ExecutionEnv): HookEnvCap
410
438
  * ({@link mintHookInvocationIdentity} — single mint home) and every station reuses it.
411
439
  * · HONESTLY ABSENT (no fabrication) where the engine structurally cannot know:
412
440
  * 1. a HOST driving the exported {@link runToolGate} directly without supplying `ToolGateInput.identity`;
413
- * 2. an ancestor's chain riding a DESCENDANT's constraint fold ({@link createPreToolUseConstraintPolicy}) — the
414
- * fold's request carries no leg identity, and stamping the INSTALL-site leg would name the wrong run;
415
- * 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.)
416
443
  *
417
444
  * CONSUMER NOTE — the minted object is FROZEN and carries a NULL PROTOTYPE (same rule and same
418
445
  * trade as {@link HookEnvCapabilities}: absence must be a fact about this object, not about what
@@ -502,8 +529,9 @@ export interface HookToolOutput {
502
529
  * whole hook result; the concurrent arm never carried it, so the two arms disagreed on a member neither
503
530
  * of them reads. Nothing in the engine reads it off a decision.
504
531
  *
505
- * PreToolUse lane × settlement table (the gate's phase 1 in {@link runToolGate}; the delegated twin in
506
- * {@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:
507
535
  * neither an allow rule (`decisionReason: "hook"` is outside the allow layer) nor the classifier (hook asks are
508
536
  * never classifier-answerable) clears it.
509
537
  * · returns `allow` (± `updatedInput` / `additionalContext`) → the face's own word (`hookAllowedBy`, naming the registration); the policy
@@ -755,12 +783,14 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
755
783
  * the call fail-closed (the event's failure column), and so does a cancel; an observe handler never decides.
756
784
  */
757
785
  modBus?: Pick<import("./mods/kernel/index.js").ModBus, "hasHandlers" | "dispatch">;
758
- /** The inherited installations whose `tool.check` judges this leg's calls too (`inheritedToolChecks`, the rule's one home):
759
- * raised after {@link modBus}, each over the verdict the previous left standing, read by the one comparison — their `allow`
760
- * never clears an ask (a constraint only tightens), and their `ask` goes to each installation's own `settle` (where its
761
- * installation froze the question), never to this gate's resolver; an approval there that edits the call takes this gate's
762
- * approved-edit pass. Absent ⇒ only {@link modBus} is raised. */
763
- 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[];
764
794
  /** The leg's observed permission mode, carried on every `classic.PreToolUse` e this gate call raises. Absent ⇒ the e
765
795
  * carries none (a host-driven gate with no leg seat). */
766
796
  observedPermissionMode?: () => PermissionMode;
@@ -1254,7 +1284,7 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
1254
1284
  };
1255
1285
  /**
1256
1286
  * F-012 L2 — the SANDBOX ADMISSION leg. Present ONLY when the runner armed the mode: the execution
1257
- * env DECLARES isolation (`RemoteExecutionEnv.capabilities.isolation === true` — a Runner-resolved
1287
+ * env DECLARES isolation (`capabilities.isolation === true`, read through `isIsolated` — a Runner-resolved
1258
1288
  * fact, never caller self-report) AND the park prerequisites hold (durable park configured + a wired
1259
1289
  * checkpoint store — every store carries the required `reopen`, read at its seat). Absent ⇒ the whole step does not
1260
1290
  * exist and the decision path is byte-identical to a build without it.
@@ -1292,52 +1322,33 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
1292
1322
  };
1293
1323
  }
1294
1324
  /**
1295
- * The PreToolUse screening face ({@link PreToolUseScreening}) for ONE call — `classic.PreToolUse` raised on the leg's
1296
- * bus, the per-screening e and the fail-closed sentences, built in ONE place for every site that screens a call: the
1297
- * gate's phase 1 and approved-edit re-screen (through {@link runToolGate}'s pass) and the resumed leg's re-screen of an
1298
- * 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.
1299
1330
  *
1300
1331
  * The e: `tool` (the call's wire name), `tool_use_id`, `input` — a deep-frozen copy of the args, so what a handler
1301
1332
  * judges is what runs (`input` is pinned; a rewrite is the answer's `updatedInput`) — `agentId` on a delegated leg,
1302
- * `cwd` (the task's tracked cwd, read per screening), `env` (the capability face), `identity`, `permissionMode`.
1303
- */
1304
- export declare function createPreToolUseScreening(input: Pick<ToolGateInput, "event" | "modBus" | "observedPermissionMode" | "trackedCwd" | "hookEnv" | "identity" | "abortSignal">): PreToolUseScreening | undefined;
1305
- /**
1306
- * Fold a leg's `classic.PreToolUse` chain into a {@link ToolPolicy} layer, so the screening a task installed can also
1307
- * travel down a delegation chain as one more inherited constraint — the constraint MINT. `chain` is the installing
1308
- * leg's bus; the policy raises `classic.PreToolUse` on it with the handlers that JUDGE (an observe handler never enters
1309
- * a constraint — the participant filter below is that rule's one home).
1310
- *
1311
- * Why a policy and not a second channel: a delegated child already folds each ancestor's caller policy
1312
- * (`InheritedGate.parentConstraints`), and that fold is where `deny > ask > allow`, the rewrite cascade, the
1313
- * ancestor-frozen approver and the durable mandate all already live. Expressing the screening in the same shape means
1314
- * the child gains no new decision channel — the existing fold consumes it — and the tighten-only property is
1315
- * structural rather than restated.
1316
- *
1317
- * The mapping mirrors the gate's own phase 1 decision for decision:
1318
- * - no opinion, and an `allow` → `allow`, contributing nothing (a constraint only tightens: it clears no question);
1319
- * - `deny` → `deny` in the fold's own words;
1320
- * - `ask` → `ask`, stamped `decisionReason:"hook"` (and the mandate, when the answer set it) so every consumer that
1321
- * distinguishes a screening ask from a policy ask reads the same fact one level down;
1322
- * - `allow`/`ask` with `updatedInput` → the same rewrite, which the fold cascades and re-checks;
1323
- * - a failed screening (a handler that threw, ran past its budget or broke the site's contract) or a cancel → the
1324
- * fail-closed deny, because a screening that cannot answer must not pass the call. The installing leg's bus
1325
- * already reported a crash or a timeout on that leg's error lane.
1326
- *
1327
- * **Idempotency** ({@link combinePolicies}): a layer's `check` may run more than once for a single tool call (the fold
1328
- * scans past an `ask`, a later rewrite re-runs the prefix, an approved edit is re-adjudicated), so a handler with a side
1329
- * effect sees that call more than once on those paths. Its own leg's phase 1 has always had the third of these.
1330
- *
1331
- * Not carried, and not reconstructible in this shape: `additionalContext` (a policy verdict has no channel for
1332
- * model-facing text — the context belongs to the run whose gate ran it), the leg identity and the tracked cwd (the
1333
- * fold's request carries neither, and the installing leg's would name the wrong run), and the phase-1 observer
1334
- * exclusion (a deny raised here is a fold deny: the descendant's deny observer sees it as `source:"policy"`). `env` is
1335
- * 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.
1336
1336
  *
1337
- * The chain travels on the minted policy: a descendant's gate raises the installation's `tool.check` on it (a verdict read is
1338
- * 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.
1339
1346
  */
1340
- 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;
1341
1352
  /**
1342
1353
  * The park closure's ONE structural seat — what the gate hands the durable park beyond the twelve
1343
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, recordScreeningChain } 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,78 +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) };
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
- recordScreeningChain(minted, chain);
199
- return minted;
235
+ deniedReason,
236
+ };
200
237
  }
201
238
  export function askCarryRowMembers(carry) {
202
239
  if (carry === undefined)
@@ -225,7 +262,12 @@ export async function runToolGate(input) {
225
262
  const onHostObserverFailure = (err) => void notifier.notify(() => { throw err; }, "toolGate.permissionDenied");
226
263
  return observePermissionDenied({ legBus: input.modBus, hostObserver: input.permissionDenied, payload: seen, signal: input.abortSignal, onHostObserverFailure });
227
264
  };
228
- 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
+ });
229
271
  const pass = {
230
272
  input,
231
273
  event,
@@ -236,7 +278,7 @@ export async function runToolGate(input) {
236
278
  toolCallId,
237
279
  callSignal,
238
280
  notifier,
239
- ledger: createSettlementLedger({ toolCallId, toolName }),
281
+ ledger,
240
282
  notifyPermissionDenied: notifyPermissionDeniedSeat,
241
283
  screening,
242
284
  afterFold: runGateLanes,
@@ -257,16 +299,18 @@ export async function runToolGate(input) {
257
299
  return await unownedArgsExit(pass, owned.reason);
258
300
  if (screening !== undefined) {
259
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;
260
304
  if (screened.kind === "refused") {
261
- return await engineFailClosedExit(pass, screened.reason);
305
+ return await engineFailClosedExit(pass, screened.reason, screened.extension);
262
306
  }
307
+ if (screened.kind === "settled")
308
+ return await settledScreenExit(pass, screened);
309
+ pass.preToolContext.push(...screened.contexts);
263
310
  const r = screened.answer;
264
311
  if (r) {
265
- if (r.additionalContext) {
266
- pass.preToolContext.push(r.additionalContext);
267
- }
268
312
  if (r.action === "deny") {
269
- return hookDenyExit(pass, screening.deniedReason(r));
313
+ return hookDenyExit(pass, screening.deniedReason(r), screened.answeredBy);
270
314
  }
271
315
  if (r.updatedInput !== undefined) {
272
316
  const rewritten = argsAsTheToolReads(pass.req, r.updatedInput);
@@ -279,6 +323,7 @@ export async function runToolGate(input) {
279
323
  if (r.action === "allow")
280
324
  pass.hookAllowedBy = screened.answeredBy !== undefined ? [screened.answeredBy] : [];
281
325
  }
326
+ takeInheritedScreen(pass, screened.inherited);
282
327
  }
283
328
  return await runGateFold(pass);
284
329
  }