@sema-agent/core 7.59.0 → 7.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (643) hide show
  1. package/CHANGELOG.md +1169 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-definition.d.ts +7 -0
  4. package/dist/agents/agent-definition.js +12 -0
  5. package/dist/agents/agent-transcript-tool.d.ts +4 -3
  6. package/dist/agents/agent-transcript-tool.js +4 -2
  7. package/dist/agents/cascade.d.ts +61 -10
  8. package/dist/agents/cascade.js +60 -20
  9. package/dist/agents/child-model-seat.js +6 -3
  10. package/dist/agents/composition-allowance.d.ts +53 -0
  11. package/dist/agents/composition-allowance.js +49 -0
  12. package/dist/agents/composition-placement.d.ts +29 -0
  13. package/dist/agents/composition-placement.js +24 -0
  14. package/dist/agents/cumulative-stats.d.ts +4 -0
  15. package/dist/agents/cumulative-stats.js +3 -1
  16. package/dist/agents/inherited-tool-pool.d.ts +28 -1
  17. package/dist/agents/inherited-tool-pool.js +22 -0
  18. package/dist/agents/list-agents-tool.d.ts +1 -1
  19. package/dist/agents/peer-notice-route.d.ts +1 -1
  20. package/dist/agents/peer-notice-route.js +4 -3
  21. package/dist/agents/peer-notices.d.ts +4 -4
  22. package/dist/agents/peer-notices.js +8 -4
  23. package/dist/agents/peer-session-drain.d.ts +8 -1
  24. package/dist/agents/peer-session-drain.js +36 -7
  25. package/dist/agents/repair-loop.js +16 -6
  26. package/dist/agents/retain-ledger.d.ts +11 -1
  27. package/dist/agents/retain-ledger.js +16 -3
  28. package/dist/agents/roster-store.d.ts +2 -2
  29. package/dist/agents/roster-store.js +8 -3
  30. package/dist/agents/send-message-tool.d.ts +14 -27
  31. package/dist/agents/send-message-tool.js +47 -54
  32. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  33. package/dist/agents/subagent-completion-gate.js +62 -0
  34. package/dist/agents/subagent-steps.d.ts +7 -6
  35. package/dist/agents/subagent.d.ts +52 -28
  36. package/dist/agents/subagent.js +276 -246
  37. package/dist/agents/suspend-guard.d.ts +9 -0
  38. package/dist/agents/suspend-guard.js +4 -0
  39. package/dist/agents/tool-filter.d.ts +1 -3
  40. package/dist/agents/tool-filter.js +4 -12
  41. package/dist/agents/verify.d.ts +41 -14
  42. package/dist/agents/verify.js +37 -27
  43. package/dist/bench/metrics.d.ts +3 -5
  44. package/dist/bench/metrics.js +0 -1
  45. package/dist/brain/anthropic.js +1 -0
  46. package/dist/brain/degrading.js +3 -1
  47. package/dist/brain/errors.d.ts +7 -1
  48. package/dist/brain/errors.js +6 -0
  49. package/dist/brain/failover.js +2 -1
  50. package/dist/brain/open-responses.js +1 -0
  51. package/dist/brain/openai.js +1 -0
  52. package/dist/brain/provider-dialect.d.ts +10 -0
  53. package/dist/brain/provider-dialect.js +13 -2
  54. package/dist/brain/route-adjudicator.js +3 -1
  55. package/dist/brain/status-sink.d.ts +7 -1
  56. package/dist/brain/status-sink.js +6 -0
  57. package/dist/brain/stream-engine.d.ts +3 -0
  58. package/dist/brain/stream-engine.js +4 -0
  59. package/dist/brain/timeout.d.ts +3 -1
  60. package/dist/brain/timeout.js +18 -5
  61. package/dist/core/a2a.d.ts +15 -5
  62. package/dist/core/a2a.js +34 -19
  63. package/dist/core/agent-definition.d.ts +20 -0
  64. package/dist/core/agent-state.d.ts +1 -1
  65. package/dist/core/allow-entry.d.ts +61 -23
  66. package/dist/core/allow-entry.js +134 -39
  67. package/dist/core/artifact-host.d.ts +0 -2
  68. package/dist/core/artifact-host.js +0 -1
  69. package/dist/core/ask-origin.d.ts +79 -0
  70. package/dist/core/ask-origin.js +76 -0
  71. package/dist/core/ask-question.d.ts +19 -13
  72. package/dist/core/ask-question.js +8 -2
  73. package/dist/core/auto-compaction.d.ts +2 -0
  74. package/dist/core/auto-compaction.js +2 -1
  75. package/dist/core/auto-mode-defaults.d.ts +8 -0
  76. package/dist/core/auto-mode-defaults.js +1 -0
  77. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  78. package/dist/core/auto-mode.d.ts +39 -4
  79. package/dist/core/auto-mode.js +66 -17
  80. package/dist/core/background-agent-store.d.ts +17 -6
  81. package/dist/core/background-agent-store.js +15 -13
  82. package/dist/core/background-shell.d.ts +12 -1
  83. package/dist/core/background-shell.js +12 -0
  84. package/dist/core/checkpoint-requirements.d.ts +24 -3
  85. package/dist/core/checkpoint-requirements.js +9 -1
  86. package/dist/core/checkpoint-store.d.ts +86 -32
  87. package/dist/core/checkpoint-store.js +10 -5
  88. package/dist/core/child-clamp-seats.d.ts +3 -2
  89. package/dist/core/child-clamp-seats.js +4 -3
  90. package/dist/core/closest-name.d.ts +13 -0
  91. package/dist/core/closest-name.js +35 -0
  92. package/dist/core/compliance.d.ts +1 -1
  93. package/dist/core/context-settings.js +3 -5
  94. package/dist/core/credential-echo.d.ts +52 -0
  95. package/dist/core/credential-echo.js +65 -0
  96. package/dist/core/credential-vocabulary.d.ts +13 -3
  97. package/dist/core/credential-vocabulary.js +12 -4
  98. package/dist/core/cross-boundary-taint.d.ts +5 -6
  99. package/dist/core/decision-receipt.d.ts +14 -1
  100. package/dist/core/decision-receipt.js +6 -3
  101. package/dist/core/delegation-frames.d.ts +13 -9
  102. package/dist/core/effective-path-target.js +2 -3
  103. package/dist/core/engine-attestation.d.ts +11 -1
  104. package/dist/core/engine-attestation.js +2 -0
  105. package/dist/core/engine-notice.d.ts +106 -32
  106. package/dist/core/file-history-retention.d.ts +8 -0
  107. package/dist/core/file-history-retention.js +14 -11
  108. package/dist/core/file-history-store.d.ts +31 -1
  109. package/dist/core/file-history-store.js +31 -2
  110. package/dist/core/frame-settlement.d.ts +15 -0
  111. package/dist/core/frame-settlement.js +10 -1
  112. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  113. package/dist/core/fs-write-gate-policy.js +8 -7
  114. package/dist/core/gate-fold.js +9 -6
  115. package/dist/core/gate-lanes.js +46 -12
  116. package/dist/core/gate-outcome.d.ts +40 -1
  117. package/dist/core/gate-outcome.js +10 -0
  118. package/dist/core/git-worktree-env.d.ts +7 -3
  119. package/dist/core/git-worktree-env.js +16 -13
  120. package/dist/core/governance-codes.d.ts +19 -3
  121. package/dist/core/governance-codes.js +27 -3
  122. package/dist/core/hands-band-screen.js +0 -1
  123. package/dist/core/hands-band.d.ts +0 -3
  124. package/dist/core/hooks.d.ts +51 -60
  125. package/dist/core/hooks.js +131 -78
  126. package/dist/core/host-floor.js +3 -5
  127. package/dist/core/image-admission.d.ts +145 -52
  128. package/dist/core/image-admission.js +202 -47
  129. package/dist/core/image-downsample.d.ts +36 -69
  130. package/dist/core/image-downsample.js +111 -73
  131. package/dist/core/input-author.d.ts +36 -0
  132. package/dist/core/input-author.js +39 -0
  133. package/dist/core/integer-option.d.ts +21 -0
  134. package/dist/core/integer-option.js +13 -0
  135. package/dist/core/leg-identity.d.ts +62 -0
  136. package/dist/core/leg-identity.js +18 -0
  137. package/dist/core/locked-config.d.ts +55 -3
  138. package/dist/core/locked-config.js +84 -51
  139. package/dist/core/lsp.d.ts +5 -3
  140. package/dist/core/lsp.js +3 -2
  141. package/dist/core/mailbox-store.d.ts +85 -10
  142. package/dist/core/mailbox-store.js +31 -10
  143. package/dist/core/mcp-call-meta.d.ts +2 -2
  144. package/dist/core/mcp-call-meta.js +9 -10
  145. package/dist/core/mcp-connection-pool.d.ts +6 -20
  146. package/dist/core/mcp-connection-pool.js +10 -28
  147. package/dist/core/mcp-failure.d.ts +83 -16
  148. package/dist/core/mcp-failure.js +67 -30
  149. package/dist/core/mcp-host-seat.d.ts +131 -0
  150. package/dist/core/mcp-host-seat.js +305 -0
  151. package/dist/core/mcp-probe.d.ts +7 -2
  152. package/dist/core/mcp-probe.js +9 -4
  153. package/dist/core/mcp-server-link.d.ts +18 -6
  154. package/dist/core/mcp-server-link.js +19 -4
  155. package/dist/core/mcp-server-spec.d.ts +39 -9
  156. package/dist/core/mcp-server-spec.js +55 -21
  157. package/dist/core/mcp-session-end.d.ts +1 -2
  158. package/dist/core/mcp-session-end.js +1 -1
  159. package/dist/core/mcp.d.ts +23 -55
  160. package/dist/core/mcp.js +172 -156
  161. package/dist/core/media-byte-cap.d.ts +21 -46
  162. package/dist/core/media-byte-cap.js +55 -55
  163. package/dist/core/member-group.d.ts +7 -0
  164. package/dist/core/member-group.js +35 -0
  165. package/dist/core/memory-admission.d.ts +23 -6
  166. package/dist/core/memory-admission.js +19 -9
  167. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  168. package/dist/core/memory-engine/consolidation.js +7 -1
  169. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  170. package/dist/core/memory-engine/content-origin.js +21 -3
  171. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  172. package/dist/core/memory-engine/dual-root.js +59 -11
  173. package/dist/core/memory-engine/engine.js +27 -24
  174. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  175. package/dist/core/memory-engine/file-backend.js +35 -15
  176. package/dist/core/memory-engine/index.d.ts +2 -1
  177. package/dist/core/memory-engine/index.js +2 -1
  178. package/dist/core/memory-engine/layout.d.ts +3 -0
  179. package/dist/core/memory-engine/layout.js +13 -3
  180. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  181. package/dist/core/memory-engine/memory-deployment.js +182 -0
  182. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  183. package/dist/core/memory-engine/scope-contract.js +2 -2
  184. package/dist/core/memory-engine/sync-client.d.ts +68 -13
  185. package/dist/core/memory-engine/sync-client.js +147 -18
  186. package/dist/core/memory-engine/sync-report.d.ts +106 -0
  187. package/dist/core/memory-engine/sync-report.js +119 -0
  188. package/dist/core/memory-engine/sync.d.ts +13 -3
  189. package/dist/core/mode-policy.d.ts +15 -7
  190. package/dist/core/mode-policy.js +18 -6
  191. package/dist/core/model-receipt.d.ts +39 -0
  192. package/dist/core/model-receipt.js +139 -0
  193. package/dist/core/mods/agent-stations.d.ts +100 -0
  194. package/dist/core/mods/agent-stations.js +154 -0
  195. package/dist/core/mods/dollar.d.ts +62 -0
  196. package/dist/core/mods/extension-call.d.ts +15 -1
  197. package/dist/core/mods/extension-call.js +7 -2
  198. package/dist/core/mods/kernel/dispatch.d.ts +9 -4
  199. package/dist/core/mods/kernel/dispatch.js +8 -8
  200. package/dist/core/mods/kernel/events.d.ts +13 -4
  201. package/dist/core/mods/kernel/events.js +14 -10
  202. package/dist/core/mods/kernel/receive.d.ts +5 -0
  203. package/dist/core/mods/kernel/receive.js +10 -0
  204. package/dist/core/mods/kernel/registration.d.ts +3 -0
  205. package/dist/core/mods/kernel/registration.js +5 -0
  206. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  207. package/dist/core/mods/kernel/site-rules.js +10 -2
  208. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  209. package/dist/core/mods/lifecycle-stations.js +35 -0
  210. package/dist/core/mods/session-append.d.ts +115 -0
  211. package/dist/core/mods/session-append.js +311 -0
  212. package/dist/core/mods/session-compact.d.ts +48 -0
  213. package/dist/core/mods/session-compact.js +194 -0
  214. package/dist/core/mods/session-receive.d.ts +93 -0
  215. package/dist/core/mods/session-receive.js +141 -0
  216. package/dist/core/mods/session-send.d.ts +72 -0
  217. package/dist/core/mods/session-send.js +88 -0
  218. package/dist/core/mods/stations.d.ts +89 -75
  219. package/dist/core/mods/stations.js +57 -53
  220. package/dist/core/mods/tool-call.d.ts +12 -4
  221. package/dist/core/mods/tool-call.js +32 -16
  222. package/dist/core/mounted-mcp.d.ts +5 -0
  223. package/dist/core/mounted-mcp.js +2 -2
  224. package/dist/core/namespaced-rule-name.d.ts +7 -1
  225. package/dist/core/namespaced-rule-name.js +13 -2
  226. package/dist/core/oracle-isolation.js +1 -1
  227. package/dist/core/output-style.js +3 -4
  228. package/dist/core/own-property-receipt.d.ts +62 -0
  229. package/dist/core/own-property-receipt.js +43 -0
  230. package/dist/core/park-selfcheck.js +12 -10
  231. package/dist/core/path-identity.d.ts +11 -0
  232. package/dist/core/path-identity.js +4 -0
  233. package/dist/core/path-rule-binding.d.ts +3 -1
  234. package/dist/core/path-rule-binding.js +3 -1
  235. package/dist/core/peer-seat.d.ts +66 -11
  236. package/dist/core/peer-seat.js +199 -42
  237. package/dist/core/permission-rule-consent.d.ts +21 -26
  238. package/dist/core/permission-rule-consent.js +22 -3
  239. package/dist/core/permission-rule-model.d.ts +38 -13
  240. package/dist/core/permission-rule-model.js +54 -16
  241. package/dist/core/permission-rule-org.d.ts +1 -1
  242. package/dist/core/permission-rule-provider.js +4 -1
  243. package/dist/core/permission-rules.d.ts +4 -0
  244. package/dist/core/permission-rules.js +11 -16
  245. package/dist/core/protocol-http-auth.d.ts +14 -2
  246. package/dist/core/protocol-http-auth.js +16 -7
  247. package/dist/core/read-face-seats.d.ts +7 -5
  248. package/dist/core/read-face-seats.js +4 -1
  249. package/dist/core/redaction-marks.d.ts +4 -3
  250. package/dist/core/redaction-marks.js +2 -2
  251. package/dist/core/remote-env.d.ts +218 -122
  252. package/dist/core/remote-env.js +133 -14
  253. package/dist/core/retention-policy.d.ts +24 -23
  254. package/dist/core/retention-policy.js +36 -2
  255. package/dist/core/retention.d.ts +4 -1
  256. package/dist/core/retention.js +37 -12
  257. package/dist/core/retired-keys.d.ts +8 -3
  258. package/dist/core/retired-keys.js +4 -1
  259. package/dist/core/rewrite-rejudge.d.ts +12 -5
  260. package/dist/core/rewrite-rejudge.js +9 -5
  261. package/dist/core/roles.d.ts +37 -3
  262. package/dist/core/roles.js +126 -78
  263. package/dist/core/row-admission.d.ts +10 -0
  264. package/dist/core/row-admission.js +5 -0
  265. package/dist/core/rule-owner.d.ts +3 -0
  266. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  267. package/dist/core/runner/advisor-instructions.js +2 -1
  268. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  269. package/dist/core/runner/assemble-result.d.ts +13 -8
  270. package/dist/core/runner/assemble-result.js +12 -8
  271. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  272. package/dist/core/runner/call-hook-stations.js +21 -10
  273. package/dist/core/runner/caller-roster.d.ts +12 -9
  274. package/dist/core/runner/caller-roster.js +5 -2
  275. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  276. package/dist/core/runner/checkpoint-scope.js +21 -0
  277. package/dist/core/runner/child-tree.d.ts +7 -8
  278. package/dist/core/runner/child-tree.js +6 -6
  279. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  280. package/dist/core/runner/classifier-ladder.js +39 -8
  281. package/dist/core/runner/compact-session.js +14 -2
  282. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  283. package/dist/core/runner/compaction-restate.d.ts +2 -2
  284. package/dist/core/runner/compaction-restate.js +4 -3
  285. package/dist/core/runner/construction-doors.d.ts +2 -2
  286. package/dist/core/runner/construction-doors.js +7 -2
  287. package/dist/core/runner/contracts.d.ts +158 -65
  288. package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
  289. package/dist/core/runner/cross-boundary-lane.js +11 -2
  290. package/dist/core/runner/decide-continuation.d.ts +4 -2
  291. package/dist/core/runner/decide-continuation.js +7 -4
  292. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  293. package/dist/core/runner/denial-limit-arms.js +17 -10
  294. package/dist/core/runner/env-capability-census.d.ts +15 -20
  295. package/dist/core/runner/env-capability-census.js +25 -34
  296. package/dist/core/runner/expire-settle.d.ts +44 -0
  297. package/dist/core/runner/expire-settle.js +55 -0
  298. package/dist/core/runner/file-history-request.d.ts +2 -2
  299. package/dist/core/runner/file-history-request.js +0 -8
  300. package/dist/core/runner/gate-exit.d.ts +75 -7
  301. package/dist/core/runner/gate-exit.js +20 -1
  302. package/dist/core/runner/git-status-frame.d.ts +5 -2
  303. package/dist/core/runner/git-status-frame.js +4 -4
  304. package/dist/core/runner/halt-attribution.d.ts +2 -1
  305. package/dist/core/runner/halt-attribution.js +2 -1
  306. package/dist/core/runner/image.d.ts +7 -2
  307. package/dist/core/runner/image.js +14 -8
  308. package/dist/core/runner/inline-image.d.ts +10 -8
  309. package/dist/core/runner/inline-image.js +11 -9
  310. package/dist/core/runner/local-claims.d.ts +17 -0
  311. package/dist/core/runner/local-claims.js +18 -0
  312. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  313. package/dist/core/runner/media-removed-seat.js +88 -0
  314. package/dist/core/runner/memory-consolidation-driver.js +4 -4
  315. package/dist/core/runner/park-commit.d.ts +2 -2
  316. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  317. package/dist/core/runner/permission-rule-lanes.js +29 -10
  318. package/dist/core/runner/person-path-rows.js +1 -1
  319. package/dist/core/runner/placement-fence.d.ts +26 -0
  320. package/dist/core/runner/placement-fence.js +38 -0
  321. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  322. package/dist/core/runner/prepare-ask-lane.js +4 -4
  323. package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
  324. package/dist/core/runner/prepare-boundary-parks.js +4 -4
  325. package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
  326. package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
  327. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  328. package/dist/core/runner/prepare-config-doors.js +30 -26
  329. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  330. package/dist/core/runner/prepare-context-lane.js +13 -13
  331. package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
  332. package/dist/core/runner/prepare-delegation-surface.js +7 -8
  333. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  334. package/dist/core/runner/prepare-execution-env.js +7 -4
  335. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  336. package/dist/core/runner/prepare-file-history.js +3 -12
  337. package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
  338. package/dist/core/runner/prepare-gate-stations.js +10 -7
  339. package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
  340. package/dist/core/runner/prepare-hands-readface.js +19 -11
  341. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  342. package/dist/core/runner/prepare-inherited-gate.js +12 -5
  343. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  344. package/dist/core/runner/prepare-lsp.js +2 -2
  345. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  346. package/dist/core/runner/prepare-memory.d.ts +2 -2
  347. package/dist/core/runner/prepare-memory.js +2 -2
  348. package/dist/core/runner/prepare-park-ask.d.ts +8 -7
  349. package/dist/core/runner/prepare-park-ask.js +6 -12
  350. package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
  351. package/dist/core/runner/prepare-policy-chain.js +131 -128
  352. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  353. package/dist/core/runner/prepare-project-context.js +8 -5
  354. package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
  355. package/dist/core/runner/prepare-prompt-inputs.js +4 -2
  356. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  357. package/dist/core/runner/prepare-protocol-tools.js +9 -2
  358. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  359. package/dist/core/runner/prepare-question-face.js +2 -2
  360. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  361. package/dist/core/runner/prepare-run-refs.js +2 -2
  362. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
  363. package/dist/core/runner/prepare-suspend-saga.js +21 -13
  364. package/dist/core/runner/prepare-task.d.ts +1 -1
  365. package/dist/core/runner/prepare-task.js +84 -42
  366. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  367. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  368. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  369. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  370. package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
  371. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  372. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  373. package/dist/core/runner/prepare-workspace-restore.js +12 -8
  374. package/dist/core/runner/read-root-grant.d.ts +1 -1
  375. package/dist/core/runner/read-root-grant.js +2 -1
  376. package/dist/core/runner/resume-admission.d.ts +5 -3
  377. package/dist/core/runner/resume-admission.js +17 -3
  378. package/dist/core/runner/resume-apply.js +3 -1
  379. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  380. package/dist/core/runner/resume-claim.d.ts +8 -3
  381. package/dist/core/runner/resume-claim.js +28 -12
  382. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  383. package/dist/core/runner/resume-internals-and-config.js +10 -1
  384. package/dist/core/runner/resume-preflight.d.ts +3 -2
  385. package/dist/core/runner/resume-preflight.js +13 -26
  386. package/dist/core/runner/retired-runner-deps.js +6 -1
  387. package/dist/core/runner/run-attachment-seats.js +3 -3
  388. package/dist/core/runner/run-brain-sinks.js +1 -0
  389. package/dist/core/runner/run-git-lane.d.ts +3 -1
  390. package/dist/core/runner/run-git-lane.js +3 -2
  391. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  392. package/dist/core/runner/run-harness-handlers.js +5 -3
  393. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  394. package/dist/core/runner/run-identity-wiring.js +15 -6
  395. package/dist/core/runner/run-leg.d.ts +3 -3
  396. package/dist/core/runner/run-leg.js +65 -56
  397. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  398. package/dist/core/runner/run-notification-lane.js +36 -12
  399. package/dist/core/runner/run-recovery-lanes.js +3 -2
  400. package/dist/core/runner/run-settle-and-teardown.js +14 -8
  401. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  402. package/dist/core/runner/run-stop-and-final-verify.js +12 -4
  403. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  404. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  405. package/dist/core/runner/run-terminal-adoption.js +26 -17
  406. package/dist/core/runner/run-turn-boundary.js +37 -19
  407. package/dist/core/runner/runtask.d.ts +25 -7
  408. package/dist/core/runner/runtask.js +46 -22
  409. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  410. package/dist/core/runner/session-rule-policy.js +6 -1
  411. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  412. package/dist/core/runner/skills-seat.js +2 -2
  413. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  414. package/dist/core/runner/stream-halt-verbs.js +4 -3
  415. package/dist/core/runner/stream-reap.d.ts +7 -6
  416. package/dist/core/runner/stream-reap.js +13 -16
  417. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  418. package/dist/core/runner/stream-settle-backstop.js +5 -3
  419. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  420. package/dist/core/runner/stream-steer-verb.js +8 -7
  421. package/dist/core/runner/sub-agent-deny-lists.js +10 -7
  422. package/dist/core/runner/synthetic-tools.js +2 -2
  423. package/dist/core/runner/terminal-account.d.ts +11 -1
  424. package/dist/core/runner/terminal-account.js +20 -0
  425. package/dist/core/runner/terminal-projection.d.ts +8 -2
  426. package/dist/core/runner/terminal-projection.js +2 -2
  427. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  428. package/dist/core/runner/tool-disclosure.js +5 -4
  429. package/dist/core/runner/tool-end-body.d.ts +3 -3
  430. package/dist/core/runner/tool-end-body.js +1 -1
  431. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  432. package/dist/core/runner/tool-face-overlay.js +26 -19
  433. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  434. package/dist/core/runner/tool-output-projection.js +7 -6
  435. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  436. package/dist/core/runner/tool-result-media-seat.js +17 -1
  437. package/dist/core/runner/tool-table-view.d.ts +56 -0
  438. package/dist/core/runner/tool-table-view.js +51 -0
  439. package/dist/core/runner/turn-attachments.d.ts +6 -7
  440. package/dist/core/runner/turn-attachments.js +4 -17
  441. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  442. package/dist/core/runner/void-verifier-pause.js +41 -0
  443. package/dist/core/runner-deps.d.ts +55 -43
  444. package/dist/core/secret-env.d.ts +14 -13
  445. package/dist/core/secret-env.js +8 -9
  446. package/dist/core/session-log-transfer.js +9 -10
  447. package/dist/core/session-policy-store.d.ts +10 -3
  448. package/dist/core/session-policy-store.js +21 -3
  449. package/dist/core/session-reconcile.d.ts +3 -2
  450. package/dist/core/session-reconcile.js +7 -4
  451. package/dist/core/session-store.d.ts +5 -2
  452. package/dist/core/session-store.js +53 -16
  453. package/dist/core/session.d.ts +2 -1
  454. package/dist/core/shell-confinement.d.ts +37 -0
  455. package/dist/core/shell-confinement.js +56 -0
  456. package/dist/core/skill-grant.d.ts +9 -0
  457. package/dist/core/skill-grant.js +18 -0
  458. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  459. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  460. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  461. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  462. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  463. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  464. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  465. package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
  466. package/dist/core/stub-env.d.ts +5 -5
  467. package/dist/core/stub-env.js +11 -1
  468. package/dist/core/swappable-deps.d.ts +17 -43
  469. package/dist/core/swappable-deps.js +15 -5
  470. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  471. package/dist/core/task-event.d.ts +35 -10
  472. package/dist/core/task-limits.d.ts +5 -0
  473. package/dist/core/task-notification.d.ts +172 -12
  474. package/dist/core/task-notification.js +209 -12
  475. package/dist/core/task-registry-agent.d.ts +23 -55
  476. package/dist/core/task-registry-agent.js +41 -56
  477. package/dist/core/task-registry-monitor.d.ts +8 -1
  478. package/dist/core/task-registry-monitor.js +43 -61
  479. package/dist/core/task-registry-shared.d.ts +52 -114
  480. package/dist/core/task-registry-shared.js +24 -48
  481. package/dist/core/task-registry-workflow.js +5 -22
  482. package/dist/core/task-registry.d.ts +64 -90
  483. package/dist/core/task-registry.js +73 -119
  484. package/dist/core/task-result.d.ts +27 -19
  485. package/dist/core/task-spec-members.d.ts +39 -0
  486. package/dist/core/task-spec-members.js +92 -0
  487. package/dist/core/task-spec.d.ts +13 -16
  488. package/dist/core/task-stream.d.ts +1 -1
  489. package/dist/core/task-tool-shape.d.ts +7 -57
  490. package/dist/core/task-tool-shape.js +7 -66
  491. package/dist/core/terminal-cause.d.ts +30 -0
  492. package/dist/core/terminal-cause.js +1 -0
  493. package/dist/core/tool-catalog-entries.js +3 -6
  494. package/dist/core/tool-check-reading.js +16 -10
  495. package/dist/core/tool-conformance.js +1 -2
  496. package/dist/core/tool-errors.d.ts +6 -3
  497. package/dist/core/tool-errors.js +2 -0
  498. package/dist/core/tool-face-reader.d.ts +7 -6
  499. package/dist/core/tool-face-reader.js +6 -4
  500. package/dist/core/tool-face.d.ts +2 -3
  501. package/dist/core/tool-name-aliases.d.ts +23 -28
  502. package/dist/core/tool-name-aliases.js +63 -7
  503. package/dist/core/tool-name-readings.d.ts +14 -3
  504. package/dist/core/tool-name-readings.js +2 -0
  505. package/dist/core/tool-policy.d.ts +113 -22
  506. package/dist/core/tool-policy.js +85 -15
  507. package/dist/core/tool-registry.d.ts +5 -5
  508. package/dist/core/tool-registry.js +2 -2
  509. package/dist/core/tool-result-store.d.ts +111 -5
  510. package/dist/core/tool-result-store.js +52 -12
  511. package/dist/core/tool-spec.d.ts +39 -10
  512. package/dist/core/trace.d.ts +18 -2
  513. package/dist/core/types.d.ts +3 -3
  514. package/dist/core/types.js +1 -1
  515. package/dist/core/untrusted-text.js +1 -1
  516. package/dist/core/user-attachment.d.ts +10 -5
  517. package/dist/core/user-attachment.js +40 -27
  518. package/dist/core/workflow-journal-store.d.ts +1 -1
  519. package/dist/core/workflow-run-store.d.ts +2 -0
  520. package/dist/core/workflow-run-store.js +6 -5
  521. package/dist/core/workflow-settled-run.d.ts +5 -0
  522. package/dist/core/workflow-settled-run.js +7 -0
  523. package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
  524. package/dist/engine/execution-env/node-execution-env.js +224 -21
  525. package/dist/engine/harness/agent-harness.d.ts +66 -19
  526. package/dist/engine/harness/agent-harness.js +98 -27
  527. package/dist/engine/harness/messages.d.ts +4 -3
  528. package/dist/engine/harness/messages.js +2 -2
  529. package/dist/engine/harness/types.d.ts +151 -34
  530. package/dist/engine/llm/media-removed.d.ts +14 -0
  531. package/dist/engine/llm/media-removed.js +9 -0
  532. package/dist/engine/llm/rejected-images.d.ts +35 -25
  533. package/dist/engine/llm/rejected-images.js +59 -10
  534. package/dist/engine/llm/types.d.ts +24 -3
  535. package/dist/engine/llm/types.js +7 -3
  536. package/dist/engine/loop/agent-loop.d.ts +18 -13
  537. package/dist/engine/loop/agent-loop.js +173 -32
  538. package/dist/engine/loop/types.d.ts +21 -5
  539. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  540. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  541. package/dist/engine/session/import-validate.js +7 -0
  542. package/dist/fixtures/index.d.ts +7 -5
  543. package/dist/fixtures/index.js +5 -3
  544. package/dist/index.d.ts +41 -23
  545. package/dist/index.js +29 -16
  546. package/dist/internal/harness-types.d.ts +3 -1
  547. package/dist/internal/llm.d.ts +2 -1
  548. package/dist/internal/llm.js +1 -0
  549. package/dist/orchestration/goal.d.ts +6 -2
  550. package/dist/orchestration/goal.js +6 -3
  551. package/dist/orchestration/run-workflow-tool.d.ts +20 -20
  552. package/dist/orchestration/run-workflow-tool.js +63 -56
  553. package/dist/orchestration/workflow-governance.d.ts +1 -1
  554. package/dist/orchestration/workflow-governance.js +2 -1
  555. package/dist/orchestration/workflow-types.d.ts +2 -2
  556. package/dist/orchestration/workflow.d.ts +8 -0
  557. package/dist/orchestration/workflow.js +33 -9
  558. package/dist/prompts/default.d.ts +1 -10
  559. package/dist/prompts/default.js +0 -2
  560. package/dist/stores/file/background-agent-store.d.ts +1 -1
  561. package/dist/stores/file/background-agent-store.js +19 -14
  562. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  563. package/dist/stores/file/checkpoint-store.js +24 -16
  564. package/dist/stores/file/file-history-store.d.ts +1 -1
  565. package/dist/stores/file/file-history-store.js +4 -1
  566. package/dist/stores/file/index.d.ts +9 -6
  567. package/dist/stores/file/index.js +33 -9
  568. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  569. package/dist/stores/file/ledger-tuning.js +21 -0
  570. package/dist/stores/file/mailbox-store.d.ts +1 -1
  571. package/dist/stores/file/mailbox-store.js +43 -21
  572. package/dist/stores/file/memory-store.d.ts +1 -1
  573. package/dist/stores/file/memory-store.js +4 -1
  574. package/dist/stores/file/permission-rule-adopt.js +24 -21
  575. package/dist/stores/file/permission-rule-store.js +6 -3
  576. package/dist/stores/file/session-policy-store.d.ts +1 -1
  577. package/dist/stores/file/session-policy-store.js +4 -1
  578. package/dist/stores/file/session-store.d.ts +17 -4
  579. package/dist/stores/file/session-store.js +22 -19
  580. package/dist/stores/file/shared-ledger.d.ts +26 -0
  581. package/dist/stores/file/shared-ledger.js +38 -9
  582. package/dist/stores/file/tool-result-store.d.ts +31 -2
  583. package/dist/stores/file/tool-result-store.js +129 -7
  584. package/dist/stores/file/usage-window-store.d.ts +1 -1
  585. package/dist/stores/file/usage-window-store.js +4 -1
  586. package/dist/stores/file/workflow-journal-store.d.ts +1 -13
  587. package/dist/stores/file/workflow-journal-store.js +4 -18
  588. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  589. package/dist/stores/file/workflow-run-store.js +15 -10
  590. package/dist/tools/fs/containment-face.d.ts +5 -0
  591. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  592. package/dist/tools/fs/dead-cwd.js +4 -11
  593. package/dist/tools/fs/encoding.d.ts +13 -4
  594. package/dist/tools/fs/encoding.js +17 -2
  595. package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
  596. package/dist/tools/fs/fs-bash-background-text.js +7 -0
  597. package/dist/tools/fs/fs-bash.d.ts +11 -22
  598. package/dist/tools/fs/fs-bash.js +58 -154
  599. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  600. package/dist/tools/fs/fs-pdf.js +34 -27
  601. package/dist/tools/fs/fs-read.d.ts +5 -4
  602. package/dist/tools/fs/fs-read.js +35 -18
  603. package/dist/tools/fs/fs-search-tools.js +4 -1
  604. package/dist/tools/fs/fs-shared.d.ts +39 -16
  605. package/dist/tools/fs/fs-shared.js +25 -6
  606. package/dist/tools/fs/fs-write.js +5 -5
  607. package/dist/tools/fs/index.d.ts +15 -9
  608. package/dist/tools/fs/index.js +12 -18
  609. package/dist/tools/fs/pdf.d.ts +4 -4
  610. package/dist/tools/fs/pdf.js +6 -6
  611. package/dist/tools/fs/read-deny-home.js +8 -1
  612. package/dist/tools/fs/read-deny.d.ts +26 -2
  613. package/dist/tools/fs/read-deny.js +9 -2
  614. package/dist/tools/fs/read-floor.d.ts +57 -6
  615. package/dist/tools/fs/read-floor.js +241 -2
  616. package/dist/tools/fs/removal-targets.d.ts +9 -4
  617. package/dist/tools/fs/removal-targets.js +17 -9
  618. package/dist/tools/fs/search.d.ts +6 -5
  619. package/dist/tools/fs/search.js +10 -10
  620. package/dist/tools/fs/shell-read-establish.js +3 -1
  621. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  622. package/dist/tools/fs/shell-read-identity.js +4 -2
  623. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  624. package/dist/tools/fs/shell-read-judge.js +1 -1
  625. package/dist/tools/monitor.d.ts +12 -10
  626. package/dist/tools/monitor.js +22 -13
  627. package/dist/tools/scheduler-tools.js +42 -4
  628. package/dist/tools/web.d.ts +0 -10
  629. package/dist/tools/web.js +1 -4
  630. package/dist/tools/worktree.d.ts +5 -1
  631. package/dist/tools/worktree.js +20 -17
  632. package/package.json +8 -3
  633. package/test/export-surface.snapshot.json +166 -30
  634. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  635. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  636. package/wire-changes/core@7.60.0.json +3274 -0
  637. package/wire-changes/core@7.61.0.json +4405 -0
  638. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  639. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  640. package/wire-changes/primitives@7.60.0.json +30 -0
  641. package/wire-changes/primitives@7.61.0.json +30 -0
  642. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  643. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -1,4 +1,4 @@
