@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
@@ -1,13 +1,15 @@
1
- import { spawn } from "node:child_process";
1
+ import { spawn, spawnSync } from "node:child_process";
2
2
  import { randomUUID } from "node:crypto";
3
3
  import { closeSync, constants, createReadStream, mkdtempSync, openSync, readSync, rmSync, statSync, truncateSync, unlinkSync } from "node:fs";
4
4
  import { access, appendFile, lstat, mkdir, mkdtemp, open, readdir, readFile, readlink, rename, rm, stat, unlink, writeFile, } from "node:fs/promises";
5
5
  import { tmpdir } from "node:os";
6
- import { dirname, isAbsolute, join, sep } from "node:path";
6
+ import { basename, dirname, isAbsolute, join, sep } from "node:path";
7
7
  import { createInterface } from "node:readline";
8
8
  import { ExecutionError, err, FileError, ok, toError, } from "../harness/types.js";
9
9
  import { killProcessTree, shutdownDebug } from "./kill-tree.js";
10
10
  import { __resetSecretEnvScrubNoticeAnnouncement, announceSecretEnvScrub, hostChildEnv, hostChildEnvProblem, inheritedHostEnv } from "../../core/secret-env.js";
11
+ import { deliverEngineNotice } from "../../core/engine-notice.js";
12
+ import { confineShellStart, SANDBOX_EXEC, SEATBELT_PROBE_PROFILE } from "../../core/shell-confinement.js";
11
13
  import { physicalPathOfAsync } from "../../core/physical-path.js";
12
14
  import { posixModeBitsMeaningful } from "../../core/posix-mode-face.js";
13
15
  import { anchorAtLinkDir, walkSymlinkChain } from "./symlink-chain.js";
@@ -25,6 +27,41 @@ const NODE_ENV_CAPABILITIES = Object.freeze({
25
27
  io: true,
26
28
  keepsReadFloor: false,
27
29
  });
