@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,8 +1,6 @@
1
- import { MCP_IMAGE_MAX_BASE64 } from "./image-downsample.js";
2
- import { claimedMediaType } from "./media-byte-cap.js";
1
+ import { createHash } from "node:crypto";
3
2
  import { readMember } from "./thrown-value.js";
4
- export const MAX_IMAGE_READ_BYTES = 5 * 1024 * 1024;
5
- export const MAX_IMAGE_DOWNSAMPLE_INPUT_BYTES = 64 * 1024 * 1024;
3
+ import { describeRejectedValue } from "./tool-search-setting.js";
6
4
  export const PDF_TARGET_RAW_SIZE = 20 * 1024 * 1024;
7
5
  const spells = (b, at, text) => {
8
6
  if (b.length < at + text.length)
@@ -14,51 +12,182 @@ const spells = (b, at, text) => {
14
12
  };
15
13
  const u32be = (b, at) => ((b[at] << 24) >>> 0) + (b[at + 1] << 16) + (b[at + 2] << 8) + b[at + 3];
16
14
  const u16le = (b, at) => b[at] + (b[at + 1] << 8);
17
- const IMAGE_HEADER_CHECKS = {
15
+ const u16be = (b, at) => (b[at] << 8) + b[at + 1];
16
+ const u24le = (b, at) => b[at] + (b[at + 1] << 8) + (b[at + 2] << 16);
17
+ const u32le = (b, at) => (u24le(b, at) + (b[at + 3] << 24)) >>> 0;
18
+ const IMAGE_HEADER_CHECKS = Object.freeze({
18
19
  "image/png": (b) => b.length >= 24 && spells(b, 0, "\x89PNG\r\n\x1a\n") && u32be(b, 8) === 13 && spells(b, 12, "IHDR") && u32be(b, 16) > 0 && u32be(b, 20) > 0,
19
20
  "image/jpeg": (b) => b.length >= 4 && b[0] === 0xff && b[1] === 0xd8 && b[2] === 0xff && b[3] >= 0xc0,
20
21
  "image/gif": (b) => b.length >= 13 && (spells(b, 0, "GIF87a") || spells(b, 0, "GIF89a")) && u16le(b, 6) > 0 && u16le(b, 8) > 0,
21
22
  "image/webp": (b) => b.length >= 16 && spells(b, 0, "RIFF") && spells(b, 8, "WEBP") && (spells(b, 12, "VP8 ") || spells(b, 12, "VP8L") || spells(b, 12, "VP8X")),
22
- };
23
+ });
24
+ const MiB = 1024 * 1024;
25
+ const IMAGE_BASE64_CHARS = 5 * MiB;
26
+ const IMAGE_BASE64_RAW_BYTES = (IMAGE_BASE64_CHARS * 3) / 4;
27
+ export const IMAGE_ADMISSION = Object.freeze({
28
+ hard: Object.freeze({
29
+ formats: IMAGE_HEADER_CHECKS,
30
+ readBytes: Object.freeze({ withoutProcessor: IMAGE_BASE64_RAW_BYTES, withProcessor: 64 * MiB }),
31
+ urlBytes: 20 * MiB,
32
+ rejectEdge: 2000,
33
+ imageBase64Chars: IMAGE_BASE64_CHARS,
34
+ }),
35
+ soft: Object.freeze({ frameEdge: 2000, rawBytes: IMAGE_BASE64_RAW_BYTES, targetBytes: 512_000 }),
36
+ request: Object.freeze({
37
+ maxItems: 100,
38
+ largeWindow: Object.freeze({ fromContextWindow: 1_000_000, maxItems: 600 }),
39
+ margin: 20,
40
+ budgetBase64Chars: 40 * MiB,
41
+ hysteresisBase64Chars: 10 * MiB,
42
+ }),
43
+ });
44
+ const smallestRequestMediaBudget = () => 2 * IMAGE_ADMISSION.request.hysteresisBase64Chars;
45
+ export function requestMediaBudget(knob) {
46
+ const budget = knob ?? IMAGE_ADMISSION.request.budgetBase64Chars;
47
+ return budget === 0 ? Infinity : budget;
48
+ }
49
+ export function requestMediaLimits(model, knob) {
50
+ const { maxItems, largeWindow, margin, hysteresisBase64Chars } = IMAGE_ADMISSION.request;
51
+ const window = model.contextWindow;
52
+ return { maxItems: typeof window === "number" && window >= largeWindow.fromContextWindow ? largeWindow.maxItems : maxItems, margin, budgetBase64Chars: requestMediaBudget(knob), hysteresisBase64Chars };
53
+ }
54
+ export function checkedRequestMediaBudget(value, seat) {
55
+ if (value === undefined || value === 0 || value === Infinity || (Number.isInteger(value) && value >= smallestRequestMediaBudget()))
56
+ return;
57
+ const e = new Error(`${seat} ${describeRejectedValue(value)} is not a request media budget — expected a whole number of base64 characters of at least ${smallestRequestMediaBudget()} (twice the ${IMAGE_ADMISSION.request.hysteresisBase64Chars}-character margin a cut leaves under the budget), 0 or Infinity for no budget, or omit it for the default ${IMAGE_ADMISSION.request.budgetBase64Chars}`);
58
+ e.code = "config.invalid_argument";
59
+ throw e;
60
+ }
23
61
  export function imageMagicMatches(bytes, mimeType) {
24
- return Object.hasOwn(IMAGE_HEADER_CHECKS, mimeType) && IMAGE_HEADER_CHECKS[mimeType](bytes);
62
+ const formats = IMAGE_ADMISSION.hard.formats;
63
+ return Object.hasOwn(formats, mimeType) && formats[mimeType](bytes);
64
+ }
65
+ function jpegFrameAt(b) {
66
+ if (b.length < 4 || b[0] !== 0xff || b[1] !== 0xd8)
67
+ return undefined;
68
+ let at = 2;
69
+ while (at + 9 < b.length) {
70
+ if (b[at] !== 0xff) {
71
+ at++;
72
+ continue;
73
+ }
74
+ const marker = b[at + 1];
75
+ if (marker === 0xff) {
76
+ at++;
77
+ continue;
78
+ }
79
+ if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc)
80
+ return at;
81
+ if ((marker >= 0xd0 && marker <= 0xd9) || marker === 0x01) {
82
+ at += 2;
83
+ continue;
84
+ }
85
+ const length = u16be(b, at + 2);
86
+ if (length < 2)
87
+ return undefined;
88
+ at += 2 + length;
89
+ }
90
+ return undefined;
91
+ }
92
+ export function readImageHeaderDimensions(b) {
93
+ if (b.length < 10)
94
+ return undefined;
95
+ if (b[0] === 0x89 && b[1] === 0x50 && b[2] === 0x4e && b[3] === 0x47)
96
+ return b.length >= 24 ? { width: u32be(b, 16), height: u32be(b, 20) } : undefined;
97
+ if (b[0] === 0x47 && b[1] === 0x49 && b[2] === 0x46)
98
+ return { width: u16le(b, 6), height: u16le(b, 8) };
99
+ const frame = jpegFrameAt(b);
100
+ if (frame !== undefined)
101
+ return { height: u16be(b, frame + 5), width: u16be(b, frame + 7) };
102
+ if (b[0] === 0xff && b[1] === 0xd8)
103
+ return undefined;
104
+ if (b.length >= 30 && spells(b, 0, "RIFF") && spells(b, 8, "WEBP")) {
105
+ if (spells(b, 12, "VP8 "))
106
+ return { width: u16le(b, 26) & 0x3fff, height: u16le(b, 28) & 0x3fff };
107
+ if (spells(b, 12, "VP8L")) {
108
+ const bits = u32le(b, 21);
109
+ return { width: (bits & 0x3fff) + 1, height: ((bits >>> 14) & 0x3fff) + 1 };
110
+ }
111
+ if (spells(b, 12, "VP8X"))
112
+ return { width: u24le(b, 24) + 1, height: u24le(b, 27) + 1 };
113
+ }
114
+ return undefined;
25
115
  }
