@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
@@ -10,6 +10,7 @@ import type { ResumeRun, ResumeTaskConfig, RunInternals, RunnerSelfSeat } from "
10
10
  export type { ResumeTaskConfig } from "./contracts.js";
11
11
  import type { CompactSessionRequest, CompactSessionResult } from "../auto-compaction.js";
12
12
  import type { RewindFilesRequest, RewindFilesResult } from "../file-history-store.js";
13
+ import { type PeerDeclarationHold, type PeerDeclarations } from "../peer-seat.js";
13
14
  /**
14
15
  * A stateless task runner. Holds shared deps (the external brain, model catalog) and an
15
16
  * in-memory session store so that passing a `sessionId` continues a prior conversation.
@@ -55,9 +56,9 @@ export declare class Runner implements RunnerSelfSeat {
55
56
  * the ORIGINAL stream's closure as the reaping owner, deliberately), and when the terminal arm
56
57
  * wins. Bounded by live suspended streams (the closures hold the same handles). */
57
58
  private readonly suspendedEnvReaps;
58
- /** SAME-RUNNER claim marks for {@link suspendedEnvReaps}: a token appears
59
- * here from the moment an in-process actor ATTEMPTS its settling CAS (the terminal preflight's
60
- * expire; a resume's resolve) until that actor's duty decision is done. The losing stream-side
59
+ /** SAME-RUNNER claims for {@link suspendedEnvReaps}, one PER ATTEMPT: a token is held from the moment an
60
+ * in-process actor ATTEMPTS its settling CAS (the terminal preflight's or the void verb's expire; a resume's
61
+ * resolve) until that actor's duty decision closes its own claim (never another's). The losing stream-side
61
62
  * reap preserves a record ONLY while a local claim is in flight — a CROSS-Runner settlement
62
63
  * leaves no local claim, so the loser retires the record (drops the strong ref; physical cleanup
63
64
  * belongs to the winning owner, unprovable from here) instead of retaining env handles without
@@ -76,6 +77,8 @@ export declare class Runner implements RunnerSelfSeat {
76
77
  emitTaskOutcome(outcome: TaskOutcome): void;
77
78
  /** Whether a child this Runner runs can be placed in another tree: {@link RunnerSelfSeat.canRerootChild}. */
78
79
  canRerootChild(): boolean;
80
+ /** A hold of `declared`'s references on this Runner's peer seat: {@link RunnerSelfSeat.holdDeclarations}. A seat member that throws reaches `onError`. */
81
+ holdDeclarations(declared: PeerDeclarations, sessionId?: string): PeerDeclarationHold;
79
82
  /** The deployment agent catalog (RunnerDeps.agents/builtinAgents), exposed READ-ONLY
80
83
  * so the Agent-tool lane (`createSubagentTool`) defaults to the SAME registry the workflow lane
81
84
  * consumes (single source; the types.ts "pass the same array" follow-on made structural). The array
@@ -127,8 +130,8 @@ export declare class Runner implements RunnerSelfSeat {
127
130
  * `undefined` clears an optional seat: `tiers: undefined` ⇒ no bindings, a face seat `undefined` ⇒ the
128
131
  * engine default); a key absent is kept. `tiers` omitted beside `models` ⇒ the current bindings are
129
132
  * re-applied over the new catalog.
130
- * - **Announced per seat.** `config.models_swapped` (models/tiers counts — key material only, never the
131
- * catalog itself) and
133
+ * - **Announced per seat.** `config.models_swapped` (models/tiers counts and the candidate's `generation` — key
134
+ * material only, never the catalog itself) and
132
135
  * `config.read_face_swapped` / `config.write_face_swapped` (`{ from, to, occurrenceId }`, the seat's
133
136
  * previous and new value, `null` = no declaration) — the table {@link SWAP_SEAT_NOTICE} binds every
134
137
  * seat to its line.
@@ -246,8 +249,8 @@ export declare class Runner implements RunnerSelfSeat {
246
249
  * registry auto re-supplies them; see `parentConstraintRegistry`). The re-supplied chain's LENGTH must
247
250
  * match the checkpoint's recorded `parentConstraintCount` (`resume.parent_constraint_mismatch`
248
251
  * otherwise). Most entries are policies the deployment authored and can hand straight back; a
249
- * hook-wired ancestor also contributes a PreToolUse SCREENING entry (issue #33) whose policy the
250
- * engine mints — rebuild that one with the exported `createPreToolUseConstraintPolicy(hook, env)`. The DATA half (ancestorRules/shellGate) rides the checkpoint itself and needs no
252
+ * mods-wired ancestor also contributes a SCREENING entry (issue #33), its installation — rebuild that one as
253
+ * `{ installation: await admitModChain(…), hookEnv, …regime }`. The DATA half (ancestorRules/shellGate) rides the checkpoint itself and needs no
251
254
  * re-supply; on the resumed leg the CHECKPOINT snapshot is the trust floor — live internals may only
252
255
  * TIGHTEN it (per-entry rev-monotonic ancestorRules replacement, max-rank shellGate fold), never
253
256
  * displace it wholesale. TRUST BOUNDARY: `internals` is the DEPLOYMENT trust channel (the same tier as
@@ -256,6 +259,21 @@ export declare class Runner implements RunnerSelfSeat {
256
259
  * authority, so constraint substitution here is outside the enforced threat model (the count check
257
260
  * catches shape MISTAKES, not a untrusted trusted caller). */
258
261
  internals?: RunInternals): Promise<TaskStream>;
