@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,27 +1,23 @@
1
- /**
2
- * The request view's reading of a provider's image refusal — restored on the way to the brain, never in the transcript.
3
- *
4
- * A turn the provider failed with `errorKind: "image_unprocessable"` (an image in the request could not be processed;
5
- * classified at the brain boundary off the provider's envelope) is a MARKER, live in the loop's context and persisted
6
- * as the transcript's API-failure record alike. Reading the messages in order, each marker:
7
- * - replaces every image of the NEWEST earlier message that still carries one (a user message, a tool result, a
8
- * custom message — never an assistant's) by a text block saying which image was removed and why;
9
- * - leaves the view itself (a failure is not model output).
10
- * An earlier marker has already emptied its carrier, so a second marker reaches the next older one: the request that
11
- * failed loses one carrier's images per refusal, and a provider that names no position is still answered (the newest
12
- * carrier is the one the failed request added last). Nothing else moves; messages without a marker before them are
13
- * the same objects, and a view with no marker is the same array — the same transcript yields the same request bytes.
14
- *
15
- * The transcript keeps the images: a later reader of the session sees what was read, and every request built from it
16
- * — the next turn, a resumed session, a compaction summary — reads the same record and removes the same images.
17
- */
18
- /** The `errorKind` a provider's image refusal carries (`AssistantMessage.errorKind`). */
19
- export declare const IMAGE_REFUSAL_KIND = "image_unprocessable";
20
- /** The text that stands in for the `ordinal`-th image (1-based) of a carrier the provider refused an image of. */
21
- export declare function rejectedImagePlaceholder(ordinal: number): string;
1
+ import { IMAGE_REFUSAL_KIND } from "./media-removed.js";
2
+ export { IMAGE_REFUSAL_KIND };
3
+ /** The `errorKind` a provider's refusal of one tool's input schema carries (`AssistantMessage.errorKind`, beside
4
+ * `refusedTool`). */
5
+ export declare const TOOL_SCHEMA_REFUSAL_KIND = "tool_schema_refused";
6
+ /** The schema a tool whose input schema the provider refused travels with: an object that names no parameter (the
7
+ * reference's replacement, `X5t` (cli309.js:264190)). */
8
+ export declare const REFUSED_TOOL_SCHEMA: Readonly<{
9
+ type: "object";
10
+ }>;
11
+ /** How many tools of one transcript the tool view sends without their schema (the reference's bound, the same coordinate). */
12
+ export declare const REFUSED_TOOL_SCHEMAS_MAX = 8;
22
13
  /** Is this message a turn the provider failed because an image in the request could not be processed — the live
23
14
  * failure or its persisted record? */
24
15
  export declare function isImageRefusal(message: unknown): boolean;
16
+ /** The tool a turn the provider failed over that tool's input schema names (the live failure or its persisted record);
17
+ * undefined for any other message. */
18
+ export declare function refusedToolOf(message: unknown): string | undefined;
19
+ /** Is this message a marker of either part — what leaves the message view? */
20
+ export declare function isRequestPartRefusal(message: unknown): boolean;
25
21
  /** One carrier whose images a marker removed: the marker, the carrier (both the view's input objects), how many, and
26
22
  * the refusal's own time — the one identity a refusal keeps across its live failure, its persisted record and every
27
23
  * rebuilt copy of either (the record is minted with the failure's timestamp). */