26
116
  export function pdfMagicMatches(bytes) {
27
117
  return bytes.length >= 5 && bytes[0] === 0x25 && bytes[1] === 0x50 && bytes[2] === 0x44 && bytes[3] === 0x46 && bytes[4] === 0x2d;
28
118
  }
29
119
  export const ADMITTED_IMAGE_MIME_TYPES = Object.freeze(["image/png", "image/jpeg", "image/gif", "image/webp"]);
30
- export function imageReadCap(downsampler) {
31
- return downsampler ? MAX_IMAGE_DOWNSAMPLE_INPUT_BYTES : MAX_IMAGE_READ_BYTES;
120
+ export function imageReadCap(processor) {
121
+ const { readBytes } = IMAGE_ADMISSION.hard;
122
+ return processor === "none" ? readBytes.withoutProcessor : readBytes.withProcessor;
32
123
  }
33
- export async function admitImageBytes(bytes, claimedMime, downsampler) {
124
+ export function unprocessedSizeClause(a) {
125
+ return a.reason === "dimensions_unreadable"
126
+ ? "it could not be processed and its header states no pixel size — convert it to PNG, JPEG, GIF, or WebP"
127
+ : `at ${a.width}x${a.height}px it is over the ${a.limit}x${a.limit}px limit and could not be shrunk — resize it to fit within ${a.limit}x${a.limit}px`;
128
+ }
129
+ export async function admitImageBytes(bytes, claimedMime, processor) {
34
130
  const rawBytes = bytes.byteLength;
35
131
  if (!ADMITTED_IMAGE_MIME_TYPES.includes(claimedMime))
36
132
  return { ok: false, reason: "mime_unsupported", rawBytes };
37
- const cap = imageReadCap(downsampler);
133
+ const cap = imageReadCap(processor);
38
134
  if (rawBytes > cap)
39
135
  return { ok: false, reason: "raw_too_large", rawBytes, cap };
40
136
  if (!imageMagicMatches(bytes, claimedMime))
41
137
  return { ok: false, reason: "magic_mismatch", rawBytes };
42
- let base64;
43
- let mimeType = claimedMime;
44
- let dimensions;
45
- if (downsampler) {
46
- const out = await downsampler(Buffer.from(bytes), claimedMime).catch(() => undefined);
47
- if (out) {
48
- base64 = out.base64;
49
- mimeType = out.mimeType;
50
- dimensions = out.dimensions;
51
- }
138
+ let shipped;
139
+ const memory = processor !== "none" ? producedBy(processor) : undefined;
140
+ const inputDigest = memory !== undefined ? digestOf(bytes) : undefined;
141
+ const known = memory !== undefined && inputDigest !== undefined && memory.has(inputDigest);
142
+ if (processor !== "none" && !known) {
143
+ const out = await Promise.resolve()
144
+ .then(() => processor(Buffer.from(bytes), claimedMime))
145
+ .catch(() => undefined);
146
+ const outBytes = out !== undefined ? Buffer.from(out.base64, "base64") : undefined;
147
+ const outMime = outBytes !== undefined ? sniffImageMime(outBytes) : undefined;
148
+ if (out !== undefined && outBytes !== undefined && outMime !== undefined)
149
+ shipped = { bytes: outBytes, base64: out.base64, mimeType: outMime, ...(out.dimensions !== undefined ? { dimensions: out.dimensions } : {}) };
52
150
  }
53
- base64 ??= Buffer.from(bytes).toString("base64");
54
- if (base64.length > MCP_IMAGE_MAX_BASE64)
151
+ const fromProcessor = shipped !== undefined;
152
+ shipped ??= { bytes, base64: Buffer.from(bytes).toString("base64"), mimeType: claimedMime };
153
+ const header = readImageHeaderDimensions(shipped.bytes);
154
+ if (header === undefined)
155
+ return { ok: false, reason: "dimensions_unreadable", rawBytes };
156
+ const limit = IMAGE_ADMISSION.hard.rejectEdge;
157
+ if (header.width > limit || header.height > limit)
158
+ return { ok: false, reason: "dimensions_too_large", rawBytes, width: header.width, height: header.height, limit };
159
+ const { base64, mimeType, dimensions } = shipped;
160
+ if (base64.length > IMAGE_ADMISSION.hard.imageBase64Chars)
55
161
  return { ok: false, reason: "base64_too_large", rawBytes, base64 };
56
162
  const resized = dimensions !== undefined &&
57
163
  dimensions.displayWidth > 0 &&
58
164
  dimensions.displayHeight > 0 &&
59
165
  (dimensions.originalWidth !== dimensions.displayWidth || dimensions.originalHeight !== dimensions.displayHeight);
166
+ if (memory !== undefined && (fromProcessor || known))
167
+ memory.add(fromProcessor ? digestOf(shipped.bytes) : inputDigest);
60
168
  return { ok: true, block: { type: "image", data: base64, mimeType }, originalSize: rawBytes, ...(dimensions !== undefined ? { dimensions } : {}), resized };
61
169
  }
170
+ const PRODUCED_KEPT = 256;
171
+ const produced = new WeakMap();
172
+ function producedBy(processor) {
173
+ let kept = produced.get(processor);
174
+ if (kept === undefined)
175
+ produced.set(processor, (kept = new Set()));
176
+ const set = kept;
177
+ return {
178
+ has: (digest) => set.has(digest),
179
+ add: (digest) => {
180
+ set.delete(digest);
181
+ set.add(digest);
182
+ if (set.size > PRODUCED_KEPT)
183
+ set.delete(set.values().next().value);
184
+ },
185
+ };
186
+ }
187
+ const digestOf = (bytes) => createHash("sha256").update(bytes).digest("base64");
188
+ export function sniffImageMime(bytes) {
189
+ return ADMITTED_IMAGE_MIME_TYPES.find((mime) => imageMagicMatches(bytes, mime));
190
+ }
62
191
  export const ADMITTED_DOCUMENT_MIME_TYPES = Object.freeze(["application/pdf"]);
63
192
  export function admitDocumentBytes(bytes, claimedMime) {
64
193
  const rawBytes = bytes.byteLength;
@@ -77,22 +206,29 @@ const REFUSAL_CLAUSE = {
77
206
  mime_unsupported: (r) => `${r.mimeType ?? "its media type"} is not a ${r.type} type the model accepts (${ADMITTED_FOR[r.type].join(", ")})`,
78
207
  raw_too_large: (r) => `its ${r.bytes} bytes exceed the ${r.limit}-byte cap`,
79
208
  magic_mismatch: (r) => `its ${r.bytes} bytes do not open with a valid ${r.mimeType ?? `${r.type}`} header`,
209
+ dimensions_unreadable: () => unprocessedSizeClause({ reason: "dimensions_unreadable" }),
210
+ dimensions_too_large: (r) => unprocessedSizeClause({ reason: "dimensions_too_large", width: r.width, height: r.height, limit: r.limit }),
80
211
  base64_too_large: (r) => `its base64 encoding exceeds the ${r.limit}-character provider limit (${r.bytes} bytes)`,
81
212
  };
82
213
  const placeholderOf = (toolName, r) => ({
83
214
  type: "text",
84
215
  text: `[${r.type} from the ${JSON.stringify(toolName)} tool not shown: ${REFUSAL_CLAUSE[r.reason](r)} (media admission: ${r.reason})]`,
85
216
  });
217
+ const MEDIA_BLOCK_TYPES = new Set(["image", "document"]);
218
+ export function claimedMediaType(block) {
219
+ const type = readMember(block, "type");
220
+ return MEDIA_BLOCK_TYPES.has(type) ? type : undefined;
221
+ }
86
222
  const claimsMedia = (block) => claimedMediaType(block) !== undefined;
87
- async function admitBlock(block) {
223
+ async function admitBlock(block, processor) {
88
224
  const type = claimedMediaType(block);
89
225
  if (type === undefined)
90
226
  return { block };
91
227
  const data = readMember(block, "data");
92
228
  const mime = readMember(block, "mimeType");
93
229
  const echo = mediaTypeEcho(mime);
94
- const refusal = (reason, bytes, limit) => ({
95
- refusal: { type, reason, bytes, ...(limit !== undefined ? { limit } : {}), ...(echo !== undefined ? { mimeType: echo } : {}) },
230
+ const refusal = (reason, bytes, limit, size) => ({
231
+ refusal: { type, reason, bytes, ...(limit !== undefined ? { limit } : {}), ...(size ?? {}), ...(echo !== undefined ? { mimeType: echo } : {}) },
96
232
  });
97
233
  if (typeof data !== "string")
98
234
  return refusal("undecodable", 0);
@@ -100,7 +236,7 @@ async function admitBlock(block) {
100
236
  try {
101
237
  const bytes = Buffer.from(data, "base64");
102
238
  const claimed = typeof mime === "string" ? mime : "";
103
- a = type === "image" ? await admitImageBytes(bytes, claimed, undefined) : admitDocumentBytes(bytes, claimed);
239
+ a = type === "image" ? await admitImageBytes(bytes, claimed, processor) : admitDocumentBytes(bytes, claimed);
104
240
  }
105
241
  catch {
106
242
  return refusal("undecodable", 0);
@@ -109,35 +245,54 @@ async function admitBlock(block) {
109
245
  return { block: a.block };
110
246
  if (a.reason === "raw_too_large")
111
247
  return refusal(a.reason, a.rawBytes, a.cap);
248
+ if (a.reason === "dimensions_too_large")
249
+ return refusal(a.reason, a.rawBytes, a.limit, { width: a.width, height: a.height });
112
250
  if (a.reason === "base64_too_large")
113
- return refusal(a.reason, a.rawBytes, MCP_IMAGE_MAX_BASE64);
251
+ return refusal(a.reason, a.rawBytes, IMAGE_ADMISSION.hard.imageBase64Chars);
114
252
  return refusal(a.reason, a.rawBytes);
115
253
  }
116
- export function admitToolResultMedia(content, toolName) {
117
- let blocks;
254
+ export function firstUnprocessedOverTarget(blocks, processor) {
255
+ if (processor !== "none")
256
+ return undefined;
257
+ for (const b of blocks) {
258
+ if (claimedMediaType(b) !== "image")
259
+ continue;
260
+ const data = readMember(b, "data");
261
+ if (typeof data !== "string")
262
+ continue;
263
+ const bytes = Buffer.byteLength(data, "base64");
264
+ if (bytes > IMAGE_ADMISSION.soft.targetBytes)
265
+ return bytes;
266
+ }
267
+ return undefined;
268
+ }
269
+ export function toolResultMediaBlocks(content) {
118
270
  try {
119
271
  if (!Array.isArray(content))
120
272
  return undefined;
121
- blocks = Array.from(content);
122
- if (!blocks.some(claimsMedia))
123
- return undefined;
273
+ const blocks = Array.from(content);
274
+ return blocks.some(claimsMedia) ? blocks : undefined;
124
275
  }
125
276
  catch {
126
277
  return undefined;
127
278
  }
128
- return (async () => {
129
- const refused = [];
130
- const out = [];
131
- for (const b of blocks) {
132
- const r = await admitBlock(b);
133
- if ("block" in r) {
134
- out.push(r.block);
135
- }
136
- else {
137
- refused.push(r.refusal);
138
- out.push(placeholderOf(toolName, r.refusal));
139
- }
279
+ }
280
+ export async function admitToolResultMediaBlocks(blocks, toolName, processor) {
281
+ const refused = [];
282
+ const out = [];
283
+ for (const b of blocks) {
284
+ const r = await admitBlock(b, processor);
285
+ if ("block" in r) {
286
+ out.push(r.block);
140
287
  }
141
- return { content: out, refused };
142
- })();
288
+ else {
289
+ refused.push(r.refusal);
290
+ out.push(placeholderOf(toolName, r.refusal));
291
+ }
292
+ }
293
+ return { content: out, refused };
294
+ }
295
+ export function admitToolResultMedia(content, toolName, processor) {
296
+ const blocks = toolResultMediaBlocks(content);
297
+ return blocks === undefined ? undefined : admitToolResultMediaBlocks(blocks, toolName, processor);
143
298
  }
@@ -1,51 +1,3 @@
1
- /**
2
- * Generic image downsample/resize pipeline (design/157 S3 — split out of `core/mcp.ts`, which historically
3
- * carried this alongside MCP-protocol plumbing even though the pipeline itself has no MCP dependency).
4
- * Two consumers share this ONE pipeline + ONE size yardstick: the MCP inline-image bound (`core/mcp.ts`
5
- * `boundedImageBlock`) and the Read tool's image branch (`tools/fs/index.ts`). `core/mcp.ts` re-exports
6
- * everything below (`export * from "./image-downsample.js"`) so existing importers (`tools/fs/index.ts`,
7
- * `core/types.ts`) needed no changes on this car.
8
- */
9
- /**
10
- * design/116 W5-1 — the max base64 size of ONE inline image (5MB). Value =
11
- * `API_IMAGE_MAX_BASE64_SIZE` (constants/apiLimits.ts:22, "5 * 1024 * 1024 // 5 MB" — the hard Anthropic API
12
- * limit on a base64 image block; CC resizes/compresses down to fit UNDER it, imageResizer.ts). An MCP server
13
- * returning a bigger image previously passed straight through = a context/API bomb.
14
- */
15
- export declare const MCP_IMAGE_MAX_BASE64: number;
16
- /**
17
- * 批③ image-pipeline — CC 2.1.x `constants/apiLimits.ts` values, shared by the MCP inline-image bound
18
- * AND the Read tool's image branch (tools/fs — internal consistency: ONE yardstick per limit). That other
19
- * consumers are the file tools (`tools/fs/fs-read.ts`'s image branch, plus `fs-pdf`/`fs-bash`), which IMPORT
20
- * {@link MCP_IMAGE_MAX_BASE64} / {@link IMAGE_TARGET_RAW_SIZE} from here (through core/mcp.js's re-export)
21
- * rather than re-deriving them — one limit, every consumer reading it, no drift.
22
- * - `IMAGE_TARGET_RAW_SIZE` (apiLimits.ts:29): raw-byte target that guarantees the base64 encoding stays
23
- * under {@link MCP_IMAGE_MAX_BASE64} (raw × 4/3 = base64 → 3.75MB raw = 5MB base64).
24
- * - `IMAGE_MAX_WIDTH/HEIGHT` (apiLimits.ts:42-43): client-side resize box. The API internally resizes
25
- * above 1568px anyway; 2000px preserves a little extra quality while bounding token burn (~3x for a
26
- * full-resolution screenshot vs the box).
27
- */
28
- export declare const IMAGE_TARGET_RAW_SIZE: number;
29
- export declare const IMAGE_MAX_WIDTH = 2000;
30
- export declare const IMAGE_MAX_HEIGHT = 2000;
31
- /**
32
- * design/116 W5-1 — bound an inline MCP image. HONEST DELTA vs CC: CC really resizes/downsamples an
33
- * oversized image with sharp (utils/imageResizer.ts `maybeResizeAndDownsampleImageBuffer`: ≤2000x2000px,
34
- * ≤3.75MB raw = 5MB base64, progressive JPEG/PNG quality ladder). Core deliberately takes NO image-processing
35
- * dependency (arch decision — sharp is a native module we won't force on every consumer), so instead of
36
- * resizing we BOUND: an image whose base64 exceeds {@link MCP_IMAGE_MAX_BASE64} is spilled to disk and
37
- * replaced by an explanatory text block with the size + path; a within-limit image passes through unchanged.
38
- */
39
- /**
40
- * Optional image-resize seam (design/116 review CONFIRM-1, 裁定 2026-07-02 加 seam 保体验): given an
41
- * over-limit image, return a smaller re-encoded one — or undefined when it can't. CC resizes with sharp
42
- * (imageResizer.ts: fit within 2000x2000, JPEG quality ladder) so the model still SEES a degraded image;
43
- * core must not hard-depend on a native image library, so the capability is injected (or auto-detected).
44
- */
45
- export type McpImageResizer = (base64: string, mimeType: string) => Promise<{
46
- base64: string;
47
- mimeType: string;
48
- } | undefined>;
49
1
  /**
50
2
  * 批③ image-pipeline — original vs displayed size of a processed image (CC `imageResizer.ts`
51
3
  * `ImageDimensions`). `display*` = what the model actually sees; the Read tool renders the CC coordinate-
@@ -65,10 +17,9 @@ export interface DownsampledImage {
65
17
  dimensions?: ImageDimensions;
66
18
  }
67
19
  /**
68
- * 批③ — buffer-level image downsampler shared by the MCP inline-image bound AND the Read tool's image
69
- * branch. Returns undefined when the input can't be processed (corrupt/unsupported) — the caller keeps
70
- * its non-sharp path (spill for MCP, original-bytes for Read). A within-limits image passes through
71
- * UNCHANGED (with dimensions when known) — pass-through is not a failure.
20
+ * An image processor: the bytes the admission checked, in; the bytes the model gets, out — or undefined when the input
21
+ * can't be processed (corrupt/unsupported), and the admission then judges the original bytes as they are. A
22
+ * within-target image passes through UNCHANGED (with dimensions when known) — pass-through is not a failure.
72
23
  */
73
24
  export type ImageDownsampler = (input: Buffer, mimeType: string) => Promise<DownsampledImage | undefined>;
74
25
  /** Minimal structural slice of the sharp API the pipeline uses (fresh instance per operation — CC note:
@@ -79,7 +30,9 @@ interface SharpOps {
79
30
  width?: number;
80
31
  height?: number;
81
32
  format?: string;
33
+ orientation?: number;
82
34
  }>;
35
+ rotate: () => SharpOps;
83
36
  resize: (w: number, h: number, o: {
84
37
  fit: "inside";
85
38
  withoutEnlargement: boolean;
@@ -91,29 +44,43 @@ interface SharpOps {
91
44
  compressionLevel: number;
92
45
  palette: boolean;
93
46
  }) => SharpOps;
47
+ flatten: (o: {
48
+ background: string;
49
+ }) => SharpOps;
94
50
  toBuffer: () => Promise<Buffer>;
95
51
  }
96
52
  /**
97
- * The CC downsample pipeline (imageResizer.ts `maybeResizeAndDownsampleImageBuffer`, called by
98
- * FileReadTool.ts:1097 `readImageWithTokenBudget`), ported over an injected sharp factory so the ladder
99
- * is unit-testable without the native dependency:
100
- * 1. fits already (raw ≤ 3.75MB AND ≤ 2000×2000) → pass through, dimensions attached;
101
- * 2. dims fit but bytes over → full-resolution compression first (PNG lossless/palette for PNGs, then
102
- * JPEG quality ladder 80/60/40/20) — preserves resolution when possible;
103
- * 3. dims over → constrain to the 2000×2000 box (aspect kept), then the same ladder on the resized
104
- * image if still over; last rung = ≤1000px wide JPEG q20 (returned without a further size check —
105
- * the caller's base64 gate stays the final arbiter, CC-identical shape);
106
- * 4. metadata without dimensions → JPEG q80 when over target, else pass through (CC branch).
107
- * Exported for tests (fake sharp factory); production entry = {@link sharpImageDownsampler}.
53
+ * The processor over an injected sharp factory (so both stages are unit-testable without the native dependency). Two
54
+ * stages, in the order of `VS` (cli309.js:262027), after a frame that asks to be shown turned is turned upright:
55
+ * 1. the frame ladder (CC `IGe`, called by FileReadTool `readImageWithTokenBudget`), toward `soft.frameEdge` and
56
+ * `soft.rawBytes`:
57
+ * a. fits already (raw ≤ rawBytes AND inside the frame) → pass through, dimensions attached;
58
+ * b. dims fit but bytes over → full-resolution compression first (PNG lossless/palette for PNGs, then
59
+ * JPEG quality ladder 80/60/40/20) — preserves resolution when possible;
60
+ * c. dims over → constrain to the frame (aspect kept), then the same ladder on the resized image if still over; last
61
+ * rung = ≤1000px wide JPEG q20;
62
+ * d. metadata without dimensions → JPEG q80 when over rawBytes, else pass through (CC branch);
63
+ * 2. the byte-target step ({@link toByteTarget}) when the ladder's bytes are over `soft.targetBytes`. A failure of this
64
+ * step keeps the ladder's bytes (CC: "passing through unbudgeted").
65
+ * An image already inside the frame and at or under the target passes both stages byte-identical, so a second
66
+ * admission of what the first one sent changes nothing. The caller's base64 gate stays the final arbiter.
108
67
  */
109
68
  export declare function createImageDownsampler(sharp: SharpFactory): ImageDownsampler;
69
+ /**
70
+ * Production processor factory: dynamic `import("sharp")`. sharp is an OPTIONAL native dependency — declared under
71
+ * `optionalDependencies`, never `dependencies` (arch decision, design/116 W5-1: core won't force a native module on
72
+ * every consumer; RB-213 made the optional-ness VISIBLE to package managers without changing the decision —
73
+ * `optionalDependencies` still installs best-effort and never fails the parent install if the native build fails). A
74
+ * turnkey deployment that has it available gets the CC experience automatically; without it this resolves to undefined.
75
+ */
110
76
  export declare function sharpImageDownsampler(): Promise<ImageDownsampler | undefined>;
77
+ /** The seat's value door (at `new Runner`): a processor, `false`, or absent — anything else is refused by name rather than read
78
+ * as "detect" or "none" (`config.invalid_argument`). */
79
+ export declare function checkedImageProcessorSeat(value: unknown, seat: string): void;
111
80
  /**
112
- * Default resizer factory: dynamic `import("sharp")` — a turnkey deployment with sharp installed gets the
113
- * CC experience automatically; without it this resolves to undefined and the spill path applies. Since
114
- * 批③ this is a thin base64 adapter over {@link sharpImageDownsampler} (single pipeline, CC ladder);
115
- * the contract is unchanged: undefined when sharp is missing, the input is corrupt, or even the lowest
116
- * ladder rung stays over the API limit.
81
+ * The one reading of the image processor seat (`RunnerDeps.imageProcessor`): a function is the processor; `false` is
82
+ * `"none"` (nothing is detected); absent detects sharp once per process ({@link sharpImageDownsampler}) and answers
83
+ * `"none"` when it does not resolve. Every carrier that admits an image reads its processor here.
117
84
  */
118
- export declare function sharpImageResizer(): Promise<McpImageResizer | undefined>;
85
+ export declare function resolveImageProcessor(seat: ImageDownsampler | false | undefined): Promise<ImageDownsampler | "none">;
119
86
  export {};