262
+ /**
263
+ * Void a verification gate's VERIFIER card — the pause `VerificationOutcome.verifierPause` hands back — and unpin the verifier
264
+ * session it held: the cancel a host that will not decide the card takes, instead of leaving it to the reaper. The card is
265
+ * read first: only one whose `CheckpointState.compositionLeg` records a `verify` leg is voided (any other is refused,
266
+ * `resume.composition_mismatch`, nothing settled). Voiding is the single-shot expire CAS — the row ends `expired`, the same end
267
+ * an expiry gives it (a later resume of the token is refused as after one, `checkpoint.already_resolved`; the gate's result the
268
+ * caller holds is untouched), with the same duty (the paused env this process holds destroyed, the parked-constraint entry evicted) —
269
+ * and then the session is UNPINNED, the end state a resumed run's terminal leaves (not released: its transcript stays the
270
+ * session store's to evict). Resolves `true` when this call voided the card, `false` when another settler already had (a
271
+ * resume won, the reaper or an earlier void expired it) — its winner owns the unpin; an expired row's env this process holds is
272
+ * still destroyed (whoever expired it), and calling again answers `false`.
273
+ * @throws {@link CheckpointError} `not_found` (no store wired / unknown token), `resume.composition_mismatch` (not a verifier's card),
274
+ * `checkpoint.void_unpin_failed` (voided, but the session's unpin threw or wedged: still pinned).
275
+ */
276
+ voidVerifierPause(token: CheckpointToken): Promise<boolean>;
259
277
  /**
260
278
  * The resume decision ladder after admission (E3–E10), driving the eight `resume-*` lanes in
261
279
  * the order the one-function ladder had: the review / park twins, the approval twin and its bindings, the
@@ -1,3 +1,5 @@
1
+ import { legTaskIdOf } from "../leg-identity.js";
2
+ import { restoreRowTaskId } from "./checkpoint-scope.js";
1
3
  import { deliverEngineNotice } from "../types.js";
2
4
  import { withDeploymentAllowedTools } from "../allow-entry.js";
3
5
  import { uuidv7 } from "../../internal/harness.js";
@@ -8,8 +10,8 @@ import { boundInputHashOf } from "../canonical-json.js";
8
10
  import { emitTrace } from "../trace.js";
9
11
  import { emitTaskOutcome } from "../task-outcome.js";
10
12
  import { runWithCapabilityWithheld, runWithReasoningWireFacts } from "../../brain/status-sink.js";
11
- import { expandTiers } from "../roles.js";
12
- import { announceReadDenySwap, screenSwappableDeps } from "../swappable-deps.js";
13
+ import { receiveModelCatalog } from "../roles.js";
14
+ import { announceReadDenySwap, catalogGenerationOf, screenSwappableDeps } from "../swappable-deps.js";
13
15
  import { runSideQuery } from "../side-query.js";
14
16
  import { PushQueue } from "../push-queue.js";
15
17
  import { TtlSessionStore } from "../session-store.js";
@@ -38,9 +40,12 @@ import { resumeInternalsAndConfig } from "./resume-internals-and-config.js";
38
40
  import { resumeApply } from "./resume-apply.js";
39
41
  import { resumePreflight } from "./resume-preflight.js";
40
42
  import { resumeClaim } from "./resume-claim.js";
43
+ import { voidVerifierPause } from "./void-verifier-pause.js";
44
+ import { LocalClaims } from "./local-claims.js";
41
45
  import { streamSettleBackstop } from "./stream-settle-backstop.js";
42
46
  import { streamReap } from "./stream-reap.js";
43
47
  import { streamSteerVerb } from "./stream-steer-verb.js";
48
+ import { bindAuthoredSteer } from "../input-author.js";
44
49
  import { steeringError } from "./steer-admission.js";
45
50
  import { streamLifecycleVerbs } from "./stream-lifecycle-verbs.js";
46
51
  import { streamHaltVerbs } from "./stream-halt-verbs.js";
@@ -67,6 +72,9 @@ import { deploymentCanRerootChild } from "./child-tree.js";
67
72
  import { rewindSessionFiles } from "./rewind-files.js";
68
73
  import { compactIdleSession } from "./compact-session.js";
69
74
  import { egressThrownText } from "../untrusted-egress.js";
75
+ import { holdPeerDeclarations } from "../peer-seat.js";
76
+ import { receivePeerDeclarations, receivedDeclarations } from "../locked-config.js";
77
+ import { readCallerSpec } from "../task-spec-members.js";
70
78
  export class Runner {
71
79
  deps;
72
80
  sessions;
@@ -78,7 +86,7 @@ export class Runner {
78
86
  pendingSessionNotifications = new PendingSessionNotifications();
79
87
  parentConstraintRegistry = new Map();
80
88
  suspendedEnvReaps = new Map();
81
- locallyClaimedTokens = new Set();
89
+ locallyClaimedTokens = new LocalClaims();
82
90
  static PARENT_CONSTRAINT_REGISTRY_CAP = 1024;
83
91
  depsSeat;
84
92
  constructor(deps) {
@@ -86,8 +94,8 @@ export class Runner {
86
94
  const runner = this;
87
95
  this.depsSeat = { get deps() { return runner.deps; } };
88
96
  this.deps = withDeploymentAllowedTools(retained);
89
- if (this.deps.tiers) {
90
- this.deps = { ...this.deps, models: expandTiers(this.deps.models, this.deps.tiers) };
97
+ if (this.deps.models !== undefined || this.deps.tiers !== undefined) {
98
+ this.deps = { ...this.deps, ...receiveModelCatalog(this.deps.models, this.deps.tiers, "RunnerDeps") };
91
99
  }
92
100
  if (this.deps.contextSettings !== undefined) {
93
101
  this.deps = { ...this.deps, contextSettings: assertContextSettingsWords(assertContextSettingsValue(this.deps.contextSettings, "RunnerDeps"), this.deps.models, "RunnerDeps") };
@@ -132,6 +140,9 @@ export class Runner {
132
140
  emitTaskOutcome(this.deps, outcome);
133
141
  }
134
142
  canRerootChild() { return deploymentCanRerootChild(this.deps); }
143
+ holdDeclarations(declared, sessionId) {
144
+ return holdPeerDeclarations(this.deps.peerSeat, declared, (err) => this.deps.onError?.(err, { phase: "config", sessionId: sessionId ?? "(pre-session)", classification: "peer-seat-hold" }));
145
+ }
135
146
  get agentCatalog() {
136
147
  return {
137
148
  ...(this.deps.agents ? { agents: [...this.deps.agents] } : {}),
@@ -180,9 +191,9 @@ export class Runner {
180
191
  let expanded;
181
192
  let tiers;
182
193
  if (catalogSwap) {
183
- const models = candidate.models;
184
- tiers = Object.hasOwn(candidate, "tiers") ? candidate.tiers : this.deps.tiers;
185
- expanded = tiers && Object.keys(tiers).length > 0 ? expandTiers({ ...models }, tiers) : { ...models };
194
+ const generation = receiveModelCatalog(candidate.models, Object.hasOwn(candidate, "tiers") ? candidate.tiers : this.deps.tiers, "swapDeps");
195
+ expanded = generation.models;
196
+ tiers = generation.tiers;
186
197
  }
187
198
  const faceSeats = ["readFace", "writeFace"].filter((seat) => seats.includes(seat));
188
199
  const priorFaces = {
@@ -212,7 +223,7 @@ export class Runner {
212
223
  deliverEngineNotice(this.deps.onNotice, {
213
224
  code: "config.models_swapped",
214
225
  message: `model catalog swapped: ${modelCount} model(s), ${tiers ? Object.keys(tiers).length : 0} tier binding(s); in-flight tasks finish on their resolved models, new tasks resolve against the new catalog`,
215
- detail: { models: modelCount, tiers: tiers ? Object.keys(tiers).length : 0, occurrenceId: uuidv7() },
226
+ detail: { models: modelCount, tiers: tiers ? Object.keys(tiers).length : 0, generation: catalogGenerationOf(candidate.models, tiers), occurrenceId: uuidv7() },
216
227
  });
217
228
  }
218
229
  if (seats.includes("contextSettings")) {
@@ -248,6 +259,7 @@ export class Runner {
248
259
  throw new TypeError("runTaskStream: `resume` must be a ResumeRun carrying `outcome` — got a value without one. " +
249
260
  "(Note the parameter order: runTaskStream(spec, resume?, internals?) — internals is the THIRD parameter.)");
250
261
  }
262
+ spec = readCallerSpec(spec).spec;
251
263
  const entryActor = spec.actor === undefined ? undefined : snapshotActorAssertion(spec.actor);
252
264
  const entryTracer = { tracer: spec.tracer ?? this.deps.tracer };
253
265
  const queue = new PushQueue();
@@ -279,7 +291,7 @@ export class Runner {
279
291
  w.resolve(outcome);
280
292
  };
281
293
  const runStartedAt = Date.now();
282
- const taskIdRef = { current: spec.taskId, sessionId: spec.sessionId };
294
+ const taskIdRef = { current: legTaskIdOf(spec, restoreRowTaskId(internals, resume?.cp.state.rowTaskId), undefined), sessionId: spec.sessionId };
283
295
  let held;
284
296
  let releaseLock;
285
297
  const holdSessionLock = (sessionId) => {
@@ -291,6 +303,8 @@ export class Runner {
291
303
  };
292
304
  const namedSessionId = spec.sessionId;
293
305
  const legWrites = this.sessionWrites.openLeg((err, sessionId) => this.deps.onError?.(err, { phase: "degraded", sessionId }));
306
+ const receivedPeers = receivePeerDeclarations(spec, this.deps);
307
+ const declarationHold = this.holdDeclarations(receivedDeclarations(receivedPeers), namedSessionId);
294
308
  const run = (async () => {
295
309
  try {
296
310
  if (namedSessionId)
@@ -304,7 +318,7 @@ export class Runner {
304
318
  resultValue = r;
305
319
  const pcs = internals?.inheritedGate?.parentConstraints;
306
320
  if (resume !== undefined)
307
- this.locallyClaimedTokens.delete(resume.cp.token);
321
+ this.locallyClaimedTokens.close(resume.cp.token);
308
322
  const rToken = r.terminal.kind === "paused" ? r.terminal.token : undefined;
309
323
  if (resume !== undefined && rToken !== resume.cp.token) {
310
324
  this.parentConstraintRegistry.delete(resume.cp.token);
@@ -333,7 +347,7 @@ export class Runner {
333
347
  manualCompactRef,
334
348
  taskIdRef,
335
349
  resume,
336
- internals: { ...(internals ?? {}), detachHub, forwardScope: createForwardSinkScope(this.deps.onNotice) },
350
+ internals: { ...(internals ?? {}), detachHub, forwardScope: createForwardSinkScope(this.deps.onNotice), receivedPeers },
337
351
  notifyRef,
338
352
  captureOptOutRef,
339
353
  mcpRedialRef,
@@ -363,15 +377,16 @@ export class Runner {
363
377
  locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
364
378
  }).onRunRejected);
365
379
  void settled.then(() => acceptedSteerInputs.clear(), () => acceptedSteerInputs.clear());
380
+ void settled.then(() => declarationHold.release(), () => declarationHold.release());
366
381
  const { reapSuspended } = streamReap({
367
382
  live, runner: this.depsSeat,
368
383
  locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
369
384
  });
370
- const { steer } = streamSteerVerb({ spec, internals, queue, acceptedSteerInputs, live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, steeringError, runner: this.depsSeat });
385
+ const { steer, authoredSteer } = streamSteerVerb({ spec, internals, queue, acceptedSteerInputs, live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, steeringError, runner: this.depsSeat });
371
386
  const { notify, optOutMemoryCapture, reconnectMcpServer, compact, detach, interrupt } = streamLifecycleVerbs({ live, ready, orTimeout, steeringError, notifyRef, captureOptOutRef, mcpRedialRef, manualCompactRef, detachHub });
372
- const { halt, destroy } = streamHaltVerbs({ spec, live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, run, reapSuspended, runner: this.depsSeat });
387
+ const { halt, destroy } = streamHaltVerbs({ live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, run, reapSuspended, runner: this.depsSeat });
373
388
  const { setPermissionMode } = streamModeVerb({ live, ready, orTimeout, steeringError });
374
- return {
389
+ const stream = {
375
390
  [Symbol.asyncIterator]: () => queue[Symbol.asyncIterator](),
376
391
  result: async () => {
377
392
  await settled;
@@ -392,6 +407,8 @@ export class Runner {
392
407
  halt,
393
408
  destroy,
394
409
  };
410
+ bindAuthoredSteer(stream, authoredSteer);
411
+ return stream;
395
412
  }
396
413
  runLocked(input) {
397
414
  const { spec, queue, setResult, onSuggestions, onReady, onSuspend, manualCompactRef, taskIdRef, holdSessionLock, legWrites, resume, internals, notifyRef, captureOptOutRef, mcpRedialRef, entryActor, entryTracer } = input;
@@ -399,7 +416,7 @@ export class Runner {
399
416
  spec, queue, resume, internals, taskIdRef, holdSessionLock, legWrites,
400
417
  runner: this.depsSeat, self: this, sessions: this.sessions, sessionReadStates: this.sessionReadStates, sessionModeSeats: this.sessionModeSeats, pendingSessionNotifications: this.pendingSessionNotifications,
401
418
  prepareTask,
402
- next: ({ prepared, injectTaskNotification, deliveredAtTurnOpen, peerInboundChainRef, modelCatalog, notificationLane, unsubscribeTaskNotifications }) => {
419
+ next: ({ prepared, injectTaskNotification, deliveredAtTurnOpen, peerInboundChainRef, modelCatalog, notificationLane, unsubscribeTaskNotifications, deliveryObligations }) => {
403
420
  const { runSourceTaskId, parentToolCallId, ident, emitDelegationLifecycle, loopLatch, stats, internalsNotifier, undrainedUserAtEnd, userInputLostAtEnd } = runIdentityWiring({
404
421
  spec, queue, prepared, internals, taskIdRef, onReady, manualCompactRef, notifyRef, captureOptOutRef, mcpRedialRef, injectTaskNotification, deliveredAtTurnOpen, peerInboundChainRef,
405
422
  notificationLane, pendingSessionNotifications: this.pendingSessionNotifications, runner: this.depsSeat,
@@ -417,7 +434,7 @@ export class Runner {
417
434
  const { withBrainSinks, withLegRequestSinks } = runBrainSinks({ queue, internals, rs, ident, observeReasoningWireFacts, notice: { onNotice: this.deps.onNotice, sessionId: prepared.sessionId, runId: prepared.runId }, announced: prepared });
418
435
  const toolLabels = new Map(prepared.tools.flatMap((t) => (t.label !== undefined && t.label !== t.name ? [[t.name, t.label]] : [])));
419
436
  for (const orphan of prepared.wakeRecovered) {
420
- emitSettled(prepared.toolOccurrences, { toolCallId: orphan.toolCallId, spelledName: orphan.toolName, ...(toolLabels.has(orphan.toolName) ? { label: toolLabels.get(orphan.toolName) } : {}), args: orphan.args }, reconciledEnd(orphan), { push: (f) => queue.push({ ...f, ...ident() }), structured: prepared.structuredProjector, mediaByteCapBytes: this.deps.mediaByteCapBytes });
437
+ emitSettled(prepared.toolOccurrences, { toolCallId: orphan.toolCallId, spelledName: orphan.toolName, ...(toolLabels.has(orphan.toolName) ? { label: toolLabels.get(orphan.toolName) } : {}), args: orphan.args }, reconciledEnd(orphan), { push: (f) => queue.push({ ...f, ...ident() }), structured: prepared.structuredProjector, mediaBudgetBase64Chars: this.deps.mediaBudgetBase64Chars });
421
438
  emitCommitted(orphan.entryId, "toolResult", orphan.toolCallId);
422
439
  }
423
440
  const postToolBatchArmed = prepared.modBus.hasHandlers("classic.PostToolBatch");
@@ -426,14 +443,14 @@ export class Runner {
426
443
  const { onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, announceWorkspaceMove } = createHarnessHandlers({
427
444
  prepared, stats, rs,
428
445
  deps: {
429
- spec, queue, internals, ident, mediaByteCapBytes: this.deps.mediaByteCapBytes,
446
+ spec, queue, internals, ident, mediaBudgetBase64Chars: this.deps.mediaBudgetBase64Chars,
430
447
  pushContent, emitCommitted, startedToolCallIds, toolStartAt, toolProgress, writeFamilyOf,
431
448
  toolLabels, postToolBatchArmed, batchArgs, internalsNotifier,
432
449
  runnerHooks: { onError: (e, info) => this.deps.onError?.(e, info), onNotice: this.deps.onNotice },
433
450
  },
434
451
  });
435
452
  const { compactionBrain, withinTaskCompaction, compactionBreaker, windowSafetyOptions } = runCompactionMachinery({ spec, prepared, rs, stats, noteUnevaluablePriceTable, modelCatalog, runner: this.depsSeat });
436
- runStopAndFinalVerify({ spec, prepared, queue, rs, stats, ident, walltimeMonotonicDeadline, runner: this.depsSeat });
453
+ runStopAndFinalVerify({ spec, prepared, queue, rs, stats, ident, walltimeMonotonicDeadline, deliveryObligations, runner: this.depsSeat });
437
454
  runRecoveryLanes({ spec, prepared, queue, rs, ident, compactionBrain, compactionBreaker, windowSafetyOptions, callerStop: loopLatch.callerStop, runner: this.depsSeat });
438
455
  const rapidRefill = createRapidRefillState();
439
456
  const drainManualCompact = (outcome) => {
@@ -454,7 +471,7 @@ export class Runner {
454
471
  });
455
472
  const { flushGitMirror, unsubGitRetry, unsubBoundary, unsub } = runGitLane({ prepared, queue, rs, ident, onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, onTurnBoundary, runner: this.depsSeat });
456
473
  return withLegRequestSinks(() => runLeg({
457
- spec, queue, prepared, resume, rs, entryActor, operatorObjective: internals?.operatorObjective === true, effectiveTimeoutMs, timeout, pushContent, ident, emitCommitted, writeFamilyOf, startedToolCallIds,
474
+ spec, queue, prepared, resume, rs, entryActor, objectiveAuthor: internals?.objectiveAuthor, effectiveTimeoutMs, timeout, pushContent, ident, emitCommitted, writeFamilyOf, startedToolCallIds,
458
475
  announceWorkspaceMove, withBrainSinks, flushGitMirror, loopLatch, notificationLane, unsubscribeTaskNotifications, unsubGitRetry, unsubBoundary, unsub,
459
476
  runner: this.depsSeat,
460
477
  next: ({ final, threw, abortedLive, userInterruptedLive, strandedHumanAnswers }) => runTerminalAdoption({
@@ -493,10 +510,16 @@ export class Runner {
493
510
  taskConfig,
494
511
  internals,
495
512
  runner: this.depsSeat, sessions: this.sessions,
496
- parentConstraintRegistry: this.parentConstraintRegistry,
513
+ parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
497
514
  next: (admitted) => this.resumeLadder(token, outcome, admitted),
498
515
  });
499
516
  }
517
+ async voidVerifierPause(token) {
518
+ return await voidVerifierPause({
519
+ token, runner: this.depsSeat, sessions: this.sessions,
520
+ locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
521
+ });
522
+ }
500
523
  async resumeLadder(token, outcome, admitted) {
501
524
  const { config, internals, store, cp, outcomeGate, resumeSignal, wakeMessage } = admitted;
502
525
  const { plainReviewOutcome, plainParkOutcome } = resumeReviewOutcome({ cp, outcome, outcomeGate, wakeMessage });
@@ -514,7 +537,8 @@ export class Runner {
514
537
  locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
515
538
  next: () => resumeClaim({
516
539
  token, cp, store, outcomeForStore, holder: internals?.holder,
517
- locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry,
540
+ locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
541
+ onDestroyError: (err, sessionId) => this.depsSeat.deps.onError?.(err, { phase: "config", sessionId }),
518
542
  next: () => this.resumeHandoff({ token, cp, store, config, internals, resumeInternals, plainPolicyOutcome, redeemedAnswer, outcomeForStore, wakeMessage, wakeHookContext, legMods, resumeSignal }),
519
543
  }),
520
544
  }),
@@ -1,6 +1,6 @@
1
1
  import type { ExecutionEnv } from "../../internal/harness-types.js";
2
2
  import type { ToolEffect } from "../types.js";
3
- import type { NamedToolPolicy } from "../tool-policy.js";
3
+ import { type NamedToolPolicy } from "../tool-policy.js";
4
4
  import { type SessionPermissionRules, type SessionPolicyStore, type SessionRuleEntryField, type StoredSessionRules } from "../session-policy-store.js";
5
5
  import type { PathRuleBases } from "../permission-rule-model.js";
6
6
  /** The FULL path-confinable write-tool set: every catalog tool declaring a write path target — `Write` / `Edit`
@@ -1,6 +1,7 @@
1
1
  import { canonicalizeTarget, isWinFormPath, pathFamilyOf, writeTargetPath } from "../../tools/fs/safety.js";
2
+ import { REFUSES_NO_WHOLE_TOOL, TOOL_TABLE_VIEW_READ } from "../tool-policy.js";
2
3
  import { SESSION_RULES_GRAMMAR, compileSessionRuleBucket, continuesLineage, earlierGrammarAnnouncer, earlierGrammarEntries, earlierGrammarRefusalClause, readSessionRulesShape, unreadableDenyEntries } from "../session-policy-store.js";
3
- import { compiledEntryName, judgeAllowEntries, uncoveredCommandSegment } from "../allow-entry.js";
4
+ import { compiledEntryName, judgeAllowEntries, uncoveredCommandSegment, wholeToolEntryOf } from "../allow-entry.js";
4
5
  import { inlineUntrusted } from "../untrusted-text.js";
5
6
  import { callTargetReadingOf, pathTargetBaseOf, readCallTarget } from "../effective-path-target.js";
6
7
  import { egressThrownText } from "../untrusted-egress.js";
@@ -137,6 +138,10 @@ export function createSessionRulePolicy(rules, opts) {
137
138
  const seedNames = compile(seed).names;
138
139
  return {
139
140
  nameSets: [{ ...(seedNames.deny.length > 0 ? { deny: seedNames.deny } : {}), ...(seedNames.allow.length > 0 ? { allow: seedNames.allow } : {}) }],
141
+ async wholeToolRefusals(signal) {
142
+ const { deny: denyRows, unreadable } = compile(await readRules(TOOL_TABLE_VIEW_READ, signal));
143
+ return unreadable !== undefined || denyRows.length === 0 ? REFUSES_NO_WHOLE_TOOL : (tool) => wholeToolEntryOf(denyRows, tool, "deny") !== undefined;
144
+ },
140
145
  async check(req, signal) {
141
146
  const { deny: denyRows, allow: allowRows, earlier, allowDirs, unreadable, pathRows } = compile(await readRules(req.toolCallId, signal));
142
147
  if (unreadable !== undefined)
@@ -5,7 +5,7 @@
5
5
  * ONE FACT, ONE MINT. Which entries a shell child loses is decided by the execution environment's one composition
6
6
  * (`inheritedHostEnv(policy, findings)` and the adapter's explicit grants), and the environment hands the result over as
7
7
  * the read `ExecutionEnv.withheldEnv`. This seat reads that answer and tells it; it never recomputes it (the policy and
8
- * the grants are the adapter's, not the run's). The split into the scrub's half and the deployment's own credentials is
8
+ * the grants are the adapter's, not the run's). The split into the scrub's half and the engine's own credentials is
9
9
  * the one the operator notice uses (`withheldEnvNames`).
10
10
  *
11
11
  * WHEN. At the start of every call to the engine's own shell tool (its mount, judged by the catalog's mount judge), on a
@@ -1,5 +1,5 @@
1
1
  import { readSkillTable } from "../skill-grant.js";
2
- import { assertNoRetiredKeys, RETIRED_TASK_SPEC_KEYS } from "../retired-keys.js";
2
+ import { assertNoRetiredKeys, RETIRED_SKILLS_SEAT_KEYS } from "../retired-keys.js";
3
3
  import { skillBaseDirOf } from "./skill-base-dir.js";
4
4
  const SKILLS_SEAT = "TaskSpec.skills";
5
5
  const kindOf = (v) => (v === null ? "null" : Array.isArray(v) ? "an array" : typeof v);
@@ -32,7 +32,7 @@ export function readSkillsSeat(skills) {
32
32
  return [];
33
33
  if (!Array.isArray(skills))
34
34
  throw skillsSeatRefusal(SKILLS_SEAT, `must be a list (got ${kindOf(skills)})`);
35
- assertNoRetiredKeys({ skills }, RETIRED_TASK_SPEC_KEYS, "TaskSpec");
35
+ assertNoRetiredKeys({ skills }, RETIRED_SKILLS_SEAT_KEYS, "TaskSpec");
36
36
  const seen = new Set();
37
37
  const out = [];
38
38
  for (const [i, raw] of skills.entries()) {
@@ -1,19 +1,6 @@
1
- /**
2
- * The TaskStream façade's HALT verbs (T7), verbatim from `Runner.runTaskStream`: `halt` (the bare
3
- * user interrupt — the finished-task refusal, the fresh liveness test on the resolved handle, `apply` with its
4
- * pre-abort ownership snapshot, the conjunctive attribution seat, the unconsumed-halt and turn-cut notices, and
5
- * the birth-window poll; never on the steer FIFO chain) and `destroy` (the once-memoized reap: abort, await the
6
- * run's settle bounded, then the reap lane's step). Two Runner reads, both the deployment's notice sink.
7
- *
8
- * Both closures are the ones the one-file façade returned, installed by the driver under their old names — no
9
- * await inside either moved off its tick. `destroyOnce` (the verb's memo) moved with the verb: it is written and
10
- * read by `destroy` alone.
11
- */
12
- import { type TaskSpec, type TaskStream } from "../types.js";
1
+ import { type TaskStream } from "../types.js";
13
2
  import type { LiveHandle, RunnerDepsSeat, TaskStreamLiveSeat } from "./contracts.js";
