@sema-agent/core 7.58.0 → 7.60.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (519) hide show
  1. package/CHANGELOG.md +1340 -0
  2. package/README.md +6 -4
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +2 -1
  6. package/dist/agents/agent-transcript-tool.js +3 -1
  7. package/dist/agents/cc-peer-directory.js +8 -8
  8. package/dist/agents/child-model-seat.d.ts +4 -2
  9. package/dist/agents/child-model-seat.js +9 -4
  10. package/dist/agents/cumulative-stats.js +0 -1
  11. package/dist/agents/inherited-tool-pool.d.ts +26 -1
  12. package/dist/agents/inherited-tool-pool.js +22 -0
  13. package/dist/agents/peer-directory.d.ts +9 -0
  14. package/dist/agents/peer-directory.js +6 -2
  15. package/dist/agents/retain-ledger.d.ts +11 -1
  16. package/dist/agents/retain-ledger.js +13 -2
  17. package/dist/agents/roster-store.d.ts +1 -1
  18. package/dist/agents/roster-store.js +3 -1
  19. package/dist/agents/send-message-tool.d.ts +8 -19
  20. package/dist/agents/send-message-tool.js +32 -50
  21. package/dist/agents/subagent.d.ts +51 -17
  22. package/dist/agents/subagent.js +150 -112
  23. package/dist/agents/tool-filter.d.ts +1 -3
  24. package/dist/agents/tool-filter.js +4 -12
  25. package/dist/bench/metrics.d.ts +3 -5
  26. package/dist/bench/metrics.js +0 -1
  27. package/dist/brain/anthropic.js +161 -45
  28. package/dist/brain/degrading.js +3 -1
  29. package/dist/brain/errors.d.ts +9 -3
  30. package/dist/brain/errors.js +7 -1
  31. package/dist/brain/failover.js +2 -1
  32. package/dist/brain/open-responses.js +3 -3
  33. package/dist/brain/openai.js +103 -53
  34. package/dist/brain/provider-dialect.d.ts +11 -0
  35. package/dist/brain/provider-dialect.js +5 -2
  36. package/dist/brain/reasoning-request.js +5 -4
  37. package/dist/brain/reasoning.d.ts +19 -0
  38. package/dist/brain/reasoning.js +17 -2
  39. package/dist/brain/request-route.d.ts +4 -1
  40. package/dist/brain/request-route.js +4 -1
  41. package/dist/brain/route-adjudicator.d.ts +84 -18
  42. package/dist/brain/route-adjudicator.js +90 -22
  43. package/dist/brain/route-conformance.js +1 -1
  44. package/dist/brain/status-sink.d.ts +7 -1
  45. package/dist/brain/status-sink.js +6 -0
  46. package/dist/brain/stream-engine.js +84 -49
  47. package/dist/brain/stream-shared.d.ts +30 -0
  48. package/dist/brain/stream-shared.js +34 -1
  49. package/dist/brain/timeout.d.ts +65 -6
  50. package/dist/brain/timeout.js +111 -11
  51. package/dist/core/a2a.d.ts +15 -5
  52. package/dist/core/a2a.js +34 -19
  53. package/dist/core/account-row.d.ts +61 -0
  54. package/dist/core/account-row.js +51 -0
  55. package/dist/core/advisor-verdict.d.ts +2 -1
  56. package/dist/core/advisor-verdict.js +1 -1
  57. package/dist/core/agent-definition.d.ts +20 -0
  58. package/dist/core/allow-entry.d.ts +20 -6
  59. package/dist/core/allow-entry.js +17 -7
  60. package/dist/core/approval-object.d.ts +29 -15
  61. package/dist/core/approval-object.js +47 -19
  62. package/dist/core/artifact-host.d.ts +0 -2
  63. package/dist/core/artifact-host.js +0 -1
  64. package/dist/core/auto-compaction.js +1 -1
  65. package/dist/core/auto-mode-defaults.d.ts +8 -0
  66. package/dist/core/auto-mode-defaults.js +1 -0
  67. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  68. package/dist/core/auto-mode.d.ts +39 -4
  69. package/dist/core/auto-mode.js +63 -12
  70. package/dist/core/background-agent-store.d.ts +26 -4
  71. package/dist/core/background-agent-store.js +3 -2
  72. package/dist/core/background-shell.d.ts +12 -1
  73. package/dist/core/background-shell.js +12 -0
  74. package/dist/core/checkpoint-requirements.d.ts +13 -1
  75. package/dist/core/checkpoint-requirements.js +3 -1
  76. package/dist/core/checkpoint-store.d.ts +66 -25
  77. package/dist/core/checkpoint-store.js +22 -9
  78. package/dist/core/child-clamp-seats.d.ts +29 -0
  79. package/dist/core/child-clamp-seats.js +56 -1
  80. package/dist/core/compliance.d.ts +3 -3
  81. package/dist/core/compliance.js +1 -1
  82. package/dist/core/credential-echo.d.ts +52 -0
  83. package/dist/core/credential-echo.js +65 -0
  84. package/dist/core/credential-vocabulary.d.ts +13 -3
  85. package/dist/core/credential-vocabulary.js +12 -4
  86. package/dist/core/cross-boundary-taint.d.ts +4 -5
  87. package/dist/core/effective-path-target.d.ts +8 -2
  88. package/dist/core/effective-path-target.js +8 -3
  89. package/dist/core/engine-notice.d.ts +156 -23
  90. package/dist/core/engine-notice.js +19 -5
  91. package/dist/core/frame-settlement.d.ts +5 -0
  92. package/dist/core/frame-settlement.js +4 -0
  93. package/dist/core/gate-fold.js +8 -6
  94. package/dist/core/gate-lanes.js +47 -12
  95. package/dist/core/gate-outcome.d.ts +32 -3
  96. package/dist/core/gate-outcome.js +19 -1
  97. package/dist/core/governance-codes.d.ts +17 -1
  98. package/dist/core/governance-codes.js +25 -0
  99. package/dist/core/hands-band-screen.js +0 -1
  100. package/dist/core/hands-band.d.ts +0 -3
  101. package/dist/core/hooks.d.ts +70 -59
  102. package/dist/core/hooks.js +125 -80
  103. package/dist/core/image-admission.d.ts +106 -52
  104. package/dist/core/image-admission.js +184 -56
  105. package/dist/core/image-downsample.d.ts +36 -69
  106. package/dist/core/image-downsample.js +111 -73
  107. package/dist/core/integer-option.d.ts +21 -0
  108. package/dist/core/integer-option.js +13 -0
  109. package/dist/core/locked-config.d.ts +59 -5
  110. package/dist/core/locked-config.js +82 -50
  111. package/dist/core/mailbox-store.d.ts +45 -1
  112. package/dist/core/mailbox-store.js +53 -9
  113. package/dist/core/mcp-call-meta.d.ts +2 -2
  114. package/dist/core/mcp-call-meta.js +9 -10
  115. package/dist/core/mcp-failure.d.ts +122 -20
  116. package/dist/core/mcp-failure.js +73 -5
  117. package/dist/core/mcp-host-seat.d.ts +92 -0
  118. package/dist/core/mcp-host-seat.js +131 -0
  119. package/dist/core/mcp-probe.d.ts +7 -2
  120. package/dist/core/mcp-probe.js +7 -2
  121. package/dist/core/mcp-server-link.d.ts +22 -1
  122. package/dist/core/mcp-server-link.js +25 -1
  123. package/dist/core/mcp-server-spec.d.ts +38 -9
  124. package/dist/core/mcp-server-spec.js +55 -21
  125. package/dist/core/mcp.d.ts +27 -12
  126. package/dist/core/mcp.js +105 -76
  127. package/dist/core/memory-admission.d.ts +23 -6
  128. package/dist/core/memory-admission.js +19 -9
  129. package/dist/core/memory-engine/consolidation-driver.d.ts +2 -4
  130. package/dist/core/memory-engine/consolidation-driver.js +3 -3
  131. package/dist/core/memory-engine/consolidation.d.ts +4 -0
  132. package/dist/core/memory-engine/consolidation.js +1 -0
  133. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  134. package/dist/core/memory-engine/content-origin.js +21 -3
  135. package/dist/core/memory-engine/delegation-settlement.js +5 -12
  136. package/dist/core/memory-engine/distiller.js +2 -2
  137. package/dist/core/memory-engine/dual-root.d.ts +50 -1
  138. package/dist/core/memory-engine/dual-root.js +44 -1
  139. package/dist/core/memory-engine/engine.d.ts +67 -14
  140. package/dist/core/memory-engine/engine.js +384 -212
  141. package/dist/core/memory-engine/export-bundle.d.ts +23 -0
  142. package/dist/core/memory-engine/export-bundle.js +23 -4
  143. package/dist/core/memory-engine/file-backend.d.ts +128 -55
  144. package/dist/core/memory-engine/file-backend.js +290 -117
  145. package/dist/core/memory-engine/index.d.ts +3 -2
  146. package/dist/core/memory-engine/index.js +2 -1
  147. package/dist/core/memory-engine/layout.d.ts +59 -11
  148. package/dist/core/memory-engine/layout.js +190 -40
  149. package/dist/core/memory-engine/memory-backend-contract.d.ts +1 -1
  150. package/dist/core/memory-engine/memory-backend-contract.js +39 -2
  151. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  152. package/dist/core/memory-engine/scope-contract.js +2 -2
  153. package/dist/core/memory-engine/sync-client.d.ts +51 -9
  154. package/dist/core/memory-engine/sync-client.js +107 -13
  155. package/dist/core/memory-engine/sync-report.d.ts +103 -0
  156. package/dist/core/memory-engine/sync-report.js +119 -0
  157. package/dist/core/memory-engine/sync.d.ts +8 -1
  158. package/dist/core/memory-engine/types.d.ts +6 -0
  159. package/dist/core/mode-policy.d.ts +9 -1
  160. package/dist/core/mode-policy.js +11 -1
  161. package/dist/core/model-receipt.d.ts +39 -0
  162. package/dist/core/model-receipt.js +139 -0
  163. package/dist/core/mods/agent-stations.d.ts +65 -0
  164. package/dist/core/mods/agent-stations.js +105 -0
  165. package/dist/core/mods/classic-events.d.ts +5 -1
  166. package/dist/core/mods/kernel/dispatch.d.ts +5 -1
  167. package/dist/core/mods/kernel/dispatch.js +6 -5
  168. package/dist/core/mods/kernel/events.d.ts +11 -4
  169. package/dist/core/mods/kernel/events.js +11 -7
  170. package/dist/core/mods/kernel/receive.d.ts +5 -0
  171. package/dist/core/mods/kernel/receive.js +10 -0
  172. package/dist/core/mods/kernel/registration.d.ts +4 -0
  173. package/dist/core/mods/kernel/registration.js +3 -0
  174. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  175. package/dist/core/mods/lifecycle-stations.js +35 -0
  176. package/dist/core/mods/stations.d.ts +73 -60
  177. package/dist/core/mods/stations.js +64 -40
  178. package/dist/core/mods/tool-call.d.ts +10 -4
  179. package/dist/core/mods/tool-call.js +28 -12
  180. package/dist/core/mounted-mcp.d.ts +5 -0
  181. package/dist/core/mounted-mcp.js +2 -2
  182. package/dist/core/namespaced-rule-name.d.ts +7 -1
  183. package/dist/core/namespaced-rule-name.js +13 -2
  184. package/dist/core/oracle-isolation.js +1 -1
  185. package/dist/core/own-property-receipt.d.ts +3 -0
  186. package/dist/core/own-property-receipt.js +3 -0
  187. package/dist/core/parent-spec-seat.d.ts +8 -3
  188. package/dist/core/parent-spec-seat.js +2 -0
  189. package/dist/core/park-selfcheck.js +14 -8
  190. package/dist/core/peer-seat.d.ts +133 -16
  191. package/dist/core/peer-seat.js +319 -42
  192. package/dist/core/permission-rule-consent.d.ts +0 -21
  193. package/dist/core/permission-rule-consent.js +11 -6
  194. package/dist/core/permission-rule-model.d.ts +20 -2
  195. package/dist/core/permission-rule-model.js +8 -7
  196. package/dist/core/present-plan-tool.d.ts +11 -3
  197. package/dist/core/present-plan-tool.js +2 -2
  198. package/dist/core/protocol-http-auth.d.ts +14 -2
  199. package/dist/core/protocol-http-auth.js +16 -7
  200. package/dist/core/read-face-seats.d.ts +7 -5
  201. package/dist/core/read-face-seats.js +4 -1
  202. package/dist/core/redaction-marks.d.ts +4 -3
  203. package/dist/core/redaction-marks.js +2 -2
  204. package/dist/core/remote-env.d.ts +146 -98
  205. package/dist/core/remote-env.js +113 -14
  206. package/dist/core/resume-startup-cause.js +1 -0
  207. package/dist/core/retention.js +37 -12
  208. package/dist/core/retired-keys.d.ts +6 -1
  209. package/dist/core/retired-keys.js +4 -1
  210. package/dist/core/rewrite-rejudge.d.ts +13 -5
  211. package/dist/core/rewrite-rejudge.js +9 -5
  212. package/dist/core/roles.d.ts +69 -3
  213. package/dist/core/roles.js +167 -80
  214. package/dist/core/rule-owner.d.ts +3 -0
  215. package/dist/core/runner/announce-once-ledger.d.ts +5 -4
  216. package/dist/core/runner/announce-once-ledger.js +4 -2
  217. package/dist/core/runner/assemble-result.d.ts +0 -5
  218. package/dist/core/runner/assemble-result.js +0 -1
  219. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  220. package/dist/core/runner/call-hook-stations.js +23 -12
  221. package/dist/core/runner/child-tree.d.ts +7 -8
  222. package/dist/core/runner/child-tree.js +6 -6
  223. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  224. package/dist/core/runner/classifier-ladder.js +39 -8
  225. package/dist/core/runner/construction-doors.js +5 -0
  226. package/dist/core/runner/contracts.d.ts +82 -57
  227. package/dist/core/runner/credential-origin-seat.js +4 -3
  228. package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
  229. package/dist/core/runner/cross-boundary-lane.js +11 -2
  230. package/dist/core/runner/cwd-alignment-probe.d.ts +20 -0
  231. package/dist/core/runner/cwd-alignment-probe.js +21 -0
  232. package/dist/core/runner/decide-continuation.d.ts +2 -2
  233. package/dist/core/runner/env-capability-census.d.ts +15 -20
  234. package/dist/core/runner/env-capability-census.js +25 -34
  235. package/dist/core/runner/file-history-request.d.ts +2 -2
  236. package/dist/core/runner/file-history-request.js +0 -8
  237. package/dist/core/runner/gate-exit.d.ts +87 -11
  238. package/dist/core/runner/gate-exit.js +30 -8
  239. package/dist/core/runner/git-status-frame.d.ts +5 -2
  240. package/dist/core/runner/git-status-frame.js +3 -4
  241. package/dist/core/runner/image-removed-seat.d.ts +12 -0
  242. package/dist/core/runner/image-removed-seat.js +19 -0
  243. package/dist/core/runner/image.d.ts +7 -2
  244. package/dist/core/runner/image.js +14 -8
  245. package/dist/core/runner/inline-image.d.ts +10 -8
  246. package/dist/core/runner/inline-image.js +11 -9
  247. package/dist/core/runner/memory-consolidation-driver.js +5 -5
  248. package/dist/core/runner/park-commit.d.ts +1 -1
  249. package/dist/core/runner/park-commit.js +3 -0
  250. package/dist/core/runner/permission-rule-lanes.js +1 -1
  251. package/dist/core/runner/prepare-ask-lane.d.ts +1 -1
  252. package/dist/core/runner/prepare-ask-lane.js +2 -1
  253. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  254. package/dist/core/runner/prepare-boundary-parks.js +5 -5
  255. package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -5
  256. package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
  257. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  258. package/dist/core/runner/prepare-config-doors.js +16 -9
  259. package/dist/core/runner/prepare-context-lane.js +2 -0
  260. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -3
  261. package/dist/core/runner/prepare-delegation-surface.js +5 -4
  262. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  263. package/dist/core/runner/prepare-file-history.js +3 -12
  264. package/dist/core/runner/prepare-gate-stations.d.ts +4 -3
  265. package/dist/core/runner/prepare-gate-stations.js +4 -3
  266. package/dist/core/runner/prepare-hands-readface.d.ts +7 -1
  267. package/dist/core/runner/prepare-hands-readface.js +19 -6
  268. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -7
  269. package/dist/core/runner/prepare-inherited-gate.js +22 -31
  270. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  271. package/dist/core/runner/prepare-memory.d.ts +2 -2
  272. package/dist/core/runner/prepare-memory.js +12 -19
  273. package/dist/core/runner/prepare-park-ask.d.ts +4 -6
  274. package/dist/core/runner/prepare-park-ask.js +5 -9
  275. package/dist/core/runner/prepare-policy-chain.d.ts +8 -7
  276. package/dist/core/runner/prepare-policy-chain.js +136 -121
  277. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  278. package/dist/core/runner/prepare-project-context.js +10 -7
  279. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -2
  280. package/dist/core/runner/prepare-prompt-inputs.js +10 -20
  281. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  282. package/dist/core/runner/prepare-protocol-tools.js +17 -2
  283. package/dist/core/runner/prepare-run-refs.d.ts +2 -3
  284. package/dist/core/runner/prepare-run-refs.js +4 -1
  285. package/dist/core/runner/prepare-suspend-saga.d.ts +0 -2
  286. package/dist/core/runner/prepare-suspend-saga.js +5 -7
  287. package/dist/core/runner/prepare-task.js +44 -28
  288. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  289. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  290. package/dist/core/runner/prepare-wiring-manifest.d.ts +5 -4
  291. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  292. package/dist/core/runner/prepare-workspace-restore.js +3 -3
  293. package/dist/core/runner/reply-pricing.d.ts +30 -0
  294. package/dist/core/runner/reply-pricing.js +19 -0
  295. package/dist/core/runner/resume-admission.js +4 -2
  296. package/dist/core/runner/resume-apply.js +6 -1
  297. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  298. package/dist/core/runner/resume-policy-outcome.js +5 -5
  299. package/dist/core/runner/retired-runner-deps.js +4 -1
  300. package/dist/core/runner/role-seat-defaulted.d.ts +44 -0
  301. package/dist/core/runner/role-seat-defaulted.js +40 -0
  302. package/dist/core/runner/run-attachment-seats.js +3 -3
  303. package/dist/core/runner/run-brain-sinks.js +3 -0
  304. package/dist/core/runner/run-git-lane.d.ts +3 -1
  305. package/dist/core/runner/run-git-lane.js +1 -1
  306. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  307. package/dist/core/runner/run-harness-handlers.js +3 -1
  308. package/dist/core/runner/run-identity-wiring.d.ts +2 -5
  309. package/dist/core/runner/run-identity-wiring.js +6 -5
  310. package/dist/core/runner/run-leg.d.ts +2 -0
  311. package/dist/core/runner/run-leg.js +63 -56
  312. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  313. package/dist/core/runner/run-notification-lane.js +16 -10
  314. package/dist/core/runner/run-settle-and-teardown.js +5 -1
  315. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  316. package/dist/core/runner/run-stop-and-final-verify.js +14 -6
  317. package/dist/core/runner/run-terminal-adoption.d.ts +2 -5
  318. package/dist/core/runner/run-terminal-adoption.js +9 -3
  319. package/dist/core/runner/run-turn-boundary.js +89 -77
  320. package/dist/core/runner/runtask.d.ts +8 -5
  321. package/dist/core/runner/runtask.js +21 -13
  322. package/dist/core/runner/side-call-account.d.ts +1 -1
  323. package/dist/core/runner/side-call-account.js +3 -18
  324. package/dist/core/runner/skills-seat.js +2 -2
  325. package/dist/core/runner/sub-agent-deny-lists.d.ts +24 -0
  326. package/dist/core/runner/sub-agent-deny-lists.js +20 -7
  327. package/dist/core/runner/synthetic-tools.js +2 -2
  328. package/dist/core/runner/tool-disclosure.js +0 -2
  329. package/dist/core/runner/tool-end-body.js +2 -2
  330. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  331. package/dist/core/runner/tool-face-overlay.js +26 -19
  332. package/dist/core/runner/tool-occurrence.d.ts +1 -1
  333. package/dist/core/runner/tool-occurrence.js +2 -2
  334. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  335. package/dist/core/runner/tool-result-media-seat.js +17 -1
  336. package/dist/core/runner/turn-attachments.d.ts +29 -27
  337. package/dist/core/runner/turn-attachments.js +27 -42
  338. package/dist/core/runner-deps.d.ts +32 -19
  339. package/dist/core/secret-env.d.ts +35 -4
  340. package/dist/core/secret-env.js +65 -3
  341. package/dist/core/sensitive-path-policy.js +3 -3
  342. package/dist/core/session-policy-store.d.ts +12 -3
  343. package/dist/core/session-policy-store.js +29 -10
  344. package/dist/core/session-store.d.ts +5 -7
  345. package/dist/core/session-store.js +50 -11
  346. package/dist/core/side-query.d.ts +11 -1
  347. package/dist/core/side-query.js +9 -0
  348. package/dist/core/skill-grant-binding.d.ts +31 -2
  349. package/dist/core/skill-grant-binding.js +31 -1
  350. package/dist/core/skill-grant.d.ts +17 -5
  351. package/dist/core/skill-grant.js +24 -6
  352. package/dist/core/store-contracts/background-agent-store-contract.js +27 -0
  353. package/dist/core/store-contracts/checkpoint-store-contract.js +3 -2
  354. package/dist/core/store-contracts/mailbox-store-contract.js +31 -1
  355. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  356. package/dist/core/store-contracts/tool-result-store-contract.js +37 -0
  357. package/dist/core/stub-env.d.ts +5 -5
  358. package/dist/core/stub-env.js +11 -1
  359. package/dist/core/swappable-deps.d.ts +17 -43
  360. package/dist/core/swappable-deps.js +15 -5
  361. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  362. package/dist/core/synthetic-read-verdict.js +2 -1
  363. package/dist/core/task-event.d.ts +50 -10
  364. package/dist/core/task-notification.d.ts +88 -5
  365. package/dist/core/task-notification.js +146 -17
  366. package/dist/core/task-registry-agent.d.ts +18 -12
  367. package/dist/core/task-registry-agent.js +19 -6
  368. package/dist/core/task-registry-monitor.d.ts +7 -0
  369. package/dist/core/task-registry-monitor.js +28 -1
  370. package/dist/core/task-registry-shared.d.ts +43 -3
  371. package/dist/core/task-registry-shared.js +21 -7
  372. package/dist/core/task-registry-workflow.js +1 -1
  373. package/dist/core/task-registry.d.ts +50 -35
  374. package/dist/core/task-registry.js +64 -23
  375. package/dist/core/task-result.d.ts +3 -12
  376. package/dist/core/task-spec.d.ts +15 -7
  377. package/dist/core/task-stream.d.ts +1 -1
  378. package/dist/core/terminal-cause.d.ts +10 -0
  379. package/dist/core/tool-catalog-entries.js +1 -1
  380. package/dist/core/tool-check-reading.d.ts +1 -0
  381. package/dist/core/tool-check-reading.js +3 -3
  382. package/dist/core/tool-face-reader.d.ts +7 -6
  383. package/dist/core/tool-face-reader.js +4 -3
  384. package/dist/core/tool-name-aliases.d.ts +19 -0
  385. package/dist/core/tool-name-aliases.js +54 -2
  386. package/dist/core/tool-policy.d.ts +21 -4
  387. package/dist/core/tool-policy.js +1 -1
  388. package/dist/core/tool-registry.d.ts +5 -5
  389. package/dist/core/tool-registry.js +2 -2
  390. package/dist/core/tool-result-store.d.ts +88 -5
  391. package/dist/core/tool-result-store.js +51 -12
  392. package/dist/core/tool-roster.d.ts +112 -5
  393. package/dist/core/tool-roster.js +42 -1
  394. package/dist/core/tool-spec.d.ts +23 -5
  395. package/dist/core/trace.d.ts +0 -1
  396. package/dist/core/types.d.ts +5 -5
  397. package/dist/core/types.js +2 -2
  398. package/dist/core/untrusted-text.js +1 -1
  399. package/dist/core/user-attachment.d.ts +10 -5
  400. package/dist/core/user-attachment.js +15 -7
  401. package/dist/core/wiring-manifest.d.ts +6 -3
  402. package/dist/engine/compaction/compaction.js +29 -3
  403. package/dist/engine/execution-env/node-execution-env.d.ts +11 -5
  404. package/dist/engine/execution-env/node-execution-env.js +21 -13
  405. package/dist/engine/harness/agent-harness.d.ts +26 -3
  406. package/dist/engine/harness/agent-harness.js +49 -16
  407. package/dist/engine/harness/messages.d.ts +3 -1
  408. package/dist/engine/harness/messages.js +3 -2
  409. package/dist/engine/harness/types.d.ts +119 -28
  410. package/dist/engine/llm/rejected-images.d.ts +46 -0
  411. package/dist/engine/llm/rejected-images.js +54 -0
  412. package/dist/engine/llm/tool-turns.d.ts +2 -1
  413. package/dist/engine/llm/types.d.ts +18 -7
  414. package/dist/engine/loop/agent-loop.d.ts +20 -12
  415. package/dist/engine/loop/agent-loop.js +205 -36
  416. package/dist/engine/loop/types.d.ts +12 -3
  417. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  418. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  419. package/dist/engine/session/path-to-root.d.ts +38 -0
  420. package/dist/engine/session/path-to-root.js +39 -0
  421. package/dist/engine/session/storage-base.js +4 -21
  422. package/dist/index.d.ts +35 -21
  423. package/dist/index.js +26 -17
  424. package/dist/internal/harness-types.d.ts +1 -1
  425. package/dist/internal/harness.d.ts +1 -0
  426. package/dist/internal/llm.d.ts +1 -0
  427. package/dist/orchestration/run-workflow-tool.d.ts +9 -3
  428. package/dist/orchestration/run-workflow-tool.js +59 -29
  429. package/dist/orchestration/workflow-governance.d.ts +1 -1
  430. package/dist/orchestration/workflow-governance.js +2 -1
  431. package/dist/orchestration/workflow-observe.d.ts +17 -1
  432. package/dist/orchestration/workflow-observe.js +20 -0
  433. package/dist/orchestration/workflow-types.d.ts +32 -7
  434. package/dist/orchestration/workflow.d.ts +4 -0
  435. package/dist/orchestration/workflow.js +762 -491
  436. package/dist/prompts/default.d.ts +1 -10
  437. package/dist/prompts/default.js +0 -2
  438. package/dist/shell/counting-pass.d.ts +50 -0
  439. package/dist/shell/counting-pass.js +502 -0
  440. package/dist/shell/lex.d.ts +4 -2
  441. package/dist/shell/lex.js +93 -34
  442. package/dist/shell/shell-words.d.ts +1 -1
  443. package/dist/shell/shell-words.js +7 -6
  444. package/dist/stores/file/background-agent-store.d.ts +1 -1
  445. package/dist/stores/file/background-agent-store.js +3 -1
  446. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  447. package/dist/stores/file/checkpoint-store.js +19 -14
  448. package/dist/stores/file/file-history-store.d.ts +1 -1
  449. package/dist/stores/file/file-history-store.js +3 -1
  450. package/dist/stores/file/index.d.ts +4 -3
  451. package/dist/stores/file/index.js +17 -8
  452. package/dist/stores/file/mailbox-store.d.ts +1 -1
  453. package/dist/stores/file/mailbox-store.js +9 -11
  454. package/dist/stores/file/memory-store.d.ts +1 -1
  455. package/dist/stores/file/memory-store.js +3 -1
  456. package/dist/stores/file/session-policy-store.d.ts +1 -1
  457. package/dist/stores/file/session-policy-store.js +3 -1
  458. package/dist/stores/file/session-store.d.ts +1 -1
  459. package/dist/stores/file/session-store.js +3 -1
  460. package/dist/stores/file/shared-ledger.d.ts +26 -0
  461. package/dist/stores/file/shared-ledger.js +38 -9
  462. package/dist/stores/file/tool-result-store.d.ts +20 -2
  463. package/dist/stores/file/tool-result-store.js +74 -6
  464. package/dist/stores/file/usage-window-store.d.ts +1 -1
  465. package/dist/stores/file/usage-window-store.js +3 -1
  466. package/dist/stores/file/workflow-journal-store.d.ts +1 -11
  467. package/dist/stores/file/workflow-journal-store.js +3 -2
  468. package/dist/tools/fs/containment-face.d.ts +5 -0
  469. package/dist/tools/fs/encoding.d.ts +13 -4
  470. package/dist/tools/fs/encoding.js +17 -2
  471. package/dist/tools/fs/fs-bash-background-text.d.ts +7 -0
  472. package/dist/tools/fs/fs-bash-background-text.js +1 -0
  473. package/dist/tools/fs/fs-bash.d.ts +14 -4
  474. package/dist/tools/fs/fs-bash.js +29 -35
  475. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  476. package/dist/tools/fs/fs-pdf.js +26 -21
  477. package/dist/tools/fs/fs-read.d.ts +5 -4
  478. package/dist/tools/fs/fs-read.js +35 -18
  479. package/dist/tools/fs/fs-search-tools.js +4 -1
  480. package/dist/tools/fs/fs-shared.d.ts +11 -13
  481. package/dist/tools/fs/fs-shared.js +11 -7
  482. package/dist/tools/fs/fs-write.js +5 -5
  483. package/dist/tools/fs/index.d.ts +14 -8
  484. package/dist/tools/fs/index.js +13 -5
  485. package/dist/tools/fs/program-read-model.d.ts +13 -0
  486. package/dist/tools/fs/program-read-model.js +15 -0
  487. package/dist/tools/fs/program-read-model.rows.js +1 -1
  488. package/dist/tools/fs/read-deny.d.ts +13 -10
  489. package/dist/tools/fs/read-deny.js +25 -5
  490. package/dist/tools/fs/read-floor.d.ts +62 -0
  491. package/dist/tools/fs/read-floor.js +58 -0
  492. package/dist/tools/fs/removal-targets.d.ts +9 -4
  493. package/dist/tools/fs/removal-targets.js +17 -9
  494. package/dist/tools/fs/search.d.ts +3 -3
  495. package/dist/tools/fs/search.js +4 -4
  496. package/dist/tools/fs/shell-read-check.d.ts +1 -1
  497. package/dist/tools/fs/shell-read-check.js +2 -1
  498. package/dist/tools/fs/shell-read-judge.d.ts +16 -8
  499. package/dist/tools/fs/shell-read-judge.js +10 -6
  500. package/dist/tools/fs/shell-read-plan.d.ts +6 -1
  501. package/dist/tools/fs/shell-read-plan.js +22 -15
  502. package/dist/tools/fs/shell-read-start.js +1 -0
  503. package/dist/tools/fs/shell-reentry-text.d.ts +15 -1
  504. package/dist/tools/fs/shell-reentry-text.js +25 -3
  505. package/dist/tools/monitor.d.ts +9 -4
  506. package/dist/tools/monitor.js +17 -8
  507. package/dist/tools/scheduler-tools.js +42 -4
  508. package/dist/tools/web.d.ts +0 -10
  509. package/dist/tools/web.js +1 -4
  510. package/package.json +5 -2
  511. package/test/export-surface.snapshot.json +161 -21
  512. package/wire-changes/core-stores-sql@7.59.0.json +29 -0
  513. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  514. package/wire-changes/core@7.59.0.json +2459 -0
  515. package/wire-changes/core@7.60.0.json +3274 -0
  516. package/wire-changes/mods-kernel@7.59.0.json +29 -0
  517. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  518. package/wire-changes/primitives@7.59.0.json +29 -0
  519. package/wire-changes/primitives@7.60.0.json +30 -0
