@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -55,12 +55,13 @@ async function symlinkedLevel(env, repoRoot, worktreeDir) {
55
55
  }
56
56
  return undefined;
57
57
  }
58
- export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, branch) {
58
+ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, branch, readFloor) {
59
+ const readFloorNow = () => { const f = readFloor?.(); return f !== undefined ? { readFloor: f } : {}; };
59
60
  let detail = "";
60
61
  let removed = false;
61
62
  for (let attempt = 0; attempt < 2 && !removed; attempt++) {
62
63
  try {
63
- const r = await baseEnv.exec(`git worktree remove --force ${shq(worktreeDir)}`, { cwd: repoRoot });
64
+ const r = await baseEnv.exec(`git worktree remove --force ${shq(worktreeDir)}`, { cwd: repoRoot, ...readFloorNow() });
64
65
  if (r.ok && r.value.exitCode === 0)
65
66
  removed = true;
66
67
  else
@@ -77,10 +78,10 @@ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, bran
77
78
  if (!/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/.test(branch.baseSha) || /^0+$/.test(branch.baseSha))
78
79
  return { ok: true, branchKept: `${branch.name} (its base commit is not a usable witness)` };
79
80
  try {
80
- const del = await baseEnv.exec(`git update-ref --no-deref -d ${shq(`refs/heads/${branch.name}`)} ${shq(branch.baseSha)}`, { cwd: repoRoot });
81
+ const del = await baseEnv.exec(`git update-ref --no-deref -d ${shq(`refs/heads/${branch.name}`)} ${shq(branch.baseSha)}`, { cwd: repoRoot, ...readFloorNow() });
81
82
  if (del.ok && del.value.exitCode === 0)
82
83
  return { ok: true, branchDeleted: branch.name };
83
- const tip = await baseEnv.exec(`git rev-parse --verify --quiet ${shq(`refs/heads/${branch.name}`)}`, { cwd: repoRoot });
84
+ const tip = await baseEnv.exec(`git rev-parse --verify --quiet ${shq(`refs/heads/${branch.name}`)}`, { cwd: repoRoot, ...readFloorNow() });
84
85
  if (tip.ok && tip.value.exitCode !== 0)
85
86
  return { ok: true };
86
87
  if (tip.ok && tip.value.stdout.trim() !== branch.baseSha)
@@ -101,20 +102,22 @@ export async function addWorktree(baseEnv, opts) {
101
102
  const symlinked = await symlinkedLevel(baseEnv, opts.repoRoot, worktreeDir);
102
103
  if (symlinked !== undefined)
103
104
  throw new Error(symlinked);
105
+ const readFloorNow = () => { const readFloor = opts.readFloor?.(); return readFloor !== undefined ? { readFloor } : {}; };
104
106
  const add = await baseEnv.exec(`git worktree add --no-track -b ${shq(branch)} ${shq(worktreeDir)} ${shq(opts.commit ?? "HEAD")}`, {
105
107
  cwd: opts.repoRoot,
108
+ ...readFloorNow(),
106
109
  });
107
110
  if (!add.ok || add.value.exitCode !== 0) {
108
111
  const detail = add.ok ? add.value.stderr || add.value.stdout : thrownText(add.error);
109
112
  throw new Error(`git worktree add failed: ${detail}`);
110
113
  }
111
114
  const excludeLine = shq(`/${WORKTREE_PARENT}/`);
112
- await baseEnv
113
- .exec(`ex="$(git rev-parse --git-path info/exclude)" && mkdir -p "$(dirname "$ex")" && ` +
114
- `{ grep -qxF ${excludeLine} "$ex" 2>/dev/null || printf '%s\\n' ${excludeLine} >> "$ex"; }`, { cwd: opts.repoRoot })
115
+ await Promise.resolve()
116
+ .then(() => baseEnv.exec(`ex="$(git rev-parse --git-path info/exclude)" && mkdir -p "$(dirname "$ex")" && ` +
117
+ `{ grep -qxF ${excludeLine} "$ex" 2>/dev/null || printf '%s\\n' ${excludeLine} >> "$ex"; }`, { cwd: opts.repoRoot, ...readFloorNow() }))
115
118
  .catch(() => undefined);
116
- const baseSha = await baseEnv
117
- .exec("git rev-parse HEAD", { cwd: worktreeDir })
119
+ const baseSha = await Promise.resolve()
120
+ .then(() => baseEnv.exec("git rev-parse HEAD", { cwd: worktreeDir, ...readFloorNow() }))
118
121
  .then((r) => (r.ok && r.value.exitCode === 0 && r.value.stdout.trim() !== "" ? r.value.stdout.trim() : undefined))
119
122
  .catch(() => undefined);
120
123
  const branchRule = baseSha !== undefined ? { name: branch, baseSha } : undefined;
@@ -123,7 +126,7 @@ export async function addWorktree(baseEnv, opts) {
123
126
  inner = await opts.rootEnvAt(worktreeDir);
124
127
  }
125
128
  catch (err) {
126
- await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule);
129
+ await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule, opts.readFloor);
127
130
  throw err;
128
131
  }
129
132
  const innerDestroy = inner.destroy;
@@ -134,7 +137,7 @@ export async function addWorktree(baseEnv, opts) {
134
137
  await innerDestroy.call(inner);
135
138
  }
136
139
  finally {
137
- const removed = await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule);
140
+ const removed = await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule, opts.readFloor);
138
141
  if (!removed.ok) {
139
142
  throw new Error(`git worktree remove failed twice — ${worktreeDir} is now an orphan (dir + registration remain; ` +
140
143
  `\`git worktree prune\` cannot reclaim it while the dir exists — remove it manually): ${removed.detail}`);
@@ -143,9 +146,9 @@ export async function addWorktree(baseEnv, opts) {
143
146
  };
144
147
  return { env, worktreeDir, name, branch, ...(baseSha !== undefined ? { baseSha } : {}) };
145
148
  }
146
- export async function pruneWorktrees(baseEnv, repoRoot) {
149
+ export async function pruneWorktrees(baseEnv, repoRoot, readFloor) {
147
150
  try {
148
- const r = await baseEnv.exec("git worktree prune", { cwd: repoRoot });
151
+ const r = await baseEnv.exec("git worktree prune", { cwd: repoRoot, ...(readFloor !== undefined ? { readFloor } : {}) });
149
152
  if (r.ok && r.value.exitCode === 0)
150
153
  return { ok: true };
151
154
  return {
@@ -145,7 +145,7 @@ export type NoticeAudience = "user" | "operator";
145
145
  * the union's catalog ({@link EngineNotice.code}). The groups below say only which family a row joins,
146
146
  * so the catalog is not written a second time here and the two cannot drift.
147
147
  */
148
- export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.image_removed", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "instructions.source_changed", "session.records_skipped", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
148
+ export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.read_floor_confinement_unavailable", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.media_removed", "context.tool_schema_removed", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "config.image_processor_unavailable", "fs.staging_file_left", "fs.staging_file_swept", "instructions.source_changed", "session.records_skipped", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
149
149
  /** A catalogued code (see {@link ENGINE_NOTICE_CODES}); {@link NOTICE_MINTER} says who mints it. NOT the type of
150
150
  * `EngineNotice.code`, which stays `string` — a host forwarding its own notices through the same
151
151
  * sink is a supported shape, and narrowing that field would break it. */
@@ -175,6 +175,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
175
175
  readonly "classifier.denial_limit": "user";
176
176
  readonly "classifier.unavailable": "user";
177
177
  readonly "classifier.fallback": "operator";
178
+ readonly "classifier.seat_rate_limited": "user";
178
179
  readonly "classifier.role_defaulted": "operator";
179
180
  readonly "classifier.contract_broken": "operator";
180
181
  readonly "task.turn_interrupted": "user";
@@ -220,6 +221,8 @@ declare const NOTICE_AUDIENCE_TABLE: {
220
221
  readonly "config.write_protection_target_view_absent": "operator";
221
222
  readonly "config.path_view_unresolved": "operator";
222
223
  readonly "config.execution_env_capability_invalid": "operator";
224
+ readonly "config.read_deny_floor_unkept": "operator";
225
+ readonly "config.read_floor_confinement_unavailable": "operator";
223
226
  readonly "config.tool_card_undeclared": "operator";
224
227
  readonly "config.tool_face_undeclared": "operator";
225
228
  readonly "config.tool_face_invalid": "operator";
@@ -238,6 +241,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
238
241
  readonly "mcp.revocation_probe_failed": "operator";
239
242
  readonly "mcp.server_redialed": "operator";
240
243
  readonly "mcp.authorization_required": "user";
244
+ readonly "mcp.credential_echoed": "operator";
241
245
  readonly "workflow.governance_key_stripped": "operator";
242
246
  readonly "workflow.agent_option_ignored": "operator";
243
247
  readonly "memory.content_class_declared": "operator";
@@ -259,11 +263,15 @@ declare const NOTICE_AUDIENCE_TABLE: {
259
263
  readonly "model.capability_downgraded": "user";
260
264
  readonly "model.role_defaulted": "operator";
261
265
  readonly "context.tool_turn_repaired": "operator";
262
- readonly "context.image_removed": "user";
266
+ readonly "context.media_removed": "user";
267
+ readonly "context.tool_schema_removed": "user";
263
268
  readonly "skills.listing_truncated": "operator";
264
269
  readonly "agents.listing_truncated": "operator";
265
270
  readonly "tool_result.offload_put_failed": "operator";
266
271
  readonly "tool_result.media_refused": "operator";
272
+ readonly "config.image_processor_unavailable": "operator";
273
+ readonly "fs.staging_file_left": "operator";
274
+ readonly "fs.staging_file_swept": "operator";
267
275
  readonly "config.forward_sink_failed": "operator";
268
276
  readonly "instructions.source_changed": "user";
269
277
  readonly "session.records_skipped": "user";
@@ -313,6 +321,8 @@ declare const NOTICE_MINTER_TABLE: {
313
321
  readonly "config.write_protection_target_view_absent": "engine";
314
322
  readonly "config.path_view_unresolved": "engine";
315
323
  readonly "config.execution_env_capability_invalid": "engine";
324
+ readonly "config.read_deny_floor_unkept": "engine";
325
+ readonly "config.read_floor_confinement_unavailable": "engine";
316
326
  readonly "config.tool_card_undeclared": "engine";
317
327
  readonly "config.tool_face_undeclared": "engine";
318
328
  readonly "config.tool_face_invalid": "engine";
@@ -338,6 +348,7 @@ declare const NOTICE_MINTER_TABLE: {
338
348
  readonly "peer.idle_subscription": "engine";
339
349
  readonly "classifier.denial_limit": "engine";
340
350
  readonly "classifier.fallback": "engine";
351
+ readonly "classifier.seat_rate_limited": "engine";
341
352
  readonly "classifier.role_defaulted": "engine";
342
353
  readonly "classifier.contract_broken": "engine";
343
354
  readonly "classifier.unavailable": "engine";
@@ -348,6 +359,7 @@ declare const NOTICE_MINTER_TABLE: {
348
359
  readonly "mcp.revocation_probe_failed": "engine";
349
360
  readonly "mcp.server_redialed": "engine";
350
361
  readonly "mcp.authorization_required": "engine";
362
+ readonly "mcp.credential_echoed": "engine";
351
363
  readonly "workflow.governance_key_stripped": "engine";
352
364
  readonly "workflow.agent_option_ignored": "engine";
353
365
  readonly "memory.session_polluted": "engine";
@@ -379,7 +391,8 @@ declare const NOTICE_MINTER_TABLE: {
379
391
  readonly "model.capability_downgraded": "engine";
380
392
  readonly "model.role_defaulted": "engine";
381
393
  readonly "context.tool_turn_repaired": "engine";
382
- readonly "context.image_removed": "engine";
394
+ readonly "context.media_removed": "engine";
395
+ readonly "context.tool_schema_removed": "engine";
383
396
  readonly "task.user_steer_undrained": "engine";
384
397
  readonly "task.user_followup_undrained": "engine";
385
398
  readonly "steering.parked_input_blocked": "engine";
@@ -396,6 +409,9 @@ declare const NOTICE_MINTER_TABLE: {
396
409
  readonly "agents.listing_truncated": "engine";
397
410
  readonly "tool_result.offload_put_failed": "engine";
398
411
  readonly "tool_result.media_refused": "engine";
412
+ readonly "config.image_processor_unavailable": "engine";
413
+ readonly "fs.staging_file_left": "engine";
414
+ readonly "fs.staging_file_swept": "engine";
399
415
  readonly "instructions.source_changed": "server";
400
416
  readonly "session.records_skipped": "server";
401
417
  readonly "memory.layer_locked_legacy": "server";
@@ -142,6 +142,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
142
142
  "config.write_protection_target_view_absent",
143
143
  "config.path_view_unresolved",
144
144
  "config.execution_env_capability_invalid",
145
+ "config.read_deny_floor_unkept",
146
+ "config.read_floor_confinement_unavailable",
145
147
  "config.tool_card_undeclared",
146
148
  "config.tool_face_undeclared",
147
149
  "config.tool_face_invalid",
@@ -167,6 +169,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
167
169
  "peer.idle_subscription",
168
170
  "classifier.denial_limit",
169
171
  "classifier.fallback",
172
+ "classifier.seat_rate_limited",
170
173
  "classifier.role_defaulted",
171
174
  "classifier.contract_broken",
172
175
  "classifier.unavailable",
@@ -177,6 +180,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
177
180
  "mcp.revocation_probe_failed",
178
181
  "mcp.server_redialed",
179
182
  "mcp.authorization_required",
183
+ "mcp.credential_echoed",
180
184
  "workflow.governance_key_stripped",
181
185
  "workflow.agent_option_ignored",
182
186
  "memory.session_polluted",
@@ -208,7 +212,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
208
212
  "model.capability_downgraded",
209
213
  "model.role_defaulted",
210
214
  "context.tool_turn_repaired",
211
- "context.image_removed",
215
+ "context.media_removed",
216
+ "context.tool_schema_removed",
212
217
  "task.user_steer_undrained",
213
218
  "task.user_followup_undrained",
214
219
  "steering.parked_input_blocked",
@@ -225,6 +230,9 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
225
230
  "agents.listing_truncated",
226
231
  "tool_result.offload_put_failed",
227
232
  "tool_result.media_refused",
233
+ "config.image_processor_unavailable",
234
+ "fs.staging_file_left",
235
+ "fs.staging_file_swept",
228
236
  "instructions.source_changed",
229
237
  "session.records_skipped",
230
238
  "memory.layer_locked_legacy",
@@ -243,6 +251,7 @@ const NOTICE_AUDIENCE_TABLE = {
243
251
  "classifier.denial_limit": "user",
244
252
  "classifier.unavailable": "user",
245
253
  "classifier.fallback": "operator",
254
+ "classifier.seat_rate_limited": "user",
246
255
  "classifier.role_defaulted": "operator",
247
256
  "classifier.contract_broken": "operator",
248
257
  "task.turn_interrupted": "user",
@@ -288,6 +297,8 @@ const NOTICE_AUDIENCE_TABLE = {
288
297
  "config.write_protection_target_view_absent": "operator",
289
298
  "config.path_view_unresolved": "operator",
290
299
  "config.execution_env_capability_invalid": "operator",
300
+ "config.read_deny_floor_unkept": "operator",
301
+ "config.read_floor_confinement_unavailable": "operator",
291
302
  "config.tool_card_undeclared": "operator",
292
303
  "config.tool_face_undeclared": "operator",
293
304
  "config.tool_face_invalid": "operator",
@@ -306,6 +317,7 @@ const NOTICE_AUDIENCE_TABLE = {
306
317
  "mcp.revocation_probe_failed": "operator",
307
318
  "mcp.server_redialed": "operator",
308
319
  "mcp.authorization_required": "user",
320
+ "mcp.credential_echoed": "operator",
309
321
  "workflow.governance_key_stripped": "operator",
310
322
  "workflow.agent_option_ignored": "operator",
311
323
  "memory.content_class_declared": "operator",
@@ -327,11 +339,15 @@ const NOTICE_AUDIENCE_TABLE = {
327
339
  "model.capability_downgraded": "user",
328
340
  "model.role_defaulted": "operator",
329
341
  "context.tool_turn_repaired": "operator",
330
- "context.image_removed": "user",
342
+ "context.media_removed": "user",
343
+ "context.tool_schema_removed": "user",
331
344
  "skills.listing_truncated": "operator",
332
345
  "agents.listing_truncated": "operator",
333
346
  "tool_result.offload_put_failed": "operator",
334
347
  "tool_result.media_refused": "operator",
348
+ "config.image_processor_unavailable": "operator",
349
+ "fs.staging_file_left": "operator",
350
+ "fs.staging_file_swept": "operator",
335
351
  "config.forward_sink_failed": "operator",
336
352
  "instructions.source_changed": "user",
337
353
  "session.records_skipped": "user",
@@ -362,6 +378,8 @@ const NOTICE_MINTER_TABLE = {
362
378
  "config.write_protection_target_view_absent": "engine",
363
379
  "config.path_view_unresolved": "engine",
364
380
  "config.execution_env_capability_invalid": "engine",
381
+ "config.read_deny_floor_unkept": "engine",
382
+ "config.read_floor_confinement_unavailable": "engine",
365
383
  "config.tool_card_undeclared": "engine",
366
384
  "config.tool_face_undeclared": "engine",
367
385
  "config.tool_face_invalid": "engine",
@@ -387,6 +405,7 @@ const NOTICE_MINTER_TABLE = {
387
405
  "peer.idle_subscription": "engine",
388
406
  "classifier.denial_limit": "engine",
389
407
  "classifier.fallback": "engine",
408
+ "classifier.seat_rate_limited": "engine",
390
409
  "classifier.role_defaulted": "engine",
391
410
  "classifier.contract_broken": "engine",
392
411
  "classifier.unavailable": "engine",
@@ -397,6 +416,7 @@ const NOTICE_MINTER_TABLE = {
397
416
  "mcp.revocation_probe_failed": "engine",
398
417
  "mcp.server_redialed": "engine",
399
418
  "mcp.authorization_required": "engine",
419
+ "mcp.credential_echoed": "engine",
400
420
  "workflow.governance_key_stripped": "engine",
401
421
  "workflow.agent_option_ignored": "engine",
402
422
  "memory.session_polluted": "engine",
@@ -428,7 +448,8 @@ const NOTICE_MINTER_TABLE = {
428
448
  "model.capability_downgraded": "engine",
429
449
  "model.role_defaulted": "engine",
430
450
  "context.tool_turn_repaired": "engine",
431
- "context.image_removed": "engine",
451
+ "context.media_removed": "engine",
452
+ "context.tool_schema_removed": "engine",
432
453
  "task.user_steer_undrained": "engine",
433
454
  "task.user_followup_undrained": "engine",
434
455
  "steering.parked_input_blocked": "engine",
@@ -445,6 +466,9 @@ const NOTICE_MINTER_TABLE = {
445
466
  "agents.listing_truncated": "engine",
446
467
  "tool_result.offload_put_failed": "engine",
447
468
  "tool_result.media_refused": "engine",
469
+ "config.image_processor_unavailable": "engine",
470
+ "fs.staging_file_left": "engine",
471
+ "fs.staging_file_swept": "engine",
448
472
  "instructions.source_changed": "server",
449
473
  "session.records_skipped": "server",
450
474
  "memory.layer_locked_legacy": "server",
@@ -1,7 +1,6 @@
1
1
  const HANDS_BAND_MEMBERS = {
2
2
  bashReadonlyAllow: { takes: "a list of command-name strings", ok: (v) => Array.isArray(v) && v.every((c) => typeof c === "string") },
3
3
  commitCoAuthor: { takes: "a string or false", ok: (v) => typeof v === "string" || v === false },
4
- readImageDownsampler: { takes: "a function or false", ok: (v) => typeof v === "function" || v === false },
5
4
  beforeWrite: { takes: "a function", ok: (v) => typeof v === "function" },
6
5
  autoBackgroundOnTimeout: { takes: "a boolean", ok: (v) => typeof v === "boolean" },
7
6
  };
@@ -104,9 +104,6 @@ export interface HandsBandOptions {
104
104
  /** Co-Authored-By trailer for the bash git protocol. Default NONE ([c209] BREAKING: attribution is a
105
105
  * deployment identity asset — the branded scenario sets `"Name <email>"`); `false` ≡ unset. */
106
106
  commitCoAuthor?: string | false;
107
- /** Read-tool image downsampler: inject your own, or `false` to force-disable (deterministic no-sharp).
108
- * Omitted ⇒ auto-detect sharp. Same contract as the MCP-side {@link import("./mcp.js").ImageDownsampler}. */
109
- readImageDownsampler?: ((input: Buffer, mimeType: string) => Promise<import("./mcp.js").DownsampledImage | undefined>) | false;
110
107
  /** Deployment write gate — COMPOSED with (never replacing) the engine's MemoryEngine write-scan gate:
111
108
  * this hook judges first (a rejection short-circuits), the engine gate then still runs in full. */
112
109
  beforeWrite?: BeforeWriteHook;
@@ -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
@@ -451,8 +450,8 @@ export declare function createHookEnvCapabilities(env: ExecutionEnv): HookEnvCap
451
450
  export interface HookInvocationIdentity {
452
451
  /** The run's session id (uuid domain) — the same key `TaskResult.sessionId` reports. */
453
452
  readonly sessionId: string;
454
- /** The run's unified task id (`spec.taskId ?? sessionId` — the value TaskEvent's `sourceTaskId`
455
- * and `task_progress` frames key on). Equal to {@link sessionId} when no task id was declared. */
453
+ /** The run's unified task id (the leg's one mint; TaskEvent's `sourceTaskId` and `task_progress` key on it): a background
454
+ * sub-agent's registry task id, else the host's declared task id, else {@link sessionId}. */
456
455
  readonly taskId: string;
457
456
  /** Which prepared leg this invocation belongs to — the wiring manifest's own `leg.kind`
458
457
  * derivation, verbatim ({@link WiringLegKind}: `"root" | "child" | "resume"`). NOTE the fork
@@ -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
@@ -549,6 +549,10 @@ export interface HookToolOutput {
549
549
  */
550
550
  export type PreToolUseResult = PermissionResult & {
551
551
  additionalContext?: string;
552
+ /** WHY the hook asks, on an `ask` only ({@link import("./ask-origin.js").HookQuestionCause}; absent reads `asked`): on the two
553
+ * `verdict_*` words the `message` is the host's account, which no entry carries. Outside the set, or on another arm, the
554
+ * decision receipt refuses it (an engine fail-closed deny). */
555
+ questionCause?: import("./ask-origin.js").HookQuestionCause;
552
556
  };
553
557
  /** A PostToolUse hook result: replace the tool output and/or append context (both optional). */
554
558
  export interface PostToolUseResult {
@@ -783,12 +787,14 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
783
787
  * the call fail-closed (the event's failure column), and so does a cancel; an observe handler never decides.
784
788
  */
785
789
  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[];
790
+ /** The inherited installations that judge this leg's calls too (`inheritedInstallations`, the rule's one home), each on its
791
+ * own bus after {@link modBus}: `classic.PreToolUse` at phase 1 (and at every re-screen), with this leg's identity and the
792
+ * installation's environment; `tool.check` at the verdict read, each over the verdict the previous left standing. On both
793
+ * events their `deny` is the hook's own refusal, their `allow` never clears an ask (an installation answers only its own
794
+ * leg's questions; it is disclosed as the `hook` member's shadow), and their `ask` goes to each installation's own `settle`
795
+ * (where its installation froze the question), never to this gate's resolver; an approval there that edits the call takes
796
+ * this gate's approved-edit pass. Absent ⇒ only {@link modBus} is raised. */
797
+ inheritedInstallations?: readonly import("./mods/stations.js").InheritedInstallation[];
792
798
  /** The leg's observed permission mode, carried on every `classic.PreToolUse` e this gate call raises. Absent ⇒ the e
793
799
  * carries none (a host-driven gate with no leg seat). */
794
800
  observedPermissionMode?: () => PermissionMode;
@@ -1282,7 +1288,7 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
1282
1288
  };
1283
1289
  /**
1284
1290
  * 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
1291
+ * env DECLARES isolation (`capabilities.isolation === true`, read through `isIsolated` — a Runner-resolved
1286
1292
  * fact, never caller self-report) AND the park prerequisites hold (durable park configured + a wired
1287
1293
  * checkpoint store — every store carries the required `reopen`, read at its seat). Absent ⇒ the whole step does not
1288
1294
  * exist and the decision path is byte-identical to a build without it.
@@ -1320,52 +1326,33 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
1320
1326
  };
1321
1327
  }
1322
1328
  /**
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.
1329
+ * The PreToolUse screening face ({@link PreToolUseScreening}) for ONE call — `classic.PreToolUse` raised on the leg's own
1330
+ * bus and then on each inherited installation's ({@link ToolGateInput.inheritedInstallations}), the per-screening e and the
1331
+ * fail-closed sentences, built in ONE place for every site that screens a call: the gate's phase 1, the fold's second look
1332
+ * and the approved-edit re-screens (through {@link runToolGate}'s pass) and the resumed leg's re-screen of an approved call.
1333
+ * Undefined when no handler hangs on the event on any of those buses.
1327
1334
  *
1328
1335
  * The e: `tool` (the call's wire name), `tool_use_id`, `input` — a deep-frozen copy of the args, so what a handler
1329
1336
  * 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.
1337
+ * `cwd` (the task's tracked cwd, read per screening), `env` (the capability face), `identity`, `permissionMode`. On an
1338
+ * inherited installation the e is THIS leg's (its identity, its mode, its cwd — the call being judged) and the `env` is the
1339
+ * environment that installation was installed against; only its judging handlers take part.
1364
1340
  *
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.
1341
+ * Every installation is one judge of the call, under one answer reading: a failure or a cancel refuses the call
1342
+ * fail-closed, a `deny` refuses it as the hook's own refusal, a rewrite is adopted (an installation that judged the earlier
1343
+ * bytes judges the rewrite once — a verdict covers the bytes it was given; a deny or yet another form there refuses), the
1344
+ * context lines are collected. Its other words differ by WHOSE installation it is: the leg's own `ask` / `allow` is the
1345
+ * leg's (folded by the gate as before); an inherited installation's `ask` is settled under the regime it froze
1346
+ * (`InheritedInstallation.settle`, read through `readSettled` — the pass's ledger): refused ⇒ the call is refused,
1347
+ * approved ⇒ that question is answered, approved with an edit ⇒ the screen ends and the gate's approved-edit pass takes the
1348
+ * edit, floated ⇒ the question stands marked; its `allow` is no objection (an installation answers only its own leg's
1349
+ * questions), disclosed beside the leg's own hook member.
1367
1350
  */
1368
- export declare function createPreToolUseConstraintPolicy(chain: Pick<import("./mods/kernel/index.js").ModBus, "hasHandlers" | "dispatch">, env?: HookEnvCapabilities): ToolPolicy;
1351
+ export declare function createPreToolUseScreening(input: Pick<ToolGateInput, "event" | "modBus" | "inheritedInstallations" | "observedPermissionMode" | "trackedCwd" | "hookEnv" | "identity" | "abortSignal" | "callSignal">, readSettled?: (settled: PermissionResult) => {
1352
+ readonly decision: PermissionResult;
1353
+ readonly deniedBy?: DeniedBy;
1354
+ readonly cause?: ClassifierDenyCause;
1355
+ }): PreToolUseScreening | undefined;
1369
1356
  /**
1370
1357
  * The park closure's ONE structural seat — what the gate hands the durable park beyond the twelve
1371
1358
  * positional seats. Every member is optional and read by name, so a new thing the park must know
@@ -1401,11 +1388,14 @@ export interface AskCarry {
1401
1388
  readonly mandate?: import("./ask-origin.js").PersistedRuleMandate;
1402
1389
  /** The deployment's authorship ({@link import("./tool-policy.js").AskRequest.authoredBy}), for the row's twin. */
1403
1390
  readonly authoredBy?: "deployment";
1391
+ /** The surviving ask's askers' entries ({@link import("./tool-policy.js").AskRequest.askReasons}), for the row's twin — the
1392
+ * same value the synchronous card carries. */
1393
+ readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
1404
1394
  }
1405
1395
  /** What a durable row persists of an {@link AskCarry}: the fallback member COPIED (the row never aliases
1406
1396
  * the gate's object; its window is already `0` — the gate's carry mint is the one writer of that
1407
- * number), the origin word only when it is a member of the closed set, and the class pair only when it is
1408
- * well-formed, as a fresh copy (the carry is typed, but the row is the boundary a host reads back through —
1397
+ * number), the origin word only when it is a member of the closed set, the class pair and the askers' entries only when
1398
+ * well-formed, as fresh copies (the carry is typed, but the row is the boundary a host reads back through —
1409
1399
  * the same screen the summary applies to the word). */
1410
1400
  export declare function askCarryRowMembers(carry: AskCarry | undefined): {
1411
1401
  denialLimitFallback?: import("./auto-mode.js").DenialLimitFallback;
@@ -1413,6 +1403,7 @@ export declare function askCarryRowMembers(carry: AskCarry | undefined): {
1413
1403
  origin?: import("./ask-origin.js").AskOrigin;
1414
1404
  askClass?: import("./ask-origin.js").AskClass;
1415
1405
  classes?: readonly import("./ask-origin.js").AskClass[];
1406
+ askReasons?: readonly import("./ask-origin.js").AskReason[];
1416
1407
  };
1417
1408
  /**
1418
1409
  * The design/37 **two-phase tool gate** — the single chokepoint that makes the load-bearing invariant