@sema-agent/core 7.60.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/CHANGELOG.md +605 -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 +61 -10
  6. package/dist/agents/cascade.js +60 -20
  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-notice-route.d.ts +1 -1
  17. package/dist/agents/peer-notice-route.js +4 -3
  18. package/dist/agents/peer-notices.d.ts +4 -4
  19. package/dist/agents/peer-notices.js +8 -4
  20. package/dist/agents/peer-session-drain.d.ts +8 -1
  21. package/dist/agents/peer-session-drain.js +36 -7
  22. package/dist/agents/repair-loop.js +16 -6
  23. package/dist/agents/retain-ledger.js +3 -1
  24. package/dist/agents/roster-store.d.ts +1 -1
  25. package/dist/agents/roster-store.js +7 -4
  26. package/dist/agents/send-message-tool.d.ts +8 -10
  27. package/dist/agents/send-message-tool.js +43 -23
  28. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  29. package/dist/agents/subagent-completion-gate.js +62 -0
  30. package/dist/agents/subagent-steps.d.ts +7 -6
  31. package/dist/agents/subagent.d.ts +30 -40
  32. package/dist/agents/subagent.js +187 -196
  33. package/dist/agents/suspend-guard.d.ts +9 -0
  34. package/dist/agents/suspend-guard.js +4 -0
  35. package/dist/agents/verify.d.ts +41 -14
  36. package/dist/agents/verify.js +37 -27
  37. package/dist/brain/anthropic.js +1 -0
  38. package/dist/brain/errors.d.ts +7 -1
  39. package/dist/brain/errors.js +6 -0
  40. package/dist/brain/failover.js +2 -1
  41. package/dist/brain/open-responses.js +1 -0
  42. package/dist/brain/openai.js +1 -0
  43. package/dist/brain/provider-dialect.d.ts +10 -0
  44. package/dist/brain/provider-dialect.js +13 -2
  45. package/dist/brain/stream-engine.d.ts +3 -0
  46. package/dist/brain/stream-engine.js +4 -0
  47. package/dist/core/agent-state.d.ts +1 -1
  48. package/dist/core/allow-entry.d.ts +59 -23
  49. package/dist/core/allow-entry.js +131 -38
  50. package/dist/core/ask-origin.d.ts +79 -0
  51. package/dist/core/ask-origin.js +76 -0
  52. package/dist/core/ask-question.d.ts +19 -13
  53. package/dist/core/ask-question.js +8 -2
  54. package/dist/core/auto-compaction.d.ts +2 -0
  55. package/dist/core/auto-compaction.js +2 -1
  56. package/dist/core/auto-mode.js +3 -5
  57. package/dist/core/background-agent-store.d.ts +7 -5
  58. package/dist/core/background-agent-store.js +12 -11
  59. package/dist/core/checkpoint-requirements.d.ts +24 -3
  60. package/dist/core/checkpoint-requirements.js +9 -1
  61. package/dist/core/checkpoint-store.d.ts +78 -19
  62. package/dist/core/checkpoint-store.js +8 -4
  63. package/dist/core/child-clamp-seats.d.ts +3 -2
  64. package/dist/core/child-clamp-seats.js +4 -3
  65. package/dist/core/closest-name.d.ts +13 -0
  66. package/dist/core/closest-name.js +35 -0
  67. package/dist/core/context-settings.js +3 -5
  68. package/dist/core/cross-boundary-taint.d.ts +1 -1
  69. package/dist/core/decision-receipt.d.ts +14 -1
  70. package/dist/core/decision-receipt.js +6 -3
  71. package/dist/core/delegation-frames.d.ts +13 -9
  72. package/dist/core/effective-path-target.js +2 -3
  73. package/dist/core/engine-attestation.d.ts +11 -1
  74. package/dist/core/engine-attestation.js +2 -0
  75. package/dist/core/engine-notice.d.ts +49 -18
  76. package/dist/core/file-history-retention.d.ts +8 -0
  77. package/dist/core/file-history-retention.js +14 -11
  78. package/dist/core/file-history-store.d.ts +31 -1
  79. package/dist/core/file-history-store.js +31 -2
  80. package/dist/core/frame-settlement.d.ts +10 -0
  81. package/dist/core/frame-settlement.js +6 -1
  82. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  83. package/dist/core/fs-write-gate-policy.js +8 -7
  84. package/dist/core/gate-fold.js +2 -1
  85. package/dist/core/gate-lanes.js +7 -4
  86. package/dist/core/gate-outcome.d.ts +40 -1
  87. package/dist/core/gate-outcome.js +10 -0
  88. package/dist/core/git-worktree-env.d.ts +7 -3
  89. package/dist/core/git-worktree-env.js +16 -13
  90. package/dist/core/governance-codes.d.ts +12 -4
  91. package/dist/core/governance-codes.js +16 -4
  92. package/dist/core/hooks.d.ts +12 -4
  93. package/dist/core/hooks.js +11 -4
  94. package/dist/core/host-floor.js +3 -5
  95. package/dist/core/image-admission.d.ts +48 -8
  96. package/dist/core/image-admission.js +35 -4
  97. package/dist/core/input-author.d.ts +36 -0
  98. package/dist/core/input-author.js +39 -0
  99. package/dist/core/leg-identity.d.ts +62 -0
  100. package/dist/core/leg-identity.js +18 -0
  101. package/dist/core/locked-config.d.ts +2 -1
  102. package/dist/core/locked-config.js +5 -3
  103. package/dist/core/lsp.d.ts +5 -3
  104. package/dist/core/lsp.js +3 -2
  105. package/dist/core/mailbox-store.d.ts +85 -10
  106. package/dist/core/mailbox-store.js +31 -10
  107. package/dist/core/mcp-connection-pool.d.ts +6 -20
  108. package/dist/core/mcp-connection-pool.js +10 -28
  109. package/dist/core/mcp-failure.d.ts +76 -15
  110. package/dist/core/mcp-failure.js +60 -33
  111. package/dist/core/mcp-host-seat.d.ts +92 -53
  112. package/dist/core/mcp-host-seat.js +220 -46
  113. package/dist/core/mcp-probe.js +2 -2
  114. package/dist/core/mcp-server-link.d.ts +18 -6
  115. package/dist/core/mcp-server-link.js +19 -4
  116. package/dist/core/mcp-server-spec.d.ts +2 -1
  117. package/dist/core/mcp-session-end.d.ts +1 -2
  118. package/dist/core/mcp-session-end.js +1 -1
  119. package/dist/core/mcp.d.ts +6 -49
  120. package/dist/core/mcp.js +115 -111
  121. package/dist/core/media-byte-cap.d.ts +21 -46
  122. package/dist/core/media-byte-cap.js +55 -55
  123. package/dist/core/member-group.d.ts +7 -0
  124. package/dist/core/member-group.js +35 -0
  125. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  126. package/dist/core/memory-engine/consolidation.js +7 -1
  127. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  128. package/dist/core/memory-engine/dual-root.js +59 -11
  129. package/dist/core/memory-engine/engine.js +27 -24
  130. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  131. package/dist/core/memory-engine/file-backend.js +35 -15
  132. package/dist/core/memory-engine/layout.d.ts +3 -0
  133. package/dist/core/memory-engine/layout.js +13 -3
  134. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  135. package/dist/core/memory-engine/memory-deployment.js +182 -0
  136. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  137. package/dist/core/memory-engine/sync-client.js +72 -14
  138. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  139. package/dist/core/memory-engine/sync.d.ts +9 -1
  140. package/dist/core/mode-policy.d.ts +8 -8
  141. package/dist/core/mode-policy.js +7 -5
  142. package/dist/core/mods/agent-stations.d.ts +39 -4
  143. package/dist/core/mods/agent-stations.js +59 -10
  144. package/dist/core/mods/dollar.d.ts +62 -0
  145. package/dist/core/mods/extension-call.d.ts +15 -1
  146. package/dist/core/mods/extension-call.js +7 -2
  147. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  148. package/dist/core/mods/kernel/dispatch.js +4 -4
  149. package/dist/core/mods/kernel/events.d.ts +4 -1
  150. package/dist/core/mods/kernel/events.js +6 -6
  151. package/dist/core/mods/kernel/registration.d.ts +3 -0
  152. package/dist/core/mods/kernel/registration.js +5 -0
  153. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  154. package/dist/core/mods/kernel/site-rules.js +10 -2
  155. package/dist/core/mods/session-append.d.ts +115 -0
  156. package/dist/core/mods/session-append.js +311 -0
  157. package/dist/core/mods/session-compact.d.ts +48 -0
  158. package/dist/core/mods/session-compact.js +194 -0
  159. package/dist/core/mods/session-receive.d.ts +93 -0
  160. package/dist/core/mods/session-receive.js +141 -0
  161. package/dist/core/mods/session-send.d.ts +72 -0
  162. package/dist/core/mods/session-send.js +88 -0
  163. package/dist/core/mods/stations.d.ts +38 -16
  164. package/dist/core/mods/stations.js +25 -11
  165. package/dist/core/mods/tool-call.d.ts +2 -0
  166. package/dist/core/mods/tool-call.js +4 -4
  167. package/dist/core/output-style.js +3 -4
  168. package/dist/core/own-property-receipt.d.ts +61 -2
  169. package/dist/core/own-property-receipt.js +42 -2
  170. package/dist/core/park-selfcheck.js +4 -2
  171. package/dist/core/path-identity.d.ts +11 -0
  172. package/dist/core/path-identity.js +4 -0
  173. package/dist/core/path-rule-binding.d.ts +3 -1
  174. package/dist/core/path-rule-binding.js +3 -1
  175. package/dist/core/peer-seat.d.ts +3 -3
  176. package/dist/core/peer-seat.js +20 -8
  177. package/dist/core/permission-rule-consent.d.ts +21 -5
  178. package/dist/core/permission-rule-consent.js +21 -1
  179. package/dist/core/permission-rule-model.d.ts +34 -11
  180. package/dist/core/permission-rule-model.js +47 -10
  181. package/dist/core/permission-rule-org.d.ts +1 -1
  182. package/dist/core/permission-rule-provider.js +4 -1
  183. package/dist/core/permission-rules.d.ts +4 -0
  184. package/dist/core/permission-rules.js +11 -16
  185. package/dist/core/remote-env.d.ts +74 -26
  186. package/dist/core/remote-env.js +20 -0
  187. package/dist/core/retention-policy.d.ts +24 -23
  188. package/dist/core/retention-policy.js +36 -2
  189. package/dist/core/retention.d.ts +4 -1
  190. package/dist/core/retired-keys.d.ts +4 -4
  191. package/dist/core/row-admission.d.ts +10 -0
  192. package/dist/core/row-admission.js +5 -0
  193. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  194. package/dist/core/runner/advisor-instructions.js +2 -1
  195. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  196. package/dist/core/runner/assemble-result.d.ts +13 -3
  197. package/dist/core/runner/assemble-result.js +12 -7
  198. package/dist/core/runner/caller-roster.d.ts +12 -9
  199. package/dist/core/runner/caller-roster.js +5 -2
  200. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  201. package/dist/core/runner/checkpoint-scope.js +21 -0
  202. package/dist/core/runner/compact-session.js +14 -2
  203. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  204. package/dist/core/runner/compaction-restate.d.ts +2 -2
  205. package/dist/core/runner/compaction-restate.js +4 -3
  206. package/dist/core/runner/construction-doors.d.ts +2 -2
  207. package/dist/core/runner/construction-doors.js +2 -2
  208. package/dist/core/runner/contracts.d.ts +98 -26
  209. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  210. package/dist/core/runner/decide-continuation.d.ts +4 -2
  211. package/dist/core/runner/decide-continuation.js +7 -4
  212. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  213. package/dist/core/runner/denial-limit-arms.js +17 -10
  214. package/dist/core/runner/expire-settle.d.ts +44 -0
  215. package/dist/core/runner/expire-settle.js +55 -0
  216. package/dist/core/runner/git-status-frame.d.ts +3 -3
  217. package/dist/core/runner/git-status-frame.js +2 -1
  218. package/dist/core/runner/halt-attribution.d.ts +2 -1
  219. package/dist/core/runner/halt-attribution.js +2 -1
  220. package/dist/core/runner/local-claims.d.ts +17 -0
  221. package/dist/core/runner/local-claims.js +18 -0
  222. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  223. package/dist/core/runner/media-removed-seat.js +88 -0
  224. package/dist/core/runner/park-commit.d.ts +2 -2
  225. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  226. package/dist/core/runner/permission-rule-lanes.js +28 -9
  227. package/dist/core/runner/person-path-rows.js +1 -1
  228. package/dist/core/runner/placement-fence.d.ts +26 -0
  229. package/dist/core/runner/placement-fence.js +38 -0
  230. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  231. package/dist/core/runner/prepare-ask-lane.js +4 -4
  232. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  233. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  234. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  235. package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
  236. package/dist/core/runner/prepare-config-doors.js +16 -17
  237. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  238. package/dist/core/runner/prepare-context-lane.js +13 -13
  239. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  240. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  241. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  242. package/dist/core/runner/prepare-execution-env.js +7 -4
  243. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  244. package/dist/core/runner/prepare-gate-stations.js +6 -4
  245. package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
  246. package/dist/core/runner/prepare-hands-readface.js +4 -4
  247. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
  248. package/dist/core/runner/prepare-inherited-gate.js +3 -0
  249. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  250. package/dist/core/runner/prepare-lsp.js +2 -2
  251. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  252. package/dist/core/runner/prepare-park-ask.js +4 -5
  253. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  254. package/dist/core/runner/prepare-policy-chain.js +16 -25
  255. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  256. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  257. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  258. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  259. package/dist/core/runner/prepare-question-face.js +2 -2
  260. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  261. package/dist/core/runner/prepare-run-refs.js +2 -2
  262. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  263. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  264. package/dist/core/runner/prepare-task.d.ts +1 -1
  265. package/dist/core/runner/prepare-task.js +56 -28
  266. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  267. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  268. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  269. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  270. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  271. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  272. package/dist/core/runner/read-root-grant.d.ts +1 -1
  273. package/dist/core/runner/read-root-grant.js +2 -1
  274. package/dist/core/runner/resume-admission.d.ts +5 -3
  275. package/dist/core/runner/resume-admission.js +17 -3
  276. package/dist/core/runner/resume-apply.js +3 -1
  277. package/dist/core/runner/resume-claim.d.ts +8 -3
  278. package/dist/core/runner/resume-claim.js +28 -12
  279. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  280. package/dist/core/runner/resume-internals-and-config.js +10 -1
  281. package/dist/core/runner/resume-preflight.d.ts +3 -2
  282. package/dist/core/runner/resume-preflight.js +13 -26
  283. package/dist/core/runner/retired-runner-deps.js +2 -0
  284. package/dist/core/runner/run-git-lane.js +2 -1
  285. package/dist/core/runner/run-harness-handlers.js +2 -2
  286. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  287. package/dist/core/runner/run-identity-wiring.js +14 -5
  288. package/dist/core/runner/run-leg.d.ts +3 -3
  289. package/dist/core/runner/run-leg.js +40 -29
  290. package/dist/core/runner/run-notification-lane.js +20 -2
  291. package/dist/core/runner/run-recovery-lanes.js +3 -2
  292. package/dist/core/runner/run-settle-and-teardown.js +9 -7
  293. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  294. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  295. package/dist/core/runner/run-terminal-adoption.js +26 -17
  296. package/dist/core/runner/run-turn-boundary.js +27 -14
  297. package/dist/core/runner/runtask.d.ts +18 -3
  298. package/dist/core/runner/runtask.js +27 -11
  299. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  300. package/dist/core/runner/session-rule-policy.js +6 -1
  301. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  302. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  303. package/dist/core/runner/stream-halt-verbs.js +4 -3
  304. package/dist/core/runner/stream-reap.d.ts +7 -6
  305. package/dist/core/runner/stream-reap.js +13 -16
  306. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  307. package/dist/core/runner/stream-settle-backstop.js +5 -3
  308. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  309. package/dist/core/runner/stream-steer-verb.js +8 -7
  310. package/dist/core/runner/terminal-account.d.ts +11 -1
  311. package/dist/core/runner/terminal-account.js +20 -0
  312. package/dist/core/runner/terminal-projection.d.ts +8 -2
  313. package/dist/core/runner/terminal-projection.js +2 -2
  314. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  315. package/dist/core/runner/tool-disclosure.js +5 -2
  316. package/dist/core/runner/tool-end-body.d.ts +3 -3
  317. package/dist/core/runner/tool-end-body.js +1 -1
  318. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  319. package/dist/core/runner/tool-output-projection.js +7 -6
  320. package/dist/core/runner/tool-table-view.d.ts +56 -0
  321. package/dist/core/runner/tool-table-view.js +51 -0
  322. package/dist/core/runner/turn-attachments.d.ts +3 -2
  323. package/dist/core/runner/turn-attachments.js +1 -1
  324. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  325. package/dist/core/runner/void-verifier-pause.js +41 -0
  326. package/dist/core/runner-deps.d.ts +24 -25
  327. package/dist/core/secret-env.d.ts +11 -11
  328. package/dist/core/secret-env.js +8 -9
  329. package/dist/core/session-log-transfer.js +9 -10
  330. package/dist/core/session-policy-store.d.ts +1 -1
  331. package/dist/core/session-policy-store.js +5 -2
  332. package/dist/core/session-reconcile.d.ts +3 -2
  333. package/dist/core/session-reconcile.js +7 -4
  334. package/dist/core/session-store.d.ts +2 -0
  335. package/dist/core/session-store.js +5 -7
  336. package/dist/core/session.d.ts +2 -1
  337. package/dist/core/shell-confinement.d.ts +37 -0
  338. package/dist/core/shell-confinement.js +56 -0
  339. package/dist/core/skill-grant.js +1 -1
  340. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  341. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  342. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  343. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  344. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  345. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  346. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  347. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  348. package/dist/core/task-event.d.ts +17 -8
  349. package/dist/core/task-limits.d.ts +5 -0
  350. package/dist/core/task-notification.d.ts +89 -12
  351. package/dist/core/task-notification.js +87 -13
  352. package/dist/core/task-registry-agent.d.ts +5 -43
  353. package/dist/core/task-registry-agent.js +24 -51
  354. package/dist/core/task-registry-monitor.d.ts +1 -1
  355. package/dist/core/task-registry-monitor.js +15 -60
  356. package/dist/core/task-registry-shared.d.ts +15 -112
  357. package/dist/core/task-registry-shared.js +3 -41
  358. package/dist/core/task-registry-workflow.js +4 -21
  359. package/dist/core/task-registry.d.ts +19 -60
  360. package/dist/core/task-registry.js +19 -106
  361. package/dist/core/task-result.d.ts +24 -7
  362. package/dist/core/task-spec-members.d.ts +39 -0
  363. package/dist/core/task-spec-members.js +92 -0
  364. package/dist/core/task-spec.d.ts +10 -10
  365. package/dist/core/task-tool-shape.d.ts +7 -57
  366. package/dist/core/task-tool-shape.js +7 -66
  367. package/dist/core/terminal-cause.d.ts +30 -0
  368. package/dist/core/terminal-cause.js +1 -0
  369. package/dist/core/tool-catalog-entries.js +2 -5
  370. package/dist/core/tool-check-reading.js +16 -10
  371. package/dist/core/tool-conformance.js +1 -2
  372. package/dist/core/tool-errors.d.ts +6 -3
  373. package/dist/core/tool-errors.js +2 -0
  374. package/dist/core/tool-face-reader.js +3 -2
  375. package/dist/core/tool-face.d.ts +2 -3
  376. package/dist/core/tool-name-aliases.d.ts +5 -29
  377. package/dist/core/tool-name-aliases.js +9 -5
  378. package/dist/core/tool-name-readings.d.ts +14 -3
  379. package/dist/core/tool-name-readings.js +2 -0
  380. package/dist/core/tool-policy.d.ts +108 -18
  381. package/dist/core/tool-policy.js +84 -14
  382. package/dist/core/tool-result-store.d.ts +23 -0
  383. package/dist/core/tool-result-store.js +3 -2
  384. package/dist/core/tool-spec.d.ts +19 -6
  385. package/dist/core/trace.d.ts +18 -1
  386. package/dist/core/user-attachment.js +26 -21
  387. package/dist/core/workflow-journal-store.d.ts +1 -1
  388. package/dist/core/workflow-run-store.d.ts +2 -0
  389. package/dist/core/workflow-run-store.js +6 -5
  390. package/dist/core/workflow-settled-run.d.ts +5 -0
  391. package/dist/core/workflow-settled-run.js +7 -0
  392. package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
  393. package/dist/engine/execution-env/node-execution-env.js +213 -21
  394. package/dist/engine/harness/agent-harness.d.ts +65 -18
  395. package/dist/engine/harness/agent-harness.js +90 -23
  396. package/dist/engine/harness/messages.d.ts +4 -3
  397. package/dist/engine/harness/messages.js +2 -2
  398. package/dist/engine/harness/types.d.ts +41 -7
  399. package/dist/engine/llm/media-removed.d.ts +14 -0
  400. package/dist/engine/llm/media-removed.js +9 -0
  401. package/dist/engine/llm/rejected-images.d.ts +35 -25
  402. package/dist/engine/llm/rejected-images.js +59 -10
  403. package/dist/engine/llm/types.d.ts +24 -3
  404. package/dist/engine/llm/types.js +7 -3
  405. package/dist/engine/loop/agent-loop.d.ts +6 -1
  406. package/dist/engine/loop/agent-loop.js +20 -11
  407. package/dist/engine/loop/types.d.ts +12 -3
  408. package/dist/engine/session/import-validate.js +7 -0
  409. package/dist/fixtures/index.d.ts +7 -5
  410. package/dist/fixtures/index.js +5 -3
  411. package/dist/index.d.ts +21 -11
  412. package/dist/index.js +15 -7
  413. package/dist/internal/harness-types.d.ts +2 -0
  414. package/dist/internal/llm.d.ts +2 -1
  415. package/dist/internal/llm.js +1 -0
  416. package/dist/orchestration/goal.d.ts +6 -2
  417. package/dist/orchestration/goal.js +6 -3
  418. package/dist/orchestration/run-workflow-tool.d.ts +11 -17
  419. package/dist/orchestration/run-workflow-tool.js +19 -42
  420. package/dist/orchestration/workflow-governance.d.ts +1 -1
  421. package/dist/orchestration/workflow-types.d.ts +2 -2
  422. package/dist/orchestration/workflow.d.ts +4 -0
  423. package/dist/orchestration/workflow.js +8 -5
  424. package/dist/stores/file/background-agent-store.js +18 -15
  425. package/dist/stores/file/checkpoint-store.js +7 -4
  426. package/dist/stores/file/file-history-store.js +3 -2
  427. package/dist/stores/file/index.d.ts +5 -3
  428. package/dist/stores/file/index.js +23 -8
  429. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  430. package/dist/stores/file/ledger-tuning.js +21 -0
  431. package/dist/stores/file/mailbox-store.js +42 -22
  432. package/dist/stores/file/memory-store.js +3 -2
  433. package/dist/stores/file/permission-rule-adopt.js +24 -21
  434. package/dist/stores/file/permission-rule-store.js +6 -3
  435. package/dist/stores/file/session-policy-store.js +3 -2
  436. package/dist/stores/file/session-store.d.ts +16 -3
  437. package/dist/stores/file/session-store.js +21 -20
  438. package/dist/stores/file/tool-result-store.d.ts +11 -0
  439. package/dist/stores/file/tool-result-store.js +57 -3
  440. package/dist/stores/file/usage-window-store.js +3 -2
  441. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  442. package/dist/stores/file/workflow-journal-store.js +3 -18
  443. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  444. package/dist/stores/file/workflow-run-store.js +15 -10
  445. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  446. package/dist/tools/fs/dead-cwd.js +4 -11
  447. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  448. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  449. package/dist/tools/fs/fs-bash.d.ts +3 -18
  450. package/dist/tools/fs/fs-bash.js +37 -124
  451. package/dist/tools/fs/fs-pdf.js +8 -6
  452. package/dist/tools/fs/fs-read.js +2 -2
  453. package/dist/tools/fs/fs-shared.d.ts +28 -3
  454. package/dist/tools/fs/fs-shared.js +15 -0
  455. package/dist/tools/fs/index.d.ts +1 -1
  456. package/dist/tools/fs/index.js +4 -14
  457. package/dist/tools/fs/pdf.d.ts +4 -4
  458. package/dist/tools/fs/pdf.js +6 -6
  459. package/dist/tools/fs/read-deny-home.js +8 -1
  460. package/dist/tools/fs/read-deny.d.ts +26 -2
  461. package/dist/tools/fs/read-deny.js +9 -2
  462. package/dist/tools/fs/read-floor.d.ts +13 -5
  463. package/dist/tools/fs/read-floor.js +206 -2
  464. package/dist/tools/fs/search.d.ts +3 -2
  465. package/dist/tools/fs/search.js +6 -6
  466. package/dist/tools/fs/shell-read-establish.js +3 -1
  467. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  468. package/dist/tools/fs/shell-read-identity.js +4 -2
  469. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  470. package/dist/tools/fs/shell-read-judge.js +1 -1
  471. package/dist/tools/monitor.d.ts +8 -7
  472. package/dist/tools/monitor.js +12 -10
  473. package/dist/tools/worktree.d.ts +5 -1
  474. package/dist/tools/worktree.js +20 -17
  475. package/package.json +6 -3
  476. package/test/export-surface.snapshot.json +92 -10
  477. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  478. package/wire-changes/core@7.61.0.json +4405 -0
  479. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  480. package/wire-changes/primitives@7.61.0.json +30 -0
  481. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  482. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -597,7 +597,37 @@ export interface FileHistoryStore {
597
597
  */
598
598
  exportHistory?(scope: string): Promise<FileHistoryExportResult>;
599
599
  importHistory?(scope: string, data: FileHistoryExport, srcGetBlob: (hash: string) => Promise<Uint8Array | undefined>): Promise<FileHistoryResult>;
600
+ /**
601
+ * The store's blob exchange — how another machine's bytes come in ahead of an import, go out to a puller, and are
602
+ * asked about — as one optional member group ({@link FileHistoryBlobExchange}): present ⇒ all three of its members;
603
+ * absent ⇒ this store exchanges no blobs (it can still import, from a source the caller reads). Read through
604
+ * {@link fileHistoryBlobExchangeOf}, which refuses a group with a member missing. A puller hands
605
+ * `blobExchange.get` to {@link importHistory} as its `srcGetBlob`.
606
+ */
607
+ readonly blobExchange?: FileHistoryBlobExchange;
608
+ }
609
+ /**
610
+ * {@link FileHistoryStore.blobExchange}: one capability, three members.
611
+ *
612
+ * - `put(hash, bytes)` stores bytes under their content address. The store checks the address itself — bytes whose
613
+ * sha256 is not `hash` are refused (`adopt_failed`, `permanence: "terminal"`) and nothing is stored — and records
614
+ * the blob present the same way a capture records one, so bytes no history references yet are kept like any other
615
+ * unreferenced blob: until the orphan sweep's grace window runs out. Idempotent.
616
+ * - `get(hash)` answers the bytes, or `undefined` when the store does not hold them.
617
+ * - `has(hashes)` answers which of `hashes` the store holds, from its own index — no bytes are read.
618
+ */
619
+ export interface FileHistoryBlobExchange {
620
+ put(hash: string, bytes: Uint8Array): Promise<FileHistoryResult>;
621
+ get(hash: string): Promise<Uint8Array | undefined>;
622
+ has(hashes: readonly string[]): Promise<ReadonlySet<string>>;
600
623
  }
