@sema-agent/core 7.66.0 → 7.67.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 (903) hide show
  1. package/CHANGELOG.md +3498 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +13 -3
  477. package/dist/core/runner/prepare-park-ask.js +25 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +7 -6
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.66.1.json +30 -0
  892. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  893. package/wire-changes/core@7.66.1.json +46 -0
  894. package/wire-changes/core@7.67.0.json +12578 -0
  895. package/wire-changes/mods-kernel@7.66.1.json +30 -0
  896. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  897. package/wire-changes/primitives@7.66.1.json +30 -0
  898. package/wire-changes/primitives@7.67.0.json +325 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/dist/brain/degrading.d.ts +0 -93
  901. package/dist/brain/degrading.js +0 -189
  902. package/dist/core/tool-conformance.d.ts +0 -20
  903. package/dist/core/tool-conformance.js +0 -37
@@ -107,6 +107,12 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
107
107
  * the own credentials declared since construction, or `shellEnv` is no grant, and every spawn throws that reason — so
108
108
  * a reader sees "the child gets none", never a throw. Composed once: the refusal is the composition's own. */
109
109
  private childEnvForRead;
110
+ /** The environment a shell child is started with (exec and the background start alike), or the composition's refusal,
111
+ * thrown for the start's `try`. The allow list was judged and copied at construction, so a refusal of the list itself
112
+ * can only come from a declaration made since: that one is said in this environment's words and, at the first start it
113
+ * refuses, once on `onNotice` (`config.inherit_env_declared_late`, `detail: { index, name }`). A grant's refusal is the
114
+ * composition's own sentence, unchanged. */
115
+ private spawnEnv;
110
116
  private shellPath?;
111
117
  private shellEnv?;
112
118
  private inheritEnv;
@@ -116,6 +122,8 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
116
122
  private readonly retainBackgroundProcesses;
117
123
  private readonly onSecretEnvScrub?;
118
124
  private readonly onNotice?;
125
+ /** Whether `config.inherit_env_declared_late` has been said: once per environment, at the first start it refuses. */
126
+ private lateDeclarationAnnounced;
119
127
  /** design/128 T1-1: the env-owned spool dir (mkdtemp under os tmp — unpredictable, never the cwd). It exists only while
120
128
  * {@link spoolPairs} is non-empty: the last pair's release removes it, the next mint makes a fresh one. */
121
129
  private bgSpoolDir?;
@@ -135,7 +143,8 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
135
143
  * reason), the same judgment the oracle gate's `inheritEnv` meets. Whatever the policy, the deployment's own
136
144
  * credentials (`declareWithheldEnv`: by name, and by a value equal to a declared or engine-held credential value)
137
145
  * are withheld from the inherited part; a list naming a declared name throws here when the declaration came
138
- * first, and every spawn refuses it (`spawn_error` / `spawn_failed`) whenever it came. */
146
+ * first, and every spawn refuses it (`spawn_error` / `spawn_failed`) whenever it came — a declaration made after
147
+ * construction in this environment's words, said once on `onNotice` (`config.inherit_env_declared_late`). */
139
148
  inheritEnv?: "all" | "scrub" | string[];
140
149
  /** design/105: inject a resident scheduler daemon backend (the shell daemon). Absent ⇒ scheduling INERT. */
141
150
  scheduler?: SchedulerCapability;
@@ -160,12 +169,14 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
160
169
  onSecretEnvScrub?: (findings: readonly SecretEnvFinding[]) => void;
161
170
  /** #1081 — the structured-notice seat for the SAME withheld-keys disclosure (`EngineNotice`,
162
171
  * `code: "config.secret_env_scrubbed"`, `detail.names`); independent of `onSecretEnvScrub` (a raw
163
- * findings collector) except: that seat wired alone stays console-silent, as before this existed. */
172
+ * findings collector) except: that seat wired alone stays console-silent, as before this existed. The same seat hears
173
+ * this environment's own faults: `config.inherit_env_declared_late` (an own-credential declaration made after
174
+ * construction now names an `inheritEnv` entry; once per environment) and `config.read_floor_confinement_unavailable`. */
164
175
  onNotice?: (notice: EngineNotice) => void;
165
176
  /** Confine every start that carries a byte floor (`ExecutionEnvExecOptions.readFloor`) at the OS: `"os"` = on macOS,
166
177
  * when the seatbelt base applies here (probed once, now), each such start runs under `sandbox-exec -p <the floor's
167
178
  * profile>` and the environment declares `keepsReadFloor: true`; a floor the profile cannot express, or a profile that
168
- * does not apply, refuses that start (`spawn_error` / `spawn_failed`, naming why) — it never runs unconfined. On any
179
+ * does not apply, refuses that start (`sandbox_unavailable`, naming why) — it never runs unconfined. On any
169
180
  * other host, or when the probe does not apply, the environment declares `false` and says so once on `onNotice`
170
181
  * (`config.read_floor_confinement_unavailable`). Absent = no confinement (`false`). Any other value throws. */
171
182
  readFloorConfinement?: "os";
@@ -188,7 +199,7 @@ export declare class NodeExecutionEnv implements ExecutionEnv, BackgroundShellCa
188
199
  maxLines?: number;
189
200
  abortSignal?: AbortSignal;
190
201
  }): Promise<Result<string[], FileError>>;
