@sema-agent/core 7.60.0 → 7.62.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 (560) hide show
  1. package/CHANGELOG.md +917 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +71 -12
  6. package/dist/agents/cascade.js +61 -21
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-held-queue.d.ts +27 -4
  17. package/dist/agents/peer-held-queue.js +81 -36
  18. package/dist/agents/peer-notice-route.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.js +4 -3
  20. package/dist/agents/peer-notices.d.ts +4 -4
  21. package/dist/agents/peer-notices.js +8 -4
  22. package/dist/agents/peer-session-drain.d.ts +8 -1
  23. package/dist/agents/peer-session-drain.js +49 -10
  24. package/dist/agents/repair-loop.js +16 -6
  25. package/dist/agents/retain-ledger.js +3 -1
  26. package/dist/agents/roster-store.d.ts +1 -1
  27. package/dist/agents/roster-store.js +7 -4
  28. package/dist/agents/send-message-tool.d.ts +8 -10
  29. package/dist/agents/send-message-tool.js +43 -23
  30. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  31. package/dist/agents/subagent-completion-gate.js +62 -0
  32. package/dist/agents/subagent-steps.d.ts +7 -6
  33. package/dist/agents/subagent.d.ts +36 -41
  34. package/dist/agents/subagent.js +245 -200
  35. package/dist/agents/suspend-guard.d.ts +47 -16
  36. package/dist/agents/suspend-guard.js +13 -4
  37. package/dist/agents/verify.d.ts +41 -14
  38. package/dist/agents/verify.js +41 -30
  39. package/dist/brain/anthropic.js +1 -0
  40. package/dist/brain/errors.d.ts +7 -1
  41. package/dist/brain/errors.js +6 -0
  42. package/dist/brain/failover.js +2 -1
  43. package/dist/brain/open-responses.js +1 -0
  44. package/dist/brain/openai.js +1 -0
  45. package/dist/brain/provider-dialect.d.ts +10 -0
  46. package/dist/brain/provider-dialect.js +13 -2
  47. package/dist/brain/stream-engine.d.ts +3 -0
  48. package/dist/brain/stream-engine.js +4 -0
  49. package/dist/core/agent-state.d.ts +1 -1
  50. package/dist/core/allow-entry.d.ts +59 -23
  51. package/dist/core/allow-entry.js +131 -38
  52. package/dist/core/ask-origin.d.ts +79 -0
  53. package/dist/core/ask-origin.js +76 -0
  54. package/dist/core/ask-question.d.ts +19 -13
  55. package/dist/core/ask-question.js +8 -2
  56. package/dist/core/auto-compaction.d.ts +2 -0
  57. package/dist/core/auto-compaction.js +2 -1
  58. package/dist/core/auto-mode.js +3 -5
  59. package/dist/core/background-agent-store.d.ts +7 -5
  60. package/dist/core/background-agent-store.js +12 -11
  61. package/dist/core/checkpoint-features.d.ts +722 -0
  62. package/dist/core/checkpoint-features.js +98 -0
  63. package/dist/core/checkpoint-requirements.d.ts +33 -5
  64. package/dist/core/checkpoint-requirements.js +18 -5
  65. package/dist/core/checkpoint-row-verdict.d.ts +99 -0
  66. package/dist/core/checkpoint-row-verdict.js +225 -0
  67. package/dist/core/checkpoint-store.d.ts +107 -738
  68. package/dist/core/checkpoint-store.js +45 -143
  69. package/dist/core/child-clamp-seats.d.ts +3 -2
  70. package/dist/core/child-clamp-seats.js +4 -3
  71. package/dist/core/closest-name.d.ts +13 -0
  72. package/dist/core/closest-name.js +35 -0
  73. package/dist/core/context-settings.js +3 -5
  74. package/dist/core/cross-boundary-taint.d.ts +1 -1
  75. package/dist/core/decision-receipt.d.ts +14 -1
  76. package/dist/core/decision-receipt.js +6 -3
  77. package/dist/core/delegation-frames.d.ts +13 -9
  78. package/dist/core/effective-path-target.js +2 -3
  79. package/dist/core/engine-attestation.d.ts +11 -1
  80. package/dist/core/engine-attestation.js +2 -0
  81. package/dist/core/engine-notice.d.ts +68 -21
  82. package/dist/core/engine-notice.js +9 -2
  83. package/dist/core/file-history-retention.d.ts +8 -0
  84. package/dist/core/file-history-retention.js +14 -11
  85. package/dist/core/file-history-store.d.ts +31 -1
  86. package/dist/core/file-history-store.js +31 -2
  87. package/dist/core/frame-settlement.d.ts +10 -0
  88. package/dist/core/frame-settlement.js +6 -1
  89. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  90. package/dist/core/fs-write-gate-policy.js +8 -7
  91. package/dist/core/gate-fold.js +4 -3
  92. package/dist/core/gate-lanes.js +7 -4
  93. package/dist/core/gate-outcome.d.ts +40 -1
  94. package/dist/core/gate-outcome.js +10 -0
  95. package/dist/core/git-worktree-env.d.ts +7 -3
  96. package/dist/core/git-worktree-env.js +16 -13
  97. package/dist/core/governance-codes.d.ts +14 -4
  98. package/dist/core/governance-codes.js +19 -4
  99. package/dist/core/hooks.d.ts +25 -4
  100. package/dist/core/hooks.js +11 -4
  101. package/dist/core/host-floor.js +3 -5
  102. package/dist/core/human-input-projection.d.ts +1 -0
  103. package/dist/core/human-input-projection.js +3 -0
  104. package/dist/core/image-admission.d.ts +47 -7
  105. package/dist/core/image-admission.js +35 -4
  106. package/dist/core/input-author.d.ts +36 -0
  107. package/dist/core/input-author.js +39 -0
  108. package/dist/core/leg-identity.d.ts +62 -0
  109. package/dist/core/leg-identity.js +18 -0
  110. package/dist/core/locked-config.d.ts +4 -3
  111. package/dist/core/locked-config.js +5 -3
  112. package/dist/core/lsp.d.ts +5 -3
  113. package/dist/core/lsp.js +3 -2
  114. package/dist/core/mailbox-store.d.ts +85 -10
  115. package/dist/core/mailbox-store.js +31 -10
  116. package/dist/core/mcp-connection-pool.d.ts +6 -20
  117. package/dist/core/mcp-connection-pool.js +10 -28
  118. package/dist/core/mcp-failure.d.ts +76 -15
  119. package/dist/core/mcp-failure.js +60 -33
  120. package/dist/core/mcp-host-seat.d.ts +92 -53
  121. package/dist/core/mcp-host-seat.js +225 -46
  122. package/dist/core/mcp-probe.js +2 -2
  123. package/dist/core/mcp-server-link.d.ts +18 -6
  124. package/dist/core/mcp-server-link.js +19 -4
  125. package/dist/core/mcp-server-spec.d.ts +2 -1
  126. package/dist/core/mcp-session-end.d.ts +1 -2
  127. package/dist/core/mcp-session-end.js +1 -1
  128. package/dist/core/mcp.d.ts +6 -49
  129. package/dist/core/mcp.js +115 -111
  130. package/dist/core/media-byte-cap.d.ts +21 -46
  131. package/dist/core/media-byte-cap.js +55 -55
  132. package/dist/core/member-group.d.ts +7 -0
  133. package/dist/core/member-group.js +35 -0
  134. package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
  135. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  136. package/dist/core/memory-engine/consolidation.js +7 -1
  137. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  138. package/dist/core/memory-engine/dual-root.js +59 -11
  139. package/dist/core/memory-engine/engine.js +27 -24
  140. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  141. package/dist/core/memory-engine/file-backend.js +35 -15
  142. package/dist/core/memory-engine/layout.d.ts +3 -0
  143. package/dist/core/memory-engine/layout.js +13 -3
  144. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  145. package/dist/core/memory-engine/memory-deployment.js +182 -0
  146. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  147. package/dist/core/memory-engine/sync-client.js +72 -14
  148. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  149. package/dist/core/memory-engine/sync.d.ts +9 -1
  150. package/dist/core/memory-vector.d.ts +1 -1
  151. package/dist/core/memory.d.ts +10 -10
  152. package/dist/core/mode-policy.d.ts +8 -8
  153. package/dist/core/mode-policy.js +8 -6
  154. package/dist/core/mods/agent-stations.d.ts +39 -4
  155. package/dist/core/mods/agent-stations.js +59 -10
  156. package/dist/core/mods/classic-events.d.ts +9 -1
  157. package/dist/core/mods/dollar.d.ts +94 -1
  158. package/dist/core/mods/dollar.js +13 -1
  159. package/dist/core/mods/extension-call.d.ts +15 -1
  160. package/dist/core/mods/extension-call.js +7 -2
  161. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  162. package/dist/core/mods/kernel/dispatch.js +4 -4
  163. package/dist/core/mods/kernel/events.d.ts +14 -3
  164. package/dist/core/mods/kernel/events.js +18 -15
  165. package/dist/core/mods/kernel/registration.d.ts +3 -0
  166. package/dist/core/mods/kernel/registration.js +5 -0
  167. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  168. package/dist/core/mods/kernel/site-rules.js +10 -2
  169. package/dist/core/mods/lifecycle-stations.d.ts +36 -4
  170. package/dist/core/mods/lifecycle-stations.js +44 -9
  171. package/dist/core/mods/session-append.d.ts +118 -0
  172. package/dist/core/mods/session-append.js +318 -0
  173. package/dist/core/mods/session-compact.d.ts +48 -0
  174. package/dist/core/mods/session-compact.js +194 -0
  175. package/dist/core/mods/session-receive.d.ts +93 -0
  176. package/dist/core/mods/session-receive.js +138 -0
  177. package/dist/core/mods/session-send.d.ts +72 -0
  178. package/dist/core/mods/session-send.js +88 -0
  179. package/dist/core/mods/stations.d.ts +88 -21
  180. package/dist/core/mods/stations.js +149 -11
  181. package/dist/core/mods/tool-call.d.ts +2 -0
  182. package/dist/core/mods/tool-call.js +4 -4
  183. package/dist/core/output-style.js +3 -4
  184. package/dist/core/own-property-receipt.d.ts +68 -2
  185. package/dist/core/own-property-receipt.js +45 -2
  186. package/dist/core/park-selfcheck.js +4 -2
  187. package/dist/core/path-identity.d.ts +11 -0
  188. package/dist/core/path-identity.js +4 -0
  189. package/dist/core/path-rule-binding.d.ts +3 -1
  190. package/dist/core/path-rule-binding.js +3 -1
  191. package/dist/core/peer-seat.d.ts +3 -3
  192. package/dist/core/peer-seat.js +20 -8
  193. package/dist/core/permission-rule-consent.d.ts +21 -5
  194. package/dist/core/permission-rule-consent.js +21 -1
  195. package/dist/core/permission-rule-model.d.ts +34 -11
  196. package/dist/core/permission-rule-model.js +47 -10
  197. package/dist/core/permission-rule-org.d.ts +1 -1
  198. package/dist/core/permission-rule-provider.js +4 -1
  199. package/dist/core/permission-rules.d.ts +4 -0
  200. package/dist/core/permission-rules.js +11 -16
  201. package/dist/core/read-root-candidate.js +1 -1
  202. package/dist/core/remote-env.d.ts +74 -26
  203. package/dist/core/remote-env.js +20 -0
  204. package/dist/core/resume-startup-cause.d.ts +5 -4
  205. package/dist/core/retention-policy.d.ts +24 -23
  206. package/dist/core/retention-policy.js +36 -2
  207. package/dist/core/retention.d.ts +4 -1
  208. package/dist/core/retired-keys.d.ts +4 -4
  209. package/dist/core/row-admission.d.ts +10 -0
  210. package/dist/core/row-admission.js +5 -0
  211. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  212. package/dist/core/runner/advisor-instructions.js +2 -1
  213. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  214. package/dist/core/runner/assemble-result.d.ts +13 -3
  215. package/dist/core/runner/assemble-result.js +12 -7
  216. package/dist/core/runner/caller-roster.d.ts +12 -9
  217. package/dist/core/runner/caller-roster.js +5 -2
  218. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  219. package/dist/core/runner/checkpoint-scope.js +21 -0
  220. package/dist/core/runner/compact-session.js +18 -3
  221. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  222. package/dist/core/runner/compaction-restate.d.ts +2 -2
  223. package/dist/core/runner/compaction-restate.js +4 -3
  224. package/dist/core/runner/construction-doors.d.ts +2 -2
  225. package/dist/core/runner/construction-doors.js +2 -2
  226. package/dist/core/runner/contracts.d.ts +116 -34
  227. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  228. package/dist/core/runner/decide-continuation.d.ts +4 -2
  229. package/dist/core/runner/decide-continuation.js +7 -4
  230. package/dist/core/runner/delegation-owner.d.ts +43 -0
  231. package/dist/core/runner/delegation-owner.js +59 -0
  232. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  233. package/dist/core/runner/denial-limit-arms.js +17 -10
  234. package/dist/core/runner/expire-settle.d.ts +44 -0
  235. package/dist/core/runner/expire-settle.js +55 -0
  236. package/dist/core/runner/git-status-frame.d.ts +3 -3
  237. package/dist/core/runner/git-status-frame.js +2 -1
  238. package/dist/core/runner/halt-attribution.d.ts +2 -1
  239. package/dist/core/runner/halt-attribution.js +2 -1
  240. package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
  241. package/dist/core/runner/lineage-reroot-view.js +108 -0
  242. package/dist/core/runner/local-claims.d.ts +17 -0
  243. package/dist/core/runner/local-claims.js +18 -0
  244. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  245. package/dist/core/runner/media-removed-seat.js +88 -0
  246. package/dist/core/runner/park-commit.d.ts +2 -2
  247. package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
  248. package/dist/core/runner/permission-rule-lanes.js +28 -9
  249. package/dist/core/runner/person-path-rows.d.ts +15 -0
  250. package/dist/core/runner/person-path-rows.js +27 -4
  251. package/dist/core/runner/placement-fence.d.ts +26 -0
  252. package/dist/core/runner/placement-fence.js +38 -0
  253. package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
  254. package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
  255. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  256. package/dist/core/runner/prepare-ask-lane.js +4 -4
  257. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  258. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  259. package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
  260. package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
  261. package/dist/core/runner/prepare-config-doors.d.ts +6 -6
  262. package/dist/core/runner/prepare-config-doors.js +19 -21
  263. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  264. package/dist/core/runner/prepare-context-lane.js +13 -13
  265. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  266. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  267. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  268. package/dist/core/runner/prepare-execution-env.js +7 -4
  269. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  270. package/dist/core/runner/prepare-gate-stations.js +6 -4
  271. package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
  272. package/dist/core/runner/prepare-hands-readface.js +32 -11
  273. package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
  274. package/dist/core/runner/prepare-inherited-gate.js +10 -3
  275. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  276. package/dist/core/runner/prepare-lsp.js +2 -2
  277. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  278. package/dist/core/runner/prepare-park-ask.js +4 -5
  279. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  280. package/dist/core/runner/prepare-policy-chain.js +16 -25
  281. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  282. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  283. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  284. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  285. package/dist/core/runner/prepare-question-face.js +2 -2
  286. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  287. package/dist/core/runner/prepare-run-refs.js +2 -2
  288. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  289. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  290. package/dist/core/runner/prepare-task.d.ts +1 -1
  291. package/dist/core/runner/prepare-task.js +61 -30
  292. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  293. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  294. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  295. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  296. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  297. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  298. package/dist/core/runner/read-root-grant.d.ts +1 -1
  299. package/dist/core/runner/read-root-grant.js +2 -1
  300. package/dist/core/runner/resume-admission.d.ts +8 -6
  301. package/dist/core/runner/resume-admission.js +23 -6
  302. package/dist/core/runner/resume-apply.d.ts +4 -0
  303. package/dist/core/runner/resume-apply.js +14 -5
  304. package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
  305. package/dist/core/runner/resume-checkpoint-screen.js +4 -84
  306. package/dist/core/runner/resume-claim.d.ts +8 -3
  307. package/dist/core/runner/resume-claim.js +28 -12
  308. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  309. package/dist/core/runner/resume-internals-and-config.js +10 -1
  310. package/dist/core/runner/resume-preflight.d.ts +3 -2
  311. package/dist/core/runner/resume-preflight.js +13 -26
  312. package/dist/core/runner/retired-runner-deps.js +2 -0
  313. package/dist/core/runner/run-git-lane.d.ts +2 -0
  314. package/dist/core/runner/run-git-lane.js +6 -2
  315. package/dist/core/runner/run-harness-handlers.d.ts +2 -0
  316. package/dist/core/runner/run-harness-handlers.js +5 -4
  317. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  318. package/dist/core/runner/run-identity-wiring.js +14 -5
  319. package/dist/core/runner/run-leg.d.ts +3 -3
  320. package/dist/core/runner/run-leg.js +64 -36
  321. package/dist/core/runner/run-notification-lane.js +20 -2
  322. package/dist/core/runner/run-recovery-lanes.js +3 -2
  323. package/dist/core/runner/run-settle-and-teardown.js +12 -9
  324. package/dist/core/runner/run-stop-and-final-verify.js +2 -1
  325. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  326. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  327. package/dist/core/runner/run-terminal-adoption.js +26 -17
  328. package/dist/core/runner/run-turn-boundary.js +34 -18
  329. package/dist/core/runner/runtask.d.ts +18 -3
  330. package/dist/core/runner/runtask.js +33 -17
  331. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  332. package/dist/core/runner/session-rule-policy.js +6 -1
  333. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  334. package/dist/core/runner/steering-preview.d.ts +9 -0
  335. package/dist/core/runner/steering-preview.js +5 -0
  336. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  337. package/dist/core/runner/stream-halt-verbs.js +4 -3
  338. package/dist/core/runner/stream-reap.d.ts +7 -6
  339. package/dist/core/runner/stream-reap.js +13 -16
  340. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  341. package/dist/core/runner/stream-settle-backstop.js +5 -3
  342. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  343. package/dist/core/runner/stream-steer-verb.js +16 -7
  344. package/dist/core/runner/terminal-account.d.ts +11 -1
  345. package/dist/core/runner/terminal-account.js +20 -0
  346. package/dist/core/runner/terminal-projection.d.ts +8 -2
  347. package/dist/core/runner/terminal-projection.js +2 -2
  348. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  349. package/dist/core/runner/tool-disclosure.js +5 -2
  350. package/dist/core/runner/tool-end-body.d.ts +3 -3
  351. package/dist/core/runner/tool-end-body.js +1 -1
  352. package/dist/core/runner/tool-face-overlay.js +2 -0
  353. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  354. package/dist/core/runner/tool-output-projection.js +7 -6
  355. package/dist/core/runner/tool-table-view.d.ts +56 -0
  356. package/dist/core/runner/tool-table-view.js +51 -0
  357. package/dist/core/runner/turn-attachments.d.ts +8 -2
  358. package/dist/core/runner/turn-attachments.js +2 -2
  359. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  360. package/dist/core/runner/void-verifier-pause.js +41 -0
  361. package/dist/core/runner-deps.d.ts +26 -27
  362. package/dist/core/secret-env.d.ts +19 -16
  363. package/dist/core/secret-env.js +45 -27
  364. package/dist/core/session-log-transfer.js +9 -10
  365. package/dist/core/session-policy-store.d.ts +1 -1
  366. package/dist/core/session-policy-store.js +5 -2
  367. package/dist/core/session-reconcile.d.ts +3 -2
  368. package/dist/core/session-reconcile.js +7 -4
  369. package/dist/core/session-store.d.ts +3 -1
  370. package/dist/core/session-store.js +10 -8
  371. package/dist/core/session.d.ts +16 -5
  372. package/dist/core/shell-confinement.d.ts +37 -0
  373. package/dist/core/shell-confinement.js +56 -0
  374. package/dist/core/skill-grant.js +1 -1
  375. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
  376. package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
  377. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  378. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  379. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  380. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  381. package/dist/core/store-contracts/session-store-contract.js +22 -8
  382. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  383. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  384. package/dist/core/task-event.d.ts +24 -9
  385. package/dist/core/task-limits.d.ts +5 -0
  386. package/dist/core/task-notification.d.ts +89 -12
  387. package/dist/core/task-notification.js +89 -14
  388. package/dist/core/task-registry-agent.d.ts +32 -50
  389. package/dist/core/task-registry-agent.js +36 -56
  390. package/dist/core/task-registry-monitor.d.ts +1 -1
  391. package/dist/core/task-registry-monitor.js +15 -60
  392. package/dist/core/task-registry-shared.d.ts +22 -112
  393. package/dist/core/task-registry-shared.js +3 -41
  394. package/dist/core/task-registry-workflow.js +5 -21
  395. package/dist/core/task-registry.d.ts +32 -62
  396. package/dist/core/task-registry.js +30 -110
  397. package/dist/core/task-result.d.ts +29 -12
  398. package/dist/core/task-spec-members.d.ts +39 -0
  399. package/dist/core/task-spec-members.js +92 -0
  400. package/dist/core/task-spec.d.ts +11 -11
  401. package/dist/core/task-tool-shape.d.ts +7 -57
  402. package/dist/core/task-tool-shape.js +7 -66
  403. package/dist/core/terminal-cause.d.ts +36 -6
  404. package/dist/core/terminal-cause.js +1 -0
  405. package/dist/core/tool-catalog-entries.js +2 -5
  406. package/dist/core/tool-check-reading.js +16 -10
  407. package/dist/core/tool-conformance.js +1 -2
  408. package/dist/core/tool-errors.d.ts +6 -3
  409. package/dist/core/tool-errors.js +2 -0
  410. package/dist/core/tool-face-reader.js +3 -2
  411. package/dist/core/tool-face.d.ts +8 -5
  412. package/dist/core/tool-face.js +1 -1
  413. package/dist/core/tool-name-aliases.d.ts +5 -29
  414. package/dist/core/tool-name-aliases.js +9 -5
  415. package/dist/core/tool-name-readings.d.ts +14 -3
  416. package/dist/core/tool-name-readings.js +2 -0
  417. package/dist/core/tool-policy.d.ts +109 -18
  418. package/dist/core/tool-policy.js +84 -14
  419. package/dist/core/tool-result-store.d.ts +23 -0
  420. package/dist/core/tool-result-store.js +3 -2
  421. package/dist/core/tool-roster.d.ts +4 -4
  422. package/dist/core/tool-spec.d.ts +23 -6
  423. package/dist/core/trace.d.ts +18 -1
  424. package/dist/core/types.d.ts +1 -1
  425. package/dist/core/types.js +1 -1
  426. package/dist/core/user-attachment.js +26 -21
  427. package/dist/core/workflow-journal-store.d.ts +1 -1
  428. package/dist/core/workflow-run-store.d.ts +2 -0
  429. package/dist/core/workflow-run-store.js +6 -5
  430. package/dist/core/workflow-settled-run.d.ts +5 -0
  431. package/dist/core/workflow-settled-run.js +7 -0
  432. package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
  433. package/dist/engine/execution-env/node-execution-env.js +221 -22
  434. package/dist/engine/harness/agent-harness.d.ts +65 -18
  435. package/dist/engine/harness/agent-harness.js +90 -23
  436. package/dist/engine/harness/messages.d.ts +4 -3
  437. package/dist/engine/harness/messages.js +2 -2
  438. package/dist/engine/harness/types.d.ts +52 -7
  439. package/dist/engine/llm/media-removed.d.ts +14 -0
  440. package/dist/engine/llm/media-removed.js +9 -0
  441. package/dist/engine/llm/rejected-images.d.ts +35 -25
  442. package/dist/engine/llm/rejected-images.js +59 -10
  443. package/dist/engine/llm/types.d.ts +24 -3
  444. package/dist/engine/llm/types.js +7 -3
  445. package/dist/engine/loop/agent-loop.d.ts +6 -1
  446. package/dist/engine/loop/agent-loop.js +20 -11
  447. package/dist/engine/loop/types.d.ts +12 -3
  448. package/dist/engine/session/import-validate.js +7 -0
  449. package/dist/engine/session/parent-chain-guard.d.ts +3 -3
  450. package/dist/engine/session/parent-chain-guard.js +1 -1
  451. package/dist/engine/session/path-to-root.d.ts +18 -3
  452. package/dist/engine/session/path-to-root.js +15 -1
  453. package/dist/engine/session/repo-utils.d.ts +12 -1
  454. package/dist/engine/session/repo-utils.js +41 -0
  455. package/dist/engine/session/session.js +1 -1
  456. package/dist/engine/session/storage-base.d.ts +20 -0
  457. package/dist/engine/session/storage-base.js +28 -9
  458. package/dist/fixtures/index.d.ts +7 -5
  459. package/dist/fixtures/index.js +5 -3
  460. package/dist/index.d.ts +29 -18
  461. package/dist/index.js +19 -11
  462. package/dist/internal/harness-types.d.ts +2 -0
  463. package/dist/internal/harness.d.ts +4 -3
  464. package/dist/internal/harness.js +3 -2
  465. package/dist/internal/llm.d.ts +2 -1
  466. package/dist/internal/llm.js +1 -0
  467. package/dist/orchestration/goal.d.ts +6 -2
  468. package/dist/orchestration/goal.js +6 -3
  469. package/dist/orchestration/run-workflow-tool.d.ts +14 -17
  470. package/dist/orchestration/run-workflow-tool.js +43 -50
  471. package/dist/orchestration/workflow-types.d.ts +2 -2
  472. package/dist/orchestration/workflow.d.ts +7 -0
  473. package/dist/orchestration/workflow.js +10 -12
  474. package/dist/stores/file/background-agent-store.js +18 -15
  475. package/dist/stores/file/checkpoint-store.d.ts +2 -0
  476. package/dist/stores/file/checkpoint-store.js +13 -9
  477. package/dist/stores/file/file-history-store.js +3 -2
  478. package/dist/stores/file/fs-atomic.d.ts +0 -22
  479. package/dist/stores/file/fs-atomic.js +0 -17
  480. package/dist/stores/file/index.d.ts +7 -12
  481. package/dist/stores/file/index.js +25 -12
  482. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  483. package/dist/stores/file/ledger-tuning.js +21 -0
  484. package/dist/stores/file/mailbox-store.js +42 -22
  485. package/dist/stores/file/memory-store.js +3 -2
  486. package/dist/stores/file/permission-rule-adopt.js +24 -21
  487. package/dist/stores/file/permission-rule-store.js +6 -3
  488. package/dist/stores/file/session-policy-store.js +3 -2
  489. package/dist/stores/file/session-store.d.ts +26 -7
  490. package/dist/stores/file/session-store.js +59 -35
  491. package/dist/stores/file/tool-result-store.d.ts +11 -0
  492. package/dist/stores/file/tool-result-store.js +57 -3
  493. package/dist/stores/file/usage-window-store.js +3 -2
  494. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  495. package/dist/stores/file/workflow-journal-store.js +3 -18
  496. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  497. package/dist/stores/file/workflow-run-store.js +15 -10
  498. package/dist/tools/fs/bash-program-position.d.ts +3 -2
  499. package/dist/tools/fs/bash-program-position.js +7 -7
  500. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  501. package/dist/tools/fs/dead-cwd.js +4 -11
  502. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  503. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  504. package/dist/tools/fs/fs-bash.d.ts +3 -18
  505. package/dist/tools/fs/fs-bash.js +37 -124
  506. package/dist/tools/fs/fs-pdf.js +8 -6
  507. package/dist/tools/fs/fs-read.js +2 -2
  508. package/dist/tools/fs/fs-shared.d.ts +28 -3
  509. package/dist/tools/fs/fs-shared.js +15 -0
  510. package/dist/tools/fs/index.d.ts +1 -1
  511. package/dist/tools/fs/index.js +4 -14
  512. package/dist/tools/fs/pdf.d.ts +4 -4
  513. package/dist/tools/fs/pdf.js +6 -6
  514. package/dist/tools/fs/read-deny-home.js +8 -1
  515. package/dist/tools/fs/read-deny.d.ts +26 -2
  516. package/dist/tools/fs/read-deny.js +9 -2
  517. package/dist/tools/fs/read-floor.d.ts +13 -5
  518. package/dist/tools/fs/read-floor.js +206 -2
  519. package/dist/tools/fs/removal-targets.js +2 -2
  520. package/dist/tools/fs/search.d.ts +3 -2
  521. package/dist/tools/fs/search.js +6 -6
  522. package/dist/tools/fs/shell-read-argv.d.ts +4 -2
  523. package/dist/tools/fs/shell-read-argv.js +14 -3
  524. package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
  525. package/dist/tools/fs/shell-read-bindings.js +148 -68
  526. package/dist/tools/fs/shell-read-check.js +20 -4
  527. package/dist/tools/fs/shell-read-establish.js +25 -9
  528. package/dist/tools/fs/shell-read-functions.js +2 -2
  529. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  530. package/dist/tools/fs/shell-read-identity.js +4 -2
  531. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  532. package/dist/tools/fs/shell-read-judge.js +1 -1
  533. package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
  534. package/dist/tools/fs/shell-read-object-path.js +119 -0
  535. package/dist/tools/fs/shell-read-plan.d.ts +8 -0
  536. package/dist/tools/fs/shell-read-plan.js +47 -30
  537. package/dist/tools/fs/shell-read-start.d.ts +66 -13
  538. package/dist/tools/fs/shell-read-start.js +89 -17
  539. package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
  540. package/dist/tools/fs/shell-read-workdir.js +31 -8
  541. package/dist/tools/monitor.d.ts +8 -7
  542. package/dist/tools/monitor.js +12 -10
  543. package/dist/tools/worktree.d.ts +5 -1
  544. package/dist/tools/worktree.js +20 -17
  545. package/package.json +6 -3
  546. package/test/export-surface.snapshot.json +112 -42
  547. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  548. package/wire-changes/core-stores-sql@7.62.0.json +30 -0
  549. package/wire-changes/core@7.61.0.json +4405 -0
  550. package/wire-changes/core@7.62.0.json +2181 -0
  551. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  552. package/wire-changes/mods-kernel@7.62.0.json +42 -0
  553. package/wire-changes/primitives@7.61.0.json +30 -0
  554. package/wire-changes/primitives@7.62.0.json +30 -0
  555. package/dist/core/consolidate-scope.d.ts +0 -93
  556. package/dist/core/consolidate-scope.js +0 -98
  557. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  558. package/dist/core/runner/image-removed-seat.js +0 -19
  559. package/dist/core/runner/memory-consolidation.d.ts +0 -109
  560. package/dist/core/runner/memory-consolidation.js +0 -251
