@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
@@ -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`
@@ -819,6 +825,13 @@ export interface ToolExecuteContext {
819
825
  * the tool runs outside a Runner task.
820
826
  */
821
827
  parentCwd?: string;
828
+ /**
829
+ * The RUNNING task's own placement target (Runner-filled, read-only, never a model argument): what its execution
830
+ * environment reported as its workspace settled. A delegation tool hands it, as is, to every agent it spawns or wakes
831
+ * (`RunInternals.placementTarget` — the fence that agent's env is minted under). Absent outside a Runner task, and when
832
+ * the environment reported none (not remote, or its handle could not answer yet).
833
+ */
834
+ placementTarget?: import("./remote-env.js").PlacementTarget;
822
835
  /** The deployment's compiled host floor (`RunnerDeps.hostFloor`; Runner-filled, read-only, never a model argument): an engine executor
823
836
  * that connects — the fetch tool on every hop, WebSearch's SearXNG backend (handed it in the backend's `opts.hostFloor`) — judges each URL
824
837
  * by it before the request. Absent outside a Runner, or when none is declared. */
@@ -958,8 +971,8 @@ export interface ToolExecuteContext {
958
971
  * from its roster, so a question it needed to ask silently became a guess.
959
972
  *
960
973
  * Forwarded VERBATIM, unlike `onAsk`'s provenance-stamped wrapper: a content ask carries its issuing
961
- * identity in the request itself (`AskQuestionRequest.principal` + `sourceTaskId`, which the child's
962
- * own prepare fills from the child's inherited principal and its Runner-minted session id), and
974
+ * identity in the request itself (`AskQuestionRequest.principal` + `sourceSessionId` + `agentId`, which the
975
+ * child's own prepare fills from the child's inherited principal, its Runner-minted session id and its task id), and
963
976
  * nothing in the question path does approver-identity collapse (the reason the permission wrapper
964
977
  * exists). Wrapping here would add a field no consumer reads and a second function identity for one
965
978
  * decision-maker.
@@ -1174,10 +1187,11 @@ export interface ToolExecuteContext {
1174
1187
  /**
1175
1188
  * A read-only CAPTURE of this (parent) task's request allow entries for the run ({@link import("./task-spec.js").TaskSpec.allowedTools},
1176
1189
  * its own and any it inherited), filled by the Runner beside {@link activeSkillGrants}: a delegation tool reads it AT SPAWN
1177
- * TIME and threads it into the child, which holds them as its own request rows until it ends. A copy; the model can
1178
- * neither read nor set it. Undefined when the tool runs outside a Runner task.
1190
+ * TIME and threads it into the child, which holds them as its own request rows until it ends — an anchored member with its
1191
+ * set's anchors, so the child reads its path rule where the parent did. A copy; the model can neither read nor set it.
1192
+ * Undefined when the tool runs outside a Runner task.
1179
1193
  */
1180
- activeRequestAllowedTools?: () => readonly string[];
1194
+ activeRequestAllowedTools?: () => readonly import("./allow-entry.js").AllowListEntry[];
1181
1195
  /**
1182
1196
  * Parent effective-policy inheritance (tighten-only) — the Runner-filled chain accessor a delegation tool
1183
1197
  * (`createSubagentTool` / the `run_workflow` spawn legs) calls AT SPAWN TIME and threads verbatim into the
@@ -1285,7 +1299,7 @@ export interface ToolExecuteContext {
1285
1299
  */
1286
1300
  checkpointScopeForChildren?: string;
1287
1301
  /**
1288
- * design/99 (nested-subagent live observability): the host run's stable taskId (`spec.taskId ?? sessionId`),
1302
+ * design/99 (nested-subagent live observability): the host run's stable taskId (the leg's single mint),
1289
1303
  * filled by the Runner. A delegation tool (`createSubagentTool`) reads it AT SPAWN TIME and threads it into the
1290
1304
  * child as the child's `parentTaskId`, so a UI can build the live nested-agent tree (child.parentTaskId === this
1291
1305
  * taskId). Undefined when the tool runs outside a Runner task.
@@ -1318,6 +1332,10 @@ export interface ToolExecuteContext {
1318
1332
  onTaskNotification?: (n: import("./task-notification.js").TaskNotificationPayload, opts?: {
1319
1333
  priority?: import("./task-notification.js").SystemInjectionPriority;
1320
1334
  }) => unknown;
1335
+ /** Where a background task's result is stored when its completion notification ({@link onTaskNotification}) carries
1336
+ * less than the whole of it — the run's offload store, read back with `ReadToolResult`. Present exactly when the run
1337
+ * has one; absent ⇒ a cut notification says the full text is not readable from this session. TRUSTED, run-scoped. */
1338
+ taskArtifacts?: import("./tool-result-store.js").TaskArtifactSeat;
1321
1339
  /**
1322
1340
  * design/99 (nested-subagent live observability): the host run's OPT-IN display sink — a deployment sets it (via
1323
1341
  * `RunInternals.onForwardEvent`) to receive a SUBAGENT's live `task_progress` ticks that otherwise stay in the
@@ -1384,6 +1402,17 @@ export interface ToolExecuteContext {
1384
1402
  forkAccess?: {
1385
1403
  denied: "task" | "principal";
1386
1404
  };
1405
+ /**
1406
+ * The delegating leg's two agent stations over its mods bus — `agent.offer` (the offered set the delegation reads at
1407
+ * dispatch) and `agent.spawn` (raised before a subagent is let start). Runner-filled; never a model argument. Absent
1408
+ * outside a Runner: no station is raised and every type is offered.
1409
+ */
1410
+ agentStations?: import("./mods/agent-stations.js").AgentStations;
1411
+ /**
1412
+ * The sending leg's `session.send` station over its mods bus — raised by SendMessage before it delivers a message.
1413
+ * Runner-filled; never a model argument. Absent outside a Runner: no station is raised.
1414
+ */
1415
+ sendStation?: import("./mods/session-send.js").SendStation;
1387
1416
  /**
1388
1417
  * design/80 D-B — the general "a tool yields to a HUMAN review gate" primitive. A tool calls this to request
1389
1418
  * that, at the next SAFE turn boundary, the engine pause with a durable `plan_review` checkpoint
@@ -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). */
@@ -97,7 +96,8 @@ export type TraceEvent = {
97
96
  version: 1;
98
97
  taskId: string;
99
98
  /** The ENGINE-minted identity of THIS run (`TaskResult.runId`). `taskId` is
100
- * `spec.taskId ?? sessionId`, so two runs of one session that declare no host task id emit two
99
+ * the leg's task id (a background row's id, else the declared one, else the session id), so two
100
+ * runs of one session that declare no host task id emit two
101
101
  * task.start frames under ONE id and a consumer pairing start↔end has no way to say which end
102
102
  * closes which start. Present on every `task.start` (the frame is emitted after prepare, which
103
103
  * is where the id is minted).
@@ -925,6 +925,22 @@ export type TraceEvent = {
925
925
  /** True = store.put failed (or no store): the model lost read-back for this result. */
926
926
  storeFallback: boolean;
927
927
  ts: number;
928
+ } | {
929
+ /** A request's media trim (`media-byte-cap.ts`) left blocks out of a request that was sent: one frame per such
930
+ * request (the person hears each block once per session, `context.media_removed`). `items` / `base64Chars` are the
931
+ * request's media before the trim; `budgetBase64Chars` is absent when the deployment set no budget. */
932
+ kind: "context.media_removed";
933
+ version: 1;
934
+ taskId: string;
935
+ reason: "media_budget";
936
+ images: number;
937
+ documents: number;
938
+ removedBase64Chars: number;
939
+ items: number;
940
+ base64Chars: number;
941
+ maxItems: number;
942
+ budgetBase64Chars?: number;
943
+ ts: number;
928
944
  } | {
929
945
  /** C4 — image blocks were replaced with text placeholders because the served model declares no
930
946
  * vision input (`ModelSpec.input` without "image"). Silent quality loss without this. */
@@ -18,12 +18,12 @@ 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";
@@ -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
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,14 +3,17 @@ 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";
10
11
  import { DEFAULT_CHARS_PER_TOKEN, estimateTokens, uuidv7 } from "../internal/harness.js";
11
12
  import { thrownText } from "./thrown-value.js";
13
+ import { optionKeys, receiveMembers } from "./own-property-receipt.js";
12
14
  import { guardBudget } from "./context-guard.js";
13
- import { agentIdOf, failedHandlerClause } from "./mods/stations.js";
15
+ import { failedHandlerClause } from "./mods/stations.js";
16
+ import { agentIdOf } from "./leg-identity.js";
14
17
  import { extensionWords } from "./untrusted-egress.js";
15
18
  export const USER_ATTACHMENTS_MAX = 20;
16
19
  export const USER_ATTACHMENT_LABEL_MAX = 4096;
@@ -74,10 +77,13 @@ function screenPositiveInt(v, at) {
74
77
  throw userAttachmentRefusal(at, "must be an integer of at least 1.");
75
78
  return v;
76
79
  }
77
- function onlyMembers(o, allowed, at) {
78
- for (const k of Object.keys(o))
79
- if (!allowed.includes(k))
80
- throw userAttachmentRefusal(memberRef(at, k), `is not a member of this attachment (allowed: ${allowed.join(", ")}).`);
80
+ const PATH_KEYS = optionKeys()({ path: 0, lines: 0 });
81
+ const LINES_KEYS = optionKeys()({ start: 0, end: 0 });
82
+ const TEXT_KEYS = optionKeys()({ name: 0, text: 0, startLine: 0 });
83
+ const IMAGE_KEYS = optionKeys()({ name: 0, image: 0 });
84
+ const IMAGE_BYTES_KEYS = optionKeys()({ data: 0, mimeType: 0 });
85
+ function onlyMembers(o, keys, at) {
86
+ return receiveMembers(o, { subject: at.path, unit: "member", moment: "when the attachment is screened" }, keys, (_, [k]) => userAttachmentRefusal(memberRef(at, String(k)), `is not a member of this attachment (allowed: ${keys.join(", ")}).`));
81
87
  }
82
88
  function screenEntry(raw, at) {
83
89
  if (!isPlainObject(raw))
@@ -89,17 +95,17 @@ function screenEntry(raw, at) {
89
95
  }
90
96
  switch (arm) {
91
97
  case "path": {
92
- onlyMembers(raw, ["path", "lines"], at);
93
- const path = screenLabel(raw.path, memberRef(at, "path"));
94
- const linesRaw = raw.lines;
98
+ const entry = onlyMembers(raw, PATH_KEYS, at);
99
+ const path = screenLabel(entry.path, memberRef(at, "path"));
100
+ const linesRaw = entry.lines;
95
101
  if (linesRaw === undefined)
96
102
  return { supply: "path", path };
97
103
  const linesAt = memberRef(at, "lines");
98
104
  if (!isPlainObject(linesRaw))
99
105
  throw userAttachmentRefusal(linesAt, "must be { start, end? }.");
100
- onlyMembers(linesRaw, ["start", "end"], linesAt);
101
- const start = screenPositiveInt(linesRaw.start, memberRef(linesAt, "start"));
102
- const endRaw = linesRaw.end;
106
+ const lines = onlyMembers(linesRaw, LINES_KEYS, linesAt);
107
+ const start = screenPositiveInt(lines.start, memberRef(linesAt, "start"));
108
+ const endRaw = lines.end;
103
109
  if (endRaw === undefined)
104
110
  return { supply: "path", path, lines: { start } };
105
111
  const end = screenPositiveInt(endRaw, memberRef(linesAt, "end"));
@@ -108,27 +114,27 @@ function screenEntry(raw, at) {
108
114
  return { supply: "path", path, lines: { start, end } };
109
115
  }
110
116
  case "text": {
111
- onlyMembers(raw, ["name", "text", "startLine"], at);
112
- const name = screenLabel(raw.name, memberRef(at, "name"));
113
- const text = raw.text;
117
+ const entry = onlyMembers(raw, TEXT_KEYS, at);
118
+ const name = screenLabel(entry.name, memberRef(at, "name"));
119
+ const text = entry.text;
114
120
  if (typeof text !== "string" || text.length === 0)
115
121
  throw userAttachmentRefusal(memberRef(at, "text"), "must be a non-empty string.");
116
- const startLine = raw.startLine === undefined ? 1 : screenPositiveInt(raw.startLine, memberRef(at, "startLine"));
122
+ const startLine = entry.startLine === undefined ? 1 : screenPositiveInt(entry.startLine, memberRef(at, "startLine"));
117
123
  const rendered = renderNumbered(text, startLine);
118
124
  if (rendered.length > MAX_READ_OUTPUT_CHARS)
119
125
  throw userAttachmentRefusal(memberRef(at, "text"), `renders to ${rendered.length} characters with line numbers, over the ${MAX_READ_OUTPUT_CHARS}-character limit a read may deliver — send a part of it.`);
120
126
  return { supply: "content_text", name, text, startLine, rendered };
121
127
  }
122
128
  case "image": {
123
- onlyMembers(raw, ["name", "image"], at);
124
- const name = screenLabel(raw.name, memberRef(at, "name"));
125
- const img = raw.image;
129
+ const entry = onlyMembers(raw, IMAGE_KEYS, at);
130
+ const name = screenLabel(entry.name, memberRef(at, "name"));
131
+ const img = entry.image;
126
132
  const imageAt = memberRef(at, "image");
127
133
  if (!isPlainObject(img))
128
134
  throw userAttachmentRefusal(imageAt, "must be { data, mimeType } (base64 bytes and the image's type).");
129
- onlyMembers(img, ["data", "mimeType"], imageAt);
130
- const data = img.data;
131
- const mimeType = img.mimeType;
135
+ const bytes = onlyMembers(img, IMAGE_BYTES_KEYS, imageAt);
136
+ const data = bytes.data;
137
+ const mimeType = bytes.mimeType;
132
138
  if (typeof data !== "string" || data.length === 0)
133
139
  throw userAttachmentRefusal(memberRef(imageAt, "data"), "must be a non-empty base64 string.");
134
140
  if (typeof mimeType !== "string" || !ADMITTED_IMAGE_MIME_TYPES.includes(mimeType)) {
@@ -151,12 +157,12 @@ function declarationOf(a, ordinal) {
151
157
  ? { ordinal, supply: a.supply, path: a.path }
152
158
  : { ordinal, supply: a.supply, name: a.name, bytes: a.supply === "content_text" ? Buffer.byteLength(a.text, "utf8") : Buffer.from(a.data, "base64").byteLength };
153
159
  }
154
- export async function admitUserAttachmentImages(screened) {
160
+ export async function admitUserAttachmentImages(screened, processor) {
155
161
  const out = new Map();
156
162
  for (const [i, a] of screened.entries()) {
157
163
  if (a.supply !== "content_image")
158
164
  continue;
159
- const admitted = await admitImageBytes(Buffer.from(a.data, "base64"), a.mimeType, undefined);
165
+ const admitted = await admitImageBytes(Buffer.from(a.data, "base64"), a.mimeType, processor);
160
166
  if (admitted.ok) {
161
167
  out.set(i + 1, admitted.block);
162
168
  continue;
@@ -169,8 +175,11 @@ export async function admitUserAttachmentImages(screened) {
169
175
  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
176
  case "raw_too_large":
171
177
  throw userAttachmentRefusal(memberRef(imageAt, "data"), `${admitted.rawBytes} bytes, over the ${admitted.cap}-byte cap.`);
178
+ case "dimensions_unreadable":
179
+ case "dimensions_too_large":
180
+ throw userAttachmentRefusal(memberRef(imageAt, "data"), `refused rather than sent: ${unprocessedSizeClause(admitted)}.`);
172
181
  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.`);