191
- readBinaryFile(path: string, abortSignal?: AbortSignal): Promise<Result<Uint8Array, FileError>>;
202
+ readBinaryFile(path: string, abortSignal?: AbortSignal, maxBytes?: number): Promise<Result<Uint8Array, FileError>>;
192
203
  /** RB-221: whole-file replace via same-directory staging + fsync + rename.
193
204
  * The former single-step `writeFile` was an in-place O_TRUNC: an abort mid-write
194
205
  * (Esc during a large Write — ctx.signal reaches here directly), ENOSPC, or a crash left the target as
@@ -1,4 +1,5 @@
1
1
  import { spawn, spawnSync } from "node:child_process";
2
+ import { describeRejectedValue } from "../../core/tool-search-setting.js";
2
3
  import { createHash, randomUUID } from "node:crypto";
3
4
  import { closeSync, constants, createReadStream, mkdtempSync, openSync, readSync, rmSync, statSync, truncateSync, unlinkSync } from "node:fs";
4
5
  import { access, appendFile, lstat, mkdir, mkdtemp, open, readdir, readFile, readlink, rename, rm, stat, unlink, writeFile, } from "node:fs/promises";
@@ -7,7 +8,7 @@ import { basename, dirname, isAbsolute, join, sep } from "node:path";
7
8
  import { createInterface } from "node:readline";
8
9
  import { ExecutionError, err, FileError, ok, toError, } from "../harness/types.js";
9
10
  import { killProcessTree, shutdownDebug } from "./kill-tree.js";
10
- import { __resetSecretEnvScrubNoticeAnnouncement, announceSecretEnvScrub, hostChildEnv, hostChildEnvProblem, inheritedHostEnv } from "../../core/secret-env.js";
11
+ import { __resetSecretEnvScrubNoticeAnnouncement, announceSecretEnvScrub, declaredInheritEntry, hostChildEnv, hostChildEnvProblem, inheritedHostEnv } from "../../core/secret-env.js";
11
12
  import { deliverEngineNotice } from "../../core/engine-notice.js";
12
13
  import { confineShellStart, SANDBOX_EXEC, SEATBELT_PROBE_PROFILE } from "../../core/shell-confinement.js";
13
14
  import { physicalPathOfAsync } from "../../core/physical-path.js";
@@ -26,6 +27,7 @@ const NODE_ENV_CAPABILITIES = Object.freeze({
26
27
  externalContentTarget: false,
27
28
  io: true,
28
29
  keepsReadFloor: false,
30
+ commandSandbox: false,
29
31
  });
30
32
  const NODE_ENV_CONFINED_CAPABILITIES = Object.freeze({ ...NODE_ENV_CAPABILITIES, keepsReadFloor: true });
31
33
  function probeReadFloorConfinement() {
@@ -92,38 +94,61 @@ function fileKindFromStats(stats) {
92
94
  return undefined;
93
95
  }
94
96
  const HAS_POSIX_MODE_FACE = posixModeBitsMeaningful();
95
- async function readAllFrom(handle, max, aborted) {
96
- const overCap = (bytes) => new FileError("invalid", `The held file is over the ${max}-byte read cap (${bytes} bytes or more); it was not read`);
97
+ async function readUpTo(handle, size, limit, aborted) {
97
98
  const readAt = async (into, offset, length, position) => {
98
99
  const { bytesRead } = await handle.read(into, offset, length, position);
99
100
  if (aborted())
100
101
  throw new FileError("aborted", "Operation aborted");
101
102
  return bytesRead;
102
103
  };
103
- const size = Number((await handle.stat()).size);
104
- if (size > max)
105
- throw overCap(size);
106
104
  if (size > 0) {
107
- const out = Buffer.allocUnsafe(size);
105
+ const want = Math.min(size, limit);
106
+ const out = Buffer.allocUnsafe(want);
108
107
  let at = 0;
109
- while (at < size) {
110
- const bytesRead = await readAt(out, at, size - at, at);
108
+ while (at < want) {
109
+ const bytesRead = await readAt(out, at, want - at, at);
111
110
  if (bytesRead === 0)
112
111
  break;
113
112
  at += bytesRead;
114
113
  }
115
114
  return out.subarray(0, at);
116
115
  }
117
- const scratch = Buffer.allocUnsafe(Math.min(1 << 16, max + 1));
116
+ const scratch = Buffer.allocUnsafe(Math.min(1 << 16, limit));
118
117
  const chunks = [];
119
- for (let at = 0;;) {
120
- const bytesRead = await readAt(scratch, 0, Math.min(scratch.length, max + 1 - at), at);
118
+ let at = 0;
119
+ while (at < limit) {
120
+ const bytesRead = await readAt(scratch, 0, Math.min(scratch.length, limit - at), at);
121
121
  if (bytesRead === 0)
122
- return Buffer.concat(chunks, at);
123
- at += bytesRead;
124
- if (at > max)
125
- throw overCap(at);
122
+ break;
126
123
  chunks.push(Buffer.from(scratch.subarray(0, bytesRead)));
124
+ at += bytesRead;
125
+ }
126
+ return Buffer.concat(chunks, at);
127
+ }
128
+ async function readAllFrom(handle, max, aborted) {
129
+ const overCap = (bytes) => new FileError("invalid", `The held file is over the ${max}-byte read cap (${bytes} bytes or more); it was not read`);
130
+ const size = Number((await handle.stat()).size);
131
+ if (size > max)
132
+ throw overCap(size);
133
+ const got = await readUpTo(handle, size, max + 1, aborted);
134
+ if (got.length > max)
135
+ throw overCap(got.length);
136
+ return got;
137
+ }
138
+ async function readFirstBytes(resolved, maxBytes, abortSignal) {
139
+ let handle;
140
+ try {
141
+ handle = await open(resolved, "r");
142
+ const held = await handle.stat();
143
+ if (held.isDirectory())
144
+ return err(new FileError("is_directory", `EISDIR: illegal operation on a directory, read '${resolved}'`, resolved));
145
+ return ok(await readUpTo(handle, Number(held.size), maxBytes, () => abortResult(abortSignal, resolved) !== undefined));
146
+ }
147
+ catch (error) {
148
+ return err(toFileError(error, resolved));
149
+ }
150
+ finally {
151
+ await handle?.close().catch(() => { });
127
152
  }
128
153
  }
129
154
  function fileInfoFromStats(path, stats) {
@@ -428,6 +453,9 @@ function getShellEnv(inheritEnv, baseEnv, extraEnv, onScrub, onNotice) {
428
453
  }
429
454
  return env;
430
455
  }
456
+ function lateDeclarationRefusal(refusal) {
457
+ return `This execution environment (NodeExecutionEnv, its inheritEnv option) was built before the process-level declaration that now names one of its entries, so it refuses every shell child it would start: ${refusal}`;
458
+ }
431
459
  const EXIT_SETTLE_DRAIN_MS = 500;
432
460
  const EXEC_SPOOL_PUMP_MS = 200;
433
461
  const EXEC_SPOOL_ROTATE_BYTES = 8 * 1024 * 1024;
@@ -493,6 +521,22 @@ export class NodeExecutionEnv {
493
521
  return undefined;
494
522
  }
495
523
  }
524
+ spawnEnv(extraEnv) {
525
+ try {
526
+ return getShellEnv(this.inheritEnv, this.shellEnv, extraEnv, this.onSecretEnvScrub, this.onNotice);
527
+ }
528
+ catch (error) {
529
+ const entry = declaredInheritEntry(this.inheritEnv);
530
+ if (entry === undefined)
531
+ throw error;
532
+ const sentence = lateDeclarationRefusal(entry.refusal);
533
+ if (!this.lateDeclarationAnnounced) {
534
+ this.lateDeclarationAnnounced = true;
535
+ deliverEngineNotice(this.onNotice, { code: "config.inherit_env_declared_late", message: sentence, detail: { index: entry.index, name: entry.name } });
536
+ }
537
+ throw new Error(sentence);
538
+ }
539
+ }
496
540
  shellPath;
497
541
  shellEnv;
498
542
  inheritEnv;
@@ -502,12 +546,13 @@ export class NodeExecutionEnv {
502
546
  retainBackgroundProcesses;
503
547
  onSecretEnvScrub;
504
548
  onNotice;
549
+ lateDeclarationAnnounced = false;
505
550
  bgSpoolDir;
506
551
  spoolPairs = new Set();
507
552
  backgroundCapabilities;
508
553
  constructor(options) {
509
554
  if (options.readFloorConfinement !== undefined && options.readFloorConfinement !== "os") {
510
- 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.`);
555
+ throw new Error(`NodeExecutionEnv: readFloorConfinement must be "os" or absent (got ${describeRejectedValue(options.readFloorConfinement)}) — a confinement request that cannot be read is no request, so it refuses instead of reading as one side.`);
511
556
  }
512
557
  this.cwd = options.cwd;
513
558
  this.shellPath = options.shellPath;
@@ -571,13 +616,16 @@ export class NodeExecutionEnv {
571
616
  const named = parts.map((part, i) => (i === 0 ? part : part.replace(leading, ""))).filter((part) => part !== "");
572
617
  return ok(named.length === 0 ? "." : named.reduce((at, part) => anchorAtLinkDir(at, part, sep)));
573
618
  }
574
- async startOf(shell, command, floor) {
619
+ async startOf(shell, command, options) {
620
+ if (options?.sandbox !== undefined)
621
+ return { ok: false, refusedBy: "environment", reason: "this environment keeps no command sandbox (capabilities.commandSandbox is false) — the command was not started" };
622
+ const floor = options?.readFloor;
575
623
  const start = { command: shell.shell, args: [...shell.args, command] };
576
624
  if (!this.confined)
577
625
  return { ok: true, ...start };
578
626
  const confined = confineShellStart(start, floor);
579
627
  if (!confined.ok)
580
- 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` };
628
+ return { ok: false, refusedBy: "this_call", 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` };
581
629
  if (confined.profile === undefined)
582
630
  return { ok: true, ...confined.start };
583
631
  let applies = this.profileApplies.get(confined.profile);
@@ -589,7 +637,7 @@ export class NodeExecutionEnv {
589
637
  }
590
638
  const failed = await applies;
591
639
  if (failed !== undefined)
592
- return { ok: false, reason: `the read-deny table's confinement profile does not apply on this host (${failed}) — the command was not started` };
640
+ return { ok: false, refusedBy: "environment", reason: `the read-deny table's confinement profile does not apply on this host (${failed}) — the command was not started` };
593
641
  return { ok: true, ...confined.start };
594
642
  }
595
643
  async exec(command, options) {
@@ -601,9 +649,9 @@ export class NodeExecutionEnv {
601
649
  if (!shellConfig.ok) {
602
650
  return shellConfig;
603
651
  }
604
- const start = await this.startOf(shellConfig.value, command, options?.readFloor);
652
+ const start = await this.startOf(shellConfig.value, command, options);
605
653
  if (!start.ok)
606
- return err(new ExecutionError("spawn_error", start.reason));
654
+ return err(Object.assign(new ExecutionError("sandbox_unavailable", start.reason), { refusedBy: start.refusedBy }));
607
655
  return await new Promise((resolvePromise) => {
608
656
  const stdoutTail = new RollingTailBuffer();
609
657
  const stderrTail = new RollingTailBuffer();
@@ -705,7 +753,7 @@ export class NodeExecutionEnv {
705
753
  child = spawn(start.command, [...start.args], {
706
754
  cwd,
707
755
  detached: process.platform !== "win32",
708
- env: getShellEnv(this.inheritEnv, this.shellEnv, options?.env, this.onSecretEnvScrub, this.onNotice),
756
+ env: this.spawnEnv(options?.env),
709
757
  stdio: execSpoolFds ? ["ignore", execSpoolFds[0], execSpoolFds[1]] : ["ignore", "pipe", "pipe"],
710
758
  windowsHide: true,
711
759
  });
@@ -1008,12 +1056,17 @@ export class NodeExecutionEnv {
1008
1056
  stream?.destroy();
1009
1057
  }
1010
1058
  }
1011
- async readBinaryFile(path, abortSignal) {
1059
+ async readBinaryFile(path, abortSignal, maxBytes) {
1012
1060
  const resolved = resolvePath(this.cwd, path);
1061
+ if (maxBytes !== undefined && (!Number.isSafeInteger(maxBytes) || maxBytes < 0)) {
1062
+ return err(new FileError("invalid", `maxBytes must be a non-negative whole number of bytes (got ${typeof maxBytes === "number" ? String(maxBytes) : typeof maxBytes})`, resolved));
1063
+ }
1013
1064
  const aborted = abortResult(abortSignal, resolved);
1014
1065
  if (aborted) {
1015
1066
  return aborted;
1016
1067
  }
1068
+ if (maxBytes !== undefined)
1069
+ return readFirstBytes(resolved, maxBytes, abortSignal);
1017
1070
  try {
1018
1071
  return ok(await readFile(resolved, { signal: abortSignal }));
1019
1072
  }
@@ -1515,9 +1568,9 @@ export class NodeExecutionEnv {
1515
1568
  if (!shellConfig.ok) {
1516
1569
  return err(new BackgroundShellError("spawn_failed", shellConfig.error.message, shellConfig.error));
1517
1570
  }
1518
- const start = await this.startOf(shellConfig.value, command, options?.readFloor);
1571
+ const start = await this.startOf(shellConfig.value, command, options);
1519
1572
  if (!start.ok)
1520
- return err(new BackgroundShellError("spawn_failed", start.reason));
1573
+ return err(Object.assign(new BackgroundShellError("sandbox_unavailable", start.reason), { refusedBy: start.refusedBy }));
1521
1574
  let spool;
1522
1575
  let spoolFds;
1523
1576
  if (this.retainBackgroundProcesses || process.platform !== "win32") {
@@ -1541,7 +1594,7 @@ export class NodeExecutionEnv {
1541
1594
  child = spawn(start.command, [...start.args], {
1542
1595
  cwd: options?.cwd ? resolvePath(this.cwd, options.cwd) : this.cwd,
1543
1596
  detached: process.platform !== "win32",
1544
- env: getShellEnv(this.inheritEnv, this.shellEnv, options?.env, this.onSecretEnvScrub, this.onNotice),
1597
+ env: this.spawnEnv(options?.env),
1545
1598
  stdio: spoolFds ? ["ignore", spoolFds[0], spoolFds[1]] : ["ignore", "pipe", "pipe"],
1546
1599
  windowsHide: true,
1547
1600
  });
@@ -1,21 +1,32 @@
1
- import type { ActorAssertion, AssistantMessage, ImageContent, Model, TextContent, UserMessage, UserMessageAttachment } from "../llm/index.js";
2
- import { type ToolTurnRepair } from "../llm/index.js";
1
+ import type { ActorAssertion, AssistantMessage, ImageContent, Message, Model, TextContent, UserMessage, UserMessageAttachment } from "../llm/index.js";
2
+ import { type ChangedFilesNotice, type ToolTurnRepair } from "../llm/index.js";
3
3
  import { type RejectedImageRemoval } from "../llm/rejected-images.js";
4
- import { runToolCall, type ExecutedToolCallOutcome } from "../loop/agent-loop.js";
4
+ import { runToolCall, type ExecutedToolCallOutcome, type GivenAnswer } from "../loop/agent-loop.js";
5
5
  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 BundledAttachment } from "../../core/attachment-source.js";
9
10
  import { type InputAuthor } from "../../core/input-author.js";
10
11
  import type { CommittedFrameCarrier } from "../../core/frame-settlement.js";
11
- import type { AbortResult, AgentHarnessEvent, AgentHarnessEventResultMap, AgentHarnessOptions, AgentHarnessOwnEvent, AgentHarnessResources, AgentHarnessStreamOptions, ExecutionEnv, PendingSessionWrite, PromptTemplate, RowRaising, Skill } from "./types.js";
12
+ import type { AbortResult, AgentHarnessEvent, AgentHarnessEventResultMap, AgentHarnessOptions, AgentHarnessOwnEvent, AgentHarnessResources, AgentHarnessStreamOptions, BuildContextOptions, ExecutionEnv, PendingSessionWrite, PromptTemplate, RowRaising, Skill } from "./types.js";
12
13
  /** [c209-C] 收口 C1/C2 — engine-provenance metadata a caller can stamp on the user message it
13
14
  * mints (see the field docs on {@link UserMessage}). Threaded from `prompt`/`steer`/`followUp`/
14
15
  * `nextTurn` options into the persisted message so derived views (auto-mode window, compaction
15
16
  * serializer) work from METADATA, never from reminder-shape guessing. */