1
- import type { AgentMessage, ExecutionEnv, GitAnnouncementKind, SessionTreeEntry } from "../../internal/harness-types.js";
1
+ import type { AgentMessage, ExecutionEnv, GitAnnouncementKind, ReadFloor, SessionTreeEntry } from "../../internal/harness-types.js";
2
2
  /** Bound into the hash domain: bump when the frame's wording/structure changes so the upgraded
3
3
  * renderer re-announces on its first leg instead of being suppressed by a pre-upgrade hash. */
4
4
  export declare const GIT_STATUS_FRAME_FORMAT_VERSION = 1;
@@ -155,6 +155,9 @@ export declare function probeGitStatusLane(args: {
155
155
  };
156
156
  handsEnabled: boolean;
157
157
  taskRoot: string;
158
+ /** The byte floor of the snapshot's start, read as it starts: the run's base read-deny table (`git config` reads what an
159
+ * `include.path` names). A floor that cannot be read degrades the frame, as a failed snapshot does. */
160
+ readFloor?: () => ReadFloor | undefined;
158
161
  onDegrade: (reason: string) => void;
159
162
  }): Promise<GitStatusLaneRef>;
160
163
  /**
@@ -189,7 +192,7 @@ export declare function newestEngineGitFrame(branch: SessionTreeEntry[], mark?:
189
192
  entryId: string;
190
193
  positive: boolean;
191
194
  } | undefined;
192
- export declare function stripGitStatusUnits(text: string, mark?: string): string;
195
+ export declare function stripGitStatusUnits(text: string): string;
193
196
  /**
194
197
  * The readable-absence tombstone question (R2-1), answered by the classifier above: does the
195
198
  * branch carry a still-context-visible POSITIVE engine frame as its newest git frame? A newest
@@ -62,7 +62,7 @@ export function resolveGitStatusFrame(outcome, canonicalRoot, degradedMaterial)
62
62
  return resolved;
63
63
  }
64
64
  export async function probeGitStatusLane(args) {
65
- const { executionEnv, envFacts, handsEnabled, taskRoot, onDegrade } = args;
65
+ const { executionEnv, envFacts, handsEnabled, taskRoot, readFloor, onDegrade } = args;
66
66
  const ref = {};
67
67
  if (!handsEnabled)
68
68
  return ref;
@@ -75,7 +75,8 @@ export async function probeGitStatusLane(args) {
75
75
  ...(envFacts.gitDirty !== undefined ? { dirty: envFacts.gitDirty } : {}),
76
76
  };
77
77
  try {
78
- const snap = await executionEnv.exec(`(m=$(git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null); m=\${m#origin/}; for s in "$m" main master; do if [ -n "$s" ] && git show-ref --verify --quiet "refs/remotes/origin/$s"; then echo "$s"; break; fi; done) || true; echo "${SEP}"; (git config user.name 2>/dev/null || true); echo "${SEP}"; gs=$(git --no-optional-locks status --short) || exit 41; printf '%s\\n' "$gs"; echo "${SEP}"; gl=$(git --no-optional-locks log --oneline -n 5) || exit 42; printf '%s\\n' "$gl"`, { cwd: envFacts.cwd, timeout: 10 });
78
+ const snapFloor = readFloor?.();
79
+ const snap = await executionEnv.exec(`(m=$(git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null); m=\${m#origin/}; for s in "$m" main master; do if [ -n "$s" ] && git show-ref --verify --quiet "refs/remotes/origin/$s"; then echo "$s"; break; fi; done) || true; echo "${SEP}"; (git config user.name 2>/dev/null || true); echo "${SEP}"; gs=$(git --no-optional-locks status --short) || exit 41; printf '%s\\n' "$gs"; echo "${SEP}"; gl=$(git --no-optional-locks log --oneline -n 5) || exit 42; printf '%s\\n' "$gl"`, { cwd: envFacts.cwd, timeout: 10, ...(snapFloor !== undefined ? { readFloor: snapFloor } : {}) });
79
80
  if (snap.ok && snap.value.exitCode === 0) {
80
81
  const parts = snap.value.stdout.split(`${SEP}\n`);
81
82
  if (parts.length === 4) {
@@ -208,8 +209,7 @@ function hasNestedReminderOpenTag(seg) {
208
209
  }
209
210
  return false;
210
211
  }
211
- export function stripGitStatusUnits(text, mark) {
212
- void mark;
212
+ export function stripGitStatusUnits(text) {
213
213
  const close = "</system-reminder>";
214
214
  const findHead = (out, from) => {
215
215
  for (let at = out.indexOf("<system-reminder", from); at !== -1; at = out.indexOf("<system-reminder", at + 1)) {
@@ -21,7 +21,8 @@ export interface UnconsumedHaltDisclosureInput {
21
21
  onNotice: RunnerDeps["onNotice"];
22
22
  sessionId: string;
23
23
  runId: string;
24
- taskId: string | undefined;
24
+ /** The leg's own task id (`Prepared.taskId`) — always present. */
25
+ taskId: string;
25
26
  }