@@ -19,7 +19,7 @@ import { callFaceSeat } from "./tool-roster.js";
19
19
  import { wireOf } from "./tool-name-readings.js";
20
20
  import { modeAcceptsFileCommand } from "./mode-policy.js";
21
21
  import { ORG_RULE_DECISION_REASON, ORG_UNAVAILABLE_DECISION_REASON, orgUnreadableClause } from "./permission-rule-org.js";
22
- import { exitGate, passAskFace, untakenValueExit } from "./runner/gate-exit.js";
22
+ import { exitGate, passAskFace, takeSettledScreen, untakenValueExit } from "./runner/gate-exit.js";
23
23
  import { readOrgRuleLane, readPersistedRuleLane } from "./rule-lane-reads.js";
24
24
  import { traceHookCrash } from "./gate-crash-trace.js";
25
25
  import { createGateDeadline, awaitWriteProtectionJudgment, withGateTimeout } from "./gate-bounded-await.js";
@@ -193,7 +193,7 @@ export async function runGateLanes(pass) {
193
193
  };
194
194
  const chains = [
195
195
  ...(own !== undefined ? [{ raise: (p) => raiseToolCheck(own, { ...e }, p, signal), ...(mayClear !== undefined ? { mayClear } : {}) }] : []),
196
- ...(input.inheritedToolChecks ?? []).map((c) => ({ raise: (p) => raiseToolCheck(c.bus, { ...e }, p, signal, c.judges), settle: settleThroughLedger(c.settle) })),
196
+ ...(input.inheritedInstallations ?? []).map((c) => ({ raise: (p) => raiseToolCheck(c.bus, { ...e }, p, signal, c.judges), settle: settleThroughLedger(c.settle) })),
197
197
  ];
