@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1,6 +1,7 @@
1
- import { carriesNamespaceSeparator, protocolOf } from "./protocol-table.js";
1
+ import { carriesNamespaceSeparator, MCP_NAMESPACE, protocolOf } from "./protocol-table.js";
2
2
  import { mintNamespacePrefix } from "./protocol-naming.js";
3
3
  import { catalogToolNames } from "./tool-registry.js";
4
+ const BACKGROUND_OUTPUT_READING = "removed — read a background command's output file with Read (its launch receipt and completion notification name the path); a background agent's or workflow's result arrives in its completion notification (read the full text with ReadToolResult and the ref it names when the notification clips it)";
4
5
  export const RETIRED_TOOL_NAMES = new Map([
5
6
  ["read_file", 'renamed "Read"'],
6
7
  ["edit_file", 'renamed "Edit"'],
@@ -25,11 +26,14 @@ export const RETIRED_TOOL_NAMES = new Map([
25
26
  ["run_workflow", 'renamed "Workflow"'],
26
27
  ["RunWorkflow", 'renamed "Workflow"'],
27
28
  ["Task", 'renamed "Agent" (a deployment-defined tool named "Task" is fine — this fires only when the name matches nothing in the roster)'],
28
- ["BashOutput", 'renamed "TaskOutput"'],
29
- ["AgentOutputTool", 'renamed "TaskOutput"'],
30
- ["BashOutputTool", 'renamed "TaskOutput"'],
31
- ["AgentOutput", 'renamed "TaskOutput"'],
32
- ["WorkflowStatus", 'folded into "TaskOutput" (poll by runId)'],
29
+ ["TaskOutput", BACKGROUND_OUTPUT_READING],
30
+ ["BashOutput", BACKGROUND_OUTPUT_READING],
31
+ ["AgentOutputTool", BACKGROUND_OUTPUT_READING],
32
+ ["BashOutputTool", BACKGROUND_OUTPUT_READING],
33
+ ["AgentOutput", BACKGROUND_OUTPUT_READING],
34
+ ["WorkflowStatus", BACKGROUND_OUTPUT_READING],
35
+ ["TeamCreate", "removed — the session has one implicit team: start a teammate with Agent (a name makes it addressable via SendMessage)"],
36
+ ["TeamDelete", "removed — the session has one implicit team: stop a teammate with TaskStop"],
33
37
  ["KillShell", 'renamed "TaskStop"'],
34
38
  ["KillBash", 'renamed "TaskStop"'],
35
39
  ["ListMcpResources", 'renamed "ListMcpResourcesTool"'],
@@ -54,6 +58,28 @@ export function splitNamespacedName(name) {
54
58
  const [peer = "", ...rest] = name.slice(ns.prefix.length).split(NAMESPACE_SEPARATOR);
55
59
  return rest.length > 0 ? { ns, peer, tool: rest.join(NAMESPACE_SEPARATOR) } : { ns, peer };
56
60
  }
61
+ export function peerReadingsOf(name) {
62
+ if (name.includes("*"))
63
+ return [];
64
+ const ns = protocolOf(name);
65
+ if (ns === undefined || ns.id !== MCP_NAMESPACE.id)
66
+ return [];
67
+ const body = name.slice(ns.prefix.length);
68
+ if (body === "" || body.startsWith(NAMESPACE_SEPARATOR))
69
+ return [];
70
+ const mintedPeer = (server) => mintNamespacePrefix(ns, server).slice(ns.prefix.length, -NAMESPACE_SEPARATOR.length);
71
+ const readings = [];
72
+ for (let at = body.indexOf(NAMESPACE_SEPARATOR); at !== -1; at = body.indexOf(NAMESPACE_SEPARATOR, at + 1)) {
73
+ const tool = body.slice(at + NAMESPACE_SEPARATOR.length);
74
+ if (tool !== "")
75
+ readings.push({ ns, peer: mintedPeer(body.slice(0, at)), tool });
76
+ }
77
+ if (readings.length === 0)
78
+ return [];
79
+ if (!body.endsWith(NAMESPACE_SEPARATOR))
80
+ readings.push({ ns, peer: mintedPeer(body) });
81
+ return readings.filter((r, i) => readings.findIndex((o) => o.peer === r.peer && o.tool === r.tool) === i);
82
+ }
57
83
  export function readsNameGlob(behavior) {
58
84
  return behavior === "deny" || behavior === "ask";
59
85
  }
@@ -86,6 +112,25 @@ function unmintableSegmentOf(split, behavior) {
86
112
  currentName: `${ns.prefix}${minted}${tool !== undefined ? `${NAMESPACE_SEPARATOR}${tool}` : ""}`,
87
113
  };
88
114
  }
115
+ function ambiguousServerSpellingOf(name, roster) {
116
+ const readings = peerReadingsOf(name);
117
+ if (readings.length === 0)
118
+ return undefined;
119
+ for (const carried of roster) {
120
+ const split = splitNamespacedName(carried);
121
+ if (split === undefined || split.tool === undefined)
122
+ continue;
123
+ if (!readings.some((r) => r.ns.id === split.ns.id && r.peer === split.peer && (r.tool === undefined || r.tool === split.tool)))
124
+ continue;
125
+ return {
126
+ kind: "unmintable_segment",
127
+ ambiguous: true,
128
+ guidance: "the name reads as more than one MCP server's. To allow it, use the tool's full name.",
129
+ currentName: carried,
130
+ };
131
+ }
132
+ return undefined;
133
+ }
89
134
  export function judgeRuleToolName(name, roster, behavior) {
90
135
  if (roster.has(name))
91
136
  return CURRENT;
@@ -94,6 +139,11 @@ export function judgeRuleToolName(name, roster, behavior) {
94
139
  const currentName = /^renamed "([^"]+)"/.exec(guidance)?.[1];
95
140
  return currentName !== undefined ? { kind: "retired", guidance, currentName } : { kind: "retired", guidance };
96
141
  }
142
+ if (behavior === "allow") {
143
+ const ambiguous = ambiguousServerSpellingOf(name, roster);
144
+ if (ambiguous !== undefined)
145
+ return ambiguous;
146
+ }
97
147
  const split = splitNamespacedName(name);
98
148
  if (split === undefined)
99
149
  return carriesNamespaceSeparator(name) && !(readsNameGlob(behavior) && name.includes("*")) ? UNPREFIXED : CURRENT;
@@ -116,7 +166,13 @@ export function toolNameFaultOf(name, roster, behavior) {
116
166
  if (verdict.kind === "unprefixed_namespace")
117
167
  return { reason: "tool_name", verdict: verdict.kind };
118
168
  if (verdict.kind !== "current") {
119
- return { reason: "tool_name", verdict: verdict.kind, guidance: verdict.guidance, ...(verdict.currentName !== undefined ? { currentName: verdict.currentName } : {}) };
169
+ return {
170
+ reason: "tool_name",
171
+ verdict: verdict.kind,
172
+ guidance: verdict.guidance,
173
+ ...(verdict.currentName !== undefined ? { currentName: verdict.currentName } : {}),
174
+ ...(verdict.kind === "unmintable_segment" && verdict.ambiguous === true ? { ambiguous: true } : {}),
175
+ };
120
176
  }
121
177
  const mounted = nearMissSpellingOf(name, roster);
122
178
  return mounted === undefined ? undefined : { reason: "near_miss", currentName: mounted };
@@ -4,13 +4,16 @@
4
4
  * the wire name the gate resolves it to, the other aliases that resolve to the same row); which of them a site reads
5
5
  * is a property of the SITE, declared here once:
6
6
  *
7
- * · `any` — a TIGHTEN keyed on an engine name set, or a rule name a user wrote: the call is held under EVERY name it
8
- * answers to ({@link heldBy}); a set-valued table is read as the union of its entries ({@link heldValues}).
7
+ * · `any` — a TIGHTEN keyed on an engine name set (a deny / ask rule's content included), or a rule naming a WHOLE tool
8
+ * (no content: the name a person or a skill wrote reaches every call that answers to it): the call is held
9
+ * under EVERY name it answers to ({@link heldBy}); a set-valued table is read as the union of its entries
10
+ * ({@link heldValues}).
9
11
  * · `seat` — a multi-key seat keyed on engine names: ONE name is chosen ({@link seatOf}) and every key of the seat is
10
12
  * read under it. `tier` = the name whose irreversibility tier is strictest (`never < maybe < always`, an
11
13
  * absent tier lowest; a tie goes to the call's wire name — the tool that runs judges its own call with its
12
14
  * own probe — then to the earlier name of the call); `member` = the first name the table holds.
13
- * · `wire` — a GRANT or a ROUTING keyed on an engine name: the call's wire name only ({@link wireOf}).
15
+ * · `wire` — a GRANT or a ROUTING keyed on an engine name — an allow rule's content (read in the grammar of the tool that
16
+ * runs), and every entry of an allow list handed in at launch: the call's wire name only ({@link wireOf}).
14
17
  * · `spelling` — a record of what the model said (stream frames, transcripts, counters): the harness event's own name;
15
18
  * no port — listed so the table is complete.
16
19
  *
@@ -111,6 +114,10 @@ export declare const NAME_READINGS: {
111
114
  readonly kind: "any";
112
115
  readonly file: string;
113
116
  };
117
+ readonly "allowEntry.launchListNames": {
118
+ readonly kind: "wire";
119
+ readonly file: string;
120
+ };
114
121
  readonly "skillGrant.binding": {
115
122
  readonly kind: "wire";
116
123
  readonly file: string;
@@ -127,6 +134,10 @@ export declare const NAME_READINGS: {
127
134
  readonly kind: "any";
128
135
  readonly file: string;
129
136
  };
137
+ readonly "policy.persistedGrammar.grant": {
138
+ readonly kind: "wire";
139
+ readonly file: string;
140
+ };
130
141
  readonly "policy.persistedToolRule": {
131
142
  readonly kind: "any";
132
143
  readonly file: string;
@@ -29,10 +29,12 @@ export const NAME_READINGS = {
29
29
  "policy.projectionReplay": any(POLICY),
30
30
  "policy.sessionRules.effect": wire("src/core/runner/session-rule-policy.ts"),
31
31
  "allowEntry.names": any("src/core/allow-entry.ts"),
32
+ "allowEntry.launchListNames": wire("src/core/allow-entry.ts"),
32
33
  "skillGrant.binding": wire("src/core/skill-grant.ts"),
33
34
  "gate.skillActivationSeat": wire(GATE),
34
35
  "policy.permissionRules": any("src/core/permission-rules.ts"),
35
36
  "policy.persistedGrammar": any("src/core/permission-rule-model.ts"),
37
+ "policy.persistedGrammar.grant": wire("src/core/permission-rule-model.ts"),
36
38
  "policy.persistedToolRule": any("src/core/permission-rule-model.ts"),
37
39
  "policy.sensitivePathGuardedByName": any("src/core/sensitive-path-policy.ts"),
38
40
  "floor.protectivePathTarget": seat("member", "src/core/tool-registry.ts"),
@@ -1,7 +1,7 @@
1
1
  import { type AskOrigin, type AssertAllKeysHandled } from "./ask-origin.js";
2
2
  import { type EngineAttestation } from "./engine-attestation.js";
3
3
  import { type ReadRootGrantScreen } from "./read-root-grant-screen.js";
4
- import { type Settlement } from "./gate-outcome.js";
4
+ import { type DecidedVia, type Settlement } from "./gate-outcome.js";
5
5
  export { policyCannotAnswer, rowDemandsAPerson } from "./real-approval.js";
6
6
  import { type BindingFault } from "./canonical-json.js";
7
7
  import { type DecisionReason } from "./decision-receipt.js";
@@ -293,6 +293,20 @@ export declare function screenApproverAttribution(v: unknown): {
293
293
  approver?: string;
294
294
  defect?: string;
295
295
  };
296
+ /**
297
+ * Screen the `decidedVia` member — the ONE screen both entry points hold it to (the synchronous `AskOutcome` object and
298
+ * the durable `hostDecision`), so one value cannot meet two standards depending on its door. `word` is the decider word
299
+ * the same answer reported (`settledBy`, folded; `hostDecision.decidedBy`): both closed sets spell the policy decider
300
+ * `"policy"`, and that is the only word the member refines.
301
+ *
302
+ * Returns `{}` for absent, `{ decidedVia }` for a member of {@link DECIDED_VIA} beside `"policy"`, or `{ defect }` with the
303
+ * sentence the caller puts in its own refusal. A closed word is exact: the empty string is outside the set, and the
304
+ * defect names the member and the set, never the supplied value (a host string is not echoed into a refusal).
305
+ */
306
+ export declare function screenDecidedVia(v: unknown, word: string): {
307
+ decidedVia?: DecidedVia;
308
+ defect?: string;
309
+ };
296
310
  /** An integrity guard an ask stands on — an engine finding, carried on the ask's record ({@link EngineAttestation.guards}). */
297
311
  export type AskGuard = "dangerous_delete" | "unverifiable_delete" | "unverifiable_shell_text" | "transcript_write" | "artifact_shared_read";
298
312
  /**
@@ -455,6 +469,11 @@ export type PermissionResult = {
455
469
  /** The ask's whole class set, in {@link import("./ask-origin.js").ASK_CLASSES} order (see
456
470
  * {@link AskRequest.classes}). Stamped beside {@link askClass}, under the same rule. */
457
471
  classes?: readonly import("./ask-origin.js").AskClass[];
472
+ /** WHO asked about this call and what each said, in its own words — see {@link AskRequest.askReasons}. A STAMP member:
473
+ * the gate writes it where it receives a policy chain's ask ({@link import("./ask-origin.js").chainAskReasonsOf}) and
474
+ * where a hook or an extension asks ({@link import("./ask-origin.js").hookAskReasonOf}); a decision that states it is
475
+ * refused at the receipt. A layer that spreads the ask keeps it. */
476
+ askReasons?: readonly import("./ask-origin.js").AskReason[];
458
477
  /** The call could not be READ against a rule that may reach it — a content-form deny row, a content-form
459
478
  * ask row, a persisted-rule row (the lexer's word), or rows the shell read station's boundary stands on that
460
479
  * could not be read (`persisted_rows`). ENGINE-STAMPED at the four unreadable mint sites;
@@ -633,13 +652,27 @@ export interface ToolPolicy {
633
652
  * name refuses the run, an unmounted one is advised). Carried through {@link combinePolicies} (the union of the
634
653
  * members' groups); read with {@link toolPolicyNameSets}. */
635
654
  readonly nameSets?: readonly ToolPolicyNameSets[];
655
+ /** The tools this policy refuses EVERY call of — its deny rules that name a whole tool (no content: `Tool`, `Tool(*)`, a
656
+ * protocol peer, a covering glob), whatever the call carries: one read of the rules (a policy whose rules move reads them
657
+ * then), and the judge of a tool by every name it answers to. The model's tool table leaves such a tool out; `check` still
658
+ * refuses its calls (the member answers no call). A policy that declares it names only tools its own `check` refuses every
659
+ * call of. Carried through {@link combinePolicies} (a tool any member refuses whole); read with {@link toolPolicyWholeToolRefusals}. */
660
+ readonly wholeToolRefusals?: (signal?: AbortSignal) => Promise<WholeToolRefusal>;
636
661
  }
662
+ /** A tool as a rule names it: its name and the face the roster stamps (every name it answers to). */
663
+ export type ToolIdentity = Pick<ToolCallRequest, "toolName" | "face">;
664
+ /** Whether a policy (or a lane) refuses every call of the tool — the judge one read of its whole-tool deny rules yields. */
665
+ export type WholeToolRefusal = (tool: ToolIdentity) => boolean;
666
+ /** The judge of a policy with no whole-tool deny rule. */
667
+ export declare const REFUSES_NO_WHOLE_TOOL: WholeToolRefusal;
668
+ /** The id a whole-tool judge's read carries — no call of the leg, so every rule reader takes a read of its own for it. */
669
+ export declare const TOOL_TABLE_VIEW_READ = "tool-table-view";
637
670
  /**
638
671
  * The members a policy carries beside `check` — one table for every seat that carries them: {@link wrapToolPolicy} reads
639
672
  * each by name off the wrapped policy, {@link combinePolicies} folds each. The fence makes a new {@link ToolPolicy} member
640
673
  * a compile error until the table names it.
641
674
  */
642
- declare const TOOL_POLICY_CARRIED_MEMBERS: readonly ["projection", "pathRules", "writeGuardRows", "nameSets"];
675
+ declare const TOOL_POLICY_CARRIED_MEMBERS: readonly ["projection", "pathRules", "writeGuardRows", "nameSets", "wholeToolRefusals"];
643
676
  type ToolPolicyCarriedMember = (typeof TOOL_POLICY_CARRIED_MEMBERS)[number];
644
677
  export type ToolPolicyCarriesEveryMember = AssertAllKeysHandled<Exclude<Exclude<keyof ToolPolicy, "check">, ToolPolicyCarriedMember>>;
645
678
  /** The carried members that are set on `p`, each read by name — an accessor or a non-enumerable member included. A
@@ -666,6 +699,10 @@ export declare function toolPolicyPathRules(policies: readonly (ToolPolicy | und
666
699
  * judgment, in member order (a member that throws throws here — the judgment leaves the target unplaced). `undefined`
667
700
  * when none carries any. */
668
701
  export declare function toolPolicyWriteGuardRows(policies: readonly (ToolPolicy | undefined)[]): ToolPolicy["writeGuardRows"];
702
+ /** The whole-tool refusals the given holders carry together (combined policies included): one read of every reading they stand
703
+ * for, side by side, each settled ({@link settledWholeToolRead}) — a reading the fold holds twice (a layer re-appended) once; a
704
+ * tool refused whole when any reading refuses it whole (a deny in the fold refuses the call). `undefined` when none carries any. */
705
+ export declare function toolPolicyWholeToolRefusals(holders: readonly (Pick<ToolPolicy, "wholeToolRefusals"> | undefined)[]): ToolPolicy["wholeToolRefusals"];
669
706
  /**
670
707
  * One deterministic DENY component of a {@link ToolPolicyProjection} (F-012 L1). All fields are plain
671
708
  * serializable data — a component round-trips JSON/`structuredClone` unchanged, which is what lets a
@@ -798,9 +835,9 @@ export type ConstraintChainEntry = ConstraintChainEntryMeta & ({
798
835
  components: readonly ToolPolicyProjectionComponent[];
799
836
  requiresLiveRemainder: boolean;
800
837
  });
801
- /** Project one policy into its chain entry (opaque placeholder when it exports no projection),
802
- * carrying the layer's decision-chain metadata posture for the digest (round 12). */
803
- export declare function constraintChainEntryOf(policy: ToolPolicy, meta?: ConstraintChainEntryMeta): ConstraintChainEntry;
838
+ /** Project one chain entry's policy into its chain entry (opaque placeholder when it exports no projection, and for a
839
+ * screening installation, which has no policy), carrying the layer's decision-chain metadata posture for the digest (round 12). */
840
+ export declare function constraintChainEntryOf(policy: ToolPolicy | undefined, meta?: ConstraintChainEntryMeta): ConstraintChainEntry;
804
841
  /**
805
842
  * One inherited-chain LAYER as both chain-entry mint sites see it — structurally an
806
843
  * `InheritedGate.parentConstraints[]` element, typed here structurally so this module (which owns the
@@ -808,7 +845,8 @@ export declare function constraintChainEntryOf(policy: ToolPolicy, meta?: Constr
808
845
  * state between rounds, so nothing about its health enters a chain entry.
809
846
  */
810
847
  export interface ConstraintChainLayerView {
811
- policy: ToolPolicy;
848
+ /** Absent on a screening installation (projected opaque, as its judgments live on its own bus). */
849
+ policy?: ToolPolicy | undefined;
812
850
  autoMode?: {
813
851
  arming?: unknown;
814
852
  };
@@ -1371,21 +1409,27 @@ export interface AskRequest {
1371
1409
  * durable suspend/checkpoint flow does NOT invoke `onAsk` on the suspend side, so v1 ask-aggregation
1372
1410
  * requires `checkpointStore` unset (design S1d §1.4 P-a). */
1373
1411
  readonly principal?: string;
1374
- /** Runner-filled source-task identity (= the issuing task's session id). An aggregating `onAsk` uses it
1375
- * to tell which worker an ask came from (nested grandchildren each carry their own session id).
1376
- * **worker-unforgeable for Runner-created delegated subagents** (a child never sets sessionId — the
1377
- * Runner mints it); a top-level caller MAY continue its own session id via `TaskSpec.sessionId`, so this
1378
- * is NOT a global "never forgeable" run id — aggregation only aggregates delegated workers, the context
1379
- * where it holds (design S1d §1.3). `readonly` + same sync-path-only / P-a caveat as `principal`.
1380
- * Undefined ⇒ no source task id. **NOT a subagent discriminator** (the HOST's own asks
1381
- * carry it too — it is always the issuing task's session id); "from a background agent" attribution
1382
- * keys on {@link fromSubagent}, never on this field's presence. */
1383
- readonly sourceTaskId?: string;
1412
+ /** Runner-filled: the issuing leg's session id — the conversation the ask was raised in, the address its
1413
+ * transcript and its parked row live at. An aggregating `onAsk` uses it to tell which worker an ask came from
1414
+ * (nested grandchildren each carry their own session). **worker-unforgeable for Runner-created delegated
1415
+ * subagents** (a child never sets sessionId — the Runner mints it); a top-level caller MAY continue its own
1416
+ * session via `TaskSpec.sessionId`, so this is NOT a global "never forgeable" run id — aggregation only
1417
+ * aggregates delegated workers, the context where it holds (design S1d §1.3). Present on every ask the
1418
+ * Runner mints, the host's included. It names a conversation, never a task: the delegated agent that asked
1419
+ * is {@link agentId}. `readonly` + same sync-path-only / P-a caveat as `principal`. */
1420
+ readonly sourceSessionId?: string;
1421
+ /** Runner-filled: the issuing leg's task id when that leg is a DELEGATED CHILD — a background sub-agent's
1422
+ * registry task id (`a…`, the string its row, `TaskStop`, `SendMessage` and `task_notification.task_id` use),
1423
+ * else the leg's own task id (a foreground sub-agent has no registry row: its session id). Present exactly
1424
+ * when {@link isDelegatedChild} is (a fork and a directly-started workflow's agent included — NOT the
1425
+ * {@link fromSubagent} set); absent on a host ask. The same value the leg's extension events carry as
1426
+ * `agentId`, read through the one predicate that mints it there. `readonly`, sync-path-only, S1d posture. */
1427
+ readonly agentId?: string;
1384
1428
  /** design/153 §1 (RB-39②) — Runner-filled: present (`true`) exactly when the gate raising this ask
1385
1429
  * belongs to a DELEGATED SUBAGENT (the prepareTask `isSubagent` fact — trusted `internals.parentTaskId`
1386
1430
  * presence; a child cannot self-declare or suppress it, internals never ride a TaskSpec). Undefined ⇒ the
1387
1431
  * host / a top-level task. THE explicit "from a background agent" discriminator (replaces presence-
1388
- * or equality-heuristics on {@link sourceTaskId}). `readonly`, sync-path-only, S1d posture. */
1432
+ * or equality-heuristics on {@link sourceSessionId}). `readonly`, sync-path-only, S1d posture. */
1389
1433
  readonly fromSubagent?: true;
1390
1434
  /** design/153 §1 — Runner-filled: the issuing task's display identity (a subagent's explicit agent
1391
1435
  * name, else its agent-type; undefined for the host and unnamed children). **UNTRUSTED-for-display**
@@ -1501,6 +1545,15 @@ export interface AskRequest {
1501
1545
  * reads the whole set — a class it will not answer anywhere in it is a question it does not answer. Present exactly
1502
1546
  * when {@link askClass} is. */
1503
1547
  readonly classes?: readonly import("./ask-origin.js").AskClass[];
1548
+ /** WHO asked about this call and what each said, in its OWN words, in fold order ({@link
1549
+ * import("./ask-origin.js").AskReason}): a deployment policy chain's ask sentence, a hook's or an extension's reason, a hook
1550
+ * host's cause word. Present ⇔ at least one asker said something of its own about this call; a generic question (the write
1551
+ * gate's default sentence, the permission mode's own) and a sentence the engine composes about a fact that rides a typed
1552
+ * member of this request are no entry. The structured approval surface renders this member and the typed members beside it,
1553
+ * never {@link message}; `words` is untrusted display text (one line, capped). Filled by the four mint stations from one
1554
+ * reader; the parked row carries the same value (`PendingAction.tool_approval.askReasons`). Never caller/worker-settable:
1555
+ * a policy or hook answer that states it is refused at the decision receipt. */
1556
+ readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
1504
1557
  /** Engine-judged risk axes of the action awaiting approval, for the human decision surface: a
1505
1558
  * coarse `requiresRealApproval` cannot tell "cannot be undone" from "data leaves the machine",
1506
1559
  * and those call for different scrutiny. Filled by the gate from the SAME resolved axes the
@@ -1521,7 +1574,7 @@ export interface AskRequest {
1521
1574
  /** ruled 2026-08-04 — present exactly when this ask was raised inside a DELEGATED child whose approver
1522
1575
  * is the ancestor run's (the `ToolExecuteContext.onAsk` seat the delegation tool forwards). Additive:
1523
1576
  * an approver that ignores it is unaffected; a durable park/suspend flow never invokes `onAsk` at all,
1524
- * so this — like `principal`/`sourceTaskId` — exists only on the synchronous resolution path.
1577
+ * so this — like `principal`/`sourceSessionId` — exists only on the synchronous resolution path.
1525
1578
  * See {@link AskDelegationProvenance} for the trust posture of each member. */
1526
1579
  readonly delegation?: AskDelegationProvenance;
1527
1580
  /**
@@ -1550,7 +1603,7 @@ export interface AskRequest {
1550
1603
  * on the type because a deployment may invoke its approver function directly.
1551
1604
  *
1552
1605
  * SCOPE, stated so absence is not read as a clean bill on the other routes: this is the
1553
- * SYNCHRONOUS `onAsk` ask, like `principal`/`sourceTaskId` — the closure claim is over AskRequest
1606
+ * SYNCHRONOUS `onAsk` ask, like `principal`/`sourceSessionId` — the closure claim is over AskRequest
1554
1607
  * mint sites, not over every approval callback. The other two human-decision routes:
1555
1608
  * ① a durable park/suspend never invokes `onAsk` and never mints an AskRequest — its twin of this
1556
1609
  * bit is the PERSISTED `PendingAction.tool_approval.hasBidiControls` on the parked row (judged at
@@ -1567,6 +1620,8 @@ export interface AskRequest {
1567
1620
  */
1568
1621
  readonly hasBidiControls?: true;
1569
1622
  }
1623
+ /** The issuing leg's identity on a Runner-minted ask: minted once per leg, and every ask, question and park of the leg reads it. */
1624
+ export type AskSourceIdentity = Pick<AskRequest, "principal" | "sourceSessionId" | "agentId" | "fromSubagent" | "sourceAgentName" | "isDelegatedChild">;
1570
1625
  /**
1571
1626
  * How an `ask` decision is resolved when a policy/hook requests human confirmation (design/37):
1572
1627
  * - `"deny"` (and the default when omitted) — **headless auto-deny**: no approver, so `ask` resolves
@@ -1677,6 +1732,15 @@ export type OnAsk = "deny" | "allow" | ((req: AskRequest, signal?: AbortSignal)
1677
1732
  * produced (an abort, a throw, an unclonable edit): nobody approved those. A host's own elapsed window has
1678
1733
  * no attribution seat on its record (`approval_window_expired` names the host as a party, not a seat).
1679
1734
  *
1735
+ * `decidedVia` — WHICH MACHINE SEAT answered for `settledBy: "policy"`, a closed word
1736
+ * ({@link import("./gate-outcome.js").DECIDED_VIA}; the durable leg's `hostDecision.decidedVia` is the same word):
1737
+ * `"policy"` (the deployment's own policy; ABSENT reads the same) or `"permission_request_hook"` (a PermissionRequest
1738
+ * hook answered on the deployment's behalf). It picks the refusal SENTENCE ({@link policyRefusalMessage}) — a
1739
+ * hook's "no" is not "this run has no interactive approval channel" — and leaves the record as it is
1740
+ * (`policy_refused` / `policy_allowed`). Not `approver`: that seat is a transcription core never reads back; this one
1741
+ * is the closed word core reads. Read once with the other members; a value outside the closed set, or the member beside
1742
+ * any word but `"policy"` (a person, an elapsed window), is a loud fail-closed refusal at {@link resolveAsk}.
1743
+ *
1680
1744
  * `readRootGrant` — "yes, and add this directory": the card's {@link AskRequest.readRootCandidate} `dir`, sent back
1681
1745
  * byte for byte (`shell.read_boundary.grant_candidate_is_the_grant`). Beside `allow: true` on an ask carrying that
1682
1746
  * candidate, THIS run's read directories include it from then on (read faces only; `covers: "exact"` = that one
@@ -1690,6 +1754,7 @@ export type AskOutcome = boolean | "unavailable" | {
1690
1754
  settledBy?: "human" | "timeout" | "policy";
1691
1755
  reason?: string;
1692
1756
  approver?: string;
1757
+ decidedVia?: DecidedVia;
1693
1758
  readRootGrant?: string;
1694
1759
  };
1695
1760
  /**
@@ -1790,12 +1855,30 @@ export declare function tryCloneArgs<T>(v: T): {
1790
1855
  * exit reports (`finalInput`, the deny observer's `input`); a deny already carrying the args its own layers judged (a composed
1791
1856
  * chain's, nested ones included) keeps them. Read by the gate's lanes and by {@link combinePolicies}. Only a deny is changed. */
1792
1857
  export declare function refusalOf<D extends PermissionResult>(deny: D, judged: unknown): D;
1858
+ /** Who spoke an extension's verdict on a call, as a gate sentence names it (`extension "<registration>"`, else "an
1859
+ * extension"), and the reason it gave (`: <reason>`, else nothing) — read by every sentence about an extension's verdict,
1860
+ * a `tool.check` answer's and a `classic.PreToolUse` answer's alike. */
1861
+ export declare function extensionSpeaker(by: string | undefined, reason: string | undefined): {
1862
+ readonly who: string;
1863
+ readonly why: string;
1864
+ };
1865
+ /** `extension "<registration>"` — the registration's name as a quoted string, so a name can never end its own quotes and run on
1866
+ * into the sentence around it. A registered name has one form (`MOD_REGISTRATION_NAME`, the kernel's screen) and this reads
1867
+ * identically to it; the quoting is the second line, for a name no screen has judged here (one carried in from elsewhere). */
1868
+ export declare function extensionNamed(registration: string): string;
1869
+ /** An extension's own question about a call, as the text a reader of `message` reads it: which extension asks, and why — read
1870
+ * off the question's ONE entry ({@link import("./ask-origin.js").hookAskReasonOf}), so the sentence and the entry are one value.
1871
+ * The one sentence an ask raised by an extension carries, whichever event raised it (`tool.check`, `classic.PreToolUse`); when
1872
+ * the hook's host asks because the hook gave no verdict it could act on, the sentence says that instead of quoting anyone. */
1873
+ export declare function extensionQuestionText(toolName: string, entry: Extract<import("./ask-origin.js").AskReason, {
1874
+ by: "hook";
1875
+ }>): string;
1793
1876
  /**
1794
1877
  * A PreToolUse hook's `ask` folded over a verdict by `deny > ask > allow` — the ONE law for the gate's first screening and for
1795
1878
  * an approved edit's re-screen. A deny stands. Over an allow, the hook's own ask, RECONSTRUCTED rather than spread (its message,
1796
- * its real-approval demand and cross-boundary member, its rewrite) under the hook provenance the engine stamps. Over an ask, that ask keeps every member,
1879
+ * its real-approval demand and cross-boundary member, its rewrite, its askers' entries) under the hook provenance the engine stamps. Over an ask, that ask keeps every member,
1797
1880
  * takes the hook provenance and the hook's real-approval demand and cross-boundary member, and its message carries the hook's beside its own — a person
1798
- * clearing one ask that stands for two gates sees both reasons.
1881
+ * clearing one ask that stands for two gates sees both reasons: its `askReasons` are the standing ask's entries, then the hook's.
1799
1882
  */
1800
1883
  export declare function foldHookAsk(verdict: Exclude<PermissionResult, {
1801
1884
  action: "deny";
@@ -1897,8 +1980,16 @@ export declare function humanRefusalSentence(subject: HumanRefusalSubject, reaso
1897
1980
  * as the user's guidance, because no user gave it. `askMessage` is the ask's own prompt where the caller
1898
1981
  * has one (the synchronous leg does); a durable decide answers a call parked in an earlier leg and has
1899
1982
  * none, and the head then simply names the call.
1983
+ *
1984
+ * WHICH MACHINE SEAT answered (`decidedVia`, read through {@link policyDeciderOf}) picks between two sentences
1985
+ * and nothing else. The deployment's own policy (the word, or its absence) gets the sentence above. Any other seat
1986
+ * DID answer, so "this run has no interactive approval channel" would be false about it: the head names the seat
1987
+ * that declined (`a PermissionRequest hook denied this call`), and the seat's own words ride the fence under its
1988
+ * label. The fence is a deliberate divergence from the reference, which hands a hook's message to the model as the
1989
+ * refusal text itself (`iPt` (cli309.js:288208), `runHooks` (cli309.js:295883)): here every decider's free text is
1990
+ * untrusted data and reaches the model only fenced, whoever typed it.
1900
1991
  */
1901
- export declare function policyRefusalMessage(toolName: string, askMessage: string | undefined, note: string | undefined): string;
1992
+ export declare function policyRefusalMessage(toolName: string, askMessage: string | undefined, note: string | undefined, decidedVia: DecidedVia | undefined): string;
1902
1993
  /**
1903
1994
  * A {@link resolveAsk} result: always a TERMINAL `allow`/`deny` (never `ask`). `approverUnavailable`
1904
1995
  * is the out-of-band G1 three-value marker: the live approver returned `"unavailable"` for this ask —