26
27
  /**
27
28
  * The ACCEPTED-but-UNCONSUMED halt: the verb latched the stop (and may have cut a seat), but the run ended for
@@ -1,3 +1,4 @@
1
+ import { legNoticeTaskId } from "../mods/stations.js";
1
2
  import { deliverEngineNotice } from "../types.js";
2
3
  export function haltConsumed(c) {
3
4
  return c?.turnCut === "halt" || c?.boundaryStop?.sources.includes("halt") === true;
@@ -10,7 +11,7 @@ export function discloseUnconsumedHalt(input) {
10
11
  message: "a user halt was accepted, but the run ended for its own reason before the halt stopped or cut anything: " +
11
12
  "no turn was settled as its cut and no boundary stopped for it — the run's own ending stands, and the result " +
12
13
  "will not carry haltedByUser for this halt.",
13
- detail: { sessionId: input.sessionId, runId: input.runId, ...(input.taskId !== undefined ? { taskId: input.taskId } : {}) },
14
+ detail: { sessionId: input.sessionId, runId: input.runId, ...legNoticeTaskId(input) },
14
15
  });
15
16
  return true;
16
17
  }
@@ -1,6 +1,7 @@
1
1
  import type { ImageContent } from "../../internal/llm.js";
2
2
  import { type HostFloor } from "../host-floor.js";
3
3
  import type { ImageInput } from "../types.js";
4
+ import { type ImageDownsampler } from "../image-downsample.js";
4
5
  /**
5
6
  * The guard of a remote image URL: https only, then the one egress hop judge with the private-network floor (`hopRefusal`,
6
7
  * host-floor.ts) — the deployment's host floor (`RunnerDeps.hostFloor`, `floor`) must admit the host, and a private host is
@@ -8,5 +9,9 @@ import type { ImageInput } from "../types.js";
8
9
  * `169.254.169.254` or a private box. The host is read literally (no DNS resolution). Throws on a refused URL.
9
10
  */
