@sema-agent/core 7.58.0 → 7.60.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 (519) hide show
  1. package/CHANGELOG.md +1340 -0
  2. package/README.md +6 -4
  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 +2 -1
  6. package/dist/agents/agent-transcript-tool.js +3 -1
  7. package/dist/agents/cc-peer-directory.js +8 -8
  8. package/dist/agents/child-model-seat.d.ts +4 -2
  9. package/dist/agents/child-model-seat.js +9 -4
  10. package/dist/agents/cumulative-stats.js +0 -1
  11. package/dist/agents/inherited-tool-pool.d.ts +26 -1
  12. package/dist/agents/inherited-tool-pool.js +22 -0
  13. package/dist/agents/peer-directory.d.ts +9 -0
  14. package/dist/agents/peer-directory.js +6 -2
  15. package/dist/agents/retain-ledger.d.ts +11 -1
  16. package/dist/agents/retain-ledger.js +13 -2
  17. package/dist/agents/roster-store.d.ts +1 -1
  18. package/dist/agents/roster-store.js +3 -1
  19. package/dist/agents/send-message-tool.d.ts +8 -19
  20. package/dist/agents/send-message-tool.js +32 -50
  21. package/dist/agents/subagent.d.ts +51 -17
  22. package/dist/agents/subagent.js +150 -112
  23. package/dist/agents/tool-filter.d.ts +1 -3
  24. package/dist/agents/tool-filter.js +4 -12
  25. package/dist/bench/metrics.d.ts +3 -5
  26. package/dist/bench/metrics.js +0 -1
  27. package/dist/brain/anthropic.js +161 -45
  28. package/dist/brain/degrading.js +3 -1
  29. package/dist/brain/errors.d.ts +9 -3
  30. package/dist/brain/errors.js +7 -1
  31. package/dist/brain/failover.js +2 -1
  32. package/dist/brain/open-responses.js +3 -3
  33. package/dist/brain/openai.js +103 -53
  34. package/dist/brain/provider-dialect.d.ts +11 -0
  35. package/dist/brain/provider-dialect.js +5 -2
  36. package/dist/brain/reasoning-request.js +5 -4
  37. package/dist/brain/reasoning.d.ts +19 -0
  38. package/dist/brain/reasoning.js +17 -2
  39. package/dist/brain/request-route.d.ts +4 -1
  40. package/dist/brain/request-route.js +4 -1
  41. package/dist/brain/route-adjudicator.d.ts +84 -18
  42. package/dist/brain/route-adjudicator.js +90 -22
  43. package/dist/brain/route-conformance.js +1 -1
  44. package/dist/brain/status-sink.d.ts +7 -1
  45. package/dist/brain/status-sink.js +6 -0
  46. package/dist/brain/stream-engine.js +84 -49
  47. package/dist/brain/stream-shared.d.ts +30 -0
  48. package/dist/brain/stream-shared.js +34 -1
  49. package/dist/brain/timeout.d.ts +65 -6
  50. package/dist/brain/timeout.js +111 -11
  51. package/dist/core/a2a.d.ts +15 -5
  52. package/dist/core/a2a.js +34 -19
  53. package/dist/core/account-row.d.ts +61 -0
  54. package/dist/core/account-row.js +51 -0
  55. package/dist/core/advisor-verdict.d.ts +2 -1
  56. package/dist/core/advisor-verdict.js +1 -1
  57. package/dist/core/agent-definition.d.ts +20 -0
  58. package/dist/core/allow-entry.d.ts +20 -6
  59. package/dist/core/allow-entry.js +17 -7
  60. package/dist/core/approval-object.d.ts +29 -15
  61. package/dist/core/approval-object.js +47 -19
  62. package/dist/core/artifact-host.d.ts +0 -2
  63. package/dist/core/artifact-host.js +0 -1
  64. package/dist/core/auto-compaction.js +1 -1
  65. package/dist/core/auto-mode-defaults.d.ts +8 -0
  66. package/dist/core/auto-mode-defaults.js +1 -0
  67. package/dist/core/auto-mode-rebuild.d.ts +2 -1
  68. package/dist/core/auto-mode.d.ts +39 -4
  69. package/dist/core/auto-mode.js +63 -12
  70. package/dist/core/background-agent-store.d.ts +26 -4
  71. package/dist/core/background-agent-store.js +3 -2
  72. package/dist/core/background-shell.d.ts +12 -1
  73. package/dist/core/background-shell.js +12 -0
  74. package/dist/core/checkpoint-requirements.d.ts +13 -1
  75. package/dist/core/checkpoint-requirements.js +3 -1
  76. package/dist/core/checkpoint-store.d.ts +66 -25
  77. package/dist/core/checkpoint-store.js +22 -9
  78. package/dist/core/child-clamp-seats.d.ts +29 -0
  79. package/dist/core/child-clamp-seats.js +56 -1
  80. package/dist/core/compliance.d.ts +3 -3
  81. package/dist/core/compliance.js +1 -1
  82. package/dist/core/credential-echo.d.ts +52 -0
  83. package/dist/core/credential-echo.js +65 -0
  84. package/dist/core/credential-vocabulary.d.ts +13 -3
  85. package/dist/core/credential-vocabulary.js +12 -4
  86. package/dist/core/cross-boundary-taint.d.ts +4 -5
  87. package/dist/core/effective-path-target.d.ts +8 -2
  88. package/dist/core/effective-path-target.js +8 -3
  89. package/dist/core/engine-notice.d.ts +156 -23
  90. package/dist/core/engine-notice.js +19 -5
  91. package/dist/core/frame-settlement.d.ts +5 -0
  92. package/dist/core/frame-settlement.js +4 -0
  93. package/dist/core/gate-fold.js +8 -6
  94. package/dist/core/gate-lanes.js +47 -12
  95. package/dist/core/gate-outcome.d.ts +32 -3
  96. package/dist/core/gate-outcome.js +19 -1
  97. package/dist/core/governance-codes.d.ts +17 -1
  98. package/dist/core/governance-codes.js +25 -0
  99. package/dist/core/hands-band-screen.js +0 -1
  100. package/dist/core/hands-band.d.ts +0 -3
  101. package/dist/core/hooks.d.ts +70 -59
  102. package/dist/core/hooks.js +125 -80
  103. package/dist/core/image-admission.d.ts +106 -52
  104. package/dist/core/image-admission.js +184 -56
  105. package/dist/core/image-downsample.d.ts +36 -69
  106. package/dist/core/image-downsample.js +111 -73
  107. package/dist/core/integer-option.d.ts +21 -0
  108. package/dist/core/integer-option.js +13 -0
  109. package/dist/core/locked-config.d.ts +59 -5
  110. package/dist/core/locked-config.js +82 -50
  111. package/dist/core/mailbox-store.d.ts +45 -1
  112. package/dist/core/mailbox-store.js +53 -9
  113. package/dist/core/mcp-call-meta.d.ts +2 -2
  114. package/dist/core/mcp-call-meta.js +9 -10
  115. package/dist/core/mcp-failure.d.ts +122 -20
  116. package/dist/core/mcp-failure.js +73 -5
  117. package/dist/core/mcp-host-seat.d.ts +92 -0
  118. package/dist/core/mcp-host-seat.js +131 -0
  119. package/dist/core/mcp-probe.d.ts +7 -2
  120. package/dist/core/mcp-probe.js +7 -2
  121. package/dist/core/mcp-server-link.d.ts +22 -1
  122. package/dist/core/mcp-server-link.js +25 -1
  123. package/dist/core/mcp-server-spec.d.ts +38 -9
  124. package/dist/core/mcp-server-spec.js +55 -21
  125. package/dist/core/mcp.d.ts +27 -12
  126. package/dist/core/mcp.js +105 -76
  127. package/dist/core/memory-admission.d.ts +23 -6
  128. package/dist/core/memory-admission.js +19 -9
  129. package/dist/core/memory-engine/consolidation-driver.d.ts +2 -4
  130. package/dist/core/memory-engine/consolidation-driver.js +3 -3
  131. package/dist/core/memory-engine/consolidation.d.ts +4 -0
  132. package/dist/core/memory-engine/consolidation.js +1 -0
  133. package/dist/core/memory-engine/content-origin.d.ts +13 -0
  134. package/dist/core/memory-engine/content-origin.js +21 -3
  135. package/dist/core/memory-engine/delegation-settlement.js +5 -12
  136. package/dist/core/memory-engine/distiller.js +2 -2
  137. package/dist/core/memory-engine/dual-root.d.ts +50 -1
  138. package/dist/core/memory-engine/dual-root.js +44 -1
  139. package/dist/core/memory-engine/engine.d.ts +67 -14
  140. package/dist/core/memory-engine/engine.js +384 -212
  141. package/dist/core/memory-engine/export-bundle.d.ts +23 -0
  142. package/dist/core/memory-engine/export-bundle.js +23 -4
  143. package/dist/core/memory-engine/file-backend.d.ts +128 -55
  144. package/dist/core/memory-engine/file-backend.js +290 -117
  145. package/dist/core/memory-engine/index.d.ts +3 -2
  146. package/dist/core/memory-engine/index.js +2 -1
  147. package/dist/core/memory-engine/layout.d.ts +59 -11
  148. package/dist/core/memory-engine/layout.js +190 -40
  149. package/dist/core/memory-engine/memory-backend-contract.d.ts +1 -1
  150. package/dist/core/memory-engine/memory-backend-contract.js +39 -2
  151. package/dist/core/memory-engine/scope-contract.d.ts +13 -3
  152. package/dist/core/memory-engine/scope-contract.js +2 -2
  153. package/dist/core/memory-engine/sync-client.d.ts +51 -9
  154. package/dist/core/memory-engine/sync-client.js +107 -13
  155. package/dist/core/memory-engine/sync-report.d.ts +103 -0
  156. package/dist/core/memory-engine/sync-report.js +119 -0
  157. package/dist/core/memory-engine/sync.d.ts +8 -1
  158. package/dist/core/memory-engine/types.d.ts +6 -0
  159. package/dist/core/mode-policy.d.ts +9 -1
  160. package/dist/core/mode-policy.js +11 -1
  161. package/dist/core/model-receipt.d.ts +39 -0
  162. package/dist/core/model-receipt.js +139 -0
  163. package/dist/core/mods/agent-stations.d.ts +65 -0
  164. package/dist/core/mods/agent-stations.js +105 -0
  165. package/dist/core/mods/classic-events.d.ts +5 -1
  166. package/dist/core/mods/kernel/dispatch.d.ts +5 -1
  167. package/dist/core/mods/kernel/dispatch.js +6 -5
  168. package/dist/core/mods/kernel/events.d.ts +11 -4
  169. package/dist/core/mods/kernel/events.js +11 -7
  170. package/dist/core/mods/kernel/receive.d.ts +5 -0
  171. package/dist/core/mods/kernel/receive.js +10 -0
  172. package/dist/core/mods/kernel/registration.d.ts +4 -0
  173. package/dist/core/mods/kernel/registration.js +3 -0
  174. package/dist/core/mods/lifecycle-stations.d.ts +41 -0
  175. package/dist/core/mods/lifecycle-stations.js +35 -0
  176. package/dist/core/mods/stations.d.ts +73 -60
  177. package/dist/core/mods/stations.js +64 -40
  178. package/dist/core/mods/tool-call.d.ts +10 -4
  179. package/dist/core/mods/tool-call.js +28 -12
  180. package/dist/core/mounted-mcp.d.ts +5 -0
  181. package/dist/core/mounted-mcp.js +2 -2
  182. package/dist/core/namespaced-rule-name.d.ts +7 -1
  183. package/dist/core/namespaced-rule-name.js +13 -2
  184. package/dist/core/oracle-isolation.js +1 -1
  185. package/dist/core/own-property-receipt.d.ts +3 -0
  186. package/dist/core/own-property-receipt.js +3 -0
  187. package/dist/core/parent-spec-seat.d.ts +8 -3
  188. package/dist/core/parent-spec-seat.js +2 -0
  189. package/dist/core/park-selfcheck.js +14 -8
  190. package/dist/core/peer-seat.d.ts +133 -16
  191. package/dist/core/peer-seat.js +319 -42
  192. package/dist/core/permission-rule-consent.d.ts +0 -21
  193. package/dist/core/permission-rule-consent.js +11 -6
  194. package/dist/core/permission-rule-model.d.ts +20 -2
  195. package/dist/core/permission-rule-model.js +8 -7
  196. package/dist/core/present-plan-tool.d.ts +11 -3
  197. package/dist/core/present-plan-tool.js +2 -2
  198. package/dist/core/protocol-http-auth.d.ts +14 -2
  199. package/dist/core/protocol-http-auth.js +16 -7
  200. package/dist/core/read-face-seats.d.ts +7 -5
  201. package/dist/core/read-face-seats.js +4 -1
  202. package/dist/core/redaction-marks.d.ts +4 -3
  203. package/dist/core/redaction-marks.js +2 -2
  204. package/dist/core/remote-env.d.ts +146 -98
  205. package/dist/core/remote-env.js +113 -14
  206. package/dist/core/resume-startup-cause.js +1 -0
  207. package/dist/core/retention.js +37 -12
  208. package/dist/core/retired-keys.d.ts +6 -1
  209. package/dist/core/retired-keys.js +4 -1
  210. package/dist/core/rewrite-rejudge.d.ts +13 -5
  211. package/dist/core/rewrite-rejudge.js +9 -5
  212. package/dist/core/roles.d.ts +69 -3
  213. package/dist/core/roles.js +167 -80
  214. package/dist/core/rule-owner.d.ts +3 -0
  215. package/dist/core/runner/announce-once-ledger.d.ts +5 -4
  216. package/dist/core/runner/announce-once-ledger.js +4 -2
  217. package/dist/core/runner/assemble-result.d.ts +0 -5
  218. package/dist/core/runner/assemble-result.js +0 -1
  219. package/dist/core/runner/call-hook-stations.d.ts +17 -10
  220. package/dist/core/runner/call-hook-stations.js +23 -12
  221. package/dist/core/runner/child-tree.d.ts +7 -8
  222. package/dist/core/runner/child-tree.js +6 -6
  223. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  224. package/dist/core/runner/classifier-ladder.js +39 -8
  225. package/dist/core/runner/construction-doors.js +5 -0
  226. package/dist/core/runner/contracts.d.ts +82 -57
  227. package/dist/core/runner/credential-origin-seat.js +4 -3
  228. package/dist/core/runner/cross-boundary-lane.d.ts +3 -5
  229. package/dist/core/runner/cross-boundary-lane.js +11 -2
  230. package/dist/core/runner/cwd-alignment-probe.d.ts +20 -0
  231. package/dist/core/runner/cwd-alignment-probe.js +21 -0
  232. package/dist/core/runner/decide-continuation.d.ts +2 -2
  233. package/dist/core/runner/env-capability-census.d.ts +15 -20
  234. package/dist/core/runner/env-capability-census.js +25 -34
  235. package/dist/core/runner/file-history-request.d.ts +2 -2
  236. package/dist/core/runner/file-history-request.js +0 -8
  237. package/dist/core/runner/gate-exit.d.ts +87 -11
  238. package/dist/core/runner/gate-exit.js +30 -8
  239. package/dist/core/runner/git-status-frame.d.ts +5 -2
  240. package/dist/core/runner/git-status-frame.js +3 -4
  241. package/dist/core/runner/image-removed-seat.d.ts +12 -0
  242. package/dist/core/runner/image-removed-seat.js +19 -0
  243. package/dist/core/runner/image.d.ts +7 -2
  244. package/dist/core/runner/image.js +14 -8
  245. package/dist/core/runner/inline-image.d.ts +10 -8
  246. package/dist/core/runner/inline-image.js +11 -9
  247. package/dist/core/runner/memory-consolidation-driver.js +5 -5
  248. package/dist/core/runner/park-commit.d.ts +1 -1
  249. package/dist/core/runner/park-commit.js +3 -0
  250. package/dist/core/runner/permission-rule-lanes.js +1 -1
  251. package/dist/core/runner/prepare-ask-lane.d.ts +1 -1
  252. package/dist/core/runner/prepare-ask-lane.js +2 -1
  253. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  254. package/dist/core/runner/prepare-boundary-parks.js +5 -5
  255. package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -5
  256. package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
  257. package/dist/core/runner/prepare-config-doors.d.ts +6 -1
  258. package/dist/core/runner/prepare-config-doors.js +16 -9
  259. package/dist/core/runner/prepare-context-lane.js +2 -0
  260. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -3
  261. package/dist/core/runner/prepare-delegation-surface.js +5 -4
  262. package/dist/core/runner/prepare-file-history.d.ts +10 -12
  263. package/dist/core/runner/prepare-file-history.js +3 -12
  264. package/dist/core/runner/prepare-gate-stations.d.ts +4 -3
  265. package/dist/core/runner/prepare-gate-stations.js +4 -3
  266. package/dist/core/runner/prepare-hands-readface.d.ts +7 -1
  267. package/dist/core/runner/prepare-hands-readface.js +19 -6
  268. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -7
  269. package/dist/core/runner/prepare-inherited-gate.js +22 -31
  270. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  271. package/dist/core/runner/prepare-memory.d.ts +2 -2
  272. package/dist/core/runner/prepare-memory.js +12 -19
  273. package/dist/core/runner/prepare-park-ask.d.ts +4 -6
  274. package/dist/core/runner/prepare-park-ask.js +5 -9
  275. package/dist/core/runner/prepare-policy-chain.d.ts +8 -7
  276. package/dist/core/runner/prepare-policy-chain.js +136 -121
  277. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  278. package/dist/core/runner/prepare-project-context.js +10 -7
  279. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -2
  280. package/dist/core/runner/prepare-prompt-inputs.js +10 -20
  281. package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
  282. package/dist/core/runner/prepare-protocol-tools.js +17 -2
  283. package/dist/core/runner/prepare-run-refs.d.ts +2 -3
  284. package/dist/core/runner/prepare-run-refs.js +4 -1
  285. package/dist/core/runner/prepare-suspend-saga.d.ts +0 -2
  286. package/dist/core/runner/prepare-suspend-saga.js +5 -7
  287. package/dist/core/runner/prepare-task.js +44 -28
  288. package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
  289. package/dist/core/runner/prepare-turn-wiring.js +7 -2
  290. package/dist/core/runner/prepare-wiring-manifest.d.ts +5 -4
  291. package/dist/core/runner/prepare-wiring-manifest.js +34 -19
  292. package/dist/core/runner/prepare-workspace-restore.js +3 -3
  293. package/dist/core/runner/reply-pricing.d.ts +30 -0
  294. package/dist/core/runner/reply-pricing.js +19 -0
  295. package/dist/core/runner/resume-admission.js +4 -2
  296. package/dist/core/runner/resume-apply.js +6 -1
  297. package/dist/core/runner/resume-checkpoint-screen.js +4 -4
  298. package/dist/core/runner/resume-policy-outcome.js +5 -5
  299. package/dist/core/runner/retired-runner-deps.js +4 -1
  300. package/dist/core/runner/role-seat-defaulted.d.ts +44 -0
  301. package/dist/core/runner/role-seat-defaulted.js +40 -0
  302. package/dist/core/runner/run-attachment-seats.js +3 -3
  303. package/dist/core/runner/run-brain-sinks.js +3 -0
  304. package/dist/core/runner/run-git-lane.d.ts +3 -1
  305. package/dist/core/runner/run-git-lane.js +1 -1
  306. package/dist/core/runner/run-harness-handlers.d.ts +3 -1
  307. package/dist/core/runner/run-harness-handlers.js +3 -1
  308. package/dist/core/runner/run-identity-wiring.d.ts +2 -5
  309. package/dist/core/runner/run-identity-wiring.js +6 -5
  310. package/dist/core/runner/run-leg.d.ts +2 -0
  311. package/dist/core/runner/run-leg.js +63 -56
  312. package/dist/core/runner/run-notification-lane.d.ts +3 -1
  313. package/dist/core/runner/run-notification-lane.js +16 -10
  314. package/dist/core/runner/run-settle-and-teardown.js +5 -1
  315. package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
  316. package/dist/core/runner/run-stop-and-final-verify.js +14 -6
  317. package/dist/core/runner/run-terminal-adoption.d.ts +2 -5
  318. package/dist/core/runner/run-terminal-adoption.js +9 -3
  319. package/dist/core/runner/run-turn-boundary.js +89 -77
  320. package/dist/core/runner/runtask.d.ts +8 -5
  321. package/dist/core/runner/runtask.js +21 -13
  322. package/dist/core/runner/side-call-account.d.ts +1 -1
  323. package/dist/core/runner/side-call-account.js +3 -18
  324. package/dist/core/runner/skills-seat.js +2 -2
  325. package/dist/core/runner/sub-agent-deny-lists.d.ts +24 -0
  326. package/dist/core/runner/sub-agent-deny-lists.js +20 -7
  327. package/dist/core/runner/synthetic-tools.js +2 -2
  328. package/dist/core/runner/tool-disclosure.js +0 -2
  329. package/dist/core/runner/tool-end-body.js +2 -2
  330. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  331. package/dist/core/runner/tool-face-overlay.js +26 -19
  332. package/dist/core/runner/tool-occurrence.d.ts +1 -1
  333. package/dist/core/runner/tool-occurrence.js +2 -2
  334. package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
  335. package/dist/core/runner/tool-result-media-seat.js +17 -1
  336. package/dist/core/runner/turn-attachments.d.ts +29 -27
  337. package/dist/core/runner/turn-attachments.js +27 -42
  338. package/dist/core/runner-deps.d.ts +32 -19
  339. package/dist/core/secret-env.d.ts +35 -4
  340. package/dist/core/secret-env.js +65 -3
  341. package/dist/core/sensitive-path-policy.js +3 -3
  342. package/dist/core/session-policy-store.d.ts +12 -3
  343. package/dist/core/session-policy-store.js +29 -10
  344. package/dist/core/session-store.d.ts +5 -7
  345. package/dist/core/session-store.js +50 -11
  346. package/dist/core/side-query.d.ts +11 -1
  347. package/dist/core/side-query.js +9 -0
  348. package/dist/core/skill-grant-binding.d.ts +31 -2
  349. package/dist/core/skill-grant-binding.js +31 -1
  350. package/dist/core/skill-grant.d.ts +17 -5
  351. package/dist/core/skill-grant.js +24 -6
  352. package/dist/core/store-contracts/background-agent-store-contract.js +27 -0
  353. package/dist/core/store-contracts/checkpoint-store-contract.js +3 -2
  354. package/dist/core/store-contracts/mailbox-store-contract.js +31 -1
  355. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  356. package/dist/core/store-contracts/tool-result-store-contract.js +37 -0
  357. package/dist/core/stub-env.d.ts +5 -5
  358. package/dist/core/stub-env.js +11 -1
  359. package/dist/core/swappable-deps.d.ts +17 -43
  360. package/dist/core/swappable-deps.js +15 -5
  361. package/dist/core/synthetic-read-verdict.d.ts +1 -1
  362. package/dist/core/synthetic-read-verdict.js +2 -1
  363. package/dist/core/task-event.d.ts +50 -10
  364. package/dist/core/task-notification.d.ts +88 -5
  365. package/dist/core/task-notification.js +146 -17
  366. package/dist/core/task-registry-agent.d.ts +18 -12
  367. package/dist/core/task-registry-agent.js +19 -6
  368. package/dist/core/task-registry-monitor.d.ts +7 -0
  369. package/dist/core/task-registry-monitor.js +28 -1
  370. package/dist/core/task-registry-shared.d.ts +43 -3
  371. package/dist/core/task-registry-shared.js +21 -7
  372. package/dist/core/task-registry-workflow.js +1 -1
  373. package/dist/core/task-registry.d.ts +50 -35
  374. package/dist/core/task-registry.js +64 -23
  375. package/dist/core/task-result.d.ts +3 -12
  376. package/dist/core/task-spec.d.ts +15 -7
  377. package/dist/core/task-stream.d.ts +1 -1
  378. package/dist/core/terminal-cause.d.ts +10 -0
  379. package/dist/core/tool-catalog-entries.js +1 -1
  380. package/dist/core/tool-check-reading.d.ts +1 -0
  381. package/dist/core/tool-check-reading.js +3 -3
  382. package/dist/core/tool-face-reader.d.ts +7 -6
  383. package/dist/core/tool-face-reader.js +4 -3
  384. package/dist/core/tool-name-aliases.d.ts +19 -0
  385. package/dist/core/tool-name-aliases.js +54 -2
  386. package/dist/core/tool-policy.d.ts +21 -4
  387. package/dist/core/tool-policy.js +1 -1
  388. package/dist/core/tool-registry.d.ts +5 -5
  389. package/dist/core/tool-registry.js +2 -2
  390. package/dist/core/tool-result-store.d.ts +88 -5
  391. package/dist/core/tool-result-store.js +51 -12
  392. package/dist/core/tool-roster.d.ts +112 -5
  393. package/dist/core/tool-roster.js +42 -1
  394. package/dist/core/tool-spec.d.ts +23 -5
  395. package/dist/core/trace.d.ts +0 -1
  396. package/dist/core/types.d.ts +5 -5
  397. package/dist/core/types.js +2 -2
  398. package/dist/core/untrusted-text.js +1 -1
  399. package/dist/core/user-attachment.d.ts +10 -5
  400. package/dist/core/user-attachment.js +15 -7
  401. package/dist/core/wiring-manifest.d.ts +6 -3
  402. package/dist/engine/compaction/compaction.js +29 -3
  403. package/dist/engine/execution-env/node-execution-env.d.ts +11 -5
  404. package/dist/engine/execution-env/node-execution-env.js +21 -13
  405. package/dist/engine/harness/agent-harness.d.ts +26 -3
  406. package/dist/engine/harness/agent-harness.js +49 -16
  407. package/dist/engine/harness/messages.d.ts +3 -1
  408. package/dist/engine/harness/messages.js +3 -2
  409. package/dist/engine/harness/types.d.ts +119 -28
  410. package/dist/engine/llm/rejected-images.d.ts +46 -0
  411. package/dist/engine/llm/rejected-images.js +54 -0
  412. package/dist/engine/llm/tool-turns.d.ts +2 -1
  413. package/dist/engine/llm/types.d.ts +18 -7
  414. package/dist/engine/loop/agent-loop.d.ts +20 -12
  415. package/dist/engine/loop/agent-loop.js +205 -36
  416. package/dist/engine/loop/types.d.ts +12 -3
  417. package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
  418. package/dist/engine/lsp/node-lsp-manager.js +32 -13
  419. package/dist/engine/session/path-to-root.d.ts +38 -0
  420. package/dist/engine/session/path-to-root.js +39 -0
  421. package/dist/engine/session/storage-base.js +4 -21
  422. package/dist/index.d.ts +35 -21
  423. package/dist/index.js +26 -17
  424. package/dist/internal/harness-types.d.ts +1 -1
  425. package/dist/internal/harness.d.ts +1 -0
  426. package/dist/internal/llm.d.ts +1 -0
  427. package/dist/orchestration/run-workflow-tool.d.ts +9 -3
  428. package/dist/orchestration/run-workflow-tool.js +59 -29
  429. package/dist/orchestration/workflow-governance.d.ts +1 -1
  430. package/dist/orchestration/workflow-governance.js +2 -1
  431. package/dist/orchestration/workflow-observe.d.ts +17 -1
  432. package/dist/orchestration/workflow-observe.js +20 -0
  433. package/dist/orchestration/workflow-types.d.ts +32 -7
  434. package/dist/orchestration/workflow.d.ts +4 -0
  435. package/dist/orchestration/workflow.js +762 -491
  436. package/dist/prompts/default.d.ts +1 -10
  437. package/dist/prompts/default.js +0 -2
  438. package/dist/shell/counting-pass.d.ts +50 -0
  439. package/dist/shell/counting-pass.js +502 -0
  440. package/dist/shell/lex.d.ts +4 -2
  441. package/dist/shell/lex.js +93 -34
  442. package/dist/shell/shell-words.d.ts +1 -1
  443. package/dist/shell/shell-words.js +7 -6
  444. package/dist/stores/file/background-agent-store.d.ts +1 -1
  445. package/dist/stores/file/background-agent-store.js +3 -1
  446. package/dist/stores/file/checkpoint-store.d.ts +127 -2
  447. package/dist/stores/file/checkpoint-store.js +19 -14
  448. package/dist/stores/file/file-history-store.d.ts +1 -1
  449. package/dist/stores/file/file-history-store.js +3 -1
  450. package/dist/stores/file/index.d.ts +4 -3
  451. package/dist/stores/file/index.js +17 -8
  452. package/dist/stores/file/mailbox-store.d.ts +1 -1
  453. package/dist/stores/file/mailbox-store.js +9 -11
  454. package/dist/stores/file/memory-store.d.ts +1 -1
  455. package/dist/stores/file/memory-store.js +3 -1
  456. package/dist/stores/file/session-policy-store.d.ts +1 -1
  457. package/dist/stores/file/session-policy-store.js +3 -1
  458. package/dist/stores/file/session-store.d.ts +1 -1
  459. package/dist/stores/file/session-store.js +3 -1
  460. package/dist/stores/file/shared-ledger.d.ts +26 -0
  461. package/dist/stores/file/shared-ledger.js +38 -9
  462. package/dist/stores/file/tool-result-store.d.ts +20 -2
  463. package/dist/stores/file/tool-result-store.js +74 -6
  464. package/dist/stores/file/usage-window-store.d.ts +1 -1
  465. package/dist/stores/file/usage-window-store.js +3 -1
  466. package/dist/stores/file/workflow-journal-store.d.ts +1 -11
  467. package/dist/stores/file/workflow-journal-store.js +3 -2
  468. package/dist/tools/fs/containment-face.d.ts +5 -0
  469. package/dist/tools/fs/encoding.d.ts +13 -4
  470. package/dist/tools/fs/encoding.js +17 -2
  471. package/dist/tools/fs/fs-bash-background-text.d.ts +7 -0
  472. package/dist/tools/fs/fs-bash-background-text.js +1 -0
  473. package/dist/tools/fs/fs-bash.d.ts +14 -4
  474. package/dist/tools/fs/fs-bash.js +29 -35
  475. package/dist/tools/fs/fs-pdf.d.ts +2 -2
  476. package/dist/tools/fs/fs-pdf.js +26 -21
  477. package/dist/tools/fs/fs-read.d.ts +5 -4
  478. package/dist/tools/fs/fs-read.js +35 -18
  479. package/dist/tools/fs/fs-search-tools.js +4 -1
  480. package/dist/tools/fs/fs-shared.d.ts +11 -13
  481. package/dist/tools/fs/fs-shared.js +11 -7
  482. package/dist/tools/fs/fs-write.js +5 -5
  483. package/dist/tools/fs/index.d.ts +14 -8
  484. package/dist/tools/fs/index.js +13 -5
  485. package/dist/tools/fs/program-read-model.d.ts +13 -0
  486. package/dist/tools/fs/program-read-model.js +15 -0
  487. package/dist/tools/fs/program-read-model.rows.js +1 -1
  488. package/dist/tools/fs/read-deny.d.ts +13 -10
  489. package/dist/tools/fs/read-deny.js +25 -5
  490. package/dist/tools/fs/read-floor.d.ts +62 -0
  491. package/dist/tools/fs/read-floor.js +58 -0
  492. package/dist/tools/fs/removal-targets.d.ts +9 -4
  493. package/dist/tools/fs/removal-targets.js +17 -9
  494. package/dist/tools/fs/search.d.ts +3 -3
  495. package/dist/tools/fs/search.js +4 -4
  496. package/dist/tools/fs/shell-read-check.d.ts +1 -1
  497. package/dist/tools/fs/shell-read-check.js +2 -1
  498. package/dist/tools/fs/shell-read-judge.d.ts +16 -8
  499. package/dist/tools/fs/shell-read-judge.js +10 -6
  500. package/dist/tools/fs/shell-read-plan.d.ts +6 -1
  501. package/dist/tools/fs/shell-read-plan.js +22 -15
  502. package/dist/tools/fs/shell-read-start.js +1 -0
  503. package/dist/tools/fs/shell-reentry-text.d.ts +15 -1
  504. package/dist/tools/fs/shell-reentry-text.js +25 -3
  505. package/dist/tools/monitor.d.ts +9 -4
  506. package/dist/tools/monitor.js +17 -8
  507. package/dist/tools/scheduler-tools.js +42 -4
  508. package/dist/tools/web.d.ts +0 -10
  509. package/dist/tools/web.js +1 -4
  510. package/package.json +5 -2
  511. package/test/export-surface.snapshot.json +161 -21
  512. package/wire-changes/core-stores-sql@7.59.0.json +29 -0
  513. package/wire-changes/core-stores-sql@7.60.0.json +30 -0
  514. package/wire-changes/core@7.59.0.json +2459 -0
  515. package/wire-changes/core@7.60.0.json +3274 -0
  516. package/wire-changes/mods-kernel@7.59.0.json +29 -0
  517. package/wire-changes/mods-kernel@7.60.0.json +62 -0
  518. package/wire-changes/primitives@7.59.0.json +29 -0
  519. package/wire-changes/primitives@7.60.0.json +30 -0