@@ -51,7 +51,9 @@ export declare function formatToolError(error: unknown): string;
51
51
  *
52
52
  * - `budget` — the cost/token budget gate fired (`limits.max_tokens_exceeded` / `limits.max_cost_exceeded`).
53
53
  * - `limit` — a hard run limit fired (`limits.max_turns_exceeded` / `limits.max_walltime_exceeded`).
54
- * - `output` — the structured/answer output was rejected (`output.invalid` / `output.degenerate`).
54
+ * - `output` — the structured/answer output was rejected (`output.invalid` / `output.degenerate`), or the
55
+ * model's output could not be used after the loop's bounded retries (`model.malformed_tool_use_exhausted`
56
+ * / `model.truncated_output_exhausted`).
55
57
  * - `suspend` — the suspend-loop cap fired (`suspend.loop`); a TERMINAL failure, distinct from a
56
58
  * resumable `suspended` status (which carries no errorCode).
57
59
  * - `review` — a review-pause terminal (`review.pending`).
@@ -118,8 +120,9 @@ export type WorkerErrorClass = "budget" | "limit" | "output" | "suspend" | "revi
118
120
  * SCOPE: this folds a TERMINAL `TaskResult.errorCode` only — i.e. every OUR dotted prefix that the runner can
119
121
  * assemble into a failed task outcome (`limits.`/`output.`/`suspend.`/`review.`/`unexpected.`/
120
122
  * `oracle.`/`resume.`/`config.`/`usage.`) as a broad PREFIX, plus `memory.admission_required` /