16
- /** Who aborted a turn seat: the bare user halt or the steer-now accelerator. A run-level abort reaches the seat
17
- * through the loop's composition listener and stamps nothing. */
18
- export type SeatCutSource = "halt" | "steer";
17
+ /** Who aborted a turn seat: the bare user halt, the steer-now accelerator, or an extension's `$.turn.abort`. A run-level
18
+ * abort reaches the seat through the loop's composition listener and stamps nothing. */
19
+ export type SeatCutSource = "halt" | "steer" | "extension";
20
+ /** What {@link AgentHarness.cutTurn} found: it cut the running turn; no turn is in flight (no seat — between turns, an
21
+ * answered turn, boundary housekeeping); or the turn is already ending (its seat was cut, or the run is unwinding). */
22
+ export type TurnCutVerdict = "cut" | "none" | "ending";
23
+ /** One seat's cut, as stamped before its abort dispatches: the source and, for an extension's cut, its registration and
24
+ * the turn number it asked to end. */
25
+ export interface SeatCut {
26
+ readonly source: SeatCutSource;
27
+ readonly by?: string;
28
+ readonly turn?: number;
29
+ }
19
30
  /** Who asked the clean-stop latch to end the run: the bare user halt, or a soft stop ({@link AgentHarness.requestStopAfterTurn}). */