14
3
  export interface StreamHaltVerbsInput {
15
- /** borrowed-readonly — the task spec (`taskId` on the notices' detail). */
16
- spec: TaskSpec;
17
4
  /** borrowed-readonly — the stream's live state: `resultValue` (the finished-task refusal, the liveness tests) and `handle`. */
18
5
  live: TaskStreamLiveSeat;
19
6
  /** borrowed-readonly — the readiness promise; halt and destroy resolve the handle through it while the run body has not published one. */
@@ -1,6 +1,7 @@
1
+ import { legNoticeTaskId } from "../mods/stations.js";
1
2
  import { deliverEngineNotice } from "../types.js";
2
3
  export function streamHaltVerbs(input) {
3
- const { spec, live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, run, reapSuspended, runner } = input;
4
+ const { live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, run, reapSuspended, runner } = input;
4
5
  let destroyOnce;
5
6
  const halt = async () => {
6
7
  const haltRefused = (msg) => {
@@ -28,7 +29,7 @@ export function streamHaltVerbs(input) {
28
29
  detail: {
29
30
  sessionId: h.sessionId,
30
31
  runId: h.runId,
31
- ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}),
32
+ ...legNoticeTaskId(h.hookIdentity),
32
33
  },
33
34
  });
34
35
  }
@@ -42,7 +43,7 @@ export function streamHaltVerbs(input) {
42
43
  cause: "user_halt",
43
44
  sessionId: h.sessionId,
44
45
  runId: h.runId,
45
- ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}),
46
+ ...legNoticeTaskId(h.hookIdentity),
46
47
  },
