@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
@@ -1,17 +1,24 @@
1
- import { createAssistantMessageEventStream, ensureToolTurnInvariants, findToolByName, snapshotActorAssertion, stripEngineMetadata, userAttachmentOf } from "../llm/index.js";
1
+ import { changedFilesNoticesOf, createAssistantMessageEventStream, ensureToolTurnInvariants, findToolByName, snapshotActorAssertion, stripEngineMetadata, userAttachmentOf } from "../llm/index.js";
2
2
  import { imageRefusalAt, isImageRefusal, removeRefusedRequestParts } from "../llm/rejected-images.js";
3
- import { finalizeToolOutcome, findUnansweredToolBatch, isBatchSafeToolCall, runAgentLoop, runToolCall } from "../loop/agent-loop.js";
3
+ import { finalizeToolOutcome, findUnansweredToolBatch, isBatchSafeToolCall, runAgentLoop, runToolCall, TURN_ENDED_TOOL_TEXT, TURN_INTERRUPTED_TOOL_TEXT } from "../loop/agent-loop.js";
4
4
  import { resolveAgentCoreStreamFn } from "../loop/runtime-deps.js";
5
5
  import { normalizeEngineSegments } from "../../core/untrusted-text.js";
6
6
  import { isCredentialHeaderName } from "../../core/secret-env.js";
7
7
  import { isRunOrigin } from "../../core/run-origin.js";
8
- import { countsAsOperator, readInputAuthor } from "../../core/input-author.js";
8
+ import { readBundledAttachments } from "../../core/attachment-source.js";
9
+ import { countsAsOperator, isBlankInput, readInputAuthor } from "../../core/input-author.js";
10
+ import { noteUserInput } from "../../core/user-row-origin.js";
9
11
  import { isProviderEchoShape } from "../../brain/errors.js";
10
12
  import { convertToLlm } from "./messages.js";
11
13
  import { readMember, thrownText } from "../../core/thrown-value.js";
12
14
  import { remoteWords } from "../../core/protocol-http-auth.js";
13
- import { AgentHarnessError, CompactionError, SessionError, SYNTHETIC_MESSAGE_MODEL, toError, } from "./types.js";
15
+ import { AgentHarnessError, CompactionError, NothingQueuedError, SessionError, SYNTHETIC_MESSAGE_MODEL, toError, } from "./types.js";
14
16
  const API_FAILURE_RECORD_MAX_CHARS = 2000;
