@sema-agent/core 7.60.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 (482) hide show
  1. package/CHANGELOG.md +605 -0
  2. package/README.md +2 -2
  3. package/dist/agents/agent-transcript-tool.d.ts +2 -2
  4. package/dist/agents/agent-transcript-tool.js +1 -1
  5. package/dist/agents/cascade.d.ts +61 -10
  6. package/dist/agents/cascade.js +60 -20
  7. package/dist/agents/composition-allowance.d.ts +53 -0
  8. package/dist/agents/composition-allowance.js +49 -0
  9. package/dist/agents/composition-placement.d.ts +29 -0
  10. package/dist/agents/composition-placement.js +24 -0
  11. package/dist/agents/cumulative-stats.d.ts +4 -0
  12. package/dist/agents/cumulative-stats.js +3 -0
  13. package/dist/agents/inherited-tool-pool.d.ts +5 -3
  14. package/dist/agents/inherited-tool-pool.js +2 -2
  15. package/dist/agents/list-agents-tool.d.ts +1 -1
  16. package/dist/agents/peer-notice-route.d.ts +1 -1
  17. package/dist/agents/peer-notice-route.js +4 -3
  18. package/dist/agents/peer-notices.d.ts +4 -4
  19. package/dist/agents/peer-notices.js +8 -4
  20. package/dist/agents/peer-session-drain.d.ts +8 -1
  21. package/dist/agents/peer-session-drain.js +36 -7
  22. package/dist/agents/repair-loop.js +16 -6
  23. package/dist/agents/retain-ledger.js +3 -1
  24. package/dist/agents/roster-store.d.ts +1 -1
  25. package/dist/agents/roster-store.js +7 -4
  26. package/dist/agents/send-message-tool.d.ts +8 -10
  27. package/dist/agents/send-message-tool.js +43 -23
  28. package/dist/agents/subagent-completion-gate.d.ts +35 -0
  29. package/dist/agents/subagent-completion-gate.js +62 -0
  30. package/dist/agents/subagent-steps.d.ts +7 -6
  31. package/dist/agents/subagent.d.ts +30 -40
  32. package/dist/agents/subagent.js +187 -196
  33. package/dist/agents/suspend-guard.d.ts +9 -0
  34. package/dist/agents/suspend-guard.js +4 -0
  35. package/dist/agents/verify.d.ts +41 -14
  36. package/dist/agents/verify.js +37 -27
  37. package/dist/brain/anthropic.js +1 -0
  38. package/dist/brain/errors.d.ts +7 -1
  39. package/dist/brain/errors.js +6 -0
  40. package/dist/brain/failover.js +2 -1
  41. package/dist/brain/open-responses.js +1 -0
  42. package/dist/brain/openai.js +1 -0
  43. package/dist/brain/provider-dialect.d.ts +10 -0
  44. package/dist/brain/provider-dialect.js +13 -2
  45. package/dist/brain/stream-engine.d.ts +3 -0
  46. package/dist/brain/stream-engine.js +4 -0
  47. package/dist/core/agent-state.d.ts +1 -1
  48. package/dist/core/allow-entry.d.ts +59 -23
  49. package/dist/core/allow-entry.js +131 -38
  50. package/dist/core/ask-origin.d.ts +79 -0
  51. package/dist/core/ask-origin.js +76 -0
  52. package/dist/core/ask-question.d.ts +19 -13
  53. package/dist/core/ask-question.js +8 -2
  54. package/dist/core/auto-compaction.d.ts +2 -0
  55. package/dist/core/auto-compaction.js +2 -1
  56. package/dist/core/auto-mode.js +3 -5
  57. package/dist/core/background-agent-store.d.ts +7 -5
  58. package/dist/core/background-agent-store.js +12 -11
  59. package/dist/core/checkpoint-requirements.d.ts +24 -3
  60. package/dist/core/checkpoint-requirements.js +9 -1
  61. package/dist/core/checkpoint-store.d.ts +78 -19
  62. package/dist/core/checkpoint-store.js +8 -4
  63. package/dist/core/child-clamp-seats.d.ts +3 -2
  64. package/dist/core/child-clamp-seats.js +4 -3
  65. package/dist/core/closest-name.d.ts +13 -0
  66. package/dist/core/closest-name.js +35 -0
  67. package/dist/core/context-settings.js +3 -5
  68. package/dist/core/cross-boundary-taint.d.ts +1 -1
  69. package/dist/core/decision-receipt.d.ts +14 -1
  70. package/dist/core/decision-receipt.js +6 -3
  71. package/dist/core/delegation-frames.d.ts +13 -9
  72. package/dist/core/effective-path-target.js +2 -3
  73. package/dist/core/engine-attestation.d.ts +11 -1
  74. package/dist/core/engine-attestation.js +2 -0
  75. package/dist/core/engine-notice.d.ts +49 -18
  76. package/dist/core/file-history-retention.d.ts +8 -0
  77. package/dist/core/file-history-retention.js +14 -11
  78. package/dist/core/file-history-store.d.ts +31 -1
  79. package/dist/core/file-history-store.js +31 -2
  80. package/dist/core/frame-settlement.d.ts +10 -0
  81. package/dist/core/frame-settlement.js +6 -1
  82. package/dist/core/fs-write-gate-policy.d.ts +3 -3
  83. package/dist/core/fs-write-gate-policy.js +8 -7
  84. package/dist/core/gate-fold.js +2 -1
  85. package/dist/core/gate-lanes.js +7 -4
  86. package/dist/core/gate-outcome.d.ts +40 -1
  87. package/dist/core/gate-outcome.js +10 -0
  88. package/dist/core/git-worktree-env.d.ts +7 -3
  89. package/dist/core/git-worktree-env.js +16 -13
  90. package/dist/core/governance-codes.d.ts +12 -4
  91. package/dist/core/governance-codes.js +16 -4
  92. package/dist/core/hooks.d.ts +12 -4
  93. package/dist/core/hooks.js +11 -4
  94. package/dist/core/host-floor.js +3 -5
  95. package/dist/core/image-admission.d.ts +48 -8
  96. package/dist/core/image-admission.js +35 -4
  97. package/dist/core/input-author.d.ts +36 -0
  98. package/dist/core/input-author.js +39 -0
  99. package/dist/core/leg-identity.d.ts +62 -0
  100. package/dist/core/leg-identity.js +18 -0
  101. package/dist/core/locked-config.d.ts +2 -1
  102. package/dist/core/locked-config.js +5 -3
  103. package/dist/core/lsp.d.ts +5 -3
  104. package/dist/core/lsp.js +3 -2
  105. package/dist/core/mailbox-store.d.ts +85 -10
  106. package/dist/core/mailbox-store.js +31 -10
  107. package/dist/core/mcp-connection-pool.d.ts +6 -20
  108. package/dist/core/mcp-connection-pool.js +10 -28
  109. package/dist/core/mcp-failure.d.ts +76 -15
  110. package/dist/core/mcp-failure.js +60 -33
  111. package/dist/core/mcp-host-seat.d.ts +92 -53
  112. package/dist/core/mcp-host-seat.js +220 -46
  113. package/dist/core/mcp-probe.js +2 -2
  114. package/dist/core/mcp-server-link.d.ts +18 -6
  115. package/dist/core/mcp-server-link.js +19 -4
  116. package/dist/core/mcp-server-spec.d.ts +2 -1
  117. package/dist/core/mcp-session-end.d.ts +1 -2
  118. package/dist/core/mcp-session-end.js +1 -1
  119. package/dist/core/mcp.d.ts +6 -49
  120. package/dist/core/mcp.js +115 -111
  121. package/dist/core/media-byte-cap.d.ts +21 -46
  122. package/dist/core/media-byte-cap.js +55 -55
  123. package/dist/core/member-group.d.ts +7 -0
  124. package/dist/core/member-group.js +35 -0
  125. package/dist/core/memory-engine/consolidation.d.ts +1 -1
  126. package/dist/core/memory-engine/consolidation.js +7 -1
  127. package/dist/core/memory-engine/dual-root.d.ts +31 -0
  128. package/dist/core/memory-engine/dual-root.js +59 -11
  129. package/dist/core/memory-engine/engine.js +27 -24
  130. package/dist/core/memory-engine/file-backend.d.ts +13 -0
  131. package/dist/core/memory-engine/file-backend.js +35 -15
  132. package/dist/core/memory-engine/layout.d.ts +3 -0
  133. package/dist/core/memory-engine/layout.js +13 -3
  134. package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
  135. package/dist/core/memory-engine/memory-deployment.js +182 -0
  136. package/dist/core/memory-engine/sync-client.d.ts +39 -18
  137. package/dist/core/memory-engine/sync-client.js +72 -14
  138. package/dist/core/memory-engine/sync-report.d.ts +7 -4
  139. package/dist/core/memory-engine/sync.d.ts +9 -1
  140. package/dist/core/mode-policy.d.ts +8 -8
  141. package/dist/core/mode-policy.js +7 -5
  142. package/dist/core/mods/agent-stations.d.ts +39 -4
  143. package/dist/core/mods/agent-stations.js +59 -10
  144. package/dist/core/mods/dollar.d.ts +62 -0
  145. package/dist/core/mods/extension-call.d.ts +15 -1
  146. package/dist/core/mods/extension-call.js +7 -2
  147. package/dist/core/mods/kernel/dispatch.d.ts +4 -3
  148. package/dist/core/mods/kernel/dispatch.js +4 -4
  149. package/dist/core/mods/kernel/events.d.ts +4 -1
  150. package/dist/core/mods/kernel/events.js +6 -6
  151. package/dist/core/mods/kernel/registration.d.ts +3 -0
  152. package/dist/core/mods/kernel/registration.js +5 -0
  153. package/dist/core/mods/kernel/site-rules.d.ts +6 -3
  154. package/dist/core/mods/kernel/site-rules.js +10 -2
  155. package/dist/core/mods/session-append.d.ts +115 -0
  156. package/dist/core/mods/session-append.js +311 -0
  157. package/dist/core/mods/session-compact.d.ts +48 -0
  158. package/dist/core/mods/session-compact.js +194 -0
  159. package/dist/core/mods/session-receive.d.ts +93 -0
  160. package/dist/core/mods/session-receive.js +141 -0
  161. package/dist/core/mods/session-send.d.ts +72 -0
  162. package/dist/core/mods/session-send.js +88 -0
  163. package/dist/core/mods/stations.d.ts +38 -16
  164. package/dist/core/mods/stations.js +25 -11
  165. package/dist/core/mods/tool-call.d.ts +2 -0
  166. package/dist/core/mods/tool-call.js +4 -4
  167. package/dist/core/output-style.js +3 -4
  168. package/dist/core/own-property-receipt.d.ts +61 -2
  169. package/dist/core/own-property-receipt.js +42 -2
  170. package/dist/core/park-selfcheck.js +4 -2
  171. package/dist/core/path-identity.d.ts +11 -0
  172. package/dist/core/path-identity.js +4 -0
  173. package/dist/core/path-rule-binding.d.ts +3 -1
  174. package/dist/core/path-rule-binding.js +3 -1
  175. package/dist/core/peer-seat.d.ts +3 -3
  176. package/dist/core/peer-seat.js +20 -8
  177. package/dist/core/permission-rule-consent.d.ts +21 -5
  178. package/dist/core/permission-rule-consent.js +21 -1
  179. package/dist/core/permission-rule-model.d.ts +34 -11
  180. package/dist/core/permission-rule-model.js +47 -10
  181. package/dist/core/permission-rule-org.d.ts +1 -1
  182. package/dist/core/permission-rule-provider.js +4 -1
  183. package/dist/core/permission-rules.d.ts +4 -0
  184. package/dist/core/permission-rules.js +11 -16
  185. package/dist/core/remote-env.d.ts +74 -26
  186. package/dist/core/remote-env.js +20 -0
  187. package/dist/core/retention-policy.d.ts +24 -23
  188. package/dist/core/retention-policy.js +36 -2
  189. package/dist/core/retention.d.ts +4 -1
  190. package/dist/core/retired-keys.d.ts +4 -4
  191. package/dist/core/row-admission.d.ts +10 -0
  192. package/dist/core/row-admission.js +5 -0
  193. package/dist/core/runner/advisor-instructions.d.ts +2 -1
  194. package/dist/core/runner/advisor-instructions.js +2 -1
  195. package/dist/core/runner/announce-once-ledger.d.ts +4 -4
  196. package/dist/core/runner/assemble-result.d.ts +13 -3
  197. package/dist/core/runner/assemble-result.js +12 -7
  198. package/dist/core/runner/caller-roster.d.ts +12 -9
  199. package/dist/core/runner/caller-roster.js +5 -2
  200. package/dist/core/runner/checkpoint-scope.d.ts +16 -1
  201. package/dist/core/runner/checkpoint-scope.js +21 -0
  202. package/dist/core/runner/compact-session.js +14 -2
  203. package/dist/core/runner/compaction-call-options.d.ts +1 -1
  204. package/dist/core/runner/compaction-restate.d.ts +2 -2
  205. package/dist/core/runner/compaction-restate.js +4 -3
  206. package/dist/core/runner/construction-doors.d.ts +2 -2
  207. package/dist/core/runner/construction-doors.js +2 -2
  208. package/dist/core/runner/contracts.d.ts +98 -26
  209. package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
  210. package/dist/core/runner/decide-continuation.d.ts +4 -2
  211. package/dist/core/runner/decide-continuation.js +7 -4
  212. package/dist/core/runner/denial-limit-arms.d.ts +15 -21
  213. package/dist/core/runner/denial-limit-arms.js +17 -10
  214. package/dist/core/runner/expire-settle.d.ts +44 -0
  215. package/dist/core/runner/expire-settle.js +55 -0
  216. package/dist/core/runner/git-status-frame.d.ts +3 -3
  217. package/dist/core/runner/git-status-frame.js +2 -1
  218. package/dist/core/runner/halt-attribution.d.ts +2 -1
  219. package/dist/core/runner/halt-attribution.js +2 -1
  220. package/dist/core/runner/local-claims.d.ts +17 -0
  221. package/dist/core/runner/local-claims.js +18 -0
  222. package/dist/core/runner/media-removed-seat.d.ts +46 -0
  223. package/dist/core/runner/media-removed-seat.js +88 -0
  224. package/dist/core/runner/park-commit.d.ts +2 -2
  225. package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
  226. package/dist/core/runner/permission-rule-lanes.js +28 -9
  227. package/dist/core/runner/person-path-rows.js +1 -1
  228. package/dist/core/runner/placement-fence.d.ts +26 -0
  229. package/dist/core/runner/placement-fence.js +38 -0
  230. package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
  231. package/dist/core/runner/prepare-ask-lane.js +4 -4
  232. package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
  233. package/dist/core/runner/prepare-boundary-parks.js +2 -2
  234. package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
  235. package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
  236. package/dist/core/runner/prepare-config-doors.js +16 -17
  237. package/dist/core/runner/prepare-context-lane.d.ts +6 -2
  238. package/dist/core/runner/prepare-context-lane.js +13 -13
  239. package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
  240. package/dist/core/runner/prepare-delegation-surface.js +4 -5
  241. package/dist/core/runner/prepare-execution-env.d.ts +5 -2
  242. package/dist/core/runner/prepare-execution-env.js +7 -4
  243. package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
  244. package/dist/core/runner/prepare-gate-stations.js +6 -4
  245. package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
  246. package/dist/core/runner/prepare-hands-readface.js +4 -4
  247. package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
  248. package/dist/core/runner/prepare-inherited-gate.js +3 -0
  249. package/dist/core/runner/prepare-lsp.d.ts +3 -0
  250. package/dist/core/runner/prepare-lsp.js +2 -2
  251. package/dist/core/runner/prepare-park-ask.d.ts +5 -2
  252. package/dist/core/runner/prepare-park-ask.js +4 -5
  253. package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
  254. package/dist/core/runner/prepare-policy-chain.js +16 -25
  255. package/dist/core/runner/prepare-project-context.d.ts +2 -2
  256. package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
  257. package/dist/core/runner/prepare-prompt-inputs.js +3 -2
  258. package/dist/core/runner/prepare-question-face.d.ts +6 -4
  259. package/dist/core/runner/prepare-question-face.js +2 -2
  260. package/dist/core/runner/prepare-run-refs.d.ts +3 -0
  261. package/dist/core/runner/prepare-run-refs.js +2 -2
  262. package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
  263. package/dist/core/runner/prepare-suspend-saga.js +17 -7
  264. package/dist/core/runner/prepare-task.d.ts +1 -1
  265. package/dist/core/runner/prepare-task.js +56 -28
  266. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
  267. package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
  268. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
  269. package/dist/core/runner/prepare-wiring-manifest.js +2 -1
  270. package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
  271. package/dist/core/runner/prepare-workspace-restore.js +10 -6
  272. package/dist/core/runner/read-root-grant.d.ts +1 -1
  273. package/dist/core/runner/read-root-grant.js +2 -1
  274. package/dist/core/runner/resume-admission.d.ts +5 -3
  275. package/dist/core/runner/resume-admission.js +17 -3
  276. package/dist/core/runner/resume-apply.js +3 -1
  277. package/dist/core/runner/resume-claim.d.ts +8 -3
  278. package/dist/core/runner/resume-claim.js +28 -12
  279. package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
  280. package/dist/core/runner/resume-internals-and-config.js +10 -1
  281. package/dist/core/runner/resume-preflight.d.ts +3 -2
  282. package/dist/core/runner/resume-preflight.js +13 -26
  283. package/dist/core/runner/retired-runner-deps.js +2 -0
  284. package/dist/core/runner/run-git-lane.js +2 -1
  285. package/dist/core/runner/run-harness-handlers.js +2 -2
  286. package/dist/core/runner/run-identity-wiring.d.ts +2 -2
  287. package/dist/core/runner/run-identity-wiring.js +14 -5
  288. package/dist/core/runner/run-leg.d.ts +3 -3
  289. package/dist/core/runner/run-leg.js +40 -29
  290. package/dist/core/runner/run-notification-lane.js +20 -2
  291. package/dist/core/runner/run-recovery-lanes.js +3 -2
  292. package/dist/core/runner/run-settle-and-teardown.js +9 -7
  293. package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
  294. package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
  295. package/dist/core/runner/run-terminal-adoption.js +26 -17
  296. package/dist/core/runner/run-turn-boundary.js +27 -14
  297. package/dist/core/runner/runtask.d.ts +18 -3
  298. package/dist/core/runner/runtask.js +27 -11
  299. package/dist/core/runner/session-rule-policy.d.ts +1 -1
  300. package/dist/core/runner/session-rule-policy.js +6 -1
  301. package/dist/core/runner/shell-env-withheld.d.ts +1 -1
  302. package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
  303. package/dist/core/runner/stream-halt-verbs.js +4 -3
  304. package/dist/core/runner/stream-reap.d.ts +7 -6
  305. package/dist/core/runner/stream-reap.js +13 -16
  306. package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
  307. package/dist/core/runner/stream-settle-backstop.js +5 -3
  308. package/dist/core/runner/stream-steer-verb.d.ts +5 -2
  309. package/dist/core/runner/stream-steer-verb.js +8 -7
  310. package/dist/core/runner/terminal-account.d.ts +11 -1
  311. package/dist/core/runner/terminal-account.js +20 -0
  312. package/dist/core/runner/terminal-projection.d.ts +8 -2
  313. package/dist/core/runner/terminal-projection.js +2 -2
  314. package/dist/core/runner/tool-disclosure.d.ts +3 -0
  315. package/dist/core/runner/tool-disclosure.js +5 -2
  316. package/dist/core/runner/tool-end-body.d.ts +3 -3
  317. package/dist/core/runner/tool-end-body.js +1 -1
  318. package/dist/core/runner/tool-output-projection.d.ts +3 -3
  319. package/dist/core/runner/tool-output-projection.js +7 -6
  320. package/dist/core/runner/tool-table-view.d.ts +56 -0
  321. package/dist/core/runner/tool-table-view.js +51 -0
  322. package/dist/core/runner/turn-attachments.d.ts +3 -2
  323. package/dist/core/runner/turn-attachments.js +1 -1
  324. package/dist/core/runner/void-verifier-pause.d.ts +33 -0
  325. package/dist/core/runner/void-verifier-pause.js +41 -0
  326. package/dist/core/runner-deps.d.ts +24 -25
  327. package/dist/core/secret-env.d.ts +11 -11
  328. package/dist/core/secret-env.js +8 -9
  329. package/dist/core/session-log-transfer.js +9 -10
  330. package/dist/core/session-policy-store.d.ts +1 -1
  331. package/dist/core/session-policy-store.js +5 -2
  332. package/dist/core/session-reconcile.d.ts +3 -2
  333. package/dist/core/session-reconcile.js +7 -4
  334. package/dist/core/session-store.d.ts +2 -0
  335. package/dist/core/session-store.js +5 -7
  336. package/dist/core/session.d.ts +2 -1
  337. package/dist/core/shell-confinement.d.ts +37 -0
  338. package/dist/core/shell-confinement.js +56 -0
  339. package/dist/core/skill-grant.js +1 -1
  340. package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
  341. package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
  342. package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
  343. package/dist/core/store-contracts/file-history-store-contract.js +25 -1
  344. package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
  345. package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
  346. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  347. package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
  348. package/dist/core/task-event.d.ts +17 -8
  349. package/dist/core/task-limits.d.ts +5 -0
  350. package/dist/core/task-notification.d.ts +89 -12
  351. package/dist/core/task-notification.js +87 -13
  352. package/dist/core/task-registry-agent.d.ts +5 -43
  353. package/dist/core/task-registry-agent.js +24 -51
  354. package/dist/core/task-registry-monitor.d.ts +1 -1
  355. package/dist/core/task-registry-monitor.js +15 -60
  356. package/dist/core/task-registry-shared.d.ts +15 -112
  357. package/dist/core/task-registry-shared.js +3 -41
  358. package/dist/core/task-registry-workflow.js +4 -21
  359. package/dist/core/task-registry.d.ts +19 -60
  360. package/dist/core/task-registry.js +19 -106
  361. package/dist/core/task-result.d.ts +24 -7
  362. package/dist/core/task-spec-members.d.ts +39 -0
  363. package/dist/core/task-spec-members.js +92 -0
  364. package/dist/core/task-spec.d.ts +10 -10
  365. package/dist/core/task-tool-shape.d.ts +7 -57
  366. package/dist/core/task-tool-shape.js +7 -66
  367. package/dist/core/terminal-cause.d.ts +30 -0
  368. package/dist/core/terminal-cause.js +1 -0
  369. package/dist/core/tool-catalog-entries.js +2 -5
  370. package/dist/core/tool-check-reading.js +16 -10
  371. package/dist/core/tool-conformance.js +1 -2
  372. package/dist/core/tool-errors.d.ts +6 -3
  373. package/dist/core/tool-errors.js +2 -0
  374. package/dist/core/tool-face-reader.js +3 -2
  375. package/dist/core/tool-face.d.ts +2 -3
  376. package/dist/core/tool-name-aliases.d.ts +5 -29
  377. package/dist/core/tool-name-aliases.js +9 -5
  378. package/dist/core/tool-name-readings.d.ts +14 -3
  379. package/dist/core/tool-name-readings.js +2 -0
  380. package/dist/core/tool-policy.d.ts +108 -18
  381. package/dist/core/tool-policy.js +84 -14
  382. package/dist/core/tool-result-store.d.ts +23 -0
  383. package/dist/core/tool-result-store.js +3 -2
  384. package/dist/core/tool-spec.d.ts +19 -6
  385. package/dist/core/trace.d.ts +18 -1
  386. package/dist/core/user-attachment.js +26 -21
  387. package/dist/core/workflow-journal-store.d.ts +1 -1
  388. package/dist/core/workflow-run-store.d.ts +2 -0
  389. package/dist/core/workflow-run-store.js +6 -5
  390. package/dist/core/workflow-settled-run.d.ts +5 -0
  391. package/dist/core/workflow-settled-run.js +7 -0
  392. package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
  393. package/dist/engine/execution-env/node-execution-env.js +213 -21
  394. package/dist/engine/harness/agent-harness.d.ts +65 -18
  395. package/dist/engine/harness/agent-harness.js +90 -23
  396. package/dist/engine/harness/messages.d.ts +4 -3
  397. package/dist/engine/harness/messages.js +2 -2
  398. package/dist/engine/harness/types.d.ts +41 -7
  399. package/dist/engine/llm/media-removed.d.ts +14 -0
  400. package/dist/engine/llm/media-removed.js +9 -0
  401. package/dist/engine/llm/rejected-images.d.ts +35 -25
  402. package/dist/engine/llm/rejected-images.js +59 -10
  403. package/dist/engine/llm/types.d.ts +24 -3
  404. package/dist/engine/llm/types.js +7 -3
  405. package/dist/engine/loop/agent-loop.d.ts +6 -1
  406. package/dist/engine/loop/agent-loop.js +20 -11
  407. package/dist/engine/loop/types.d.ts +12 -3
  408. package/dist/engine/session/import-validate.js +7 -0
  409. package/dist/fixtures/index.d.ts +7 -5
  410. package/dist/fixtures/index.js +5 -3
  411. package/dist/index.d.ts +21 -11
  412. package/dist/index.js +15 -7
  413. package/dist/internal/harness-types.d.ts +2 -0
  414. package/dist/internal/llm.d.ts +2 -1
  415. package/dist/internal/llm.js +1 -0
  416. package/dist/orchestration/goal.d.ts +6 -2
  417. package/dist/orchestration/goal.js +6 -3
  418. package/dist/orchestration/run-workflow-tool.d.ts +11 -17
  419. package/dist/orchestration/run-workflow-tool.js +19 -42
  420. package/dist/orchestration/workflow-governance.d.ts +1 -1
  421. package/dist/orchestration/workflow-types.d.ts +2 -2
  422. package/dist/orchestration/workflow.d.ts +4 -0
  423. package/dist/orchestration/workflow.js +8 -5
  424. package/dist/stores/file/background-agent-store.js +18 -15
  425. package/dist/stores/file/checkpoint-store.js +7 -4
  426. package/dist/stores/file/file-history-store.js +3 -2
  427. package/dist/stores/file/index.d.ts +5 -3
  428. package/dist/stores/file/index.js +23 -8
  429. package/dist/stores/file/ledger-tuning.d.ts +23 -0
  430. package/dist/stores/file/ledger-tuning.js +21 -0
  431. package/dist/stores/file/mailbox-store.js +42 -22
  432. package/dist/stores/file/memory-store.js +3 -2
  433. package/dist/stores/file/permission-rule-adopt.js +24 -21
  434. package/dist/stores/file/permission-rule-store.js +6 -3
  435. package/dist/stores/file/session-policy-store.js +3 -2
  436. package/dist/stores/file/session-store.d.ts +16 -3
  437. package/dist/stores/file/session-store.js +21 -20
  438. package/dist/stores/file/tool-result-store.d.ts +11 -0
  439. package/dist/stores/file/tool-result-store.js +57 -3
  440. package/dist/stores/file/usage-window-store.js +3 -2
  441. package/dist/stores/file/workflow-journal-store.d.ts +0 -2
  442. package/dist/stores/file/workflow-journal-store.js +3 -18
  443. package/dist/stores/file/workflow-run-store.d.ts +1 -1
  444. package/dist/stores/file/workflow-run-store.js +15 -10
  445. package/dist/tools/fs/dead-cwd.d.ts +5 -5
  446. package/dist/tools/fs/dead-cwd.js +4 -11
  447. package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
  448. package/dist/tools/fs/fs-bash-background-text.js +6 -0
  449. package/dist/tools/fs/fs-bash.d.ts +3 -18
  450. package/dist/tools/fs/fs-bash.js +37 -124
  451. package/dist/tools/fs/fs-pdf.js +8 -6
  452. package/dist/tools/fs/fs-read.js +2 -2
  453. package/dist/tools/fs/fs-shared.d.ts +28 -3
  454. package/dist/tools/fs/fs-shared.js +15 -0
  455. package/dist/tools/fs/index.d.ts +1 -1
  456. package/dist/tools/fs/index.js +4 -14
  457. package/dist/tools/fs/pdf.d.ts +4 -4
  458. package/dist/tools/fs/pdf.js +6 -6
  459. package/dist/tools/fs/read-deny-home.js +8 -1
  460. package/dist/tools/fs/read-deny.d.ts +26 -2
  461. package/dist/tools/fs/read-deny.js +9 -2
  462. package/dist/tools/fs/read-floor.d.ts +13 -5
  463. package/dist/tools/fs/read-floor.js +206 -2
  464. package/dist/tools/fs/search.d.ts +3 -2
  465. package/dist/tools/fs/search.js +6 -6
  466. package/dist/tools/fs/shell-read-establish.js +3 -1
  467. package/dist/tools/fs/shell-read-identity.d.ts +3 -1
  468. package/dist/tools/fs/shell-read-identity.js +4 -2
  469. package/dist/tools/fs/shell-read-judge.d.ts +7 -1
  470. package/dist/tools/fs/shell-read-judge.js +1 -1
  471. package/dist/tools/monitor.d.ts +8 -7
  472. package/dist/tools/monitor.js +12 -10
  473. package/dist/tools/worktree.d.ts +5 -1
  474. package/dist/tools/worktree.js +20 -17
  475. package/package.json +6 -3
  476. package/test/export-surface.snapshot.json +92 -10
  477. package/wire-changes/core-stores-sql@7.61.0.json +480 -0
  478. package/wire-changes/core@7.61.0.json +4405 -0
  479. package/wire-changes/mods-kernel@7.61.0.json +65 -0
  480. package/wire-changes/primitives@7.61.0.json +30 -0
  481. package/dist/core/runner/image-removed-seat.d.ts +0 -12
  482. package/dist/core/runner/image-removed-seat.js +0 -19
