@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
@@ -42,7 +42,9 @@ export interface RunGitLaneInput {
42
42
  type: "tool_execution_end";
43
43
  }>) => void;
44
44
  /** borrowed-readonly — the harness-handlers lane's turn_end closure. */
45
- onTurnEnd: () => void;
45
+ onTurnEnd: (event: Extract<AgentHarnessEvent, {
46
+ type: "turn_end";
47
+ }>) => void;
46
48
  /** borrowed-readonly — the turn-boundary lane's handler, registered on `turn_boundary` AFTER the owed-frame retry
47
49
  * so a pending announcement is re-asserted into the session ahead of the boundary's own context work. */
48
50
  onTurnBoundary: (event: {
@@ -1,5 +1,6 @@
1
1
  import { GIT_STATUS_ECHO_PREVIEW } from "./git-status-frame.js";
2
2
  import { wrapGitFrame } from "./git-leg-delivery.js";
3
+ import { appendAdmittedRow } from "../row-admission.js";
3
4
  import { thrownText } from "../thrown-value.js";
4
5
  export function runGitLane(input) {
5
6
  const { prepared, queue, rs, ident, onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, onTurnBoundary, runner } = input;
@@ -14,7 +15,7 @@ export function runGitLane(input) {
14
15
  : { kind: frame.kind, body: frame.body, hash: frame.hash };
15
16
  const wrapped = wrapGitFrame(use.body, prepared.reminderMark);
16
17
  try {
17
- const entryId = await prepared.session.appendMessage({
18
+ const entryId = await appendAdmittedRow(prepared.admitRows, prepared.session, {
18
19
  role: "user",
19
20
  content: [{ type: "text", text: wrapped }],
20
21
  timestamp: Date.now(),
@@ -93,7 +94,7 @@ export function runGitLane(input) {
93
94
  onToolEnd(event);
94
95
  break;
95
96
  case "turn_end":
96
- onTurnEnd();
97
+ onTurnEnd(event);
97
98
  break;
98
99
  default:
99
100
  break;
@@ -33,7 +33,9 @@ export interface RunHarnessHandlersResult {
33
33
  onToolEnd: (event: Extract<AgentHarnessEvent, {
34
34
  type: "tool_execution_end";
35
35
  }>) => void;
36
- onTurnEnd: () => void;
36
+ onTurnEnd: (event: Extract<AgentHarnessEvent, {
37
+ type: "turn_end";
38
+ }>) => void;
37
39
  /** The leg's workspace-frame observation (`Prepared.workspaceFrame.observe`); the run body
38
40
  * calls it after a resume's approved-call resolution, which bypasses onToolEnd. */
39
41
  announceWorkspaceMove: () => void;
@@ -13,6 +13,7 @@ import { hasVerifiableStructureSignal } from "./grounding-signal.js";
13
13
  import { announceToolCall, batchResponseDigest, emitSettled } from "./tool-end-body.js";
14
14
  import { neverExecuted, stampRowNotExecuted } from "./tool-not-executed.js";
15
15
  import { extensionCallOf, noteExtensionCallDenied, requesterOf } from "../mods/extension-call.js";
16
+ import { noteCompletedTurn } from "../mods/lifecycle-stations.js";
16
17
  import { createResponseModelSeat } from "./response-model-seat.js";
17
18
  import { createToolCallIdFoldSeat } from "./tool-call-id-fold-seat.js";
18
19
  import { createFinishReasonSeat } from "./finish-reason-seat.js";
@@ -27,8 +28,8 @@ export function createHarnessHandlers(input) {
27
28
  const toolTurnIncompleteSeat = createToolTurnIncompleteSeat(deps.runnerHooks.onNotice, { sessionId: prepared.sessionId, runId: prepared.runId });
28
29
  const finishReasonSeat = createFinishReasonSeat(deps.runnerHooks.onNotice, { sessionId: prepared.sessionId, runId: prepared.runId });
29
30
  const withheldShellEnvSeat = createWithheldShellEnvSeat(prepared, deps.runnerHooks.onNotice);
30
- const { spec, queue, internals, ident, pushContent, emitCommitted, startedToolCallIds, toolStartAt, toolProgress, writeFamilyOf, toolLabels, postToolBatchArmed, batchArgs, internalsNotifier, mediaByteCapBytes } = deps;
31
- const frames = { push: (f) => pushContent({ ...f, ...ident() }), structured: prepared.structuredProjector, mediaByteCapBytes };
31
+ const { spec, queue, internals, ident, pushContent, emitCommitted, startedToolCallIds, toolStartAt, toolProgress, writeFamilyOf, toolLabels, postToolBatchArmed, batchArgs, internalsNotifier, mediaBudgetBase64Chars } = deps;
32
+ const frames = { push: (f) => pushContent({ ...f, ...ident() }), structured: prepared.structuredProjector, mediaBudgetBase64Chars };
32
33
  const startOf = (e) => {
33
34
  const label = toolLabels.get(e.toolName);
34
35
  return { toolCallId: e.toolCallId, spelledName: e.toolName, wireName: rosterToolName(prepared.toolRosterDeltas.current, e.toolName), ...(label !== undefined ? { label } : {}), args: e.args, ...requesterOf(prepared.modBus, e.toolCallId) };
@@ -295,8 +296,9 @@ export function createHarnessHandlers(input) {
295
296
  }
296
297
  }
297
298
  };
298
- const onTurnEnd = () => {
299
+ const onTurnEnd = (event) => {
299
300
  stats.turns += 1;
301
+ noteCompletedTurn(prepared.modBus, rs.turn, event.message.role === "assistant" ? event.message : undefined, stats.turns, prepared.abortController.signal.aborted, rs.turn.turnUsageMissing ? undefined : rs.turn.turnUsage);
300
302
  if (prepared.abortController.signal.aborted)
301
303
  prepared.workCutRef.abortedBeforeTurnEnd = true;
302
304
  const stopExtra = rs.turn.turnStopReason !== undefined ? { stopReason: rs.turn.turnStopReason } : {};
@@ -7,7 +7,7 @@ import type { Stats } from "./assemble-result.js";
7
7
  import { type CallerStopGate } from "./caller-stop-gate.js";
8
8
  import type { CaptureOptOutRef, LiveHandle, ManualCompactRef, McpRedialRef, NotificationLaneBindings, NotifyRef, Prepared, RunInternals, RunnerDepsSeat, TaskIdRef } from "./contracts.js";
9
9
  export interface RunIdentityWiringInput {
10
- /** borrowed-readonly — the task spec: the task id and the memory / notification seats it names. */
10
+ /** borrowed-readonly — the task spec: the memory / notification seats it names, its principal and its signal. */
11
11
  spec: TaskSpec;
12
12
  /** borrowed-mutable — the run's event queue: the manifest, roster-delta, task_started, compaction_outcome and
13
13
  * redelivered task_notification frames. */
@@ -49,7 +49,7 @@ export interface RunIdentityWiringInput {
49
49
  runner: RunnerDepsSeat;
50
50
  }
51
51
  export interface RunIdentityWiringResult {
52
- /** The run's canonical task id (`spec.taskId ?? sessionId`) — one source, shared with `ident()`. */
52
+ /** The leg's task id (`Prepared.taskId`, minted once at prepare) — one source, shared with `ident()`. */
53
53
  runSourceTaskId: string;
54
54
  /** The spawning tool call's id when this task runs AS A SUB-AGENT; undefined on a top-level run. */
55
55
  parentToolCallId: string | undefined;
@@ -3,10 +3,12 @@ import { createSafeNotifier, observeThenableRejection } from "../safe-notify.js"
3
3
  import { forwardSafely } from "./forward-sink.js";
4
4
  import { emitsChildRowFrames, taskStartedFrame } from "../delegation-frames.js";
5
5
  import { recordFrameReceipt, toolResultReceiptKey } from "../frame-settlement.js";
6
+ import { createReceivingChain } from "../mods/session-receive.js";
6
7
  import { discloseDroppedPending, renderTaskNotificationXml, taskNotificationDedupKey } from "../task-notification.js";
7
8
  import { buildAppliedHumanInputEvent } from "../human-input-projection.js";
8
9
  import { announceAcceptance, nextHumanInputSeq } from "./steer-admission.js";
9
10
  import { deliverDelegationLifecycle, deliverEngineNotice, parentLegIds, parkedInputIdsOf, undrainedUserInputNotices } from "../types.js";
11
+ import { droppedInputsDisclosure } from "../input-author.js";
10
12
  import { mintCallerStopGate } from "./caller-stop-gate.js";
11
13
  export function runIdentityWiring(input) {
12
14
  const { spec, queue, prepared, internals, taskIdRef, onReady, manualCompactRef, notifyRef, captureOptOutRef, mcpRedialRef, injectTaskNotification, deliveredAtTurnOpen, peerInboundChainRef, notificationLane, pendingSessionNotifications, runner } = input;
@@ -16,7 +18,7 @@ export function runIdentityWiring(input) {
16
18
  taskIdRef.effectiveMemoryScopes = prepared.effectiveMemoryScopes;
17
19
  if (taskIdRef)
18
20
  taskIdRef.editedFiles = prepared.editedFilesSnapshot;
19
- const runSourceTaskId = spec.taskId ?? prepared.sessionId;
21
+ const runSourceTaskId = prepared.taskId;
20
22
  const parentToolCallId = internals?.parentToolCallId;
21
23
  const ident = () => parentToolCallId !== undefined ? { eventId: uuidv7(), parentToolCallId, sourceTaskId: runSourceTaskId } : { eventId: uuidv7() };
22
24
  notificationLane.ident = ident;
@@ -71,10 +73,11 @@ export function runIdentityWiring(input) {
71
73
  undrainedUserAtEnd = { steer: counts.steer, followUp: counts.followUp, ...(inputIds !== undefined ? { inputIds } : {}) };
72
74
  return;
73
75
  }
74
- for (const notice of undrainedUserInputNotices({ ...counts, ...(inputIds !== undefined ? { inputIds } : {}) }, spec.taskId ?? prepared.sessionId, prepared.sessionId, prepared.runId, parentLegIds(internals))) {
76
+ for (const notice of undrainedUserInputNotices({ ...counts, ...(inputIds !== undefined ? { inputIds } : {}) }, prepared.taskId, prepared.sessionId, prepared.runId, parentLegIds(internals))) {
75
77
  deliverEngineNotice(runner.deps.onNotice, notice);
76
78
  }
77
79
  };
80
+ prepared.harness.onUndrainedOtherInputs = (authors) => runner.deps.onError?.(droppedInputsDisclosure(authors), { phase: "degraded", sessionId: prepared.sessionId, classification: "undelivered-input-dropped" });
78
81
  prepared.harness.onEngineNoteConsumed = (p) => {
79
82
  const payload = p;
80
83
  const peer = payload?.peer;
@@ -117,17 +120,23 @@ export function runIdentityWiring(input) {
117
120
  catch {
118
121
  }
119
122
  {
123
+ const receiving = createReceivingChain(() => prepared.receiveSeat);
120
124
  const pendingIdle = pendingSessionNotifications.drain(prepared.sessionId);
121
125
  if (pendingIdle !== undefined) {
122
- for (const payload of discloseDroppedPending(pendingIdle)) {
126
+ for (const payload of discloseDroppedPending(pendingIdle, prepared.taskReadHandleOf, () => prepared.listBackgroundTasks({ settled: true }))) {
123
127
  const parkedPriority = pendingIdle.priorities?.get(payload);
124
128
  deliveredAtTurnOpen.add(taskNotificationDedupKey(payload));
125
129
  queue.push({ type: "task_notification", notification: payload, ...(parkedPriority !== undefined ? { priority: parkedPriority } : {}), ...ident() });
126
- void prepared.harness.nextTurn(renderTaskNotificationXml(payload), { provenance: "engine-note", enginePayload: payload }).catch(() => {
127
- pendingSessionNotifications.pend(prepared.sessionId, payload, parkedPriority);
128
- });
130
+ const handOver = (shown) => {
131
+ void prepared.harness.nextTurn(renderTaskNotificationXml(shown), { provenance: "engine-note", enginePayload: payload }).catch(() => {
132
+ pendingSessionNotifications.pend(prepared.sessionId, payload, parkedPriority);
133
+ });
134
+ };
135
+ receiving.pass(payload, { handOver, fault: () => pendingSessionNotifications.pend(prepared.sessionId, payload, parkedPriority) });
129
136
  }
130
137
  }
138
+ if (receiving.settled !== undefined)
139
+ prepared.turnOpenRedelivery.current = receiving.settled;
131
140
  }
132
141
  const loopLatch = { ended: false, userInterrupted: false, userHalted: false, callerStop: mintCallerStopGate(spec.signal) };
133
142
  onReady({ harness: prepared.harness, abortController: prepared.abortController, loop: loopLatch, reminderMark: prepared.reminderMark, sessionId: prepared.sessionId, runId: prepared.runId, hookIdentity: prepared.hookIdentity, modBus: prepared.modBus, permissionMode: prepared.permissionMode });
@@ -40,8 +40,8 @@ export interface RunLegInput<R> {
40
40
  rs: RunState;
41
41
  /** borrowed-readonly — the API-boundary attribution snapshot of the objective's actor (the objective leg's speaker envelope). */
42
42
  entryActor: ActorAssertion | undefined;
43
- /** borrowed-readonly — `RunInternals.operatorObjective`: this delegated leg's objective carries a person's words. */
44
- operatorObjective: boolean;
43
+ /** borrowed-readonly — `RunInternals.objectiveAuthor` as the trusted channel gave it: who wrote the objective, read at its seat. */
44
+ objectiveAuthor: unknown;
45
45
  /** borrowed-readonly — the effective walltime window (undefined = unbounded): `<= 0` refuses the first turn. */
46
46
  effectiveTimeoutMs: number | undefined;
47
47
  /** borrowed-mutable — the hard walltime timer: claimed (`fired`) and cleared by the exhausted arms and the finally. */
@@ -84,7 +84,7 @@ export interface RunLegInput<R> {
84
84
  unsubBoundary: () => void;
85
85
  /** borrowed-readonly — the git lane's harness-event release, called third. */
86
86
  unsub: () => void;
87
- /** borrowed-readonly — the Runner's deployment deps, read LIVE (`onError`, `hooks`, `onNotice`, `mediaByteCapBytes`; the resumed
87
+ /** borrowed-readonly — the Runner's deployment deps, read LIVE (`onError`, `hooks`, `onNotice`, `mediaBudgetBase64Chars`; the resumed
88
88
  * decision's resolver files its execution record's word through `onNotice` too); the one home of why it is a seat and not a
89
89
  * captured object is {@link RunnerDepsSeat}. */
90
90
  runner: RunnerDepsSeat;
@@ -1,17 +1,20 @@
1
1
  import { snapshotActorAssertion } from "../../internal/llm.js";
2
2
  import { redactThenCut } from "../../agents/subagent-steps.js";
3
3
  import { isEngineQuestionFace } from "../ask-question.js";
4
- import { CheckpointError, readPendingSteerQueue, realApprovalOrgFact, remainingBudgetMicroUsd } from "../checkpoint-store.js";
4
+ import { CheckpointError, planReviewRequesterOf, readPendingSteerQueue, realApprovalOrgFact, remainingBudgetMicroUsd } from "../checkpoint-store.js";
5
5
  import { normalizePersistedRuleHit } from "../rule-lane-reads.js";
6
6
  import { decidersNote, SETTLEMENT_NOBODY_JUDGED } from "../gate-outcome.js";
7
7
  import { formatHookFeedback } from "../hooks.js";
8
- import { classicEventBase, failedHandlerClause, legEventsOf, openSubagent, screenUserPrompt } from "../mods/stations.js";
8
+ import { classicEventBase, failedHandlerClause, legEventsOf, legNoticeTaskId, openSubagent, screenUserPrompt, seatHears } from "../mods/stations.js";
9
+ import { offeredAgentListing } from "../mods/agent-stations.js";
10
+ import { appendAdmittedRow } from "../row-admission.js";
9
11
  import { buildAppliedHumanInputEvent, buildHumanInputEvent, projectHumanInput } from "../human-input-projection.js";
12
+ import { countsAsOperator, objectiveAuthorOf } from "../input-author.js";
10
13
  import { humanInputAttachmentsOf, readObjectiveAttachments, userAttachmentDeclarations } from "../user-attachment.js";
11
14
  import { readToolCallArguments, uuidv7 } from "../../internal/harness.js";
12
15
  import { ORG_ADJUDICATION_TIMEOUT_MS, settleOrgVerdictWithin } from "../permission-rule-org.js";
13
16
  import { applyPersistedTightening, disclosedRuleSet } from "../persisted-rule-arms.js";
14
- import { argsReadBy, stampArgsReading } from "../effective-path-target.js";
17
+ import { argsReadBy, carryArgsReadFrom, stampArgsReading } from "../effective-path-target.js";
15
18
  import { skillGrantBindingMembers, skillRowRefusal } from "../skill-grant.js";
16
19
  import { requestGrantBinding } from "../skill-grant-binding.js";
17
20
  import { judgeApprovalObject } from "../approval-object.js";
@@ -19,7 +22,7 @@ import { SKILL_TOOL_NAME } from "./synthetic-tools.js";
19
22
  import { computeCostMicroUsd } from "../pricing.js";
20
23
  import { mintSystemReminder } from "../reminder-mint.js";
21
24
  import { hasDestroy } from "../remote-env.js";
22
- import { advertisedWritableRootsSeat, attestationOf, exemptRootsSeat, humanRefusalSentence, licenseCovers, ownedReading, policyCannotAnswer, policyRefusalMessage, refuseOutOfContractDecision } from "../tool-policy.js";
25
+ import { advertisedWritableRootsSeat, attestationOf, exemptRootsSeat, humanRefusalSentence, licenseCovers, ownArgs, ownedReading, policyCannotAnswer, policyRefusalMessage, refuseOutOfContractDecision } from "../tool-policy.js";
23
26
  import { failedJudgmentDeny } from "./policy-throw.js";
24
27
  import { pathDenialCardOf } from "../../tools/fs/safety.js";
25
28
  import { callFaceSeat, parkedRowLiveFace, rosterEntryNamed, rowMember } from "../tool-roster.js";
@@ -31,7 +34,7 @@ import { legContextOverlayOption } from "./compaction-call-options.js";
31
34
  import { mintOutputStyleReminder, owedPostureText } from "./compaction-restate.js";
32
35
  import { advisorFrameText, registerAdvisorReceipt } from "./advisor-instructions.js";
33
36
  import { resumeContinuation } from "./decide-continuation.js";
34
- import { editRewrittenSentence, sameBytes } from "../rewrite-rejudge.js";
37
+ import { sameBytes } from "../rewrite-rejudge.js";
35
38
  import { approvalWordsOf, owedApprovalWords, withApprovalWords } from "./approval-feedback.js";
36
39
  import { chainCannotJudge } from "./call-hook-stations.js";
37
40
  import { settleExecutionRecord } from "./execution-record.js";
@@ -41,8 +44,8 @@ import { withGateTimeout } from "../gate-bounded-await.js";
41
44
  import { readStationAnswer } from "../shell-read-silence.js";
42
45
  import { resolveGitLegDelivery, wrapGitFrame } from "./git-leg-delivery.js";
43
46
  import { GIT_STATUS_ECHO_PREVIEW } from "./git-status-frame.js";
44
- import { toImageContent } from "./image.js";
45
- import { maybeHumanRejectionHalt } from "./prepare-gate-stations.js";
47
+ import { toImageContents } from "./image.js";
48
+ import { isBareHumanRefusal, maybeHumanRejectionHalt } from "./prepare-gate-stations.js";
46
49
  import { nextHumanInputSeq } from "./steer-admission.js";
47
50
  import { settleTeardownLeg } from "./teardown-bounded.js";
48
51
  import { announceToolCall, emitSettled, toolResultMsg } from "./tool-end-body.js";
@@ -54,7 +57,7 @@ import { thrownMarksOf } from "../thrown-value.js";
54
57
  import { egressThrownText, egressValue } from "../untrusted-egress.js";
55
58
  import { ruleSourcePhrase } from "../rule-denial-sentence.js";
56
59
  export async function runLeg(input) {
57
- const { spec, queue, prepared, resume, rs, entryActor, operatorObjective, effectiveTimeoutMs, timeout, pushContent, ident, emitCommitted, writeFamilyOf, startedToolCallIds, announceWorkspaceMove, withBrainSinks, flushGitMirror, loopLatch, notificationLane, unsubscribeTaskNotifications, unsubGitRetry, unsubBoundary, unsub, runner, next } = input;
60
+ const { spec, queue, prepared, resume, rs, entryActor, objectiveAuthor, effectiveTimeoutMs, timeout, pushContent, ident, emitCommitted, writeFamilyOf, startedToolCallIds, announceWorkspaceMove, withBrainSinks, flushGitMirror, loopLatch, notificationLane, unsubscribeTaskNotifications, unsubGitRetry, unsubBoundary, unsub, runner, next } = input;
58
61
  let final;
59
62
  let threw;
60
63
  let abortedLive = false;
@@ -213,7 +216,7 @@ export async function runLeg(input) {
213
216
  ...(steer.inputId !== undefined ? { inputId: steer.inputId } : {}),
214
217
  sessionId: prepared.sessionId,
215
218
  runId: prepared.runId,
216
- ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}),
219
+ ...legNoticeTaskId(prepared),
217
220
  },
218
221
  });
219
222
  queue.push({
@@ -254,11 +257,14 @@ export async function runLeg(input) {
254
257
  if (approvalWords !== undefined)
255
258
  continuation = withApprovalWords(continuation, engineSegments, approvalWords);
256
259
  const pending = resume.cp.pendingAction;
257
- const rejectionHalt = pending.kind === "tool_approval" && resume.outcome.gate === "policy_ask"
258
- ? maybeHumanRejectionHalt({ gate: resume.outcome.gateOutcome, isDelegatedChild: prepared.hookIdentity.isDelegatedChild, toolName: pending.toolName, toolCallId: pending.toolCallId })
260
+ const decided = resume.outcome.gate === "policy_ask" || resume.outcome.gate === "plan_review" ? resume.outcome.gateOutcome : undefined;
261
+ const refusalEndsTurn = isBareHumanRefusal(decided, prepared.hookIdentity.isDelegatedChild);
262
+ const rejectionHalt = refusalEndsTurn && pending.kind === "tool_approval"
263
+ ? maybeHumanRejectionHalt({ gate: decided, isDelegatedChild: prepared.hookIdentity.isDelegatedChild, toolName: pending.toolName, toolCallId: pending.toolCallId })
259
264
  : undefined;
260
- if (rejectionHalt !== undefined && pending.kind === "tool_approval")
261
- prepared.batchHaltRef.current = { rejectedToolCallId: pending.toolCallId };
265
+ const refusedCallId = pending.kind === "tool_approval" ? pending.toolCallId : planReviewRequesterOf(pending);
266
+ if (refusalEndsTurn)
267
+ prepared.batchHaltRef.current = { ...(refusedCallId !== undefined ? { rejectedToolCallId: refusedCallId } : {}) };
262
268
  prepared.undeliveredContinuationRef.current = { parkedSteers: [...resumeFrames.map(({ entry }) => entry).filter((e) => !withheldSteerIds.has(e.inputId)), ...approvalFrames], orphanTasks };
263
269
  if (!prepared.abortController.signal.aborted) {
264
270
  registerAdvisorReceipt(prepared, continuation);
@@ -284,9 +290,12 @@ export async function runLeg(input) {
284
290
  prepared.frameReceipts.pending.push({ source: "posture", text: continuation, commit: () => undefined });
285
291
  if (unavailableResume !== undefined)
286
292
  prepared.frameReceipts.pending.push({ source: "mcp_unavailable", text: continuation, commit: () => void (settleMcpUnavailable(prepared, unavailableResume.entries), queue.push({ type: "steering_injected", source: "mcp_unavailable", preview: redactThenCut(unavailableResume.body, 220), ...ident() }), (rs.attach.attachmentsInjected += 1)) });
293
+ if (prepared.turnOpenRedelivery.current !== undefined)
294
+ await prepared.turnOpenRedelivery.current;
287
295
  final = await withBrainSinks(() => prepared.harness.prompt(continuation, {
288
296
  engineSegments,
289
297
  settleUnansweredToolCalls: rejectionHalt !== undefined ? { halt: rejectionHalt } : {},
298
+ ...(refusalEndsTurn && appliedEvents.length === 0 ? { endsAwaitingUser: true } : {}),
290
299
  onCommitted: () => {
291
300
  if (resume !== undefined)
292
301
  resume.decisionDelivered = true;
@@ -306,8 +315,9 @@ export async function runLeg(input) {
306
315
  const projectedObjective = projectHumanInput({ text: spec.objective, actor: objectiveActor, source: "objective" });
307
316
  let effectiveObjective = projectedObjective;
308
317
  let promptBlocked = false;
309
- const objectiveEvents = legEventsOf(prepared.hookIdentity, operatorObjective);
310
- if (objectiveEvents.screen !== undefined) {
318
+ const author = objectiveAuthorOf(objectiveAuthor, (e) => runner.deps.onError?.(e, { phase: "config", sessionId: prepared.sessionId, classification: "input-author-unreadable" }));
319
+ const objectiveEvents = legEventsOf(prepared.hookIdentity);
320
+ if (countsAsOperator(author)) {
311
321
  const screen = await screenUserPrompt(prepared.modBus, {
312
322
  ...classicEventBase(prepared.hookIdentity, prepared.permissionMode.observed),
313
323
  prompt: spec.objective,
@@ -338,7 +348,7 @@ export async function runLeg(input) {
338
348
  effectiveObjective = `${formatHookFeedback(start.additionalContext, prepared.reminderMark)}\n\n${effectiveObjective}`;
339
349
  }
340
350
  const objectiveInputId = uuidv7();
341
- const { frames: attachmentFrames, chars: attachmentChars } = await readObjectiveAttachments(prepared, objectiveInputId, promptBlocked, { overlay: () => legContextOverlayOption(prepared, runner).contextOverlay, objectiveChars: effectiveObjective.length });
351
+ const { frames: attachmentFrames, chars: attachmentChars } = await readObjectiveAttachments(prepared, objectiveInputId, promptBlocked, { overlay: () => legContextOverlayOption(prepared, runner).contextOverlay, objectiveChars: effectiveObjective.length }, runner.deps.imageProcessor);
342
352
  let gitLegDelivered;
343
353
  if (!promptBlocked) {
344
354
  const gitBody = await resolveGitLegDelivery(prepared, undefined, (err) => {
@@ -370,8 +380,9 @@ export async function runLeg(input) {
370
380
  firstFrames.push({ source: "mcp_unavailable", body: unavailable.body, commit: () => settleMcpUnavailable(prepared, unavailable.entries), disclose: () => undefined });
371
381
  if (rs.attach.attachState !== undefined) {
372
382
  const attach = rs.attach.attachState;
373
- if (rs.attach.agentListingOn && prepared.agentListing !== undefined) {
374
- const listing = prepared.agentListing;
383
+ const offeredListing = !rs.attach.agentListingOn ? undefined : seatHears({ bus: prepared.modBus }, "agent.offer") ? await offeredAgentListing({ bus: prepared.modBus }, prepared.agentListing, prepared.abortController.signal) : prepared.agentListing;
384
+ if (offeredListing !== undefined) {
385
+ const listing = offeredListing;
375
386
  const frame = renderAgentListingFrame(attach, listing.entries, listing.toolName, listing.models, listing.budget);
376
387
  if (frame !== undefined) {
377
388
  firstFrames.push({
@@ -456,9 +467,7 @@ export async function runLeg(input) {
456
467
  prepared.abortController.abort();
457
468
  }
458
469
  else {
459
- const images = spec.images
460
- ? await Promise.all(spec.images.map((img) => toImageContent(img, prepared.hostFloor)))
461
- : undefined;
470
+ const images = spec.images ? await toImageContents(spec.images, prepared.hostFloor, runner.deps.imageProcessor, prepared.imageUnprocessed) : undefined;
462
471
  if (gitLegDelivered !== undefined) {
463
472
  const delivered = gitLegDelivered;
464
473
  if (delivered.standalone)
@@ -508,6 +517,8 @@ export async function runLeg(input) {
508
517
  }),
509
518
  ...ident(),
510
519
  });
520
+ if (prepared.turnOpenRedelivery.current !== undefined)
521
+ await prepared.turnOpenRedelivery.current;
511
522
  final = await withBrainSinks(() => prepared.harness.prompt(effectiveObjective, {
512
523
  ...(images && images.length > 0 ? { images } : {}),
513
524
  ...(enginePrefixChars > 0 ? { enginePrefixChars } : {}),
@@ -593,12 +604,18 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
593
604
  const reading = liveTool === undefined ? undefined : ownedReading((a) => readToolCallArguments(liveTool, { type: "toolCall", id: pendingAction.toolCallId, name: pendingAction.toolName, arguments: {} }, a));
594
605
  const beltFace = () => { const f = parkedRowLiveFace(prepared.toolRosterDeltas.current, pendingAction); if (f !== undefined && reading !== undefined)
595
606
  stampArgsReading(f, reading); return f; };
596
- const tryRead = (v) => { try {
597
- return { args: reading === undefined ? v : argsReadBy(reading, v) };
598
- }
599
- catch (error) {
600
- return { args: v, unread: { error } };
601
- } };
607
+ const tryRead = (v) => {
608
+ try {
609
+ const read = reading === undefined ? v : argsReadBy(reading, v);
610
+ const owned = ownArgs(read);
611
+ if (owned.ok && owned.value !== read)
612
+ carryArgsReadFrom(read, owned.value);
613
+ return { args: owned.ok ? owned.value : read };
614
+ }
615
+ catch (error) {
616
+ return { args: v, unread: { error } };
617
+ }
618
+ };
602
619
  const decided = outcome.decision === "allow" ? tryRead(humanRewrite !== undefined ? humanRewrite : pendingAction.args) : { args: humanRewrite !== undefined ? humanRewrite : pendingAction.args };
603
620
  const resolvedArgs = decided.args;
604
621
  const pendingLabel = (() => { const l = liveTool?.label; return l !== undefined && l !== pendingAction.toolName ? { label: l } : {}; })();
@@ -612,7 +629,7 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
612
629
  const settleEnd = async (isError, result, refusedBy, neverRan, extension) => {
613
630
  if (refusedBy !== undefined)
614
631
  occurrences.refuse(pendingAction.toolCallId, refusedBy, extension);
615
- const settled = emitSettled(occurrences, callStart, { result, isError, ...(neverRan ? { notExecuted: true } : {}) }, { push: emit, structured: prepared.structuredProjector, mediaByteCapBytes: runner.deps.mediaByteCapBytes });
632
+ const settled = emitSettled(occurrences, callStart, { result, isError, ...(neverRan ? { notExecuted: true } : {}) }, { push: emit, structured: prepared.structuredProjector, mediaBudgetBase64Chars: runner.deps.mediaBudgetBase64Chars });
616
633
  notExecuted = settled.notExecuted === true;
617
634
  const gate = settled.gate ?? decidedGate;
618
635
  const word = await resume.recordExecutionOutcome(gate);
@@ -622,24 +639,24 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
622
639
  const marks = egressValue("same-principal", thrownMarksOf(error));
623
640
  const text = formatHookFeedback(`The approved tool call "${pendingAction.toolName}" was not executed: the tool could not read ${which} — its argument preparation failed (${egressThrownText("same-principal", error)}). This approval is spent — the call has to be re-issued.`, prepared.reminderMark);
624
641
  await settleEnd(true, { content: text, ...(marks !== undefined ? { details: marks } : {}) }, undefined, true);
625
- emitCommitted(await prepared.session.appendMessage(resultRow(text, true)), "toolResult", pendingAction.toolCallId);
642
+ emitCommitted(await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(text, true)), "toolResult", pendingAction.toolCallId);
626
643
  };
627
644
  const vetoApproval = async (miss) => {
628
645
  const text = formatHookFeedback(miss.message, prepared.reminderMark);
629
646
  await settleEnd(true, { content: text, ...(miss.code !== undefined ? { details: { code: miss.code } } : {}) }, "policy");
630
- emitCommitted(await prepared.session.appendMessage(resultRow(text, true)), "toolResult", pendingAction.toolCallId);
647
+ emitCommitted(await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(text, true)), "toolResult", pendingAction.toolCallId);
631
648
  };
632
649
  if (outcome.decision === "deny") {
633
650
  const settlementKind = outcome.gateOutcome?.settlement?.kind;
634
651
  const reason = settlementKind === "policy_refused"
635
- ? policyRefusalMessage(pendingAction.toolName, undefined, decidersNote(outcome.reason))
652
+ ? policyRefusalMessage(pendingAction.toolName, undefined, decidersNote(outcome.reason), outcome.hostDecision.decidedVia)
636
653
  : settlementKind === "park_sla_expired"
637
654
  ? outcome.reason
638
655
  ? delimitUntrusted("reviewer note", outcome.reason, REVIEWER_NOTE_MAX_BODY)
639
656
  : `No one answered the approval request for the pending tool call "${pendingAction.toolName}" — the approval window elapsed with no answer, so it was not executed.`
640
657
  : humanRefusalSentence("tool use", outcome.reason, prepared.hookIdentity.isDelegatedChild);
641
658
  await settleEnd(true, { content: formatHookFeedback(reason, prepared.reminderMark) });
642
- const eid = await prepared.session.appendMessage(resultRow(formatHookFeedback(reason, prepared.reminderMark), true));
659
+ const eid = await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(formatHookFeedback(reason, prepared.reminderMark), true));
643
660
  emitCommitted(eid, "toolResult", pendingAction.toolCallId);
644
661
  const parkedFallback = pendingAction.denialLimitFallback;
645
662
  if (parkedFallback !== undefined && settlementKind !== undefined && SETTLEMENT_NOBODY_JUDGED[settlementKind]) {
@@ -658,18 +675,10 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
658
675
  if (screened !== undefined && "refused" in screened) {
659
676
  const hookDenial = formatHookFeedback(screened.refused, prepared.reminderMark);
660
677
  await settleEnd(true, { content: hookDenial }, "hook", undefined, screened.extension);
661
- emitCommitted(await prepared.session.appendMessage(resultRow(hookDenial, true)), "toolResult", pendingAction.toolCallId);
678
+ emitCommitted(await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(hookDenial, true)), "toolResult", pendingAction.toolCallId);
662
679
  return;
663
680
  }
664
- const rescreened = screened !== undefined ? tryRead(screened.args) : undefined;
665
- if (rescreened?.unread !== undefined)
666
- return settleUnreadable(rescreened.unread.error, "the arguments a PreToolUse hook rewrote it to");
667
- if (humanRewrite !== undefined && rescreened !== undefined && !sameBytes({}, resolvedArgs, rescreened.args)) {
668
- const text = formatHookFeedback(`${editRewrittenSentence(pendingAction.toolName)}, which a PreToolUse hook wrote — this approval is spent; the call has to be re-issued.`, prepared.reminderMark);
669
- await settleEnd(true, { content: text, details: { editRewritten: { acceptableForm: rescreened.args } } }, "hook");
670
- return emitCommitted(await prepared.session.appendMessage(resultRow(text, true)), "toolResult", pendingAction.toolCallId);
671
- }
672
- const executedArgs = rescreened !== undefined ? rescreened.args : resolvedArgs;
681
+ const executedArgs = resolvedArgs;
673
682
  const unseen = !licenseCovers(pendingAction.boundInputHash, executedArgs);
674
683
  let beltReading;
675
684
  const beltReq = () => ({ toolName: pendingAction.toolName, args: executedArgs, toolCallId: pendingAction.toolCallId, ...callFaceSeat(beltFace()), budget: beltBudget, ...(prepared.cwdRef !== undefined ? { cwd: prepared.cwdRef.current } : {}), ...(prepared.handsRoot !== undefined ? { root: prepared.handsRoot } : {}), ...advertisedWritableRootsSeat(prepared.advertisedWritableDirs), ...exemptRootsSeat(prepared.exemptRoots), ...(beltReading !== undefined ? { targetReading: beltReading } : {}), ...requestGrantBinding((call, args) => skillGrantBindingMembers(call, args, prepared.skillSpecs, SKILL_TOOL_NAME), pendingAction, executedArgs) });
@@ -677,7 +686,7 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
677
686
  if (unjudgeable !== undefined) {
678
687
  const chainDenial = formatHookFeedback(`The approved tool call "${pendingAction.toolName}" was not executed: its input changed after the approval and the inherited ancestor chain cannot judge the changed input (${unjudgeable}). This approval is spent — the call has to be re-issued.`, prepared.reminderMark);
679
688
  await settleEnd(true, { content: chainDenial }, "policy");
680
- emitCommitted(await prepared.session.appendMessage(resultRow(chainDenial, true)), "toolResult", pendingAction.toolCallId);
689
+ emitCommitted(await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(chainDenial, true)), "toolResult", pendingAction.toolCallId);
681
690
  return;
682
691
  }
683
692
  const beltBudget = {
@@ -709,10 +718,10 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
709
718
  : personUnanswered
710
719
  ? " (the call as it would run requires a person's approval, and this decision was the deployment's policy)"
711
720
  : " (the policy rewrote these bytes to a value that was not approved)";
712
- const editedDenial = formatHookFeedback(`${outcome.updatedInput !== undefined ? "The approver EDITED this call's input; the edited call" : "A PreToolUse hook REWROTE this approved call's input; the rewritten call"} is refused by the deployment's tool policy and was not executed${why}.`, prepared.reminderMark);
713
- const outlet = rechecked.action !== "deny" && !personUnanswered && humanRewrite !== undefined && rewrite?.unread === undefined && rewrite !== undefined ? { details: { editRewritten: { acceptableForm: rewrite.args } } } : denialCard(rechecked);
721
+ const editedDenial = formatHookFeedback(`The approver EDITED this call's input; the edited call is refused by the deployment's tool policy and was not executed${why}.`, prepared.reminderMark);
722
+ const outlet = rechecked.action !== "deny" && !personUnanswered && rewrite?.unread === undefined && rewrite !== undefined ? { details: { editRewritten: { acceptableForm: rewrite.args } } } : denialCard(rechecked);
714
723
  await settleEnd(true, { content: editedDenial, ...outlet }, "policy");
715
- emitCommitted(await prepared.session.appendMessage(resultRow(editedDenial, true)), "toolResult", pendingAction.toolCallId);
724
+ emitCommitted(await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(editedDenial, true)), "toolResult", pendingAction.toolCallId);
716
725
  return;
717
726
  }
718
727
  }
@@ -721,7 +730,7 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
721
730
  if (gateOrgGoverned && prepared.permissionRuleOrg === undefined) {
722
731
  const unwiredDenial = formatHookFeedback(`The approved tool call "${pendingAction.toolName}" was not executed: its approval was minted under organization governance (${gateRealApproval.origin}), and this worker has no org adjudication wiring — a governed approval may only be redeemed where governance can be enforced. This approval is spent; re-issue the call on an org-wired worker.`, prepared.reminderMark);
723
732
  await settleEnd(true, { content: unwiredDenial }, "org");
724
- const eid = await prepared.session.appendMessage(resultRow(unwiredDenial, true));
733
+ const eid = await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(unwiredDenial, true));
725
734
  emitCommitted(eid, "toolResult", pendingAction.toolCallId);
726
735
  return;
727
736
  }
@@ -755,7 +764,7 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
755
764
  : "";
756
765
  const orgDenial = formatHookFeedback(`The approved tool call "${pendingAction.toolName}" was not executed: ${blocked}.${orgDisclosures} This approval is spent — the call has to be re-issued and ${unanswered ? "decided by a person" : "approved again once organization policy permits it"}.`, prepared.reminderMark);
757
766
  await settleEnd(true, { content: orgDenial }, "org");
758
- const eid = await prepared.session.appendMessage(resultRow(orgDenial, true));
767
+ const eid = await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(orgDenial, true));
759
768
  emitCommitted(eid, "toolResult", pendingAction.toolCallId);
760
769
  return;
761
770
  }
@@ -765,7 +774,7 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
765
774
  if (narrowed.action === "deny") {
766
775
  const narrowedDenial = formatHookFeedback(`The approved tool call "${pendingAction.toolName}" is now denied by ${ruleSourcePhrase("narrowing")} and was not executed${narrowed.message ? `: ${narrowed.message}` : ""}.`, prepared.reminderMark);
767
776
  await settleEnd(true, { content: narrowedDenial, ...denialCard(narrowed) }, "policy");
768
- const eid = await prepared.session.appendMessage(resultRow(narrowedDenial, true));
777
+ const eid = await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(narrowedDenial, true));
769
778
  emitCommitted(eid, "toolResult", pendingAction.toolCallId);
770
779
  return;
771
780
  }
@@ -774,7 +783,7 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
774
783
  if (skillRefusal !== undefined) {
775
784
  const skillDenial = formatHookFeedback(`The approved tool call "${pendingAction.toolName}" was not executed: ${skillRefusal.message}. This approval is spent — the call has to be re-issued.`, prepared.reminderMark);
776
785
  await settleEnd(true, { content: skillDenial }, "policy");
777
- emitCommitted(await prepared.session.appendMessage(resultRow(skillDenial, true)), "toolResult", pendingAction.toolCallId);
786
+ emitCommitted(await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(skillDenial, true)), "toolResult", pendingAction.toolCallId);
778
787
  return;
779
788
  }
780
789
  if (prepared.persistedRuleLane !== undefined) {
@@ -797,7 +806,7 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
797
806
  : `it could not be read against your standing deny/ask rules (${read.reason})`;
798
807
  const ruleDenial = formatHookFeedback(`The approved tool call "${pendingAction.toolName}" was not executed: ${why}. This approval is spent — the call has to be re-issued and approved again.`, prepared.reminderMark);
799
808
  await settleEnd(true, { content: ruleDenial, ...denialCard(tightened.decision) }, "persisted_rule");
800
- const eid = await prepared.session.appendMessage(resultRow(ruleDenial, true));
809
+ const eid = await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(ruleDenial, true));
801
810
  emitCommitted(eid, "toolResult", pendingAction.toolCallId);
802
811
  return;
803
812
  }
@@ -820,7 +829,7 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
820
829
  if (reading.kind === "refuse" || reading.kind === "silence" || (unseen && reading.kind !== "vouch")) {
821
830
  const readDenial = formatHookFeedback(`The approved tool call "${pendingAction.toolName}" was not executed: ${reading.verdict.sentence ?? "the read boundary does not vouch for what it reads on this leg"} This approval is spent — the call has to be re-issued and approved again.`, prepared.reminderMark);
822
831
  await settleEnd(true, { content: readDenial, ...(reading.verdict.details !== undefined ? { details: reading.verdict.details } : {}) }, "read_boundary");
823
- const eid = await prepared.session.appendMessage(resultRow(readDenial, true));
832
+ const eid = await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(readDenial, true));
824
833
  emitCommitted(eid, "toolResult", pendingAction.toolCallId);
825
834
  return;
826
835
  }
@@ -841,13 +850,13 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
841
850
  if (crossBoundaryRefusal !== undefined) {
842
851
  const text = formatHookFeedback(crossBoundaryRefusal.message, prepared.reminderMark);
843
852
  await settleEnd(true, { content: text }, "policy");
844
- emitCommitted(await prepared.session.appendMessage(resultRow(text, true)), "toolResult", pendingAction.toolCallId);
853
+ emitCommitted(await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(text, true)), "toolResult", pendingAction.toolCallId);
845
854
  return;
846
855
  }
847
856
  if ((prepared.crossBoundary?.storeWaits() ?? 0) === waited)
848
857
  break;
849
858
  }
850
- const args = executedArgs;
859
+ const args = structuredClone(executedArgs);
851
860
  screened?.admit();
852
861
  onExecuteStart?.(pendingAction.toolCallId);
853
862
  occurrences.release(pendingAction.toolCallId);
@@ -863,14 +872,14 @@ async function resolvePendingCall(runner, prepared, resume, emit, emitCommitted,
863
872
  const failed = await finalize({ result: { content: [{ type: "text", text: execError }], details: marks ?? {} }, isError: true });
864
873
  const failedText = failed.result.content.flatMap((c) => (c.type === "text" ? [c.text] : [])).join("\n");
865
874
  await settleEnd(true, { content: failedText, ...(marks !== undefined ? { details: marks } : {}) });
866
- const eid = await prepared.session.appendMessage(resultRow(failedText, true));
875
+ const eid = await appendAdmittedRow(prepared.admitRows, prepared.session, resultRow(failedText, true));
867
876
  emitCommitted(eid, "toolResult", pendingAction.toolCallId);
868
877
  return;
869
878
  }
870
879
  const ran = await finalize({ result: res, isError: res.isError === true });
871
880
  await settleEnd(ran.isError, ran.result);
872
881
  onResolvedToolSuccess?.(pendingAction.toolName, ran.isError ? undefined : ran.result.details);
873
- const eid = await prepared.session.appendMessage({
882
+ const eid = await appendAdmittedRow(prepared.admitRows, prepared.session, {
874
883
  role: "toolResult",
875
884
  toolCallId: pendingAction.toolCallId,
876
885
  toolName: pendingAction.toolName,
@@ -1,7 +1,7 @@
1
1
  import { type PeerInboundChainRef } from "../../agents/peer-admission.js";
2
2
  import type { PushQueue } from "../push-queue.js";
3
3
  import type { SessionStore } from "../session.js";
4
- import { type NotificationInjectionOutcome, type PendingSessionNotifications, type SystemInjectionPriority, type TaskNotificationPayload } from "../task-notification.js";
4
+ import { DeliveryObligations, type NotificationInjectionOutcome, type PendingSessionNotifications, type SystemInjectionPriority, type TaskNotificationPayload } from "../task-notification.js";
5
5
  import type { RunnerDeps, TaskEvent, TaskSpec } from "../types.js";
6
6
  import type { SessionReadFileStates } from "./session-read-file-states.js";
7
7
  import type { SessionModeSeats } from "./session-mode-seats.js";
@@ -59,5 +59,7 @@ export interface RunNotificationLaneResult {
59
59
  notificationLane: NotificationLaneBindings;
60
60
  /** The queue subscription's release; the leg lane's finally calls it right after flipping `live`. */
61
61
  unsubscribeTaskNotifications: () => void;
62
+ /** The terminal frames this lane is still owed by loop-type tasks admitted onto its sink — what a one-shot ending waits on. */
63
+ deliveryObligations: DeliveryObligations;
62
64
  }
63
65
  export declare function runNotificationLane<R>(input: RunNotificationLaneInput<R>): Promise<R>;