30
+ const NODE_ENV_CONFINED_CAPABILITIES = Object.freeze({ ...NODE_ENV_CAPABILITIES, keepsReadFloor: true });
31
+ function probeReadFloorConfinement() {
32
+ if (process.platform !== "darwin")
33
+ return { ok: false, reason: `this platform (${process.platform}) has no process confinement the engine applies — macOS only` };
34
+ try {
35
+ const r = spawnSync(SANDBOX_EXEC, ["-p", SEATBELT_PROBE_PROFILE, "/usr/bin/true"], { env: {}, stdio: ["ignore", "ignore", "pipe"], timeout: 10_000, encoding: "utf8" });
36
+ if (r.status === 0)
37
+ return { ok: true };
38
+ const said = (r.error?.message ?? r.stderr ?? "").trim().slice(0, 300);
39
+ return { ok: false, reason: `${SANDBOX_EXEC} could not apply the confinement base here (${r.status === null ? `signal ${r.signal ?? "none"}` : `exit ${r.status}`}${said !== "" ? `: ${said}` : ""})` };
40
+ }
41
+ catch (e) {
42
+ return { ok: false, reason: `${SANDBOX_EXEC} could not be run (${toError(e).message.slice(0, 300)})` };
43
+ }
44
+ }
45
+ function profileApplyFailure(profile) {
46
+ return new Promise((resolve) => {
47
+ let said = "";
48
+ let child;
49
+ try {
50
+ child = spawn(SANDBOX_EXEC, ["-p", profile, "/usr/bin/true"], { env: {}, stdio: ["ignore", "ignore", "pipe"] });
51
+ }
52
+ catch (e) {
53
+ resolve(`${SANDBOX_EXEC} could not be run: ${toError(e).message.slice(0, 300)}`);
54
+ return;
55
+ }
56
+ child.stderr?.setEncoding("utf8");
57
+ child.stderr?.on("data", (chunk) => {
58
+ if (said.length < 300)
59
+ said += chunk;
60
+ });
61
+ child.on("error", (e) => resolve(`${SANDBOX_EXEC} could not be run: ${e.message.slice(0, 300)}`));
62
+ child.on("close", (code, signal) => resolve(code === 0 ? undefined : `${code === null ? `signal ${signal ?? "none"}` : `exit ${code}`}${said.trim() !== "" ? `: ${said.trim().slice(0, 300)}` : ""}`));
63
+ });
64
+ }
28
65
  function resolvePath(cwd, path) {
29
66
  if (isAbsolute(path))
30
67
  return path;
@@ -126,6 +163,8 @@ function toFileError(error, path) {
126
163
  return new FileError("permission_denied", message, path, cause);
127
164
  case "ENOTDIR":
128
165
  return new FileError("not_directory", message, path, cause);
166
+ case "ELOOP":
167
+ return new FileError("symlink_loop", message, path, cause);
129
168
  case "EISDIR":
130
169
  return new FileError("is_directory", message, path, cause);
131
170
  case "ENAMETOOLONG":
@@ -156,6 +195,106 @@ function isFsSupportError(error) {
156
195
  return code === "EINVAL" || code === "ENOTSUP" || code === "EPERM" || code === "ENOSYS";
157
196
  }
158
197
  const RENAME_FALLBACK_CODES = new Set(["EXDEV", "EPERM", "EEXIST", "EBUSY"]);
198
+ const NAME_MAX_BYTES = 255;
199
+ const STAGING_SUFFIX = /\.tmp\.(\d+)\.[0-9a-f]{12}$/;
200
+ function stagingSuffix(pid) {
201
+ return `.tmp.${pid}.${randomUUID().replace(/-/g, "").slice(0, 12)}`;
202
+ }
203
+ function stagingNameOf(name, suffix) {
204
+ const nameBytes = Buffer.byteLength(name, "utf8");
205
+ const room = NAME_MAX_BYTES - Buffer.byteLength(suffix, "utf8");
206
+ if (nameBytes <= room || nameBytes > NAME_MAX_BYTES)
207
+ return `${name}${suffix}`;
208
+ let kept = "";
209
+ let used = 0;
210
+ for (const char of name) {
211
+ const bytes = Buffer.byteLength(char, "utf8");
212
+ if (used + bytes > room)
213
+ break;
214
+ kept += char;
215
+ used += bytes;
216
+ }
217
+ return `${kept}${suffix}`;
218
+ }
219
+ function stagingSiblingOf(target) {
220
+ const suffix = stagingSuffix(process.pid);
221
+ const name = basename(target);
222
+ if (!target.endsWith(name))
223
+ return `${target}${suffix}`;
224
+ return `${target.slice(0, target.length - name.length)}${stagingNameOf(name, suffix)}`;
225
+ }
226
+ function processIsGone(pid) {
227
+ if (!Number.isSafeInteger(pid) || pid < 1)
228
+ return false;
229
+ try {
230
+ process.kill(pid, 0);
231
+ return false;
232
+ }
233
+ catch (error) {
234
+ return isNodeError(error) && error.code === "ESRCH";
235
+ }
236
+ }
237
+ async function sweepDeadStaging(target) {
238
+ const name = basename(target);
239
+ if (!target.endsWith(name))
240
+ return 0;
241
+ const prefix = target.slice(0, target.length - name.length);
242
+ let entries;
243
+ try {
244
+ entries = await readdir(dirname(target));
245
+ }
246
+ catch {
247
+ return 0;
248
+ }
249
+ let swept = 0;
250
+ for (const entry of entries) {
251
+ if (entry === name)
252
+ continue;
253
+ const tail = STAGING_SUFFIX.exec(entry);
254
+ if (tail === null || entry !== stagingNameOf(name, tail[0]) || !processIsGone(Number(tail[1])))
255
+ continue;
256
+ const at = `${prefix}${entry}`;
257
+ if (SWEEPING.has(at))
258
+ continue;
259
+ SWEEPING.add(at);
260
+ try {
261
+ const st = await lstat(at);
262
+ if (!st.isFile() || st.nlink !== 1)
263
+ continue;
264
+ await unlink(at);
265
+ swept += 1;
266
+ }
267
+ catch {
268
+ }
269
+ finally {
270
+ SWEEPING.delete(at);
271
+ }
272
+ }
273
+ return swept;
274
+ }
275
+ const SWEEPING = new Set();
276
+ async function discardStaging(tmp) {
277
+ try {
278
+ await unlink(tmp);
279
+ return undefined;
280
+ }
281
+ catch (error) {
282
+ const code = isNodeError(error) ? error.code : undefined;
283
+ return code === "ENOENT" ? undefined : { path: tmp, sentence: `staging file left at ${tmp} (${code ?? "unlink failed"})` };
284
+ }
285
+ }
286
+ function withStagingResidue(result, left, onNotice) {
287
+ if (left === undefined)
288
+ return result;
289
+ if (result.ok) {
290
+ if (typeof onNotice === "function") {
291
+ deliverEngineNotice(onNotice, { code: "fs.staging_file_left", message: `${left.sentence}; the write itself succeeded`, detail: { path: left.path } });
292
+ }
293
+ return result;
294
+ }
295
+ const { code, message, path, cause } = result.error;
296
+ return err(new FileError(code, `${message}; ${left.sentence}`, path, cause instanceof Error ? cause : undefined));
297
+ }
159
298
  async function pathExists(path) {
160
299
  try {
161
300
  await access(path, constants.F_OK);
@@ -324,7 +463,9 @@ export function openSpoolPair(base) {
324
463
  }
325
464
  export class NodeExecutionEnv {
326
465
  cwd;
327
- capabilities = NODE_ENV_CAPABILITIES;
466
+ capabilities;
467
+ confined;
468
+ profileApplies = new Map();
328
469
  get homeDir() {
329
470
  return this.childEnvForRead()?.HOME;
330
471
  }
@@ -358,6 +499,9 @@ export class NodeExecutionEnv {
358
499
  spoolPairs = new Set();
359
500
  backgroundCapabilities;
360
501
  constructor(options) {
502
+ if (options.readFloorConfinement !== undefined && options.readFloorConfinement !== "os") {
503
+ throw new Error(`NodeExecutionEnv: readFloorConfinement must be "os" or absent (got ${JSON.stringify(options.readFloorConfinement) ?? typeof options.readFloorConfinement}) — a confinement request that cannot be read is no request, so it refuses instead of reading as one side.`);
504
+ }
361
505
  this.cwd = options.cwd;
362
506
  this.shellPath = options.shellPath;
363
507
  this.shellEnv = options.shellEnv;
@@ -369,6 +513,16 @@ export class NodeExecutionEnv {
369
513
  this.retainBackgroundProcesses = options.retainBackgroundProcesses ?? false;
370
514
  this.onSecretEnvScrub = options.onSecretEnvScrub;
371
515
  this.onNotice = options.onNotice;
516
+ const probe = options.readFloorConfinement === "os" ? probeReadFloorConfinement() : undefined;
517
+ this.confined = probe?.ok === true;
518
+ this.capabilities = this.confined ? NODE_ENV_CONFINED_CAPABILITIES : NODE_ENV_CAPABILITIES;
519
+ if (probe !== undefined && !probe.ok) {
520
+ deliverEngineNotice(this.onNotice, {
521
+ code: "config.read_floor_confinement_unavailable",
522
+ message: `Process confinement of the byte floor was requested (readFloorConfinement: "os") and is not available: ${probe.reason}. This environment declares that it does not keep the floor (capabilities.keepsReadFloor is false), so a run with read-deny rows is announced or, under readDenyFloorRequired, refused.`,
523
+ detail: { reason: probe.reason },
524
+ });
525
+ }
372
526
  this.backgroundCapabilities = {
373
527
  supported: true,
374
528
  maxConcurrent: 8,
@@ -410,6 +564,27 @@ export class NodeExecutionEnv {
410
564
  const named = parts.map((part, i) => (i === 0 ? part : part.replace(leading, ""))).filter((part) => part !== "");
411
565
  return ok(named.length === 0 ? "." : named.reduce((at, part) => anchorAtLinkDir(at, part, sep)));
412
566
  }
567
+ async startOf(shell, command, floor) {
568
+ const start = { command: shell.shell, args: [...shell.args, command] };
569
+ if (!this.confined)
570
+ return { ok: true, ...start };
571
+ const confined = confineShellStart(start, floor);
572
+ if (!confined.ok)
573
+ return { ok: false, reason: `the read-deny row ${JSON.stringify(confined.row)} cannot be kept by this environment's process confinement (${confined.reason}) — the command was not started` };
574
+ if (confined.profile === undefined)
575
+ return { ok: true, ...confined.start };
576
+ let applies = this.profileApplies.get(confined.profile);
577
+ if (applies === undefined) {
578
+ if (this.profileApplies.size >= 16)
579
+ this.profileApplies.clear();
580
+ applies = profileApplyFailure(confined.profile);
581
+ this.profileApplies.set(confined.profile, applies);
582
+ }
583
+ const failed = await applies;
584
+ if (failed !== undefined)
585
+ return { ok: false, reason: `the read-deny table's confinement profile does not apply on this host (${failed}) — the command was not started` };
586
+ return { ok: true, ...confined.start };
587
+ }
413
588
  async exec(command, options) {
414
589
  if (options?.abortSignal?.aborted) {
415
590
  return err(new ExecutionError("aborted", "aborted"));
@@ -419,6 +594,9 @@ export class NodeExecutionEnv {
419
594
  if (!shellConfig.ok) {
420
595
  return shellConfig;
421
596
  }
597
+ const start = await this.startOf(shellConfig.value, command, options?.readFloor);
598
+ if (!start.ok)
599
+ return err(new ExecutionError("spawn_error", start.reason));
422
600
  return await new Promise((resolvePromise) => {
423
601
  const stdoutTail = new RollingTailBuffer();
424
602
  const stderrTail = new RollingTailBuffer();
@@ -517,7 +695,7 @@ export class NodeExecutionEnv {
517
695
  execSpoolFds = undefined;
518
696
  };
519
697
  try {
520
- child = spawn(shellConfig.value.shell, [...shellConfig.value.args, command], {
698
+ child = spawn(start.command, [...start.args], {
521
699
  cwd,
522
700
  detached: process.platform !== "win32",
523
701
  env: getShellEnv(this.inheritEnv, this.shellEnv, options?.env, this.onSecretEnvScrub, this.onNotice),
@@ -894,10 +1072,23 @@ export class NodeExecutionEnv {
894
1072
  existingMode = st.mode & 0o7777;
895
1073
  }
896
1074
  }
897
- const tmp = `${target}.tmp.${process.pid}.${randomUUID().replace(/-/g, "").slice(0, 12)}`;
1075
+ const swept = await sweepDeadStaging(target);
1076
+ if (swept > 0 && typeof this.onNotice === "function") {
1077
+ deliverEngineNotice(this.onNotice, {
1078
+ code: "fs.staging_file_swept",
1079
+ message: `removed ${swept} staging file${swept === 1 ? "" : "s"} that a process which no longer runs left beside a file this write replaces`,
1080
+ detail: { count: swept },
1081
+ });
1082
+ }
1083
+ const afterSweepAbort = abortResult(abortSignal, resolved);
1084
+ if (afterSweepAbort)
1085
+ return afterSweepAbort;
1086
+ const tmp = stagingSiblingOf(target);
898
1087
  let tmpDurable = false;
1088
+ let created = false;
899
1089
  try {
900
1090
  const handle = await open(tmp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | (constants.O_NOFOLLOW ?? 0), existingMode === undefined ? 0o666 : 0o600);
1091
+ created = true;
901
1092
  try {
902
1093
  await handle.writeFile(content, { signal: abortSignal });
903
1094
  if (existingMode !== undefined) {
@@ -923,17 +1114,15 @@ export class NodeExecutionEnv {
923
1114
  }
924
1115
  }
925
1116
  catch (error) {
926
- await unlink(tmp).catch(() => { });
1117
+ const left = created ? await discardStaging(tmp) : undefined;
927
1118
  if (isNodeError(error) && error.code === "EACCES" && existingMode !== undefined) {
928
- return await this.writeFileInPlace(resolved, content, abortSignal);
1119
+ return withStagingResidue(await this.writeFileInPlace(resolved, content, abortSignal), left, this.onNotice);
929
1120
  }
930
- return err(toFileError(error, resolved));
1121
+ return withStagingResidue(err(toFileError(error, resolved)), left, this.onNotice);
931
1122
  }
932
1123
  const preRenameAbort = abortResult(abortSignal, resolved);
933
- if (preRenameAbort) {
934
- await unlink(tmp).catch(() => { });
935
- return preRenameAbort;
936
- }
1124
+ if (preRenameAbort)
1125
+ return withStagingResidue(preRenameAbort, await discardStaging(tmp), this.onNotice);
937
1126
  try {
938
1127
  await rename(tmp, target);
939
1128
  return ok(undefined);
@@ -942,19 +1131,19 @@ export class NodeExecutionEnv {
942
1131
  const code = isNodeError(error) ? error.code : undefined;
943
1132
  if (tmpDurable && code !== undefined && RENAME_FALLBACK_CODES.has(code)) {
944
1133
  const inPlace = await this.writeFileInPlace(resolved, content, abortSignal);
945
- if (inPlace.ok) {
946
- await unlink(tmp).catch(() => { });
947
- return inPlace;
948
- }
1134
+ if (inPlace.ok || inPlace.error.code === "aborted")
1135
+ return withStagingResidue(inPlace, await discardStaging(tmp), this.onNotice);
949
1136
  return err(new FileError("unknown", `write to ${resolved} failed after the atomic rename was refused (${code}): ${inPlace.error.message}. The new content was preserved at ${tmp}`, resolved, inPlace.error));
950
1137
  }
951
- await unlink(tmp).catch(() => { });
952
- return err(toFileError(error, resolved));
1138
+ return withStagingResidue(err(toFileError(error, resolved)), await discardStaging(tmp), this.onNotice);
953
1139
  }
954
1140
  }
955
1141
  async writeFileInPlace(resolved, content, abortSignal) {
1142
+ const aborted = abortResult(abortSignal, resolved);
1143
+ if (aborted)
1144
+ return aborted;
956
1145
  try {
957
- await writeFile(resolved, content, { signal: abortSignal });
1146
+ await writeFile(resolved, content);
958
1147
  return ok(undefined);
959
1148
  }
960
1149
  catch (error) {
@@ -978,7 +1167,7 @@ export class NodeExecutionEnv {
978
1167
  return afterMkdirAbort;
979
1168
  }
980
1169
  try {
981
- await writeFile(resolved, content, { signal: abortSignal, flag: "wx" });
1170
+ await writeFile(resolved, content, { flag: "wx" });
982
1171
  return ok(undefined);
983
1172
  }
984
1173
  catch (error) {
@@ -1319,6 +1508,9 @@ export class NodeExecutionEnv {
1319
1508
  if (!shellConfig.ok) {
1320
1509
  return err(new BackgroundShellError("spawn_failed", shellConfig.error.message, shellConfig.error));
1321
1510
  }
1511
+ const start = await this.startOf(shellConfig.value, command, options?.readFloor);
1512
+ if (!start.ok)
1513
+ return err(new BackgroundShellError("spawn_failed", start.reason));
1322
1514
  let spool;
1323
1515
  let spoolFds;
1324
1516
  if (this.retainBackgroundProcesses || process.platform !== "win32") {
@@ -1339,7 +1531,7 @@ export class NodeExecutionEnv {
1339
1531
  }
1340
1532
  let child;
1341
1533
  try {
1342
- child = spawn(shellConfig.value.shell, [...shellConfig.value.args, command], {
1534
+ child = spawn(start.command, [...start.args], {
1343
1535
  cwd: options?.cwd ? resolvePath(this.cwd, options.cwd) : this.cwd,
1344
1536
  detached: process.platform !== "win32",
1345
1537
  env: getShellEnv(this.inheritEnv, this.shellEnv, options?.env, this.onSecretEnvScrub, this.onNotice),
@@ -6,8 +6,9 @@ import type { HaltRemainingDirective } from "../loop/types.js";
6
6
  import type { AgentMessage, AgentTool, AgentToolCall, LoopMalformedToolUseRecovery, LoopThinkingOnlyRecovery, LoopTruncatedOutputRecovery, QueueMode, ThinkingLevel } from "../loop/types.js";
7
7
  import { type EngineSegment } from "../../core/untrusted-text.js";
8
8
  import { type RunOrigin } from "../../core/run-origin.js";
9
+ import { type InputAuthor } from "../../core/input-author.js";
9
10
  import type { CommittedFrameCarrier } from "../../core/frame-settlement.js";
10
- import type { AbortResult, AgentHarnessEvent, AgentHarnessEventResultMap, AgentHarnessOptions, AgentHarnessOwnEvent, AgentHarnessResources, AgentHarnessStreamOptions, ExecutionEnv, PromptTemplate, Skill } from "./types.js";
11
+ import type { AbortResult, AgentHarnessEvent, AgentHarnessEventResultMap, AgentHarnessOptions, AgentHarnessOwnEvent, AgentHarnessResources, AgentHarnessStreamOptions, ExecutionEnv, PendingSessionWrite, PromptTemplate, RowRaising, Skill } from "./types.js";
11
12
  /** [c209-C] 收口 C1/C2 — engine-provenance metadata a caller can stamp on the user message it
12
13
  * mints (see the field docs on {@link UserMessage}). Threaded from `prompt`/`steer`/`followUp`/
13
14
  * `nextTurn` options into the persisted message so derived views (auto-mode window, compaction
@@ -51,6 +52,12 @@ export interface TrailingMessageSeed {
51
52
  export interface PromptTrailing {
52
53
  trailing?: readonly TrailingMessageSeed[];
53
54
  }
55
+ /** `prompt()` option: the prompt RECORDS a decision that ended the turn awaiting the user (a person's bare refusal) and
56
+ * owes no model turn — what joins it at turn open (engine notes only) rides along unanswered, the steer / follow-up
57
+ * drain points still continue the run, and an ending with no new answer answers with the last assistant message. */
58
+ export interface PromptEndsAwaitingUser {
59
+ endsAwaitingUser?: true;
60
+ }
54
61
  export interface UserMessageProvenance {
55
62
  /** Exact char length of the engine-prepended prefix on `text` (first-frame reminders etc.).
56
63
  * Sugar for the single segment `[0, chars)` — when `engineSegments` is also supplied, segments win. */
@@ -65,13 +72,14 @@ export interface UserMessageProvenance {
65
72
  /** [c209-C] R3: engine-injected note whose content must stay VISIBLE in derived views (diagnostics,
66
73
  * task notifications, steering, recall) but never under user authority — see UserMessage.provenance. */
67
74
  provenance?: "engine-note";
68
- /** The frame's CONTENT is caller/supervisor speech relayed by the engine (a TaskStream steer), not
69
- * engine-authored guidance. Rides only WITH `provenance:"engine-note"` (the projection semantics are
70
- * identical — visible, never `[user]` authority); what it changes is the run-control judgment: the
71
- * human-halt hold below treats a caller-authored frame as USER-provenance input (always passes),
72
- * while an engine-authored one is held. Minter-stated at the single relay seam that mints such
73
- * frames — never inferred from text. Metadata only; not persisted on the message. */
74
- callerAuthored?: true;
75
+ /** Who wrote the input this frame's CONTENT is ({@link InputAuthor}) — an input relayed by the engine (a TaskStream steer, the
76
+ * observer's report), not engine-authored guidance. Rides only WITH `provenance:"engine-note"` (the projection semantics are
77
+ * identical — visible, never `[user]` authority); what it changes is the run-control judgment: the human-halt hold below
78
+ * treats an authored frame as input (always passes) while an engine-authored one is held, and only a frame whose author
79
+ * counts as the operator's (`countsAsOperator`) is the person's input — parkable across a pause, on the undelivered-input
80
+ * account. Minter-stated at the single relay seam that mints such frames — never inferred from text. Metadata only; not
81
+ * persisted on the message. */
82
+ author?: InputAuthor;
75
83
  /** #1036 — the frame's injection-queue dedup key, persisted on the message it becomes
76
84
  * ({@link UserMessage.engineNoteKey}) so a reader of the TRANSCRIPT alone can join an entry back
77
85
  * to its frame. Rides only WITH `provenance:"engine-note"`. */
@@ -155,6 +163,14 @@ export interface HarnessLoopRecovery {
155
163
  withholdErrorEvents?: boolean;
156
164
  };
157
165
  }
166
+ /** How a durable park's commit ended, for the rows its gate took off the port ({@link AgentHarness.parkCapture}): the row
167
+ * holds them (`committed`), no row was written (`absent`), or whether one was is unknown (`indeterminate`). */
168
+ type ParkCaptureOutcome = "committed" | "absent" | "indeterminate";
169
+ /** The port's held rows as a park's gate took them, in queue order, and the one call that says how the commit ended. */
170
+ interface ParkCapture {
171
+ readonly rows: readonly AgentMessage[];
172
+ settle(outcome: ParkCaptureOutcome): void;
173
+ }
158
174
  export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate, TTool extends AgentTool = AgentTool> {
159
175
  readonly env: ExecutionEnv;
160
176
  private session;
@@ -179,7 +195,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
179
195
  * per turn, so identity carries the generation); the loop's cut-consumption report is accepted for THIS seat only. */
180
196
  private lastPublishedSeat?;
181
197
  private readonly seatCutSources;
182
- private trailingBatchEndedOn?;
198
+ private endedOnPriorAnswer;
183
199
  private promptReceipt?;
184
200
  private turnCutConsumed?;
185
201
  private readonly committedEntryIds;
@@ -204,6 +220,10 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
204
220
  private runAbortController?;
205
221
  private runPromise?;
206
222
  private pendingSessionWrites;
223
+ /** A park's capture of the port's held rows, from the gate's snapshot until its commit settles: the port waits on it. */
224
+ private parkCaptureInFlight?;
225
+ /** Set when a park's commit took the port's rows, or may have: the port refuses from then on (this leg's conversation goes on from the checkpoint). */
226
+ private parkedPortClosed;
207
227
  private model;
208
228
  /** The ref that chose {@link model}, moved by the SAME assignment (one value, never two answers). */
209
229
  private modelRef;
@@ -215,10 +235,16 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
215
235
  * with every request view that needed one (the transcript is never rewritten, so a broken turn is repaired, and
216
236
  * reported, on each request; the sink owns its dedup). Advisory: a throwing sink never breaks the request. */
217
237
  onToolTurnRepaired?: (repairs: readonly ToolTurnRepair[]) => void;
218
- /** Runner-set sink for the images a provider refused in THIS run ({@link removeRejectedImages}) — a refusal recorded
238
+ /** Runner-set sink for the images a provider refused in THIS run ({@link removeRefusedRequestParts}) — a refusal recorded
219
239
  * before the run began is not reported. Every request re-reads the transcript, so the sink owns its dedup (by
220
240
  * `refusalAt`). Advisory: a throwing sink never breaks the request. */
221
241
  onImagesRemoved?: (removals: readonly RejectedImageRemoval[]) => void;
242
+ /** Runner-set sink for a tool whose input schema a provider refused in THIS run, told when the loop re-sends the turn
243
+ * without it (the loop config's `onToolSchemaRefused`). Advisory: a throwing sink never breaks the re-send. */
244
+ onToolSchemaRefused?: (refusal: {
245
+ tool: string;
246
+ refusalAt: number;
247
+ }) => void;
222
248
  /** The image refusals standing in the transcript when the current run began, by their identity
223
249
  * ({@link RejectedImageRemoval.refusalAt}): the run that met them announced them. */
224
250
  private priorImageRefusals?;
@@ -241,6 +267,10 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
241
267
  steer: readonly unknown[];
242
268
  followUp: readonly unknown[];
243
269
  }) => void;
270
+ /** The same terminal moment's inputs that are NOT the operator's ({@link UserMessageProvenance.author} outside
271
+ * `countsAsOperator`, e.g. an observer's report): never parked and never on the account above, they end with the run;
272
+ * handed over by author, in service order, so the runner can say once that they were dropped. */
273
+ onUndrainedOtherInputs?: (authors: readonly InputAuthor[]) => void;
244
274
  /** design/176 — runner-set sink fired at the CONSUMPTION boundary, once per engine-note payload,
245
275
  * in consumption order (steer/followUp drain and the turn-open nextTurn splice — the two points
246
276
  * where a queued frame actually enters the model's input). The runner uses it to record the
@@ -276,7 +306,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
276
306
  * minted it. */
277
307
  engineInjectionsHeld?: () => boolean;
278
308
  /** The provider boundary's tool-turn law: the repaired view goes to the brain, the repairs to the runner's sink. */
279
- /** The request view of `messages` under the provider's image refusals they hold ({@link removeRejectedImages}), and
309
+ /** The request view of `messages` under the provider's image refusals they hold ({@link removeRefusedRequestParts}), and
280
310
  * the removals this run met handed to {@link onImagesRemoved}. */
281
311
  private imageRefusalView;
282
312
  private holdToolTurnLaw;
@@ -294,9 +324,9 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
294
324
  private sweepUndrainedEngineNotes;
295
325
  /**
296
326
  * How much of a PERSON's input is currently accepted-but-unserved, per lane — the one predicate behind
297
- * both readers below, so "a person's input is waiting" cannot come to mean two things. Engine-AUTHORED
298
- * frames are excluded, and the IN-FLIGHT slot counts (a frame spliced out of a queue and never injected
299
- * is as pending as one that never left it).
327
+ * both readers below, so "a person's input is waiting" cannot come to mean two things. Only the operator's
328
+ * input counts ({@link isOperatorInput}: engine-AUTHORED frames and inputs another author wrote are out), and the
329
+ * IN-FLIGHT slot counts (a frame spliced out of a queue and never injected is as pending as one that never left it).
300
330
  */
301
331
  private pendingUserInputFramesByLane;
302
332
  private pendingUserInputsByLane;
@@ -336,6 +366,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
336
366
  private stallTimeoutsPerCall?;
337
367
  private abortResultDetails?;
338
368
  private executeTool?;
369
+ private admitRows;
339
370
  private activeRun?;
340
371
  private loopTrace?;
341
372
  private onToolInputValidationFault?;
@@ -436,7 +467,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
436
467
  images?: ImageContent[];
437
468
  settleUnansweredToolCalls?: TrailingToolBatchOptions;
438
469
  onCommitted?: PromptCommittedCallback;
439
- } & UserMessageProvenance & PromptTrailing): Promise<AssistantMessage | undefined>;
470
+ } & UserMessageProvenance & PromptTrailing & PromptEndsAwaitingUser): Promise<AssistantMessage | undefined>;
440
471
  /** R2-③: an empty/whitespace-only injection with no images carries ZERO information — it
441
472
  * must not mint a user frame (strict endpoints reject empty user content, and an empty follow-up would
442
473
  * pointlessly extend the run by one turn). No-op, not a throw: injection callers are fire-and-
@@ -577,7 +608,11 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
577
608
  nextTurn(text: string, options?: {
578
609
  images?: ImageContent[];
579
610
  } & UserMessageProvenance): Promise<void>;
580
- appendMessage(message: AgentMessage): Promise<void>;
611
+ /** The admission seat first (a raised row carries its `raising`; one the seat does not keep is not stored), then the store:
612
+ * at once when no turn runs and nothing is held before it, else queued for the next serialization point. A park's capture
613
+ * in progress is waited out; once a park took (or may have taken) the held rows, the row is refused — no running loop
614
+ * takes it. */
615
+ appendMessage(message: AgentMessage, raising?: RowRaising): Promise<void>;
581
616
  /** The loop's `afterToolCall`: one `tool_result` hook emit per executed call (every registered handler, one fold). */
582
617
  private afterToolCallHook;
583
618
  /**
@@ -639,6 +674,16 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
639
674
  * the queue is empty.
640
675
  */
641
676
  flushQueuedSessionWrites(): Promise<void>;
677
+ /**
678
+ * A durable park's gate takes the rows the port holds (non-destructive, in queue order) to write them on its checkpoint;
679
+ * until {@link ParkCapture.settle} the port waits. `committed` takes them off the queue (the resumed leg writes them) and
680
+ * closes the port; `indeterminate` closes the port and leaves them queued (this leg's own branch gets them if its
681
+ * transcript is closed again); `absent` changes nothing. Only rows are held at a park: the other queued writes come from
682
+ * turn ends, which flush before any park point.
683
+ */
684
+ parkCapture(): ParkCapture;
685
+ /** The session writes still held (queue order) — what an interrupted run whose batch stayed open cannot write. */
686
+ heldSessionWrites(): readonly PendingSessionWrite[];
642
687
  /**
643
688
  * backlog #389 — the accepted-but-undelivered CALLER frames a durable suspend can carry forward,
644
689
  * in delivery order (steer before followUp, each queue forward — the order the live loop serves).
@@ -646,8 +691,9 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
646
691
  * for a checkpoint that never landed would be lost twice over. {@link dropParkedUserInputs} is the
647
692
  * second half, called only once the checkpoint is durably committed.
648
693
  *
649
- * Only frames carrying a park record are returned — engine-authored notes have their own lossless
650
- * lane (`onUndrainedEngineNotes` → pend per session) and must not be parked twice.
694
+ * Only the operator's frames carrying a park record are returned ({@link isOperatorInput}) — engine-authored notes have
695
+ * their own lossless lane (`onUndrainedEngineNotes` → pend per session) and must not be parked twice, and an input another
696
+ * author wrote is not the person's to carry (it ends with the run, named through `onUndrainedOtherInputs`).
651
697
  */
652
698
  readParkableUserInputs(): unknown[];
653
699
  /**
@@ -704,3 +750,4 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
704
750
  type: TType;
705
751
  }>) => Promise<AgentHarnessEventResultMap[TType]> | AgentHarnessEventResultMap[TType]): () => void;
706
752
  }
753
+ export {};