624
+ /**
625
+ * The store's blob exchange, read as one capability: `undefined` when the store carries no `blobExchange`; its three
626
+ * members, bound, when it carries the whole group; a refusal (`config.invalid_argument`) when the group is not an
627
+ * object or a member is missing or not a function. A store that still carries the retired `syncBlobFaces` marker is
628
+ * refused too: the capability is the group's presence, and a second word for it is a second reading.
629
+ */
630
+ export declare function fileHistoryBlobExchangeOf(store: FileHistoryStore): FileHistoryBlobExchange | undefined;
601
631
  /**
602
632
  * design/381 §3 + §10 T-5 — the FENCING judge for a boundary-capture attempt, exposed as a
603
633
  * direct-callable function (the G6b grey-box seat) and used by every in-tree backend as the single
@@ -852,7 +882,7 @@ export declare class InMemoryFileHistoryStore implements FileHistoryStore {
852
882
  * (adversarial round): two concurrent captures can lease the same new hash, and the first
853
883
  * attempt's release must not strip the second attempt's liveness. */
854
884
  private readonly inFlightBlobs;
855
- constructor(opts?: InMemoryFileHistoryStoreOptions);
885
+ constructor(options?: InMemoryFileHistoryStoreOptions);
856
886
  /**
857
887
  * The RETENTION pass, run after a boundary commits (design/381 §片2 — see {@link FileHistoryStore.reap}
858
888
  * for why the backend owns this rather than the host). Boundaries are an insertion-ordered map
@@ -1,7 +1,9 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { readMember, thrownText } from "./thrown-value.js";
3
+ import { readMemberGroup } from "./member-group.js";
3
4
  import { isAbsoluteForFamily, isWinFormPath, pathFamilyOf, relativeInEveryFamily } from "../tools/fs/safety.js";
4
5
  import { fileHistoryBoundariesToKeep, resolveFileHistoryRetention } from "./file-history-retention.js";
6
+ import { optionKeys, receiveOptions } from "./own-property-receipt.js";
5
7
  const normSlash = (p) => p.replace(/\\/g, "/");
6
8
  const stripTrailSep = (p) => (isWinFormPath(p) ? p.replace(/[\\/]+$/, "") : p.replace(/\/+$/, ""));
7
9
  const foldDrive = (p) => (/^[A-Za-z]:(\/|$)/.test(p) ? p[0].toLowerCase() + p.slice(1) : p);
@@ -244,6 +246,31 @@ function judgeFileHistoryEnvelope(data) {
244
246
  }
245
247
  return { ok: true };
246
248
  }
249
+ const BLOB_EXCHANGE_MEMBERS = Object.freeze(["put", "get", "has"]);
250
+ export function fileHistoryBlobExchangeOf(store) {
251
+ const owner = "FileHistoryStore.blobExchange";
252
+ let marker;
253
+ let group;
254
+ try {
255
+ marker = Reflect.get(store, "syncBlobFaces");
256
+ group = store.blobExchange;
257
+ }
258
+ catch (cause) {
259
+ throw invalidBlobExchange(`${owner} could not be read (${thrownText(cause)}).`);
260
+ }
261
+ if (marker !== undefined)
262
+ throw invalidBlobExchange(`FileHistoryStore carries the retired syncBlobFaces marker — the blob exchange is the ${owner} group (put / get / has): present means the capability, absent means none.`);
263
+ if (group === undefined)
264
+ return undefined;
265
+ if (typeof group !== "object" || group === null)
266
+ throw invalidBlobExchange(`${owner} must be an object with put / get / has (got ${group === null ? "null" : typeof group}).`);
267
+ return readMemberGroup(owner, group, BLOB_EXCHANGE_MEMBERS, true);
268
+ }
269
+ function invalidBlobExchange(message) {
270
+ const e = new Error(message);
271
+ e.code = "config.invalid_argument";
272
+ return e;
273
+ }
247
274
  export function boundaryPublishVerdict(attempt) {
248
275
  return attempt.aborted ? { publish: false, reason: "aborted" } : { publish: true };
249
276
  }
@@ -412,13 +439,15 @@ async function applyRecordedMode(env, absPath, opts, currentMode) {
412
439
  const r = await env.setFileMode(absPath, want & 0o7777, opts.signal);
413
440
  return r.ok ? "applied" : "unpreserved";
414
441
  }
442
+ const IN_MEMORY_FILE_HISTORY_STORE_OPTION_KEYS = optionKeys()({ retention: 0 });
415
443
  export class InMemoryFileHistoryStore {
416
444
  scopes = new Map();
417
445
  boundaryKeep;
418
446
  blobs = new Map();
419
447
  inFlightBlobs = new Map();
420
- constructor(opts) {
421
- this.boundaryKeep = resolveFileHistoryRetention("InMemoryFileHistoryStore", opts?.retention);
448
+ constructor(options) {
449
+ const opts = receiveOptions(options, "InMemoryFileHistoryStore", IN_MEMORY_FILE_HISTORY_STORE_OPTION_KEYS);
450
+ this.boundaryKeep = resolveFileHistoryRetention("InMemoryFileHistoryStore", opts.retention);
422
451
  }
423
452
  applyBoundaryRetention(scope, justCommitted) {
424
453
  if (this.boundaryKeep === null)
@@ -40,6 +40,13 @@ export interface FrameSettlement {
40
40
  * host decided what the model reads, so the consumer settles the record as the host's decision (terminal),
41
41
  * discloses it loudly, and never hands it over again. */