121
- * `memory.admission_denied` / `env.lifetime_expired` as EXACT codes (their sibling `memory.*`/`env.*` strings
122
- * are NOT all terminal-errorCode-shaped — see {@link EXACT_CODE_CLASS}'s comment), plus the flat 1.36 codes.
123
+ * `memory.admission_denied` / `env.lifetime_expired` / the two `model.*_exhausted` loop terminals as EXACT codes (their
124
+ * sibling `memory.*`/`env.*`/`model.*` strings are NOT all terminal-errorCode-shaped — see {@link EXACT_CODE_CLASS}'s
125
+ * comment), plus the flat 1.36 codes.
123
126
  * The `limits.` namespace splits into the `budget` and `limit` classes by exact code — see
124
127
  * {@link EXACT_CODE_CLASS}. Operation-level dotted codes that are surfaced to a *caller* and never become a
125
128
  * task outcome are deliberately OUT of scope: `steering.*` (`steering.not_running`/`steering.invalid_content`/
@@ -89,6 +89,8 @@ const EXACT_CODE_CLASS = new Map([
89
89
  ["memory.admission_denied", "config"],
90
90
  ["memory.capture_optout_denied", "config"],
91
91
  ["env.lifetime_expired", "config"],
92
+ ["model.malformed_tool_use_exhausted", "output"],
93
+ ["model.truncated_output_exhausted", "output"],
92
94
  ]);
93
95
  const DOTTED_PREFIX_CLASS = [
94
96
  ["limits.", "limit"],
@@ -1,5 +1,6 @@
1
1
  import { callerText, dataKind, perToolEmptyName, perToolEntryRefusal, receivePerToolDeclaration } from "./mcp-server-spec.js";
2
2
  import { isPlainRecord } from "./mods/kernel/receive.js";
3
+ import { strayMembersOf } from "./own-property-receipt.js";
3
4
  import { faceProblem } from "./runner/tool-face-overlay.js";
4
5
  import { inlineUntrusted } from "./untrusted-text.js";
5
6
  const TOOL_FACE_MEMBERS = { family: true, pathTarget: true, hostTarget: true, renderHints: true, ruleFace: true };
@@ -20,8 +21,8 @@ function kindProblem(label, value, kind) {
20
21
  function membersOf(raw, label, names) {
21
22
  if (!isPlainRecord(raw))
22
23
  return `${label} is ${dataKind(raw)}, not an object`;
23
- const unknown = Object.keys(raw).find((member) => !names.includes(member));
24
- return unknown === undefined ? raw : `${label} has an unknown member ${callerText(unknown)} (the members are ${names.join(", ")})`;
24
+ const stray = strayMembersOf(raw, { subject: label, unit: "member", moment: "when the face is read" }, names);
25
+ return stray === undefined ? raw : `${label} has an unknown member ${callerText(String(stray.names[0]))} (the members are ${names.join(", ")})`;
25
26
  }
26
27
  function ownMember(record, name) {
27
28
  return Object.hasOwn(record, name) ? record[name] : undefined;
@@ -16,13 +16,12 @@ export declare const TOOL_FAMILIES: readonly ["shell", "file-read", "file-write"
16
16
  export type ToolFamily = (typeof TOOL_FAMILIES)[number];
17
17
  /**
18
18
  * The closed set of MOUNT-CONDITION tags a static catalog entry is listed under. The static half of the
19
- * catalog carries an ARRAY (a tool can be mounted by more than one condition — TaskOutput rides both the
20
- * hand band and the delegation surface); the effect roster records the ONE tag that actually fired.
19
+ * catalog carries an ARRAY (a tool can be mounted by more than one condition); the effect roster records the ONE tag that actually fired.
21
20
  *
22
21
  * - `hands` — the hand band (an execution env is wired: `deps.executionEnv` / `executionEnvFactory`);
23
22
  * - `backgroundTasks` — the background-task surface (`Monitor`);
24
23
  * - `workflow` — the workflow tool surface (`Workflow`);
25
- * - `delegation` — the union of the background-task and workflow surfaces (TaskOutput/TaskStop/
24
+ * - `delegation` — the union of the background-task and workflow surfaces (TaskStop/
26
25
  * AgentTranscript, SendMessage's first condition);
27
26
  * - `hostInternals` — a host-internal seat is present (`RunInternals.parentNotify`);
28
27
  * - `peerLane` — the peer-session lane is mounted;
@@ -39,8 +38,12 @@ export type ToolMountTag = (typeof TOOL_MOUNT_TAGS)[number];
39
38
  import type { AssertAllKeysHandled } from "./ask-origin.js";
40
39
  /** The closed set of specialised approval cards a shell may pre-select from a render hint. The hint is a
41
40
  * PRE-FILTER: the shell owns each card's input schema and validates the call's full args before
42
- * mounting the card (design/388 §2.5 boundary ①). */
43
- export declare const TOOL_APPROVAL_CARDS: readonly ["file-edit", "file-write", "notebook-edit", "shell", "fetch", "skill", "workflow", "plan", "question", "generic"];
41
+ * mounting the card (design/388 §2.5 boundary ①).
42
+ *
43
+ * `computer-access` (the call carries `apps`, the list asked for) and `computer-control` (the call carries nothing the
44
+ * card needs) are the two consent cards of a tool that hands the model the user's screen; a caller or an MCP overlay may
45
+ * declare either. What each grants is per connection: `docs/sdk/04-tools-and-mcp.md` states the lifetime. */
46
+ export declare const TOOL_APPROVAL_CARDS: readonly ["file-edit", "file-write", "notebook-edit", "shell", "fetch", "skill", "workflow", "plan", "question", "generic", "computer-access", "computer-control"];
44
47
  export type ToolApprovalCard = (typeof TOOL_APPROVAL_CARDS)[number];
45
48
  /** Membership in the closed set — the one screen a stored or declared card word passes before it is read. */
46
49
  export declare function isToolApprovalCard(word: unknown): word is ToolApprovalCard;
@@ -1,6 +1,6 @@
1
1
  export const TOOL_FAMILIES = Object.freeze(["shell", "file-read", "file-write", "search", "web", "delegate", "plan", "scaffold", "memory", "protocol", "other"]);
2
2
  export const TOOL_MOUNT_TAGS = Object.freeze(["hands", "backgroundTasks", "workflow", "delegation", "hostInternals", "peerLane", "scheduler", "memory", "scenario", "always", "optional"]);
3
- export const TOOL_APPROVAL_CARDS = Object.freeze(["file-edit", "file-write", "notebook-edit", "shell", "fetch", "skill", "workflow", "plan", "question", "generic"]);
3
+ export const TOOL_APPROVAL_CARDS = Object.freeze(["file-edit", "file-write", "notebook-edit", "shell", "fetch", "skill", "workflow", "plan", "question", "generic", "computer-access", "computer-control"]);
4
4
  export function isToolApprovalCard(word) {
5
5
  return typeof word === "string" && TOOL_APPROVAL_CARDS.includes(word);
6
6
  }
@@ -1,33 +1,5 @@
1
1
  import { type ProtocolNamespace } from "./protocol-table.js";
2
2
  import type { RuleBehavior } from "./permission-rule-model.js";
3
- /**
4
- * RB-476-A stage 2 (ruling 2026-08-02, RB-476 "no compatibility surface survives", replay
5
- * resolution included) — the durable-name machinery this module used to hold is RETIRED:
6
- *
7
- * - `OLD_TO_NEW` (the Q6/design-108/design-115 persisted-name normalization) and the MCP `mcp__`
8
- * prefix arm are gone: a persisted checkpoint/orphan/policy entry carrying a pre-rename name no
9
- * longer resolves to the live roster. Old durable state misses LOUDLY (`resume.tool_unavailable`
10
- * on a resumed checkpoint, a roster miss on replay) — by ruling, old sessions are sacrificed
11
- * rather than carried.
12
- * - `canonicalToolName` is gone with it: with the mapping cleared it was the identity function, and
13
- * keeping an identity shim invites the next mapping to grow back silently.
14
- * - `TOMBSTONED_TOOLS` (a second table of per-name re-education prose) is gone. A CALL to a retired name is
15
- * told what the one table here says about it ({@link judgeToolNameMiss}): the miss is `expected-absent`
16
- * with the successor, where any other unknown name stays the generic roster miss.
17
- *
18
- * What REMAINS is validation data: {@link RETIRED_TOOL_NAMES} maps every name the engine ever
19
- * retired to a one-line guidance string, and {@link judgeRuleToolName} is the ONE judgment of it a rule's
20
- * tool name gets ({@link toolNameFaultOf} adds the near-miss step: the one reading). They exist because deleting the mapping flips stale POLICY entries from "silently
21
- * matched" to "silently matches nothing" — and for a deny/requireApproval entry that direction WIDENS
22
- * the surface. `validatePermissionRules` (permission-rules.ts) does NOT classify retired names itself:
23
- * which names a deployment mounts its OWN tool under is a roster fact, and the judgment takes the roster.
24
- * A deployment that mounts its OWN tool under one of these names is unaffected: the name is then in the
25
- * roster and the judgment answers `current`.
26
- *
27
- * GRAMMAR of a guidance string, read by {@link judgeRuleToolName} and held by a pin: it opens with
28
- * `renamed "<name>"` (a 1:1 successor — the judgment's `currentName`), `folded into "<name>"` (merged into a
29
- * wider tool: writing it would deny more than the entry did, so it is no current name), or `removed — `.
30
- */
31
3
  export declare const RETIRED_TOOL_NAMES: ReadonlyMap<string, string>;
32
4
  /** The four answers {@link judgeRuleToolName} gives — a closed set. */
33
5
  export declare const RULE_TOOL_NAME_VERDICTS: readonly ["current", "retired", "unprefixed_namespace", "unmintable_segment"];
@@ -95,7 +67,11 @@ export interface PeerReading {
95
67
  * segment is read through the mint — the peer a reading names is the one the mint would spell it as. `[]` for a name with no
96
68
  * second reading: no separator in the body (the one reading is {@link splitNamespacedName}'s), a glob, an empty segment on either
97
69
  * side of a cut, or a namespace the reference has no spelling for (only MCP's server names reach a rule from another product).
98
- * The first reading is the first separator's — the one `splitNamespacedName` gives.
70
+ * The first reading is the first separator's — the one `splitNamespacedName` gives. The readings run one way only: from the
71
+ * reference's spelling to the minted peers. The fold is lossy (`a__b` and `a_b` mint one prefix) and only a peer segment is folded —
72
+ * the separator between a peer and its tool never is — so a name already in the minted spelling (`mcp__a_b__t`) is the name the
73
+ * engine mounts and is read as that, never as the unfolded spellings that fold to it (server `a`'s tool `b__t` is another tool);
74
+ * a name no mint produces (`b3126_echo`) reads as no tool, and the policy-name audit announces it.
99
75
  */
100
76
  export declare function peerReadingsOf(name: string): readonly PeerReading[];
101
77
  /**
@@ -1,6 +1,7 @@
1
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"'],
@@ -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,28 @@ 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 of the session rules carries — no call of the leg, so that reader takes a read of its own
669
+ * for it (the person's rules are read for a request through `PersonPathRows.forRequest`). */
670
+ export declare const TOOL_TABLE_VIEW_READ = "tool-table-view";
637
671
  /**
638
672
  * The members a policy carries beside `check` — one table for every seat that carries them: {@link wrapToolPolicy} reads
639
673
  * each by name off the wrapped policy, {@link combinePolicies} folds each. The fence makes a new {@link ToolPolicy} member
640
674
  * a compile error until the table names it.
641
675
  */
642
- declare const TOOL_POLICY_CARRIED_MEMBERS: readonly ["projection", "pathRules", "writeGuardRows", "nameSets"];
676
+ declare const TOOL_POLICY_CARRIED_MEMBERS: readonly ["projection", "pathRules", "writeGuardRows", "nameSets", "wholeToolRefusals"];
643
677
  type ToolPolicyCarriedMember = (typeof TOOL_POLICY_CARRIED_MEMBERS)[number];
644
678
  export type ToolPolicyCarriesEveryMember = AssertAllKeysHandled<Exclude<Exclude<keyof ToolPolicy, "check">, ToolPolicyCarriedMember>>;
645
679
  /** The carried members that are set on `p`, each read by name — an accessor or a non-enumerable member included. A
@@ -666,6 +700,10 @@ export declare function toolPolicyPathRules(policies: readonly (ToolPolicy | und
666
700
  * judgment, in member order (a member that throws throws here — the judgment leaves the target unplaced). `undefined`
667
701
  * when none carries any. */
668
702
  export declare function toolPolicyWriteGuardRows(policies: readonly (ToolPolicy | undefined)[]): ToolPolicy["writeGuardRows"];
703
+ /** The whole-tool refusals the given holders carry together (combined policies included): one read of every reading they stand
704
+ * for, side by side, each settled ({@link settledWholeToolRead}) — a reading the fold holds twice (a layer re-appended) once; a
705
+ * tool refused whole when any reading refuses it whole (a deny in the fold refuses the call). `undefined` when none carries any. */
706
+ export declare function toolPolicyWholeToolRefusals(holders: readonly (Pick<ToolPolicy, "wholeToolRefusals"> | undefined)[]): ToolPolicy["wholeToolRefusals"];
669
707
  /**
670
708
  * One deterministic DENY component of a {@link ToolPolicyProjection} (F-012 L1). All fields are plain
671
709
  * serializable data — a component round-trips JSON/`structuredClone` unchanged, which is what lets a
@@ -1372,21 +1410,27 @@ export interface AskRequest {
1372
1410
  * durable suspend/checkpoint flow does NOT invoke `onAsk` on the suspend side, so v1 ask-aggregation
1373
1411
  * requires `checkpointStore` unset (design S1d §1.4 P-a). */
1374
1412
  readonly principal?: string;
1375
- /** Runner-filled source-task identity (= the issuing task's session id). An aggregating `onAsk` uses it
1376
- * to tell which worker an ask came from (nested grandchildren each carry their own session id).
1377
- * **worker-unforgeable for Runner-created delegated subagents** (a child never sets sessionId — the
1378
- * Runner mints it); a top-level caller MAY continue its own session id via `TaskSpec.sessionId`, so this
1379
- * is NOT a global "never forgeable" run id — aggregation only aggregates delegated workers, the context
1380
- * where it holds (design S1d §1.3). `readonly` + same sync-path-only / P-a caveat as `principal`.
1381
- * Undefined ⇒ no source task id. **NOT a subagent discriminator** (the HOST's own asks
1382
- * carry it too — it is always the issuing task's session id); "from a background agent" attribution
1383
- * keys on {@link fromSubagent}, never on this field's presence. */
1384
- readonly sourceTaskId?: string;
1413
+ /** Runner-filled: the issuing leg's session id — the conversation the ask was raised in, the address its
1414
+ * transcript and its parked row live at. An aggregating `onAsk` uses it to tell which worker an ask came from
1415
+ * (nested grandchildren each carry their own session). **worker-unforgeable for Runner-created delegated
1416
+ * subagents** (a child never sets sessionId — the Runner mints it); a top-level caller MAY continue its own
1417
+ * session via `TaskSpec.sessionId`, so this is NOT a global "never forgeable" run id — aggregation only
1418
+ * aggregates delegated workers, the context where it holds (design S1d §1.3). Present on every ask the
1419
+ * Runner mints, the host's included. It names a conversation, never a task: the delegated agent that asked
1420
+ * is {@link agentId}. `readonly` + same sync-path-only / P-a caveat as `principal`. */
1421
+ readonly sourceSessionId?: string;
1422
+ /** Runner-filled: the issuing leg's task id when that leg is a DELEGATED CHILD — a background sub-agent's
1423
+ * registry task id (`a…`, the string its row, `TaskStop`, `SendMessage` and `task_notification.task_id` use),
1424
+ * else the leg's own task id (a foreground sub-agent has no registry row: its session id). Present exactly
1425
+ * when {@link isDelegatedChild} is (a fork and a directly-started workflow's agent included — NOT the
1426
+ * {@link fromSubagent} set); absent on a host ask. The same value the leg's extension events carry as
1427
+ * `agentId`, read through the one predicate that mints it there. `readonly`, sync-path-only, S1d posture. */
1428
+ readonly agentId?: string;
1385
1429
  /** design/153 §1 (RB-39②) — Runner-filled: present (`true`) exactly when the gate raising this ask
1386
1430
  * belongs to a DELEGATED SUBAGENT (the prepareTask `isSubagent` fact — trusted `internals.parentTaskId`
1387
1431
  * presence; a child cannot self-declare or suppress it, internals never ride a TaskSpec). Undefined ⇒ the
1388
1432
  * host / a top-level task. THE explicit "from a background agent" discriminator (replaces presence-
1389
- * or equality-heuristics on {@link sourceTaskId}). `readonly`, sync-path-only, S1d posture. */
1433
+ * or equality-heuristics on {@link sourceSessionId}). `readonly`, sync-path-only, S1d posture. */
1390
1434
  readonly fromSubagent?: true;
1391
1435
  /** design/153 §1 — Runner-filled: the issuing task's display identity (a subagent's explicit agent
1392
1436
  * name, else its agent-type; undefined for the host and unnamed children). **UNTRUSTED-for-display**
@@ -1502,6 +1546,15 @@ export interface AskRequest {
1502
1546
  * reads the whole set — a class it will not answer anywhere in it is a question it does not answer. Present exactly
1503
1547
  * when {@link askClass} is. */
1504
1548
  readonly classes?: readonly import("./ask-origin.js").AskClass[];
1549
+ /** WHO asked about this call and what each said, in its OWN words, in fold order ({@link
1550
+ * import("./ask-origin.js").AskReason}): a deployment policy chain's ask sentence, a hook's or an extension's reason, a hook
1551
+ * host's cause word. Present ⇔ at least one asker said something of its own about this call; a generic question (the write
1552
+ * gate's default sentence, the permission mode's own) and a sentence the engine composes about a fact that rides a typed
1553
+ * member of this request are no entry. The structured approval surface renders this member and the typed members beside it,
1554
+ * never {@link message}; `words` is untrusted display text (one line, capped). Filled by the four mint stations from one
1555
+ * reader; the parked row carries the same value (`PendingAction.tool_approval.askReasons`). Never caller/worker-settable:
1556
+ * a policy or hook answer that states it is refused at the decision receipt. */
1557
+ readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
1505
1558
  /** Engine-judged risk axes of the action awaiting approval, for the human decision surface: a
1506
1559
  * coarse `requiresRealApproval` cannot tell "cannot be undone" from "data leaves the machine",
1507
1560
  * and those call for different scrutiny. Filled by the gate from the SAME resolved axes the
@@ -1522,7 +1575,7 @@ export interface AskRequest {
1522
1575
  /** ruled 2026-08-04 — present exactly when this ask was raised inside a DELEGATED child whose approver
1523
1576
  * is the ancestor run's (the `ToolExecuteContext.onAsk` seat the delegation tool forwards). Additive:
1524
1577
  * an approver that ignores it is unaffected; a durable park/suspend flow never invokes `onAsk` at all,
1525
- * so this — like `principal`/`sourceTaskId` — exists only on the synchronous resolution path.
1578
+ * so this — like `principal`/`sourceSessionId` — exists only on the synchronous resolution path.
1526
1579
  * See {@link AskDelegationProvenance} for the trust posture of each member. */
1527
1580
  readonly delegation?: AskDelegationProvenance;
1528
1581
  /**
@@ -1551,7 +1604,7 @@ export interface AskRequest {
1551
1604
  * on the type because a deployment may invoke its approver function directly.
1552
1605
  *
1553
1606
  * SCOPE, stated so absence is not read as a clean bill on the other routes: this is the
1554
- * SYNCHRONOUS `onAsk` ask, like `principal`/`sourceTaskId` — the closure claim is over AskRequest
1607
+ * SYNCHRONOUS `onAsk` ask, like `principal`/`sourceSessionId` — the closure claim is over AskRequest
1555
1608
  * mint sites, not over every approval callback. The other two human-decision routes:
1556
1609
  * ① a durable park/suspend never invokes `onAsk` and never mints an AskRequest — its twin of this
1557
1610
  * bit is the PERSISTED `PendingAction.tool_approval.hasBidiControls` on the parked row (judged at
@@ -1568,6 +1621,8 @@ export interface AskRequest {
1568
1621
  */
1569
1622
  readonly hasBidiControls?: true;
1570
1623
  }
1624
+ /** 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. */
1625
+ export type AskSourceIdentity = Pick<AskRequest, "principal" | "sourceSessionId" | "agentId" | "fromSubagent" | "sourceAgentName" | "isDelegatedChild">;
1571
1626
  /**
1572
1627
  * How an `ask` decision is resolved when a policy/hook requests human confirmation (design/37):
1573
1628
  * - `"deny"` (and the default when omitted) — **headless auto-deny**: no approver, so `ask` resolves
@@ -1678,6 +1733,15 @@ export type OnAsk = "deny" | "allow" | ((req: AskRequest, signal?: AbortSignal)
1678
1733
  * produced (an abort, a throw, an unclonable edit): nobody approved those. A host's own elapsed window has
1679
1734
  * no attribution seat on its record (`approval_window_expired` names the host as a party, not a seat).
1680
1735
  *
1736
+ * `decidedVia` — WHICH MACHINE SEAT answered for `settledBy: "policy"`, a closed word
1737
+ * ({@link import("./gate-outcome.js").DECIDED_VIA}; the durable leg's `hostDecision.decidedVia` is the same word):
1738
+ * `"policy"` (the deployment's own policy; ABSENT reads the same) or `"permission_request_hook"` (a PermissionRequest
1739
+ * hook answered on the deployment's behalf). It picks the refusal SENTENCE ({@link policyRefusalMessage}) — a
1740
+ * hook's "no" is not "this run has no interactive approval channel" — and leaves the record as it is
1741
+ * (`policy_refused` / `policy_allowed`). Not `approver`: that seat is a transcription core never reads back; this one
1742
+ * is the closed word core reads. Read once with the other members; a value outside the closed set, or the member beside
1743
+ * any word but `"policy"` (a person, an elapsed window), is a loud fail-closed refusal at {@link resolveAsk}.
1744
+ *
1681
1745
  * `readRootGrant` — "yes, and add this directory": the card's {@link AskRequest.readRootCandidate} `dir`, sent back
1682
1746
  * byte for byte (`shell.read_boundary.grant_candidate_is_the_grant`). Beside `allow: true` on an ask carrying that
1683
1747
  * candidate, THIS run's read directories include it from then on (read faces only; `covers: "exact"` = that one
@@ -1691,6 +1755,7 @@ export type AskOutcome = boolean | "unavailable" | {
1691
1755
  settledBy?: "human" | "timeout" | "policy";
1692
1756
  reason?: string;
1693
1757
  approver?: string;
1758
+ decidedVia?: DecidedVia;
1694
1759
  readRootGrant?: string;
1695
1760
  };
1696
1761
  /**
@@ -1791,12 +1856,30 @@ export declare function tryCloneArgs<T>(v: T): {
1791
1856
  * exit reports (`finalInput`, the deny observer's `input`); a deny already carrying the args its own layers judged (a composed
1792
1857
  * chain's, nested ones included) keeps them. Read by the gate's lanes and by {@link combinePolicies}. Only a deny is changed. */
1793
1858
  export declare function refusalOf<D extends PermissionResult>(deny: D, judged: unknown): D;
1859
+ /** Who spoke an extension's verdict on a call, as a gate sentence names it (`extension "<registration>"`, else "an
1860
+ * extension"), and the reason it gave (`: <reason>`, else nothing) — read by every sentence about an extension's verdict,
1861
+ * a `tool.check` answer's and a `classic.PreToolUse` answer's alike. */
1862
+ export declare function extensionSpeaker(by: string | undefined, reason: string | undefined): {
1863
+ readonly who: string;
1864
+ readonly why: string;
1865
+ };
1866
+ /** `extension "<registration>"` — the registration's name as a quoted string, so a name can never end its own quotes and run on
1867
+ * into the sentence around it. A registered name has one form (`MOD_REGISTRATION_NAME`, the kernel's screen) and this reads
1868
+ * identically to it; the quoting is the second line, for a name no screen has judged here (one carried in from elsewhere). */
1869
+ export declare function extensionNamed(registration: string): string;
1870
+ /** An extension's own question about a call, as the text a reader of `message` reads it: which extension asks, and why — read
1871
+ * off the question's ONE entry ({@link import("./ask-origin.js").hookAskReasonOf}), so the sentence and the entry are one value.
1872
+ * The one sentence an ask raised by an extension carries, whichever event raised it (`tool.check`, `classic.PreToolUse`); when
1873
+ * the hook's host asks because the hook gave no verdict it could act on, the sentence says that instead of quoting anyone. */
1874
+ export declare function extensionQuestionText(toolName: string, entry: Extract<import("./ask-origin.js").AskReason, {
1875
+ by: "hook";
1876
+ }>): string;
1794
1877
  /**
1795
1878
  * A PreToolUse hook's `ask` folded over a verdict by `deny > ask > allow` — the ONE law for the gate's first screening and for
1796
1879
  * an approved edit's re-screen. A deny stands. Over an allow, the hook's own ask, RECONSTRUCTED rather than spread (its message,
1797
- * 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,
1880
+ * 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,
1798
1881
  * 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
1799
- * clearing one ask that stands for two gates sees both reasons.
1882
+ * clearing one ask that stands for two gates sees both reasons: its `askReasons` are the standing ask's entries, then the hook's.
1800
1883
  */
1801
1884
  export declare function foldHookAsk(verdict: Exclude<PermissionResult, {
1802
1885
  action: "deny";
@@ -1898,8 +1981,16 @@ export declare function humanRefusalSentence(subject: HumanRefusalSubject, reaso
1898
1981
  * as the user's guidance, because no user gave it. `askMessage` is the ask's own prompt where the caller
1899
1982
  * has one (the synchronous leg does); a durable decide answers a call parked in an earlier leg and has
1900
1983
  * none, and the head then simply names the call.
1984
+ *
1985
+ * WHICH MACHINE SEAT answered (`decidedVia`, read through {@link policyDeciderOf}) picks between two sentences
1986
+ * and nothing else. The deployment's own policy (the word, or its absence) gets the sentence above. Any other seat
1987
+ * DID answer, so "this run has no interactive approval channel" would be false about it: the head names the seat
1988
+ * that declined (`a PermissionRequest hook denied this call`), and the seat's own words ride the fence under its
1989
+ * label. The fence is a deliberate divergence from the reference, which hands a hook's message to the model as the
1990
+ * refusal text itself (`iPt` (cli309.js:288208), `runHooks` (cli309.js:295883)): here every decider's free text is
1991
+ * untrusted data and reaches the model only fenced, whoever typed it.
1901
1992
  */
1902
- export declare function policyRefusalMessage(toolName: string, askMessage: string | undefined, note: string | undefined): string;
1993
+ export declare function policyRefusalMessage(toolName: string, askMessage: string | undefined, note: string | undefined, decidedVia: DecidedVia | undefined): string;
1903
1994
  /**
1904
1995
  * A {@link resolveAsk} result: always a TERMINAL `allow`/`deny` (never `ask`). `approverUnavailable`
1905
1996
  * is the out-of-band G1 three-value marker: the live approver returned `"unavailable"` for this ask —