@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
@@ -17,7 +17,7 @@ import type { HumanReviewGateRow } from "../task-result.js";
17
17
  import type { RepairBundle } from "../../agents/repair-loop.js";
18
18
  import type { SubagentRetainLedger } from "../../agents/retain-ledger.js";
19
19
  import type { BrainCallGuardrailRef } from "../../brain/timeout.js";
20
- import type { ActiveWorktreeSession, AgentHarness, AgentMessage, AgentTool, AnnouncedListingSnapshotInput, ExecutionEnv, ThinkingLevel } from "../../internal/harness.js";
20
+ import type { ActiveWorktreeSession, AgentHarness, AgentMessage, AgentTool, AnnouncedListingSnapshotInput, ExecutionEnv, LoopTerminalReason, RowAdmission, ThinkingLevel } from "../../internal/harness.js";
21
21
  import type { Model } from "../../internal/llm.js";
22
22
  import type { WorkflowSizeGuideline } from "../../orchestration/workflow-size-guideline.js";
23
23
  import type { ToolManifestRow } from "../../prompt-assembly/tool-catalog.js";
@@ -37,7 +37,7 @@ import type { Checkpoint, CheckpointState, CheckpointStore, CheckpointToken, Pen
37
37
  import type { ExecutionOutcomeRecordWord } from "../checkpoint-execution-record.js";
38
38
  import type { ClearedProjectionLedger, MicroCompactMachine, OccurrenceIndex } from "../context-edit.js";
39
39
  import type { ModBus } from "../mods/kernel/index.js";
40
- import type { LegModBus, LegMods, ModChainLink } from "../mods/stations.js";
40
+ import type { LegModBus, LegMods } from "../mods/stations.js";
41
41
  import type { HookInvocationIdentity, OrgGateVerdict, PermissionDeniedPayload, PostToolBatchCall, ToolGateInput } from "../hooks.js";
42
42
  import type { MaterializedMcp } from "../mcp.js";
43
43
  import type { MemoryEngine } from "../memory-engine/engine.js";
@@ -52,7 +52,7 @@ import type { ModelPricing } from "../pricing.js";
52
52
  import type { PushQueue } from "../push-queue.js";
53
53
  import type { SystemInjectionPriority, TaskNotificationPayload } from "../task-notification.js";
54
54
  import type { OnAsk, PermissionResult, ResolvedAsk, ToolCallRequest, ToolPolicy } from "../tool-policy.js";
55
- import type { RemoteExecutionEnv, SnapshotId, WorkspaceHandle } from "../remote-env.js";
55
+ import type { PlacementTarget, RemoteExecutionEnv, SnapshotId, WorkspaceHandle } from "../remote-env.js";
56
56
  import type { ToolDisclosureManifest } from "../trace.js";
57
57
  import type { AgentDefinition, Brain, CompactOutcome, ModelRef, ModelRoles, NestedUsageAccum, PermissionMode, RunnerDeps, ShellGateDoctrine, TaskEvent, TaskEventIdentity, TaskResult, TaskSpec, TaskStream, ToolActivity, ToolEffect } from "../types.js";
58
58
  import type { InheritedAutoModeFace, PermissionModeController } from "../mode-policy.js";
@@ -271,6 +271,9 @@ export interface Prepared {
271
271
  * the `Session` contract instead. */
272
272
  session: StoredSession;
273
273
  sessionId: string;
274
+ /** This leg's task id, minted ONCE at prepare ({@link import("../leg-identity.js").legTaskIdOf}): its identity, frames, events'
275
+ * `sourceTaskId`, trace frames and `TaskResult.taskId` read it here; none re-spells it. */
276
+ taskId: string;
274
277
  /**
275
278
  * THIS INVOCATION's own identity, minted once at the top of {@link prepareTask} and never
276
279
  * rewritten. The third id of the trio, and the only one the engine owns outright:
@@ -278,7 +281,7 @@ export interface Prepared {
278
281
  * - `sessionId` — the CONVERSATION's identity (shared by every run that continues it);
279
282
  * - `runId` — THIS call of the engine.
280
283
  *
281
- * The gap it closes: the repo-wide `spec.taskId ?? sessionId` spelling answers the same value for
284
+ * The gap it closes: the leg's task id ({@link taskId}) answers the same value for
282
285
  * two runs of one session whenever the host supplies no task id, so every per-run account keyed on
283
286
  * it FOLDED two runs into one row (two runs each losing one steer read as one run losing one).
284
287
  * A per-run account must key on this; a per-TASK fact (trace `taskId`, the host's own correlation
@@ -293,7 +296,7 @@ export interface Prepared {
293
296
  runId: string;
294
297
  /** The deployment's host floor as the config doors compiled it (absent ⇒ none declared) — the task images' guard reads it. */
295
298
  hostFloor?: import("../host-floor.js").HostFloor;
296
- /** The (owner, scope) key this run's registry-facing tools register rows under — (host task id, mount domain), minted once at prepare; the teardown sweeps read it and never re-derive it. */
299
+ /** The (owner, scope) key this run's registry-facing tools register rows under — ({@link taskId}, mount domain), minted once at prepare; the teardown sweeps read it and never re-derive it. */
297
300
  registryAccess: {
298
301
  readonly owner: string;
299
302
  readonly scope: string;
@@ -363,8 +366,10 @@ export interface Prepared {
363
366
  */
364
367
  toolOccurrences: import("./tool-occurrence.js").ToolOccurrenceTable;
365
368
  /**
366
- * The parent-thread human-rejection halt fact (see `maybeHumanRejectionHalt`): present from the
367
- * moment a bare human rejection halts the turn's batch until the run ends or the NEXT provider
369
+ * The parent-thread human-rejection halt fact (see `isBareHumanRefusal`): present from the
370
+ * moment a bare human rejection halts the turn's batch — or a resumed leg records one (a parked call's, a plan
371
+ * pause's; `rejectedToolCallId` then names the gated call, or the call that asked for the plan pause when the row
372
+ * recorded one) — until the run ends or the NEXT provider
368
373
  * request begins (user input continuing the run clears it). Consumers: the runner's stop gate
369
374
  * (suppress natural-end pushback / final-verify injection — engine continuations must not restart
370
375
  * a run a person just stopped), the turn-boundary engine steers (same reason), and the result
@@ -373,7 +378,7 @@ export interface Prepared {
373
378
  */
374
379
  batchHaltRef: {
375
380
  current?: {
376
- rejectedToolCallId: string;
381
+ rejectedToolCallId?: string;
377
382
  };
378
383
  };
379
384
  /** Summed usage of nested sub-runs (sub-agents) spawned by this task's tools. */
@@ -406,6 +411,9 @@ export interface Prepared {
406
411
  * states are their own values); the seat is optional only so a Prepared shape without the phase
407
412
  * cannot fabricate one. */
408
413
  effectiveMemoryScopes?: import("../types.js").EffectiveMemoryScopes;
414
+ /** The leg's placement fixed point as prepare resolved it ONCE — the value the env-factory ctx was minted with and the suspend
415
+ * stamp records — echoed on `TaskResult.placementRoot`. Absent when the resolution came out empty (`""` is absence). */
416
+ placementRoot?: string;
409
417
  /** The per-task logical cwd ref when a real shell is mounted (else undefined); the workspace frame reads it. */
410
418
  cwdRef?: CwdRef;
411
419
  /** The leg's `workspace_changed` seat (its one snapshot projection): the run binds the sink after `wiring_manifest` (the leg-start frame) and observes after each tool. */
@@ -474,7 +482,6 @@ export interface Prepared {
474
482
  readonly refused: string;
475
483
  readonly extension?: string;
476
484
  } | {
477
- readonly args: unknown;
478
485
  readonly admit: () => void;
479
486
  }>;
480
487
  /** The leg's `tool.call` station (`mods/tool-call.ts`) — every execution of a call passes it; absent when no handler hangs on the event. */
@@ -548,6 +555,19 @@ export interface Prepared {
548
555
  hookIdentity: HookInvocationIdentity;
549
556
  /** The leg's mods bus: one per leg, admitted at this leg's prepare (both seats, `plugin.register` run once for this leg). Every classic station raises its event on it; its `records` are the manifest's `mods[]`. */
550
557
  modBus: ModBus;
558
+ /** The leg's one admission seat (`session-append.ts`): a direct writer passes each row through it first (`appendAdmittedRow`). */
559
+ admitRows: RowAdmission;
560
+ /** The leg's one receiving station (`session-receive.ts`): the live lane, the turn-open redelivery and the box drain's pull
561
+ * hand every frame to it before the model reads it. */
562
+ receiveSeat: import("../task-notification.js").FrameReceiver;
563
+ /** The turn-open redelivery's hand-over while the receiving station judges it (set only when a handler listens and frames
564
+ * were parked): the leg's prompt waits on it, so what the station hands over is in the first model call. */
565
+ turnOpenRedelivery: {
566
+ current?: Promise<void>;
567
+ };
568
+ /** The leg's `session.compact` station and its `$.session.compact` window (`session-compact.ts`): every compaction lane runs
569
+ * its pass through it. */
570
+ compactStation: import("../mods/session-compact.js").CompactStation;
551
571
  /**
552
572
  * This session's DURABLE box, present iff this leg mounted the session-box drain (a top-level leg
553
573
  * over a cross-process-safe mailbox with a grammatical session id). The notification lane binds it
@@ -570,6 +590,8 @@ export interface Prepared {
570
590
  /** The pending commits of this leg's attachment frames, settled by the transcript-append receipt sink — the one place
571
591
  * an attachment's read effects are applied. Always present. */
572
592
  attachmentDelivery: import("../user-attachment.js").AttachmentDelivery;
593
+ /** The run's once-per-run account of an image sent unprocessed over the soft target — the tool-result seat's and the leg's (task images, attachments). */
594
+ imageUnprocessed: (bytes: number) => void;
573
595
  /** The leg's one file reader — the Read tool's own (one read state, one set of disclosure windows and counters),
574
596
  * handed to the leg's other carriers of a file. Present iff hands are mounted. */
575
597
  modelFileReader?: import("../../tools/fs/fs-read.js").ModelFileReader;
@@ -862,6 +884,11 @@ export interface Prepared {
862
884
  continuation: boolean;
863
885
  abortedBeforeTurnEnd: boolean;
864
886
  };
887
+ /** The word the loop's exit named (its terminal trace step; absent until it exits), read by the terminal arbitration
888
+ * (`ResultFlags.loopTerminal`) for the exits the final message cannot state. Always present. */
889
+ loopTerminalRef: {
890
+ reason?: LoopTerminalReason;
891
+ };
865
892
  /** Records the FIRST brain call this run's outer guardrail gave up on (see
866
893
  * {@link import("../../brain/timeout.js").withBrainCallGuardrail}). Always present; `timedOut`
867
894
  * stays absent unless the guardrail fired. The run loop reads it AFTER the loop settles and gives
@@ -958,7 +985,7 @@ export interface Prepared {
958
985
  * · protocol-tools — pushes the MCP tools (through the remote wrapper), RefreshMcpTools (servers declared),
959
986
  * the A2A tools; at RUN time its refresh closure splices a server's name-prefix domain out and back in;
960
987
  * · hands mount — pushes the hands band (env wired);
961
- * · delegation-surface — pushes TaskOutput/TaskStop (background ∨ workflow door), SendMessage (door ∨
988
+ * · delegation-surface — pushes TaskStop (background ∨ workflow door), SendMessage (door ∨
962
989
  * parentNotify ∨ peer lane, ∧ runner self ∧ no shadow), AgentTranscript (door ∧ runner self ∧ no shadow),
963
990
  * ListAgents (peer lane ∧ built-in SendMessage ∧ mountable), Monitor (background), EnterWorktree +
964
991
  * ExitWorktree (tracked cwd), ReadToolResult (offload store);
@@ -1219,15 +1246,23 @@ export interface Prepared {
1219
1246
  /** The posture composition's run-local half (the newest carrier's protection slot; the row last composed for). */
1220
1247
  postureFrameRef: import("../auto-mode-directive.js").PostureFrameRef;
1221
1248
  /** G1 通告层 — narrow getter over the process task registry: THIS run's visible live background tasks
1222
- * (pending / running / parked under the same owner/scope/session identity the TaskOutput/TaskStop tools
1223
- * use), EVERY one (`TaskRegistry.liveTasks`), as a projection (id/description/status — never
1224
- * handles/env/abort). Read by the post-compact listing (which caps what it renders), the resume's orphan
1225
- * diff and the stop hook's `backgroundTasks` view. */
1226
- listBackgroundTasks: () => Array<{
1249
+ * (pending / running / parked under the same owner/scope/session identity the TaskStop tool
1250
+ * uses), EVERY one (`TaskRegistry.liveTasks`), as a projection (id/description/status and the row's read handle,
1251
+ * `TaskRegistry.readHandleOf` — never handles/env/abort). Read by the post-compact listing (which caps what it
1252
+ * renders), the resume's orphan diff and the stop hook's `backgroundTasks` view. `{ settled: true }` = the same rows with
1253
+ * the finished ones too (`TaskRegistry.list`) — the whole-session notification loss's table, where a finished task's
1254
+ * lost frame is the likeliest loss and its read handle the one way back. */
1255
+ listBackgroundTasks: (opts?: {
1256
+ settled?: true;
1257
+ }) => Array<{
1227
1258
  id: string;
1228
1259
  description?: string;
1229
1260
  status: string;
1261
+ read?: string;
1230
1262
  }>;
1263
+ /** One task's read handle under the same identity (`TaskRegistry.readHandleOf`) — a live or terminal row this leg reaches;
1264
+ * `undefined` for an unreachable id or a row with nothing to read. Read by a dropped notification's disclosure line. */
1265
+ taskReadHandleOf: (taskId: string) => string | undefined;
1231
1266
  /** The parent-run subagent-retain ledger (present ONLY when `spec.retainSubagentSessions`
1232
1267
  * is enabled). The Runner disposes it (abort in-flight resumes + unpin + release every retained child
1233
1268
  * session) in the task's terminal `finally` — same UNCONDITIONAL posture as the background-agent reap:
@@ -1305,6 +1340,9 @@ export interface PrepareResume {
1305
1340
  /** The session leaf to rewind to (the suspension point) BEFORE reconcile — discards the abort's
1306
1341
  * off-branch "Operation aborted" writes so the resume engine resolves the pending batch cleanly. */
1307
1342
  leafId: string;
1343
+ /** The session rows the parked leg's port held past that leaf (`Checkpoint.heldRows`): the resumed harness's queue starts with
1344
+ * them and writes them at the transcript's first legal point. Absent ⇒ the park held none. */
1345
+ heldRows?: readonly AgentMessage[];
1308
1346
  /** Batch tool-call ids of the suspended turn — wake-reconcile SKIPS these (they are resumed, not
1309
1347
  * crash-interrupted; closing them with `[INTERRUPTED]` would DESTROY the suspended batch, §15.2 #7). */
1310
1348
  suspendedBatch: ReadonlySet<string>;
@@ -1374,13 +1412,15 @@ export interface PrepareResume {
1374
1412
  * (`"always"`): a child inherits it and cannot lift it. `permissionMode` is the ceiling a child's own
1375
1413
  * declaration is clamped under.
1376
1414
  * - **Opaque half** (`parentConstraints`): each ancestor's live caller `ToolPolicy` plus its FROZEN
1377
- * `onAsk`, ancestors first — and, for a hook-wired ancestor, a SECOND entry: its PreToolUse screening
1378
- * face folded into a `ToolPolicy` (`createPreToolUseConstraintPolicy`), carrying its own frozen
1379
- * approver/mandate/env axes (the `preToolUse`/`hookEnv` fields below). Folded AFTER the child's own caller policy and BEFORE the trailing
1380
- * deny-narrowing re-check, each wrapper resolving its own `ask` via the ancestor's frozen approver —
1381
- * so a parent `ask` never widens into a child auto-allow, and a parent `allow{updatedInput}` rewrite
1382
- * is still re-checked by the child's narrowing layers. NOT serializable: a durable resume must
1383
- * re-supply it via `resumeStream(..., internals)` (see {@link CheckpointState.inheritedGate}).
1415
+ * `onAsk`, ancestors first — and, for a mods-wired ancestor, a SECOND entry: its installation (the bus
1416
+ * its admission mounted, `installation`), carrying its own frozen approver/mandate/env axes. A caller
1417
+ * policy is folded AFTER the child's own caller policy and BEFORE the trailing deny-narrowing re-check,
1418
+ * each wrapper resolving its own `ask` via the ancestor's frozen approver — so a parent `ask` never
1419
+ * widens into a child auto-allow, and a parent `allow{updatedInput}` rewrite is still re-checked by the
1420
+ * child's narrowing layers. An installation judges the child's calls at the child's gate, on the
1421
+ * installation's own bus (`classic.PreToolUse` at phase 1, `tool.check` at the verdict read), its
1422
+ * question settled under the same frozen axes. NOT serializable: a durable resume must re-supply it via
1423
+ * `resumeStream(..., internals)` (see {@link CheckpointState.inheritedGate}).
1384
1424
  *
1385
1425
  * Chain assembly is single-sited in prepareTask's ctx injection (`inheritedGateForChildren`): upstream
1386
1426
  * chain + THIS task's own contribution (its session-rule snapshot, its RESOLVED caller policy —
@@ -1489,9 +1529,18 @@ export interface InheritedGate extends InheritedAutoModeFace {
1489
1529
  * same frozen `onAsk` — no mandate). It is a CONSERVATIVE descendant-side mandate: whether or not a given ask would actually
1490
1530
  * have parked at the ancestor (the regime may be scoped), the durable-park semantics cannot be
1491
1531
  * reconstructed in a delegated child's context — so a wrapper seeing `ask` under this flag denies
1492
- * fail-closed (tighten-only holds) instead of resolving synchronously. */
1493
- parentConstraints?: ReadonlyArray<{
1532
+ * fail-closed (tighten-only holds) instead of resolving synchronously.
1533
+ *
1534
+ * Each entry is exactly ONE of two kinds: a caller policy (`policy`), or a screening installation
1535
+ * (`installation` — the bus a leg's admission mounted, or {@link import("../mods/stations.js").admitModChain}'s on a
1536
+ * cross-process re-supply). A chain naming both, neither, or an installation no engine admission mounted is refused. */
1537
+ parentConstraints?: ReadonlyArray<({
1494
1538
  policy: ToolPolicy;
1539
+ installation?: undefined;
1540
+ } | {
1541
+ installation: LegModBus;
1542
+ policy?: undefined;
1543
+ }) & {
1495
1544
  onAsk?: OnAsk;
1496
1545
  durableMandate?: boolean;
1497
1546
  /** The CONTENT-ask twin of `durableMandate`, frozen from the QUESTION seat (`spec.onQuestion ??
@@ -1543,26 +1592,14 @@ export interface InheritedGate extends InheritedAutoModeFace {
1543
1592
  };
1544
1593
  };
1545
1594
  /**
1546
- * Set by the constraint mint's caller on an entry whose `policy` is the folded form of an ancestor's
1547
- * `classic.PreToolUse` chain (`createPreToolUseConstraintPolicy`): the chain that leg's admission MOUNTED, as the
1548
- * entry declares it. It is read for ONE thing — a declaration that this entry carries a chain: beside a policy the
1549
- * mint did not make, a declared judging `tool.check` handler is refused (`config.mods_invalid`; the guard has no bus to
1550
- * be raised on), and such an entry is never treated as a caller policy (it licenses no ask grant). It is NEVER the
1551
- * entry's identity: the chain an entry stands for is read off the bus its policy was minted over (that bus's admission
1552
- * recorded it), so a host may hand any list here (`[]` included, or none) without moving what is judged.
1553
- *
1554
- * The identity (`sameInstallation`) is that chain plus the context the entry's questions are settled in — the frozen
1555
- * approver, the two durable mandates, the environment, the classifier instance — and it is the CONSERVATIVE test:
1556
- * two chains over the same registrations in a different order, or a re-built registration object, compare unequal,
1557
- * and a bus no engine admission mounted is no leg's installation. Chain assembly does not re-append a leg already on
1558
- * the chain; a descendant's own gate stands in for an entry only when that identity holds under no mandate (the
1559
- * pass-through of its `classic.PreToolUse`, the skip of its `tool.check`); any other entry is judged on both events
1560
- * under its own context — judged twice rather than skipped, never toward a missed one.
1561
- */
1562
- mods?: readonly ModChainLink[];
1563
- /**
1564
- * The environment this screening face was installed against — the source of the `HookEnvCapabilities`
1565
- * handed to it, compared BY REFERENCE, `undefined` when the installation had no env face. Part of the
1595
+ * The environment this installation was installed against — the source of the `HookEnvCapabilities` face its
1596
+ * `classic.PreToolUse` e carries (`env`), compared BY REFERENCE, `undefined` when the installation had no env. The
1597
+ * installation identity (`sameInstallation`) is the chain its bus's admission recorded plus the context its questions are
1598
+ * settled in — the frozen approver, the two durable mandates, this environment, the classifier instance — the
1599
+ * CONSERVATIVE test: two chains over the same registrations in a different order, or a re-built registration object,
1600
+ * compare unequal. Chain assembly does not re-append a leg already on the chain; a descendant's own gate stands in for an
1601
+ * installation only when that identity holds under no mandate; any other is judged on both events under its own context
1602
+ * — judged twice rather than skipped, never toward a missed one. Part of the
1566
1603
  * installation's identity for the same reason the frozen approver is (HIGH): a face that
1567
1604
  * resolves paths through `ctx.env` answers a different question in a different environment, so an
1568
1605
  * ancestor running against the deployment's tree and a descendant running in an isolated worktree are
@@ -1634,6 +1671,11 @@ export interface RunInternals {
1634
1671
  * releases the lease when its materialization is disposed — see `mcp-connection-pool.ts`. Trusted, never a TaskSpec field.
1635
1672
  */
1636
1673
  mcpPool?: import("../mcp-connection-pool.js").McpConnectionPool;
1674
+ /** This leg's host seats by declaration name: a `{ kind: "host" }` server of `TaskSpec.mcp` / `ResumeTaskConfig.mcp` dials through the
1675
+ * pipe its seat opens for each dial (mcp-host-seat.ts; a request-level seat rides `hostSeatOfRequests`); a declaration with no seat fails its dial (`config.mcp_host_seat_missing`), a seat with no declaration is
1676
+ * announced once (`config.mcp_host_seat_undeclared`). The leg's own: a delegated child is handed the seats of the host servers it
1677
+ * is declared (inherited or its definition's own), a retained child's snapshot keeps none (its waker's seats ride each wake). Trusted, never a TaskSpec field. */
1678
+ mcpHostSeats?: ReadonlyMap<string, import("../mcp-host-seat.js").McpHostSeat>;
1637
1679
  /**
1638
1680
  * The tool-selector layers of the run that spawned this leg — its ceiling ({@link ToolFaceSnapshot.selector}`.layers`): this
1639
1681
  * leg's selector is these layers plus its own `allowTools` / `excludeTools`, so nothing a child names can widen what its
@@ -1839,10 +1881,10 @@ export interface RunInternals {
1839
1881
  * mirroring `insideFork`.
1840
1882
  */
1841
1883
  isDelegatedChild?: boolean;
1842
- /** `true` iff this delegated leg's objective carries an operator's words — minted ONLY by a retained child's resume
1843
- * through its steer handle (a SendMessage resume is a peer's): it passes `classic.UserPromptSubmit` before the leg
1844
- * opens on `classic.SubagentStart`. TRUSTED run-scoped channel (NOT a {@link TaskSpec} field). */
1845
- operatorObjective?: true;
1884
+ /** Who wrote this leg's objective ({@link import("../input-author.js").InputAuthor}), stated by the seat that mints it; absent = the public
1885
+ * entry's caller, `operator`. Only the operator's objective passes `classic.UserPromptSubmit`; a non-member reads `unknown`, is screened and
1886
+ * reported once (`onError`, `"config"`). Never inherited — each seat says its own. TRUSTED run-scoped channel (NOT a {@link TaskSpec} field). */
1887
+ objectiveAuthor?: import("../input-author.js").InputAuthor;
1846
1888
  /**
1847
1889
  * Subagent transcript persistence — the child transcript session's PLACEMENT declaration, minted
1848
1890
  * by the background delegation lane (the trusted spawner: it knows the a* handle, scope and root)
@@ -1900,7 +1942,7 @@ export interface RunInternals {
1900
1942
  */
1901
1943
  inheritedSkillGrants?: readonly SkillGrantRecord[];
1902
1944
  /** The parent's request allow entries at the spawn (`ctx.activeRequestAllowedTools()`), seeded as this child's own request rows until it ends — the channel of {@link inheritedSkillGrants}. */
1903
- inheritedAllowedTools?: readonly string[];
1945
+ inheritedAllowedTools?: readonly import("../allow-entry.js").AllowListEntry[];
1904
1946
  /**
1905
1947
  * When this task runs as a SUB-AGENT spawned under a parent task's
1906
1948
  * tool call, the spawning tool's `ToolExecuteContext.toolCallId`. The Runner stamps it onto this task's
@@ -1948,6 +1990,10 @@ export interface RunInternals {
1948
1990
  /** The spawning run's sessionId (paired with parentTaskId; see
1949
1991
  * ToolExecuteContext.parentSessionId). */
1950
1992
  parentSessionId?: string;
1993
+ /** The registry row this leg runs as (a background child's `a…` handle, the id `TaskStop` / `SendMessage` take), which the leg's
1994
+ * one task-id mint reads first. Set by the background lanes (plain, fork, retained snapshot); absent on a top-level run, a
1995
+ * synchronous child and a workflow agent. Stamped as `CheckpointState.rowTaskId`. Trusted seat, NOT a {@link TaskSpec} field. */
1996
+ rowTaskId?: string;
1951
1997
  /**
1952
1998
  * The memory-capture opt-out FLOOR: TRUE ⇔ the spawning session was under an
1953
1999
  * opt-out when this child spawned. The child then runs opted-out itself (its prepare mints its
@@ -2032,9 +2078,27 @@ export interface RunInternals {
2032
2078
  * `resume.placement_mismatch`). TRUSTED run-scoped channel (never a {@link TaskSpec} field).
2033
2079
  */
2034
2080
  placementRoot?: string;
2081
+ /** The placement FENCE this leg is minted under: the target of the leg that hands it work (a spawner, a waker, a composition's
2082
+ * first leg), folded at the mint into {@link import("../remote-env.js").ExecutionEnvFactoryContext.placementTarget} — whose
2083
+ * contract lists every producer; one hop, re-read at every leg (unlike the tree's fixed point {@link placementRoot}). An
2084
+ * unreadable value is refused at the mint (`config.placement_not_honored`). TRUSTED run-scoped channel (never a {@link TaskSpec} field). */
2085
+ placementTarget?: PlacementTarget;
2086
+ /**
2087
+ * Which composition this leg is a leg of, and whose run it belongs to ({@link CompositionLeg}): minted ONLY by a composition
2088
+ * entry when it hands the leg out (`runCascade` / `resumeCascade` for each rung, the verification gate for each verifier leg),
2089
+ * never by the engine. The suspend mint stamps it on the row as `CheckpointState.compositionLeg`, so a card a leg parks says
2090
+ * itself which leg of which composition it is and which host session it belongs to; one value, read ONCE at prepare (the live
2091
+ * member, else the row's; an `entry` outside the closed set is refused there, `config.invalid_argument`). On a resume the same rule as the
2092
+ * placement fixed point: a live value wins, a live value that CONTRADICTS the row's is refused pre-CAS
2093
+ * (`resume.composition_mismatch`, the row stays pending), an absent one is restored from the row — and a live value over a row
2094
+ * that records none (a card minted before the member, or by a leg nobody labelled) is that row's first record, never refused.
2095
+ * Not threaded to the leg's children: a child is not a rung, its card is filed by its own lane. TRUSTED run-scoped channel
2096
+ * (never a {@link TaskSpec} field).
2097
+ */
2098
+ compositionLeg?: CompositionLeg;
2035
2099
  /**
2036
2100
  * The REGISTRY SCOPE this run's own background row lives in: the domain its registry-facing
2037
- * tools (TaskOutput / TaskStop / SendMessage / AgentTranscript / Monitor, and the announce listing)
2101
+ * tools (TaskStop / SendMessage / AgentTranscript / Monitor, and the announce listing)
2038
2102
  * must mount in to see it. Filled by the delegation tool at spawn, which is the party that CHOSE the
2039
2103
  * domain when it registered the row — `ctx.principal` when the spawning run has one, else the
2040
2104
  * delegation mount's declared `background.scope`, and on a revival the claimed row's own scope.
@@ -2103,6 +2167,9 @@ export interface RunInternals {
2103
2167
  * per run" true across the lanes that forward. A caller value is overridden like the refs beside it;
2104
2168
  * absent ⇒ the door mints a per-object one, so containment never depends on the threading. */
2105
2169
  forwardScope?: import("./forward-sink.js").ForwardSinkScope;
2170
+ /** The door's receipt of this leg's `mcp` / `a2a` declarations — ENGINE-owned, taken by `Runner.runTaskStream` at the call for every
2171
+ * leg (a caller value is overridden): the leg's door judges this copy, and the references it names are what the leg holds (peer-seat.ts). */
2172
+ receivedPeers?: import("../locked-config.js").ReceivedPeerDeclarations;
2106
2173
  /**
2107
2174
  * The Runner's per-session read-file-state seats (CC parity: readFileState is
2108
2175
  * session-scoped). Always set by the Runner's own prepare call (overriding any caller value, like
@@ -2249,7 +2316,7 @@ export interface RunInternals {
2249
2316
  * the tool ctx as {@link ToolExecuteContext.onSubagentSpawn} and recursively down the delegation
2250
2317
  * tree. Absent ⇒ children run non-steerable (prior behavior, zero overhead).
2251
2318
  * SCOPE: only SYNC delegations emit a handle — a
2252
- * `run_in_background` child does not (poll/stop it via TaskOutput/TaskStop); wiring the background
2319
+ * `run_in_background` child does not (its completion notification carries the result; TaskStop stops it); wiring the background
2253
2320
  * lane is a recorded follow-up, not an oversight a deployment should discover at runtime.
2254
2321
  */
2255
2322
  onSubagentSpawn?: (handle: import("../../agents/subagent.js").SubagentSteerHandle) => void;
@@ -2349,14 +2416,17 @@ export interface ResolvedWorkspace {
2349
2416
  cwd: string;
2350
2417
  /** True only for an accepted `isolation: "worktree"` request (⇒ `cwd` is this agent's own worktree). */
2351
2418
  isolated: boolean;
2352
- /** True when the task's execution env is REMOTE: `cwd` then names a path INSIDE the remote
2353
- * target (a per-task sandbox on the shape-(d) exemption leg, e.g. `/workspace`), which does not exist —
2354
- * or names an unrelated directory — on the host. `isolated && !remote` is the only combination under
2355
- * which `cwd` is a host path a consumer may diff / merge / remove. */
2419
+ /** True when the task's execution env does not declare its paths the host's (`pathsAreHostLocal` is false — whatever
2420
+ * interface drives it): `cwd` then names a path INSIDE that target (a per-task sandbox on the shape-(d) exemption leg,
2421
+ * e.g. `/workspace`), which does not exist — or names an unrelated directory — on the host. A host lane driven through
2422
+ * the remote seam reads `false`. `isolated && !remote` is the only combination under which `cwd` is a host path a
2423
+ * consumer may diff / merge / remove. */
2356
2424
  remote: boolean;
2357
2425
  /** Where a delegated child's environment placed it against where its caller asked; absent on a leg no delegation
2358
2426
  * caller placed. */
2359
2427
  placement?: ChildPlacement;
2428
+ /** The target this leg's env reported as it settled — the fence of every leg it hands work to; absent when it reported none. */
2429
+ target?: PlacementTarget;
2360
2430
  }
2361
2431
  /**
2362
2432
  * The resolver's answer, with the WITHHELD cause beside the value.
@@ -2432,7 +2502,7 @@ export interface SuspendSaga {
2432
2502
  suspendLoopCapHit: (count: number, cap: number | undefined, detail: string) => boolean;
2433
2503
  /** The `suspendVM` target by CAPABILITY, or undefined. */
2434
2504
  suspendableEnv: RemoteExecutionEnv | undefined;
2435
- /** The park-only remote target (non-suspendable, externally durable), or undefined. */
2505
+ /** The park-only remote target (declares `suspendable: false`: externally durable), or undefined. */
2436
2506
  parkOnlyRemoteEnv: RemoteExecutionEnv | undefined;
2437
2507
  /** The park-only identity capture (snapshotId stripped, `restoreMode: "park_only"`). */
2438
2508
  parkOnlyHandle: (env: RemoteExecutionEnv) => WorkspaceHandle;
@@ -2551,6 +2621,7 @@ export interface RunState {
2551
2621
  turnResponseModel: string | undefined;
2552
2622
  /** B15 三期使能:postToolBatch 的本回合聚集批(每回合边界消费并重置 — 回合语义,故归 turn)。 */
2553
2623
  toolBatch: PostToolBatchCall[];
2624
+ completed?: readonly import("../mods/lifecycle-stations.js").CompletedTurn[];
2554
2625
  };
2555
2626
  counters: {
2556
2627
  /** How many LIMIT-APPROACH frames have been injected this run (0..2). Also the
@@ -2616,6 +2687,29 @@ export interface RunState {
2616
2687
  * objective's attachments nor the objective's run origin (a config that carries `userAttachments` or `runOrigin` anyway is
2617
2688
  * refused before the claim; a wake states its leg's word on the input it hands over). */
2618
2689
  export type ResumeTaskConfig = Omit<TaskSpec, "objective" | "sessionId" | "userAttachments" | "runOrigin">;
2690
+ /**
2691
+ * A composition leg's identity ({@link RunInternals.compositionLeg}, `CheckpointState.compositionLeg`): which entry handed the
2692
+ * leg out, which leg of it this is, and the host session the composition runs for. One member per entry; `entry` is a closed
2693
+ * set, and a word outside it is refused wherever the identity is read (`config.invalid_argument`), never stamped on a card.
2694
+ * · `entry: "cascade"` — `leg` is the ladder rung's index (0-based); `hostSessionId` is the caller's `TaskSpec.sessionId`,
2695
+ * the session a host files the composition's run under. A rung runs in its OWN session (the card's `sessionId`), so a host
2696
+ * links a rung's card back to its run by `hostSessionId`, never by the card's session. A cascade whose caller named no
2697
+ * session mints none: that rung's card cannot be linked by composition.
2698
+ * · `entry: "verify"` — the verification gate's VERIFIER leg (`verifyCompleted` and every entry built on it): `leg` is the
2699
+ * verification iteration (1-based, the number `onRound` reports); `hostSessionId` is the implementation's session (the result
2700
+ * the gate verifies, which every fix leg continues). Only the verifier leg is handed one — a fix leg continues the
2701
+ * implementation session itself, so its card already sits in the host's session. A verifier runs in a session the gate
2702
+ * minted, so its card is one no resume of the host's own run reaches: a host reads this entry to tell it from a card it
2703
+ * can decide, and settles it by its token — `runner.resume`, or `Runner.voidVerifierPause` to void it and unpin the
2704
+ * verifier session. An implementation result with no session id mints none.
2705
+ * Three identities beside each other on one card, never merged: the card's `sessionId` (what a resume continues),
2706
+ * `placementRootSessionId` (where the work is placed), and this (whose run it is, and which leg).
2707
+ */
2708
+ export type CompositionLeg = {
2709
+ readonly entry: "cascade" | "verify";
2710
+ readonly leg: number;
2711
+ readonly hostSessionId: string;
2712
+ };
2619
2713
  /** Resume plan threaded from {@link Runner.resume} into the shared run loop. */
2620
2714
  export interface ResumeRun {
2621
2715
  cp: Checkpoint;
@@ -2716,14 +2810,7 @@ export interface TurnBoundaryDeps {
2716
2810
  readonly userHalted: boolean;
2717
2811
  readonly callerStop: import("./caller-stop-gate.js").CallerStopGate;
2718
2812
  };
2719
- manualCompactRef: {
2720
- requested: boolean;
2721
- waiters: Array<{
2722
- resolve: (outcome: CompactOutcome) => void;
2723
- signal?: AbortSignal;
2724
- instructions?: string;
2725
- }>;
2726
- };
2813
+ manualCompactRef: Pick<ManualCompactRef, "requested" | "waiters">;
2727
2814
  todoToolMounted: boolean;
2728
2815
  taskToolsMounted: boolean;
2729
2816
  walltimeMonotonicDeadline: number | undefined;
@@ -2805,7 +2892,7 @@ export interface HarnessHandlersDeps {
2805
2892
  onError: RunnerDeps["onError"];
2806
2893
  onNotice: RunnerDeps["onNotice"];
2807
2894
  };
2808
- mediaByteCapBytes: RunnerDeps["mediaByteCapBytes"];
2895
+ mediaBudgetBase64Chars: RunnerDeps["mediaBudgetBase64Chars"];
2809
2896
  /** The run's ONE isolation scope for the {@link RunInternals} observation sinks, minted by the
2810
2897
  * identity-wiring lane (which calls the first of them) and shared with these handlers, so the
2811
2898
  * "first failure per site" disclosure is one account for the whole run rather than one per lane. */
@@ -2864,6 +2951,9 @@ export interface RunnerSelfSeat {
2864
2951
  canRerootChild?(): boolean;
2865
2952
  /** Fire `RunnerDeps.onTaskOutcome` through the swallow-guarded chokepoint (thin compositions emit at their terminal state). */
2866
2953
  emitTaskOutcome(outcome: TaskOutcome): void;
2954
+ /** A hold, on the peer seat THIS runner's legs ask, of the references `declared` names — taken by a keeper of declarations
2955
+ * outside a leg (a retained child's ledger entry), released by it once (peer-seat.ts `holdPeerDeclarations`). */
2956
+ holdDeclarations(declared: import("../peer-seat.js").PeerDeclarations): import("../peer-seat.js").PeerDeclarationHold;
2867
2957
  /** Run a task to completion. `internals` is the TRUSTED run-scoped channel (never a TaskSpec field). */
2868
2958
  runTask(spec: TaskSpec, internals?: RunInternals): Promise<TaskResult>;
2869
2959
  /** Streaming form of {@link RunnerSelfSeat.runTask}; `resume` is the run loop's resume plan, `internals` the trusted channel. */
@@ -2941,10 +3031,13 @@ export interface TaskIdRef {
2941
3031
  * gate the run-end backstop closes before its final drain. */
2942
3032
  export interface ManualCompactRef {
2943
3033
  requested: boolean;
3034
+ /** `requestedBy`: the extension a `$.session.compact` request came from (absent on a host `compact()` request) — the
3035
+ * pass that claims it carries it on the frame that ends it. */
2944
3036
  waiters: Array<{
2945
3037
  resolve: (outcome: CompactOutcome) => void;
2946
3038
  signal?: AbortSignal;
2947
3039
  instructions?: string;
3040
+ requestedBy?: import("../task-event.js").ExtensionRequester;
2948
3041
  }>;
2949
3042
  emitMooted?: (reason: string) => void;
2950
3043
  closed?: boolean;
@@ -11,7 +11,7 @@
11
11
  * put, when the leg settles) also when conversation content follows the newest record. A write that fails refuses its call (or its
12
12
  * row) on a governed tree; a prepare's or a settle's, and any write on a tree that is not governed, mints
13
13
  * `config.cross_boundary_record_unwritten`, once per state. A record says how the content before it is READ: a leg's end record also
14
- * carries what the session is still owed — each unfinished background task the leg's TaskOutput reaches, judged as the poll the
14
+ * carries what the session is still owed — each unfinished background task the leg's task access reaches, judged as the poll the
15
15
  * session's next leg (another tree) would make of it, so its delivery is read under the bit it brings. A leg that takes over a
16
16
  * session whose content no record covers (none on the branch, or after the newest), on an armed tree, reads that content as
17
17
  * off-target.
@@ -21,7 +21,7 @@
21
21
  * leg reaches declares itself the target NOW, and the tree's state NOW.
22
22
  */
23
23
  import type { AgentTool } from "../../internal/harness.js";
24
- import type { SessionTreeEntry } from "../../internal/harness-types.js";
24
+ import type { ExecutionEnv, SessionTreeEntry } from "../../internal/harness-types.js";
25
25
  import { type CrossBoundaryCheck, type CrossBoundaryPosture, type CrossBoundaryTreeToken, type OwedDeliveries } from "../cross-boundary-taint.js";
26
26
  import { type ToolRoster } from "../tool-roster.js";
27
27
  import type { RunnerDeps } from "../types.js";
@@ -73,10 +73,8 @@ export interface CrossBoundaryLaneInput {
73
73
  posture: CrossBoundaryPosture | undefined;
74
74
  /** The run fold: this leg's environment declares the target, or the row it resumes was minted on one. */
75
75
  externalContentTargetActive: boolean;
76
- /** The leg's own environment — read for its CURRENT declaration at each judgment. */
77
- env: {
78
- readonly externalContentTarget?: boolean;
79
- };
76
+ /** The leg's own environment — read for its CURRENT declaration (`targetIsExternal`) at each judgment. */
77
+ env: Pick<ExecutionEnv, "capabilities">;
80
78
  session: {
81
79
  getBranch(): Promise<ReadonlyArray<SessionTreeEntry>>;
82
80
  getLeafId(): Promise<string | null>;
@@ -1,3 +1,4 @@
1
+ import { targetIsExternal } from "../remote-env.js";
1
2
  import { BOUNDARY_LEGS, CROSS_BOUNDARY_RECORD_TYPE, CROSS_BOUNDARY_TAINT_BITS, STRICTEST_CROSS_BOUNDARY_TREE, crossBoundaryObligation, crossBoundaryPostureUndeclaredNotice, crossBoundaryRecordUnwrittenNotice, crossBoundaryRecordData, crossBoundaryTreeCovers, crossBoundaryTreeGoverned, joinCrossBoundaryTree, readCrossBoundaryRecord, } from "../cross-boundary-taint.js";
2
3
  import { deliverEngineNotice } from "../engine-notice.js";
3
4
  import { policyCannotAnswer } from "../real-approval.js";
@@ -23,6 +24,14 @@ export function joinedCrossBoundaryTree(handed, report) {
23
24
  const EVERY_LEG = Object.freeze([...BOUNDARY_LEGS]);
24
25
  const ONE_OUTSIDE_READ = Object.freeze([Object.freeze({ legs: Object.freeze(["outside_read"]) })]);
25
26
  const bitsOf = (t) => CROSS_BOUNDARY_TAINT_BITS.filter((b) => t[b] === true);
27
+ function obligationReaching(legs, reached, tree) {
28
+ const declared = reached === undefined ? false : targetIsExternal(reached);
29
+ if (declared !== "undeclared")
30
+ return crossBoundaryObligation(legs, declared, tree);
31
+ const onTarget = crossBoundaryObligation(legs, true, tree);
32
+ const offTarget = crossBoundaryObligation(legs, false, tree);
33
+ return Object.freeze({ mandate: onTarget.mandate || offTarget.mandate, record: onTarget.record || offTarget.record });
34
+ }
26
35
  function legsOfCall(view, legEnv, token, call, report) {
27
36
  const roster = view.roster.current;
28
37
  const row = roster !== undefined ? rosterEntryNamed(roster, call.toolName) : undefined;
@@ -137,7 +146,7 @@ export async function prepareCrossBoundaryLane(input) {
137
146
  const OBSERVED = Object.freeze({ offTargetReadObserved: true });
138
147
  const addedBy = (record) => (record && ref.current.offTargetReadObserved !== true ? OBSERVED : undefined);
139
148
  const owedBit = (owed) => {
140
- const records = (given) => given.some((d) => crossBoundaryObligation(d.legs, d.env?.externalContentTarget === true, ref.current).record);
149
+ const records = (given) => given.some((d) => obligationReaching(d.legs, d.env, ref.current).record);
141
150
  try {
142
151
  return addedBy(records(owed()));
143
152
  }
@@ -166,7 +175,7 @@ export async function prepareCrossBoundaryLane(input) {
166
175
  const obligationOf = (call, say) => {
167
176
  const { legs, env: reached } = legsOfCall(view, env, token, call, say);
168
177
  try {
169
- return crossBoundaryObligation(legs, reached?.externalContentTarget === true, ref.current);
178
+ return obligationReaching(legs, reached, ref.current);
170
179
  }
171
180
  catch (err) {
172
181
  say(`the cross-boundary obligation of "${call.toolName}" could not be read (${thrownText(err)}) — the call reads as every leg, off the target`);
@@ -94,7 +94,7 @@ export interface DecideVerdict {
94
94
  }
95
95
  /**
96
96
  * Read and judge the host's decision facts — the ONE validation for every durable decide. `raw` is the caller's
97
- * `hostDecision`, read ONCE by the lane (this function reads `decidedBy` and `approver` once each, off it).
97
+ * `hostDecision`, read ONCE by the lane (this function reads `decidedBy`, `approver` and `decidedVia` once each, off it).
98
98
  * - the facts are REQUIRED: absence (or a non-object) is refused — absence is not a fact about the wait, and core
99
99
  * does not guess one;
100
100
  * - `decidedBy` is a member of the closed set ({@link isHostDecider}); the sweep's word is the host's SLA sweep and
@@ -102,7 +102,9 @@ export interface DecideVerdict {
102
102
  * the word would file a record of an event that row's contract says cannot happen;
103
103
  * - WHO MAY ALLOW the row: not the sweep's word (a wait nobody answered), and not the policy on a row that demands a
104
104
  * person (`policyCannotAnswer`, the synchronous seat's rule);
105
- * - the attribution passes the shared screen (a bounded plain string) — refused rather than dropped.
105
+ * - the attribution passes the shared screen (a bounded plain string) — refused rather than dropped;
106
+ * - `decidedVia`, when present, is a member of its closed set beside `decidedBy: "policy"` ({@link screenDecidedVia}, the
107
+ * synchronous seam's screen); a plan pause takes it under the same screen and its reminder reads `decidedBy` alone.
106
108
  */
107
109
  export declare function captureHostDecision(cp: Checkpoint, raw: unknown, lane: DecideLane, verdict: DecideVerdict): HostDecisionFacts;
108
110
  /** The origin word of the ask a pending row holds: a tool approval's was stamped on the park by the gate; a plan
@@ -2,10 +2,10 @@ import { isAskOrigin } from "../ask-origin.js";
2
2
  import { isLiveQuestionFace, markBoundOnlyQuestionFace } from "../ask-question.js";
3
3
  import { boundInputHashOf } from "../canonical-json.js";
4
4
  import { CheckpointError } from "../checkpoint-store.js";
5
- import { decidersNote, isHostDecider, settlementOfHostDecision } from "../gate-outcome.js";
5
+ import { decidersNote, isHostDecider, policyDeciderOf, settlementOfHostDecision } from "../gate-outcome.js";
6
6
  import { formatHookFeedback } from "../hooks.js";
7
7
  import { facetOf, isGateKind, isQuestionGate } from "../pause-registry.js";
8
- import { humanRefusalSentence, policyCannotAnswer, screenApproverAttribution } from "../tool-policy.js";
8
+ import { humanRefusalSentence, policyCannotAnswer, screenApproverAttribution, screenDecidedVia } from "../tool-policy.js";
9
9
  import { mintGateOutcome } from "./gate-exit.js";
10
10
  import { delimitUntrusted, REVIEWER_NOTE_MAX_BODY } from "../untrusted-text.js";
11
11
  import { writtenFeedback } from "./approval-feedback.js";
@@ -108,7 +108,10 @@ export function captureHostDecision(cp, raw, lane, verdict) {
108
108
  if (attribution.defect !== undefined) {
109
109
  throw new CheckpointError("checkpoint.invalid_outcome", `resume carries an approver attribution this engine refuses: ${attribution.defect}; refusing pre-CAS, the checkpoint stays pending`, { field: "approver" });
110
110
  }
111
- return { decidedBy, ...(attribution.approver !== undefined ? { approver: attribution.approver } : {}) };
111
+ const via = screenDecidedVia(raw.decidedVia, decidedBy);
112
+ if (via.defect !== undefined)
113
+ throw new CheckpointError("checkpoint.invalid_outcome", `resume hostDecision carries a decidedVia this engine refuses: ${via.defect}; refusing pre-CAS, the checkpoint stays pending`, { field: "hostDecision" });
114
+ return { decidedBy, ...(attribution.approver !== undefined ? { approver: attribution.approver } : {}), ...(via.decidedVia !== undefined ? { decidedVia: via.decidedVia } : {}) };
112
115
  }
113
116
  export function parkedOriginOf(cp) {
114
117
  if (cp.pendingAction.kind === "tool_approval")
@@ -183,6 +186,6 @@ export function resumeContinuation(resume, mark, fullShellReachable, delegatedCh
183
186
  }
184
187
  const decided = decision === "allow"
185
188
  ? "was APPROVED and has now been executed — its result is in the tool results above"
186
- : `was DENIED ${hostDecision.decidedBy === "policy" ? "by this deployment's own policy" : "because its approval window elapsed with no answer"}, not by a person — the refusal and its reason are in the tool results above`;
189
+ : `was DENIED ${hostDecision.decidedBy === "policy" ? `by ${policyDeciderOf(hostDecision.decidedVia).name}` : "because its approval window elapsed with no answer"}, not by a person — the refusal and its reason are in the tool results above`;
187
190
  return formatHookFeedback(`The pending tool call "${pendingAction.toolName}" ${decided}. ${resumed}${carryOn}`, mark);
188
191
  }