@@ -7,13 +7,14 @@ import { redactThenCut } from "../../agents/subagent-steps.js";
7
7
  import { ATTACHMENT_BYTE_CAP, CHANGED_FILES_MAX, TOTAL_TOKENS_REMINDER_DEFAULT_MODE, attachmentEnvelopeTags, clipToBytes, collectDateChange, collectDueAttachments, collectInstructionsChange, commitAgentListing, commitInstructionsChange, commitSkillsListing, isIntactSource, rebaseCadenceWindows, renderAgentListingFrame, renderMcpInstructionsDelta, selectMcpDroppedBatch, renderSkillsListingFrame } from "./turn-attachments.js";
8
8
  import { announceListingTruncation } from "../skill-listing-budget.js";
9
9
  import { buildWorkingFileAttachments, centerAdoptionOption, contextInstructionFilesOption, emitInputTruncated, forkContextOption, legCompactionSettings, legContextOverlayOption } from "./compaction-call-options.js";
10
- import { classicEventBase, dispatchClassic, stringMembersAnswer, stringMembersOf } from "../mods/stations.js";
10
+ import { classicEventBase, dispatchClassic, seatHears, stringMembersAnswer, stringMembersOf } from "../mods/stations.js";
11
11
  import { offeredAgentListing } from "../mods/agent-stations.js";