42
42
  readonly hostWithheld: Set<string>;
43
+ /** Awaited keys whose frame the session's receiving station did not hand over ({@link settleConsumedFrame}): an
44
+ * extension consumed it, or a handler there failed — key → who (an extension's name, or `engine`) and why. The consumer
45
+ * settles the record as that decision (terminal), tells its sender, and never hands it over again. */
46
+ readonly consumed: Map<string, {
47
+ readonly by: string;
48
+ readonly reason: string;
49
+ }>;
43
50
  /** Compactions that LANDED this run and have not been consumed by a settlement pass yet, in landing
44
51
  * order. Recorded only while {@link FrameSettlement.wantsEffects} says a record could still be
45
52
  * broken by one, and cleared by the consumer's LOCAL settlement half — which needs no lease, so an
@@ -63,6 +70,9 @@ export interface FrameSettlement {
63
70
  wantsEffects?: () => boolean;
64
71
  }
65
72
  export declare function createFrameSettlement(): FrameSettlement;
73
+ /** The receiving station did not hand the frame keyed `key` over: its ask is answered now, as consumed (only an ask some
74
+ * consumer registered is answered — a frame nobody awaits leaves nothing behind). */
75
+ export declare function settleConsumedFrame(seam: FrameSettlement, key: string, by: string, reason: string): void;
66
76
  /** The carrier key of a TOOL RESULT (the `ReadInbox` pull face): its own domain, so it can never
67
77
  * collide with an injection queue dedup key. One tool result can carry SEVERAL frames, each asked for
68
78
  * under its own key with this carrier. */