47
48
  });
48
49
  }
@@ -1,23 +1,24 @@
1
1
  /**
2
2
  * The TaskStream façade's REAP lane (T4), verbatim from `Runner.runTaskStream`: `destroy()`'s
3
3
  * once-memoized work for a run that SUSPENDED. Runs AFTER `run` has settled (the destroy verb awaits the run before
4
- * calling it), fences any concurrent resume first (the single-shot `expire` CAS — only the winner destroys the
5
- * paused env; a loser retires its reap record only when no same-Runner claimant is in flight), evicts the
6
- * terminally expired token's parked-constraint entry, and destroys the paused env best-effort behind a
7
- * swallow-guarded onError sink so the memoized `destroy()` promise keeps its "never throws" contract.
4
+ * calling it), fences any concurrent resume first (the single-shot `expire` CAS), and once the row is expired —
5
+ * by this CAS or by any other settler — runs the expired-row duty: evicts the token's parked-constraint entry and
6
+ * destroys the paused env (bounded, best-effort) behind a swallow-guarded onError sink, so the memoized `destroy()`
7
+ * promise keeps its "never throws" contract.
8
8
  *
9
9
  * The lane returns the same async function the one-file façade declared; the destroy verb still calls it in the
10
10
  * same position (after its own `await orTimeout(run.catch(…))`), so every await inside it sits on the tick it did.
11
11
  */