182
+ 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
183
  }
175
184
  }
176
185
  return out;
@@ -485,15 +494,16 @@ function refuseFramesOverWindow(frames, model, window) {
485
494
  const n = frames.length;
486
495
  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
496
  }
488
- export async function readObjectiveAttachments(prepared, inputId, blocked, window) {
497
+ export async function readObjectiveAttachments(prepared, inputId, blocked, window, imageSeat) {
489
498
  if (blocked || prepared.userAttachments === undefined)
490
499
  return { frames: [], chars: 0 };
500
+ const processor = await resolveImageProcessor(imageSeat);
491
501
  const frames = await readUserAttachments({
492
502
  screened: prepared.userAttachments,
493
503
  inputId,
494
504
  reader: prepared.modelFileReader,
495
505
  judge: prepared.syntheticReadVerdict,
496
- images: await admitUserAttachmentImages(prepared.userAttachments),
506
+ images: await admitUserAttachmentImages(prepared.userAttachments, processor),
497
507
  cwd: prepared.cwdRef?.current,
498
508
  mark: prepared.reminderMark,
499
509
  counts: prepared.reminderDisclosureCounts,
@@ -501,6 +511,9 @@ export async function readObjectiveAttachments(prepared, inputId, blocked, windo
501
511
  mentions: { bus: prepared.modBus, ...(agentIdOf(prepared.hookIdentity) !== undefined ? { agentId: agentIdOf(prepared.hookIdentity) } : {}) },
502
512
  });
503
513
  refuseFramesOverWindow(frames, prepared.harness.getModel(), window);
514
+ const unprocessed = firstUnprocessedOverTarget(frames.flatMap((f) => f.seed.content), processor);
515
+ if (unprocessed !== undefined)
516
+ prepared.imageUnprocessed(unprocessed);
504
517
  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
518
  }
506
519
  export const COMPACTION_RESTORE_PROBE_FACE = "compaction-restore";
@@ -135,7 +135,7 @@ export interface WorkflowJournalStore {
135
135
  /** (CC diagnostics parity, additive): a HUMAN/MODEL-readable coordinate for this run's journal —
136
136
  * the file store returns the on-disk jsonl path (CC "Read journal.jsonl" local form); a service store
137
137
  * returns its API route (cloud form). `undefined`/absent ⇒ the completion notification's diagnostics
138
- * line teaches only the TaskOutput route (which is always live). Engine-facing string, never parsed. */
138
+ * line names no journal (the record behind its ref still carries every agent's row). Engine-facing string, never parsed. */
139
139
  locator?(runId: string, scope: string): string | undefined;
140
140
  /**
141
141
  * ADMISSION for a resume, so two concurrent
@@ -222,6 +222,8 @@ export declare function queryWorkflowRuns(runs: Iterable<WorkflowRun>, scope: st
222
222
  * `WorkflowRun` the workflow keeps mutating — must not corrupt the stored row, and a returned run must not
223
223
  * be a live reference the caller can mutate back into the store).
224
224
  */
225
+ /** The retention knobs a workflow-run `reap` takes: an age bound and a keep-newest-N bound over the terminal runs. */
226
+ export declare const WORKFLOW_RUN_REAP_KNOBS: readonly ["maxAgeMs", "keep"];
225
227
  export declare class InMemoryWorkflowRunStore implements WorkflowRunStore {
226
228
  private runs;
227
229
  put(id: string, run: WorkflowRun): Promise<void>;
@@ -1,5 +1,5 @@
1
1
  import { runParkedOf } from "../orchestration/workflow-types.js";
2
- import { assertRetentionPolicy } from "./retention-policy.js";
2
+ import { receiveRetentionPolicy } from "./retention-policy.js";
3
3
  export function summarizeWorkflowRun(run) {
4
4
  const latestPhase = run.phases.at(-1);
5
5
  return {
@@ -53,6 +53,7 @@ export function queryWorkflowRuns(runs, scope, opts) {
53
53
  const limited = opts?.limit !== undefined ? rows.slice(0, Math.max(0, opts.limit)) : rows;
54
54
  return limited.map(summarizeWorkflowRun);
55
55
  }
56
+ export const WORKFLOW_RUN_REAP_KNOBS = Object.freeze(["maxAgeMs", "keep"]);
56
57
  export class InMemoryWorkflowRunStore {
57
58
  runs = new Map();
58
59
  async put(id, run) {
@@ -79,16 +80,16 @@ export class InMemoryWorkflowRunStore {
79
80
  return queryWorkflowRuns(this.runs.values(), scope, opts);
80
81
  }
81
82
  async reap(scope, now, opts) {
82
- assertRetentionPolicy("WorkflowRunStore.reap", opts);
83
- if (opts?.maxAgeMs === undefined && opts?.keep === undefined)
83
+ const policy = receiveRetentionPolicy("WorkflowRunStore.reap", opts, WORKFLOW_RUN_REAP_KNOBS);
84
+ if (policy.maxAgeMs === undefined && policy.keep === undefined)
84
85
  return 0;
85
86
  const terminal = [...this.runs.values()].filter((r) => r.scope === scope && isTerminalWorkflowStatus(r.status));
86
87
  terminal.sort((a, b) => b.createdAt - a.createdAt);
87
88
  const doomed = new Set();
88
89
  for (let i = 0; i < terminal.length; i++) {
89
90
  const r = terminal[i];
90
- const tooOld = opts.maxAgeMs !== undefined && (r.endedAt ?? r.createdAt) < now - opts.maxAgeMs;
91
- const overKeep = opts.keep !== undefined && i >= opts.keep;
91
+ const tooOld = policy.maxAgeMs !== undefined && (r.endedAt ?? r.createdAt) < now - policy.maxAgeMs;
92
+ const overKeep = policy.keep !== undefined && i >= policy.keep;
92
93
  if (tooOld || overKeep)
93
94
  doomed.add(r.id);
94
95
  }
@@ -0,0 +1,5 @@
1
+ import type { WorkflowRun } from "../orchestration/workflow-types.js";
2
+ /** Bind `run` to the `done` promise that settles for it — the run's starter, once, before the promise is handed out. */
3
+ export declare function bindSettledRun(done: Promise<unknown>, run: WorkflowRun): void;
4
+ /** The run `done` settles for; `undefined` for a promise no run was bound to (a handle its caller assembled itself). */
5
+ export declare function settledRunOf(done: Promise<unknown>): WorkflowRun | undefined;
@@ -0,0 +1,7 @@
1
+ const runOfDone = new WeakMap();
2
+ export function bindSettledRun(done, run) {
3
+ runOfDone.set(done, run);
4
+ }
5
+ export function settledRunOf(done) {
6
+ return runOfDone.get(done);
7
+ }
@@ -1,8 +1,8 @@
1
1
  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
- import type { EngineNotice } from "../../core/engine-notice.js";
5
- import type { SymlinkChain } from "../harness/types.js";
4
+ import { type EngineNotice } from "../../core/engine-notice.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,14 @@ 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 keeps the byte floor exactly when its starts are confined
87
+ * (`readFloorConfinement: "os"` on a host where the probe applied), and otherwise does not. */
88
+ readonly capabilities: ExecutionEnvCapabilities;
89
+ /** Every start carrying a floor runs under that floor's seatbelt profile (the probe applied at construction). */
90
+ private readonly confined;
91
+ /** Each profile's apply, once per text: `undefined` applied, else the launcher's reason. */
92
+ private readonly profileApplies;
85
93
  /** `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
94
  * 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
95
  get homeDir(): string | undefined;
@@ -151,6 +159,13 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
151
159
  * `code: "config.secret_env_scrubbed"`, `detail.names`); independent of `onSecretEnvScrub` (a raw
152
160
  * findings collector) except: that seat wired alone stays console-silent, as before this existed. */
153
161
  onNotice?: (notice: EngineNotice) => void;
162
+ /** Confine every start that carries a byte floor (`ExecutionEnvExecOptions.readFloor`) at the OS: `"os"` = on macOS,
163
+ * when the seatbelt base applies here (probed once, now), each such start runs under `sandbox-exec -p <the floor's
164
+ * profile>` and the environment declares `keepsReadFloor: true`; a floor the profile cannot express, or a profile that
165
+ * does not apply, refuses that start (`spawn_error` / `spawn_failed`, naming why) — it never runs unconfined. On any
166
+ * other host, or when the probe does not apply, the environment declares `false` and says so once on `onNotice`
167
+ * (`config.read_floor_confinement_unavailable`). Absent = no confinement (`false`). Any other value throws. */
168
+ readFloorConfinement?: "os";
154
169
  });
155
170
  get schedulerCapabilities(): SchedulerCapability["schedulerCapabilities"];
156
171
  schedule(intent: ScheduledIntent, ctx: SchedulerContext): Promise<Result<{
@@ -160,6 +175,10 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
160
175
  list(ctx: SchedulerContext): Promise<Result<ScheduledTaskSummary[], SchedulerError>>;
161
176
  absolutePath(path: string): Promise<Result<string, FileError>>;
162
177
  joinPath(parts: string[]): Promise<Result<string, FileError>>;
178
+ /** The program and arguments ONE shell start spawns: the shell as it is, or — on a confined environment, for a start
179
+ * carrying a floor — the shell under that floor's seatbelt profile; a floor the profile cannot express, or a profile the
180
+ * host does not apply, is the reason the start is refused (the command never runs, confined or not). */
181
+ private startOf;
163
182
  exec(command: string, options?: ExecutionEnvExecOptions): Promise<Result<ExecResult, ExecutionError>>;
164
183
  readTextFile(path: string, abortSignal?: AbortSignal): Promise<Result<string, FileError>>;
165
184
  readTextLines(path: string, options?: {
@@ -171,18 +190,29 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
171
190
  * The former single-step `writeFile` was an in-place O_TRUNC: an abort mid-write
172
191
  * (Esc during a large Write — ctx.signal reaches here directly), ENOSPC, or a crash left the target as
173
192
  * a torn prefix of the NEW content with the original unrecoverable. Post-fix contract: the target is
174
- * either fully old or fully new; `aborted` means it was never touched. Known semantic change (same as
175
- * CC): rename breaks a hard link — the other link keeps the old content. */
193
+ * either fully old or fully new; `aborted` means it was never touched — the in-place fallback legs
194
+ * judge the signal once, before their first byte, so they answer `aborted` (untouched), `ok` or their own
195
+ * error, never `aborted` after a truncation. Known semantic change (same as CC): rename breaks a hard link —
196
+ * the other link keeps the old content. The replacement is a new inode made by the writing process: its owner
197
+ * is the writer and its group follows the new-file rule, so the target's group bits can land on another group;
198
+ * no fchown (KL-3120-b). */
176
199
  writeFile(path: string, content: string | Uint8Array, abortSignal?: AbortSignal): Promise<Result<void, FileError>>;
177
200
  /** RB-221: the historical single-step in-place overwrite — kept for targets where
178
201
  * staging+rename would change node identity (symlink chains, non-regular files) and as the
179
- * CC-parity fallback for filesystems where the rename cannot work. NOT atomic by design. */
202
+ * CC-parity fallback for filesystems where the rename cannot work. NOT atomic by design, and
203
+ * deliberately not cancellable: the signal is judged once, here, before the first byte, and not again —
204
+ * so `aborted` never describes a target this write has truncated. */
180
205
  private writeFileInPlace;
181
206
  /** Atomic exclusive create ({@link FileSystem.writeFileExclusive}): Node `wx` flag = one
182
207
  * `open(O_CREAT|O_EXCL)` syscall — an existing file returns FileError `"already_exists"` and is left
183
208
  * untouched. The EEXIST→already_exists mapping lives HERE, on the exclusive-open step only — a parent
184
209
  * `mkdir` can also throw EEXIST (parent path component is a regular file) and that is NOT "the target
185
- * already exists" (fable review). Parent directories are created like writeFile. */
210
+ * already exists" (fable review). Parent directories are created like writeFile.
211
+ *
212
+ * The signal is judged before the first byte — at entry and after the parent `mkdir` — and is not handed to the write: the
213
+ * exclusive open creates the target itself, so a write cancelled after it would leave a new file holding a prefix of the
214
+ * content under an `aborted` answer. `aborted` therefore means no file was created; a write whose open has begun runs to its
215
+ * end and answers `ok` or its own error (the same rule as the in-place legs of {@link NodeExecutionEnv.writeFile}). */
186
216
  writeFileExclusive(path: string, content: string | Uint8Array, abortSignal?: AbortSignal): Promise<Result<void, FileError>>;
187
217
  appendFile(path: string, content: string | Uint8Array): Promise<Result<void, FileError>>;
188
218
  fileInfo(path: string): Promise<Result<FileInfo, FileError>>;
@@ -236,7 +266,7 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
236
266
  suffix?: string;
237
267
  }): Promise<Result<string, FileError>>;
238
268
  /** design/116 detach: adopt a RUNNING foreground child as a background shell. Pre-fills the bg tails with
239
- * the output captured so far (so TaskOutput's first read has the full history), attaches fresh data/close
269
+ * the output captured so far (so the first background read has the full history), attaches fresh data/close
240
270
  * handlers, and arms the default bg timeout. Returns undefined when the live-shell limit is hit (detach
241
271
  * refused; the exec keeps running in the foreground). */
242
272
  private adoptRunningChild;