10
11
  export declare function defaultImageUrlGuard(raw: string, floor?: HostFloor): void;
11
- /** Resolve an {@link ImageInput} (inline base64 or a URL to fetch) into a vendored `ImageContent` block. */
12
- export declare function toImageContent(img: ImageInput, floor: HostFloor | undefined): Promise<ImageContent>;
12
+ /** Resolve an {@link ImageInput} (inline base64 or a URL to fetch) into a vendored `ImageContent` block: both arms pass
13
+ * the one byte admission with the run's processor (inline-image.ts) — a fetched body after the URL's own guard and cap. */
14
+ export declare function toImageContent(img: ImageInput, floor: HostFloor | undefined, processor: ImageDownsampler | "none"): Promise<ImageContent>;
15
+ /** The task's images (`TaskSpec.images`), each through {@link toImageContent} with the run's one processor (`seat` =
16
+ * `RunnerDeps.imageProcessor`); the first one sent unprocessed over the soft target is told to `unprocessed`. */
17
+ export declare function toImageContents(images: readonly ImageInput[], floor: HostFloor | undefined, seat: ImageDownsampler | false | undefined, unprocessed: (bytes: number) => void): Promise<ImageContent[]>;
@@ -1,9 +1,7 @@
1
1
  import { hopRefusal } from "../host-floor.js";