12
12
  import { raiseCompletedTurn } from "../mods/lifecycle-stations.js";
13
13
  import { sanitizeUntrustedText, SHELLED_BODY_ENVELOPE_TAGS } from "../untrusted-text.js";
14
14
  import { droppedToolDigest, withAnnounceDigests } from "./announce-once-ledger.js";
15
15
  import { formatDiagnosticsBlock, withholdListedDiagnostics } from "../lsp-diagnostics.js";
16
16
  import { workflowSizeGuidelineChangeNotice } from "../../orchestration/workflow-size-guideline.js";
17
+ import { requesterOf } from "../mods/session-compact.js";
17
18
  import { awaitChargeWithSlowDisclosure, discloseUnevaluableWindow, ENV_DUE_GOVERNANCE_READ_BUDGET_MS, GOVERNANCE_READ_STALLED, LIMIT_APPROACH_DEFAULT_THRESHOLDS, limitApproachFrames, platformLimitTerminal, raceUntilDeadline } from "./clock-and-limits.js";
18
19
  import { appendBoundaryFrames, compactionRestateOptions, frameCarried } from "./compaction-restate.js";
19
20
  import { COMPACTION_FREED_EPSILON, COMPACTION_REGROWTH_FACTOR, MAX_CONSECUTIVE_COMPACTION_FAILURES } from "./compaction-knobs.js";
