@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,76 +1,110 @@
1
- export const MCP_IMAGE_MAX_BASE64 = 5 * 1024 * 1024;
2
- export const IMAGE_TARGET_RAW_SIZE = (MCP_IMAGE_MAX_BASE64 * 3) / 4;
3
- export const IMAGE_MAX_WIDTH = 2000;
4
- export const IMAGE_MAX_HEIGHT = 2000;
1
+ import { IMAGE_ADMISSION } from "./image-admission.js";
2
+ import { describeRejectedValue } from "./tool-search-setting.js";
3
+ const toJpeg = (ops, quality) => ops.flatten({ background: "#ffffff" }).jpeg({ quality });
4
+ async function toByteTarget(sharp, input, target) {
5
+ const jpeg = (quality) => toJpeg(sharp(input.buf), quality).toBuffer();
6
+ const asJpeg = (buf) => ({ buf, mimeType: "image/jpeg", ...(input.dimensions !== undefined ? { dimensions: input.dimensions } : {}) });
7
+ let smallest = input;
8
+ let hi = 90;
9
+ if (input.mimeType !== "image/jpeg") {
10
+ const q90 = await jpeg(90);
11
+ if (q90.length < smallest.buf.length)
12
+ smallest = asJpeg(q90);
13
+ if (q90.length <= target)
14
+ return asJpeg(q90);
15
+ hi = 89;
16
+ }
17
+ let lo = 1;
18
+ let best;
19
+ for (let probe = 0; probe < 5; probe++) {
20
+ const quality = Math.floor((lo + hi) / 2);
21
+ const buf = await jpeg(quality);
22
+ if (buf.length < smallest.buf.length)
23
+ smallest = asJpeg(buf);
24
+ if (buf.length <= target) {
25
+ best = buf;
26
+ lo = quality + 1;
27
+ }
28
+ else
29
+ hi = quality - 1;
30
+ if (lo > hi)
31
+ break;
32
+ }
33
+ return best !== undefined ? asJpeg(best) : smallest;
34
+ }
5
35
  export function createImageDownsampler(sharp) {
6
36
  const BOX = { fit: "inside", withoutEnlargement: true };
7
- return async (input, mimeType) => {
8
- if (input.length === 0)
9
- return undefined;
10
- try {
11
- const meta = await sharp(input).metadata();
12
- const fmt = meta.format === "jpg" ? "jpeg" : meta.format;
13
- const passMime = fmt ? `image/${fmt}` : mimeType;
14
- const originalSize = input.length;
15
- if (!meta.width || !meta.height) {
16
- if (originalSize > IMAGE_TARGET_RAW_SIZE) {
17
- const buf = await sharp(input).jpeg({ quality: 80 }).toBuffer();
18
- return { base64: buf.toString("base64"), mimeType: "image/jpeg" };
19
- }
20
- return { base64: input.toString("base64"), mimeType: passMime };
21
- }
22
- const originalWidth = meta.width;
23
- const originalHeight = meta.height;
24
- let width = originalWidth;
25
- let height = originalHeight;
26
- const dims = (dw, dh) => ({ originalWidth, originalHeight, displayWidth: dw, displayHeight: dh });
27
- if (originalSize <= IMAGE_TARGET_RAW_SIZE && width <= IMAGE_MAX_WIDTH && height <= IMAGE_MAX_HEIGHT) {
28
- return { base64: input.toString("base64"), mimeType: passMime, dimensions: dims(width, height) };
29
- }
30
- const needsDimensionResize = width > IMAGE_MAX_WIDTH || height > IMAGE_MAX_HEIGHT;
31
- const isPng = fmt === "png";
32
- if (!needsDimensionResize) {
33
- if (isPng) {
34
- const png = await sharp(input).png({ compressionLevel: 9, palette: true }).toBuffer();
35
- if (png.length <= IMAGE_TARGET_RAW_SIZE)
36
- return { base64: png.toString("base64"), mimeType: "image/png", dimensions: dims(width, height) };
37
- }
38
- for (const quality of [80, 60, 40, 20]) {
39
- const buf = await sharp(input).jpeg({ quality }).toBuffer();
40
- if (buf.length <= IMAGE_TARGET_RAW_SIZE)
41
- return { base64: buf.toString("base64"), mimeType: "image/jpeg", dimensions: dims(width, height) };
42
- }
43
- }
44
- if (width > IMAGE_MAX_WIDTH) {
45
- height = Math.round((height * IMAGE_MAX_WIDTH) / width);
46
- width = IMAGE_MAX_WIDTH;
47
- }
48
- if (height > IMAGE_MAX_HEIGHT) {
49
- width = Math.round((width * IMAGE_MAX_HEIGHT) / height);
50
- height = IMAGE_MAX_HEIGHT;
51
- }
52
- const resized = await sharp(input).resize(width, height, BOX).toBuffer();
53
- if (resized.length <= IMAGE_TARGET_RAW_SIZE) {
54
- return { base64: resized.toString("base64"), mimeType: passMime, dimensions: dims(width, height) };
55
- }
37
+ const { frameEdge, rawBytes, targetBytes } = IMAGE_ADMISSION.soft;
38
+ const upright = async (input) => ((await sharp(input).metadata()).orientation ?? 1) >= 2 ? sharp(input).rotate().toBuffer() : input;
39
+ const ladder = async (input, mimeType) => {
40
+ const meta = await sharp(input).metadata();
41
+ const fmt = meta.format === "jpg" ? "jpeg" : meta.format;
42
+ const passMime = fmt ? `image/${fmt}` : mimeType;
43
+ const originalSize = input.length;
44
+ if (!meta.width || !meta.height) {
45
+ if (originalSize > rawBytes)
46
+ return { buf: await toJpeg(sharp(input), 80).toBuffer(), mimeType: "image/jpeg" };
47
+ return { buf: input, mimeType: passMime };
48
+ }
49
+ const originalWidth = meta.width;
50
+ const originalHeight = meta.height;
51
+ let width = originalWidth;
52
+ let height = originalHeight;
53
+ const dims = (dw, dh) => ({ originalWidth, originalHeight, displayWidth: dw, displayHeight: dh });
54
+ if (originalSize <= rawBytes && width <= frameEdge && height <= frameEdge)
55
+ return { buf: input, mimeType: passMime, dimensions: dims(width, height) };
56
+ const needsDimensionResize = width > frameEdge || height > frameEdge;
57
+ const isPng = fmt === "png";
58
+ if (!needsDimensionResize) {
56
59
  if (isPng) {
57
- const png = await sharp(input).resize(width, height, BOX).png({ compressionLevel: 9, palette: true }).toBuffer();
58
- if (png.length <= IMAGE_TARGET_RAW_SIZE)
59
- return { base64: png.toString("base64"), mimeType: "image/png", dimensions: dims(width, height) };
60
+ const png = await sharp(input).png({ compressionLevel: 9, palette: true }).toBuffer();
61
+ if (png.length <= rawBytes)
62
+ return { buf: png, mimeType: "image/png", dimensions: dims(width, height) };
60
63
  }
61
64
  for (const quality of [80, 60, 40, 20]) {
62
- const buf = await sharp(input).resize(width, height, BOX).jpeg({ quality }).toBuffer();
63
- if (buf.length <= IMAGE_TARGET_RAW_SIZE)
64
- return { base64: buf.toString("base64"), mimeType: "image/jpeg", dimensions: dims(width, height) };
65
+ const buf = await toJpeg(sharp(input), quality).toBuffer();
66
+ if (buf.length <= rawBytes)
67
+ return { buf, mimeType: "image/jpeg", dimensions: dims(width, height) };
65
68
  }
66
- const smallerWidth = Math.min(width, 1000);
67
- const smallerHeight = Math.round((height * smallerWidth) / Math.max(width, 1));
68
- const last = await sharp(input).resize(smallerWidth, smallerHeight, BOX).jpeg({ quality: 20 }).toBuffer();
69
- return { base64: last.toString("base64"), mimeType: "image/jpeg", dimensions: dims(smallerWidth, smallerHeight) };
69
+ }
70
+ if (width > frameEdge) {
71
+ height = Math.round((height * frameEdge) / width);
72
+ width = frameEdge;
73
+ }
74
+ if (height > frameEdge) {
75
+ width = Math.round((width * frameEdge) / height);
76
+ height = frameEdge;
77
+ }
78
+ const resized = await sharp(input).resize(width, height, BOX).toBuffer();
79
+ if (resized.length <= rawBytes)
80
+ return { buf: resized, mimeType: passMime, dimensions: dims(width, height) };
81
+ if (isPng) {
82
+ const png = await sharp(input).resize(width, height, BOX).png({ compressionLevel: 9, palette: true }).toBuffer();
83
+ if (png.length <= rawBytes)
84
+ return { buf: png, mimeType: "image/png", dimensions: dims(width, height) };
85
+ }
86
+ for (const quality of [80, 60, 40, 20]) {
87
+ const buf = await toJpeg(sharp(input).resize(width, height, BOX), quality).toBuffer();
88
+ if (buf.length <= rawBytes)
89
+ return { buf, mimeType: "image/jpeg", dimensions: dims(width, height) };
90
+ }
91
+ const smallerWidth = Math.min(width, 1000);
92
+ const smallerHeight = Math.round((height * smallerWidth) / Math.max(width, 1));
93
+ const last = await toJpeg(sharp(input).resize(smallerWidth, smallerHeight, BOX), 20).toBuffer();
94
+ return { buf: last, mimeType: "image/jpeg", dimensions: dims(smallerWidth, smallerHeight) };
95
+ };
96
+ return async (input, mimeType) => {
97
+ if (input.length === 0)
98
+ return undefined;
99
+ let framed;
100
+ try {
101
+ framed = await ladder(await upright(input), mimeType);
70
102
  }
71
103
  catch {
72
104
  return undefined;
73
105
  }
106
+ const out = framed.buf.length > targetBytes ? await toByteTarget(sharp, framed, targetBytes).catch(() => framed) : framed;
107
+ return { base64: out.buf.toString("base64"), mimeType: out.mimeType, ...(out.dimensions !== undefined ? { dimensions: out.dimensions } : {}) };
74
108
  };
75
109
  }
76
110
  const SHARP_LIMIT_INPUT_PIXELS = 100_000_000;
@@ -84,14 +118,18 @@ export async function sharpImageDownsampler() {
84
118
  return undefined;
85
119
  }
86
120
  }
87
- export async function sharpImageResizer() {
88
- const down = await sharpImageDownsampler();
89
- if (!down)
90
- return undefined;
91
- return async (base64, mimeType) => {
92
- const out = await down(Buffer.from(base64, "base64"), mimeType).catch(() => undefined);
93
- if (!out || out.base64.length > MCP_IMAGE_MAX_BASE64)
94
- return undefined;
95
- return { base64: out.base64, mimeType: out.mimeType };
96
- };
121
+ export function checkedImageProcessorSeat(value, seat) {
122
+ if (value === undefined || value === false || typeof value === "function")
123
+ return;
124
+ const e = new Error(`${seat} ${describeRejectedValue(value)} is not an image processor — expected an ImageDownsampler function, or false for none, or omit it to detect sharp`);
125
+ e.code = "config.invalid_argument";
126
+ throw e;
127
+ }
128
+ let detected;
129
+ export async function resolveImageProcessor(seat) {
130
+ if (typeof seat === "function")
131
+ return seat;
132
+ if (seat === false)
133
+ return "none";
134
+ return (await (detected ??= sharpImageDownsampler())) ?? "none";
97
135
  }
@@ -0,0 +1,36 @@
1
+ import type { RunInternals } from "./runner/contracts.js";
2
+ export declare const INPUT_AUTHORS: readonly ["operator", "parent_model", "workflow", "peer", "observer", "engine"];
3
+ export type InputAuthor = (typeof INPUT_AUTHORS)[number];
4
+ /** Membership test for {@link InputAuthor}. */
5
+ export declare function isInputAuthor(v: unknown): v is InputAuthor;
6
+ /** An author as read: a member of the set, or `unknown` for anything else. */
7
+ export type InputAuthorReading = InputAuthor | "unknown";
8
+ /** The one reader: a member reads as itself, anything else (`undefined` included) as `unknown`. */
9
+ export declare function readInputAuthor(raw: unknown): InputAuthorReading;
10
+ /** THE predicate: does this input count as the operator's — screened by `classic.UserPromptSubmit`, carried across a pause, on
11
+ * the person's undelivered-input account? An unreadable word does (a filter's safe side); the five other words do not. */
12
+ export declare function countsAsOperator(reading: InputAuthorReading): boolean;
13
+ /**
14
+ * The objective's author on a leg, from the trusted channel's word (`RunInternals.objectiveAuthor`): absent is the public
15
+ * entry's own mint, `operator` — the host that called `runTask` wrote the objective or relays the person who did; a member is
16
+ * itself; anything else is `unknown`, screened like the operator's, and its sentence is handed to `onUnreadable` (the caller
17
+ * reports it once).
18
+ */
19
+ export declare function objectiveAuthorOf(declared: unknown, onUnreadable: (error: Error) => void): InputAuthorReading;
20
+ /** The trusted channel of a recipe's continuation leg — the one mint of `engine`: a fresh shallow copy of the internals the leg rides
21
+ * otherwise, its objective the recipe's own words (the caller's request rode the recipe's first leg). A composition whose later legs
22
+ * re-run the caller's objective (a cascade's rungs) does not call it. */
23
+ export declare function recipeContinuationLeg(internals: RunInternals | undefined): RunInternals;
24
+ /**
25
+ * The engine's own relay into a running stream's steer lane, under the author it states. The public `TaskStream.steer` mints
26
+ * `operator` on every call; this seat is how the engine hands a stream an input someone else wrote (an observer's report). It
27
+ * lives on the stream object the Runner minted — registered here, never on the package face — so no caller can name an author.
28
+ */
29
+ export type AuthoredSteer = (author: InputAuthor, text: string) => Promise<void>;
30
+ /** Register the authored steer of a stream the Runner minted (the driver calls this once per stream). */
31
+ export declare function bindAuthoredSteer(stream: object, steer: AuthoredSteer): void;
32
+ /** The authored steer of a stream the Runner minted; `undefined` for any other object. */
33
+ export declare function authoredSteerOf(stream: object): AuthoredSteer | undefined;
34
+ /** The terminal account's sentence for inputs of other authors a run accepted and never delivered: they are dropped, never
35
+ * carried across a pause and never counted as the person's (the caller hands it to `onError` once, `phase: "degraded"`). */
36
+ export declare function droppedInputsDisclosure(authors: readonly InputAuthor[]): Error;
@@ -0,0 +1,39 @@
1
+ import { describeRejectedValue } from "./tool-search-setting.js";
2
+ export const INPUT_AUTHORS = Object.freeze(["operator", "parent_model", "workflow", "peer", "observer", "engine"]);
3
+ const INPUT_AUTHOR_SET = new Set(INPUT_AUTHORS);
4
+ export function isInputAuthor(v) {
5
+ return INPUT_AUTHOR_SET.has(v);
6
+ }
7
+ export function readInputAuthor(raw) {
8
+ return isInputAuthor(raw) ? raw : "unknown";
9
+ }
10
+ const COUNTS_AS_OPERATOR = Object.freeze({ operator: true, parent_model: false, workflow: false, peer: false, observer: false, engine: false });
11
+ export function countsAsOperator(reading) {
12
+ return reading === "unknown" || COUNTS_AS_OPERATOR[reading];
13
+ }
14
+ export function objectiveAuthorOf(declared, onUnreadable) {
15
+ if (declared === undefined)
16
+ return "operator";
17
+ const reading = readInputAuthor(declared);
18
+ if (reading === "unknown") {
19
+ onUnreadable(new Error(`RunInternals.objectiveAuthor ${describeRejectedValue(declared)} is not an input author (${INPUT_AUTHORS.join(" / ")}) — the objective is screened as the operator's`));
20
+ }
21
+ return reading;
22
+ }
23
+ export function recipeContinuationLeg(internals) {
24
+ return { ...internals, objectiveAuthor: "engine" };
25
+ }
26
+ const authoredSteers = new WeakMap();
27
+ export function bindAuthoredSteer(stream, steer) {
28
+ authoredSteers.set(stream, steer);
29
+ }
30
+ export function authoredSteerOf(stream) {
31
+ return authoredSteers.get(stream);
32
+ }
33
+ export function droppedInputsDisclosure(authors) {
34
+ const counts = new Map();
35
+ for (const a of authors)
36
+ counts.set(a, (counts.get(a) ?? 0) + 1);
37
+ const named = [...counts].map(([a, n]) => `${n} from ${a}`).join(", ");
38
+ return new Error(`the run ended with ${authors.length} accepted input(s) it never delivered that are not the operator's (${named}): they are dropped — only an operator's input is carried across a pause or counted as the person's undelivered input`);
39
+ }
@@ -0,0 +1,21 @@
1
+ /** The integers an option takes, both ends included. */
2
+ export interface IntegerRange {
3
+ readonly min: number;
4
+ readonly max: number;
5
+ }
6
+ /** Every whole number a double holds exactly, from 0: the range of a count or a size. */
7
+ export declare const NON_NEGATIVE_SAFE_INTEGER: IntegerRange;
8
+ /** The milliseconds an interval timer takes: `1..{@link MAX_TIMER_DELAY_MS}`. Node reads a zero, a negative, a non-number or a longer
9
+ * delay as 1 ms and truncates a fractional one — an interval set to a 1 ms delay runs back to back — so an interval option refuses every value outside it. */
10
+ export declare const TIMER_DELAY_MS: IntegerRange;
11
+ /**
12
+ * The ONE reading of a whole-number option of a constructor: absent is the option's own default (`undefined`), a number that is an
13
+ * integer inside `range` is itself, and anything else — a fractional, an infinite, a NaN, an out-of-range number, a value that is no
14
+ * number — refuses (`config.invalid_argument`) rather than being read as "off" or as a neighbouring value. A number is spelled in the
15
+ * sentence; any other value is named by its type only, so a refusal never repeats text the caller handed over.
16
+ *
17
+ * @param name the option as the refusal names it (`Owner.option`)
18
+ * @param unit what the number counts (`milliseconds`, `characters`)
19
+ * @param absent what omitting the option means, as the sentence's way out
20
+ */
21
+ export declare function readIntegerOption(name: string, value: unknown, range: IntegerRange, unit: string, absent: string): number | undefined;
@@ -0,0 +1,13 @@
1
+ import { MAX_TIMER_DELAY_MS } from "../brain/timeout.js";
2
+ import { receiptRefusal } from "./own-property-receipt.js";
3
+ import { describeRejectedValue } from "./tool-search-setting.js";
4
+ export const NON_NEGATIVE_SAFE_INTEGER = Object.freeze({ min: 0, max: Number.MAX_SAFE_INTEGER });
5
+ export const TIMER_DELAY_MS = Object.freeze({ min: 1, max: MAX_TIMER_DELAY_MS });
6
+ export function readIntegerOption(name, value, range, unit, absent) {
7
+ if (value === undefined)
8
+ return undefined;
9
+ if (typeof value === "number" && Number.isInteger(value) && value >= range.min && value <= range.max)
10
+ return value;
11
+ const got = typeof value === "number" ? describeRejectedValue(value) : `a ${value === null ? "null" : typeof value}`;
12
+ throw receiptRefusal(`${name} must be a whole number of ${unit} from ${range.min} to ${range.max} (got ${got}) — omit it for ${absent}`);
13
+ }
@@ -0,0 +1,62 @@
1
+ /**
2
+ * A leg's two identity readings, as pure functions with no runtime imports — so a store's projection reads them exactly as
3
+ * the prepare mint and the stations do (one predicate each, never a second spelling at a reader that cannot reach the
4
+ * mods layer).
5
+ */
6
+ import type { HookInvocationIdentity } from "./hooks.js";
7
+ import type { AskSourceIdentity } from "./tool-policy.js";
8
+ /**
9
+ * The id a delegated leg's events carry as `agentId`: the leg's task id ({@link legTaskIdOf}) — for a background child, the
10
+ * registry task id its spawner registered it under (the string its row, launch card, notifications, `TaskStop` and
11
+ * `SendMessage` use); a foreground child has no row, so it is its session id. A top-level leg carries none. It reads two facts of
12
+ * the leg's identity, so a face minted before the leg's hook envelope (the ask source) asks it with the same two, and a parked
13
+ * row's summary asks it with the two the row records.
14
+ */
15
+ export declare function agentIdOf(identity: Pick<HookInvocationIdentity, "taskId" | "isDelegatedChild"> | undefined): string | undefined;
16
+ /** A leg's task id — the row a delegation lane runs it as (`internals.rowTaskId`), else its host's `spec.taskId`, else its
17
+ * session id. Minted once at prepare (`Prepared.taskId`); a reader before prepare asks this same function (the resume screen;
18
+ * the throw backstop, which has no session yet). The session id is the leg's transcript address. */
19
+ export declare function legTaskIdOf(spec: {
20
+ readonly taskId?: string | undefined;
21
+ }, internals: {
22
+ readonly rowTaskId?: string | undefined;
23
+ } | undefined, sessionId: string): string;
24
+ export declare function legTaskIdOf(spec: {
25
+ readonly taskId?: string | undefined;
26
+ }, internals: {
27
+ readonly rowTaskId?: string | undefined;
28
+ } | undefined, sessionId: string | undefined): string | undefined;
29
+ /** The facts a leg's ask source is minted from — all the leg's own, read once its session and task id are minted. */
30
+ export interface AskSourceFacts {
31
+ /** The leg's end-user principal (its spec's). */
32
+ readonly principal: string | undefined;
33
+ /** The leg's session id: the conversation every ask of the leg is raised in. */
34
+ readonly sessionId: string;
35
+ /** The leg's one task id ({@link legTaskIdOf}, as minted at prepare). */
36
+ readonly taskId: string;
37
+ /** The leg's effective delegation fact — forks included, the checkpoint's record on a deps-only resume. */
38
+ readonly isDelegatedChild: boolean;
39
+ /** The leg's trusted internals: the parent link and the display names. */
40
+ readonly internals: {
41
+ readonly parentTaskId?: string | undefined;
42
+ readonly explicitAgentName?: string | undefined;
43
+ readonly agentName?: string | undefined;
44
+ } | undefined;
45
+ }
46
+ /**
47
+ * The leg's ask source, minted ONCE per leg and read by every face that names the issuing leg: the four `resolveAsk`
48
+ * construction sites (the main gate, both inherited wrapper arms, the approved-edit re-ask) spread it, the question tool and
49
+ * the gate's question routing project it, and the approval and plan_review parks stamp its session onto the row — so the
50
+ * explicit "from a background agent" discriminator can never be dropped on one leg, and the same leg is never named two ways.
51
+ * Every member is a fact of THIS leg's own prepare (an inherited ask fires in the child's gate): `internals` never rides a
52
+ * TaskSpec, so a worker cannot self-declare or suppress them.
53
+ *
54
+ * - `sourceSessionId` — the leg's session: the conversation, never a task.
55
+ * - `agentId` — {@link agentIdOf} over the leg's task id and delegation fact: present exactly on a delegated child.
56
+ * - `fromSubagent` — the attribution discriminator: trusted `parentTaskId` presence (a directly-started workflow's agent has
57
+ * none, so it carries `agentId` without it).
58
+ * - `isDelegatedChild` — the refusal posture: the RAW delegation fact, forks included (a fork's interaction contract is
59
+ * one-shot — "no waiting for the user" — so a stop-and-wait refusal would ask it the impossible), so `resolveAsk`'s human
60
+ * refusal texts speak the right posture (parent thread: stop and wait for the user; delegated child: adapt or report).
61
+ */
62
+ export declare function mintAskSourceIdentity(leg: AskSourceFacts): AskSourceIdentity;
@@ -0,0 +1,18 @@
1
+ export function agentIdOf(identity) {
2
+ return identity?.isDelegatedChild === true ? identity.taskId : undefined;
3
+ }
4
+ export function legTaskIdOf(spec, internals, sessionId) {
5
+ return internals?.rowTaskId ?? spec.taskId ?? sessionId;
6
+ }
7
+ export function mintAskSourceIdentity(leg) {
8
+ const agentId = agentIdOf({ taskId: leg.taskId, isDelegatedChild: leg.isDelegatedChild });
9
+ const sourceAgentName = leg.internals?.explicitAgentName ?? leg.internals?.agentName;
10
+ return Object.freeze({
11
+ principal: leg.principal,
12
+ sourceSessionId: leg.sessionId,
13
+ ...(agentId !== undefined ? { agentId } : {}),
14
+ ...(leg.internals?.parentTaskId !== undefined ? { fromSubagent: true } : {}),
15
+ ...(sourceAgentName !== undefined ? { sourceAgentName } : {}),
16
+ ...(leg.isDelegatedChild ? { isDelegatedChild: true } : {}),
17
+ });
18
+ }
@@ -43,7 +43,7 @@ export interface LockedPreflight {
43
43
  /** The validated lock set (empty when the deployment declares none). */
44
44
  lockedKeys: ReadonlySet<LockedKey>;
45
45
  /** Effective MCP server list for this task: a validated, frozen SNAPSHOT of `spec.mcp` when the
46
- * key is unlocked (see {@link snapshotAndValidateMcpEntries} — the content-class and `toolAxes` declarations
46
+ * key is unlocked (the receipt {@link receivePeerDeclarations}, judged by `validatedMcpEntries` — the content-class and `toolAxes` declarations
47
47
  * are read once and judged here, so no mint site downstream can be handed a different value than the door
48
48
  * approved); with `mcp` locked a spec-supplied value has already been refused, so this is always
49
49
  * `undefined` (core has no deployment-level MCP seat — a locked deployment mounts no
@@ -201,7 +201,23 @@ export declare function judgeEntrySessionMetaKey(copy: McpServerSpec): {
201
201
  code: string;
202
202
  };
203
203
  };
204
- /** Everything a snapshot MCP entry declares beyond its plain data, judged: its `toolAxes` ({@link judgeEntryToolAxes}), its `toolFaces` ({@link judgeEntryToolFaces}), its `sessionMetaKey` ({@link judgeEntrySessionMetaKey}). */
204
+ /**
205
+ * The host-transport question for ONE snapshot MCP entry: a `{ kind: "host" }` transport carries no member beyond its kind (its host seat
206
+ * carries its own pieces — a reference, a principal header, a command or a url would be declared and never in force), and its server
207
+ * cannot opt in to `elicitation` (the server behind a host's pipe is the host's own code: a question it has for the user goes through the
208
+ * host's own interface, and the engine advertises no elicitation for it). Either refuses under
209
+ * `config.invalid_argument`, naming the server and the member. Any other entry is unchanged.
210
+ */
211
+ export declare function judgeEntryHostTransport(copy: McpServerSpec): {
212
+ ok: true;
213
+ entry: McpServerSpec;
214
+ } | {
215
+ ok: false;
216
+ error: Error & {
217
+ code: string;
218
+ };
219
+ };
220
+ /** Everything a snapshot MCP entry declares beyond its plain data, judged: its `toolAxes` ({@link judgeEntryToolAxes}), its `toolFaces` ({@link judgeEntryToolFaces}), its `sessionMetaKey` ({@link judgeEntrySessionMetaKey}), its host transport ({@link judgeEntryHostTransport}). */
205
221
  export declare function judgeMcpEntryDeclarations(copy: McpServerSpec): {
206
222
  ok: true;
207
223
  entry: McpServerSpec;
@@ -211,6 +227,42 @@ export declare function judgeMcpEntryDeclarations(copy: McpServerSpec): {
211
227
  code: string;
212
228
  };
213
229
  };
230
+ /** One received thing: what the receipt read, or the refusal it raised — kept, raised by the door where it would have been raised. */
231
+ export type Received<T> = {
232
+ readonly read: T;
233
+ } | {
234
+ readonly refused: unknown;
235
+ };
236
+ /**
237
+ * What the door receives of a task, read once: the deployment's lock set, then the declared MCP servers and A2A peers — each list read
238
+ * once, each entry copied (frozen plain data) or refused on its own (the door raises the refusals in the order it judges entries). A list
239
+ * is absent when the task declares none, when its key is locked (the door refuses a locked list without reading it), or when the lock
240
+ * declaration was refused (nothing past it is read). Taken where the engine takes the spec ({@link receivePeerDeclarations}).
241
+ */
242
+ export interface ReceivedPeerDeclarations {
243
+ readonly locks: Received<ReadonlySet<LockedKey>>;
244
+ readonly mcp?: Received<readonly Received<McpServerSpec>[]>;
245
+ readonly a2a?: Received<readonly Received<A2aServerSpec>[]>;
246
+ }
247
+ /**
248
+ * The door's receipt — the lock set, `spec.mcp`, `spec.a2a` — taken once at the moment the engine takes the spec
249
+ * (`Runner.runTaskStream`): the leg holds the references this copy names from then on (peer-seat.ts) and its door judges this same
250
+ * copy ({@link preflightLockedConfig}), so what a leg holds and what it dials are one read. Never throws.
251
+ */
252
+ export declare function receivePeerDeclarations(spec: Pick<TaskSpec, "mcp" | "a2a">, deps: Pick<RunnerDeps, "lockedConfig">): ReceivedPeerDeclarations;
253
+ /** The copies a receipt holds, as a keeper's declarations (a refused entry names nothing: the door refuses its leg before anything is dialled). */
254
+ export declare function receivedDeclarations(receipt: ReceivedPeerDeclarations): {
255
+ readonly mcp?: readonly McpServerSpec[];
256
+ readonly a2a?: readonly A2aServerSpec[];
257
+ };
258
+ /**
259
+ * The door's MCP half over one declared list, in one call: the list read once ({@link declaredEntriesOf}), each server snapshotted to frozen
260
+ * plain data ({@link snapshotMcpEntries}), its content class and its per-tool declarations judged ({@link validatedMcpEntries}) — a server
261
+ * whose declaration does not fit refuses the whole list. The same steps the task's own list takes (received when the engine takes the spec,
262
+ * {@link receivePeerDeclarations}, judged at its prepare), for a list received elsewhere: an agent definition's `AgentDefinition.mcp` where
263
+ * the definition is received (`where` names that field in the list-level sentence; every per-server sentence is the same).
264
+ */
265
+ export declare function snapshotAndValidateMcpEntries(declared: unknown, where?: string): McpServerSpec[];
214
266
  /**
215
267
  * The single preflight resolver: validate the lock declaration, refuse a spec that tries to occupy
216
268
  * a locked slot (`config.locked_key`, two-state — the whole prepare is rejected, nothing is
@@ -219,7 +271,7 @@ export declare function judgeMcpEntryDeclarations(copy: McpServerSpec): {
219
271
  * screen calls this same function (`enter` naming each refusal's seat) and hands the leg the frozen
220
272
  * entries it judged, so the leg's prepare judges engine-owned plain data and dials what was judged.
221
273
  */
222
- export declare function preflightLockedConfig(spec: Pick<TaskSpec, "mcp" | "a2a" | "toolPolicy" | "basePolicyForResumeEdit">, deps: RunnerDeps, enter?: ConfigDoorEntry): LockedPreflight;
274
+ export declare function preflightLockedConfig(spec: Pick<TaskSpec, "mcp" | "a2a" | "toolPolicy" | "basePolicyForResumeEdit">, deps: RunnerDeps, enter?: ConfigDoorEntry, receipt?: ReceivedPeerDeclarations): LockedPreflight;
223
275
  /**
224
276
  * The two caller policies a prepare resolves to: the task's own seat over the deployment's, or the deployment's alone
225
277
  * under a `toolPolicy` lock — one resolution, read by the preflight above (which a resume enters before its claim).