@@ -1,5 +1,10 @@
1
1
  export function createFrameSettlement() {
2
- return { awaiting: new Map(), receipts: new Map(), withheld: new Set(), hostRewritten: new Set(), hostWithheld: new Set(), compactions: [] };
2
+ return { awaiting: new Map(), receipts: new Map(), withheld: new Set(), hostRewritten: new Set(), hostWithheld: new Set(), consumed: new Map(), compactions: [] };
3
+ }
4
+ export function settleConsumedFrame(seam, key, by, reason) {
5
+ if (!seam.awaiting.delete(key))
6
+ return;
7
+ seam.consumed.set(key, Object.freeze({ by, reason }));
3
8
  }
4
9
  export function toolResultReceiptKey(toolCallId) {
5
10
  return `tool_result:${toolCallId}`;
@@ -1,5 +1,5 @@
1
1
  import type { ExecutionEnv } from "../internal/harness-types.js";
2
- import type { PermissionResult, ToolPolicy } from "./tool-policy.js";
2
+ import type { PermissionResult, ToolCallRequest, ToolPolicy } from "./tool-policy.js";
3
3
  import { type PathGuardRow } from "./path-guard-rows.js";
4
4
  /** One write domain SOURCE as an allow row of the one table: it reaches every location at or below one of its admitted keys.
5
5
  * The write gate's three sources, and a session rule's `allowDirs` (the confinement that admits a write only inside them). */
@@ -39,8 +39,8 @@ export interface FsWriteGatePolicyOptions {
39
39
  defaultWrite: "ask" | "allow";
40
40
  /** The ask the default verdict mints in place of the gate's ordinary write question — a permission mode's own
41
41
  * sentence over the resolved `path`, with the gate's domain note (a configured domain that was not honored) to
42
- * append when there is one. Read only where `defaultWrite` is `"ask"`. */
43
- defaultAsk?: (path: string, note: string | undefined) => PermissionResult;
42
+ * append when there is one, and the call it answers. Read only where `defaultWrite` is `"ask"`. */
43
+ defaultAsk?: (path: string, note: string | undefined, call: ToolCallRequest) => PermissionResult;
44
44
  /**
45
45
  * Session-exemption lookup ("allow all for this session" grants recorded by the deployment's approval
46
46
  * surface). Consulted ONCE per covered write, after the domain checks and immediately BEFORE the gate
@@ -1,4 +1,5 @@
1
1
  import { canonicalizeTarget, lexicalViewOf, pathFamilyOf, writeTargetPath } from "../tools/fs/safety.js";
2
+ import { attest } from "./engine-attestation.js";
2
3
  import { isWithin } from "./runner/session-rule-policy.js";
3
4
  import { swallowedFenceRoot } from "./runner/advertised-writable-dirs.js";
4
5
  import { declaredPathTargetOf, isProtectedWrite } from "./tool-registry.js";
@@ -51,9 +52,6 @@ export function createFsWriteGatePolicy(opts) {
51
52
  const rootLexical = absoluteRootOf(rootPath, env.cwd);
52
53
  assertExemptDirsDoNotCoverRoot(exemptDirs, rootLexical);
53
54
  const guardedCapable = env.writeFileGuarded !== undefined;
54
- const advisory = guardedCapable
55
- ? ""
56
- : " (advisory adjudication: this environment provides no guarded write, so approval is judged before a separate, non-atomic write step)";
57
55
  return {
58
56
  async check(req, signal) {
59
57
  if (!isProtectedWrite(req))
@@ -68,11 +66,11 @@ export function createFsWriteGatePolicy(opts) {
68
66
  const declared = declaredPathTargetOf(req);
69
67
  const path = declared === undefined ? undefined : writeTargetPath(req, declared);
70
68
  if (path === undefined) {
71
- return ask(`write tool "${req.toolName}" requires approval: the call has no resolvable path target to confine${declared === undefined ? " (the tool declares no path target)" : ""}${advisory}`);
69
+ return ask(`write tool "${req.toolName}" requires approval: the call has no resolvable path target to confine${declared === undefined ? " (the tool declares no path target)" : ""}`);
72
70
  }
73
71
  const canon = await canonicalizeTarget(env, path, signal, pathFamilyOf({ root: rootPath, cwd: req.cwd ?? env.cwd }), pathTargetBaseOf(declared, { root: rootPath, cwd: req.cwd }));
74
72
  if (!canon.ok) {
75
- return ask(`write to "${path}" requires approval: its real target could not be resolved (${canon.message})${advisory}`);
73
+ return ask(`write to "${path}" requires approval: its real target could not be resolved (${canon.message})`);
76
74
  }
77
75
  const advertised = req.advertisedWritableRoots ?? [];
78
76
  const targetViews = { views: [{ path: canon.key, kind: "canonical" }] };
@@ -132,8 +130,11 @@ export function createFsWriteGatePolicy(opts) {
132
130
  return { action: "allow" };
133
131
  const note = refusedDomain === undefined ? undefined : ` — note: the configured write domain ${refusedDomain} was not honored; a domain that holds the root would exempt every write under it`;
134
132
  if (opts.defaultAsk !== undefined)
135
- return opts.defaultAsk(path, note);
136
- return ask(`approve write to "${path}"?${advisory}${note ?? ""}`);
133
+ return opts.defaultAsk(path, note, req);
134
+ if (note !== undefined)
135
+ return ask(`approve write to "${path}"?${note}`);
136
+ const generic = `approve write to "${path}"?`;
137
+ return attest(ask(generic), req, { genericQuestion: generic });
137
138
  },
138
139
  };
139
140
  }
@@ -12,7 +12,7 @@ import { failedJudgmentDeny } from "./runner/policy-throw.js";
12
12
  import { thrownText } from "./thrown-value.js";
13
13
  import { argsAsTheToolReads } from "./effective-path-target.js";
14
14
  import { foldHookAsk, refuseOutOfContractDecision } from "./tool-policy.js";
15
- import { withProbeMandate } from "./ask-origin.js";
15
+ import { withChainAskReasons, withProbeMandate } from "./ask-origin.js";
16
16
  import { applyUnansweredSilence, readStationAnswer, silencedBy } from "./shell-read-silence.js";
17
17
  import { asksUnstated, permissionSeatAt, unstatedAskMessage } from "./mode-policy.js";
18
18
  export async function runGateFold(pass) {
@@ -40,6 +40,7 @@ export async function runGateFold(pass) {
40
40
  if (attributed !== undefined)
41
41
  pass.classifierRound = attributed;
42
42
  }
43
+ pass.decision = withChainAskReasons(pass.decision, pass.req);
43
44
  const rewritten = pass.screening !== undefined && pass.decision.action !== "deny" ? readRejudge(pass.req, pass.currentInput, pass.decision) : undefined;
44
45
  if (pass.screening !== undefined && rewritten?.kind === "rewritten") {
45
46
  const second = await screenRewrite(pass.screening, pass.req, rewritten.form, `the rewritten call to "${toolName}"`);
@@ -1,7 +1,7 @@
1
1
  import { argsAsTheToolReads, withArgsReading } from "./effective-path-target.js";
2
2
  import { attest, attestationOf, bindableArgsOf, decisionText, foldHookAsk, refusalOf, refuseOutOfContractDecision } from "./tool-policy.js";
3
3
  import { APPROVER_AUTHOR, extensionAuthors, noteRewrite, outletAsk, POLICY_AUTHOR, readRejudge, rewriteChasedSentence, screenRewrite } from "./rewrite-rejudge.js";
4
- import { arbitrateByMode, classifyAsk, decisionAskClassesOf, dontAskRefusalMessage, fileCommandOptionsSentence, persistedRuleMandateOf, safetyAxisOf, stampAskOrigin } from "./ask-origin.js";
4
+ import { arbitrateByMode, askReasonsOf, classifyAsk, joinAskReasons, decisionAskClassesOf, dontAskRefusalMessage, fileCommandOptionsSentence, persistedRuleMandateOf, safetyAxisOf, stampAskOrigin, withChainAskReasons } from "./ask-origin.js";
5
5
  import { classifierParseFailureDenyMessage, denialLimitFallbackMessage, rungDidNotRule, unarmedWindow } from "./auto-mode.js";
6
6
  import { classifierNoRulingArm, settleNoRulingAsk } from "./classifier-unavailable-arm.js";
7
7
  import { SETTLEMENT_NOBODY_JUDGED } from "./gate-outcome.js";
@@ -24,7 +24,8 @@ 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";
26
26
  import { readStationAnswer } from "./shell-read-silence.js";
27
- import { agentIdOf, judgedInputOf, raiseToolCheck } from "./mods/stations.js";
27
+ import { judgedInputOf, raiseToolCheck } from "./mods/stations.js";
28
+ import { agentIdOf } from "./leg-identity.js";
28
29
  import { extensionAllowOf, readToolChecks } from "./tool-check-reading.js";
29
30
  import { policyThrowLine, reportPolicyThrow } from "./runner/policy-throw.js";
30
31
  function parkWith(suspendAsk, parkArgs, carry) {
@@ -60,6 +61,7 @@ export async function runGateLanes(pass) {
60
61
  ...(d.action === "ask" && d.askClass !== undefined && d.classes !== undefined ? { askClass: d.askClass, classes: d.classes } : {}),
61
62
  ...(d.action === "ask" && d.mandated === true ? { mandated: true, ...(d.mandate !== undefined ? { mandate: d.mandate } : {}) } : {}),
62
63
  ...(d.action === "ask" && d.authoredBy === "deployment" ? { authoredBy: "deployment" } : {}),
64
+ ...askReasonsOf(d),
63
65
  });
64
66
  const parkAsk = async (d, req, args, safety, liveFaceUnavailable, org) => {
65
67
  if (suspendAsk === undefined || d.action !== "ask")
@@ -649,7 +651,7 @@ export async function runGateLanes(pass) {
649
651
  if (attributed !== undefined)
650
652
  pass.classifierRound = attributed;
651
653
  const read = ledger.fromDecision(recheck);
652
- recheck = read.decision;
654
+ recheck = withChainAskReasons(read.decision, { toolCallId, toolName });
653
655
  if (recheck.action === "deny" && read.deniedBy !== undefined) {
654
656
  editDenied = recheck;
655
657
  pass.deniedBy = read.deniedBy;
@@ -751,7 +753,8 @@ export async function runGateLanes(pass) {
751
753
  const rra = carried.requiresRealApproval === true ? { requiresRealApproval: true } : {};
752
754
  const call = { toolCallId, toolName };
753
755
  const folded = new Set([...(editDecision.action === "ask" ? (attestationOf(editDecision, call)?.foldedClasses ?? []) : []), ...decisionAskClassesOf(carried, call), ...(carried.classes ?? [])]);
754
- editDecision = stampEditAsk(editDecision.action === "ask" ? attest({ ...editDecision, ...rra }, call, { foldedClasses: [...folded] }) : carried);
756
+ const askReasons = editDecision.action === "ask" ? joinAskReasons(editDecision.askReasons, carried.askReasons) : undefined;
757
+ editDecision = stampEditAsk(editDecision.action === "ask" ? attest({ ...editDecision, ...rra, ...(askReasons !== undefined ? { askReasons } : {}) }, call, { foldedClasses: [...folded] }) : carried);
755
758
  carriedOwnAsk = undefined;
756
759
  }
757
760
  const editRead = await checkTool(editDecision, editArgs, editOrg.org, undefined);
@@ -135,12 +135,51 @@ export declare function isSettlementParty(v: unknown): v is SettlementParty;
135
135
  export declare const HOST_DECIDERS: readonly ["person", "sla_timeout", "policy"];
136
136
  export type HostDecider = (typeof HOST_DECIDERS)[number];
137
137
  export declare const isHostDecider: (word: unknown) => word is HostDecider;
138
+ /**
139
+ * WHICH MACHINE SEAT answered when the deployment's policy decided an ask — the closed set of the `decidedVia` member
140
+ * (`AskOutcome.decidedVia` on the synchronous leg, `hostDecision.decidedVia` on a durable decide; one word set, one
141
+ * name, both faces). It refines the policy decider and nothing else: a person, an elapsed window and the host's SLA
142
+ * sweep are not machines that answered, so the member beside any other decider word is refused, never ignored.
143
+ * - `policy` — the deployment's own policy answered (an unattended lane answering by class, a headless lane whose
144
+ * seat can show nobody a prompt). ABSENT reads the same: an unrevised host is unchanged.
145
+ * - `permission_request_hook` — a PermissionRequest hook answered the ask on the deployment's behalf (the
146
+ * reference's `decisionReason.type: "hook"` with `hookName: "PermissionRequest"`, `iPt` (cli309.js:288208) /
147
+ * `runHooks` (cli309.js:295883)). A hook's refusal is not "this run has no approval channel": something DID answer,
148
+ * and the model reads that the hook declined, with the hook's own words.
149
+ * The record is unchanged by it (`policy_allowed` / `policy_refused`, `who.party: "policy"`): the member decides which
150
+ * sentence the model reads ({@link import("./tool-policy.js").policyRefusalMessage}), not which party the record names.
151
+ */
152
+ export declare const DECIDED_VIA: readonly ["policy", "permission_request_hook"];
153
+ export type DecidedVia = (typeof DECIDED_VIA)[number];
154
+ export declare const isDecidedVia: (word: unknown) => word is DecidedVia;
155
+ /** The model-facing NAME of each machine seat a policy decision can come from ({@link policyDeciderOf}). */
156
+ declare const POLICY_DECIDER_NAMES: Readonly<{
157
+ readonly policy: "this deployment's own policy";
158
+ readonly permission_request_hook: "a PermissionRequest hook";
159
+ }>;
160
+ /** The fence over the name table: `never` while every seat word has a name. */
161
+ export type PolicyDeciderNamesCoverEverySeat = AssertAllKeysHandled<Exclude<DecidedVia, keyof typeof POLICY_DECIDER_NAMES>>;
162
+ /**
163
+ * THE reading of `decidedVia` — the one place its absence folds ("absent ⇒ the deployment's own policy") and the one
164
+ * place each seat is NAMED to the model. Every sentence that names who REFUSED a tool approval for the policy reads it:
165
+ * the refusal composer ({@link import("./tool-policy.js").policyRefusalMessage}, all three legs) and the durable
166
+ * resume's continuation reminder, so the tool result and the reminder about the same refusal can never name two
167
+ * different deciders. A sentence about a policy's ALLOW that a later check refuses names the party alone ("not a
168
+ * person"), and so does a plan pause's reminder.
169
+ */
170
+ export declare function policyDeciderOf(decidedVia: DecidedVia | undefined): {
171
+ readonly seat: DecidedVia;
172
+ readonly name: string;
173
+ };
138
174
  /** The host's DECISION FACTS on a durable decide — who ended the wait, and the attribution the approval channel
139
175
  * reported for that party. ONE shape for every decide that records its decider (a tool approval's and a plan
140
- * pause's); core mints the settlement word from it ({@link settlementOfHostDecision}), the host never supplies one. */
176
+ * pause's); core mints the settlement word from it ({@link settlementOfHostDecision}), the host never supplies one.
177
+ * `decidedVia` — which machine seat answered for a `"policy"` decider ({@link DECIDED_VIA}); legal only beside
178
+ * `decidedBy: "policy"`, absent ⇒ the deployment's policy. */
141
179
  export interface HostDecisionFacts {
142
180
  decidedBy: HostDecider;
143
181
  approver?: string;
182
+ decidedVia?: DecidedVia;
144
183
  }
145
184
  /** The DECIDER arms of {@link Settlement} — a person's and the deployment policy's, the two parties that
146
185
  * answer an ask either way. Named so a site that both composes one and quotes its note can read the seat
@@ -28,6 +28,16 @@ export function isSettlementParty(v) {
28
28
  }
29
29
  export const HOST_DECIDERS = Object.freeze(["person", "sla_timeout", "policy"]);
30
30
  export const isHostDecider = (word) => HOST_DECIDERS.some((w) => w === word);
31
+ export const DECIDED_VIA = Object.freeze(["policy", "permission_request_hook"]);
32
+ export const isDecidedVia = (word) => DECIDED_VIA.some((w) => w === word);
33
+ const POLICY_DECIDER_NAMES = Object.freeze({
34
+ policy: "this deployment's own policy",
35
+ permission_request_hook: "a PermissionRequest hook",
36
+ });
37
+ export function policyDeciderOf(decidedVia) {
38
+ const seat = decidedVia ?? "policy";
39
+ return { seat, name: POLICY_DECIDER_NAMES[seat] };
40
+ }
31
41
  export function decidersNote(text) {
32
42
  return text === "" ? undefined : text;
33
43
  }
@@ -1,4 +1,4 @@
1
- import type { ExecutionEnv } from "../internal/harness-types.js";
1
+ import type { ExecutionEnv, ReadFloor } from "../internal/harness-types.js";
2
2
  /** The managed parent (under the repository root) that holds every managed worktree — the reference implementation's
3
3
  * `.claude/worktrees/` under this project's brand — so {@link pruneWorktrees} and a userland reaper find orphans by one known
4
4
  * location. Every tree the engine mints lives at `<repoRoot>/.sema/worktrees/<slug>` (see {@link managedWorktreeDir}). */
@@ -31,6 +31,10 @@ export interface AddWorktreeOptions {
31
31
  rootEnvAt: (worktreeDir: string) => ExecutionEnv | Promise<ExecutionEnv>;
32
32
  /** Base commit/ref for the worktree (default `HEAD` at creation time). */
33
33
  commit?: string;
34
+ /** The byte floor (`ExecutionEnvExecOptions.readFloor`) of every start the mint and the tree's removal make, read as each
35
+ * start begins: a run's git bookkeeping is the run's own start and carries the run's table. A read that throws is that
36
+ * step's failure (the add's refuses the mint before anything exists). Absent ⇒ the starts carry none (no run). */
37
+ readFloor?: () => ReadFloor | undefined;
34
38
  }
35
39
  /**
36
40
  * Remove a managed worktree and — by the ONE branch rule — its branch: the branch is deleted only when its tip is still the
@@ -46,7 +50,7 @@ export interface AddWorktreeOptions {
46
50
  export declare function removeManagedWorktree(baseEnv: ExecutionEnv, repoRoot: string, worktreeDir: string, branch?: {
47
51
  readonly name: string;
48
52
  readonly baseSha: string;
49
- }): Promise<{
53
+ }, readFloor?: () => ReadFloor | undefined): Promise<{
50
54
  ok: true;
51
55
  branchDeleted?: string;
52
56
  branchKept?: string;
@@ -85,7 +89,7 @@ export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOpti
85
89
  * on a claim it could not have checked. Same fail-loud treatment {@link removeManagedWorktree} already got
86
90
  * Report the outcome, let the caller decide what to say. Never throws (a throwing env
87
91
  * lands on the same `{ok:false}`), so a caller that ignores the value behaves exactly as before. */
88
- export declare function pruneWorktrees(baseEnv: ExecutionEnv, repoRoot: string): Promise<{
92
+ export declare function pruneWorktrees(baseEnv: ExecutionEnv, repoRoot: string, readFloor?: ReadFloor): Promise<{
89
93
  ok: true;
90
94
  } | {
91
95
  ok: false;
@@ -55,12 +55,13 @@ async function symlinkedLevel(env, repoRoot, worktreeDir) {
55
55
  }
56
56
  return undefined;
57
57
  }
58
- export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, branch) {
58
+ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, branch, readFloor) {
59
+ const readFloorNow = () => { const f = readFloor?.(); return f !== undefined ? { readFloor: f } : {}; };
59
60
  let detail = "";
60
61
  let removed = false;
61
62
  for (let attempt = 0; attempt < 2 && !removed; attempt++) {
62
63
  try {
63
- const r = await baseEnv.exec(`git worktree remove --force ${shq(worktreeDir)}`, { cwd: repoRoot });
64
+ const r = await baseEnv.exec(`git worktree remove --force ${shq(worktreeDir)}`, { cwd: repoRoot, ...readFloorNow() });
64
65
  if (r.ok && r.value.exitCode === 0)
65
66
  removed = true;
66
67
  else
@@ -77,10 +78,10 @@ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, bran
77
78
  if (!/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/.test(branch.baseSha) || /^0+$/.test(branch.baseSha))
78
79
  return { ok: true, branchKept: `${branch.name} (its base commit is not a usable witness)` };
79
80
  try {
80
- const del = await baseEnv.exec(`git update-ref --no-deref -d ${shq(`refs/heads/${branch.name}`)} ${shq(branch.baseSha)}`, { cwd: repoRoot });
81
+ const del = await baseEnv.exec(`git update-ref --no-deref -d ${shq(`refs/heads/${branch.name}`)} ${shq(branch.baseSha)}`, { cwd: repoRoot, ...readFloorNow() });
81
82
  if (del.ok && del.value.exitCode === 0)
82
83
  return { ok: true, branchDeleted: branch.name };
83
- const tip = await baseEnv.exec(`git rev-parse --verify --quiet ${shq(`refs/heads/${branch.name}`)}`, { cwd: repoRoot });
84
+ const tip = await baseEnv.exec(`git rev-parse --verify --quiet ${shq(`refs/heads/${branch.name}`)}`, { cwd: repoRoot, ...readFloorNow() });
84
85
  if (tip.ok && tip.value.exitCode !== 0)
85
86
  return { ok: true };
86
87
  if (tip.ok && tip.value.stdout.trim() !== branch.baseSha)
@@ -101,20 +102,22 @@ export async function addWorktree(baseEnv, opts) {
101
102
  const symlinked = await symlinkedLevel(baseEnv, opts.repoRoot, worktreeDir);
102
103
  if (symlinked !== undefined)
103
104
  throw new Error(symlinked);
105
+ const readFloorNow = () => { const readFloor = opts.readFloor?.(); return readFloor !== undefined ? { readFloor } : {}; };
104
106
  const add = await baseEnv.exec(`git worktree add --no-track -b ${shq(branch)} ${shq(worktreeDir)} ${shq(opts.commit ?? "HEAD")}`, {
105
107
  cwd: opts.repoRoot,
108
+ ...readFloorNow(),
106
109
  });
107
110
  if (!add.ok || add.value.exitCode !== 0) {
108
111
  const detail = add.ok ? add.value.stderr || add.value.stdout : thrownText(add.error);
109
112
  throw new Error(`git worktree add failed: ${detail}`);
110
113
  }
111
114
  const excludeLine = shq(`/${WORKTREE_PARENT}/`);
112
- await baseEnv
113
- .exec(`ex="$(git rev-parse --git-path info/exclude)" && mkdir -p "$(dirname "$ex")" && ` +
114
- `{ grep -qxF ${excludeLine} "$ex" 2>/dev/null || printf '%s\\n' ${excludeLine} >> "$ex"; }`, { cwd: opts.repoRoot })
115
+ await Promise.resolve()
116
+ .then(() => baseEnv.exec(`ex="$(git rev-parse --git-path info/exclude)" && mkdir -p "$(dirname "$ex")" && ` +
117
+ `{ grep -qxF ${excludeLine} "$ex" 2>/dev/null || printf '%s\\n' ${excludeLine} >> "$ex"; }`, { cwd: opts.repoRoot, ...readFloorNow() }))
115
118
  .catch(() => undefined);
116
- const baseSha = await baseEnv
117
- .exec("git rev-parse HEAD", { cwd: worktreeDir })
119
+ const baseSha = await Promise.resolve()
120
+ .then(() => baseEnv.exec("git rev-parse HEAD", { cwd: worktreeDir, ...readFloorNow() }))
118
121
  .then((r) => (r.ok && r.value.exitCode === 0 && r.value.stdout.trim() !== "" ? r.value.stdout.trim() : undefined))
119
122
  .catch(() => undefined);
120
123
  const branchRule = baseSha !== undefined ? { name: branch, baseSha } : undefined;
@@ -123,7 +126,7 @@ export async function addWorktree(baseEnv, opts) {
123
126
  inner = await opts.rootEnvAt(worktreeDir);
124
127
  }
125
128
  catch (err) {
126
- await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule);
129
+ await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule, opts.readFloor);
127
130
  throw err;
128
131
  }
129
132
  const innerDestroy = inner.destroy;
@@ -134,7 +137,7 @@ export async function addWorktree(baseEnv, opts) {
134
137
  await innerDestroy.call(inner);
135
138
  }
136
139
  finally {
137
- const removed = await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule);
140
+ const removed = await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule, opts.readFloor);
138
141
  if (!removed.ok) {
139
142
  throw new Error(`git worktree remove failed twice — ${worktreeDir} is now an orphan (dir + registration remain; ` +
140
143
  `\`git worktree prune\` cannot reclaim it while the dir exists — remove it manually): ${removed.detail}`);
@@ -143,9 +146,9 @@ export async function addWorktree(baseEnv, opts) {
143
146
  };
144
147
  return { env, worktreeDir, name, branch, ...(baseSha !== undefined ? { baseSha } : {}) };
145
148
  }
146
- export async function pruneWorktrees(baseEnv, repoRoot) {
149
+ export async function pruneWorktrees(baseEnv, repoRoot, readFloor) {
147
150
  try {
148
- const r = await baseEnv.exec("git worktree prune", { cwd: repoRoot });
151
+ const r = await baseEnv.exec("git worktree prune", { cwd: repoRoot, ...(readFloor !== undefined ? { readFloor } : {}) });
149
152
  if (r.ok && r.value.exitCode === 0)
150
153
  return { ok: true };
151
154
  return {
@@ -145,7 +145,7 @@ export type NoticeAudience = "user" | "operator";
145
145
  * the union's catalog ({@link EngineNotice.code}). The groups below say only which family a row joins,
146
146
  * so the catalog is not written a second time here and the two cannot drift.
147
147
  */
148
- export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.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"];
148
+ export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.read_floor_confinement_unavailable", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.media_removed", "context.tool_schema_removed", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "config.image_processor_unavailable", "fs.staging_file_left", "fs.staging_file_swept", "instructions.source_changed", "session.records_skipped", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
149
149
  /** A catalogued code (see {@link ENGINE_NOTICE_CODES}); {@link NOTICE_MINTER} says who mints it. NOT the type of
150
150
  * `EngineNotice.code`, which stays `string` — a host forwarding its own notices through the same
151
151
  * sink is a supported shape, and narrowing that field would break it. */
@@ -175,7 +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
+ readonly "classifier.seat_rate_limited": "user";
179
179
  readonly "classifier.role_defaulted": "operator";
180
180
  readonly "classifier.contract_broken": "operator";
181
181
  readonly "task.turn_interrupted": "user";
@@ -222,6 +222,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
222
222
  readonly "config.path_view_unresolved": "operator";
223
223
  readonly "config.execution_env_capability_invalid": "operator";
224
224
  readonly "config.read_deny_floor_unkept": "operator";
225
+ readonly "config.read_floor_confinement_unavailable": "operator";
225
226
  readonly "config.tool_card_undeclared": "operator";
226
227
  readonly "config.tool_face_undeclared": "operator";
227
228
  readonly "config.tool_face_invalid": "operator";
@@ -262,12 +263,15 @@ declare const NOTICE_AUDIENCE_TABLE: {
262
263
  readonly "model.capability_downgraded": "user";
263
264
  readonly "model.role_defaulted": "operator";
264
265
  readonly "context.tool_turn_repaired": "operator";
265
- readonly "context.image_removed": "user";
266
+ readonly "context.media_removed": "user";
267
+ readonly "context.tool_schema_removed": "user";
266
268
  readonly "skills.listing_truncated": "operator";
267
269
  readonly "agents.listing_truncated": "operator";
268
270
  readonly "tool_result.offload_put_failed": "operator";
269
271
  readonly "tool_result.media_refused": "operator";
270
272
  readonly "config.image_processor_unavailable": "operator";
273
+ readonly "fs.staging_file_left": "operator";
274
+ readonly "fs.staging_file_swept": "operator";
271
275
  readonly "config.forward_sink_failed": "operator";
272
276
  readonly "instructions.source_changed": "user";
273
277
  readonly "session.records_skipped": "user";
@@ -318,6 +322,7 @@ declare const NOTICE_MINTER_TABLE: {
318
322
  readonly "config.path_view_unresolved": "engine";
319
323
  readonly "config.execution_env_capability_invalid": "engine";
320
324
  readonly "config.read_deny_floor_unkept": "engine";
325
+ readonly "config.read_floor_confinement_unavailable": "engine";
321
326
  readonly "config.tool_card_undeclared": "engine";
322
327
  readonly "config.tool_face_undeclared": "engine";
323
328
  readonly "config.tool_face_invalid": "engine";
@@ -386,7 +391,8 @@ declare const NOTICE_MINTER_TABLE: {
386
391
  readonly "model.capability_downgraded": "engine";
387
392
  readonly "model.role_defaulted": "engine";
388
393
  readonly "context.tool_turn_repaired": "engine";
389
- readonly "context.image_removed": "engine";
394
+ readonly "context.media_removed": "engine";
395
+ readonly "context.tool_schema_removed": "engine";
390
396
  readonly "task.user_steer_undrained": "engine";
391
397
  readonly "task.user_followup_undrained": "engine";
392
398
  readonly "steering.parked_input_blocked": "engine";
@@ -404,6 +410,8 @@ declare const NOTICE_MINTER_TABLE: {
404
410
  readonly "tool_result.offload_put_failed": "engine";
405
411
  readonly "tool_result.media_refused": "engine";
406
412
  readonly "config.image_processor_unavailable": "engine";
413
+ readonly "fs.staging_file_left": "engine";
414
+ readonly "fs.staging_file_swept": "engine";
407
415
  readonly "instructions.source_changed": "server";
408
416
  readonly "session.records_skipped": "server";
409
417
  readonly "memory.layer_locked_legacy": "server";