20
31
  export type StopRequestSource = "halt" | "soft";
21
32
  /** The harness's STATEMENT of what a run's halt (and its stop siblings) did — the result assembly reads this in
@@ -23,13 +34,19 @@ export type StopRequestSource = "halt" | "soft";
23
34
  * Per prompt: every seat is cleared at the next `prompt()`, so a read after the prompt settled describes that run. */
24
35
  export interface HaltConsumption {
25
36
  /** The loop's interrupt settlement consumed the cut of the LAST-published seat, stamped with its aborter. Absent: no
26
- * seat cut was consumed on the final turn (never cut / a later seat cleared it / a run abort owned the ending / no stamp). */
37
+ * seat cut was consumed on the final turn (never cut / a later turn cleared it / a run abort owned the ending / no stamp). */
27
38
  readonly turnCut?: SeatCutSource;
39
+ /** The registration that made that cut — present with `turnCut: "extension"`. */
40
+ readonly turnCutBy?: string;
28
41
  /** The first boundary consult that stopped a non-unwinding loop, with the latch's sources at that instant. */
29
42
  readonly boundaryStop?: {
30
43
  readonly face: "pre_turn" | "post_turn";
31
44
  readonly sources: ReadonlyArray<StopRequestSource>;
32
45
  };
46
+ /** The cuts this run ACCEPTED ({@link AgentHarness.cutTurn} answered `"cut"`) that no settlement took as its turn's
47
+ * cause — the turn had already settled otherwise (its request's end was delivered first), or the run's own ending won.
48
+ * In acceptance order; absent when every accepted cut was consumed. */
49
+ readonly unconsumedCuts?: ReadonlyArray<SeatCut>;
33
50
  }