@@ -36,7 +37,7 @@ export function createTurnBoundary(input) {
36
37
  let legContinues = true;
37
38
  const boundaryPass = async (event) => {
38
39
  if (rs.turn.completed !== undefined)
39
- await raiseCompletedTurn(prepared.modBus, rs.turn, prepared.hookIdentity, prepared.abortController.signal);
40
+ await prepared.compactStation.window((request) => compactInPlace(event.model, request), () => raiseCompletedTurn(prepared.modBus, rs.turn, prepared.hookIdentity, prepared.abortController.signal));
40
41
  const turnOwesRequest = event.continues;
41
42
  let boundarySteered = false;
42
43
  const noNextRequest = () => prepared.stopRequestedRef.current || deps.loopLatch.userHalted;
@@ -300,7 +301,7 @@ export function createTurnBoundary(input) {
300
301
  ? [...prepared.deferredToolNames].filter((n) => !prepared.activeTools.has(n)).sort()
301
302
  : undefined;
302
303
  const agentListingOwed = rs.attach.agentListingOn && prepared.agentListing !== undefined && !frameCarried(prepared.frameReceipts, "agent_listing");
303
- const offeredListing = !agentListingOwed ? undefined : prepared.modBus.hasHandlers("agent.offer") ? await offeredAgentListing(prepared.modBus, prepared.agentListing, prepared.abortController.signal) : prepared.agentListing;
304
+ const offeredListing = !agentListingOwed ? undefined : seatHears({ bus: prepared.modBus }, "agent.offer") ? await offeredAgentListing({ bus: prepared.modBus }, prepared.agentListing, prepared.abortController.signal) : prepared.agentListing;
304
305
  const skillsListingDue = rs.attach.skillsListingOn && prepared.skillsListing !== undefined && !frameCarried(prepared.frameReceipts, "skills_listing");
305
306
  const listingBudget = prepared.skillsListing?.budget ?? prepared.agentListing?.budget;
306
307
  due.push(...collectDueAttachments(rs.attach.attachState, {
@@ -503,6 +504,16 @@ export function createTurnBoundary(input) {
503
504
  prepared.frameReceipts.pending = prepared.frameReceipts.pending.filter((r) => r.text !== payload);
504
505
  });
505
506
  }
507
+ return await compactionPass(event.model);
508
+ };
509
+ const compactInPlace = async (model, request) => {
510
+ let outcome = "mooted";
511
+ manualCompactRef.waiters.push({ resolve: (o) => (outcome = o), ...(request.instructions !== undefined ? { instructions: request.instructions } : {}), requestedBy: request.requestedBy });
512
+ manualCompactRef.requested = true;
513
+ await compactionPass(model, request.call);
514
+ return outcome;
515
+ };
516
+ const compactionPass = async (model, call) => {
506
517
  const forceManual = manualCompactRef.requested;
507
518
  if ((!withinTaskCompaction() && !forceManual) ||
508
519
  prepared.abortController.signal.aborted ||
@@ -510,7 +521,7 @@ export function createTurnBoundary(input) {
510
521
  prepared.pausedRef.current !== undefined) {
511
522
  if (forceManual) {
512
523
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.mooted", version: 1, taskId: rs.telemetry.taskId, reason: "task_ending", ts: Date.now() }));
513
- queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: "manual", reason: "task_ending", ...ident() });
524
+ queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: "manual", reason: "task_ending", ...requesterOf(manualCompactRef.waiters), ...ident() });
514
525
  drainManualCompact("mooted");
515
526
  }
516
527
  legContinues = !prepared.abortController.signal.aborted && prepared.pausedRef.current === undefined;
@@ -526,7 +537,7 @@ export function createTurnBoundary(input) {
526
537
  reason: "compaction circuit breaker open (3 consecutive failures this task) — manual request drained without an attempt",
527
538
  ts: Date.now(),
528
539
  }));