17
+ const TURN_CUT_SETTLEMENTS = Object.freeze({
18
+ halt: Object.freeze({ neverStartedText: TURN_INTERRUPTED_TOOL_TEXT, marker: true, movesArmedCommandAside: false }),
19
+ steer: Object.freeze({ neverStartedText: TURN_INTERRUPTED_TOOL_TEXT, marker: false, movesArmedCommandAside: false }),
20
+ extension: Object.freeze({ neverStartedText: TURN_ENDED_TOOL_TEXT, marker: false, movesArmedCommandAside: true }),
21
+ });
15
22
  function createUserMessage(text, images, provenance) {
16
23
  const content = text.length > 0 ? [{ type: "text", text }] : [];
17
24
  if (images) {
@@ -19,7 +26,7 @@ function createUserMessage(text, images, provenance) {
19
26
  }
20
27
  const engineNote = provenance?.provenance === "engine-note";
21
28
  const segments = normalizeEngineSegments(text, provenance?.engineSegments);
22
- return {
29
+ const message = {
23
30
  role: "user",
24
31
  content,
25
32
  timestamp: Date.now(),
@@ -32,6 +39,7 @@ function createUserMessage(text, images, provenance) {
32
39
  ? { enginePrefixChars: provenance.enginePrefixChars }
33
40
  : {}),
34
41
  ...(provenance?.engineMinted === true && !engineNote ? { engineMinted: true } : {}),
42
+ ...((bundled) => (provenance?.engineMinted === true && !engineNote && bundled !== undefined ? { attachments: bundled } : {}))(readBundledAttachments(provenance?.attachments, text.length)),
35
43
  ...(engineNote ? { provenance: "engine-note" } : {}),
36
44
  ...(engineNote && typeof provenance?.engineNoteKey === "string" && provenance.engineNoteKey.length > 0 ? { engineNoteKey: provenance.engineNoteKey } : {}),
37
45
  ...(provenance?.actor !== undefined &&
@@ -42,6 +50,19 @@ function createUserMessage(text, images, provenance) {
42
50
  : {}),
43
51
  ...((runOrigin) => (isRunOrigin(runOrigin) ? { runOrigin } : {}))(provenance?.runOrigin),
44
52
  };
53
+ const notices = changedFilesNoticesOf({ role: "user", content, changedFilesNotices: provenance?.changedFilesNotices });
54
+ if (notices !== undefined)
55
+ message.changedFilesNotices = notices;
56
+ if (provenance?.input !== undefined)
57
+ noteUserInput(message, provenance.input.inputId);
58
+ return message;
59
+ }
60
+ export function turnContextOptions(model) {
61
+ const windowTokens = model.contextTokens ?? model.contextWindow;
62
+ return {
63
+ ...(typeof windowTokens === "number" && windowTokens > 0 ? { windowTokens } : {}),
64
+ ...(model.charsPerToken !== undefined ? { charsPerToken: model.charsPerToken } : {}),
65
+ };
45
66
  }
46
67
  function createTrailingMessage(seed) {
47
68
  return { role: "user", content: [...seed.content], timestamp: Date.now(), provenance: "engine-note", attachment: seed.attachment };
@@ -56,6 +77,7 @@ function isEngineAdvisory(m) {
56
77
  return engineAuthoredInjections.has(m) && !engineNotePayloads.has(m);
57
78
  }
58
79
  const userInputParkRecords = new WeakMap();
80
+ const givenAnswerFrames = new WeakMap();
59
81
  const drainedFromLane = new WeakMap();
60
82
  const immediateClassInjections = new WeakSet();
61
83
  const capPreferredInjections = new WeakSet();
@@ -145,9 +167,6 @@ function applyStreamOptionsPatch(base, patch) {
145
167
  if (Object.hasOwn(patch, "maxRetryDelayMs")) {
146
168
  result.maxRetryDelayMs = patch.maxRetryDelayMs;
147
169
  }
148
- if (Object.hasOwn(patch, "cacheRetention")) {
149
- result.cacheRetention = patch.cacheRetention;
150
- }
151
170
  if (Object.hasOwn(patch, "headers")) {
152
171
  if (patch.headers === undefined) {
153
172
  result.headers = undefined;
@@ -218,10 +237,13 @@ export class AgentHarness {
218
237
  }
219
238
  boundaryStopConsumed;
220
239
  lastPublishedSeat;
221
- seatCutSources = new WeakMap();
240
+ seatCuts = new WeakMap();
222
241
  endedOnPriorAnswer = false;
223
242
  promptReceipt;
224
243
  turnCutConsumed;
244
+ turnOpenedAt = 0;
245
+ acceptedCuts = [];
246
+ consumedCuts = new Set();
225
247
  committedEntryIds = new WeakMap();
226
248
  answerSources = new WeakMap();
227
249
  aborting = false;
@@ -236,6 +258,7 @@ export class AgentHarness {
236
258
  thinkingLevel;
237
259
  onUndrainedEngineNotes;
238
260
  onToolTurnRepaired;
261
+ projectRequestCopies;
239
262
  onImagesRemoved;
240
263
  onToolSchemaRefused;
241
264
  priorImageRefusals;
@@ -267,7 +290,7 @@ export class AgentHarness {
267
290
  catch {
268
291
  }
269
292
  }
270
- return view.messages;
293
+ return this.projectRequestCopies?.(view.messages, view.folds) ?? view.messages;
271
294
  }
272
295
  recoverUndrainedEngineNotes() {
273
296
  this.sweepUndrainedEngineNotes([this.drainedPendingInjection, this.nextTurnQueue, this.steerQueue, this.followUpQueue]);
@@ -334,6 +357,7 @@ export class AgentHarness {
334
357
  }
335
358
  systemPrompt;
336
359
  systemBlocks;
360
+ promptLocale;
337
361
  streamOptions;
338
362
  getApiKeyAndHeaders;
339
363
  runtime;
@@ -370,6 +394,7 @@ export class AgentHarness {
370
394
  this.streamOptions = cloneStreamOptions(options.streamOptions);
371
395
  this.systemPrompt = options.systemPrompt;
372
396
  this.systemBlocks = options.systemBlocks;
397
+ this.promptLocale = options.promptLocale;
373
398
  this.getApiKeyAndHeaders = options.getApiKeyAndHeaders;
374
399
  this.runtime = options.runtime;
375
400
  for (const tool of options.tools ?? []) {
@@ -394,6 +419,7 @@ export class AgentHarness {
394
419
  ...(options.imageProcessor !== undefined ? { imageProcessor: options.imageProcessor } : {}),
395
420
  ...(options.onToolMediaRefused !== undefined ? { onToolMediaRefused: options.onToolMediaRefused } : {}),
396
421
  ...(options.onImageUnprocessed !== undefined ? { onImageUnprocessed: options.onImageUnprocessed } : {}),
422
+ ...(options.toolResultBytes !== undefined ? { toolResultBytes: options.toolResultBytes } : {}),
397
423
  };
398
424
  this.resilience = options.resilience;
399
425
  this.maxToolConcurrency = options.maxToolConcurrency;
@@ -508,11 +534,7 @@ export class AgentHarness {
508
534
  };
509
535
  }
510
536
  async createTurnState() {
511
- const windowTokens = this.model.contextTokens ?? this.model.contextWindow;
512
- const context = await this.session.buildContext({
513
- ...(typeof windowTokens === "number" && windowTokens > 0 ? { windowTokens } : {}),
514
- ...(this.model.charsPerToken !== undefined ? { charsPerToken: this.model.charsPerToken } : {}),
515
- });
537
+ const context = await this.session.buildContext(turnContextOptions(this.model));
516
538
  const resources = this.getResources();
517
539
  const sessionMetadata = await this.session.getMetadata();
518
540
  const tools = [...this.tools.values()];
@@ -556,6 +578,7 @@ export class AgentHarness {
556
578
  ...(blocksSafe ? { systemBlocks: this.systemBlocks } : {}),
557
579
  messages: turnState.messages.slice(),
558
580
  tools: turnState.activeTools.slice(),
581
+ ...(this.promptLocale !== undefined ? { promptLocale: this.promptLocale } : {}),
559
582
  };
560
583
  }
561
584
  createStreamFn(getTurnState) {
@@ -588,7 +611,6 @@ export class AgentHarness {
588
611
  }
589
612
  return resolveAgentCoreStreamFn(this.runtime)(model, context, {
590
613
  ...(auth?.apiKey !== undefined ? { apiKey: auth.apiKey } : {}),
591
- cacheRetention: requestOptions.cacheRetention,
592
614
  headers: requestOptions.headers,
593
615
  maxRetries: requestOptions.maxRetries,
594
616
  maxRetryDelayMs: requestOptions.maxRetryDelayMs,
@@ -622,17 +644,19 @@ export class AgentHarness {
622
644
  async drainQueuedMessages(queue, mode, continuing) {
623
645
  if (this.aborting)
624
646
  return [];
625
- const messages = [];
647
+ const head = queue.findIndex((m) => this.isDrainable(m, continuing) && !isEngineAdvisory(m));
648
+ const alone = head !== -1 && givenAnswerFrames.has(queue[head]);
649
+ const messages = alone ? queue.splice(head, 1) : [];
626
650
  let first;
627
651
  let selecting = true;
628
- for (let i = 0; i < queue.length; i++) {
652
+ for (let i = 0; i < queue.length && !alone; i++) {
629
653
  const m = queue[i];
630
654
  if (!this.isDrainable(m, continuing))
631
655
  continue;
632
656
  if (!isEngineAdvisory(m)) {
633
657
  if (!selecting)
634
658
  continue;
635
- if (mode !== "all" && first !== undefined && !(engineNotePayloads.has(first) && engineNotePayloads.has(m))) {
659
+ if (first !== undefined && (givenAnswerFrames.has(m) || (mode !== "all" && !(engineNotePayloads.has(first) && engineNotePayloads.has(m))))) {
636
660
  selecting = false;
637
661
  continue;
638
662
  }
@@ -720,7 +744,7 @@ export class AgentHarness {
720
744
  ...(this.streamingToolExecution === true && (this.getHandlers("tool_call")?.size ?? 0) === 0
721
745
  ? { streamingToolExecution: true }
722
746
  : {}),
723
- convertToLlm: (messages) => this.holdToolTurnLaw(stripEngineMetadata(convertToLlm(messages))),
747
+ convertToLlm: (messages) => stripEngineMetadata(this.holdToolTurnLaw(convertToLlm(messages))),
724
748
  shouldStopAfterTurn: () => this.consultStopLatch("post_turn"),
725
749
  shouldHaltBeforeTurn: () => this.consultStopLatch("pre_turn"),
726
750
  transformContext: async (messages, signal) => {
@@ -756,9 +780,9 @@ export class AgentHarness {
756
780
  return result;
757
781
  },
758
782
  afterToolCall: ({ toolCall, args, result, isError }) => this.afterToolCallHook(toolCall, args, result, isError),
759
- prepareNextTurn: async ({ continues }) => {
783
+ prepareNextTurn: async ({ continues, message }) => {
760
784
  await this.flushPendingSessionWrites();
761
- await this.emitHook({ type: "turn_boundary", model: this.model, continues });
785
+ await this.emitHook({ type: "turn_boundary", model: this.model, continues, message });
762
786
  const nextTurnState = await this.createTurnState();
763
787
  setTurnState(nextTurnState);
764
788
  return {
@@ -769,13 +793,15 @@ export class AgentHarness {
769
793
  },
770
794
  getSteeringMessages: async (continuing) => this.drainQueuedMessages(this.steerQueue, this.steeringQueueMode, continuing),
771
795
  publishTurnInterruptSeat: (seat) => {
772
- if (seat !== undefined) {
796
+ if (seat !== undefined)
773
797
  this.lastPublishedSeat = seat;
774
- this.turnCutConsumed = undefined;
775
- }
776
798
  this.turnInterruptSeat = seat;
777
799
  },
778
800
  noteTurnCutConsumed: (seat) => this.noteTurnCutConsumed(seat),
801
+ noteTurnOpened: (opensAt) => {
802
+ this.turnCutConsumed = undefined;
803
+ this.turnOpenedAt = opensAt;
804
+ },
779
805
  recheckImmediateInjections: async (pending) => this.absorbImmediateSteering(pending),
780
806
  pendingInjectionCount: () => this.pendingInjectionCount(),
781
807
  getFollowUpMessages: async () => {
@@ -784,6 +810,7 @@ export class AgentHarness {
784
810
  return queued;
785
811
  return this.stopGate ? await this.stopGate() : queued;
786
812
  },
813
+ answerOf: (message) => givenAnswerFrames.get(message),
787
814
  recovery: {
788
815
  get truncatedOutput() {
789
816
  return self.loopRecovery?.truncatedOutput;
@@ -976,8 +1003,15 @@ export class AgentHarness {
976
1003
  }
977
1004
  async executeTurn(turnState, text, options, abortController) {
978
1005
  let activeTurnState = turnState;
979
- const userMessage = createUserMessage(text, options?.images, options);
980
- this.promptReceipt = options?.onCommitted !== undefined ? { message: userMessage, commit: options.onCommitted } : undefined;
1006
+ const opensOnQueuedInput = options?.opensOnQueuedInput === true;
1007
+ const userMessage = opensOnQueuedInput && AgentHarness.emptyInjection(text, options) ? undefined : createUserMessage(text, options?.images, options);
1008
+ const answered = (options?.answeredInputs ?? []).map((seed) => this.mintInjection(seed.text, { ...seed.provenance, givenAnswer: seed.answer }));
1009
+ const onCommitted = options?.onCommitted;
1010
+ const commit = (entryId) => {
1011
+ onCommitted?.(entryId);
1012
+ this.followUpQueue.push(...answered);
1013
+ };
1014
+ this.promptReceipt = userMessage !== undefined && (onCommitted !== undefined || answered.length > 0) ? { message: userMessage, commit } : undefined;
981
1015
  const trailingMessages = (options?.trailing ?? []).map(createTrailingMessage);
982
1016
  this.runHistory = new WeakSet(turnState.messages.filter((m) => m.role === "assistant"));
983
1017
  this.priorImageRefusals = new Set(turnState.messages.filter(isImageRefusal).map(imageRefusalAt));
@@ -988,8 +1022,13 @@ export class AgentHarness {
988
1022
  systemPrompt: turnState.systemPrompt,
989
1023
  resources: turnState.resources,
990
1024
  });
1025
+ if (opensOnQueuedInput && this.nextTurnQueue.length + this.pendingInjectionCount() + (beforeResult?.messages?.length ?? 0) === 0) {
1026
+ if (userMessage !== undefined && this.promptReceipt?.message === userMessage)
1027
+ this.promptReceipt = undefined;
1028
+ throw new NothingQueuedError();
1029
+ }
991
1030
  const takePrompts = async () => {
992
- let messages = [userMessage, ...trailingMessages];
1031
+ let messages = [...(userMessage !== undefined ? [userMessage] : []), ...trailingMessages];
993
1032
  if (this.nextTurnQueue.length > 0) {
994
1033
  const queuedMessages = this.nextTurnQueue.splice(0);
995
1034
  try {
@@ -1039,9 +1078,12 @@ export class AgentHarness {
1039
1078
  }
1040
1079
  : {}),
1041
1080
  ...(options?.endsAwaitingUser === true ? { endsAwaitingUser: true } : {}),
1081
+ ...(options?.givenAnswer !== undefined ? { givenAnswer: options.givenAnswer } : {}),
1082
+ ...(opensOnQueuedInput && userMessage !== undefined ? { ridingPrompt: userMessage } : {}),
1042
1083
  });
1043
1084
  }
1044
1085
  catch (error) {
1086
+ this.turnOpenedAt = 0;
1045
1087
  try {
1046
1088
  return await this.emitRunFailure(activeTurnState.model, error, abortController.signal.aborted, abortController.signal);
1047
1089
  }
@@ -1053,14 +1095,17 @@ export class AgentHarness {
1053
1095
  })();
1054
1096
  try {
1055
1097
  const newMessages = await runResultPromise;
1056
- for (let i = newMessages.length - 1; i >= 0; i--) {
1098
+ let answerFloor = this.turnCutConsumed !== undefined ? this.turnOpenedAt : 0;
1099
+ if (answerFloor > 0 && continuesAnswer(newMessages[answerFloor - 1], newMessages[answerFloor]))
1100
+ answerFloor -= 1;
1101
+ for (let i = newMessages.length - 1; i >= answerFloor; i--) {
1057
1102
  const message = newMessages[i];
1058
1103
  if (message.role === "assistant") {
1059
1104
  const answer = mergeTruncatedOutputChain(newMessages, i);
1060
1105
  return this.answeredFrom(answer.message, answer.members);
1061
1106
  }
1062
1107
  }
1063
- if (this.stopRequested || abortController.signal.aborted)
1108
+ if (this.stopRequested || this.turnCutConsumed !== undefined || abortController.signal.aborted)
1064
1109
  return undefined;
1065
1110
  if (this.endedOnPriorAnswer || options?.endsAwaitingUser === true) {
1066
1111
  const prior = turnState.messages.findLast((m) => m.role === "assistant");
@@ -1078,7 +1123,7 @@ export class AgentHarness {
1078
1123
  finally {
1079
1124
  this.runAbortController = undefined;
1080
1125
  this.activeRun = undefined;
1081
- if (this.promptReceipt?.message === userMessage)
1126
+ if (userMessage !== undefined && this.promptReceipt?.message === userMessage)
1082
1127
  this.promptReceipt = undefined;
1083
1128
  }
1084
1129
  }
@@ -1091,6 +1136,9 @@ export class AgentHarness {
1091
1136
  this.stopRequestSources.clear();
1092
1137
  this.boundaryStopConsumed = undefined;
1093
1138
  this.turnCutConsumed = undefined;
1139
+ this.turnOpenedAt = 0;
1140
+ this.acceptedCuts = [];
1141
+ this.consumedCuts.clear();
1094
1142
  this.lastPublishedSeat = undefined;
1095
1143
  this.aborting = false;
1096
1144
  if (this.drainedPendingInjection.length > 0) {
@@ -1126,24 +1174,14 @@ export class AgentHarness {
1126
1174
  }
1127
1175
  }
1128
1176
  static emptyInjection(text, options) {
1129
- return text.trim().length === 0 && (options?.images === undefined || options.images.length === 0);
1177
+ return isBlankInput(text) && (options?.images === undefined || options.images.length === 0);
1130
1178
  }
1131
- async enqueueInjection(queue, text, options) {
1132
- if (AgentHarness.emptyInjection(text, options))
1133
- return undefined;
1134
- let displaced;
1135
- if (options?.enginePayload !== undefined && queue.filter((q) => engineNotePayloads.has(q)).length >= ENGINE_NOTE_STEER_BACKLOG_CAP) {
1136
- const victimIdx = options.capPreferred === true
1137
- ? queue.findIndex((q) => engineNotePayloads.has(q) && !capPreferredInjections.has(q))
1138
- : -1;
1139
- if (victimIdx === -1) {
1140
- throw new AgentHarnessError("invalid_state", `engine-note backlog at cap (${ENGINE_NOTE_STEER_BACKLOG_CAP}) — park the payload for the session's next run`);
1141
- }
1142
- displaced = { frame: queue.splice(victimIdx, 1)[0], at: victimIdx };
1143
- }
1179
+ mintInjection(text, options) {
1144
1180
  const m = createUserMessage(text, options?.images, options);
1145
1181
  if (options?.enginePayload !== undefined)
1146
1182
  engineNotePayloads.set(m, options.enginePayload);
1183
+ if (options?.givenAnswer !== undefined)
1184
+ givenAnswerFrames.set(m, { text: options.givenAnswer.text, by: options.givenAnswer.by });
1147
1185
  if (isEngineAuthoredInjection(options))
1148
1186
  engineAuthoredInjections.add(m);
1149
1187
  if (options?.author !== undefined)
@@ -1154,6 +1192,24 @@ export class AgentHarness {
1154
1192
  immediateClassInjections.add(m);
1155
1193
  if (options?.capPreferred === true && options?.enginePayload !== undefined)
1156
1194
  capPreferredInjections.add(m);
1195
+ return m;
1196
+ }
1197
+ async enqueueInjection(queue, text, options, frame) {
1198
+ if (frame === undefined && AgentHarness.emptyInjection(text, options))
1199
+ return undefined;
1200
+ let displaced;
1201
+ if (options?.enginePayload !== undefined && queue.filter((q) => engineNotePayloads.has(q)).length >= ENGINE_NOTE_STEER_BACKLOG_CAP) {
1202
+ const victimIdx = options.capPreferred === true
1203
+ ? queue.findIndex((q) => engineNotePayloads.has(q) && !capPreferredInjections.has(q))
1204
+ : -1;
1205
+ if (victimIdx === -1) {
1206
+ throw new AgentHarnessError("invalid_state", `engine-note backlog at cap (${ENGINE_NOTE_STEER_BACKLOG_CAP}) — park the payload for the session's next run`);
1207
+ }
1208
+ displaced = { frame: queue.splice(victimIdx, 1)[0], at: victimIdx };
1209
+ }
1210
+ const m = frame !== undefined ? createTrailingMessage(frame) : this.mintInjection(text, options);
1211
+ if (frame !== undefined)
1212
+ engineAuthoredInjections.add(m);
1157
1213
  if (options?.immediate === true && queue === this.steerQueue) {
1158
1214
  let at = 0;
1159
1215
  while (at < queue.length && immediateClassInjections.has(queue[at]))
@@ -1200,6 +1256,13 @@ export class AgentHarness {
1200
1256
  this.refuseHeldEngineInjection(options);
1201
1257
  return await this.enqueueInjection(this.steerQueue, text, options);
1202
1258
  }
1259
+ async steerFrame(seed) {
1260
+ if (!this.takingInput) {
1261
+ throw new AgentHarnessError("invalid_state", "Cannot steer while idle");
1262
+ }
1263
+ this.refuseHeldEngineInjection({ provenance: "engine-note" });
1264
+ return await this.enqueueInjection(this.steerQueue, "", undefined, seed);
1265
+ }
1203
1266
  async followUp(text, options) {
1204
1267
  if (!this.takingInput) {
1205
1268
  throw new AgentHarnessError("invalid_state", "Cannot follow up while idle");
@@ -1208,15 +1271,9 @@ export class AgentHarness {
1208
1271
  await this.enqueueInjection(this.followUpQueue, text, options);
1209
1272
  }
1210
1273
  interruptTurn(frame) {
1211
- if (this.aborting)
1212
- return false;
1213
1274
  if (!this.steerQueue.includes(frame))
1214
1275
  return false;
1215
- const seat = this.turnInterruptSeat;
1216
- if (seat === undefined || seat.signal.aborted)
1217
- return false;
1218
- this.cutSeat(seat, "steer");
1219
- return true;
1276
+ return this.cutTurn("steer") === "cut";
1220
1277
  }
1221
1278
  halt() {
1222
1279
  if (this.phase === "idle") {
@@ -1225,18 +1282,44 @@ export class AgentHarness {
1225
1282
  if (this.aborting)
1226
1283
  return { turnCut: false, accepted: false };
1227
1284
  this.stopRequestSources.add("halt");
1228
- const seat = this.turnInterruptSeat;
1229
- if (seat === undefined || seat.signal.aborted)
1230
- return { turnCut: false, accepted: true };
1231
- this.cutSeat(seat, "halt");
1232
- return { turnCut: true, accepted: true };
1233
- }
1234
- cutSeat(seat, source) {
1235
- this.seatCutSources.set(seat, source);
1285
+ return { turnCut: this.cutTurn("halt") === "cut", accepted: true };
1286
+ }
1287
+ cutTurn(source, extension) {
1288
+ const seat = this.seatToCut();
1289
+ if (typeof seat === "string")
1290
+ return seat;
1291
+ const cut = extension !== undefined ? { source, by: extension.by, turn: extension.turn } : { source };
1292
+ this.seatCuts.set(seat, cut);
1293
+ this.acceptedCuts.push(cut);
1236
1294
  const runQuietBefore = this.runAbortController?.signal.aborted !== true;
1237
1295
  seat.abort();
1238
1296
  if (runQuietBefore && this.runAbortController?.signal.aborted === true)
1239
- this.turnCutConsumed = { source };
1297
+ this.consumeTurnCut(cut);
1298
+ return "cut";
1299
+ }
1300
+ consumeTurnCut(cut) {
1301
+ this.turnCutConsumed = { cut };
1302
+ if (cut !== undefined)
1303
+ this.consumedCuts.add(cut);
1304
+ }
1305
+ turnSeatState() {
1306
+ const seat = this.seatToCut();
1307
+ return typeof seat === "string" ? seat : "live";
1308
+ }
1309
+ cutMovesArmedCommandAside(signal) {
1310
+ const seat = this.lastPublishedSeat;
1311
+ if (seat === undefined || seat.signal !== signal)
1312
+ return false;
1313
+ const cut = this.seatCuts.get(seat);
1314
+ return cut !== undefined && TURN_CUT_SETTLEMENTS[cut.source].movesArmedCommandAside;
1315
+ }
1316
+ seatToCut() {
1317
+ if (this.aborting)
1318
+ return "ending";
1319
+ const seat = this.turnInterruptSeat;
1320
+ if (seat === undefined)
1321
+ return "none";
1322
+ return seat.signal.aborted ? "ending" : seat;
1240
1323
  }
1241
1324
  answerEntryIdsOf(answer) {
1242
1325
  return answer === undefined ? [] : this.answerSources.get(answer);
@@ -1254,10 +1337,13 @@ export class AgentHarness {
1254
1337
  return answer;
1255
1338
  }
1256
1339
  haltConsumption() {
1257
- const turnCut = this.turnCutConsumed?.source;
1340
+ const cut = this.turnCutConsumed?.cut;
1341
+ const unconsumedCuts = this.acceptedCuts.filter((c) => !this.consumedCuts.has(c));
1258
1342
  return {
1259
- ...(turnCut !== undefined ? { turnCut } : {}),
1343
+ ...(cut !== undefined ? { turnCut: cut.source } : {}),
1344
+ ...(cut?.by !== undefined ? { turnCutBy: cut.by } : {}),
1260
1345
  ...(this.boundaryStopConsumed !== undefined ? { boundaryStop: this.boundaryStopConsumed } : {}),
1346
+ ...(unconsumedCuts.length > 0 ? { unconsumedCuts } : {}),
1261
1347
  };
1262
1348
  }
1263
1349
  consultStopLatch(face) {
@@ -1272,7 +1358,9 @@ export class AgentHarness {
1272
1358
  if (seat !== this.lastPublishedSeat) {
1273
1359
  throw new AgentHarnessError("invalid_state", "turn-cut consumption reported for a seat the harness did not publish last");
1274
1360
  }
1275
- this.turnCutConsumed = { source: this.seatCutSources.get(seat) };
1361
+ const cut = this.seatCuts.get(seat);
1362
+ this.consumeTurnCut(cut);
1363
+ return cut !== undefined ? TURN_CUT_SETTLEMENTS[cut.source] : undefined;
1276
1364
  }
1277
1365
  pendingInjectionCount() {
1278
1366
  if (this.aborting)
@@ -1617,6 +1705,14 @@ function isEmptyFailureAssistant(message) {
1617
1705
  return false;
1618
1706
  return m.content.every((c) => c.type === "text" ? c.text.trim() === "" : c.type === "thinking" ? c.thinking.trim() === "" : false);
1619
1707
  }
1708
+ function continuesAnswer(head, nudge) {
1709
+ const mid = nudge;
1710
+ if (head?.role !== "assistant" || mid?.role !== "custom")
1711
+ return false;
1712
+ const stopReason = head.stopReason;
1713
+ return ((mid.customType === "loop:truncated-output-continue" && stopReason === "length") ||
1714
+ (mid.customType === "loop:midstream-partial-continue" && stopReason === "stop"));
1715
+ }
1620
1716
  function mergeTruncatedOutputChain(messages, lastAssistantIndex) {
1621
1717
  const last = messages[lastAssistantIndex];
1622
1718
  const lastText = last.content.map((c) => (c.type === "text" ? c.text : "")).join("");
@@ -1624,17 +1720,9 @@ function mergeTruncatedOutputChain(messages, lastAssistantIndex) {
1624
1720
  const members = [last];
1625
1721
  let i = lastAssistantIndex;
1626
1722
  while (i - 2 >= 0) {
1627
- const mid = messages[i - 1];
1628
- if (mid.role !== "custom")
1629
- break;
1630
- const h = messages[i - 2];
1631
- if (h.role !== "assistant")
1632
- break;
1633
- const head = h;
1634
- const step = (mid.customType === "loop:truncated-output-continue" && head.stopReason === "length") ||
1635
- (mid.customType === "loop:midstream-partial-continue" && head.stopReason === "stop");
1636
- if (!step)
1723
+ if (!continuesAnswer(messages[i - 2], messages[i - 1]))
1637
1724
  break;
1725
+ const head = messages[i - 2];
1638
1726
  parts.unshift(head.content.map((c) => (c.type === "text" ? c.text : "")).join(""));
1639
1727
  members.unshift(head);
1640
1728
  i = i - 2;