34
51
  /** `prompt()` option: settle the transcript's trailing UNANSWERED tool batch through the loop's own batch pipeline
35
52
  * BEFORE the prompt is delivered (a resumed run whose suspended batch still holds unanswered calls). `halt` settles
@@ -58,6 +75,34 @@ export interface PromptTrailing {
58
75
  export interface PromptEndsAwaitingUser {
59
76
  endsAwaitingUser?: true;
60
77
  }
78
+ /** `prompt()` option: the prompt's own text is not the turn's input (the engine's frames riding a wake) — the turn opens on the
79
+ * input queued for it, and a blank text under this declaration mints no message at all. Queued input is read once the turn-open
80
+ * hooks have run (they may hand input over): the next-turn, steer and follow-up lanes and what the hooks return. With none, the
81
+ * prompt is refused with {@link NothingQueuedError} before the run starts. A prompt without the declaration is its own message,
82
+ * blank or not. */
83
+ export interface PromptOpensOnQueuedInput {
84
+ opensOnQueuedInput?: true;
85
+ }
86
+ /** `prompt()` / `followUp()` option: the answer to the turn the input opens is already given (an extension's `{ reply }`) —
87
+ * that turn calls no model; see {@link GivenAnswer}. On `followUp`, the frame drains alone at the would-otherwise-stop seat
88
+ * and its turn is the answer. */
89
+ export interface PromptGivenAnswer {
90
+ givenAnswer?: Pick<GivenAnswer, "text" | "by">;
91
+ }
92
+ /** One input whose answer is already given (a parked `later` steer an extension answered before the pause): the frame it
93
+ * enters as (`text` with its `provenance`, whose `parkRecord` is what a later pause parks it as and what the frame's
94
+ * consumption is reported by, {@link AgentHarness.onUserInputConsumed}), and the answer. */
95
+ export interface AnsweredInputSeed {
96
+ readonly text: string;
97
+ readonly provenance: UserMessageProvenance;
98
+ readonly answer: Pick<GivenAnswer, "text" | "by">;
99
+ }
100
+ /** `prompt()` option: inputs whose answers are already given ({@link AnsweredInputSeed}). Each enters the follow-up lane when
101
+ * the prompt's own message commits, as an answered follow-up does ({@link PromptGivenAnswer}): it drains alone at the
102
+ * would-otherwise-stop seat, after the prompt's work, and its turn is the answer. */
103
+ export interface PromptAnsweredInputs {
104
+ answeredInputs?: readonly AnsweredInputSeed[];
105
+ }
61
106
  export interface UserMessageProvenance {
62
107
  /** Exact char length of the engine-prepended prefix on `text` (first-frame reminders etc.).
63
108
  * Sugar for the single segment `[0, chars)` — when `engineSegments` is also supplied, segments win. */
@@ -69,6 +114,10 @@ export interface UserMessageProvenance {
69
114
  /** The ENTIRE message is engine-minted guidance (nudges/finalize/attachment bundles), not user speech.
70
115
  * [c209-C] R4: mutually exclusive with `provenance` — on a double-stamp, `provenance` wins (see below). */
71
116
  engineMinted?: true;
117
+ /** The attachments an engine-minted bundle message carries ({@link UserMessage.attachments}) — meaningful only WITH
118
+ * `engineMinted` (a person's input has no bundle): on any other mint it is dropped, and a list that is not canonical (empty,
119
+ * an unknown source, a length that is not a count) is dropped whole. Threaded as a snapshot copy. */
120
+ attachments?: ReadonlyArray<BundledAttachment>;
72
121
  /** [c209-C] R3: engine-injected note whose content must stay VISIBLE in derived views (diagnostics,
73
122
  * task notifications, steering, recall) but never under user authority — see UserMessage.provenance. */
74
123
  provenance?: "engine-note";
@@ -84,6 +133,9 @@ export interface UserMessageProvenance {
84
133
  * ({@link UserMessage.engineNoteKey}) so a reader of the TRANSCRIPT alone can join an entry back
85
134
  * to its frame. Rides only WITH `provenance:"engine-note"`. */
86
135
  engineNoteKey?: string;
136
+ /** The changed-files notices `text` carries ({@link UserMessage.changedFilesNotices}); persisted only when well formed
137
+ * against `text` (a malformed record is dropped at the mint, so the notices are carried as written). */
138
+ changedFilesNotices?: ReadonlyArray<ChangedFilesNotice>;
87
139
  /** RB-30 terminal fix — an OPAQUE payload the engine rides on this queued message (the runner's
88
140
  * task-notification frame). Never serialized, never interpreted by the harness: if the message is
89
141
  * still undrained at agent_end, the payload is handed back through `onUndrainedEngineNotes` so
@@ -95,6 +147,14 @@ export interface UserMessageProvenance {
95
147
  * projection point `projectHumanInput`) BEFORE the frame wrapping — the harness never rewrites
96
148
  * text, so annotation stays adjacent to the frame it attributes. */
97
149
  actor?: ActorAssertion;
150
+ /** This message carries a person's input — and, when it is the one input a `human_input` frame accounts for, that frame's key
151
+ * (`inputId`; a resume's continuation merging several parked steers is a person's input with no single key). A sidecar entry judged at
152
+ * the mint (a key that is given and hollow is refused), never a message field: it does not reach the transcript or the model. Read back,
153
+ * once the message is committed, by `userRowSourceOf` — which is how the commit frame says what the row is. Absent on every message that
154
+ * is not a person's input (an engine note, an attachment frame). */
155
+ input?: {
156
+ inputId?: string;
157
+ };
98
158
  /** What brought the one input this message carries ({@link UserMessage.runOrigin}) — the caller passes it with a message
99
159
  * that carries a single input only. Threaded onto the message when it is a member of the closed set; anything else is
100
160
  * omitted at the mint. */
@@ -125,6 +185,15 @@ export interface UserMessageProvenance {
125
185
  * frames still gets the cap refusal (nothing displaceable). */
126
186
  capPreferred?: true;
127
187
  }
188
+ /**
189
+ * How a turn's context is built from the session for `model` — the view every request of the turn starts from.
190
+ * Window-aware: declares the model's request window so the session's read-side clamp can re-budget the compaction
191
+ * summary's retained invoked-skills area against it (a session compacted under a large-window model must stay
192
+ * window-safe when THIS model is smaller). Physical request window (`contextTokens ?? contextWindow`) — the same
193
+ * coordinate the request hard-stop guards; an unknown/zero window disarms the clamp (legacy rendering). The one reading:
194
+ * the turn state and a caller that prices the next request before it is built both read the session through it.
195
+ */
196
+ export declare function turnContextOptions(model: Model): BuildContextOptions;
128
197
  /**
129
198
  * Harness-level recovery wiring (design/118 ④b/⑤). The loop's prompt-too-long seam wants a
130
199
  * replacement TRANSCRIPT; at the harness level the correct policy is a SESSION-persisted reduction
@@ -198,10 +267,13 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
198
267
  /** The seat the loop published LAST — retract does not clear it, only the next publish replaces it (a fresh controller
199
268
  * per turn, so identity carries the generation); the loop's cut-consumption report is accepted for THIS seat only. */
200
269
  private lastPublishedSeat?;
201
- private readonly seatCutSources;
270
+ private readonly seatCuts;
202
271
  private endedOnPriorAnswer;
203
272
  private promptReceipt?;
204
273
  private turnCutConsumed?;
274
+ private turnOpenedAt;
275
+ private acceptedCuts;
276
+ private readonly consumedCuts;
205
277
  private readonly committedEntryIds;
206
278
  private readonly answerSources;
207
279
  /** backlog #389 — one-way latch set by {@link abort}. Read by `drainQueuedMessages`: no boundary may
@@ -239,6 +311,9 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
239
311
  * with every request view that needed one (the transcript is never rewritten, so a broken turn is repaired, and
240
312
  * reported, on each request; the sink owns its dedup). Advisory: a throwing sink never breaks the request. */
241
313
  onToolTurnRepaired?: (repairs: readonly ToolTurnRepair[]) => void;
314
+ /** Runner-set projection of the request's copies of file contents, applied at the provider boundary after the tool-turn law and before the metadata strip (it reads the frames'
315
+ * delivery records the strip removes). `folds` = the results the law folded and the recorded results each folds. Absent ⇒ the view is sent as the law leaves it. */
316
+ projectRequestCopies?: (messages: Message[], folds: ReadonlyMap<Message, readonly Message[]>) => Message[];
242
317
  /** Runner-set sink for the images a provider refused in THIS run ({@link removeRefusedRequestParts}) — a refusal recorded
243
318
  * before the run began is not reported. Every request re-reads the transcript, so the sink owns its dedup (by
244
319
  * `refusalAt`). Advisory: a throwing sink never breaks the request. */
@@ -315,6 +390,7 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
315
390
  /** The request view of `messages` under the provider's image refusals they hold ({@link removeRefusedRequestParts}), and
316
391
  * the removals this run met handed to {@link onImagesRemoved}. */
317
392
  private imageRefusalView;
393
+ /** The provider-bound view: the tool-turn law, then the request's copy projection over what the law leaves. */
318
394
  private holdToolTurnLaw;
319
395
  /** RB-30 R2 belt-and-braces: runner-callable idempotent recovery for exit paths that reach
320
396
  * neither agent_end nor abort() (a pre-prompt throw after prepare). Swept entries are removed,
@@ -359,6 +435,8 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
359
435
  private systemPrompt;
360
436
  /** S4: physical system blocks (static per leg, additive — see AgentHarnessOptions.systemBlocks). */
361
437
  private systemBlocks;
438
+ /** The leg's engine-text locale (see AgentHarnessOptions.promptLocale). */
439
+ private readonly promptLocale;
362
440
  private streamOptions;
363
441
  private getApiKeyAndHeaders?;
364
442
  private runtime?;
@@ -468,19 +546,23 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
468
546
  private handleAgentEvent;
469
547
  private emitRunFailure;
470
548
  private executeTurn;
471
- /** Returns the run's final assistant message — or `undefined` on exactly one arm (#504): a bare
472
- * user halt ({@link halt}) stopped the run before any assistant output existed. Every other
473
- * zero-assistant ending still throws (see the executeTurn tail). */
549
+ /** Returns the run's final assistant message — or `undefined` when the run ended before any assistant output existed
550
+ * for a reason that is not a defect: a bare user halt ({@link halt}), or a turn cut ({@link cutTurn}) that settled the
551
+ * last turn before it said anything. Every other zero-assistant ending still throws (see the executeTurn tail). */
474
552
  prompt(text: string, options?: {
475
553
  images?: ImageContent[];
476
554
  settleUnansweredToolCalls?: TrailingToolBatchOptions;
477
555
  onCommitted?: PromptCommittedCallback;
478
- } & UserMessageProvenance & PromptTrailing & PromptEndsAwaitingUser): Promise<AssistantMessage | undefined>;
556
+ } & UserMessageProvenance & PromptTrailing & PromptEndsAwaitingUser & PromptGivenAnswer & PromptAnsweredInputs & PromptOpensOnQueuedInput): Promise<AssistantMessage | undefined>;
479
557
  /** R2-③: an empty/whitespace-only injection with no images carries ZERO information — it
480
558
  * must not mint a user frame (strict endpoints reject empty user content, and an empty follow-up would
481
559
  * pointlessly extend the run by one turn). No-op, not a throw: injection callers are fire-and-
482
560
  * forget lanes (wakeups, reminders) and a shell bug upstream must not crash the run. */
483
561
  private static emptyInjection;
562
+ /** The one mint of a queued frame: the user message and its sidecars, each judged from the options at the mint (never a
563
+ * message field). Shared by the enqueue below and a prompt's answered inputs, so a frame means the same whichever way it
564
+ * reached a lane. */
565
+ private mintInjection;
484
566
  /** REF-B6 — the ONE injection enqueue behind steer/followUp/nextTurn: the R2-③ empty-injection
485
567
  * short circuit, the user frame, the RB-30 engine-payload SIDECAR (a WeakMap entry, never a message field —
486
568
  * pre-prompt exits recover these too), the queue push, and the broadcast. All three lanes ship in ONE
@@ -503,9 +585,14 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
503
585
  steer(text: string, options?: {
504
586
  images?: ImageContent[];
505
587
  } & UserMessageProvenance): Promise<UserMessage | undefined>;
588
+ /** An engine-minted frame that carries its own delivery record (an attachment frame the engine loads mid-run) on the
589
+ * steer lane: an engine advisory, so it rides the next request the run already owes and never opens one; it is
590
+ * delivered when it is in the transcript, where its record's receipt is reported like a prompt's trailing frame's. */
591
+ steerFrame(seed: TrailingMessageSeed): Promise<UserMessage | undefined>;
592
+ /** `givenAnswer` ({@link PromptGivenAnswer}): the frame's turn is that answer — the frame drains alone, and no model is asked. */
506
593
  followUp(text: string, options?: {
507
594
  images?: ImageContent[];
508
- } & UserMessageProvenance): Promise<void>;
595
+ } & UserMessageProvenance & PromptGivenAnswer): Promise<void>;
509
596
  /**
510
597
  * design/373 §3.4 — force the running turn's boundary FOR a queued immediate-class frame:
511
598
  * abort the CURRENT main turn (provider stream + tool batch — never the run, never boundary
@@ -514,14 +601,14 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
514
601
  * happened AND none was needed — the frame is already consumed or already rides the imminent
515
602
  * boundary — so delivery semantics are exactly the non-interrupting ones either way.
516
603
  *
517
- * Guards, in order:
518
- * - an unwinding run (`abort()` latched) owns its ending — never contest it;
519
- * - CONSUMPTION guard (r4/R3-1): the frame must still sit in the steer queue. Drained/consumed ⇒
604
+ * Guards:
605
+ * - CONSUMPTION guard: the frame must still sit in the steer queue. Drained/consumed ⇒
520
606
  * it is already part of a turn's input — aborting THAT turn would cut the very delivery this
521
607
  * verb exists to speed up. Same-tick check-then-abort (single-threaded: no window);
522
- * - seat liveness: no published turn (idle tail / between turns / boundary housekeeping) ⇒ no-op,
523
- * the frame rides the next boundary; an already-fired seat ⇒ idempotent no-op (one boundary per
524
- * turn — later immediates join the same boundary batch).
608
+ * - then {@link cutTurn}'s own: an unwinding run owns its ending; no published turn (idle tail /
609
+ * between turns / boundary housekeeping) ⇒ no-op, the frame rides the next boundary; an
610
+ * already-fired seat ⇒ idempotent no-op (one boundary per turn — later immediates join the same
611
+ * boundary batch).
525
612
  */