@@ -192,7 +192,9 @@ export interface ToolSpec<TParams extends TSchema = TSchema> {
192
192
  * runtime tracking of what the child actually did is involved (that is the v2 ticket). `authored`
193
193
  * marks the entries minted from a definition a caller wrote on a tool a deployment mounted (not the
194
194
  * engine's built-ins, the general-purpose alias, fork, or the engine's nested copy of the tool for a
195
- * delegated child); prepare's deny-name check judges only those.
195
+ * delegated child); prepare's deny-name check judges only those. `servers` are the MCP servers the definition declares itself
196
+ * (`AgentDefinition.mcp`): part of the child's universe for both readers, and its `allowTools` is the list the child's own layer is
197
+ * minted from (the written one, admitting every tool of those servers).
196
198
  */
197
199
  agentToolFaces?: ReadonlyArray<{
198
200
  name: string;
@@ -200,6 +202,10 @@ export interface ToolSpec<TParams extends TSchema = TSchema> {
200
202
  denyTools?: readonly string[];
201
203
  canRedelegate?: boolean;
202
204
  authored?: true;
205
+ servers?: ReadonlyArray<{
206
+ name: string;
207
+ contentOrigin?: import("./types.js").ToolContentOrigin;
208
+ }>;
203
209
  }>;
204
210
  /**
205
211
  * The tool-level `denyTools` list of the delegation tool (`SubagentToolOptions.denyTools`, applied when no agent definition is
@@ -740,9 +746,9 @@ export interface ToolExecuteContext {
740
746
  * is rejected — this seat never widens, it only reopens the documented re-supply channel to
741
747
  * the parked-decide lane). Absent ⇒ exactly the previous behavior.
742
748
  *
743
- * One entry kind is NOT a policy the deployment authored: a hook-wired parent contributes a
744
- * PreToolUse SCREENING entry (issue #33), whose policy the engine mints. Rebuild it with the
745
- * exported `createPreToolUseConstraintPolicy(hook, env)` — same callback, same installed env —
749
+ * One entry kind is NOT a policy the deployment authored: a mods-wired parent contributes a
750
+ * SCREENING entry (issue #33), its installation. Rebuild it as `{ installation: await
751
+ * admitModChain(…), hookEnv, …regime }` over the same registrations and the same installed env,
746
752
  * or the chain handed back here will be short and rejected on the count check. A face that only
747
753
  * observes should be declared `{ observe: true }` instead, and then never enters the chain
748
754
  * at all; a park under a screening entry announces the requirement on `onError`
@@ -1318,6 +1324,10 @@ export interface ToolExecuteContext {
1318
1324
  onTaskNotification?: (n: import("./task-notification.js").TaskNotificationPayload, opts?: {
1319
1325
  priority?: import("./task-notification.js").SystemInjectionPriority;
1320
1326
  }) => unknown;
1327
+ /** Where a background task's result is stored when its completion notification ({@link onTaskNotification}) carries
1328
+ * less than the whole of it — the run's offload store, read back with `ReadToolResult`. Present exactly when the run
1329
+ * has one; absent ⇒ a cut notification says the full text is not readable from this session. TRUSTED, run-scoped. */
1330
+ taskArtifacts?: import("./tool-result-store.js").TaskArtifactSeat;
1321
1331
  /**
1322
1332
  * design/99 (nested-subagent live observability): the host run's OPT-IN display sink — a deployment sets it (via
1323
1333
  * `RunInternals.onForwardEvent`) to receive a SUBAGENT's live `task_progress` ticks that otherwise stay in the
@@ -1384,6 +1394,12 @@ export interface ToolExecuteContext {
1384
1394
  forkAccess?: {
1385
1395
  denied: "task" | "principal";
1386
1396
  };
1397
+ /**
1398
+ * The delegating leg's two agent stations over its mods bus — `agent.offer` (the offered set the delegation reads at
1399
+ * dispatch) and `agent.spawn` (raised before a subagent is let start). Runner-filled; never a model argument. Absent
1400
+ * outside a Runner: no station is raised and every type is offered.
1401
+ */
1402
+ agentStations?: import("./mods/agent-stations.js").AgentStations;
1387
1403
  /**
1388
1404
  * design/80 D-B — the general "a tool yields to a HUMAN review gate" primitive. A tool calls this to request
1389
1405
  * that, at the next SAFE turn boundary, the engine pause with a durable `plan_review` checkpoint
@@ -1392,7 +1408,9 @@ export interface ToolExecuteContext {
1392
1408
  * only when the deployment can actually pause (a `checkpointStore` is wired); otherwise the request is a silent
1393
1409
  * no-op (read-only/headless degrade). The first-party `present_plan` tool (CC `ExitPlanMode` parity) is a thin
1394
1410
  * caller of this; any tool may use it to gate a high-blast step on human review. Idempotent within a batch (the
1395
- * first request wins; the suspend fires once at the boundary). The Runner fills it; not a tool arg.
1411
+ * first request wins; the suspend fires once at the boundary). The Runner fills it; not a tool arg. The Runner
1412
+ * binds the id of the calling tool call to the request (a tool cannot name another call): the parked `plan_review`
1413
+ * row and the paused cause carry it as `requestedByCallId` — which call asked for the pause.
1396
1414
  */
1397
1415
  requestReview?: (opts?: {
1398
1416
  reason?: string;
@@ -64,7 +64,6 @@ export interface PromptManifestSection {
64
64
  * metadata-only rule). Field meanings: see the `stats.mechanisms` JSDoc in core/types.ts.
65
65
  */
66
66
  export interface TraceMechanismsSummary {
67
- finalVerifyInjected?: true;
68
67
  finalVerifyInjections?: number;
69
68
  attachmentsInjected?: number;
70
69
  /** design/164: how many LIMIT-APPROACH frames were injected this run (0..2). */
@@ -18,18 +18,18 @@ export type { PermissionMode } from "./ask-origin.js";
18
18
  export type { ToolEffect, ToolContentOrigin, ReversibilityVerdict, ReadRootGrantCandidate, ToolSpec, ToolReturn, NestedUsage, NestedUsageAccum, ToolExecuteContext } from "./tool-spec.js";
19
19
  export type { BeforeWriteRequest, BeforeWriteResult, BeforeWriteHook, TrackEditRequest, TrackEditResult, TrackFileEditHook, FileEditedNotice, FileEditedHook, HandsBandOptions } from "./hands-band.js";
20
20
  export type { AgentDefinition, SkillSpec } from "./agent-definition.js";
21
- export type { McpServerSpec, A2aServerSpec, McpElicitRequest, McpElicitResponse, OnElicit, McpRevocationLedger, McpMountIdentity, DeclarationFault, DeclarationPathRule, DeclarationRead, ToolAxesRead, ToolAxesSurface } from "./mcp-server-spec.js";
22
- export { DECLARATION_PATH_RULES, NO_DECLARATION_PATH_RULES, dataKind, declarationFaultOf, declarerWord, perToolEmptyName, perToolEntryRefusal, quotedName, readMcpToolAxes, readToolAxes, receiveDeclaration, receivePerToolDeclaration, toolAxesRefusal } from "./mcp-server-spec.js";
21
+ export type { McpServerSpec, A2aServerSpec, McpElicitRequest, McpElicitResponse, OnElicit, McpRevocationLedger, McpMountIdentity, McpTransportKind, DeclarationFault, DeclarationPathRule, DeclarationRead, ToolAxesRead, ToolAxesSurface } from "./mcp-server-spec.js";
22
+ export { DECLARATION_ENTRY_WORDS, DECLARATION_PATH_RULES, MCP_TRANSPORT_KINDS, NO_DECLARATION_PATH_RULES, TOOL_AXIS_WORDS, callerText, dataKind, declarationFaultOf, declarationPath, declarerWord, perToolEmptyName, perToolEntryRefusal, readMcpToolAxes, readToolAxes, receiveDeclaration, receivePerToolDeclaration, toolAxesRefusal, transportKindOf } from "./mcp-server-spec.js";
23
23
  export type { TaskLimits } from "./task-limits.js";
24
24
  export type { TaskStatus, RemoteEnvFailureNote, EffectiveMemoryScopes, TaskResult, HumanReviewGateRow } from "./task-result.js";
25
25
  export type { TerminalCause, PausedCause } from "./terminal-cause.js";
26
- export type { TaskEventIdentity, BrainStatusPhase, BrainRetryErrClass, BrainStatus, ToolActivity, HumanInputSource, HumanInputDelivery, DelegationTaskType, TaskEvent, HumanInputEvent, HumanInputAttachment, CompactOutcome, ExtensionRequester, RewriteAuthor, ToolInputRewrite } from "./task-event.js";
26
+ export type { TaskEventIdentity, BrainStatusPhase, BrainStatusSeat, BrainRetryErrClass, BrainStatus, ToolActivity, HumanInputSource, HumanInputDelivery, DelegationTaskType, TaskEvent, HumanInputEvent, HumanInputAttachment, CompactOutcome, ExtensionRequester, RewriteAuthor, ToolInputRewrite } from "./task-event.js";
27
27
  export type { TaskStream } from "./task-stream.js";
28
28
  export type { WorkflowGovernanceBaseline, RuntimeCaps, AutoModeDenySource } from "./runtime-caps.js";
29
29
  export { AUTO_MODE_DENY_SOURCES, isAutoModeDenySource } from "./runtime-caps.js";
30
30
  export type { BackgroundChildEvent, BackgroundChildRow, DelegationLifecycleEvent } from "./delegation-frames.js";
31
31
  export { __resetMalformedDelegationSeatAnnouncement, backgroundChildTerminal, deliverDelegationLifecycle, emitsChildRowFrames, taskStartedFrame } from "./delegation-frames.js";
32
32
  export type { ProjectMemoryLoad, ResumePreflightInfo, ResumePreflightVerdict, RunnerDeps } from "./runner-deps.js";
33
- export type { ApprovalCarryRefusal, EngineNotice, OwedUserInputAccount, UserInputUndrainedCause } from "./engine-notice.js";
34
- export { __resetMalformedNoticeSeatAnnouncement, deliverEngineNotice, owedUserInputCounts, parentLegIds, settleOwedUserInput, undrainedUserInputNotices, USER_INPUT_UNDRAINED_CAUSES, USER_INPUT_UNDRAINED_FAMILIES } from "./engine-notice.js";
33
+ export type { ApprovalCarryRefusal, EngineNotice, HeldUserInputs, OwedInputIds, OwedUserInputAccount, UserInputUndrainedCause } from "./engine-notice.js";
34
+ export { __resetMalformedNoticeSeatAnnouncement, deliverEngineNotice, owedUserInputCounts, owedUserInputIds, parentLegIds, parkedInputIdsOf, settleOwedUserInput, undrainedUserInputNotices, USER_INPUT_UNDRAINED_CAUSES, USER_INPUT_UNDRAINED_FAMILIES } from "./engine-notice.js";
35
35
  export type { AgentTool, Model, StreamFn, ThinkingLevel, ToolInputValidationContext, ToolInputVerdict };
@@ -1,5 +1,5 @@
1
1
  export { MODEL_ROLES } from "./model-seat.js";
2
- export { DECLARATION_PATH_RULES, NO_DECLARATION_PATH_RULES, dataKind, declarationFaultOf, declarerWord, perToolEmptyName, perToolEntryRefusal, quotedName, readMcpToolAxes, readToolAxes, receiveDeclaration, receivePerToolDeclaration, toolAxesRefusal } from "./mcp-server-spec.js";
2
+ export { DECLARATION_ENTRY_WORDS, DECLARATION_PATH_RULES, MCP_TRANSPORT_KINDS, NO_DECLARATION_PATH_RULES, TOOL_AXIS_WORDS, callerText, dataKind, declarationFaultOf, declarationPath, declarerWord, perToolEmptyName, perToolEntryRefusal, readMcpToolAxes, readToolAxes, receiveDeclaration, receivePerToolDeclaration, toolAxesRefusal, transportKindOf } from "./mcp-server-spec.js";
3
3
  export { AUTO_MODE_DENY_SOURCES, isAutoModeDenySource } from "./runtime-caps.js";
4
4
  export { __resetMalformedDelegationSeatAnnouncement, backgroundChildTerminal, deliverDelegationLifecycle, emitsChildRowFrames, taskStartedFrame } from "./delegation-frames.js";
5
- export { __resetMalformedNoticeSeatAnnouncement, deliverEngineNotice, owedUserInputCounts, parentLegIds, settleOwedUserInput, undrainedUserInputNotices, USER_INPUT_UNDRAINED_CAUSES, USER_INPUT_UNDRAINED_FAMILIES } from "./engine-notice.js";
5
+ export { __resetMalformedNoticeSeatAnnouncement, deliverEngineNotice, owedUserInputCounts, owedUserInputIds, parentLegIds, parkedInputIdsOf, settleOwedUserInput, undrainedUserInputNotices, USER_INPUT_UNDRAINED_CAUSES, USER_INPUT_UNDRAINED_FAMILIES } from "./engine-notice.js";
@@ -229,7 +229,7 @@ export const ENGINE_ENVELOPES = Object.freeze([
229
229
  {
230
230
  tag: "example",
231
231
  kind: "not-an-envelope",
232
- mint: "engine/compaction SUMMARIZATION_PROMPT (CC 2.1.223 `qby` verbatim — the output skeleton shown to the summarizer)",
232
+ mint: "engine/compaction SUMMARIZATION_PROMPT (the output skeleton shown to the summarizer, captured from an early reference build)",
233
233
  guard: "no untrusted bytes reach it: the block is a CONSTANT that frames placeholder text (`[Concept 1]`), it wraps nothing, and it is never emitted back — the summarizer's own answer is read through the `<summary>` envelope, not this one",
234
234
  fenced: false,
235
235
  disclosed: false,
@@ -25,6 +25,7 @@
25
25
  import type { ImageContent, TextContent, UserAttachmentSupply, UserMessageAttachment } from "../internal/llm.js";
26
26
  import type { HumanInputAttachment } from "./task-event.js";
27
27
  import { type ModelFileReader } from "../tools/fs/fs-read.js";
28
+ import { type ImageDownsampler } from "./image-downsample.js";
28
29
  import type { SyntheticReadJudge } from "./synthetic-read-verdict.js";
29
30
  import { type ReminderDisclosureCounts } from "./reminder-disclosure.js";
30
31
  import { type AgentMessage } from "../internal/harness.js";
@@ -115,10 +116,11 @@ export interface UserAttachmentDeclaration {
115
116
  /** The UserPromptSubmit hook's view of the declarations. */
116
117
  export declare function userAttachmentDeclarations(screened: readonly ScreenedUserAttachment[]): readonly UserAttachmentDeclaration[];
117
118
  /**
118
- * The host images' byte admission — the one function an image the Read tool serves passes. Asynchronous (it decodes),
119
- * run on the captured values before any attachment is read or delivered. Throws `config.user_attachment_invalid`.
119
+ * The host images' byte admission — the one function an image the Read tool serves passes, with the run's processor.
120
+ * Asynchronous (it decodes), run on the captured values before any attachment is read or delivered. Throws
121
+ * `config.user_attachment_invalid`.
120
122
  */
121
- export declare function admitUserAttachmentImages(screened: readonly ScreenedUserAttachment[]): Promise<ReadonlyMap<number, ImageContent>>;
123
+ export declare function admitUserAttachmentImages(screened: readonly ScreenedUserAttachment[], processor: ImageDownsampler | "none"): Promise<ReadonlyMap<number, ImageContent>>;
122
124
  /** The transmission an attachment frame is (the read-state entry its delivery records carries it): when the frame leaves
123
125
  * the request — a trim drops it — the entry retires with it. One spelling for the mint and every remover. */
124
126
  export declare function attachmentTransmissionId(a: Pick<UserMessageAttachment, "inputId" | "ordinal">): string;
@@ -171,8 +173,11 @@ export interface AttachmentWindowInput {
171
173
  }
172
174
  /** The objective lane's read: once the UserPromptSubmit hook let the objective through (a blocked objective reads
173
175
  * nothing), and before the pre-call gate, which prices the frames (`chars`). Refuses the whole objective when the frames
174
- * and the objective cannot ride one request ({@link refuseFramesOverWindow}). Commits nothing. */
175
- export declare function readObjectiveAttachments(prepared: Pick<import("./runner/contracts.js").Prepared, "userAttachments" | "modelFileReader" | "syntheticReadVerdict" | "cwdRef" | "reminderMark" | "reminderDisclosureCounts" | "abortController" | "harness" | "modBus" | "hookIdentity">, inputId: string, blocked: boolean, window: AttachmentWindowInput): Promise<{
176
+ * and the objective cannot ride one request ({@link refuseFramesOverWindow}). Commits nothing. `imageSeat` is the run's
177
+ * image processor seat (`RunnerDeps.imageProcessor`): the host images are admitted with it (a path's image is read by the
178
+ * reader, with the same seat), and the first image of the frames sent unprocessed over the soft target is told to
179
+ * `prepared.imageUnprocessed`. */
180
+ export declare function readObjectiveAttachments(prepared: Pick<import("./runner/contracts.js").Prepared, "userAttachments" | "modelFileReader" | "syntheticReadVerdict" | "cwdRef" | "reminderMark" | "reminderDisclosureCounts" | "abortController" | "harness" | "modBus" | "hookIdentity" | "imageUnprocessed">, inputId: string, blocked: boolean, window: AttachmentWindowInput, imageSeat: ImageDownsampler | false | undefined): Promise<{
176
181
  frames: MintedAttachmentFrame[];
177
182
  chars: number;
178
183
  }>;
@@ -3,7 +3,8 @@ import { READ_OUTCOMES } from "../tools/fs/fs-read.js";
3
3
  import { renderDirectoryListing } from "../tools/fs/dir-entries.js";
4
4
  import { MAX_READ_OUTPUT_CHARS } from "../tools/fs/fs-shared.js";
5
5
  import { normalizeFileText } from "../tools/fs/encoding.js";
6
- import { ADMITTED_IMAGE_MIME_TYPES, admitImageBytes } from "./image-admission.js";
6
+ import { ADMITTED_IMAGE_MIME_TYPES, admitImageBytes, firstUnprocessedOverTarget, IMAGE_ADMISSION, unprocessedSizeClause } from "./image-admission.js";
7
+ import { resolveImageProcessor } from "./image-downsample.js";
7
8
  import { PDF_MAX_PAGES_PER_READ } from "../tools/fs/pdf.js";
8
9
  import { MARKED_BLOCK_AFTER_DATA, mintSystemReminder } from "./reminder-mint.js";
9
10
  import { commitReminderDisclosureEffects, planReminderDisclosure } from "./reminder-disclosure.js";
@@ -151,12 +152,12 @@ function declarationOf(a, ordinal) {
151
152
  ? { ordinal, supply: a.supply, path: a.path }
152
153
  : { ordinal, supply: a.supply, name: a.name, bytes: a.supply === "content_text" ? Buffer.byteLength(a.text, "utf8") : Buffer.from(a.data, "base64").byteLength };
153
154
  }
154
- export async function admitUserAttachmentImages(screened) {
155
+ export async function admitUserAttachmentImages(screened, processor) {
155
156
  const out = new Map();
156
157
  for (const [i, a] of screened.entries()) {
157
158
  if (a.supply !== "content_image")
158
159
  continue;
159
- const admitted = await admitImageBytes(Buffer.from(a.data, "base64"), a.mimeType, undefined);
160
+ const admitted = await admitImageBytes(Buffer.from(a.data, "base64"), a.mimeType, processor);
160
161
  if (admitted.ok) {
161
162
  out.set(i + 1, admitted.block);
162
163
  continue;
@@ -166,11 +167,14 @@ export async function admitUserAttachmentImages(screened) {
166
167
  case "mime_unsupported":
167
168
  throw userAttachmentRefusal(memberRef(imageAt, "mimeType"), `must be one of ${ADMITTED_IMAGE_MIME_TYPES.join(", ")}.`);
168
169
  case "magic_mismatch":
169
- throw userAttachmentRefusal(memberRef(imageAt, "data"), `does not begin with a ${a.mimeType} signature (empty, mis-declared, or not base64) — refused rather than sent.`);
170
+ throw userAttachmentRefusal(memberRef(imageAt, "data"), `does not open with a valid ${a.mimeType} header (empty, truncated, mis-declared, not base64, or a variant such as an Apple-optimized PNG that model APIs cannot read) — refused rather than sent.`);
170
171
  case "raw_too_large":
171
172
  throw userAttachmentRefusal(memberRef(imageAt, "data"), `${admitted.rawBytes} bytes, over the ${admitted.cap}-byte cap.`);
173
+ case "dimensions_unreadable":
174
+ case "dimensions_too_large":
175
+ throw userAttachmentRefusal(memberRef(imageAt, "data"), `refused rather than sent: ${unprocessedSizeClause(admitted)}.`);
172
176
  case "base64_too_large":
173
- throw userAttachmentRefusal(memberRef(imageAt, "data"), `base64 of ${admitted.base64.length} characters, over the API's 5 MB image limit — shrink the image first.`);
177
+ throw userAttachmentRefusal(memberRef(imageAt, "data"), `base64 of ${admitted.base64.length} characters, over the API's ${IMAGE_ADMISSION.hard.imageBase64Chars}-character image limit — shrink the image first.`);
174
178
  }
175
179
  }
176
180
  return out;
@@ -485,15 +489,16 @@ function refuseFramesOverWindow(frames, model, window) {
485
489
  const n = frames.length;
486
490
  throw userAttachmentRefusal(SEAT_REF, `the ${n} ${n === 1 ? "attachment" : "attachments"} and the objective come to about ${tokens} tokens, over the ${budget} tokens one request can hold on this model — to send it the engine would have to drop the objective or some of the attachments. Nothing was sent; attach fewer or smaller parts.`);
487
491
  }
488
- export async function readObjectiveAttachments(prepared, inputId, blocked, window) {
492
+ export async function readObjectiveAttachments(prepared, inputId, blocked, window, imageSeat) {
489
493
  if (blocked || prepared.userAttachments === undefined)
490
494
  return { frames: [], chars: 0 };
495
+ const processor = await resolveImageProcessor(imageSeat);
491
496
  const frames = await readUserAttachments({
492
497
  screened: prepared.userAttachments,
493
498
  inputId,
494
499
  reader: prepared.modelFileReader,
495
500
  judge: prepared.syntheticReadVerdict,
496
- images: await admitUserAttachmentImages(prepared.userAttachments),
501
+ images: await admitUserAttachmentImages(prepared.userAttachments, processor),
497
502
  cwd: prepared.cwdRef?.current,
498
503
  mark: prepared.reminderMark,
499
504
  counts: prepared.reminderDisclosureCounts,
@@ -501,6 +506,9 @@ export async function readObjectiveAttachments(prepared, inputId, blocked, windo
501
506
  mentions: { bus: prepared.modBus, ...(agentIdOf(prepared.hookIdentity) !== undefined ? { agentId: agentIdOf(prepared.hookIdentity) } : {}) },
502
507
  });
503
508
  refuseFramesOverWindow(frames, prepared.harness.getModel(), window);
509
+ const unprocessed = firstUnprocessedOverTarget(frames.flatMap((f) => f.seed.content), processor);
510
+ if (unprocessed !== undefined)
511
+ prepared.imageUnprocessed(unprocessed);
504
512
  return { frames, chars: frames.reduce((n, f) => n + f.seed.content.reduce((m, b) => m + (b.type === "text" ? b.text.length : 0), 0), 0) };
505
513
  }
506
514
  export const COMPACTION_RESTORE_PROBE_FACE = "compaction-restore";
@@ -24,7 +24,7 @@ import { type PermissionMode } from "./ask-origin.js";
24
24
  import type { RunnerDeps, TaskSpec } from "./types.js";
25
25
  import { type StoreDurability } from "./checkpoint-store.js";
26
26
  import type { ModAdmissionRecord } from "./mods/kernel/index.js";
27
- import type { McpDelivered, McpFailureKind, McpServerLiveness } from "./mcp-failure.js";
27
+ import type { McpAuthorization, McpDelivered, McpFailureKind, McpServerLiveness } from "./mcp-failure.js";
28
28
  import type { WriteProtectionTargetView } from "./write-protect.js";
29
29
  import type { OnAsk } from "./tool-policy.js";
30
30
  import { type RunOrigin } from "./run-origin.js";
@@ -114,8 +114,8 @@ export interface AutoModeArmFact {
114
114
  * One declared MCP server's materialization result for THIS leg — the per-server connection-state
115
115
  * read face on {@link WiringManifest.mcp}. `status` is the connect-time verdict of this leg's
116
116
  * materialize (a snapshot, never a heartbeat — the same semantics as `MaterializedMcp.statuses`,
117
- * which it is projected from): `connected` (tools listed; `toolCount` = see the field), `failed` (the connect or the tool listing threw — `errorCode`/`delivered`/`httpStatus` are the
118
- * failure record spread flat (see the MCP failure vocabulary's `McpFailure`), `error` the
117
+ * which it is projected from): `connected` (tools listed; `toolCount` = see the field), `failed` (the connect or the tool listing threw — `errorCode`/`delivered`/`httpStatus`/`authorization` are the
118
+ * failure record spread flat (see the MCP failure vocabulary's `McpFailure` and `failureFields`), `error` the
119
119
  * neutralized, length-bounded remote text), `skipped` (declared on the spec but this leg produced no
120
120
  * status for it — the materialization did not reach it). `source` is the DECLARING side's own label
121
121
  * (`McpServerSpec.source`: plugin / user / project / local, or anything the deployment writes),
@@ -129,6 +129,9 @@ export interface WiringManifestMcpEntry {
129
129
  errorCode?: McpFailureKind;
130
130
  delivered?: McpDelivered;
131
131
  httpStatus?: number;
132
+ /** The `unauthorized` failure's authorization fact (`McpAuthorization`): present iff `errorCode === "unauthorized"`, copied whole
133
+ * from the status record (`authorizeUrl` the deployment seat's, `resourceMetadataUrl` the endpoint's own UNTRUSTED claim). */
134
+ authorization?: McpAuthorization;
132
135
  error?: string;
133
136
  /** How many of the server's tools the roster the row is read against holds: a run's roster (the valve and the deployment's
134
137
  * `toolFaces` overlay applied — a tool either one leaves off is not counted), or, for `probeMcpServers` (no run, so no lists),
@@ -583,10 +583,36 @@ function createSummarizationOptions(model, maxTokens, apiKey, headers, signal, t
583
583
  return options;
584
584
  }
585
585
  async function completeSummarization(model, context, options, streamFn, runtime) {
586
- if (streamFn) {
587
- return (await streamFn(model, context, options)).result();
586
+ const call = async () => streamFn ? (await streamFn(model, context, options)).result() : await resolveAgentCoreCompleteFn(runtime)(model, context, options);
587
+ const signal = options.signal;
588
+ if (signal === undefined)
589
+ return await call();
590
+ if (signal.aborted)
591
+ return summaryCallAborted(model);
592
+ let release = () => undefined;
593
+ const cut = new Promise((resolve) => {
594
+ const onAbort = () => resolve(summaryCallAborted(model));
595
+ signal.addEventListener("abort", onAbort, { once: true });
596
+ release = () => signal.removeEventListener("abort", onAbort);
597
+ });
598
+ try {
599
+ return await Promise.race([cut, call()]);
600
+ }
601
+ finally {
602
+ release();
588
603
  }
589
- return await resolveAgentCoreCompleteFn(runtime)(model, context, options);
604
+ }
605
+ function summaryCallAborted(model) {
606
+ return {
607
+ role: "assistant",
608
+ content: [],
609
+ api: model.api,
610
+ provider: model.provider,
611
+ model: model.id,
612
+ usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
613
+ stopReason: "aborted",
614
+ timestamp: Date.now(),
615
+ };
590
616
  }
591
617
  const SUMMARY_REASONING_FLOOR = 2048;
592
618
  const SUMMARY_MAX_ESCALATIONS = 2;
@@ -2,7 +2,7 @@ import { type FileHandle } from "node:fs/promises";
2
2
  import { type BoundFileObject, type ExecResult, type ExecutionEnv, ExecutionError, type ExecutionEnvExecOptions, FileError, type FileInfo, type Result } from "../harness/types.js";
3
3
  import { type SecretEnvFinding } from "../../core/secret-env.js";
4
4
  import type { EngineNotice } from "../../core/engine-notice.js";
5
- import type { SymlinkChain } from "../harness/types.js";
5
+ import type { ExecutionEnvCapabilities, SymlinkChain } from "../harness/types.js";
6
6
  import type { BackgroundHardKillOutcome, BackgroundShellCapability, BackgroundShellId, BackgroundPoll, BackgroundSpawnOptions } from "../../core/background-shell.js";
7
7
  import { BackgroundShellError } from "../../core/background-shell.js";
8
8
  import type { SchedulerCapability, ScheduledIntent, SchedulerContext, ScheduledTaskId, ScheduledTaskSummary } from "../../core/scheduler.js";
@@ -82,6 +82,9 @@ export declare function openSpoolPair(base: string): {
82
82
  };
83
83
  export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCapability, SchedulerCapability {
84
84
  cwd: string;
85
+ /** `ExecutionEnv.capabilities`: the engine's own host — commands are this process's children on its own disk, not
86
+ * contained, not snapshotable; its resolver always answers; it does not keep the byte floor (no process confinement). */
87
+ readonly capabilities: ExecutionEnvCapabilities;
85
88
  /** `ExecutionEnv.homeDir` = the `HOME` the shell child receives (its `~`/`$HOME`/`${HOME}` all expand to it), read LIVE off the same `shellEnv`-over-`inheritEnv` merge each exec gets; ABSENT when the
86
89
  * child gets none (an allowlist that withholds it: `~` then falls back to passwd while `$HOME` is empty — two values, no single home, home-relative operands stay fail-closed). Residual: a per-exec `env.HOME` override. */
87
90
  get homeDir(): string | undefined;
@@ -93,8 +96,8 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
93
96
  get withheldEnv(): readonly SecretEnvFinding[];
94
97
  /** The environment the next shell child would receive, for a READ (the scrub seat is the reader's collector or a
95
98
  * no-op: a read announces nothing). `undefined` when no child would be spawned at all — the policy is refused against
96
- * the own credentials declared since construction, and every spawn throws that reason — so a reader sees "the child
97
- * gets none", never a throw. */
99
+ * the own credentials declared since construction, or `shellEnv` is no grant, and every spawn throws that reason — so
100
+ * a reader sees "the child gets none", never a throw. Composed once: the refusal is the composition's own. */
98
101
  private childEnvForRead;
99
102
  private shellPath?;
100
103
  private shellEnv?;
@@ -118,7 +121,8 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
118
121
  shellEnv?: NodeJS.ProcessEnv;
119
122
  /** VENDORED EDIT (D1, security): how much of `process.env` the shell child inherits. Default `"scrub"` =
120
123
  * fail-closed (drop secret-pattern keys, keep PATH/build/locale). `"all"` = full inherit (trusted env);
121
- * `string[]` = strict allowlist. `shellEnv`/per-exec `env` always pass through. Any other value — an unknown
124
+ * `string[]` = strict allowlist. `shellEnv`/per-exec `env` always pass through (`hostChildEnv`'s grants: one that is
125
+ * not a map of variable names to strings throws here and at the spawn). Any other value — an unknown
122
126
  * word, a non-string, a list entry that is not a variable name — throws here (`inheritEnvPolicyProblem`'s
123
127
  * reason), the same judgment the oracle gate's `inheritEnv` meets. Whatever the policy, the deployment's own
124
128
  * credentials (`declareWithheldEnv`: by name, and by a value equal to a declared or engine-held credential value)
@@ -171,7 +175,9 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
171
175
  * (Esc during a large Write — ctx.signal reaches here directly), ENOSPC, or a crash left the target as
172
176
  * a torn prefix of the NEW content with the original unrecoverable. Post-fix contract: the target is
173
177
  * either fully old or fully new; `aborted` means it was never touched. Known semantic change (same as
174
- * CC): rename breaks a hard link — the other link keeps the old content. */
178
+ * CC): rename breaks a hard link — the other link keeps the old content. The replacement is a new inode made
179
+ * by the writing process: its owner is the writer and its group follows the new-file rule, so the target's
180
+ * group bits can land on another group; no fchown (KL-3120-b). */
175
181
  writeFile(path: string, content: string | Uint8Array, abortSignal?: AbortSignal): Promise<Result<void, FileError>>;
176
182
  /** RB-221: the historical single-step in-place overwrite — kept for targets where
177
183
  * staging+rename would change node identity (symlink chains, non-regular files) and as the
@@ -7,7 +7,7 @@ import { dirname, isAbsolute, join, sep } from "node:path";
7
7
  import { createInterface } from "node:readline";
8
8
  import { ExecutionError, err, FileError, ok, toError, } from "../harness/types.js";
9
9
  import { killProcessTree, shutdownDebug } from "./kill-tree.js";
10
- import { __resetSecretEnvScrubNoticeAnnouncement, announceSecretEnvScrub, inheritEnvPolicyProblem, inheritedHostEnv } from "../../core/secret-env.js";
10
+ import { __resetSecretEnvScrubNoticeAnnouncement, announceSecretEnvScrub, hostChildEnv, hostChildEnvProblem, inheritedHostEnv } from "../../core/secret-env.js";
11
11
  import { physicalPathOfAsync } from "../../core/physical-path.js";
12
12
  import { posixModeBitsMeaningful } from "../../core/posix-mode-face.js";
13
13
  import { anchorAtLinkDir, walkSymlinkChain } from "./symlink-chain.js";
@@ -15,6 +15,16 @@ import { RollingTailBuffer, markTruncated, newStreamCursorState, sliceStreamIncr
15
15
  import { BackgroundShellError } from "../../core/background-shell.js";
16
16
  import { SchedulerError } from "../../core/scheduler.js";
17
17
  const MAX_TIMER_TIMEOUT_MS = 2_147_000_000;
18
+ const NODE_ENV_CAPABILITIES = Object.freeze({
19
+ isolation: false,
20
+ suspendable: false,
21
+ sharesProcessTable: true,
22
+ canonicalPathAuthoritative: true,
23
+ hostLocalPaths: true,
24
+ externalContentTarget: false,
25
+ io: true,
26
+ keepsReadFloor: false,
27
+ });
18
28
  function resolvePath(cwd, path) {
19
29
  if (isAbsolute(path))
20
30
  return path;
@@ -248,9 +258,7 @@ export function __resetSecretScrubAnnouncement() {
248
258
  __resetSecretEnvScrubNoticeAnnouncement();
249
259
  }
250
260
  function getShellEnv(inheritEnv, baseEnv, extraEnv, onScrub, onNotice) {
251
- const scrubbed = [];
252
- const inherited = inheritedHostEnv(inheritEnv, scrubbed);
253
- const findings = scrubbed.filter((f) => baseEnv?.[f.key] === undefined && extraEnv?.[f.key] === undefined);
261
+ const { env, withheld: findings } = hostChildEnv(inheritEnv, baseEnv, extraEnv);
254
262
  if (findings.length > 0) {
255
263
  if (typeof onScrub === "function") {
256
264
  try {
@@ -275,11 +283,7 @@ function getShellEnv(inheritEnv, baseEnv, extraEnv, onScrub, onNotice) {
275
283
  announceSecretEnvScrub(onNotice, findings);
276
284
  }
277
285
  }
278
- return {
279
- ...inherited,
280
- ...baseEnv,
281
- ...extraEnv,
282
- };
286
+ return env;
283
287
  }
284
288
  const EXIT_SETTLE_DRAIN_MS = 500;
285
289
  const EXEC_SPOOL_PUMP_MS = 200;
@@ -320,6 +324,7 @@ export function openSpoolPair(base) {
320
324
  }
321
325
  export class NodeExecutionEnv {
322
326
  cwd;
327
+ capabilities = NODE_ENV_CAPABILITIES;
323
328
  get homeDir() {
324
329
  return this.childEnvForRead()?.HOME;
325
330
  }
@@ -333,9 +338,12 @@ export class NodeExecutionEnv {
333
338
  return withheld;
334
339
  }
335
340
  childEnvForRead(collect = () => { }) {
336
- if (inheritEnvPolicyProblem(this.inheritEnv) !== undefined)
341
+ try {
342
+ return getShellEnv(this.inheritEnv, this.shellEnv, undefined, collect);
343
+ }
344
+ catch {
337
345
  return undefined;
338
- return getShellEnv(this.inheritEnv, this.shellEnv, undefined, collect);
346
+ }
339
347
  }
340
348
  shellPath;
341
349
  shellEnv;
@@ -353,7 +361,7 @@ export class NodeExecutionEnv {
353
361
  this.cwd = options.cwd;
354
362
  this.shellPath = options.shellPath;
355
363
  this.shellEnv = options.shellEnv;
356
- const inheritEnvProblem = inheritEnvPolicyProblem(options.inheritEnv);
364
+ const inheritEnvProblem = hostChildEnvProblem(options.inheritEnv, options.shellEnv);
357
365
  if (inheritEnvProblem !== undefined)
358
366
  throw new Error(`NodeExecutionEnv: ${inheritEnvProblem}`);
359
367
  this.inheritEnv = Array.isArray(options.inheritEnv) ? [...options.inheritEnv] : (options.inheritEnv ?? "scrub");
@@ -889,7 +897,7 @@ export class NodeExecutionEnv {
889
897
  const tmp = `${target}.tmp.${process.pid}.${randomUUID().replace(/-/g, "").slice(0, 12)}`;
890
898
  let tmpDurable = false;
891
899
  try {
892
- const handle = await open(tmp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | (constants.O_NOFOLLOW ?? 0));
900
+ const handle = await open(tmp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | (constants.O_NOFOLLOW ?? 0), existingMode === undefined ? 0o666 : 0o600);
893
901
  try {
894
902
  await handle.writeFile(content, { signal: abortSignal });
895
903
  if (existingMode !== undefined) {
@@ -1,5 +1,6 @@
1
1
  import type { ActorAssertion, AssistantMessage, ImageContent, Model, TextContent, UserMessage, UserMessageAttachment } from "../llm/index.js";
2
2
  import { type ToolTurnRepair } from "../llm/index.js";
3
+ import { type RejectedImageRemoval } from "../llm/rejected-images.js";
3
4
  import { runToolCall, type ExecutedToolCallOutcome } from "../loop/agent-loop.js";
4
5
  import type { HaltRemainingDirective } from "../loop/types.js";
5
6
  import type { AgentMessage, AgentTool, AgentToolCall, LoopMalformedToolUseRecovery, LoopThinkingOnlyRecovery, LoopTruncatedOutputRecovery, QueueMode, ThinkingLevel } from "../loop/types.js";
@@ -214,6 +215,13 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
214
215
  * with every request view that needed one (the transcript is never rewritten, so a broken turn is repaired, and
215
216
  * reported, on each request; the sink owns its dedup). Advisory: a throwing sink never breaks the request. */
216
217
  onToolTurnRepaired?: (repairs: readonly ToolTurnRepair[]) => void;
218
+ /** Runner-set sink for the images a provider refused in THIS run ({@link removeRejectedImages}) — a refusal recorded
219
+ * before the run began is not reported. Every request re-reads the transcript, so the sink owns its dedup (by
220
+ * `refusalAt`). Advisory: a throwing sink never breaks the request. */
221
+ onImagesRemoved?: (removals: readonly RejectedImageRemoval[]) => void;
222
+ /** The image refusals standing in the transcript when the current run began, by their identity
223
+ * ({@link RejectedImageRemoval.refusalAt}): the run that met them announced them. */
224
+ private priorImageRefusals?;
217
225
  /** The assistant messages standing in the transcript when the current run began — what the request view reads as
218
226
  * "before this run" (a message is the run's own unless it is in here). */
219
227
  private runHistory?;
@@ -222,10 +230,16 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
222
230
  * hands ENGINE payloads back for redelivery; user inputs have no redelivery semantics (a steer
223
231
  * aimed at a finished run must not silently fire at the next one), so their loss is ANNOUNCED
224
232
  * instead — the runner surfaces it as an operator notice, closing the "accepted then silently
225
- * dropped" window the #257 contract could only document. */
233
+ * dropped" window the #257 contract could only document. The second argument hands over the OPAQUE park records of the
234
+ * counted inputs that carried one, per lane in service order — the order the queue would serve them, so an
235
+ * `immediate`-class input leads the ones accepted before it (never interpreted here; the runner reads which input each
236
+ * is) — a lane's list shorter than its count means some counted input had none. */
226
237
  onUndrainedUserInputs?: (counts: {
227
238
  steer: number;
228
239
  followUp: number;
240
+ }, parkRecords?: {
241
+ steer: readonly unknown[];
242
+ followUp: readonly unknown[];
229
243
  }) => void;
230
244
  /** design/176 — runner-set sink fired at the CONSUMPTION boundary, once per engine-note payload,
231
245
  * in consumption order (steer/followUp drain and the turn-open nextTurn splice — the two points
@@ -262,6 +276,9 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
262
276
  * minted it. */
263
277
  engineInjectionsHeld?: () => boolean;
264
278
  /** The provider boundary's tool-turn law: the repaired view goes to the brain, the repairs to the runner's sink. */
279
+ /** The request view of `messages` under the provider's image refusals they hold ({@link removeRejectedImages}), and
280
+ * the removals this run met handed to {@link onImagesRemoved}. */
281
+ private imageRefusalView;
265
282
  private holdToolTurnLaw;
266
283
  /** RB-30 R2 belt-and-braces: runner-callable idempotent recovery for exit paths that reach
267
284
  * neither agent_end nor abort() (a pre-prompt throw after prepare). Swept entries are removed,
@@ -281,6 +298,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
281
298
  * frames are excluded, and the IN-FLIGHT slot counts (a frame spliced out of a queue and never injected
282
299
  * is as pending as one that never left it).
283
300
  */
301
+ private pendingUserInputFramesByLane;
284
302
  private pendingUserInputsByLane;
285
303
  /**
286
304
  * Is a PERSON's input waiting for this run's NEXT TURN BOUNDARY? The live read face over
@@ -321,7 +339,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
321
339
  private activeRun?;
322
340
  private loopTrace?;
323
341
  private onToolInputValidationFault?;
324
- private onToolMediaRefused?;
342
+ private toolResultMedia;
325
343
  private resilience?;
326
344
  private maxToolConcurrency?;
327
345
  private streamingToolExecution?;
@@ -637,11 +655,16 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
637
655
  * on a checkpoint, so their live frames leave the queues (identity-matched on the sidecar). Dropping
638
656
  * them here is what keeps the terminal `#259` account honest — a migrated instruction is not "accepted
639
657
  * then lost", and one this is never called for (a failed commit) still gets its loud undrained notice.
640
- * Returns the per-lane drop counts so the caller can subtract them from an account already taken.
658
+ * Returns the per-lane drop counts so the caller can subtract them from an account already taken, and the dropped
659
+ * records themselves per lane (opaque, in the order the queues held them) so it can subtract by identity too.
641
660
  */
642
661
  dropParkedUserInputs(records: readonly unknown[]): {
643
662
  steer: number;
644
663
  followUp: number;
664
+ records: {
665
+ steer: unknown[];
666
+ followUp: unknown[];
667
+ };
645
668
  };
646
669
  /**
647
670
  * backlog #389 (`control_request:"interrupt"`) — an interrupt does