2
- import { ADMITTED_IMAGE_MIME_TYPES, imageMagicMatches } from "../image-admission.js";
2
+ import { firstUnprocessedOverTarget, IMAGE_ADMISSION, sniffImageMime } from "../image-admission.js";
3
+ import { resolveImageProcessor } from "../image-downsample.js";
3
4
  import { admitInlineImage } from "./inline-image.js";
4
- function sniffImageMime(bytes) {
5
- return ADMITTED_IMAGE_MIME_TYPES.find((mime) => imageMagicMatches(bytes, mime));
6
- }
7
5
  export function defaultImageUrlGuard(raw, floor) {
8
6
  let u;
9
7
  try {
@@ -20,7 +18,7 @@ export function defaultImageUrlGuard(raw, floor) {
20
18
  throw new Error(`image url not fetched — ${refused}`);
21
19
  }
22
20
  const IMAGE_FETCH_TIMEOUT_MS = 30_000;
23
- const IMAGE_MAX_BYTES = 20 * 1024 * 1024;
21
+ const IMAGE_MAX_BYTES = IMAGE_ADMISSION.hard.urlBytes;
24
22
  async function readImageBodyCapped(res) {
25
23
  const reader = res.body?.getReader();
26
24
  if (!reader) {
@@ -67,12 +65,20 @@ async function fetchImageCapped(url) {
67
65
  }
68
66
  return { buf, mimeType: sniffed };
69
67
  }
70
- export async function toImageContent(img, floor) {
68
+ export async function toImageContent(img, floor, processor) {
71
69
  if ("url" in img) {
72
70
  const url = img.url;
73
71
  defaultImageUrlGuard(url, floor);
74
72
  const { buf, mimeType } = await fetchImageCapped(url);
75
- return { type: "image", data: buf.toString("base64"), mimeType };
73
+ return admitInlineImage({ data: buf.toString("base64"), mimeType }, processor, "the image fetched from its url");
76
74
  }
77
- return admitInlineImage(img);
75
+ return admitInlineImage(img, processor);
76
+ }
77
+ export async function toImageContents(images, floor, seat, unprocessed) {
78
+ const processor = await resolveImageProcessor(seat);
79
+ const blocks = await Promise.all(images.map((img) => toImageContent(img, floor, processor)));
80
+ const over = firstUnprocessedOverTarget(blocks, processor);
81
+ if (over !== undefined)
82
+ unprocessed(over);
83
+ return blocks;
78
84
  }
@@ -1,14 +1,16 @@
1
1
  /**
2
- * The `TaskSpec.images` INLINE arm's admission: the same byte admission a file the Read tool serves passes
3
- * (image-admission.ts) — a claimed type the API accepts, within the raw cap, that type's signature, under
4
- * the provider's base64 limit. Without it a mis-declared image rode straight to the provider and 400'd the whole
5
- * request. Like the Read lane it checks the SIGNATURE, not decodability: a file cut short after its signature
6
- * passes (KL-1311a-c). No downsampling here: this arm only refuses what would not survive the wire, and a
7
- * valid image reaches the model unchanged. The block is built from the bytes that were checked.
2
+ * The `TaskSpec.images` arms' admission: the same byte admission a file the Read tool serves passes
3
+ * (image-admission.ts), with the run's processor — a claimed type the API accepts, within the raw cap, that type's
4
+ * signature, then the processor (or, with none, a header-stated size within the reject edge), under the provider's
5
+ * base64 limit. Without it a mis-declared image rode straight to the provider and 400'd the whole request. Like the
6
+ * Read lane it checks the SIGNATURE, not decodability: a file cut short after its signature passes when no processor
7
+ * reads it (KL-1311a-c). The block is built from the bytes that were checked (or the processor made from them).
8
8
  */
9
9
  import type { ImageContent } from "../../internal/llm.js";
10
10
  import type { ImageInput } from "../types.js";
11
- /** Admit one inline entry (`{ data, mimeType }`) or throw `config.image_invalid`. */
11
+ import type { ImageDownsampler } from "../image-downsample.js";
12
+ /** Admit one entry's bytes (`{ data, mimeType }` — inline, or a URL arm's fetched body, `subject` naming which) or throw
13
+ * `config.image_invalid`. */
12
14
  export declare function admitInlineImage(img: Extract<ImageInput, {
13
15
  data: string;
14
- }>): Promise<ImageContent>;
16
+ }>, processor: ImageDownsampler | "none", subject?: string): Promise<ImageContent>;
@@ -1,26 +1,28 @@
1
- import { admitImageBytes, ADMITTED_IMAGE_MIME_TYPES } from "../image-admission.js";
2
- import { MCP_IMAGE_MAX_BASE64 } from "../image-downsample.js";
1
+ import { admitImageBytes, ADMITTED_IMAGE_MIME_TYPES, IMAGE_ADMISSION, unprocessedSizeClause } from "../image-admission.js";
3
2
  function inlineImageRefusal(detail) {
4
3
  const e = new Error(`TaskSpec.images: ${detail}`);
5
4
  e.code = "config.image_invalid";
6
5
  return e;
7
6
  }
8
- export async function admitInlineImage(img) {
7
+ export async function admitInlineImage(img, processor, subject = "an inline image") {
9
8
  const data = img.data;
10
9
  const mimeType = img.mimeType;
11
10
  if (typeof data !== "string" || typeof mimeType !== "string")
12
- throw inlineImageRefusal("an inline image needs a base64 string `data` and a string `mimeType`.");
13
- const admitted = await admitImageBytes(Buffer.from(data, "base64"), mimeType, undefined);
11
+ throw inlineImageRefusal(`${subject} needs a base64 string \`data\` and a string \`mimeType\`.`);
12
+ const admitted = await admitImageBytes(Buffer.from(data, "base64"), mimeType, processor);
14
13
  if (admitted.ok)
15
14
  return admitted.block;
16
15
  switch (admitted.reason) {
17
16
  case "mime_unsupported":
18
- throw inlineImageRefusal(`an inline image declares mimeType ${JSON.stringify(mimeType.slice(0, 80))}, which the model API does not accept (accepted: ${ADMITTED_IMAGE_MIME_TYPES.join(", ")}).`);
17
+ throw inlineImageRefusal(`${subject} declares mimeType ${JSON.stringify(mimeType.slice(0, 80))}, which the model API does not accept (accepted: ${ADMITTED_IMAGE_MIME_TYPES.join(", ")}).`);
19
18
  case "magic_mismatch":
20
- throw inlineImageRefusal(`an inline image's bytes do not open with a valid ${mimeType} header (empty, truncated, mis-declared, not base64, or a variant such as an Apple-optimized PNG that model APIs cannot read) — refused rather than sent.`);
19
+ throw inlineImageRefusal(`${subject}'s bytes do not open with a valid ${mimeType} header (empty, truncated, mis-declared, not base64, or a variant such as an Apple-optimized PNG that model APIs cannot read) — refused rather than sent.`);
21
20
  case "raw_too_large":
22
- throw inlineImageRefusal(`an inline image is ${admitted.rawBytes} bytes, over the ${admitted.cap}-byte cap.`);
21
+ throw inlineImageRefusal(`${subject} is ${admitted.rawBytes} bytes, over the ${admitted.cap}-byte cap.`);
22
+ case "dimensions_unreadable":
23
+ case "dimensions_too_large":
24
+ throw inlineImageRefusal(`${subject} is refused rather than sent: ${unprocessedSizeClause(admitted)}.`);
23
25
  case "base64_too_large":
24
- throw inlineImageRefusal(`an inline image's base64 is ${admitted.base64.length} chars, over the ${MCP_IMAGE_MAX_BASE64}-char / 5MB API image limit — shrink it before sending.`);
26
+ throw inlineImageRefusal(`${subject}'s base64 is ${admitted.base64.length} chars, over the ${IMAGE_ADMISSION.hard.imageBase64Chars}-char / 5MB API image limit — shrink it before sending.`);
25
27
  }
26
28
  }
@@ -0,0 +1,17 @@
1
+ /**
2
+ * The Runner's same-Runner settle claims on checkpoint tokens. A claim is PER ATTEMPT: every in-Runner actor that settles a
3
+ * row (a resume's resolve, an in-Runner expire) opens its own claim with its CAS attempt and closes exactly that claim, once,
4
+ * when its duty is decided (a lost CAS, or the winner's duty done). A token is held while ANY attempt's claim is open — so a
5
+ * losing attempt never closes a winner's still-open claim, and a stream-side reap that loses its own expire preserves the
6
+ * paused-env reap record for whichever same-Runner winner is still on its way to it.
7
+ */
8
+ import type { CheckpointToken } from "../checkpoint-store.js";
9
+ export declare class LocalClaims {
10
+ #private;
11
+ /** Open one attempt's claim on `token` (with its CAS attempt). */
12
+ open(token: CheckpointToken): void;
13
+ /** Close one attempt's claim on `token` — the attempt's own, once, at its duty decision. */
14
+ close(token: CheckpointToken): void;
15
+ /** Whether any same-Runner attempt's claim on `token` is open. */
16
+ held(token: CheckpointToken): boolean;
17
+ }
@@ -0,0 +1,18 @@
1
+ export class LocalClaims {
2
+ #open = new Map();
3
+ open(token) {
4
+ this.#open.set(token, (this.#open.get(token) ?? 0) + 1);
5
+ }
6
+ close(token) {
7
+ const n = this.#open.get(token);
8
+ if (n === undefined)
9
+ return;
10
+ if (n > 1)
11
+ this.#open.set(token, n - 1);
12
+ else
13
+ this.#open.delete(token);
14
+ }
15
+ held(token) {
16
+ return this.#open.has(token);
17
+ }
18
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * The person's account of the media that left the model's view of a request (`context.media_removed`, user) — one code,
3
+ * the reason in `detail.reason`, the message minted once here for both:
4
+ * - `rejected_by_provider`: the harness's request view removes the images a provider refusal points at
5
+ * (`engine/llm/rejected-images.ts`) and hands {@link createProviderRefusalSeat} the removals the run itself met; every
6
+ * request re-reads the transcript — the live failure, then its record or a rebuilt copy — so that seat announces ONCE
7
+ * PER RUN PER REFUSAL, keyed by the identity all of those share (`refusalAt`);
8
+ * - `media_budget`: the request trim (`media-byte-cap.ts`) hands {@link createMediaBudgetSeat} what it did to a request
9
+ * view the context hook handed on (the lane's observation flush, KL-2988-a); that seat traces every such view (`context.media_removed`, the request's numbers) and announces
10
+ * each block ONCE PER SESSION, by the block's identity — the digest of its bytes, which a compaction, a resume or a
11
+ * rewind does not change. The digest rides the session's announced record (the advisory arm, bounded) and the write is
12
+ * parked for the leg's flush; best effort — a lost write, or a block whose digest the bound let go, is said again by a
13
+ * later run, never lost. Within a run a block is looked at once.
14
+ * Beside the provider's image refusal sits its other refused part, a tool's input schema ({@link createToolSchemaRemovedSeat},
15
+ * its own code).
16
+ */
17
+ import { type EngineNotice } from "../engine-notice.js";
18
+ import type { RejectedImageRemoval } from "../../internal/llm.js";
19
+ import type { RequestMediaLimits } from "../image-admission.js";
20
+ import type { RequestMediaTrim } from "../media-byte-cap.js";
21
+ import { type TracerHook } from "../trace.js";
22
+ import type { Prepared } from "./contracts.js";
23
+ import type { NoticeSeatInput } from "./notice-seat-input.js";
24
+ /** The session's announced record and the leg's receipt ledger (the parked write). */
25
+ export type MediaBudgetRecord = Pick<Prepared, "announcedListingsRef" | "frameReceipts">;
26
+ /** The provider-refusal account: one notice per refusal, once per run. */
27
+ export declare function createProviderRefusalSeat(ids: NoticeSeatInput): (removals: readonly RejectedImageRemoval[]) => void;
28
+ /**
29
+ * The run's account of a tool whose input schema a provider refused (`context.tool_schema_removed`, user): the loop re-sent
30
+ * the turn with that tool's parameters taken out of what the model sees (`engine/llm/rejected-images.ts`), and every later
31
+ * request built from a transcript the refusal's record stands in sends it so. ONCE PER REFUSAL (`refusalAt`): the loop
32
+ * re-sends once per refusal, and a refusal recorded before the run began is never re-sent, so never announced again.
33
+ */
34
+ export declare function createToolSchemaRemovedSeat(onNotice: ((notice: EngineNotice) => void) | undefined, ids: {
35
+ sessionId: string;
36
+ runId: string;
37
+ }): (refusal: {
38
+ tool: string;
39
+ refusalAt: number;
40
+ }) => void;
41
+ /** The request budget's account of one request view the trim cut: its trace frame, then — of the blocks it left out, those
42
+ * the session was not yet told of — one notice. */
43
+ export declare function createMediaBudgetSeat(ids: NoticeSeatInput, record: MediaBudgetRecord, trace: {
44
+ readonly tracer: TracerHook | undefined;
45
+ readonly taskId: string;
46
+ }): (trim: RequestMediaTrim, limits: RequestMediaLimits) => void;
@@ -0,0 +1,88 @@
1
+ import { deliverEngineNotice } from "../engine-notice.js";
2
+ import { inlineUntrusted } from "../untrusted-text.js";
3
+ import { emitTrace } from "../trace.js";
4
+ import { announceDigest, withAnnounceDigests } from "./announce-once-ledger.js";
5
+ const MEDIA_REMOVED = "context.media_removed";
6
+ const counted = (n, noun) => (n === 1 ? `${noun === "image" ? "an" : "a"} ${noun}` : `${n} ${noun}s`);
7
+ function announceMediaRemoved(ids, reason, images, documents) {
8
+ const what = [images > 0 ? counted(images, "image") : undefined, documents > 0 ? counted(documents, "document") : undefined].filter((s) => s !== undefined).join(" and ");
9
+ const one = images + documents === 1;
10
+ const it = one ? "it" : "them";
11
+ const message = reason === "rejected_by_provider"
12
+ ? `The model provider could not process ${what} in this conversation, so ${one ? "it was" : "they were"} removed ` +
13
+ `from what the model sees (each replaced by a line saying so) and the request was sent again without ${it}. ` +
14
+ `The session still holds the original; to show the model this content again, send it in another format.`
15
+ : `${what[0].toUpperCase()}${what.slice(1)} in this conversation no longer fit the request's media budget, so ${one ? "it was" : "they were"} removed ` +
16
+ `from what the model sees (the oldest go first; each is replaced by a line saying so). ` +
17
+ `The session still holds the original; to show the model ${it} again, read the file again or send ${it} again. Said once per image or document per conversation.`;
18
+ deliverEngineNotice(ids.onNotice, { code: MEDIA_REMOVED, message, detail: { reason, images, documents, sessionId: ids.sessionId, runId: ids.runId } });
19
+ }
20
+ export function createProviderRefusalSeat(ids) {
21
+ const announced = new Set();
22
+ return (removals) => {
23
+ for (const { refusalAt, images } of removals) {
24
+ if (announced.has(refusalAt))
25
+ continue;
26
+ announced.add(refusalAt);
27
+ announceMediaRemoved(ids, "rejected_by_provider", images, 0);
28
+ }
29
+ };
30
+ }
31
+ export function createToolSchemaRemovedSeat(onNotice, ids) {
32
+ const announced = new Set();
33
+ return ({ tool, refusalAt }) => {
34
+ if (announced.has(refusalAt))
35
+ return;
36
+ announced.add(refusalAt);
37
+ const name = inlineUntrusted(tool, 160);
38
+ deliverEngineNotice(onNotice, {
39
+ code: "context.tool_schema_removed",
40
+ message: `Tool "${name}": the model provider refused this tool's input schema, so the request was sent again with the tool's parameters ` +
41
+ `taken out of what the model sees. The model can still call the tool in this conversation, but does not see its parameters. ` +
42
+ `Fix the schema on the server that provides the tool, then start a new conversation.`,
43
+ detail: { tool, sessionId: ids.sessionId, runId: ids.runId },
44
+ });
45
+ };
46
+ }
47
+ export function createMediaBudgetSeat(ids, record, trace) {
48
+ const lookedAt = new WeakSet();
49
+ return ({ removed, removedBase64Chars, items, base64Chars }, { maxItems, budgetBase64Chars }) => {
50
+ const cutImages = removed.filter((r) => r.type === "image").length;
51
+ emitTrace(trace.tracer, () => ({
52
+ kind: MEDIA_REMOVED,
53
+ version: 1,
54
+ taskId: trace.taskId,
55
+ reason: "media_budget",
56
+ images: cutImages,
57
+ documents: removed.length - cutImages,
58
+ removedBase64Chars,
59
+ items,
60
+ base64Chars,
61
+ maxItems,
62
+ ...(budgetBase64Chars !== Infinity ? { budgetBase64Chars } : {}),
63
+ ts: Date.now(),
64
+ }));
65
+ const told = new Set(record.announcedListingsRef.advisories ?? []);
66
+ const fresh = new Set();
67
+ let images = 0;
68
+ let documents = 0;
69
+ for (const { block, type, data } of removed) {
70
+ if (lookedAt.has(block))
71
+ continue;
72
+ lookedAt.add(block);
73
+ const digest = announceDigest(MEDIA_REMOVED, `${type}\n${data}`);
74
+ if (told.has(digest) || fresh.has(digest))
75
+ continue;
76
+ fresh.add(digest);
77
+ if (type === "image")
78
+ images++;
79
+ else
80
+ documents++;
81
+ }
82
+ if (fresh.size === 0)
83
+ return;
84
+ announceMediaRemoved(ids, "media_budget", images, documents);
85
+ record.announcedListingsRef.advisories = withAnnounceDigests(record.announcedListingsRef.advisories, [...fresh]);
86
+ record.frameReceipts.listingSnapshotOwed = true;
87
+ };
88
+ }
@@ -1,5 +1,5 @@
1
1
  import { brainToRuntime } from "../runtime.js";
2
- import { expandTiers, roleModelIfSet, unheldChainRefusal } from "../roles.js";
2
+ import { catalogOfDeps, roleModelIfSet, unheldChainRefusal } from "../roles.js";
3
3
  import { isAliasModelId, openAiCompatChatSeat } from "../memory-engine/distiller.js";
4
4
  import { runMemoryConsolidationDriver } from "../memory-engine/consolidation-driver.js";
5
5
  import { recommendationUnconsumed } from "../memory-engine/consolidation.js";
@@ -26,7 +26,7 @@ export function resolveMemoryConsolidationDriver(deps) {
26
26
  model = seat.chat.model;
27
27
  }
28
28
  else {
29
- const models = expandTiers(deps.models, deps.tiers);
29
+ const models = catalogOfDeps(deps);
30
30
  const resolved = roleModelIfSet("consolidate", {}, { models, roles: deps.roles }) ?? roleModelIfSet("summarize", {}, { models, roles: deps.roles });
31
31
  if (resolved === undefined) {
32
32
  throw unheldChainRefusal(["consolidate", "summarize"], models, deps.roles) ?? seatRefusal('memory consolidation has no model seat: configure RunnerDeps.memoryConsolidationDriver.chat (an endpoint triple or a chat function), or declare roles.consolidate / roles.summarize (a tier-expanded catalog\'s "flash" binding also satisfies the summarize hop). The chain deliberately does NOT fall back to the default main model — a whole-library distillation must not silently ride the most expensive seat.');
@@ -65,7 +65,7 @@ export function resolveMemoryConsolidationDriver(deps) {
65
65
  export function consolidationSeatResolvable(deps) {
66
66
  if (deps.memoryConsolidationDriver?.chat !== undefined)
67
67
  return true;
68
- const models = expandTiers(deps.models, deps.tiers);
68
+ const models = catalogOfDeps(deps);
69
69
  return (roleModelIfSet("consolidate", {}, { models, roles: deps.roles }) ?? roleModelIfSet("summarize", {}, { models, roles: deps.roles })) !== undefined;
70
70
  }
71
71
  export function autoRunConsolidationFromRecommendation(args) {
@@ -116,6 +116,6 @@ export function assertAutoConsolidationWirable(deps) {
116
116
  throw autoRunRefusal("RunnerDeps.autoRunOnRecommendation is true but RunnerDeps.memoryConsolidation is absent — the recommendation that would trigger a run is never minted (consolidation is OFF) and the engine's verbs refuse coded, so the trigger can never fire. An armed-but-unrunnable trigger is refused, never folded to off: wire memoryConsolidation, or leave autoRunOnRecommendation unset.");
117
117
  }
118
118
  if (!consolidationSeatResolvable(deps)) {
119
- throw unheldChainRefusal(["consolidate", "summarize"], expandTiers(deps.models, deps.tiers), deps.roles) ?? autoRunRefusal("RunnerDeps.autoRunOnRecommendation is true but no consolidation model seat resolves — configure RunnerDeps.memoryConsolidationDriver.chat (an endpoint triple or a chat function), or declare roles.consolidate / roles.summarize. Arming auto-run with no model to run it is refused, never folded to off (a whole-library distillation must not silently ride the default main model).");
119
+ throw unheldChainRefusal(["consolidate", "summarize"], catalogOfDeps(deps), deps.roles) ?? autoRunRefusal("RunnerDeps.autoRunOnRecommendation is true but no consolidation model seat resolves — configure RunnerDeps.memoryConsolidationDriver.chat (an endpoint triple or a chat function), or declare roles.consolidate / roles.summarize. Arming auto-run with no model to run it is refused, never folded to off (a whole-library distillation must not silently ride the default main model).");
120
120
  }
121
121
  }
@@ -3,8 +3,8 @@
3
3
  * marker the loop stamps on the contaminated siblings, and the deadline arithmetic every mint shares (the retention
4
4
  * defaults and the one TTL sanitizer). Moved whole out of the orchestrator so the boundary-parks phase (resource /
5
5
  * platform / review) and the park-ask phase (the approval park) reach DOWN for the same publication seam and the same
6
- * numbers, and the driver keeps reaching down for the marker its harness stamps. Pure: no engine state; the only clock
7
- * is the caller's.
6
+ * numbers, and the driver keeps reaching down for the marker its harness stamps. No engine state of its own (the
7
+ * publication writes the pause holder and marks the harness's capture); the only clock is the caller's.
8
8
  */
9
9
  import { type CheckpointGate, type CheckpointToken, type PendingAction } from "../checkpoint-store.js";
10
10
  import type { WorkspaceHandle } from "../remote-env.js";
@@ -23,7 +23,7 @@
23
23
  * position (a permanent no-op) and a layer's mere presence flips `hasEffectAwareGate`, which would
24
24
  * silence the ungated-write warning for deployments that wired no policy at all.
25
25
  */
26
- import type { AskRuleEvidence, ToolCallRequest } from "../tool-policy.js";
26
+ import { type ToolPolicy, type AskRuleEvidence, type ToolCallRequest, type WholeToolRefusal } from "../tool-policy.js";
27
27
  import { persistedRuleMandateOf, type RuleClearanceFacts, type RuleOffersAbsence } from "../ask-origin.js";
28
28
  import { type OrgGateVerdict, type PersistedRuleAnswer, type PersistedRuleHit, type PersistedRuleUnreadable } from "../hooks.js";
29
29
  import type { PersistedRule, PersistedRuleVerdict, RuleOffer, ScopeRootIdentity, SegmentCoverage } from "../permission-rule-model.js";
@@ -111,7 +111,11 @@ export interface PermissionRuleLanes {
111
111
  } | undefined;
112
112
  org: {
113
113
  adjudicate: (req: ToolCallRequest) => Promise<OrgGateVerdict>;
114
+ refusesWholeOver: (resolution: OrgRuleResolution) => WholeToolRefusal;
114
115
  } | undefined;
116
+ /** The tools the stored rules refuse every call of — the person's and the org's, over ONE read (a request's view is one
117
+ * judgment), a fold of the two readings; `undefined` when neither lane is wired. */
118
+ wholeToolRefusals: ToolPolicy["wholeToolRefusals"];
115
119
  }
116
120
  /** The ORG lane: the org's verdict about one call, off the store view `read` supplies — the gate's `orgRules` face over the
117
121
  * call's pinned read ({@link createPermissionRuleLanes}), and {@link orgVerdictBeforeClaim} over a view of its own.
@@ -1,6 +1,7 @@
1
+ import { REFUSES_NO_WHOLE_TOOL, TOOL_TABLE_VIEW_READ, toolPolicyWholeToolRefusals } from "../tool-policy.js";
1
2
  import { persistedRuleMandateOf, ruleClearanceOf } from "../ask-origin.js";
2
3
  import {} from "../hooks.js";
3
- import { adjudicatePersistedDomainRules, adjudicatePersistedNameRules, adjudicatePersistedPathRules, adjudicatePersistedRules, adjudicatePersistedToolRules, callPathFaceOf, cardRuleFormOf, eligiblePersisted, escapeForDisclosure, faceRowsSpeakFor, parseRuleText, laneToolNamesOf, nameRuleSubjectOf, ruleToolGrammarOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, wholeToolRuleReaches } from "../permission-rule-model.js";
4
+ import { adjudicatePersistedDomainRules, adjudicatePersistedNameRules, adjudicatePersistedPathRules, adjudicatePersistedRules, adjudicatePersistedToolRules, callPathFaceOf, cardRuleFormOf, eligiblePersisted, escapeForDisclosure, faceRowsSpeakFor, parseRuleText, ruleWordsOf, nameRuleSubjectOf, ruleToolGrammarOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, wholeToolRuleReaches } from "../permission-rule-model.js";
4
5
  import { callHostTargetOf } from "../host-target.js";
5
6
  import { callTargetViewsOf, validatePath } from "../effective-path-target.js";
6
7
  import { bindPathRules, persistedRowAnchors, projectScopeIdentity } from "../path-rule-binding.js";
@@ -54,9 +55,10 @@ export function pathRuleLaneAnswer(table, req, ctx) {
54
55
  return persistedRuleAnswerOf(adjudicatePersistedPathRules(table, { tool: req.toolName, cwd: ctx.root, sessionId: ctx.sessionId, face: callPathFaceOf(req), ...(ctx.scopeIdentity !== undefined ? { scopeIdentity: ctx.scopeIdentity } : {}) }, { ...(tighten !== undefined ? { tighten } : {}), ...(allow !== undefined ? { allow } : {}) }, ctx.anchorsOf, ctx.leads));
55
56
  }
56
57
  export function orgRuleLane(cfg) {
58
+ const questionToolExempt = (call) => wireOf("offer.orgQuestionExemption", call) === cfg.questionToolName && cfg.questionToolMounted;
57
59
  return {
58
60
  adjudicate: async (req) => {
59
- if (wireOf("offer.orgQuestionExemption", req) === cfg.questionToolName && cfg.questionToolMounted)
61
+ if (questionToolExempt(req))
60
62
  return { status: "available" };
61
63
  let resolution;
62
64
  try {
@@ -73,13 +75,19 @@ export function orgRuleLane(cfg) {
73
75
  return { status: "unavailable", disclosures: [`the store's org resolution cannot be read (${reading.refused}) — unreadable governance, never an empty one`] };
74
76
  const command = req.args?.command;
75
77
  const face = callPathFaceOf(req);
76
- const verdict = reading.verdictFor({ tool: laneToolNamesOf(req), ...(typeof command === "string" ? { command } : {}), ...(face !== undefined ? { face } : {}) });
78
+ const verdict = reading.verdictFor({ tool: ruleWordsOf(req, "deny"), ...(typeof command === "string" ? { command } : {}), ...(face !== undefined ? { face } : {}) });
77
79
  const revisionCell = orgRevisionEvidenceOf(resolution, cfg.onRevisionDefect);
78
80
  const degraded = describeUnreadableOrgRows(reading.unreadable, revisionCell.revision);
79
81
  if (degraded !== undefined)
80
82
  cfg.onDegraded(degraded);
81
83
  return verdict === undefined ? { status: "available", ...revisionCell } : { status: "available", verdict, ...revisionCell };
82
84
  },
85
+ refusesWholeOver: (resolution) => {
86
+ const reading = resolution.status === "unavailable" || resolution.status === "ungoverned" ? undefined : readOrgRules(resolution.rules);
87
+ if (reading === undefined || "refused" in reading)
88
+ return REFUSES_NO_WHOLE_TOOL;
89
+ return (tool) => !questionToolExempt(tool) && reading.verdictFor({ tool: ruleWordsOf(tool, "deny"), face: callPathFaceOf({ ...tool, args: undefined }) })?.behavior === "deny";
90
+ },
83
91
  };
84
92
  }
85
93
  export function orgVerdictBeforeClaim(cfg, req) {
@@ -106,7 +114,7 @@ export function createPermissionRuleLanes(cfg) {
106
114
  }
107
115
  }
108
116
  if (provider === undefined)
109
- return { personal: undefined, org: undefined };
117
+ return { personal: undefined, org: undefined, wholeToolRefusals: undefined };
110
118
  const anonymous = readPrincipal(cfg.principal).kind === "absent";
111
119
  const reader = cfg.rows;
112
120
  const orgViewOf = async (toolCallId, judged) => {
@@ -119,11 +127,11 @@ export function createPermissionRuleLanes(cfg) {
119
127
  const personalAdjudicate = async (req) => {
120
128
  if (anonymous && !cfg.localOwnerDeclared)
121
129
  return undefined;
122
- const judged = laneToolNamesOf(req).map((n) => [n, ruleToolGrammarOf(n)]);
123
- if (!judged.some(([, g]) => g === "path") && faceRowsSpeakFor(callPathFaceOf(req)))
124
- judged.push([req.toolName, "path"]);
130
+ const judged = ruleWordsOf(req, "deny").map((n) => [n, ruleToolGrammarOf(n), ruleWordsOf(req, "allow").includes(n)]);
131
+ if (!judged.some(([, g, grants]) => g === "path" && grants) && faceRowsSpeakFor(callPathFaceOf(req)))
132
+ judged.push([req.toolName, "path", true]);
125
133
  const view = await reader.pin(req.toolCallId, req.args);
126
- const ownRow = (r) => judged.some(([n]) => n === r.tool) || wholeToolRuleReaches(r.tool, req);
134
+ const ownRow = (r) => judged.some(([n]) => n === r.tool) || wholeToolRuleReaches(r.tool, req, r.behavior);
127
135
  if (judged.length === 0 && !view.rules.some(ownRow))
128
136
  return view.unreadable !== undefined ? { unreadable: true } : undefined;
129
137
  try {
@@ -139,7 +147,7 @@ export function createPermissionRuleLanes(cfg) {
139
147
  const leads = judgesPath ? await cfg.leads.resolve(bindPathRules(table.filter((r) => r.match === "path" || r.match === "subpath").map((r) => ({ parsed: r, ruleText: r.rule, rule: r })), (spec) => anchorsOf(spec.rule))) : NO_LEADS;
140
148
  const scopeIdentity = await projectScopeIdentity(table, cfg.rootCanonical, cfg.leads);
141
149
  const wholeTool = persistedRuleAnswerOf(adjudicatePersistedToolRules(table, { request: req, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) }));
142
- const judgedAnswer = strongestAnswer([...judged.map(([n, grammar]) => judgeAgainst(table, { ...req, toolName: n }, grammar, leads, scopeIdentity)), wholeTool]);
150
+ const judgedAnswer = strongestAnswer([...judged.map(([n, grammar, grants]) => judgeAgainst(grants ? table : table.filter((r) => r.behavior !== "allow"), { ...req, toolName: n }, grammar, leads, scopeIdentity)), wholeTool]);
143
151
  const unjudged = noRule.find(({ row }) => (row.behavior === "deny" || row.behavior === "ask") && eligiblePersisted(row, { tool: row.tool, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) }, row.behavior));
144
152
  const answer = unjudged !== undefined && !(judgedAnswer !== undefined && "behavior" in judgedAnswer && judgedAnswer.behavior === "deny") ? unjudgedRowAnswer(unjudged.row, unjudged.why, req.toolName) : judgedAnswer;
145
153
  const stands = answer !== undefined && (("behavior" in answer && answer.behavior === "deny") || "unreadable" in answer);
@@ -176,8 +184,19 @@ export function createPermissionRuleLanes(cfg) {
176
184
  const coverage = segmentCoverageOf(command, { persisted: table }, { tool: req.toolName, cwd: cfg.root, sessionId: cfg.sessionId, ...execCwd, ...scope });
177
185
  return coverage !== undefined ? { segmentCoverage: coverage } : undefined;
178
186
  };
187
+ const personalRefusesWholeOver = async (rules) => {
188
+ const deny = anonymous && !cfg.localOwnerDeclared ? [] : rules.filter((r) => r.behavior === "deny" && r.match === "tool");
189
+ const scopeIdentity = deny.length === 0 ? undefined : await projectScopeIdentity(deny, cfg.rootCanonical, cfg.leads);
190
+ return deny.length === 0 ? REFUSES_NO_WHOLE_TOOL : (tool) => !routesContent(tool.face) && adjudicatePersistedToolRules(deny, { request: tool, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) })?.behavior === "deny";
191
+ };
179
192
  const personal = provider.partitions.durable ? { adjudicate: personalAdjudicate } : undefined;
180
- return { personal, org };
193
+ let inFlight;
194
+ const viewRead = () => (inFlight ??= reader.pin(TOOL_TABLE_VIEW_READ).finally(() => (inFlight = undefined)));
195
+ const wholeToolRefusals = toolPolicyWholeToolRefusals([
196
+ personal !== undefined ? { wholeToolRefusals: async () => personalRefusesWholeOver((await viewRead()).rules) } : undefined,
197
+ org !== undefined ? { wholeToolRefusals: async () => ((read) => (read.org !== undefined ? org.refusesWholeOver(read.org) : REFUSES_NO_WHOLE_TOOL))(await viewRead()) } : undefined,
198
+ ]);
199
+ return { personal, org, wholeToolRefusals };
181
200
  }
182
201
  export function createRuleOffersOf(cfg) {
183
202
  return (call, args, ask) => {
@@ -271,7 +271,7 @@ export function createPersonPathRows(cfg) {
271
271
  unexcludableUnder: (scope) => judging().readDeny.unexcludableUnder?.(scope) ?? false,
272
272
  rowUnderRoot: (scope) => judging().readDeny.rowUnderRoot?.(scope) ?? null,
273
273
  rowAtOrBelow: (path) => judging().readDeny.rowAtOrBelow?.(path) ?? null,
274
- forCall: (id) => tablesFor(id).readDeny,
274
+ forCall: (id) => (id === undefined ? judging() : tablesFor(id)).readDeny,
275
275
  });
276
276
  const writeDeny = {
277
277
  face: "write",
@@ -0,0 +1,26 @@
1
+ /**
2
+ * The placement fence's two engine readings (the seat and its contract: `ExecutionEnvFactoryContext.placementTarget`,
3
+ * remote-env.ts): the MINT folds a leg's fence once, and the SETTLE POINT reads the leg's own target once — which is
4
+ * also every fenced leg's receipt (a restore takes the same receipt earlier as well, against the env before and the
5
+ * handle after `resumeVM`, in prepare-workspace-restore.ts).
6
+ */
7
+ import { type PlacementTarget, type WorkspaceHandle } from "../remote-env.js";
8
+ import type { ExecutionEnv } from "../../internal/harness.js";
9
+ /**
10
+ * The fence a leg is minted under, from its two sources: the target its checkpoint row recorded (a durable resume leg)
11
+ * and the one its trusted internals carry (the leg that handed it work). Member by member — a member the row states
12
+ * wins, a member it does not state is the internals' (a row recorded before `deviceId` existed takes the waking leg's
13
+ * device) — so neither source replaces the other whole. `undefined` when neither names a provider. A handed value the
14
+ * engine cannot read as a target (no non-empty string `provider`, a `deviceId` that is not a string) is refused loudly
15
+ * rather than read as "no fence", which would place the leg wherever the current binding points.
16
+ */
17
+ export declare function mintPlacementFence(row: WorkspaceHandle | undefined, handedValue: unknown): PlacementTarget | undefined;
18
+ /**
19
+ * The leg's OWN target, read once at its settle point (what its env reports, {@link reportedPlacementTarget}) — the fence
20
+ * of every leg it hands work to — and every fenced leg's receipt on that same reading: an env that does not name the
21
+ * device its fence names is refused before anything reports the workspace or runs on it. A leg that restored a
22
+ * checkpointed workspace (its restore took the receipt already, against the restored handle) is refused
23
+ * `resume.env_failed` here too — its env may have moved after the restore (re-initialization reconnecting elsewhere) —
24
+ * any other leg `config.placement_not_honored`.
25
+ */
26
+ export declare function settleOwnTarget(env: ExecutionEnv | undefined, fence: PlacementTarget | undefined, restoredCheckpoint: boolean): PlacementTarget | undefined;