526
613
  interruptTurn(frame: AgentMessage): boolean;
527
614
  /**
@@ -572,11 +659,38 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
572
659
  turnCut: boolean;
573
660
  accepted: boolean;
574
661
  };
575
- /** The ONE seat-cut dispatch behind both verbs: stamp the aborter FIRST (a seat is never aborted twice), then abort.
576
- * A run abort fired INSIDE this dispatch (a listener on the cut signal tearing the run down) was fired BY the cut —
577
- * the loop takes the run-terminal path and never reports that settlement, so the consumption is recorded here, the
578
- * only point that can see the causation (synchronous, single-threaded). A LATER abort is the run's own ending. */
579
- private cutSeat;
662
+ /**
663
+ * The ONE turn cut: the halt, the steer-now accelerator and an extension's `$.turn.abort` all end the running turn
664
+ * here. What differs between them is the row their cut settles by ({@link TURN_CUT_SETTLEMENTS}) and what each caller
665
+ * does around the cut (the halt's stop latch, the steer's frame guard) — nothing else. Guards: {@link turnSeatState}'s.
666
+ * The aborter is stamped FIRST (a seat is never aborted twice; its first aborter is its source), then the seat aborted.
667
+ * A run abort fired INSIDE this dispatch (a listener on the cut signal tearing the run down) was fired BY the cut — the
668
+ * loop takes the run-terminal path and never reports that settlement, so the consumption is recorded here, the only
669
+ * point that can see the causation (synchronous, single-threaded). A LATER abort is the run's own ending.
670
+ * Every cut answered `"cut"` is ACCEPTED; one that no settlement then takes as its turn's cause is reported by
671
+ * {@link haltConsumption} (`unconsumedCuts`). `extension` names an extension's cut: its registration and the turn it ended.
672
+ */
673
+ cutTurn(source: SeatCutSource, extension?: {
674
+ readonly by: string;
675
+ readonly turn: number;
676
+ }): TurnCutVerdict;
677
+ /** The cut that settled the last-published seat's turn: the last turn's record, and the run's ledger of consumed cuts. */
678
+ private consumeTurnCut;
679
+ /**
680
+ * What a cut would find now, read without cutting: a turn in flight to cut (`"live"`); none (`"none"` — no published
681
+ * seat: between turns, an answered turn, boundary housekeeping); or one already ending (`"ending"` — an unwinding run
682
+ * owns its ending, and a cut seat has had its one boundary). Synchronous: a {@link cutTurn} in the same synchronous step
683
+ * finds what this found.
684
+ */
685
+ turnSeatState(): "live" | Exclude<TurnCutVerdict, "cut">;
686
+ /**
687
+ * Does the cut behind `signal` move an armed running command into the background instead of ending it — its source's
688
+ * row ({@link TURN_CUT_SETTLEMENTS})? `signal` is the one a running tool call holds: the seat this harness published
689
+ * last, whose cut is stamped BEFORE its abort dispatches, so an abort listener reads the source of the very cut it is
690
+ * hearing. Any other signal, and a seat no named source cut (a run-level abort reaching it), answer no.
691
+ */
692
+ cutMovesArmedCommandAside(signal: AbortSignal): boolean;
693
+ private seatToCut;
580
694
  /** The entry ids of the committed messages an answer `prompt()` returned was read from, in conversation order: the
581
695
  * final assistant message, or every member of the continuation chain merged into it (members never appended — an
582
696
  * empty failure — have no id). Bound to the returned object, so a prompt that rejects, or one overlapping another,
@@ -594,8 +708,10 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
594
708
  * signal always wins (the loop's cut arms' rule): an unwinding run ends FOR its abort — the latch's true answer is
595
709
  * incidental (the next turn's abort guard would have exited anyway), so the attribution is withheld, not the exit. */
596
710
  private consultStopLatch;
597
- /** The loop's report that a seat's cut settled its turn (the loop-config seam). Identity is checked against the
598
- * LAST-published seat, never the live one (the arms report around retraction); any other seat is refused loudly. */
711
+ /** The loop's report that a seat's cut settled its turn (the loop-config seam), answered with the row the cut settles
712
+ * by — its source's ({@link TURN_CUT_SETTLEMENTS}); an unstamped cut answers none (the loop's own row). Identity is
713
+ * checked against the LAST-published seat, never the live one (the arms report around retraction); any other seat is
714
+ * refused loudly. */
599
715
  private noteTurnCutConsumed;
600
716
  /**
601
717
  * design/373 §3.3 (the final-commit-point double check) — how many queued injection frames a