@@ -34,13 +30,27 @@ export interface RejectedImageRemoval {
34
30
  /** A refusal's identity ({@link RejectedImageRemoval.refusalAt}). */
35
31
  export declare function imageRefusalAt(message: unknown): number;
36
32
  /**
37
- * The request view of `messages` under every image refusal they hold ({@link isImageRefusal}): each marker removed and
38
- * the images of its carrier replaced. `removals` lists, in order, the carriers emptied — empty when no marker found
39
- * an image to remove.
33
+ * The message view of `messages` under every refusal marker they hold ({@link isRequestPartRefusal}): each marker removed,
34
+ * and the images of an image marker's carrier replaced. `removals` lists, in order, the carriers emptied — empty when no
35
+ * image marker found an image to remove.
40
36
  */
41
- export declare function removeRejectedImages<T>(messages: readonly T[]): {
37
+ export declare function removeRefusedRequestParts<T>(messages: readonly T[]): {
42
38
  messages: T[];
43
39
  removals: RejectedImageRemoval[];
44
40
  };
45
41
  /** Does `marker`, standing in `messages`, remove images in their request view — was there a carrier left for it? */
46
42
  export declare function imageRefusalRemoves(messages: readonly unknown[], marker: object): boolean;
43
+ /** The tools whose schemas `messages` refused and the tool view replaces: in the order the transcript refused them, each
44
+ * once, external-protocol tools only, at most {@link REFUSED_TOOL_SCHEMAS_MAX}. */
45
+ export declare function refusedToolSchemas(messages: readonly unknown[]): string[];
46
+ /** The tool view of `tools` under `messages`' tool-schema refusals: each refused tool ({@link refusedToolSchemas}) with
47
+ * {@link REFUSED_TOOL_SCHEMA} for its parameters, every other tool the same object; with nothing refused, the same array. */
48
+ export declare function withoutRefusedToolSchemas<T extends {
49
+ readonly name: string;
50
+ readonly parameters: unknown;
51
+ }>(tools: readonly T[] | undefined, messages: readonly unknown[]): T[] | undefined;
52
+ /** Does `marker`, standing in `messages`, change the tool view of `tools` — does it name a mounted tool whose schema no
53
+ * earlier marker already replaced, within the transcript's bound? */
54
+ export declare function toolSchemaRefusalReplaces(messages: readonly unknown[], marker: object, tools: readonly {
55
+ readonly name: string;
56
+ }[] | undefined): boolean;
@@ -1,10 +1,24 @@
1
- export const IMAGE_REFUSAL_KIND = "image_unprocessable";
2
- export function rejectedImagePlaceholder(ordinal) {
3
- return `[image ${ordinal} removed: rejected by provider: ${IMAGE_REFUSAL_KIND}]`;
1
+ import { protocolOf } from "../../core/protocol-table.js";
2
+ import { IMAGE_REFUSAL_KIND, mediaRemovedPlaceholder } from "./media-removed.js";
3
+ export { IMAGE_REFUSAL_KIND };
4
+ export const TOOL_SCHEMA_REFUSAL_KIND = "tool_schema_refused";
5
+ export const REFUSED_TOOL_SCHEMA = Object.freeze({ type: "object" });
6
+ export const REFUSED_TOOL_SCHEMAS_MAX = 8;
7
+ function refusalKindOf(message) {
8
+ const m = message;
9
+ return m?.role === "assistant" && m.isApiErrorMessage === true ? m.errorKind : undefined;
4
10
  }
5
11
  export function isImageRefusal(message) {
6
- const m = message;
7
- return m?.role === "assistant" && m.isApiErrorMessage === true && m.errorKind === IMAGE_REFUSAL_KIND;
12
+ return refusalKindOf(message) === IMAGE_REFUSAL_KIND;
13
+ }
14
+ export function refusedToolOf(message) {
15
+ if (refusalKindOf(message) !== TOOL_SCHEMA_REFUSAL_KIND)
16
+ return undefined;
17
+ const tool = message.refusedTool;
18
+ return typeof tool === "string" && tool.length > 0 ? tool : undefined;
19
+ }
20
+ export function isRequestPartRefusal(message) {
21
+ return isImageRefusal(message) || refusedToolOf(message) !== undefined;
8
22
  }
9
23
  export function imageRefusalAt(message) {
10
24
  const at = message?.timestamp;
@@ -22,21 +36,23 @@ function imageCount(message) {
22
36
  }
23
37
  function withoutImages(message) {
24
38
  let ordinal = 0;
25
- const content = message.content.map((block) => block?.type === "image" ? { type: "text", text: rejectedImagePlaceholder(++ordinal) } : block);
39
+ const content = message.content.map((block) => block?.type === "image" ? { type: "text", text: mediaRemovedPlaceholder("rejected_by_provider", "image", ++ordinal) } : block);
26
40
  return { ...message, content };
27
41
  }
28
- export function removeRejectedImages(messages) {
29
- if (!messages.some(isImageRefusal))
42
+ export function removeRefusedRequestParts(messages) {
43
+ if (!messages.some(isRequestPartRefusal))
30
44
  return { messages: messages, removals: [] };
31
45
  const out = [];
32
46
  const carriers = [];
33
47
  const removals = [];
34
48
  for (const m of messages) {
35
- if (!isImageRefusal(m)) {
49
+ if (!isRequestPartRefusal(m)) {
36
50
  out.push(m);
37
51
  carriers.push(undefined);
38
52
  continue;
39
53
  }
54
+ if (!isImageRefusal(m))
55
+ continue;
40
56
  for (let j = out.length - 1; j >= 0; j--) {
41
57
  const images = imageCount(out[j]);
42
58
  if (images === 0)
@@ -50,5 +66,38 @@ export function removeRejectedImages(messages) {
50
66
  return { messages: out, removals };
51
67
  }
52
68
  export function imageRefusalRemoves(messages, marker) {
53
- return removeRejectedImages(messages).removals.some((r) => r.marker === marker);
69
+ return removeRefusedRequestParts(messages).removals.some((r) => r.marker === marker);
70
+ }
71
+ function schemaReplaceable(tool) {
72
+ return protocolOf(tool) !== undefined;
73
+ }
74
+ export function refusedToolSchemas(messages) {
75
+ const out = [];
76
+ for (const m of messages) {
77
+ const tool = refusedToolOf(m);
78
+ if (tool === undefined || !schemaReplaceable(tool) || out.includes(tool))
79
+ continue;
80
+ if (out.length === REFUSED_TOOL_SCHEMAS_MAX)
81
+ break;
82
+ out.push(tool);
83
+ }
84
+ return out;
85
+ }
86
+ export function withoutRefusedToolSchemas(tools, messages) {
87
+ if (tools === undefined)
88
+ return undefined;
89
+ const refused = refusedToolSchemas(messages);
90
+ if (refused.length === 0 || !tools.some((t) => refused.includes(t.name)))
91
+ return tools;
92
+ return tools.map((t) => (refused.includes(t.name) ? { ...t, parameters: { ...REFUSED_TOOL_SCHEMA } } : t));
93
+ }
94
+ export function toolSchemaRefusalReplaces(messages, marker, tools) {
95
+ const tool = refusedToolOf(marker);
96
+ if (tool === undefined || tools?.some((t) => t.name === tool) !== true)
97
+ return false;
98
+ const at = messages.indexOf(marker);
99
+ if (at < 0)
100
+ return false;
101
+ const before = refusedToolSchemas(messages.slice(0, at));
102
+ return !before.includes(tool) && refusedToolSchemas(messages.slice(0, at + 1)).includes(tool);
54
103
  }
@@ -406,7 +406,15 @@ export interface UserMessage {
406
406
  * custom Brain); the session import door strips it (an imported frame is an ordinary engine note).
407
407
  */
408
408
  attachment?: UserMessageAttachment;
409
+ /** {@link RowRewrittenBy} */
410
+ rewrittenBy?: RowRewrittenBy;
409
411
  }
412
+ /**
413
+ * The extensions whose rewrite of this row the conversation kept (a `session.append` handler's, at the row's admission),
414
+ * in the order they handed it on — absent ⇒ the row is as its writer made it. Attribution only: never sent to a provider
415
+ * (brains rebuild wire messages field by field; {@link stripEngineMetadata} strips it for a custom Brain).
416
+ */
417
+ export type RowRewrittenBy = readonly string[];
410
418
  /** What the engine found an attachment to be: the four Read lanes, a directory, or bytes the host supplied. */
411
419
  export type UserAttachmentKind = "text" | "notebook" | "image" | "pdf" | "directory" | "client_text" | "client_image";
412
420
  /** Who held the bytes: the engine read a path in its workspace, or the host supplied text / an image. */
@@ -608,8 +616,16 @@ export interface AssistantMessage {
608
616
  * brain boundary off the provider's envelope (`brain/provider-dialect.ts`, `IMAGE_UNPROCESSABLE_RE`). Such a turn —
609
617
  * live, or as the transcript's persisted record of it — is the request view's instruction to remove the images of
610
618
  * the newest earlier message still carrying any (`engine/llm/rejected-images.ts`, at `convertToLlm`); the loop
611
- * re-sends the turn without them. */
612
- errorKind?: "length_empty" | "degenerate" | "input_too_long" | "image_unprocessable";
619
+ * re-sends the turn without them.
620
+ *
621
+ * `"tool_schema_refused"`: the provider refused the request because of one tool's input schema, and located that
622
+ * tool ({@link refusedTool}) — classified at the brain boundary off the provider's envelope (`brain/provider-dialect.ts`,
623
+ * the tool-schema rows). Such a turn, live or as its persisted record, is the request view's instruction to send that
624
+ * tool — when an external protocol (MCP, A2A) provides it — with an empty object schema in every request built from a
625
+ * transcript it stands in (`engine/llm/rejected-images.ts`); the loop re-sends the turn so. */
626
+ errorKind?: "length_empty" | "degenerate" | "input_too_long" | "image_unprocessable" | "tool_schema_refused";
627
+ /** With `errorKind: "tool_schema_refused"`: the engine name of the tool whose input schema the provider refused. */
628
+ refusedTool?: string;
613
629
  /** The AUTHORITATIVE-NEGATIVE twin of `errorKind: "input_too_long"`: the brain's provenance-checked
614
630
  * classifier RAN and ruled this failure NOT input-too-long (wrong status family, or the provider's
615
631
  * own envelope states a different error). The loop's prompt-too-long recovery treats it as a hard
@@ -670,6 +686,8 @@ export interface AssistantMessage {
670
686
  * the 2-downgrade stop-loss. Additive — absent everywhere else (incl. the dynamicCut shape).
671
687
  */
672
688
  staticReasoningCut?: true;
689
+ /** {@link RowRewrittenBy} */
690
+ rewrittenBy?: RowRewrittenBy;
673
691
  timestamp: number;
674
692
  }
675
693
  export interface ToolResultMessage<TDetails = unknown> {
@@ -679,6 +697,8 @@ export interface ToolResultMessage<TDetails = unknown> {
679
697
  content: (TextContent | ImageContent | DocumentContent)[];
680
698
  details?: TDetails;
681
699
  isError: boolean;
700
+ /** {@link RowRewrittenBy} */
701
+ rewrittenBy?: RowRewrittenBy;
682
702
  timestamp: number;
683
703
  }
684
704
  export type Message = UserMessage | AssistantMessage | ToolResultMessage;
@@ -687,7 +707,8 @@ export type Message = UserMessage | AssistantMessage | ToolResultMessage;
687
707
  * serializing a Context to an external wire. The eight fields (`enginePrefixChars`/`engineSegments`/
688
708
  * `engineMinted`/`provenance`/`actor`/`engineNoteKey`/`attachment`/`runOrigin`) are INTERNAL coordination between the engine's
689
709
  * minting side and its consumers (permission classifier, compaction summarizer, prompt suggestions,
690
- * multiplayer attribution, attachment delivery, run attribution) — they must never reach a provider payload. The built-in brains construct
710
+ * multiplayer attribution, attachment delivery, run attribution) — they must never reach a provider payload; so is
711
+ * {@link RowRewrittenBy}, on every role. The built-in brains construct
691
712
  * their own wire shapes and are immune; a CUSTOM Brain that whole-object-serializes messages
692
713
  * (`JSON.stringify(context.messages)`) would leak them — run the array through this projection first.
693
714
  */
@@ -50,9 +50,13 @@ export function renderUserAttachmentView(m, a, cap) {
50
50
  }
51
51
  export function stripEngineMetadata(messages) {
52
52
  return messages.map((m) => {
53
- if (m.role !== "user")
54
- return m;
55
- const { enginePrefixChars: _a, engineSegments: _b, engineMinted: _c, provenance: _d, actor: _e, engineNoteKey: _f, attachment: _g, runOrigin: _h, ...rest } = m;
53
+ if (m.role !== "user") {
54
+ if (m.rewrittenBy === undefined)
55
+ return m;
56
+ const { rewrittenBy: _r, ...kept } = m;
57
+ return kept;
58
+ }
59
+ const { enginePrefixChars: _a, engineSegments: _b, engineMinted: _c, provenance: _d, actor: _e, engineNoteKey: _f, attachment: _g, runOrigin: _h, rewrittenBy: _i, ...rest } = m;
56
60
  return rest;
57
61
  });
58
62
  }
@@ -38,6 +38,8 @@ export type LoopContinueReason =
38
38
  | "reactive_compact_retry"
39
39
  /** The provider refused an image; the request view removed it and the turn was re-sent in-turn. */
40
40
  | "image_refusal_retry"
41
+ /** The provider refused one tool's input schema; the tool view emptied it and the turn was re-sent in-turn. */
42
+ | "tool_schema_refusal_retry"
41
43
  /** ④b recovery: a `length`-stopped answer triggered a synthetic continue nudge for another turn. */
42
44
  | "max_output_tokens_recovery"
43
45
  /** S2 recovery (design/119): a `toolUse` stop with ZERO parseable tool calls got a retry nudge. */
@@ -69,14 +71,12 @@ export type LoopTerminalReason =
69
71
  * budget is used up — the model believes it acted, nothing ran, and there is no more recovery budget
70
72
  * left to try again. Before this reason existed, this case fell through to the generic no-more-work
71
73
  * path and was reported as a plain `"completed"`, indistinguishable from a turn that genuinely had
72
- * nothing left to do.
74
+ * nothing left to do. A Runner run reads this exit (and `truncated_output_exhausted`) as a `failed`
75
+ * terminal: `model.malformed_tool_use_exhausted` / `model.truncated_output_exhausted`.
73
76
  *
74
- * 独立复审(视角一)提醒:`malformedToolUseRetries` 是**整个 run 生命周期内的绝对计数**,恢复成功后不
75
- * 回退(与 `staticReasoningCutRecoveries` 同一姿势,非本次改动引入)——"exhausted" 说的是"这个 run 从
76
- * 开始到现在总共用掉的重试次数已达上限",不是"刚刚连续失败了 maxRetries 次"。一次早于此刻很久、且已
77
- * 成功恢复过的畸形调用,和刚刚才第一次触发畸形调用但恰好撞上早已用尽的预算,在这个 reason 面前不可
78
- * 区分;调用方若需要"最近是否连续失败"这类更细的语义,需要自行在更高层维护窗口计数,这个 reason 只
79
- * 承诺"预算耗尽"这一件事。 */
77
+ * `malformedToolUseRetries` 数的是**连续**畸形轮:任何带可解析工具调用的轮(即工具真的跑了)都把它
78
+ * 清零,与上游「重试至多两次、成功即复位」同形——"exhausted" 说的是"刚刚连续 maxRetries + 1 个轮次
79
+ * 全部畸形",不是"这个 run 总共累计过多少次畸形"。早先已恢复成功的畸形调用不再占用后来的预算。 */
80
80
  | "malformed_tool_use_exhausted"
81
81
  /** RB-258(RB-206 口径追查的衍生发现;RB-206 的同族对仗):the model kept ending its turn on the
82
82
  * provider's output cap (`length`) with no tool calls, and the bounded truncated-output continue
@@ -90,9 +90,9 @@ export type LoopTerminalReason =
90
90
  * - Only the CONFIGURED lane reports it. With `recovery.truncatedOutput` absent (the loop default
91
91
  * is OFF) there is no budget to exhaust, so a `length` stop still ends as a plain `completed` —
92
92
  * the pre-④b behavior, unchanged.
93
- * - `truncatedOutputContinues` counts CONSECUTIVE nudges and RESETS on any non-`length` turn (unlike
94
- * `malformedToolUseRetries`, which is absolute per run). So this reason means "the model just ended
95
- * `length` maxContinues+1 times in a row", not "this run has burnt N recoveries in total".
93
+ * - `truncatedOutputContinues` counts CONSECUTIVE nudges and RESETS on any non-`length` turn (as
94
+ * `malformedToolUseRetries` resets on any turn whose tool calls ran). So this reason means "the model
95
+ * just ended `length` maxContinues+1 times in a row", not "this run has burnt N recoveries in total".
96
96
  * - Like every other terminal, it stops the loop BEFORE drain point B — a follow-up queue / Stop-hook
97
97
  * continuation no longer gets consulted on this path. That is the point (a stop-gate rescue would
98
98
  * re-enter the same wall with a spent budget), and queued follow-ups stay queued for the next
@@ -134,6 +134,8 @@ export interface TrailingToolBatchSettlement {
134
134
  /** A prompt run's seam beyond its prompts (the trailing-batch settlement); a prompt is delivered at its `message_end`. */
135
135
  export interface RunAgentLoopSeams {
136
136
  settle?: TrailingToolBatchSettlement;
137
+ /** The prompts RECORD a turn a person's bare refusal ended: they owe no model turn (a drain point's queued input still continues the run). */
138
+ endsAwaitingUser?: true;
137
139
  }
138
140
  /** The last assistant message of `messages` when at least one of its tool calls has no tool result after it. */
139
141
  export declare function findUnansweredToolBatch(messages: readonly AgentMessage[]): AssistantMessage | undefined;
@@ -223,13 +225,16 @@ export declare const TOOL_INPUT_VALIDATION_TIMEOUT_MS = 10000;
223
225
  * same function, so the two cannot drift into two dialects of one finalization: the `afterToolCall` patch
224
226
  * (content / details / terminate / isError), the D4 posture on a throwing hook, the delivery mark, and last
225
227
  * the media admission — the tool-result seat every supply of media reaches after the last hand that can change
226
- * it (`admitToolResultMedia`): a refused block becomes its text placeholder in the result, and `onMediaRefused`
227
- * hears the call's refusals once. `after` absent and no media ⇒ the executed outcome stands as is (same object).
228
+ * it (`toolResultMediaBlocks`, then `admitToolResultMediaBlocks` with the run's image processor `media.imageProcessor`,
229
+ * resolved only once a block claims media): a refused block becomes its text placeholder in the result,
230
+ * `media.onToolMediaRefused` hears the call's refusals once, and `media.onImageUnprocessed` hears an image that goes on
231
+ * unprocessed over the soft target. `after` absent and no media ⇒ the executed outcome stands as is (same object), with
232
+ * nothing awaited.
228
233
  */
229
234
  export declare function finalizeToolOutcome<C extends {
230
235
  id: string;
231
236
  name: string;
232
- }>(toolCall: C, executed: ExecutedToolCallOutcome, after: ((result: AgentToolResult<unknown>, isError: boolean) => Promise<AfterToolCallResult | undefined>) | undefined, onMediaRefused?: AgentLoopConfig["onToolMediaRefused"]): Promise<ExecutedToolCallOutcome & {
237
+ }>(toolCall: C, executed: ExecutedToolCallOutcome, after: ((result: AgentToolResult<unknown>, isError: boolean) => Promise<AfterToolCallResult | undefined>) | undefined, media?: Pick<AgentLoopConfig, "imageProcessor" | "onToolMediaRefused" | "onImageUnprocessed">): Promise<ExecutedToolCallOutcome & {
233
238
  toolCall: C;
234
239
  }>;
235
240
  export {};
@@ -7,8 +7,9 @@ import { isErrorLike, readMember, readOwnMembers, thrownMarksOf } from "../../co
7
7
  import { egressThrownText, egressValue } from "../../core/untrusted-egress.js";
8
8
  import { remoteWords } from "../../core/protocol-http-auth.js";
9
9
  import { types } from "node:util";
10
- import { admitToolResultMedia } from "../../core/image-admission.js";
11
- import { IMAGE_REFUSAL_KIND, imageRefusalRemoves } from "../llm/rejected-images.js";
10
+ import { admitToolResultMediaBlocks, firstUnprocessedOverTarget, toolResultMediaBlocks } from "../../core/image-admission.js";
11
+ import { resolveImageProcessor } from "../../core/image-downsample.js";
12
+ import { IMAGE_REFUSAL_KIND, imageRefusalRemoves, toolSchemaRefusalReplaces, withoutRefusedToolSchemas } from "../llm/rejected-images.js";
12
13
  const IMAGE_REFUSAL_RETRIES = 3;
13
14
  function appendTextDeltaToAssistantMessage(message, contentIndex, delta) {
14
15
  const content = [...message.content];
@@ -76,7 +77,7 @@ export async function runAgentLoop(prompts, context, config, emit, signal, strea
76
77
  }
77
78
  const delivered = typeof prompts === "function" ? await prompts() : prompts;
78
79
  if (delivered.length > 0)
79
- state.hasMoreToolCalls = true;
80
+ state.hasMoreToolCalls = seams?.endsAwaitingUser !== true;
80
81
  state.context.messages.push(...delivered);
81
82
  state.newMessages.push(...delivered);
82
83
  for (const prompt of delivered) {
@@ -369,18 +370,27 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
369
370
  raiseFatalCancellation(executor);
370
371
  let interruptedInRecovery = false;
371
372
  let imageRetries = 0;
372
- const resendWithoutRefusedImages = async () => {
373
+ const refusalChangesRequest = () => message.errorKind === IMAGE_REFUSAL_KIND
374
+ ? imageRetries < IMAGE_REFUSAL_RETRIES && imageRefusalRemoves(state.context.messages, message)
375
+ : toolSchemaRefusalReplaces(state.context.messages, message, state.context.tools);
376
+ const resendWithoutRefusedParts = async () => {
373
377
  while (message.stopReason === "error" &&
374
- message.errorKind === IMAGE_REFUSAL_KIND &&
375
378
  !signal?.aborted &&
376
379
  !turnController.signal.aborted &&
377
380
  isBlankFailureContent(message) &&
378
381
  executor.admittedCount === 0 &&
379
- imageRetries < IMAGE_REFUSAL_RETRIES &&
380
382
  state.context.messages[state.context.messages.length - 1] === message &&
381
- imageRefusalRemoves(state.context.messages, message)) {
382
- imageRetries++;
383
- trace?.({ kind: "continue", reason: "image_refusal_retry" });
383
+ refusalChangesRequest()) {
384
+ if (message.errorKind === IMAGE_REFUSAL_KIND)
385
+ imageRetries++;
386
+ else if (message.refusedTool !== undefined) {
387
+ try {
388
+ state.config.onToolSchemaRefused?.({ tool: message.refusedTool, refusalAt: message.timestamp });
389
+ }
390
+ catch {
391
+ }
392
+ }
393
+ trace?.({ kind: "continue", reason: message.errorKind === IMAGE_REFUSAL_KIND ? "image_refusal_retry" : "tool_schema_refusal_retry" });
384
394
  executor = new StreamToolExecutor(state.context, state.config, turnController.signal, emit);
385
395
  try {
386
396
  ({ message, cutAtSettle: cutAtFinalSettle } = await streamAssistantResponse(state.context, state.config, turnController.signal, withhold?.sink ?? emit, streamFn, runtime, executor, staticReasoningCutDowngrade));
@@ -391,7 +401,7 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
391
401
  raiseFatalCancellation(executor);
392
402
  }
393
403
  };
394
- await resendWithoutRefusedImages();
404
+ await resendWithoutRefusedParts();
395
405
  {
396
406
  if (ptl) {
397
407
  const detect = ptlDetect;
@@ -444,7 +454,7 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
444
454
  }
445
455
  }
446
456
  }
447
- await resendWithoutRefusedImages();
457
+ await resendWithoutRefusedParts();
448
458
  const unrecoveredPtlFailureUnderInterrupt = ptl !== undefined &&
449
459
  message.stopReason === "error" &&
450
460
  ptlDetect(message) &&
@@ -459,6 +469,8 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
459
469
  withhold?.discard();
460
470
  await withhold?.flush();
461
471
  state.newMessages.push(message);
472
+ if (message.content.some((c) => c.type === "toolCall"))
473
+ state.malformedToolUseRetries = 0;
462
474
  if (message.staticReasoningCut === true)
463
475
  state.staticReasoningCutRecoveries++;
464
476
  if (interruptOwnsTurn) {
@@ -565,7 +577,7 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
565
577
  }
566
578
  const malformed = state.config.recovery?.malformedToolUse;
567
579
  if (malformed && message.stopReason === "toolUse" && toolCalls.length === 0 && state.pendingMessages.length === 0) {
568
- if (state.malformedToolUseRetries < (malformed.maxRetries ?? 1)) {
580
+ if (state.malformedToolUseRetries < (malformed.maxRetries ?? 2)) {
569
581
  state.malformedToolUseRetries++;
570
582
  state.pendingMessages = [createMalformedToolUseNudge()];
571
583
  return { kind: "ran", recovered: "malformed_tool_use_retry" };
@@ -716,37 +728,27 @@ async function streamAssistantResponse(context, config, signal, emit, streamFn,
716
728
  systemPrompt: context.systemPrompt,
717
729
  ...(context.systemBlocks ? { systemBlocks: context.systemBlocks } : {}),
718
730
  messages: llmMessages,
719
- tools: context.tools,
731
+ tools: withoutRefusedToolSchemas(context.tools, context.messages),
720
732
  };
721
733
  const streamFunction = resolveAgentCoreStreamFn(runtime, streamFn);
722
734
  const resolvedApiKey = (config.getApiKey ? await config.getApiKey(config.model.provider) : undefined) || config.apiKey;
723
735
  const perCallMaxTokens = config.maxTokensPerCall?.();
724
736
  const perCallStallTimeouts = config.stallTimeoutsPerCall?.();
725
737
  if (signal?.aborted) {
726
- const abortedBeforeDispatch = {
727
- role: "assistant",
728
- content: [{ type: "text", text: "" }],
729
- api: config.model.api,
730
- provider: config.model.provider,
731
- model: config.model.id,
732
- stopReason: "aborted",
733
- timestamp: Date.now(),
734
- usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
735
- usageMissing: true,
736
- };
738
+ const abortedBeforeDispatch = engineAbortedFinal(config.model);
737
739
  context.messages.push(abortedBeforeDispatch);
738
740
  await emit({ type: "message_start", message: { ...abortedBeforeDispatch } });
739
741
  await emit({ type: "message_end", message: abortedBeforeDispatch });
740
742
  return { message: abortedBeforeDispatch, cutAtSettle: true };
741
743
  }
742
- const response = await streamFunction(config.model, llmContext, {
744
+ const response = cutByTurnSignal(() => streamFunction(config.model, llmContext, {
743
745
  ...config,
744
746
  ...(perCallMaxTokens !== undefined ? { maxTokens: perCallMaxTokens, maxTokensDynamic: true } : {}),
745
747
  ...(perCallStallTimeouts !== undefined ? { stallTimeouts: perCallStallTimeouts } : {}),
746
748
  ...(staticReasoningCutDowngrade === true ? { staticReasoningCutDowngrade: true } : {}),
747
749
  apiKey: resolvedApiKey,
748
750
  signal,
749
- });
751
+ }), signal, config.model);
750
752
  let partialMessage = null;
751
753
  let addedPartial = false;
752
754
  for await (const event of response) {
@@ -818,6 +820,136 @@ async function streamAssistantResponse(context, config, signal, emit, streamFn,
818
820
  await emit({ type: "message_end", message: finalMessage });
819
821
  return { message: finalMessage, cutAtSettle };
820
822
  }
823
+ function engineAbortedFinal(model) {
824
+ return {
825
+ role: "assistant",
826
+ content: [{ type: "text", text: "" }],
827
+ api: model.api,
828
+ provider: model.provider,
829
+ model: model.id,
830
+ stopReason: "aborted",
831
+ timestamp: Date.now(),
832
+ usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
833
+ usageMissing: true,
834
+ };
835
+ }
836
+ function cutByTurnSignal(open, signal, model) {
837
+ const steps = [];
838
+ let wake;
839
+ let answered = false;
840
+ let settled = false;
841
+ let resolveFinal;
842
+ let rejectFinal;
843
+ const final = new Promise((resolve, reject) => ((resolveFinal = resolve), (rejectFinal = reject)));
844
+ final.catch(() => undefined);
845
+ const deliver = (step) => {
846
+ steps.push(step);
847
+ wake?.();
848
+ };
849
+ let iterator;
850
+ let letGo = false;
851
+ const release = () => {
852
+ letGo = true;
853
+ const it = iterator;
854
+ iterator = undefined;
855
+ if (it?.return !== undefined)
856
+ void Promise.resolve(it).then((held) => held.return?.()).catch(() => undefined);
857
+ };
858
+ const settle = (outcome) => {
859
+ if (settled)
860
+ return;
861
+ settled = true;
862
+ signal?.removeEventListener("abort", onAbort);
863
+ if ("message" in outcome)
864
+ resolveFinal(outcome.message);
865
+ else
866
+ rejectFinal(outcome.error);
867
+ };
868
+ const onAbort = () => void setImmediate(() => {
869
+ if (settled)
870
+ return;
871
+ const shell = engineAbortedFinal(model);
872
+ if (!answered) {
873
+ answered = true;
874
+ deliver({ event: { type: "error", reason: "aborted", error: shell } });
875
+ deliver("end");
876
+ }
877
+ settle({ message: shell });
878
+ release();
879
+ });
880
+ if (signal?.aborted)
881
+ onAbort();
882
+ else
883
+ signal?.addEventListener("abort", onAbort, { once: true });
884
+ void (async () => {
885
+ try {
886
+ const inner = await open();
887
+ const it = (iterator = inner[Symbol.asyncIterator]());
888
+ if (letGo)
889
+ return release();
890
+ for (;;) {
891
+ const step = await it.next();
892
+ if (letGo)
893
+ return;
894
+ if (step.done === true)
895
+ break;
896
+ const event = step.value;
897
+ deliver({ event });
898
+ if (event.type !== "done" && event.type !== "error")
899
+ continue;
900
+ answered = true;
901
+ settle({ message: await inner.result() });
902
+ return release();
903
+ }
904
+ iterator = undefined;
905
+ if (!answered) {
906
+ answered = true;
907
+ deliver("end");
908
+ settle({ message: await inner.result() });
909
+ }
910
+ }
911
+ catch (error) {
912
+ if (!answered) {
913
+ iterator = undefined;
914
+ answered = true;
915
+ deliver({ error });
916
+ }
917
+ else
918
+ release();
919
+ settle({ error });
920
+ }
921
+ finally {
922
+ deliver("end");
923
+ }
924
+ })();
925
+ return {
926
+ async *[Symbol.asyncIterator]() {
927
+ let readToEnd = false;
928
+ try {
929
+ for (;;) {
930
+ const step = steps.shift();
931
+ if (step === undefined) {
932
+ await new Promise((resolve) => (wake = resolve));
933
+ wake = undefined;
934
+ continue;
935
+ }
936
+ if (step === "end")
937
+ return void (readToEnd = true);
938
+ if ("error" in step)
939
+ throw step.error;
940
+ yield step.event;
941
+ }
942
+ }
943
+ finally {
944
+ if (!readToEnd) {
945
+ signal?.removeEventListener("abort", onAbort);
946
+ release();
947
+ }
948
+ }
949
+ },
950
+ result: () => final,
951
+ };
952
+ }
821
953
  async function executeToolCalls(currentContext, assistantMessage, config, signal, emit, executor) {
822
954
  const toolCalls = assistantMessage.content.filter((c) => c.type === "toolCall");
823
955
  if (config.toolExecution === "sequential") {
@@ -1570,9 +1702,9 @@ async function executePreparedWithDisclosure(currentContext, assistantMessage, p
1570
1702
  function finalizeExecutedToolCall(currentContext, assistantMessage, prepared, executed, config, signal) {
1571
1703
  return finalizeToolOutcome(prepared.toolCall, executed, config.afterToolCall === undefined
1572
1704
  ? undefined
1573
- : (result, isError) => config.afterToolCall({ assistantMessage, toolCall: prepared.toolCall, args: prepared.args, result, isError, context: currentContext }, signal), config.onToolMediaRefused);
1705
+ : (result, isError) => config.afterToolCall({ assistantMessage, toolCall: prepared.toolCall, args: prepared.args, result, isError, context: currentContext }, signal), config);
1574
1706
  }
1575
- export async function finalizeToolOutcome(toolCall, executed, after, onMediaRefused) {
1707
+ export async function finalizeToolOutcome(toolCall, executed, after, media) {
1576
1708
  let result = executed.result;
1577
1709
  let isError = executed.isError;
1578
1710
  const deliveryMark = readDeliveryFailureMark(executed.result.details);
@@ -1598,13 +1730,22 @@ export async function finalizeToolOutcome(toolCall, executed, after, onMediaRefu
1598
1730
  result = { ...result, details };
1599
1731
  }
1600
1732
  }
1601
- const admitting = admitToolResultMedia(result.content, toolCall.name);
1602
- if (admitting !== undefined) {
1603
- const admitted = await admitting;
1733
+ const mediaBlocks = toolResultMediaBlocks(result.content);
1734
+ if (mediaBlocks !== undefined) {
1735
+ const processor = await resolveImageProcessor(media?.imageProcessor);
1736
+ const admitted = await admitToolResultMediaBlocks(mediaBlocks, toolCall.name, processor);
1604
1737
  result = { ...result, content: admitted.content };
1738
+ const unprocessed = firstUnprocessedOverTarget(admitted.content, processor);
1605
1739
  if (admitted.refused.length > 0) {
1606
1740
  try {
1607
- onMediaRefused?.({ toolName: toolCall.name, toolCallId: toolCall.id, refused: admitted.refused });
1741
+ media?.onToolMediaRefused?.({ toolName: toolCall.name, toolCallId: toolCall.id, refused: admitted.refused });
1742
+ }
1743
+ catch {
1744
+ }
1745
+ }
1746
+ if (unprocessed !== undefined) {
1747
+ try {
1748
+ media?.onImageUnprocessed?.(unprocessed);
1608
1749
  }
1609
1750
  catch {
1610
1751
  }