12
12
  import type { CheckpointToken } from "../checkpoint-store.js";
13
13
  import type { InheritedGate, RunnerDepsSeat, SuspendReap, TaskStreamLiveSeat } from "./contracts.js";
14
+ import type { LocalClaims } from "./local-claims.js";
14
15
  export interface StreamReapInput {
15
16
  /** borrowed-readonly — the stream's live state; `reapHandle` is read ONCE at the call (the run has settled, so it is the terminal fact). */
16
17
  live: TaskStreamLiveSeat;
17
18
  /** borrowed-readonly — the Runner's deployment deps, read LIVE (`onError`, after the fence's await too). */
18
19
  runner: RunnerDepsSeat;
19
- /** borrowed-readonly — the Runner's same-Runner claim marks: a lost fence preserves the reap record only while one is in flight. */
20
- locallyClaimedTokens: Set<CheckpointToken>;
20
+ /** borrowed-readonly — the Runner's same-Runner claims: a lost fence preserves the reap record only while one is open. */
21
+ locallyClaimedTokens: LocalClaims;
21
22
  /** borrowed-mutable — the Runner's parked-constraint registry: the expired token's entry is evicted. */
22
23
  parentConstraintRegistry: Map<CheckpointToken, NonNullable<InheritedGate["parentConstraints"]>>;
23
24
  /** borrowed-mutable — the Runner's suspended-env reap handles: the winner (and an unclaimed loser) retires this token's record. */
@@ -1,4 +1,4 @@
1
- import { hasDestroy } from "../remote-env.js";
1
+ import { runExpiredDuty, settleLostRow } from "./expire-settle.js";
2
2
  export function streamReap(input) {
3
3
  const { live, runner, locallyClaimedTokens, parentConstraintRegistry, suspendedEnvReaps } = input;
4
4
  const reapSuspended = async () => {
@@ -20,21 +20,18 @@ export function streamReap(input) {
20
20
  reportErr(err);
21
21
  return;
22
22
  }
23
- if (!won) {
24
- if (!locallyClaimedTokens.has(rh.token))
25
- suspendedEnvReaps.delete(rh.token);
26
- return;
27
- }
28
- parentConstraintRegistry.delete(rh.token);
29
- suspendedEnvReaps.delete(rh.token);
30
- if (rh.env && hasDestroy(rh.env)) {
31
- try {
32
- await rh.env.destroy();
33
- }
34
- catch (err) {
35
- reportErr(err);
36
- }
37
- }
23
+ const duty = {
24
+ token: rh.token, store: rh.store, parentConstraintRegistry, suspendedEnvReaps,
25
+ destroyLabel: "suspended stream env destroy",
26
+ onDestroyError: (err) => reportErr(err),
27
+ };
28
+ if (won)
29
+ return runExpiredDuty(duty);
30
+ const claimed = locallyClaimedTokens.held(rh.token);
31
+ const seen = await settleLostRow(duty);
32
+ const settledAway = seen === "resolved" || seen === "absent";
33
+ if (settledAway && !claimed && !locallyClaimedTokens.held(rh.token))
34
+ suspendedEnvReaps.delete(rh.token);
38
35
  };
39
36
  return { reapSuspended };
40
37
  }
@@ -3,6 +3,7 @@ import type { PushQueue } from "../push-queue.js";
3
3
  import type { SessionStore } from "../session.js";
4
4
  import { type TaskEvent, type TaskSpec } from "../types.js";
5
5
  import type { InheritedGate, ResumeRun, RunnerDepsSeat, SuspendReap, TaskIdRef, TaskStreamLiveSeat } from "./contracts.js";
6
+ import type { LocalClaims } from "./local-claims.js";
6
7
  export interface StreamSettleBackstopInput {
7
8
  /** borrowed-readonly — the task spec (read for the subagent-forwarding predicate the terminal push drains under). */
8
9
  spec: TaskSpec;
@@ -24,8 +25,8 @@ export interface StreamSettleBackstopInput {
24
25
  runner: RunnerDepsSeat;
25
26
  /** borrowed-readonly — the Runner's session store (the terminal resume-failure arm's `unpin`). */
26
27
  sessions: SessionStore;
27
- /** borrowed-mutable — the Runner's same-Runner claim marks: every failure leg releases the resume token's claim. */
28
- locallyClaimedTokens: Set<CheckpointToken>;
28
+ /** borrowed-mutable — the Runner's same-Runner claims: a failure leg closes the resume attempt's own claim (unless the minted result's exit already did). */
29
+ locallyClaimedTokens: LocalClaims;
29
30
  /** borrowed-mutable — the Runner's parked-constraint registry: the reopen-failure and terminal-failure arms evict the consumed resume token's entry. */
30
31
  parentConstraintRegistry: Map<CheckpointToken, NonNullable<InheritedGate["parentConstraints"]>>;
31
32
  /** borrowed-mutable — the Runner's suspended-env reap handles: the terminal resume-failure arm takes and destroys this token's. */
@@ -16,8 +16,10 @@ export function streamSettleBackstop(input) {
16
16
  const reopenable = resume !== undefined && live.resultValue === undefined && resume.pendingActionStarted !== true && !(resumeDecisionWasNegative(resume) && resume.decisionDelivered === true);
17
17
  let reopenCommitted = false;
18
18
  let reopenStateUnknown = false;
19
+ let unstartedRow;
19
20
  if (reopenable && resume !== undefined) {
20
21
  const row = await compensateUnstarted(resume.reopenUnstarted, reopenReason);
22
+ unstartedRow = row.kind;
21
23
  if (row.kind === "reopened") {
22
24
  reopenCommitted = true;
23
25
  message = `${message} — ${unstartedRowSentence(row)}`;
@@ -33,8 +35,8 @@ export function streamSettleBackstop(input) {
33
35
  detail = replacement.detail;
34
36
  }
35
37
  }
36
- if (resume)
37
- locallyClaimedTokens.delete(resume.cp.token);
38
+ if (resume && live.resultValue === undefined)
39
+ locallyClaimedTokens.close(resume.cp.token);
38
40
  if (resume && !reopenCommitted && live.resultValue === undefined) {
39
41
  parentConstraintRegistry.delete(resume.cp.token);
40
42
  await settleTeardownLeg(() => sessions.unpin?.(resume.cp.sessionId), "sessions.unpin (resume-failure leg)", (e) => runner.deps.onError?.(e, { phase: "config", sessionId: resume.cp.sessionId }));
@@ -70,7 +72,7 @@ export function streamSettleBackstop(input) {
70
72
  taskId: taskIdRef.current ?? "unknown",
71
73
  sessionId: taskIdRef.sessionId ?? "unknown",
72
74
  ...(taskIdRef.runId !== undefined ? { runId: taskIdRef.runId } : {}),
73
- terminal: { kind: "failed", ...(code !== undefined ? { code } : {}), message, ...(detail !== undefined ? { detail } : {}) },
75
+ terminal: { kind: "failed", ...(code !== undefined ? { code } : {}), message, ...(detail !== undefined ? { detail } : {}), ...(unstartedRow !== undefined ? { unstartedRow } : {}) },
74
76
  result: "", resultEntryIds: [],
75
77
  ...(remoteEnvFailure !== undefined ? { remoteEnvFailures: remoteEnvFailure } : {}),
76
78
  ...(taskIdRef.effectiveMemoryScopes !== undefined ? { effectiveMemoryScopes: taskIdRef.effectiveMemoryScopes } : {}),
@@ -1,9 +1,10 @@
1
+ import { type AuthoredSteer } from "../input-author.js";
1
2
  import type { PushQueue } from "../push-queue.js";
2
3
  import { type TaskEvent, type TaskSpec, type TaskStream } from "../types.js";
3
4
  import type { LiveHandle, RunInternals, RunnerDepsSeat, TaskStreamLiveSeat } from "./contracts.js";
4
5
  import { type SteerReplayRecord, type SteerReplayRefusalDetail } from "../steer-replay.js";
5
6
  export interface StreamSteerVerbInput {
6
- /** borrowed-readonly — the task spec (`principal`, `taskId`). */
7
+ /** borrowed-readonly — the task spec (`principal`). */
7
8
  spec: TaskSpec;
8
9
  /** borrowed-readonly — the trusted run-internals channel (the spawning tool id the ledger frame carries). */
9
10
  internals: RunInternals | undefined;
@@ -25,7 +26,9 @@ export interface StreamSteerVerbInput {
25
26
  runner: RunnerDepsSeat;
26
27
  }
27
28
  export interface StreamSteerVerbResult {
28
- /** The stream's `steer` verb. */
29
+ /** The stream's `steer` verb: every input it takes is the operator's. */
29
30
  steer: TaskStream["steer"];
31
+ /** The same verb under an author the engine states (an observer's report) — registered on the stream object, never on the package face. */
32
+ authoredSteer: AuthoredSteer;
30
33
  }
31
34
  export declare function streamSteerVerb(input: StreamSteerVerbInput): StreamSteerVerbResult;