@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
@@ -2,7 +2,8 @@ import { uuidv7 } from "../../internal/harness.js";
2
2
  import { snapshotActorAssertion } from "../../internal/llm.js";
3
3
  import { MAX_STEER_INPUT_ID_CHARS } from "../checkpoint-store.js";
4
4
  import { formatHookFeedback } from "../hooks.js";
5
- import { classicEventBase, failedHandlerClause, screenUserPrompt } from "../mods/stations.js";
5
+ import { classicEventBase, failedHandlerClause, legNoticeTaskId, screenUserPrompt } from "../mods/stations.js";
6
+ import { countsAsOperator } from "../input-author.js";
6
7
  import { buildHumanInputEvent, frameMidTurnUserInput, projectHumanInput } from "../human-input-projection.js";
7
8
  import { injectionLaneOf, isSystemInjectionPriority, steerPriorityOf, SYSTEM_INJECTION_PRIORITIES } from "../task-notification.js";
8
9
  import { deliverEngineNotice } from "../types.js";
@@ -12,7 +13,7 @@ import { steerReplayRefusal } from "../steer-replay.js";
12
13
  export function streamSteerVerb(input) {
13
14
  const { spec, internals, queue, acceptedSteerInputs, live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, steeringError, runner } = input;
14
15
  let steerChain = Promise.resolve();
15
- const steer = async (text, options) => {
16
+ const steerAs = async (author, text, options) => {
16
17
  if (options?.userAttachments !== undefined) {
17
18
  throw steeringError("a steer carries no attachments — declare them in TaskSpec.userAttachments on the next objective", "steering.invalid_content");
18
19
  }
@@ -48,7 +49,7 @@ export function streamSteerVerb(input) {
48
49
  let payload;
49
50
  let mintsAFrame;
50
51
  const publishQueued = (h) => {
51
- const identity = internals?.parentToolCallId !== undefined ? { parentToolCallId: internals.parentToolCallId, ...(spec.taskId !== undefined ? { sourceTaskId: spec.taskId } : {}) } : {};
52
+ const identity = internals?.parentToolCallId !== undefined ? { parentToolCallId: internals.parentToolCallId, sourceTaskId: h.hookIdentity.taskId } : {};
52
53
  queue.push({
53
54
  ...buildHumanInputEvent({
54
55
  carrier: "steer",
@@ -93,7 +94,7 @@ export function streamSteerVerb(input) {
93
94
  }
94
95
  if (live.resultValue !== undefined || h.loop.ended)
95
96
  throw steeringError("the task is no longer running");
96
- if (mintsAFrame) {
97
+ if (mintsAFrame && countsAsOperator(author)) {
97
98
  const screen = await screenUserPrompt(h.modBus, {
98
99
  ...classicEventBase(h.hookIdentity, h.permissionMode.observed),
99
100
  prompt: text,
@@ -115,7 +116,7 @@ export function streamSteerVerb(input) {
115
116
  }
116
117
  }
117
118
  const injectFramed = async () => {
118
- const noteOptions = { provenance: "engine-note", callerAuthored: true, parkRecord, ...(actor !== undefined ? { actor } : {}) };
119
+ const noteOptions = { provenance: "engine-note", author, parkRecord, ...(actor !== undefined ? { actor } : {}) };
119
120
  if (mintsAFrame)
120
121
  armAcceptance(parkRecord, () => publishQueued(h));
121
122
  if (injectionLaneOf(priority) === "followUp") {
@@ -136,7 +137,7 @@ export function streamSteerVerb(input) {
136
137
  sessionId: h.sessionId,
137
138
  runId: h.runId,
138
139
  ...(actor?.id !== undefined ? { actorId: actor.id } : {}),
139
- ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}),
140
+ ...legNoticeTaskId(h.hookIdentity),
140
141
  },
141
142
  });
142
143
  }
@@ -167,5 +168,5 @@ export function streamSteerVerb(input) {
167
168
  steerChain = p.then(() => undefined, () => undefined);
168
169
  return p;
169
170
  };
170
- return { steer };
171
+ return { steer: (text, options) => steerAs("operator", text, options), authoredSteer: (author, text) => steerAs(author, text, undefined) };
171
172
  }
@@ -297,28 +297,31 @@ export function judgeRunToolLists(input) {
297
297
  }
298
298
  const pool = delegationPoolReading(spec.tools ?? [], valveLeaves(spec, selector));
299
299
  const mounted = mountedToolNames([...tools, ...(spec.tools ?? [])]);
300
+ const withOwnServers = (servers) => servers === undefined || servers.length === 0 ? input.declaredPeers : { ...input.declaredPeers, mcp: [...(input.declaredPeers.mcp ?? []), ...servers] };
301
+ const definitionServers = [...(spec.agents ?? []).flatMap((d) => d.mcp ?? []), ...pool.tools.flatMap((t) => (t.agentToolFaces ?? []).flatMap((f) => f.servers ?? []))];
300
302
  if (!input.judgedUpstream) {
301
- const root = rootFacingUniverse(input.ownBy !== undefined ? new Set([...mounted, input.ownBy.toolName]) : mounted, pool, input.declaredPeers);
303
+ const root = rootFacingUniverse(input.ownBy !== undefined ? new Set([...mounted, input.ownBy.toolName]) : mounted, pool, withOwnServers(definitionServers));
302
304
  const own = [["allowed", input.own.allow], ["denied", input.own.exclude]];
303
305
  const tell = input.toldUpstream === true ? () => undefined : advise;
304
306
  for (const [side, value] of own)
305
307
  judgeToolNameList(ownWhere ?? (side === "allowed" ? "TaskSpec.allowTools" : "TaskSpec.excludeTools"), side, value, root, tell, "config.tool_face_control");
306
308
  }
307
- const children = new Map(pool.tools.map((t) => [t, childFacingUniverse(poolOf([t]), input.declaredPeers)]));
308
- const taskTargets = pool.tools.length > 0 ? [...children.values()] : [childFacingUniverse(poolOf([]), input.declaredPeers)];
309
+ const childUniverses = (servers) => pool.tools.length > 0 ? pool.tools.map((t) => childFacingUniverse(poolOf([t]), withOwnServers(servers))) : [childFacingUniverse(poolOf([]), withOwnServers(servers))];
309
310
  for (const def of spec.agents ?? []) {
310
- for (const universe of taskTargets) {
311
+ for (const universe of childUniverses(def.mcp)) {
311
312
  judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "allowed", def.allowTools, universe, advise, "config.agent.unknown_tool");
312
313
  judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "denied", def.denyTools, universe, advise, "config.agent.unknown_tool");
313
314
  }
314
315
  }
315
316
  const replaced = new Set((spec.agents ?? []).map((d) => d.name));
316
- for (const [t, universe] of children) {
317
+ for (const t of pool.tools) {
318
+ const universe = childFacingUniverse(poolOf([t]), input.declaredPeers);
317
319
  for (const face of t.agentToolFaces ?? []) {
318
320
  if (face.authored === true && !replaced.has(face.name)) {
319
321
  const faceWhere = delegationListWhere(t.name, face.name);
320
- judgeToolNameList(faceWhere, "allowed", face.allowTools, universe, advise, "config.agent.unknown_tool");
321
- judgeToolNameList(faceWhere, "denied", face.denyTools, universe, advise, "config.agent.unknown_tool");
322
+ const faceUniverse = childFacingUniverse(poolOf([t]), withOwnServers(face.servers));
323
+ judgeToolNameList(faceWhere, "allowed", face.allowTools, faceUniverse, advise, "config.agent.unknown_tool");
324
+ judgeToolNameList(faceWhere, "denied", face.denyTools, faceUniverse, advise, "config.agent.unknown_tool");
322
325
  }
323
326
  }
324
327
  judgeToolNameList(delegationListWhere(t.name, undefined), "allowed", t.agentToolLevelAllowTools, universe, advise, "config.agent.unknown_tool");
@@ -2,7 +2,7 @@ import { Type } from "typebox";
2
2
  import { defineTool } from "../tools.js";
3
3
  import { sanitizeUntrustedText, SHELLED_BODY_ENVELOPE_TAGS } from "../untrusted-text.js";
4
4
  import { SKILL_LISTING_DEFAULT_BUDGET, SKILL_LISTING_DESC_MAX_CHARS_DEFAULT } from "../skill-listing-budget.js";
5
- import { readSkillTable, skillNamedBy } from "../skill-grant.js";
5
+ import { readSkillTable, skillNamedBy, skillNameHint } from "../skill-grant.js";
6
6
  import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../tool-catalog-entries.js";
7
7
  import { skillLoadReading, substituteSkillRoot, substituteSkillRootBounded } from "./skill-base-dir.js";
8
8
  import { readSkillsSeat } from "./skills-seat.js";
@@ -180,7 +180,7 @@ export function createSkillTool(skills, grants) {
180
180
  const name = String(a.skill ?? "");
181
181
  const skill = skillNamedBy(a, skills);
182
182
  if (!skill) {
183
- throw new Error(`Unknown skill "${name}". Available skills: ${names}. ` +
183
+ throw new Error(`Unknown skill "${name}".${skillNameHint(a, skills)} Available skills: ${names}. ` +
184
184
  `(Only skills registered with this deployment are loadable — other products' skills directories are not read. ` +
185
185
  `If the user wants one of those here, read its source file and recreate its content for this deployment instead.)`);
186
186
  }
@@ -6,16 +6,26 @@
6
6
  * `assemble-result.ts`'s (`terminalCauseOf`); this module only reads.
7
7
  */
8
8
  import { type AssistantMessage, type ModelOutputInvalid } from "../../internal/llm.js";
9
+ import type { LoopTerminalReason } from "../../internal/harness-types.js";
9
10
  import { type RequestRoute } from "../../brain/request-route.js";
10
11
  import type { TerminalCause } from "../types.js";
11
- import type { TerminalFailureDetail } from "../terminal-cause.js";
12
+ import { type TerminalFailureDetail } from "../terminal-cause.js";
12
13
  type ProviderRejected = Extract<TerminalFailureDetail, {
13
14
  kind: "provider_rejected";
14
15
  }>;
16
+ /** The failure a loop exit word names ({@link LOOP_EXIT_FAILURE}), by own-row membership; `undefined` for every other word and for no word. */
17
+ export declare function loopExitFailureOf(reason: LoopTerminalReason | undefined): {
18
+ readonly code: string;
19
+ readonly message: string;
20
+ } | undefined;
15
21
  /** The terminal message's provider-condition verdict, as the refusal account carries it: each member read once and
16
22
  * admitted only as a word of its closed set (a host Brain mints this message too); the reset instant only beside a
17
23
  * condition. Absent members stay absent. */
18
24
  export declare function providerVerdictOf(final: AssistantMessage): Pick<ProviderRejected, "providerCondition" | "providerConditionSource" | "providerResetAtMs">;
25
+ /** The part of the request the terminal message's refusal named, from the message's `errorKind` and `refusedTool` as the
26
+ * terminal read them (each once): the kind admitted only as a word of `REFUSED_REQUEST_PARTS`, a tool-schema refusal only
27
+ * with its tool (a non-empty string), else no account. */
28
+ export declare function refusedPartOf(errorKind: unknown, refusedTool: unknown): Pick<ProviderRejected, "errorKind" | "tool">;
19
29
  /** The terminal message's request route (`apiErrorRoute`), admitted as a shape some request carries
20
30
  * (`ROUTE_CREDENTIAL_PAIRING`); anything else is no route. */
21
31
  export declare function requestRouteOfMessage(final: AssistantMessage): RequestRoute | undefined;
@@ -2,11 +2,23 @@ import { MODEL_OUTPUT_INVALID_CAUSES } from "../../internal/llm.js";
2
2
  import { isProviderEchoShape } from "../../brain/errors.js";
3
3
  import { isProviderCondition, isProviderConditionSource } from "../../brain/provider-dialect.js";
4
4
  import { admittedRequestRoute } from "../../brain/request-route.js";
5
+ import { REFUSED_REQUEST_PARTS } from "../terminal-cause.js";
5
6
  import { readMember } from "../thrown-value.js";
6
7
  import { egressText } from "../untrusted-egress.js";
7
8
  import { REDACTION_MARK } from "../redaction-marks.js";
8
9
  import { isSensitiveName, looksLikeCredentialValue } from "../secret-env.js";
9
10
  import { isSensitiveRecordKey } from "../credential-vocabulary.js";
11
+ const LOOP_EXIT_FAILURE = {
12
+ completed: undefined,
13
+ aborted_before_stream: undefined,
14
+ assistant_error: undefined,
15
+ stop_requested: undefined,
16
+ malformed_tool_use_exhausted: { code: "model.malformed_tool_use_exhausted", message: "The model's tool call could not be parsed (retry also failed)." },
17
+ truncated_output_exhausted: { code: "model.truncated_output_exhausted", message: "The model's response exceeded the output token maximum (continuing also failed)." },
18
+ };
19
+ export function loopExitFailureOf(reason) {
20
+ return reason !== undefined && Object.hasOwn(LOOP_EXIT_FAILURE, reason) ? LOOP_EXIT_FAILURE[reason] : undefined;
21
+ }
10
22
  export function providerVerdictOf(final) {
11
23
  const condition = readMember(final, "providerCondition");
12
24
  const source = readMember(final, "providerConditionSource");
@@ -15,6 +27,14 @@ export function providerVerdictOf(final) {
15
27
  const resetAtMs = readMember(final, "providerResetAtMs");
16
28
  return { providerCondition: condition, providerConditionSource: source, ...(typeof resetAtMs === "number" && Number.isFinite(resetAtMs) ? { providerResetAtMs: resetAtMs } : {}) };
17
29
  }
30
+ const REFUSED_REQUEST_PART_SET = new Set(REFUSED_REQUEST_PARTS);
31
+ export function refusedPartOf(errorKind, refusedTool) {
32
+ if (!REFUSED_REQUEST_PART_SET.has(errorKind))
33
+ return {};
34
+ if (errorKind !== "tool_schema_refused")
35
+ return { errorKind: errorKind };
36
+ return typeof refusedTool === "string" && refusedTool.length > 0 ? { errorKind, tool: refusedTool } : {};
37
+ }
18
38
  export function requestRouteOfMessage(final) {
19
39
  return admittedRequestRoute(readMember(final, "apiErrorRoute"));
20
40
  }
@@ -1,5 +1,9 @@
1
1
  import type { CheckpointGate, CheckpointToken } from "../checkpoint-store.js";
2
2
  import type { TaskResult, TaskStatus, TerminalCause } from "../types.js";
3
+ /** The words of a failed terminal's `unstartedRow` — read off the cause itself, so the two never drift. */
4
+ type UnstartedRowOutcome = NonNullable<Extract<TerminalCause, {
5
+ kind: "failed";
6
+ }>["unstartedRow"]>;
3
7
  /** The plane words a {@link TerminalCause} reads as — one derivation, called by the faces that speak
4
8
  * them. The paused arm's `status` is its gate kind's registry row (`suspended` for an approval,
5
9
  * a resource slice or a platform pause; `needs_review` for a plan or dry-run review, which also
@@ -17,6 +21,8 @@ export declare function terminalProjection(terminal: TerminalCause): {
17
21
  /**
18
22
  * A compensation that changes WHY a settled result ended (a resume leg's approval reopened / could not
19
23
  * be reopened) amends the CAUSE — the one record there is. The code fills only an empty seat (the leg's
20
- * own terminal code, when it had one, still names the ending); the message is extended, not replaced.
24
+ * own terminal code, when it had one, still names the ending); the message is extended, not replaced;
25
+ * the row's outcome is stated on its own member (`unstartedRow`), whatever the code says.
21
26
  */
22
- export declare function amendTerminal(result: TaskResult, code: string, message: (prior: string | undefined) => string): void;
27
+ export declare function amendTerminal(result: TaskResult, code: string, unstartedRow: UnstartedRowOutcome, message: (prior: string | undefined) => string): void;
28
+ export {};
@@ -20,9 +20,9 @@ export function terminalProjection(terminal) {
20
20
  }
21
21
  }
22
22
  }
23
- export function amendTerminal(result, code, message) {
23
+ export function amendTerminal(result, code, unstartedRow, message) {
24
24
  const t = result.terminal;
25
25
  if (t.kind !== "failed")
26
26
  return;
27
- result.terminal = { ...t, code: t.code ?? code, message: message(t.message) };
27
+ result.terminal = { ...t, code: t.code ?? code, message: message(t.message), unstartedRow };
28
28
  }
@@ -258,4 +258,7 @@ export declare function createToolSearchTool(opts: {
258
258
  * and every "full schemas are loaded" claim about the tools block is dropped as false. Absent ⇒
259
259
  * the swap posture (activation rewrites the tools block; prior wording, unchanged). */
260
260
  staticSchemaFor?: (name: string) => TSchema | undefined;
261
+ /** Whether the model is shown this tool. A tool its view leaves out is outside this search, and it is never answered
262
+ * "already available" either: what the model is not shown it cannot find here. Absent ⇒ every tool is shown. */
263
+ inView?: (name: string) => boolean;
261
264
  }): AgentTool;
@@ -234,7 +234,9 @@ export function extractDiscoveredToolNames(messages, registry) {
234
234
  return [...names];
235
235
  }
236
236
  export function createToolSearchTool(opts) {
237
- const { registry, active, rematerialize, listingRide, mountedNames, staticSchemaFor, isMounted } = opts;
237
+ const { active, rematerialize, listingRide, staticSchemaFor, isMounted, inView } = opts;
238
+ const shownRegistry = () => inView === undefined ? opts.registry : new Map([...opts.registry].filter(([n]) => inView(n)));
239
+ const shownMounted = () => inView === undefined ? opts.mountedNames?.() : new Set([...(opts.mountedNames?.() ?? [])].filter((n) => inView(n)));
238
240
  const directCallEnabled = opts.directCallEnabled !== false;
239
241
  const activationPosture = directCallEnabled
240
242
  ? (staticSchemaFor !== undefined
@@ -285,11 +287,12 @@ export function createToolSearchTool(opts) {
285
287
  `selection in \`query\` instead: {"query":"select:ToolA,ToolB"}. Nothing was activated.`);
286
288
  }
287
289
  const args = (raw ?? {});
290
+ const registry = shownRegistry();
288
291
  const resolved = resolveToolSearchDetailed(args, registry);
289
292
  const missing = resolved.missing;
290
293
  const withdrawn = isMounted === undefined ? [] : resolved.matched.filter((n) => !isMounted(n));
291
294
  const matched = isMounted === undefined ? resolved.matched : resolved.matched.filter((n) => isMounted(n));
292
- const mounted = mountedNames?.() ?? new Set();
295
+ const mounted = shownMounted() ?? new Set();
293
296
  const missCallable = missing.filter((n) => mounted.has(n));
294
297
  const missUnknown = missing.filter((n) => !mounted.has(n));
295
298
  const callableNote = missCallable.length > 0
@@ -312,7 +315,6 @@ export function createToolSearchTool(opts) {
312
315
  missingNote,
313
316
  details: {
314
317
  type: "tool-search",
315
- matched: [],
316
318
  activated: [],
317
319
  matches: [],
318
320
  query: typeof args.query === "string" ? args.query : "",
@@ -366,7 +368,6 @@ export function createToolSearchTool(opts) {
366
368
  content: `${head}\n${lines.join("\n")}${missingNote}${ride !== undefined ? `\n\n${ride}` : ""}`,
367
369
  details: {
368
370
  type: "tool-search",
369
- matched: matched.map(safeName),
370
371
  activated: newly.map(safeName),
371
372
  matches: matched.map(safeName),
372
373
  query: typeof args.query === "string" ? args.query : "",
@@ -33,7 +33,7 @@ export declare function batchResponseDigest(result: unknown): string | undefined
33
33
  * Also the one place the gate outcome reaches a frame — see the parameter. */
34
34
  export declare function toolEndBodyFrom(result: unknown, isError: boolean,
35
35
  /** The leg's card projector (never a module default: the engine set alone drops every declared caller card unannounced) and media budget. */
36
- leg: Pick<OccurrenceFrames, "structured" | "mediaByteCapBytes">,
36
+ leg: Pick<OccurrenceFrames, "structured" | "mediaBudgetBase64Chars">,
37
37
  /** The gate's record of the pass that admitted or refused this call, supplied by the CALLER of this
38
38
  * projection — the end projection ({@link emitSettled}) reads it off the call's occurrence (its latest gate
39
39
  * record). Deliberately a parameter and never derived from `result`: a tool's own `details`
@@ -66,8 +66,8 @@ export type OccurrenceFrame = Omit<Extract<TaskEvent, {
66
66
  export interface OccurrenceFrames {
67
67
  push(frame: OccurrenceFrame): void;
68
68
  structured: StructuredProjector;
69
- /** `RunnerDeps.mediaByteCapBytes` as given — the request strip's budget, read through the same `mediaBudgetBytes`; required, so no site reads a second one. */
70
- mediaByteCapBytes: number | undefined;
69
+ /** `RunnerDeps.mediaBudgetBase64Chars` as given — the request trim's budget, read through the same `requestMediaBudget`; required, so no site reads a second one. */
70
+ mediaBudgetBase64Chars: number | undefined;
71
71
  }
72
72
  /** The START projection: the call's occurrence opens and its start frame goes out. Every leg that announces a call
73
73
  * comes through here (the live loop's `tool_execution_start`, the resumed leg's approved call). */
@@ -36,7 +36,7 @@ export function batchResponseDigest(result) {
36
36
  : text;
37
37
  }
38
38
  export function toolEndBodyFrom(result, isError, leg, gate, gatedCallIdOfRun) {
39
- const o = toolOutputFrom(result, leg.mediaByteCapBytes);
39
+ const o = toolOutputFrom(result, leg.mediaBudgetBase64Chars);
40
40
  const st = leg.structured(result);
41
41
  const det = isError ? result?.details : undefined;
42
42
  const card = isPlainRecord(det) ? det : undefined;
@@ -16,7 +16,7 @@
16
16
  * materialization entrance; the specs this file consumes carry that reader's copy, never the caller's object.
17
17
  */
18
18
  import type { AgentTool } from "../../internal/harness-types.js";
19
- import type { McpServerSpec } from "../mcp-server-spec.js";
19
+ import { type McpServerSpec } from "../mcp-server-spec.js";
20
20
  import { type ToolApprovalCard } from "../tool-face.js";
21
21
  import { type EngineNotice } from "../engine-notice.js";
22
22
  /** The keys each specialised approval card needs on the call (the SHELL owns the
@@ -1,3 +1,4 @@
1
+ import { callerText } from "../mcp-server-spec.js";
1
2
  import { MCP_NAMESPACE } from "../protocol-table.js";
2
3
  import { mintNamespacePrefix } from "../protocol-naming.js";
3
4
  import { RESERVED_APPROVAL_CARDS, TOOL_APPROVAL_CARDS, TOOL_FAMILIES, TOOL_PATH_ABSENCES, TOOL_PATH_ACCESSES, TOOL_PATH_BASES, RENDER_HINT_ACTIVITY_MAX_CHARS, RENDER_HINT_MAX_CHARS, RENDER_HINT_MAX_LIST, TOOL_KEY_MAX_CHARS, } from "../tool-face.js";
@@ -22,34 +23,39 @@ export function toolFaceProblem(face, schema, tool) {
22
23
  export function faceProblem(face, schema, tool) {
23
24
  const bound = schema === undefined ? undefined : inputKeysOf(schema);
24
25
  const top = bound === undefined ? undefined : new Set(bound.keys.map((k) => k.name));
25
- if (face.family !== undefined && !TOOL_FAMILIES.includes(face.family))
26
- return `family ${JSON.stringify(face.family)} is outside the closed set`;
26
+ const outside = (label, value, words) => value === undefined || words.includes(value) ? undefined : `${label} ${callerText(value)} is outside the closed set (${words.join(" | ")})`;
27
+ const family = outside("family", face.family, TOOL_FAMILIES);
28
+ if (family !== undefined)
29
+ return family;
27
30
  const overlong = (label, values) => {
28
31
  const k = values.find((v) => v.length > TOOL_KEY_MAX_CHARS);
29
- return k === undefined ? undefined : `${label} ${JSON.stringify(k.slice(0, 40) + "…")} is ${k.length} characters; a roster key is at most ${TOOL_KEY_MAX_CHARS}`;
32
+ return k === undefined ? undefined : `${label} has a key of ${k.length} characters; a roster key is at most ${TOOL_KEY_MAX_CHARS}`;
30
33
  };
31
34
  const vocabulary = new Set(bound?.scalar);
32
35
  if (face.pathTarget !== undefined) {
33
36
  if (top !== undefined && (typeof face.pathTarget.param !== "string" || !top.has(face.pathTarget.param)))
34
- return `pathTarget.param ${JSON.stringify(face.pathTarget.param)} is not a top-level property of the tool's schema`;
35
- if (!TOOL_PATH_ACCESSES.includes(face.pathTarget.access))
36
- return `pathTarget.access ${JSON.stringify(face.pathTarget.access)} is outside the closed set`;
37
+ return `pathTarget.param ${callerText(face.pathTarget.param)} is not a top-level property of the tool's schema`;
38
+ const access = outside("pathTarget.access", face.pathTarget.access, TOOL_PATH_ACCESSES);
39
+ if (access !== undefined)
40
+ return access;
37
41
  const base = face.pathTarget.base;
38
- if (base !== undefined && !TOOL_PATH_BASES.includes(base))
39
- return `pathTarget.base ${JSON.stringify(base)} is outside the closed set`;
42
+ const baseWord = outside("pathTarget.base", base, TOOL_PATH_BASES);
43
+ if (baseWord !== undefined)
44
+ return baseWord;
40
45
  if (base === "root" && face.pathTarget.access !== "read")
41
46
  return `pathTarget.base "root" needs pathTarget.access "read" — two write guards (the session-transcript directory guard and the frozen-spec deny) resolve a write target against the call's working directory only, so a write face declaring a root base would be judged on two different files (#638)`;
42
47
  const absent = face.pathTarget.absent;
43
- if (absent !== undefined && !TOOL_PATH_ABSENCES.includes(absent))
44
- return `pathTarget.absent ${JSON.stringify(absent)} is outside the closed set`;
48
+ const absentWord = outside("pathTarget.absent", absent, TOOL_PATH_ABSENCES);
49
+ if (absentWord !== undefined)
50
+ return absentWord;
45
51
  if (absent === "base" && face.pathTarget.access !== "read")
46
52
  return `pathTarget.absent "base" needs pathTarget.access "read" — it says the call is about the whole base directory when the slot is empty, which is a search SCOPE; a write with no path names no file, and the containment fences judge a write on its own target`;
47
53
  const patternParam = face.pathTarget.patternParam;
48
54
  if (patternParam !== undefined) {
49
55
  if (top !== undefined && (typeof patternParam !== "string" || !top.has(patternParam)))
50
- return `pathTarget.patternParam ${JSON.stringify(patternParam)} is not a top-level property of the tool's schema`;
56
+ return `pathTarget.patternParam ${callerText(patternParam)} is not a top-level property of the tool's schema`;
51
57
  if (absent !== "base")
52
- return `pathTarget.patternParam ${JSON.stringify(patternParam)} is declared but pathTarget.absent is ${JSON.stringify(absent ?? "none")} — the pattern base is only ever read for an absent slot, so this declaration would be inert`;
58
+ return `pathTarget.patternParam is declared but pathTarget.absent is ${JSON.stringify(absent ?? "none")} — the pattern base is only ever read for an absent slot, so this declaration would be inert`;
53
59
  }
54
60
  const long = overlong("pathTarget.param", [face.pathTarget.param]) ??
55
61
  overlong("pathTarget.aliases", face.pathTarget.aliases ?? []) ??
@@ -68,7 +74,7 @@ export function faceProblem(face, schema, tool) {
68
74
  if (face.pathTarget !== undefined)
69
75
  return `hostTarget and pathTarget are both declared — a face names one protected target, the URL a call reaches or the path it touches`;
70
76
  if (top !== undefined && (typeof face.hostTarget.param !== "string" || !top.has(face.hostTarget.param)))
71
- return `hostTarget.param ${JSON.stringify(face.hostTarget.param)} is not a top-level property of the tool's schema`;
77
+ return `hostTarget.param ${callerText(face.hostTarget.param)} is not a top-level property of the tool's schema`;
72
78
  const long = overlong("hostTarget.param", [face.hostTarget.param]);
73
79
  if (long !== undefined)
74
80
  return long;
@@ -77,8 +83,9 @@ export function faceProblem(face, schema, tool) {
77
83
  if (hints !== undefined) {
78
84
  const card = hints.approvalCard;
79
85
  if (card !== undefined) {
80
- if (!TOOL_APPROVAL_CARDS.includes(card))
81
- return `renderHints.approvalCard ${JSON.stringify(card)} is outside the closed set`;
86
+ const cardWord = outside("renderHints.approvalCard", card, TOOL_APPROVAL_CARDS);
87
+ if (cardWord !== undefined)
88
+ return cardWord;
82
89
  if (RESERVED_APPROVAL_CARDS.includes(card) && (tool === undefined || engineCardOf(tool) !== card))
83
90
  return `renderHints.approvalCard ${JSON.stringify(card)} is reserved for the engine's own tool that owns it; a declared tool takes another card or none`;
84
91
  const missing = top === undefined ? [] : APPROVAL_CARD_REQUIRED_KEYS[card].filter((k) => !top.has(k));
@@ -98,18 +105,18 @@ export function faceProblem(face, schema, tool) {
98
105
  return long;
99
106
  const foreignCard = tool?.cardId === undefined ? undefined : offendingResultCard(hints, tool.cardId, engineCardTypes());
100
107
  if (foreignCard !== undefined)
101
- return `renderHints.resultCards names ${JSON.stringify(foreignCard.slice(0, 80))}, outside the tool's own card namespace "${tool.cardId}/<card>" (engine cards and other contracts' namespaces are reserved)`;
108
+ return `renderHints.resultCards names ${callerText(foreignCard)}, outside the tool's own card namespace "${tool.cardId}/<card>" (engine cards and other contracts' namespaces are reserved)`;
102
109
  const stray = top === undefined ? undefined : (hints.summaryParams ?? []).find((p) => !top.has(p));
103
110
  if (stray !== undefined)
104
- return `renderHints.summaryParams names ${JSON.stringify(stray)}, which is not a top-level property`;
111
+ return `renderHints.summaryParams names ${callerText(stray)}, which is not a top-level property`;
105
112
  }
106
113
  if (top !== undefined) {
107
114
  for (const p of face.ruleFace?.params ?? [])
108
115
  if (!vocabulary.has(p))
109
- return `ruleFace.params names ${JSON.stringify(p)}, which is neither a scalar top-level property nor the declared path target`;
116
+ return `ruleFace.params names ${callerText(p)}, which is neither a scalar top-level property nor the declared path target`;
110
117
  for (const p of face.ruleFace?.primaryParams ?? [])
111
118
  if (!vocabulary.has(p))
112
- return `ruleFace.primaryParams names ${JSON.stringify(p)}, which is neither a top-level property nor the declared path target`;
119
+ return `ruleFace.primaryParams names ${callerText(p)}, which is neither a top-level property nor the declared path target`;
113
120
  }
114
121
  const long = overlong("ruleFace.params", face.ruleFace?.params ?? []) ?? overlong("ruleFace.primaryParams", face.ruleFace?.primaryParams ?? []);
115
122
  if (long !== undefined)
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * The `tool_end` output/structured projection, verbatim from
3
3
  * `runtask.ts`'s runLocked R4 phase. Pure functions over the harness `AgentToolResult`: zero closure
4
- * state, zero runtask coupling — the module-level inputs are the text cap below and the shared media budget default
5
- * (`mediaBudgetBytes`); the leg hands in its own `mediaByteCapBytes`.
4
+ * state, zero runtask coupling — the module-level inputs are the text cap below and the shared media budget reading
5
+ * (`requestMediaBudget`); the leg hands in its own `mediaBudgetBase64Chars`.
6
6
  */
7
7
  /** A block's own size in characters — the ONE counter `tool_end.totalChars` adds up over a tool result's blocks (a
8
8
  * consumer that re-renders a result sums the same function): a text block its text plus whatever else it carries at
@@ -14,7 +14,7 @@ type ToolOutput = {
14
14
  truncated: boolean;
15
15
  totalChars?: number;
16
16
  };
17
- export declare const toolOutputFrom: (result: unknown, mediaByteCapBytes: number | undefined) => ToolOutput | undefined;
17
+ export declare const toolOutputFrom: (result: unknown, mediaBudgetBase64Chars: number | undefined) => ToolOutput | undefined;
18
18
  /** The `tool_end.structured` projection over a harness tool result: the CC card when `details.type` names a card
19
19
  * the leg admits, else undefined. Minted per leg by {@link createStructuredProjector}; every body projection takes it
20
20
  * as a parameter — there is no module-level card set to fall back to. */
@@ -1,5 +1,6 @@
1
1
  import { isTextBlock, renderContentBlock } from "../../internal/llm.js";
2
- import { isMediaBlock, mediaBlockDescriptor, mediaBudgetBytes, omittedMediaDescriptor } from "../media-byte-cap.js";
2
+ import { requestMediaBudget } from "../image-admission.js";
3
+ import { isMediaBlock, mediaBlockDescriptor, omittedMediaDescriptor } from "../media-byte-cap.js";
3
4
  import { engineCardTypes } from "../tool-registry.js";
4
5
  import { readMember } from "../thrown-value.js";
5
6
  const MAX_TOOL_END_OUTPUT_CHARS = 16384;
@@ -45,7 +46,7 @@ const fitMedia = (media, budget) => {
45
46
  }
46
47
  return { blocks, degraded };
47
48
  };
48
- const project = (content, mediaByteCapBytes) => {
49
+ const project = (content, mediaBudgetBase64Chars) => {
49
50
  if (!Array.isArray(content)) {
50
51
  const s = typeof content === "string" ? content : (JSON.stringify(content) ?? "");
51
52
  if (s.length <= MAX_TOOL_END_OUTPUT_CHARS)
@@ -54,19 +55,19 @@ const project = (content, mediaByteCapBytes) => {
54
55
  }
55
56
  const media = content.map(isMediaBlock);
56
57
  const text = boundTextLane(content, content.flatMap((_, i) => (media[i] ? [] : [i])));
57
- const limit = mediaBudgetBytes(mediaByteCapBytes);
58
+ const limit = requestMediaBudget(mediaBudgetBase64Chars);
58
59
  const textBytes = [...text.forms.values()].reduce((n, f) => n + wireBytes(f), 0);
59
- const fit = fitMedia(content.filter((_, i) => media[i]), limit === Infinity ? Infinity : Math.ceil((limit * 4) / 3) - SUMMARY_RESERVE - textBytes);
60
+ const fit = fitMedia(content.filter((_, i) => media[i]), limit - SUMMARY_RESERVE - textBytes);
60
61
  if (!text.cut && !fit.degraded)
61
62
  return { output: content, truncated: false };
62
63
  let next = 0;
63
64
  const output = content.flatMap((_, i) => (media[i] ? (fit.blocks[next++] ?? []) : text.forms.has(i) ? [text.forms.get(i)] : []));
64
65
  return { output, truncated: true, totalChars: content.reduce((n, b) => n + toolOutputBlockChars(b), 0) };
65
66
  };
66
- export const toolOutputFrom = (result, mediaByteCapBytes) => {
67
+ export const toolOutputFrom = (result, mediaBudgetBase64Chars) => {
67
68
  try {
68
69
  const content = result !== null && typeof result === "object" ? result.content : result;
69
- return content === undefined ? undefined : project(content, mediaByteCapBytes);
70
+ return content === undefined ? undefined : project(content, mediaBudgetBase64Chars);
70
71
  }
71
72
  catch {
72
73
  return { output: "[unserializable tool output]", truncated: true };
@@ -6,7 +6,8 @@
6
6
  * closed-set words, counts, the call's identity and a media type only when it can be one — never the bytes.
7
7
  */
8
8
  import { type EngineNotice } from "../engine-notice.js";
9
- import type { ToolResultMediaRefusal } from "../image-admission.js";
9
+ import { type ToolResultMediaRefusal } from "../image-admission.js";
10
+ import type { ImageDownsampler } from "../image-downsample.js";
10
11
  /** The run's attribution pair, as every per-run notice carries it. */
11
12
  export interface ToolResultMediaSeatIds {
12
13
  sessionId: string;
@@ -17,3 +18,10 @@ export declare function toolResultMediaRefusedSeat(onNotice: ((notice: EngineNot
17
18
  toolCallId: string;
18
19
  refused: readonly ToolResultMediaRefusal[];
19
20
  }) => void;
21
+ /**
22
+ * The run's one account of an image that goes to the model unprocessed over `IMAGE_ADMISSION.soft.targetBytes`
23
+ * (`config.image_processor_unavailable`, operator): said ONCE per run, at the first such image wherever it entered — a
24
+ * tool's result (the tool-result seat), the task's images or a person's attachment (the leg). The detail carries the
25
+ * image's decoded size and the target — never the bytes.
26
+ */
27
+ export declare function imageUnprocessedSeat(onNotice: ((notice: EngineNotice) => void) | undefined, seat: ImageDownsampler | false | undefined, ids: ToolResultMediaSeatIds): (bytes: number) => void;
@@ -1,4 +1,5 @@
1
1
  import { deliverEngineNotice } from "../engine-notice.js";
2
+ import { IMAGE_ADMISSION } from "../image-admission.js";
2
3
  export function toolResultMediaRefusedSeat(onNotice, ids) {
3
4
  return ({ toolName, toolCallId, refused }) => {
4
5
  const reasons = [...new Set(refused.map((r) => r.reason))].join(", ");
@@ -6,8 +7,23 @@ export function toolResultMediaRefusedSeat(onNotice, ids) {
6
7
  code: "tool_result.media_refused",
7
8
  message: `The ${JSON.stringify(toolName)} tool's result carried ${refused.length} media block(s) whose bytes the media admission refused (${reasons}). ` +
8
9
  `Each was replaced in the result by a text placeholder naming the refusal, so neither the model nor the event stream received those bytes; ` +
9
- `the tool, or the server behind it, returned bytes that are not what their block claims.`,
10
+ `the tool, or the server behind it, returned bytes that are not what their block claims, or that are beyond what can be sent.`,
10
11
  detail: { toolName, toolCallId, refused: refused.map((r) => ({ ...r })), sessionId: ids.sessionId, runId: ids.runId },
11
12
  });
12
13
  };
13
14
  }
15
+ export function imageUnprocessedSeat(onNotice, seat, ids) {
16
+ let told = false;
17
+ return (bytes) => {
18
+ if (told)
19
+ return;
20
+ told = true;
21
+ const why = seat === false ? "`RunnerDeps.imageProcessor` is `false`" : "the optional sharp dependency did not resolve and `RunnerDeps.imageProcessor` sets none";
22
+ deliverEngineNotice(onNotice, {
23
+ code: "config.image_processor_unavailable",
24
+ message: `An image of ${bytes} bytes went to the model as it was, over the ${IMAGE_ADMISSION.soft.targetBytes}-byte target, because this run has no image processor: ${why}. ` +
25
+ `Images within the hard limits are sent uncompressed (more request bytes and tokens, earlier media-budget trims); set a processor or install sharp to compress them. Said once per run.`,
26
+ detail: { bytes, targetBytes: IMAGE_ADMISSION.soft.targetBytes, sessionId: ids.sessionId, runId: ids.runId },
27
+ });
28
+ };
29
+ }
@@ -0,0 +1,56 @@
1
+ /**
2
+ * The model's VIEW of the leg's tool table — the tools one request shows it.
3
+ *
4
+ * ONE rule: a tool whose every call the run's deny rules refuse is not shown. The reference removes a tool a whole-tool deny
5
+ * rule names from the tool pool before the model sees it (built-in and protocol tools alike; a deny wins, no allow is
6
+ * consulted). Here every face that can refuse a model's call answers by its own whole-tool reading, the one its refusal of a
7
+ * call already takes: the leg's effective policy (the fold the gate runs — the caller policy, the session and ancestor rules,
8
+ * the inherited parent policies; {@link ToolPolicy.wholeToolRefusals}), and the stored rules — the person's persisted rows and
9
+ * the org's rows, over one read of the store (`PermissionRuleLanes.wholeToolRefusals`). Only a WHOLE-TOOL rule speaks here: a
10
+ * rule about some calls of a tool (a command, a path, a value) leaves the tool shown, and its calls meet the gate.
11
+ *
12
+ * Read once per request, every reading side by side, each settled by the fold's own law ({@link toolPolicyWholeToolRefusals}):
13
+ * one that cannot answer (it throws, it does not answer in time) refuses nothing here, and the readings beside it stand — its
14
+ * calls still meet the gate, which is where a refusal is decided. The leg's tools stay
15
+ * mounted: a call the model makes anyway (a name it learned elsewhere) meets the gate and its rule's refusal. The view and
16
+ * the gate never decide the same question: the view says what the model is shown, the gate whether a call runs.
17
+ */
18
+ import type { Context, StreamFn } from "../../internal/llm.js";
19
+ import type { TurnPromptSnapshot } from "../../prompt-assembly/turn-snapshot.js";
20
+ import { type ToolFingerprintInput } from "../cache-break-detector.js";
21
+ import { type ToolRoster } from "../tool-roster.js";
22
+ import { type ToolPolicy } from "../tool-policy.js";
23
+ /** The faces the view reads, the roster whose face the gate stamps on a call of a tool, and the leg's prefix seats (the
24
+ * cache-break fingerprint and the turn snapshot name the tools ACTUALLY sent). */
25
+ export interface ToolTableViewFaces {
26
+ readonly policy: Pick<ToolPolicy, "wholeToolRefusals"> | undefined;
27
+ /** The stored rules — the person's rows and the org's, one read of the store for both. */
28
+ readonly stored: Pick<ToolPolicy, "wholeToolRefusals"> | undefined;
29
+ readonly roster: {
30
+ readonly current: ToolRoster | undefined;
31
+ };
32
+ readonly fpRef: {
33
+ current?: {
34
+ systemPrompt: string;
35
+ tools: ToolFingerprintInput[];
36
+ };
37
+ };
38
+ readonly turnSnapshotRef: {
39
+ current?: TurnPromptSnapshot;
40
+ };
41
+ }
42
+ export interface ToolTableView {
43
+ /** The request `context` as the model is shown it: its tools block without the tools the faces refuse whole (the same
44
+ * object when none is) — over one read of every face. */
45
+ request(context: Context, signal?: AbortSignal): Promise<Context>;
46
+ /** Whether the last request showed the tool (before any request: every tool) — the search space of a lane that answers the
47
+ * model about tools between requests (ToolSearch: a tool the model is not shown is no tool it can find). */
48
+ shows(toolName: string): boolean;
49
+ }
50
+ /** The leg's view — `undefined` when no face reads a whole-tool rule (every request then shows the tools block as built). */
51
+ export declare function createToolTableView(faces: ToolTableViewFaces): ToolTableView | undefined;
52
+ /** A request stream that rides the view: its tools block shows what {@link ToolTableView.request} shows. A leg whose view is
53
+ * not seated yet rides unchanged. */
54
+ export declare function streamShowingView(seat: {
55
+ readonly current?: ToolTableView;
56
+ }, stream: StreamFn): StreamFn;