529
- queue.push({ type: "compaction_outcome", outcome: "failed", trigger: "manual", reason: "compaction circuit breaker open (3 consecutive failures this task) — manual request drained without an attempt", ...ident() });
540
+ queue.push({ type: "compaction_outcome", outcome: "failed", trigger: "manual", reason: "compaction circuit breaker open (3 consecutive failures this task) — manual request drained without an attempt", ...requesterOf(manualCompactRef.waiters), ...ident() });
530
541
  drainManualCompact("failed");
531
542
  }
532
543
  return undefined;
@@ -547,6 +558,7 @@ export function createTurnBoundary(input) {
547
558
  if (forceManual) {
548
559
  manualCompactRef.requested = false;
549
560
  }
561
+ const requester = requesterOf(claimedManual?.waiters ?? []);
550
562
  const resolveClaimedWaiters = (outcome) => {
551
563
  if (claimedManual !== undefined)
552
564
  for (const w of claimedManual.waiters.splice(0))
@@ -564,11 +576,12 @@ export function createTurnBoundary(input) {
564
576
  const manualInstructions = claimedManual?.instructions;
565
577
  const passReport = compactionPassReport(queue, ident);
566
578
  try {
567
- const comp = await maybeCompact({
579
+ const comp = await prepared.compactStation.compact({
568
580
  session: prepared.session,
581
+ admitRows: prepared.admitRows,
569
582
  promptIdentity: prepared.promptIdentity,
570
583
  ...centerAdoptionOption(prepared),
571
- model: event.model,
584
+ model,
572
585
  ...legContextOverlayOption(prepared, runner),
573
586
  compactionModel: prepared.compModel,
574
587
  ...forkContextOption(prepared, false),
@@ -590,10 +603,10 @@ export function createTurnBoundary(input) {
590
603
  ...(prepared.onCompactionApplied ? { onApplied: prepared.onCompactionApplied } : {}),
591
604
  ...seamCCompactionOptions(runner, prepared),
592
605
  ...compactionRestateOptions(prepared),
593
- ...windowSafetyOptions(event.model),
606
+ ...windowSafetyOptions(model),
594
607
  ...compactionHookOptions(runner, prepared, passTrigger, compactionPassSignal),
595
608
  onStarted: passReport.onStarted,
596
- });
609
+ }, maybeCompact, { ...(manualInstructions !== undefined ? { instructions: manualInstructions } : {}), ...(call !== undefined ? { call } : {}) });
597
610
  if (comp.blocked) {
598
611
  emitTrace(rs.telemetry.tracer, () => ({
599
612
  kind: "compaction.blocked",
@@ -645,12 +658,12 @@ export function createTurnBoundary(input) {
645
658
  ? "noop"
646
659
  : undefined;
647
660
  if (outcome !== undefined) {
648
- queue.push({ type: "compaction_outcome", outcome, trigger: passTrigger, ...ident() });
661
+ queue.push({ type: "compaction_outcome", outcome, trigger: passTrigger, ...requester, ...ident() });
649
662
  }
650
663
  }
651
664
  recordCompactionReuse(runner, prepared, comp);
652
665
  if (comp.compacted) {
653
- queue.push(mintCompactedEvent(comp, passTrigger, ident()));
666
+ queue.push({ ...mintCompactedEvent(comp, passTrigger, ident()), ...requester });
654
667
  rs.counters.compactionPasses += 1;
655
668
  rs.counters.compactionKind = compactionKindOf(passTrigger);
656
669
  if (!forceManual && recordCompactionAndCheckRapidRefill(rapidRefill, stats.turns)) {
@@ -676,7 +689,7 @@ export function createTurnBoundary(input) {
676
689
  catch (err) {
677
690
  if (isCompactionManualCancel(err)) {
678
691
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.mooted", version: 1, taskId: rs.telemetry.taskId, reason: "cancelled", ts: Date.now() }));
679
- queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "cancelled", ...passReport.end, ...ident() });
692
+ queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "cancelled", ...passReport.end, ...requester, ...ident() });
680
693
  manualOutcome = "mooted";
681
694
  }
682
695
  else if (!prepared.abortController.signal.aborted) {
@@ -691,14 +704,14 @@ export function createTurnBoundary(input) {
691
704
  reason: failReason,
692
705
  ts: Date.now(),
693
706
  }));
694
- queue.push({ type: "compaction_outcome", outcome: "failed", trigger: passTrigger, reason: failReason, ...passReport.end, ...ident() });
707
+ queue.push({ type: "compaction_outcome", outcome: "failed", trigger: passTrigger, reason: failReason, ...passReport.end, ...requester, ...ident() });
695
708
  manualOutcome = "failed";
696
709
  }
697
710
  else {
698
711
  manualOutcome = "mooted";
699
712
  if (passReport.pass !== undefined) {
700
713
  emitTrace(rs.telemetry.tracer, () => ({ kind: "compaction.mooted", version: 1, taskId: rs.telemetry.taskId, reason: "task_ending", ts: Date.now() }));
701
- queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "task_ending", ...passReport.end, ...ident() });
714
+ queue.push({ type: "compaction_outcome", outcome: "mooted", trigger: passTrigger, reason: "task_ending", ...passReport.end, ...requester, ...ident() });
702
715
  }
703
716
  }
704
717
  }
@@ -56,9 +56,9 @@ export declare class Runner implements RunnerSelfSeat {
56
56
  * the ORIGINAL stream's closure as the reaping owner, deliberately), and when the terminal arm
57
57
  * wins. Bounded by live suspended streams (the closures hold the same handles). */
58
58
  private readonly suspendedEnvReaps;
59
- /** SAME-RUNNER claim marks for {@link suspendedEnvReaps}: a token appears
60
- * here from the moment an in-process actor ATTEMPTS its settling CAS (the terminal preflight's
61
- * 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
62
62
  * reap preserves a record ONLY while a local claim is in flight — a CROSS-Runner settlement
63
63
  * leaves no local claim, so the loser retires the record (drops the strong ref; physical cleanup
64
64
  * belongs to the winning owner, unprovable from here) instead of retaining env handles without
@@ -259,6 +259,21 @@ export declare class Runner implements RunnerSelfSeat {
259
259
  * authority, so constraint substitution here is outside the enforced threat model (the count check
260
260
  * catches shape MISTAKES, not a untrusted trusted caller). */
261
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>;
262
277
  /**
263
278
  * The resume decision ladder after admission (E3–E10), driving the eight `resume-*` lanes in
264
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";
@@ -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";
@@ -69,6 +74,7 @@ import { compactIdleSession } from "./compact-session.js";
69
74
  import { egressThrownText } from "../untrusted-egress.js";
70
75
  import { holdPeerDeclarations } from "../peer-seat.js";
71
76
  import { receivePeerDeclarations, receivedDeclarations } from "../locked-config.js";
77
+ import { readCallerSpec } from "../task-spec-members.js";
72
78
  export class Runner {
73
79
  deps;
74
80
  sessions;
@@ -80,7 +86,7 @@ export class Runner {
80
86
  pendingSessionNotifications = new PendingSessionNotifications();
81
87
  parentConstraintRegistry = new Map();
82
88
  suspendedEnvReaps = new Map();
83
- locallyClaimedTokens = new Set();
89
+ locallyClaimedTokens = new LocalClaims();
84
90
  static PARENT_CONSTRAINT_REGISTRY_CAP = 1024;
85
91
  depsSeat;
86
92
  constructor(deps) {
@@ -253,6 +259,7 @@ export class Runner {
253
259
  throw new TypeError("runTaskStream: `resume` must be a ResumeRun carrying `outcome` — got a value without one. " +
254
260
  "(Note the parameter order: runTaskStream(spec, resume?, internals?) — internals is the THIRD parameter.)");
255
261
  }
262
+ spec = readCallerSpec(spec).spec;
256
263
  const entryActor = spec.actor === undefined ? undefined : snapshotActorAssertion(spec.actor);
257
264
  const entryTracer = { tracer: spec.tracer ?? this.deps.tracer };
258
265
  const queue = new PushQueue();
@@ -284,7 +291,7 @@ export class Runner {
284
291
  w.resolve(outcome);
285
292
  };
286
293
  const runStartedAt = Date.now();
287
- const taskIdRef = { current: spec.taskId, sessionId: spec.sessionId };
294
+ const taskIdRef = { current: legTaskIdOf(spec, restoreRowTaskId(internals, resume?.cp.state.rowTaskId), undefined), sessionId: spec.sessionId };
288
295
  let held;
289
296
  let releaseLock;
290
297
  const holdSessionLock = (sessionId) => {
@@ -311,7 +318,7 @@ export class Runner {
311
318
  resultValue = r;
312
319
  const pcs = internals?.inheritedGate?.parentConstraints;
313
320
  if (resume !== undefined)
314
- this.locallyClaimedTokens.delete(resume.cp.token);
321
+ this.locallyClaimedTokens.close(resume.cp.token);
315
322
  const rToken = r.terminal.kind === "paused" ? r.terminal.token : undefined;
316
323
  if (resume !== undefined && rToken !== resume.cp.token) {
317
324
  this.parentConstraintRegistry.delete(resume.cp.token);
@@ -375,11 +382,11 @@ export class Runner {
375
382
  live, runner: this.depsSeat,
376
383
  locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
377
384
  });
378
- 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 });
379
386
  const { notify, optOutMemoryCapture, reconnectMcpServer, compact, detach, interrupt } = streamLifecycleVerbs({ live, ready, orTimeout, steeringError, notifyRef, captureOptOutRef, mcpRedialRef, manualCompactRef, detachHub });
380
- 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 });
381
388
  const { setPermissionMode } = streamModeVerb({ live, ready, orTimeout, steeringError });
382
- return {
389
+ const stream = {
383
390
  [Symbol.asyncIterator]: () => queue[Symbol.asyncIterator](),
384
391
  result: async () => {
385
392
  await settled;
@@ -400,6 +407,8 @@ export class Runner {
400
407
  halt,
401
408
  destroy,
402
409
  };
410
+ bindAuthoredSteer(stream, authoredSteer);
411
+ return stream;
403
412
  }
404
413
  runLocked(input) {
405
414
  const { spec, queue, setResult, onSuggestions, onReady, onSuspend, manualCompactRef, taskIdRef, holdSessionLock, legWrites, resume, internals, notifyRef, captureOptOutRef, mcpRedialRef, entryActor, entryTracer } = input;
@@ -425,7 +434,7 @@ export class Runner {
425
434
  const { withBrainSinks, withLegRequestSinks } = runBrainSinks({ queue, internals, rs, ident, observeReasoningWireFacts, notice: { onNotice: this.deps.onNotice, sessionId: prepared.sessionId, runId: prepared.runId }, announced: prepared });
426
435
  const toolLabels = new Map(prepared.tools.flatMap((t) => (t.label !== undefined && t.label !== t.name ? [[t.name, t.label]] : [])));
427
436
  for (const orphan of prepared.wakeRecovered) {
428
- 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 });
429
438
  emitCommitted(orphan.entryId, "toolResult", orphan.toolCallId);
430
439
  }
431
440
  const postToolBatchArmed = prepared.modBus.hasHandlers("classic.PostToolBatch");
@@ -434,7 +443,7 @@ export class Runner {
434
443
  const { onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, announceWorkspaceMove } = createHarnessHandlers({
435
444
  prepared, stats, rs,
436
445
  deps: {
437
- spec, queue, internals, ident, mediaByteCapBytes: this.deps.mediaByteCapBytes,
446
+ spec, queue, internals, ident, mediaBudgetBase64Chars: this.deps.mediaBudgetBase64Chars,
438
447
  pushContent, emitCommitted, startedToolCallIds, toolStartAt, toolProgress, writeFamilyOf,
439
448
  toolLabels, postToolBatchArmed, batchArgs, internalsNotifier,
440
449
  runnerHooks: { onError: (e, info) => this.deps.onError?.(e, info), onNotice: this.deps.onNotice },
@@ -462,7 +471,7 @@ export class Runner {
462
471
  });
463
472
  const { flushGitMirror, unsubGitRetry, unsubBoundary, unsub } = runGitLane({ prepared, queue, rs, ident, onMessageUpdate, onMessageEnd, onToolStart, onToolEnd, onTurnEnd, onTurnBoundary, runner: this.depsSeat });
464
473
  return withLegRequestSinks(() => runLeg({
465
- 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,
466
475
  announceWorkspaceMove, withBrainSinks, flushGitMirror, loopLatch, notificationLane, unsubscribeTaskNotifications, unsubGitRetry, unsubBoundary, unsub,
467
476
  runner: this.depsSeat,
468
477
  next: ({ final, threw, abortedLive, userInterruptedLive, strandedHumanAnswers }) => runTerminalAdoption({
@@ -501,10 +510,16 @@ export class Runner {
501
510
  taskConfig,
502
511
  internals,
503
512
  runner: this.depsSeat, sessions: this.sessions,
504
- parentConstraintRegistry: this.parentConstraintRegistry,
513
+ parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
505
514
  next: (admitted) => this.resumeLadder(token, outcome, admitted),
506
515
  });
507
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
+ }
508
523
  async resumeLadder(token, outcome, admitted) {
509
524
  const { config, internals, store, cp, outcomeGate, resumeSignal, wakeMessage } = admitted;
510
525
  const { plainReviewOutcome, plainParkOutcome } = resumeReviewOutcome({ cp, outcome, outcomeGate, wakeMessage });
@@ -522,7 +537,8 @@ export class Runner {
522
537
  locallyClaimedTokens: this.locallyClaimedTokens, parentConstraintRegistry: this.parentConstraintRegistry, suspendedEnvReaps: this.suspendedEnvReaps,
523
538
  next: () => resumeClaim({
524
539
  token, cp, store, outcomeForStore, holder: internals?.holder,
525
- 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 }),
526
542
  next: () => this.resumeHandoff({ token, cp, store, config, internals, resumeInternals, plainPolicyOutcome, redeemedAnswer, outcomeForStore, wakeMessage, wakeHookContext, legMods, resumeSignal }),
527
543
  }),
528
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,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;
@@ -2,7 +2,8 @@ import { uuidv7 } from "../../internal/harness.js";
2
2
  import { snapshotActorAssertion } from "../../internal/llm.js";
3
3
  import { MAX_STEER_INPUT_ID_CHARS } from "../checkpoint-store.js";
4
4
  import { formatHookFeedback } from "../hooks.js";
5
- import { classicEventBase, failedHandlerClause, screenUserPrompt } from "../mods/stations.js";
5
+ import { classicEventBase, failedHandlerClause, legNoticeTaskId, screenUserPrompt } from "../mods/stations.js";
6
+ import { countsAsOperator } from "../input-author.js";
6
7
  import { buildHumanInputEvent, frameMidTurnUserInput, projectHumanInput } from "../human-input-projection.js";
7
8
  import { injectionLaneOf, isSystemInjectionPriority, steerPriorityOf, SYSTEM_INJECTION_PRIORITIES } from "../task-notification.js";
8
9
  import { deliverEngineNotice } from "../types.js";
@@ -12,7 +13,7 @@ import { steerReplayRefusal } from "../steer-replay.js";
12
13
  export function streamSteerVerb(input) {
13
14
  const { spec, internals, queue, acceptedSteerInputs, live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, steeringError, runner } = input;
14
15
  let steerChain = Promise.resolve();
15
- const steer = async (text, options) => {
16
+ const steerAs = async (author, text, options) => {
16
17
  if (options?.userAttachments !== undefined) {
17
18
  throw steeringError("a steer carries no attachments — declare them in TaskSpec.userAttachments on the next objective", "steering.invalid_content");
18
19
  }
@@ -48,7 +49,7 @@ export function streamSteerVerb(input) {
48
49
  let payload;
49
50
  let mintsAFrame;
50
51
  const publishQueued = (h) => {
51
- const identity = internals?.parentToolCallId !== undefined ? { parentToolCallId: internals.parentToolCallId, ...(spec.taskId !== undefined ? { sourceTaskId: spec.taskId } : {}) } : {};
52
+ const identity = internals?.parentToolCallId !== undefined ? { parentToolCallId: internals.parentToolCallId, sourceTaskId: h.hookIdentity.taskId } : {};
52
53
  queue.push({
53
54
  ...buildHumanInputEvent({
54
55
  carrier: "steer",
@@ -93,7 +94,7 @@ export function streamSteerVerb(input) {
93
94
  }
94
95
  if (live.resultValue !== undefined || h.loop.ended)
95
96
  throw steeringError("the task is no longer running");
96
- if (mintsAFrame) {
97
+ if (mintsAFrame && countsAsOperator(author)) {
97
98
  const screen = await screenUserPrompt(h.modBus, {
98
99
  ...classicEventBase(h.hookIdentity, h.permissionMode.observed),
99
100
  prompt: text,
@@ -115,7 +116,7 @@ export function streamSteerVerb(input) {
115
116
  }
116
117
  }
117
118
  const injectFramed = async () => {
118
- const noteOptions = { provenance: "engine-note", callerAuthored: true, parkRecord, ...(actor !== undefined ? { actor } : {}) };
119
+ const noteOptions = { provenance: "engine-note", author, parkRecord, ...(actor !== undefined ? { actor } : {}) };
119
120
  if (mintsAFrame)
120
121
  armAcceptance(parkRecord, () => publishQueued(h));
121
122
  if (injectionLaneOf(priority) === "followUp") {
@@ -136,7 +137,7 @@ export function streamSteerVerb(input) {
136
137
  sessionId: h.sessionId,
137
138
  runId: h.runId,
138
139
  ...(actor?.id !== undefined ? { actorId: actor.id } : {}),
139
- ...(spec.taskId !== undefined ? { taskId: spec.taskId } : {}),
140
+ ...legNoticeTaskId(h.hookIdentity),
140
141
  },
141
142
  });
142
143
  }
@@ -167,5 +168,5 @@ export function streamSteerVerb(input) {
167
168
  steerChain = p.then(() => undefined, () => undefined);
168
169
  return p;
169
170
  };
170
- return { steer };
171
+ return { steer: (text, options) => steerAs("operator", text, options), authoredSteer: (author, text) => steerAs(author, text, undefined) };
171
172
  }