198
198
  const project = (current, clears) => {
199
199
  const reason = decisionText(current);
@@ -202,17 +202,20 @@ export async function runGateLanes(pass) {
202
202
  };
203
203
  return await readToolChecks(chains, standing, { toolName, judged: args, rewrite, request: Object.freeze({ ...pass.req, args }), signal }, project);
204
204
  };
205
- const refuseByExtension = (deny) => {
205
+ const refuseByExtension = (deny, by) => {
206
206
  pass.decision = deny;
207
207
  pass.deniedBy = settledRefusal?.deniedBy ?? "hook";
208
+ pass.deniedExtension = settledRefusal === undefined ? by : undefined;
208
209
  pass.denyCause = settledRefusal?.cause;
209
210
  };
210
- if (pass.decision.action === "allow") {
211
+ if (pass.screenApproval !== undefined && pass.decision.action !== "deny")
212
+ takeApprovedEdit({ kind: "approved", allow: pass.screenApproval });
213
+ if (pass.decision.action === "allow" && !approvedWithArgs) {
211
214
  const read = await checkTool(pass.decision, finalArgs, orgAnswer.org, pass.policyRewrite);
212
215
  if (read !== undefined)
213
216
  pass.toolCheckRaised = true;
214
217
  if (read?.kind === "denied")
215
- refuseByExtension(read.deny);
218
+ refuseByExtension(read.deny, read.by);
216
219
  else if (read?.kind === "asked")
217
220
  pass.decision = read.ask;
218
221
  else if (read?.kind === "approved")
@@ -273,6 +276,7 @@ export async function runGateLanes(pass) {
273
276
  const storedAllows = laneAnswer?.hit?.behavior === "allow" ? laneAnswer.hit.rules : undefined;
274
277
  const members = [
275
278
  ["hook", () => (pass.hookAllowedBy !== undefined ? { entries: pass.hookAllowedBy, clear: () => extensionAllowOf(pass.hookAllowedBy ?? [], pass.policyRewrite), afterClear: async () => undefined } : undefined)],
279
+ ["hook", () => (pass.inheritedAllowedBy !== undefined ? { entries: pass.inheritedAllowedBy, clear: () => extensionAllowOf(pass.inheritedAllowedBy ?? [], pass.policyRewrite), afterClear: async () => undefined, discloseOnly: true } : undefined)],
276
280
  ["deployment", () => {
277
281
  const hit = input.deploymentAllows?.allowing(pass.req, mode);
278
282
  return hit && { entries: hit.entries, ...(hit.positions !== undefined ? { positions: hit.positions } : {}), clear: () => listAllow("deployment_rule", "the deployment's", hit.entries), afterClear: () => notifier.notifyAsync(() => input.deploymentAllows?.onAllowed?.({ toolName: pass.req.toolName, toolCallId, entries: hit.entries }), "toolGate.allowedToolsResolved") };
@@ -308,7 +312,7 @@ export async function runGateLanes(pass) {
308
312
  const hit = match();
309
313
  if (hit === undefined)
310
314
  continue;
311
- if (allowMayClear()) {
315
+ if (hit.discloseOnly !== true && allowMayClear()) {
312
316
  pass.decision = await clearAs(member, hit);
313
317
  break;
314
318
  }
@@ -353,7 +357,7 @@ export async function runGateLanes(pass) {
353
357
  if (pass.toolCheckRaised !== true && pass.decision.action !== "deny") {
354
358
  const read = await checkTool(pass.decision, pass.currentInput, orgAnswer.org, pass.policyRewrite, allowMayClear);
355
359
  if (read?.kind === "denied")
356
- refuseByExtension(read.deny);
360
+ refuseByExtension(read.deny, read.by);
357
361
  else if (read?.kind === "cleared")
358
362
  pass.decision = await clearAs("hook", { entries: read.entries, clear: () => read.allow, afterClear: async () => undefined });
359
363
  else if (read?.kind === "asked") {
@@ -584,18 +588,31 @@ export async function runGateLanes(pass) {
584
588
  let rewrittenEdit = false;
585
589
  if (screening !== undefined) {
586
590
  const screened = await screening.screen(editArgs, `the approved edit for "${toolName}"`, pass.req);
591
+ if ((screened.kind !== "answered" || screened.answer?.action === "deny") && screened.judged !== undefined)
592
+ editArgs = screened.judged;
587
593
  if (screened.kind === "refused") {
588
594
  editDenied = { action: "deny", message: screened.reason };
589
595
  pass.deniedBy = "hook";
596
+ pass.deniedExtension = screened.extension;
590
597
  break;
591
598
  }
599
+ if (screened.kind === "settled") {
600
+ editDenied = takeSettledScreen(pass, screened);
601
+ break;
602
+ }
603
+ pass.preToolContext.push(...screened.contexts);
604
+ if (screened.inherited?.approved !== undefined) {
605
+ shownToApprover = { bytes: editArgs };
606
+ editArgs = screened.inherited.approved.updatedInput;
607
+ editAnswer = screened.inherited.approved;
608
+ continue;
609
+ }
592
610
  const hr = screened.answer;
593
611
  if (hr) {
594
- if (hr.additionalContext)
595
- pass.preToolContext.push(hr.additionalContext);
596
612
  if (hr.action === "deny") {
597
613
  editDenied = { action: "deny", message: decisionText(hr) ?? `the approved edit for "${toolName}" was blocked by a PreToolUse hook` };
598
614
  pass.deniedBy = "hook";
615
+ pass.deniedExtension = screened.answeredBy;
599
616
  break;
600
617
  }
601
618
  if (hr.action === "ask") {
@@ -609,6 +626,9 @@ export async function runGateLanes(pass) {
609
626
  rewrittenEdit = true;
610
627
  }
611
628
  }
629
+ const floatedAsk = screened.inherited?.floated;
630
+ if (floatedAsk !== undefined)
631
+ editHookAsk = editHookAsk !== undefined ? foldHookAsk(editHookAsk, floatedAsk) : floatedAsk;
612
632
  }
613
633
  let recheck = { action: "allow" };
614
634
  if (adjudicate) {
@@ -652,15 +672,30 @@ export async function runGateLanes(pass) {
652
672
  editArgs = policyRead.form;
653
673
  rewrittenEdit = true;
654
674
  const second = screening !== undefined ? await screenRewrite(screening, pass.req, editArgs, `the rewritten edit for "${toolName}"`) : undefined;
675
+ if ((second?.kind === "refused" || second?.kind === "settled") && second.judged !== undefined)
676
+ editArgs = second.judged;
655
677
  if (second?.kind === "refused") {
656
678
  editDenied = { action: "deny", message: second.reason };
657
679
  pass.deniedBy = "hook";
680
+ pass.deniedExtension = second.extension;
681
+ break;
682
+ }
683
+ if (second?.kind === "settled") {
684
+ editDenied = takeSettledScreen(pass, second);
658
685
  break;
659
686
  }
660
687
  if (second?.kind === "stands") {
661
- if (second.answer?.additionalContext)
662
- pass.preToolContext.push(second.answer.additionalContext);
688
+ pass.preToolContext.push(...second.contexts);
663
689
  editHookAsk = second.answer?.action === "ask" ? second.answer : undefined;
690
+ const floatedAsk = second.inherited?.floated;
691
+ if (floatedAsk !== undefined)
692
+ editHookAsk = editHookAsk !== undefined ? foldHookAsk(editHookAsk, floatedAsk) : floatedAsk;
693
+ if (second.inherited?.approved !== undefined) {
694
+ shownToApprover = { bytes: editArgs };
695
+ editArgs = second.inherited.approved.updatedInput;
696
+ editAnswer = second.inherited.approved;
697
+ continue;
698
+ }
664
699
  }
665
700
  }
666
701
  const editOrg = await applyOrgLayer(recheck, editArgs);
@@ -721,7 +756,7 @@ export async function runGateLanes(pass) {
721
756
  }
722
757
  const editRead = await checkTool(editDecision, editArgs, editOrg.org, undefined);
723
758
  if (editRead?.kind === "denied") {
724
- refuseByExtension(editRead.deny);
759
+ refuseByExtension(editRead.deny, editRead.by);
725
760
  editDenied = editRead.deny;
726
761
  break;
727
762
  }
@@ -345,6 +345,24 @@ export declare const DENIED_BY_MAY_CARRY_CAUSE: {
345
345
  };
346
346
  /** Compile-time fence: `never` while every deny layer has a cause row. */
347
347
  export type CauseTableCoversEveryDeniedBy = AssertAllKeysHandled<Exclude<DeniedBy, keyof typeof DENIED_BY_MAY_CARRY_CAUSE>>;
348
+ /** Which deny layers may name the extension whose handler ended the call ({@link GateDisposition}'s `extension`): the hook layer
349
+ * alone — an extension's `tool.check` answer or failure is a hook-layer refusal, and no other layer's verdict is an extension's.
350
+ * The mint reads it as the producer and the screen (invariant I12) as the archive: one table, two readers. Module-level only; not
351
+ * part of the package root. */
352
+ export declare const DENIED_BY_MAY_NAME_EXTENSION: {
353
+ readonly policy: false;
354
+ readonly hook: true;
355
+ readonly org: false;
356
+ readonly persisted_rule: false;
357
+ readonly classifier: false;
358
+ readonly compliance: false;
359
+ readonly write_protection: false;
360
+ readonly ask_resolution: false;
361
+ readonly read_boundary: false;
362
+ readonly mode: false;
363
+ };
364
+ /** Compile-time fence: `never` while every deny layer has an extension-naming row. */
365
+ export type ExtensionTableCoversEveryDeniedBy = AssertAllKeysHandled<Exclude<DeniedBy, keyof typeof DENIED_BY_MAY_NAME_EXTENSION>>;
348
366
  /** The final disposition of a gate pass. `cause` is present exactly when the deny came out of an auto-mode
349
367
  * classifier round that did not RULE ({@link ClassifierDenyCause}); a ruling block and every non-classifier
350
368
  * deny carry none. Invariant I5 ({@link screenGateOutcome}): a cause stands only beside a layer word in
@@ -371,7 +389,15 @@ export type CauseTableCoversEveryDeniedBy = AssertAllKeysHandled<Exclude<DeniedB
371
389
  * record is, with `positions` for a list member (the indices of those entries in the list the run received — a host maps them
372
390
  * onto the declaration it sent for this run). Present exactly when an allow member cleared a standing ask and nobody answered
373
391
  * it: absent on a call nothing asked about, a mode's release or acceptance, the read-only arm's, the classifier's or the
374
- * sandbox's allow, and a person's yes. Additive. Invariant I9 ({@link screenGateOutcome}) screens its shape. */
392
+ * sandbox's allow, and a person's yes. Additive. Invariant I9 ({@link screenGateOutcome}) screens its shape.
393
+ *
394
+ * `extension` — on the denied arm only: the registration name of the extension whose handler ended the call at the hook layer,
395
+ * by its `deny` answer (`tool.check`, `classic.PreToolUse`, `tool.call`) or by its failure (a throw, a budget overrun, an
396
+ * answer the station cannot take — the engine fails the call closed). Present exactly when `deniedBy` is `hook` and the
397
+ * refusing handler's registration is known; ABSENT beside every other layer word (an ancestor leg's screening reaches a
398
+ * descendant as a `policy` refusal, and a refusal an inherited installation's question settled is that question's), and beside
399
+ * a `hook` refusal that names no registration (the engine's own failed raise, a cancel). A display and audit fact: the call is
400
+ * refused whatever the name. Additive. Invariant I12 ({@link screenGateOutcome}) screens its shape. */
375
401
  export type GateDisposition = {
376
402
  kind: "allowed";
377
403
  classifier?: AutoModeClassifierRound;
@@ -385,6 +411,7 @@ export type GateDisposition = {
385
411
  mode?: ModeRefusal["mode"];
386
412
  askClass?: AskClass;
387
413
  classes?: readonly AskClass[];
414
+ extension?: string;
388
415
  };
389
416
  /**
390
417
  * A permission MODE released a surviving ask — the allowed disposition's account of the question it did not put
@@ -443,6 +470,8 @@ export interface ModeRefusal {
443
470
  * whole number when present, and `positions` — only on a list member (`request`, `deployment`) — a list of non-negative
444
471
  * whole numbers;
445
472
  * I10 `settlement.when` present ⇒ a finite number (epoch ms — the moment the wait ended is a value a reader can order);
473
+ * I12 `disposition.extension` present ⇒ the denied arm, a layer word {@link DENIED_BY_MAY_NAME_EXTENSION} admits (the hook layer),
474
+ * and a non-empty string (a registration's name);
446
475
  * I11 a winner's `decision` stated beside the record (the caller reads a durable row: `winnerDecision`) ⇒ a word a winner holds,
447
476
  * and its direction (allow: `allow` / `approve` / `edit`; refusal: `deny` / `reject`) is the direction of the record's
448
477
  * settlement ({@link SETTLEMENT_IS_REFUSAL}) and of its disposition (`allowed` / `denied`) — one decision, one direction.
@@ -514,7 +543,7 @@ export declare function isRetiredMember<S extends MemberSet>(set: S, word: unkno
514
543
  */
515
544
  export declare function releasePolicyDefects(g: unknown): string[];
516
545
  /** The members only the denied arm of a {@link GateDisposition} carries. */
517
- declare const DENY_ONLY_MEMBERS: readonly ["deniedBy", "cause", "mode", "askClass", "classes"];
546
+ declare const DENY_ONLY_MEMBERS: readonly ["deniedBy", "cause", "mode", "askClass", "classes", "extension"];
518
547
  type DenyOnlyMember = Exclude<keyof Extract<GateDisposition, {
519
548
  kind: "denied";
520
549
  }>, keyof Extract<GateDisposition, {
@@ -523,7 +552,7 @@ type DenyOnlyMember = Exclude<keyof Extract<GateDisposition, {
523
552
  /** Compile-time fence: `never` while the list is exactly the denied arm's own members. */
524
553
  export type DenyOnlyMembersAreListed = AssertAllKeysHandled<Exclude<DenyOnlyMember, (typeof DENY_ONLY_MEMBERS)[number]> | Exclude<(typeof DENY_ONLY_MEMBERS)[number], DenyOnlyMember>>;
525
554
  /**
526
- * The one invariant screen for a {@link GateOutcome} (I1–I11 above, plus the closed-set word each member carries). Two readings:
555
+ * The one invariant screen for a {@link GateOutcome} (I1–I12 above, plus the closed-set word each member carries). Two readings:
527
556
  * - `"archive"` (the default) — a record read back from where it was kept (a replay, a ledger, a durable row): its shape, with
528
557
  * every closed set read as its live members plus {@link RETIRED_MEMBERS}. A record lawful when minted is not a defect later.
529
558
  * - `"producer"` — a record THIS engine is composing or publishing now: the live sets alone, and the engine's release law
@@ -119,6 +119,18 @@ export const DENIED_BY_MAY_CARRY_CAUSE = {
119
119
  read_boundary: false,
120
120
  mode: false,
121
121
  };
122
+ export const DENIED_BY_MAY_NAME_EXTENSION = {
123
+ policy: false,
124
+ hook: true,
125
+ org: false,
126
+ persisted_rule: false,
127
+ classifier: false,
128
+ compliance: false,
129
+ write_protection: false,
130
+ ask_resolution: false,
131
+ read_boundary: false,
132
+ mode: false,
133
+ };
122
134
  const retired = (word, retiredIn) => Object.freeze({ word, retiredIn });
123
135
  export const RETIRED_MEMBERS = Object.freeze({
124
136
  askClass: Object.freeze([retired("write_protection_unresolved", "7.49.0"), retired("governance_unavailable", "7.51.0")]),
@@ -189,7 +201,7 @@ function clearanceDefects(v, settled, released) {
189
201
  }
190
202
  return out;
191
203
  }
192
- const DENY_ONLY_MEMBERS = Object.freeze(["deniedBy", "cause", "mode", "askClass", "classes"]);
204
+ const DENY_ONLY_MEMBERS = Object.freeze(["deniedBy", "cause", "mode", "askClass", "classes", "extension"]);
193
205
  function objectOf(v) {
194
206
  return typeof v === "object" && v !== null && !Array.isArray(v) ? v : undefined;
195
207
  }
@@ -303,6 +315,12 @@ export function screenGateOutcome(g, opts) {
303
315
  }
304
316
  if (modeRefusal && (denied.askClass === undefined || denied.classes === undefined))
305
317
  defects.push("I8: a mode refusal carries askClass and classes");
318
+ if (denied.extension !== undefined) {
319
+ if (typeof denied.extension !== "string" || denied.extension === "")
320
+ defects.push(`I12: disposition.extension ${spelled(denied.extension)} is not a registration name (a non-empty string)`);
321
+ if (layer && !(isDeniedBy(denied.deniedBy) && DENIED_BY_MAY_NAME_EXTENSION[denied.deniedBy]))
322
+ defects.push(`I12: an extension cannot be named beside deniedBy "${String(denied.deniedBy)}"`);
323
+ }
306
324
  if (denied.askClass !== undefined && !member("askClass", denied.askClass))
307
325
  defects.push(outside("disposition.askClass", "askClass", denied.askClass));
308
326
  if (denied.classes !== undefined && !classList(denied.classes))
@@ -145,7 +145,7 @@ export type NoticeAudience = "user" | "operator";
145
145
  * the union's catalog ({@link EngineNotice.code}). The groups below say only which family a row joins,
146
146
  * so the catalog is not written a second time here and the two cannot drift.
147
147
  */
148
- export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "context.tool_turn_repaired", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "instructions.source_changed", "session.records_skipped", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
148
+ export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.image_removed", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "config.image_processor_unavailable", "instructions.source_changed", "session.records_skipped", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
149
149
  /** A catalogued code (see {@link ENGINE_NOTICE_CODES}); {@link NOTICE_MINTER} says who mints it. NOT the type of
150
150
  * `EngineNotice.code`, which stays `string` — a host forwarding its own notices through the same
151
151
  * sink is a supported shape, and narrowing that field would break it. */
@@ -175,6 +175,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
175
175
  readonly "classifier.denial_limit": "user";
176
176
  readonly "classifier.unavailable": "user";
177
177
  readonly "classifier.fallback": "operator";
178
+ readonly "classifier.seat_rate_limited": "operator";
178
179
  readonly "classifier.role_defaulted": "operator";
179
180
  readonly "classifier.contract_broken": "operator";
180
181
  readonly "task.turn_interrupted": "user";
@@ -220,6 +221,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
220
221
  readonly "config.write_protection_target_view_absent": "operator";
221
222
  readonly "config.path_view_unresolved": "operator";
222
223
  readonly "config.execution_env_capability_invalid": "operator";
224
+ readonly "config.read_deny_floor_unkept": "operator";
223
225
  readonly "config.tool_card_undeclared": "operator";
224
226
  readonly "config.tool_face_undeclared": "operator";
225
227
  readonly "config.tool_face_invalid": "operator";
@@ -237,6 +239,8 @@ declare const NOTICE_AUDIENCE_TABLE: {
237
239
  readonly "mcp.injection_dropped": "user";
238
240
  readonly "mcp.revocation_probe_failed": "operator";
239
241
  readonly "mcp.server_redialed": "operator";
242
+ readonly "mcp.authorization_required": "user";
243
+ readonly "mcp.credential_echoed": "operator";
240
244
  readonly "workflow.governance_key_stripped": "operator";
241
245
  readonly "workflow.agent_option_ignored": "operator";
242
246
  readonly "memory.content_class_declared": "operator";
@@ -250,16 +254,20 @@ declare const NOTICE_AUDIENCE_TABLE: {
250
254
  readonly "route.fallback_to_primary": "operator";
251
255
  readonly "route.classifier_unroutable": "operator";
252
256
  readonly "route.seat_detached": "operator";
257
+ readonly "route.credential_rebound": "operator";
253
258
  readonly "advisor.not_attached": "user";
254
259
  readonly "route.response_model_mismatch": "operator";
255
260
  readonly "route.tool_call_id_folded": "operator";
256
261
  readonly "route.extra_body_reserved_dropped": "operator";
257
262
  readonly "model.capability_downgraded": "user";
263
+ readonly "model.role_defaulted": "operator";
258
264
  readonly "context.tool_turn_repaired": "operator";
265
+ readonly "context.image_removed": "user";
259
266
  readonly "skills.listing_truncated": "operator";
260
267
  readonly "agents.listing_truncated": "operator";
261
268
  readonly "tool_result.offload_put_failed": "operator";
262
269
  readonly "tool_result.media_refused": "operator";
270
+ readonly "config.image_processor_unavailable": "operator";
263
271
  readonly "config.forward_sink_failed": "operator";
264
272
  readonly "instructions.source_changed": "user";
265
273
  readonly "session.records_skipped": "user";
@@ -309,6 +317,7 @@ declare const NOTICE_MINTER_TABLE: {
309
317
  readonly "config.write_protection_target_view_absent": "engine";
310
318
  readonly "config.path_view_unresolved": "engine";
311
319
  readonly "config.execution_env_capability_invalid": "engine";
320
+ readonly "config.read_deny_floor_unkept": "engine";
312
321
  readonly "config.tool_card_undeclared": "engine";
313
322
  readonly "config.tool_face_undeclared": "engine";
314
323
  readonly "config.tool_face_invalid": "engine";
@@ -334,6 +343,7 @@ declare const NOTICE_MINTER_TABLE: {
334
343
  readonly "peer.idle_subscription": "engine";
335
344
  readonly "classifier.denial_limit": "engine";
336
345
  readonly "classifier.fallback": "engine";
346
+ readonly "classifier.seat_rate_limited": "engine";
337
347
  readonly "classifier.role_defaulted": "engine";
338
348
  readonly "classifier.contract_broken": "engine";
339
349
  readonly "classifier.unavailable": "engine";
@@ -343,6 +353,8 @@ declare const NOTICE_MINTER_TABLE: {
343
353
  readonly "mcp.injection_dropped": "engine";
344
354
  readonly "mcp.revocation_probe_failed": "engine";
345
355
  readonly "mcp.server_redialed": "engine";
356
+ readonly "mcp.authorization_required": "engine";
357
+ readonly "mcp.credential_echoed": "engine";
346
358
  readonly "workflow.governance_key_stripped": "engine";
347
359
  readonly "workflow.agent_option_ignored": "engine";
348
360
  readonly "memory.session_polluted": "engine";
@@ -365,13 +377,16 @@ declare const NOTICE_MINTER_TABLE: {
365
377
  readonly "route.seat_detached": "engine";
366
378
  readonly "advisor.not_attached": "engine";
367
379
  readonly "route.credential_origin_mismatch": "engine";
380
+ readonly "route.credential_rebound": "engine";
368
381
  readonly "route.response_model_mismatch": "engine";
369
382
  readonly "route.tool_call_id_folded": "engine";
370
383
  readonly "route.finish_reason_unknown": "engine";
371
384
  readonly "route.stream_end_ignored": "engine";
372
385
  readonly "route.extra_body_reserved_dropped": "engine";
373
386
  readonly "model.capability_downgraded": "engine";
387
+ readonly "model.role_defaulted": "engine";
374
388
  readonly "context.tool_turn_repaired": "engine";
389
+ readonly "context.image_removed": "engine";
375
390
  readonly "task.user_steer_undrained": "engine";
376
391
  readonly "task.user_followup_undrained": "engine";
377
392
  readonly "steering.parked_input_blocked": "engine";
@@ -388,6 +403,7 @@ declare const NOTICE_MINTER_TABLE: {
388
403
  readonly "agents.listing_truncated": "engine";
389
404
  readonly "tool_result.offload_put_failed": "engine";
390
405
  readonly "tool_result.media_refused": "engine";
406
+ readonly "config.image_processor_unavailable": "engine";
391
407
  readonly "instructions.source_changed": "server";
392
408
  readonly "session.records_skipped": "server";
393
409
  readonly "memory.layer_locked_legacy": "server";
@@ -15,6 +15,7 @@ export const NON_GOVERNANCE_MEMORY_CODES = new Set([
15
15
  "memory.secret_detected",
16
16
  "memory.promotable_ungated",
17
17
  "memory.announce_failed",
18
+ "memory.announcement_withheld",
18
19
  "memory.partition_adopt_failed",
19
20
  "memory.partition_split",
20
21
  "memory.layout_migrated",
@@ -141,6 +142,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
141
142
  "config.write_protection_target_view_absent",
142
143
  "config.path_view_unresolved",
143
144
  "config.execution_env_capability_invalid",
145
+ "config.read_deny_floor_unkept",
144
146
  "config.tool_card_undeclared",
145
147
  "config.tool_face_undeclared",
146
148
  "config.tool_face_invalid",
@@ -166,6 +168,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
166
168
  "peer.idle_subscription",
167
169
  "classifier.denial_limit",
168
170
  "classifier.fallback",
171
+ "classifier.seat_rate_limited",
169
172
  "classifier.role_defaulted",
170
173
  "classifier.contract_broken",
171
174
  "classifier.unavailable",
@@ -175,6 +178,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
175
178
  "mcp.injection_dropped",
176
179
  "mcp.revocation_probe_failed",
177
180
  "mcp.server_redialed",
181
+ "mcp.authorization_required",
182
+ "mcp.credential_echoed",
178
183
  "workflow.governance_key_stripped",
179
184
  "workflow.agent_option_ignored",
180
185
  "memory.session_polluted",
@@ -197,13 +202,16 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
197
202
  "route.seat_detached",
198
203
  "advisor.not_attached",
199
204
  "route.credential_origin_mismatch",
205
+ "route.credential_rebound",
200
206
  "route.response_model_mismatch",
201
207
  "route.tool_call_id_folded",
202
208
  "route.finish_reason_unknown",
203
209
  "route.stream_end_ignored",
204
210
  "route.extra_body_reserved_dropped",
205
211
  "model.capability_downgraded",
212
+ "model.role_defaulted",
206
213
  "context.tool_turn_repaired",
214
+ "context.image_removed",
207
215
  "task.user_steer_undrained",
208
216
  "task.user_followup_undrained",
209
217
  "steering.parked_input_blocked",
@@ -220,6 +228,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
220
228
  "agents.listing_truncated",
221
229
  "tool_result.offload_put_failed",
222
230
  "tool_result.media_refused",
231
+ "config.image_processor_unavailable",
223
232
  "instructions.source_changed",
224
233
  "session.records_skipped",
225
234
  "memory.layer_locked_legacy",
@@ -238,6 +247,7 @@ const NOTICE_AUDIENCE_TABLE = {
238
247
  "classifier.denial_limit": "user",
239
248
  "classifier.unavailable": "user",
240
249
  "classifier.fallback": "operator",
250
+ "classifier.seat_rate_limited": "operator",
241
251
  "classifier.role_defaulted": "operator",
242
252
  "classifier.contract_broken": "operator",
243
253
  "task.turn_interrupted": "user",
@@ -283,6 +293,7 @@ const NOTICE_AUDIENCE_TABLE = {
283
293
  "config.write_protection_target_view_absent": "operator",
284
294
  "config.path_view_unresolved": "operator",
285
295
  "config.execution_env_capability_invalid": "operator",
296
+ "config.read_deny_floor_unkept": "operator",
286
297
  "config.tool_card_undeclared": "operator",
287
298
  "config.tool_face_undeclared": "operator",
288
299
  "config.tool_face_invalid": "operator",
@@ -300,6 +311,8 @@ const NOTICE_AUDIENCE_TABLE = {
300
311
  "mcp.injection_dropped": "user",
301
312
  "mcp.revocation_probe_failed": "operator",
302
313
  "mcp.server_redialed": "operator",
314
+ "mcp.authorization_required": "user",
315
+ "mcp.credential_echoed": "operator",
303
316
  "workflow.governance_key_stripped": "operator",
304
317
  "workflow.agent_option_ignored": "operator",
305
318
  "memory.content_class_declared": "operator",
@@ -313,16 +326,20 @@ const NOTICE_AUDIENCE_TABLE = {
313
326
  "route.fallback_to_primary": "operator",
314
327
  "route.classifier_unroutable": "operator",
315
328
  "route.seat_detached": "operator",
329
+ "route.credential_rebound": "operator",
316
330
  "advisor.not_attached": "user",
317
331
  "route.response_model_mismatch": "operator",
318
332
  "route.tool_call_id_folded": "operator",
319
333
  "route.extra_body_reserved_dropped": "operator",
320
334
  "model.capability_downgraded": "user",
335
+ "model.role_defaulted": "operator",
321
336
  "context.tool_turn_repaired": "operator",
337
+ "context.image_removed": "user",
322
338
  "skills.listing_truncated": "operator",
323
339
  "agents.listing_truncated": "operator",
324
340
  "tool_result.offload_put_failed": "operator",
325
341
  "tool_result.media_refused": "operator",
342
+ "config.image_processor_unavailable": "operator",
326
343
  "config.forward_sink_failed": "operator",
327
344
  "instructions.source_changed": "user",
328
345
  "session.records_skipped": "user",
@@ -353,6 +370,7 @@ const NOTICE_MINTER_TABLE = {
353
370
  "config.write_protection_target_view_absent": "engine",
354
371
  "config.path_view_unresolved": "engine",
355
372
  "config.execution_env_capability_invalid": "engine",
373
+ "config.read_deny_floor_unkept": "engine",
356
374
  "config.tool_card_undeclared": "engine",
357
375
  "config.tool_face_undeclared": "engine",
358
376
  "config.tool_face_invalid": "engine",
@@ -378,6 +396,7 @@ const NOTICE_MINTER_TABLE = {
378
396
  "peer.idle_subscription": "engine",
379
397
  "classifier.denial_limit": "engine",
380
398
  "classifier.fallback": "engine",
399
+ "classifier.seat_rate_limited": "engine",
381
400
  "classifier.role_defaulted": "engine",
382
401
  "classifier.contract_broken": "engine",
383
402
  "classifier.unavailable": "engine",
@@ -387,6 +406,8 @@ const NOTICE_MINTER_TABLE = {
387
406
  "mcp.injection_dropped": "engine",
388
407
  "mcp.revocation_probe_failed": "engine",
389
408
  "mcp.server_redialed": "engine",
409
+ "mcp.authorization_required": "engine",
410
+ "mcp.credential_echoed": "engine",
390
411
  "workflow.governance_key_stripped": "engine",
391
412
  "workflow.agent_option_ignored": "engine",
392
413
  "memory.session_polluted": "engine",
@@ -409,13 +430,16 @@ const NOTICE_MINTER_TABLE = {
409
430
  "route.seat_detached": "engine",
410
431
  "advisor.not_attached": "engine",
411
432
  "route.credential_origin_mismatch": "engine",
433
+ "route.credential_rebound": "engine",
412
434
  "route.response_model_mismatch": "engine",
413
435
  "route.tool_call_id_folded": "engine",
414
436
  "route.finish_reason_unknown": "engine",
415
437
  "route.stream_end_ignored": "engine",
416
438
  "route.extra_body_reserved_dropped": "engine",
417
439
  "model.capability_downgraded": "engine",
440
+ "model.role_defaulted": "engine",
418
441
  "context.tool_turn_repaired": "engine",
442
+ "context.image_removed": "engine",
419
443
  "task.user_steer_undrained": "engine",
420
444
  "task.user_followup_undrained": "engine",
421
445
  "steering.parked_input_blocked": "engine",
@@ -432,6 +456,7 @@ const NOTICE_MINTER_TABLE = {
432
456
  "agents.listing_truncated": "engine",
433
457
  "tool_result.offload_put_failed": "engine",
434
458
  "tool_result.media_refused": "engine",
459
+ "config.image_processor_unavailable": "engine",
435
460
  "instructions.source_changed": "server",
436
461
  "session.records_skipped": "server",
437
462
  "memory.layer_locked_legacy": "server",
@@ -1,7 +1,6 @@
1
1
  const HANDS_BAND_MEMBERS = {
2
2
  bashReadonlyAllow: { takes: "a list of command-name strings", ok: (v) => Array.isArray(v) && v.every((c) => typeof c === "string") },
3
3
  commitCoAuthor: { takes: "a string or false", ok: (v) => typeof v === "string" || v === false },
4
- readImageDownsampler: { takes: "a function or false", ok: (v) => typeof v === "function" || v === false },
5
4
  beforeWrite: { takes: "a function", ok: (v) => typeof v === "function" },
6
5
  autoBackgroundOnTimeout: { takes: "a boolean", ok: (v) => typeof v === "boolean" },
7
6
  };
@@ -104,9 +104,6 @@ export interface HandsBandOptions {
104
104
  /** Co-Authored-By trailer for the bash git protocol. Default NONE ([c209] BREAKING: attribution is a
105
105
  * deployment identity asset — the branded scenario sets `"Name <email>"`); `false` ≡ unset. */
106
106
  commitCoAuthor?: string | false;
107
- /** Read-tool image downsampler: inject your own, or `false` to force-disable (deterministic no-sharp).
108
- * Omitted ⇒ auto-detect sharp. Same contract as the MCP-side {@link import("./mcp.js").ImageDownsampler}. */
109
- readImageDownsampler?: ((input: Buffer, mimeType: string) => Promise<import("./mcp.js").DownsampledImage | undefined>) | false;
110
107
  /** Deployment write gate — COMPOSED with (never replacing) the engine's MemoryEngine write-scan gate:
111
108
  * this hook judges first (a rejection short-circuits), the engine gate then still runs in full. */
112
109
  beforeWrite?: BeforeWriteHook;