@sema-agent/core 7.66.1 → 7.67.1

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 (904) hide show
  1. package/CHANGELOG.md +3518 -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 +169 -0
  71. package/dist/brain/model-lane.js +505 -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 +164 -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 +105 -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 +24 -25
  362. package/dist/core/roles.js +148 -21
  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 +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -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 +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -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 +6 -5
  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 +19 -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 +126 -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 +64 -34
  730. package/dist/index.js +45 -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 +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -1,6 +1,8 @@
1
- import { findToolByName, validateToolArguments } from "../llm/index.js";
1
+ import { findToolByName, toolNameIndex, validateToolArguments } from "../llm/index.js";
2
2
  import { truncateError } from "../../core/tool-errors.js";
3
+ import { noteInterruptionMarker } from "../../core/user-row-origin.js";
3
4
  import { judgeToolNameMiss, mountedToolNames } from "../../core/tool-name-aliases.js";
5
+ import { engineTextFor } from "../../prompt-assembly/engine-text.js";
4
6
  import { INTERRUPTED_BY_USER_FOR_TOOL_USE_MARKER, INTERRUPTED_BY_USER_MARKER, } from "../../core/session-reconcile.js";
5
7
  import { resolveAgentCoreStreamFn } from "./runtime-deps.js";
6
8
  import { isErrorLike, readMember, readOwnMembers, thrownMarksOf } from "../../core/thrown-value.js";
@@ -9,6 +11,8 @@ import { remoteWords } from "../../core/protocol-http-auth.js";
9
11
  import { types } from "node:util";
10
12
  import { admitToolResultMediaBlocks, firstUnprocessedOverTarget, toolResultMediaBlocks } from "../../core/image-admission.js";
11
13
  import { resolveImageProcessor } from "../../core/image-downsample.js";
14
+ import { runWithCommandSandboxPlan } from "../../core/command-sandbox-dispatch.js";
15
+ import { toolResultBytesKeeper } from "../../core/tool-result-store.js";
12
16
  import { IMAGE_REFUSAL_KIND, imageRefusalRemoves, toolSchemaRefusalReplaces, withoutRefusedToolSchemas } from "../llm/rejected-images.js";
13
17
  const IMAGE_REFUSAL_RETRIES = 3;
14
18
  function appendTextDeltaToAssistantMessage(message, contentIndex, delta) {
@@ -71,13 +75,19 @@ export async function settleUnansweredToolCalls(context, assistantMessage, confi
71
75
  export async function runAgentLoop(prompts, context, config, emit, signal, streamFn, runtime, trace, seams) {
72
76
  const state = await createLoopState({ ...context, messages: [...context.messages] }, config, []);
73
77
  await emit({ type: "agent_start" });
74
- await emit({ type: "turn_start" });
78
+ await openTurn(state, emit);
75
79
  if (seams?.settle !== undefined && (await settleTrailingBatchTurn(state, signal, emit, seams.settle)) === "ended") {
76
80
  return state.newMessages;
77
81
  }
78
82
  const delivered = typeof prompts === "function" ? await prompts() : prompts;
79
- if (delivered.length > 0)
83
+ if (delivered.some((m) => m !== seams?.ridingPrompt)) {
80
84
  state.hasMoreToolCalls = seams?.endsAwaitingUser !== true;
85
+ if (state.hasMoreToolCalls && seams?.givenAnswer !== undefined)
86
+ state.givenAnswer = seams.givenAnswer;
87
+ }
88
+ else if (state.newMessages.length === 0) {
89
+ state.hasMoreToolCalls = false;
90
+ }
81
91
  state.context.messages.push(...delivered);
82
92
  state.newMessages.push(...delivered);
83
93
  for (const prompt of delivered) {
@@ -99,6 +109,7 @@ async function settleTrailingBatchTurn(state, signal, emit, settle) {
99
109
  else
100
110
  signal.addEventListener("abort", onRunAbort, { once: true });
101
111
  }
112
+ state.config.noteTurnOpened?.(state.newMessages.length);
102
113
  state.config.publishTurnInterruptSeat?.(turnController);
103
114
  let batch;
104
115
  try {
@@ -113,9 +124,9 @@ async function settleTrailingBatchTurn(state, signal, emit, settle) {
113
124
  let ended = signal?.aborted === true;
114
125
  let terminalEmitted = false;
115
126
  if (!ended && turnController.signal.aborted) {
116
- state.config.noteTurnCutConsumed?.(turnController);
127
+ const cut = state.config.noteTurnCutConsumed?.(turnController);
117
128
  const pendingBeforeSettlement = state.pendingMessages;
118
- const outcome = await settleInterruptedTurn(state, tail, new StreamToolExecutor(state.context, state.config, turnController.signal, emit), batch.messages, signal, emit);
129
+ const outcome = await settleInterruptedTurn(state, tail, new StreamToolExecutor(state.context, state.config, turnController.signal, emit), batch.messages, signal, emit, cut);
119
130
  ended = outcome.kind === "terminal";
120
131
  if (!ended)
121
132
  state.pendingMessages.unshift(...pendingBeforeSettlement);
@@ -134,6 +145,14 @@ async function settleTrailingBatchTurn(state, signal, emit, settle) {
134
145
  await emit({ type: "agent_end", messages: state.newMessages });
135
146
  return ended ? "ended" : "continue";
136
147
  }
148
+ function openTurn(state, emit) {
149
+ state.turnOpen = true;
150
+ return emit({ type: "turn_start" });
151
+ }
152
+ function endTurn(state, emit, message, toolResults) {
153
+ state.turnOpen = false;
154
+ return emit({ type: "turn_end", message, toolResults });
155
+ }
137
156
  const PROMPT_TOO_LONG_RE = /context.{0,3}length|context_length|context window (?:limit|exceeded)|reached its context window|prompt is too long|too many tokens|maximum context|exceeds? .{0,30}(?:context|token)|input is too long|\b413\b/i;
138
157
  function isBlankFailureContent(message) {
139
158
  return message.content.every((c) => c.type === "text" ? c.text.trim() === "" : c.type === "thinking" ? c.thinking.trim() === "" : false);
@@ -189,6 +208,17 @@ function createMalformedToolUseNudge() {
189
208
  timestamp: Date.now(),
190
209
  };
191
210
  }
211
+ const LOOP_TOOL_MISSES = new WeakSet();
212
+ function sameToolMissKey(calls, results, nextTools) {
213
+ if (calls.length === 0 || results.length !== calls.length)
214
+ return undefined;
215
+ if (!results.every((r) => typeof r.details === "object" && r.details !== null && LOOP_TOOL_MISSES.has(r.details)))
216
+ return undefined;
217
+ const next = toolNameIndex(nextTools);
218
+ if (calls.some((c) => next(c.name) !== undefined))
219
+ return undefined;
220
+ return JSON.stringify([...new Set(calls.map((c) => c.name))].sort());
221
+ }
192
222
  function createThinkingOnlyNudge() {
193
223
  return {
194
224
  role: "custom",
@@ -209,13 +239,12 @@ function createMidstreamPartialContinueNudge() {
209
239
  timestamp: Date.now(),
210
240
  };
211
241
  }
212
- function createDegenerateRecoveryNudge() {
242
+ function createDegenerateRecoveryNudge(locale) {
213
243
  return {
214
244
  role: "custom",
215
245
  customType: "loop:degenerate-output-recovery",
216
246
  provenance: "engine-note",
217
- content: "Your previous reply degenerated into repetition and was cut off. Do NOT repeat or continue that text. " +
218
- "Take a DIFFERENT approach: state your next concrete step or conclusion in one short sentence, then proceed normally.",
247
+ content: engineTextFor(locale)("core/engine.degenerate-recovery"),
219
248
  display: false,
220
249
  timestamp: Date.now(),
221
250
  };
@@ -246,7 +275,7 @@ async function createLoopState(context, config, newMessages) {
246
275
  context,
247
276
  config,
248
277
  newMessages,
249
- firstTurn: true,
278
+ turnOpen: false,
250
279
  pendingMessages: (await config.getSteeringMessages?.(true)) || [],
251
280
  hasMoreToolCalls: true,
252
281
  truncatedOutputContinues: 0,
@@ -272,7 +301,11 @@ async function runLoop(state, signal, emit, streamFn, runtime, trace) {
272
301
  trace?.({ kind: "terminal", reason: "completed" });
273
302
  break;
274
303
  }
275
- state.pendingMessages = followUpMessages;
304
+ const answer = followUpMessages.length === 1 ? state.config.answerOf?.(followUpMessages[0]) : undefined;
305
+ if (answer !== undefined)
306
+ state.givenAnswer = { text: answer.text, by: answer.by, input: followUpMessages[0] };
307
+ else
308
+ state.pendingMessages = followUpMessages;
276
309
  trace?.({ kind: "continue", reason: "follow_up_injected" });
277
310
  }
278
311
  const outcome = await runSingleTurn(state, signal, emit, streamFn, runtime, trace);
@@ -302,16 +335,13 @@ async function runSingleTurn(state, signal, emit, streamFn, runtime, trace) {
302
335
  await emit({ type: "agent_end", messages: state.newMessages });
303
336
  return { kind: "terminal", reason: "stop_requested" };
304
337
  }
305
- if (!state.firstTurn) {
306
- await emit({ type: "turn_start" });
338
+ if (!state.turnOpen) {
339
+ await openTurn(state, emit);
307
340
  if (state.config.shouldHaltBeforeTurn?.() === true) {
308
341
  await emit({ type: "agent_end", messages: state.newMessages });
309
342
  return { kind: "terminal", reason: "stop_requested" };
310
343
  }
311
344
  }
312
- else {
313
- state.firstTurn = false;
314
- }
315
345
  const turnController = new AbortController();
316
346
  const onRunAbort = () => turnController.abort();
317
347
  if (signal !== undefined) {
@@ -340,12 +370,18 @@ async function runSingleTurn(state, signal, emit, streamFn, runtime, trace) {
340
370
  }
341
371
  }
342
372
  async function runTurnPhases(state, signal, turnController, publishSeat, retractSeat, emit, streamFn, runtime, trace) {
343
- publishSeat();
344
- if (state.config.recheckImmediateInjections) {
373
+ const given = state.givenAnswer;
374
+ state.givenAnswer = undefined;
375
+ const carried = given !== undefined ? state.pendingMessages : [];
376
+ state.config.noteTurnOpened?.(state.newMessages.length);
377
+ if (given === undefined)
378
+ publishSeat();
379
+ if (given === undefined && state.config.recheckImmediateInjections) {
345
380
  state.pendingMessages = await state.config.recheckImmediateInjections(state.pendingMessages);
346
381
  }
347
- if (state.pendingMessages.length > 0) {
348
- for (const message of state.pendingMessages) {
382
+ const injected = given === undefined ? state.pendingMessages : given.input !== undefined ? [given.input] : [];
383
+ if (injected.length > 0) {
384
+ for (const message of injected) {
349
385
  await emit({ type: "message_start", message });
350
386
  await emit({ type: "message_end", message });
351
387
  state.context.messages.push(message);
@@ -353,6 +389,12 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
353
389
  }
354
390
  }
355
391
  let executor = new StreamToolExecutor(state.context, state.config, turnController.signal, emit);
392
+ const retractWhenNothingInFlight = (final) => {
393
+ if (final.stopReason === "aborted" || final.stopReason === "error")
394
+ return;
395
+ if (executor.admittedCount === 0 && final.content.every((b) => b.type !== "toolCall"))
396
+ retractSeat();
397
+ };
356
398
  const staticReasoningCutDowngrade = state.config.recovery?.truncatedOutput !== undefined &&
357
399
  state.staticReasoningCutRecoveries < MAX_STATIC_REASONING_CUT_RECOVERIES;
358
400
  const ptl = state.config.recovery?.promptTooLong;
@@ -362,7 +404,10 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
362
404
  let message;
363
405
  let cutAtFinalSettle = false;
364
406
  try {
365
- ({ message, cutAtSettle: cutAtFinalSettle } = await streamAssistantResponse(state.context, state.config, turnController.signal, withhold?.sink ?? emit, streamFn, runtime, executor, staticReasoningCutDowngrade));
407
+ ({ message, cutAtSettle: cutAtFinalSettle } =
408
+ given !== undefined
409
+ ? await deliverGivenAnswer(state.context, state.config, given, emit)
410
+ : await streamAssistantResponse(state.context, state.config, turnController.signal, withhold?.sink ?? emit, streamFn, runtime, executor, staticReasoningCutDowngrade, retractWhenNothingInFlight));
366
411
  }
367
412
  finally {
368
413
  await executor.settle();
@@ -393,7 +438,7 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
393
438
  trace?.({ kind: "continue", reason: message.errorKind === IMAGE_REFUSAL_KIND ? "image_refusal_retry" : "tool_schema_refusal_retry" });
394
439
  executor = new StreamToolExecutor(state.context, state.config, turnController.signal, emit);
395
440
  try {
396
- ({ message, cutAtSettle: cutAtFinalSettle } = await streamAssistantResponse(state.context, state.config, turnController.signal, withhold?.sink ?? emit, streamFn, runtime, executor, staticReasoningCutDowngrade));
441
+ ({ message, cutAtSettle: cutAtFinalSettle } = await streamAssistantResponse(state.context, state.config, turnController.signal, withhold?.sink ?? emit, streamFn, runtime, executor, staticReasoningCutDowngrade, retractWhenNothingInFlight));
397
442
  }
398
443
  finally {
399
444
  await executor.settle();
@@ -445,7 +490,7 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
445
490
  trace?.({ kind: "continue", reason: "reactive_compact_retry" });
446
491
  executor = new StreamToolExecutor(state.context, state.config, turnController.signal, emit);
447
492
  try {
448
- ({ message, cutAtSettle: cutAtFinalSettle } = await streamAssistantResponse(state.context, state.config, turnController.signal, withhold?.sink ?? emit, streamFn, runtime, executor, staticReasoningCutDowngrade));
493
+ ({ message, cutAtSettle: cutAtFinalSettle } = await streamAssistantResponse(state.context, state.config, turnController.signal, withhold?.sink ?? emit, streamFn, runtime, executor, staticReasoningCutDowngrade, retractWhenNothingInFlight));
449
494
  }
450
495
  finally {
451
496
  await executor.settle();
@@ -463,19 +508,22 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
463
508
  const cutAtPtlLaneExit = turnController.signal.aborted;
464
509
  const interruptOwnsTurn = ((message.stopReason === "aborted" && cutAtFinalSettle) || (unrecoveredPtlFailureUnderInterrupt && cutAtPtlLaneExit) || interruptedInRecovery) &&
465
510
  !signal?.aborted;
466
- if (interruptOwnsTurn)
467
- state.config.noteTurnCutConsumed?.(turnController);
511
+ const cut = interruptOwnsTurn ? state.config.noteTurnCutConsumed?.(turnController) : undefined;
468
512
  if (interruptOwnsTurn && message.stopReason === "error")
469
513
  withhold?.discard();
470
514
  await withhold?.flush();
471
515
  state.newMessages.push(message);
472
- if (message.content.some((c) => c.type === "toolCall"))
516
+ const toolCalls = message.content.filter((c) => c.type === "toolCall");
517
+ const streakBefore = { retries: state.malformedToolUseRetries, missed: state.streakMissedNames };
518
+ if (toolCalls.length > 0) {
473
519
  state.malformedToolUseRetries = 0;
520
+ state.streakMissedNames = undefined;
521
+ }
474
522
  if (message.staticReasoningCut === true)
475
523
  state.staticReasoningCutRecoveries++;
476
524
  if (interruptOwnsTurn) {
477
525
  retractSeat();
478
- return await settleInterruptedTurn(state, message, executor, [], signal, emit);
526
+ return await settleInterruptedTurn(state, message, executor, [], signal, emit, cut);
479
527
  }
480
528
  {
481
529
  const degen = state.config.recovery?.degenerateOutput;
@@ -488,9 +536,9 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
488
536
  state.degenerateContinues < (degen.maxContinues ?? 2)) {
489
537
  retractSeat();
490
538
  state.degenerateContinues++;
491
- await emit({ type: "turn_end", message, toolResults: [] });
539
+ await endTurn(state, emit, message, []);
492
540
  const drained = (await state.config.getSteeringMessages?.(false)) || [];
493
- state.pendingMessages = drained.length > 0 ? drained : [createDegenerateRecoveryNudge()];
541
+ state.pendingMessages = drained.length > 0 ? drained : [createDegenerateRecoveryNudge(state.context.promptLocale)];
494
542
  return { kind: "ran", recovered: "degenerate_output_recovery" };
495
543
  }
496
544
  if (message.stopReason !== "error")
@@ -499,11 +547,10 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
499
547
  if (message.stopReason === "error" || message.stopReason === "aborted") {
500
548
  retractSeat();
501
549
  const errorFinalResults = await harvestExecutorOnErrorFinal(executor, state, message, turnController.signal, emit);
502
- await emit({ type: "turn_end", message, toolResults: errorFinalResults });
550
+ await endTurn(state, emit, message, errorFinalResults);
503
551
  await emit({ type: "agent_end", messages: state.newMessages });
504
552
  return { kind: "terminal", reason: "assistant_error" };
505
553
  }
506
- const toolCalls = message.content.filter((c) => c.type === "toolCall");
507
554
  const toolResults = [];
508
555
  state.hasMoreToolCalls = false;
509
556
  if (toolCalls.length > 0) {
@@ -524,10 +571,10 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
524
571
  const cutAtBatchSettle = turnController.signal.aborted;
525
572
  retractSeat();
526
573
  if (toolCalls.length > 0 && cutAtBatchSettle && !signal?.aborted) {
527
- state.config.noteTurnCutConsumed?.(turnController);
528
- return await settleInterruptedTurn(state, message, executor, toolResults, signal, emit);
574
+ const batchCut = state.config.noteTurnCutConsumed?.(turnController);
575
+ return await settleInterruptedTurn(state, message, executor, toolResults, signal, emit, batchCut);
529
576
  }
530
- await emit({ type: "turn_end", message, toolResults });
577
+ await endTurn(state, emit, message, toolResults);
531
578
  const nextTurnContext = {
532
579
  message,
533
580
  toolResults,
@@ -545,7 +592,7 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
545
592
  await emit({ type: "agent_end", messages: state.newMessages });
546
593
  return { kind: "terminal", reason: "stop_requested" };
547
594
  }
548
- state.pendingMessages = (await state.config.getSteeringMessages?.(state.hasMoreToolCalls)) || [];
595
+ state.pendingMessages = [...carried, ...((await state.config.getSteeringMessages?.(state.hasMoreToolCalls)) || [])];
549
596
  const truncated = state.config.recovery?.truncatedOutput;
550
597
  if (message.stopReason === "length") {
551
598
  if (truncated && toolCalls.length === 0 && state.pendingMessages.length === 0) {
@@ -576,14 +623,25 @@ async function runTurnPhases(state, signal, turnController, publishSeat, retract
576
623
  state.midstreamPartialContinues = 0;
577
624
  }
578
625
  const malformed = state.config.recovery?.malformedToolUse;
579
- if (malformed && message.stopReason === "toolUse" && toolCalls.length === 0 && state.pendingMessages.length === 0) {
626
+ const noParseableCall = message.stopReason === "toolUse" && toolCalls.length === 0;
627
+ const missedKey = sameToolMissKey(toolCalls, toolResults, state.context.tools);
628
+ if (missedKey !== undefined) {
629
+ if (missedKey === streakBefore.missed)
630
+ state.malformedToolUseRetries = streakBefore.retries;
631
+ state.streakMissedNames = missedKey;
632
+ }
633
+ if (malformed && (noParseableCall || missedKey !== undefined) && state.pendingMessages.length === 0) {
580
634
  if (state.malformedToolUseRetries < (malformed.maxRetries ?? 2)) {
581
635
  state.malformedToolUseRetries++;
582
- state.pendingMessages = [createMalformedToolUseNudge()];
583
- return { kind: "ran", recovered: "malformed_tool_use_retry" };
636
+ if (noParseableCall) {
637
+ state.pendingMessages = [createMalformedToolUseNudge()];
638
+ return { kind: "ran", recovered: "malformed_tool_use_retry" };
639
+ }
640
+ }
641
+ else {
642
+ await emit({ type: "agent_end", messages: state.newMessages });
643
+ return { kind: "terminal", reason: "malformed_tool_use_exhausted" };
584
644
  }
585
- await emit({ type: "agent_end", messages: state.newMessages });
586
- return { kind: "terminal", reason: "malformed_tool_use_exhausted" };
587
645
  }
588
646
  const thinkingOnly = state.config.recovery?.thinkingOnly;
589
647
  if (thinkingOnly &&
@@ -622,9 +680,11 @@ function adoptNextTurnSnapshot(state, nextTurnSnapshot) {
622
680
  : nextTurnSnapshot.thinkingLevel,
623
681
  });
624
682
  }
625
- const TURN_INTERRUPTED_TOOL_TEXT = "[INTERRUPTED] The user interrupted this turn before this tool call started. It was never executed and " +
683
+ export const TURN_INTERRUPTED_TOOL_TEXT = "[INTERRUPTED] The user interrupted this turn before this tool call started. It was never executed and " +
626
684
  "had no side effects. Address the user's interjection first; re-issue the call afterwards if it is still needed.";
627
- async function settleInterruptedTurn(state, message, executor, committedResults, signal, emit) {
685
+ export const TURN_ENDED_TOOL_TEXT = "[Tool call did not complete: the turn was ended to deliver the message that follows. Nothing refused it; re-run it if still needed.]";
686
+ export const INTERRUPT_TURN_CUT_SETTLEMENT = Object.freeze({ neverStartedText: TURN_INTERRUPTED_TOOL_TEXT, marker: true, movesArmedCommandAside: false });
687
+ async function settleInterruptedTurn(state, message, executor, committedResults, signal, emit, cut = INTERRUPT_TURN_CUT_SETTLEMENT) {
628
688
  const toolResults = [...committedResults];
629
689
  toolResults.push(...(await harvestExecutorOnErrorFinal(executor, state, message, signal, emit)));
630
690
  const turnCalls = message.content.filter((c) => c.type === "toolCall");
@@ -642,7 +702,7 @@ async function settleInterruptedTurn(state, message, executor, committedResults,
642
702
  const finalized = {
643
703
  toolCall: call,
644
704
  result: {
645
- content: [{ type: "text", text: TURN_INTERRUPTED_TOOL_TEXT }],
705
+ content: [{ type: "text", text: cut.neverStartedText }],
646
706
  details: { errorKind: "interrupted_never_started" },
647
707
  },
648
708
  isError: true,
@@ -668,23 +728,26 @@ async function settleInterruptedTurn(state, message, executor, committedResults,
668
728
  if (state.newMessages[state.newMessages.length - 1] === message)
669
729
  state.newMessages.pop();
670
730
  }
671
- const marker = {
672
- role: "user",
673
- content: [
674
- {
675
- type: "text",
676
- text: turnCalls.length > 0 ? INTERRUPTED_BY_USER_FOR_TOOL_USE_MARKER : INTERRUPTED_BY_USER_MARKER,
677
- },
678
- ],
679
- provenance: "engine-note",
680
- timestamp: Date.now(),
681
- };
682
- await emit({ type: "message_start", message: marker });
683
- await emit({ type: "message_end", message: marker });
684
- state.context.messages.push(marker);
685
- state.newMessages.push(marker);
731
+ if (cut.marker) {
732
+ const marker = {
733
+ role: "user",
734
+ content: [
735
+ {
736
+ type: "text",
737
+ text: turnCalls.length > 0 ? INTERRUPTED_BY_USER_FOR_TOOL_USE_MARKER : INTERRUPTED_BY_USER_MARKER,
738
+ },
739
+ ],
740
+ provenance: "engine-note",
741
+ timestamp: Date.now(),
742
+ };
743
+ noteInterruptionMarker(marker);
744
+ await emit({ type: "message_start", message: marker });
745
+ await emit({ type: "message_end", message: marker });
746
+ state.context.messages.push(marker);
747
+ state.newMessages.push(marker);
748
+ }
686
749
  state.hasMoreToolCalls = false;
687
- await emit({ type: "turn_end", message, toolResults });
750
+ await endTurn(state, emit, message, toolResults);
688
751
  if (signal?.aborted) {
689
752
  await emit({ type: "agent_end", messages: state.newMessages });
690
753
  return { kind: "terminal", reason: "aborted_before_stream" };
@@ -709,7 +772,7 @@ async function settleInterruptedTurn(state, message, executor, committedResults,
709
772
  state.pendingMessages = (await state.config.getSteeringMessages?.(state.hasMoreToolCalls)) || [];
710
773
  return { kind: "ran" };
711
774
  }
712
- async function streamAssistantResponse(context, config, signal, emit, streamFn, runtime, executor, staticReasoningCutDowngrade) {
775
+ async function streamAssistantResponse(context, config, signal, emit, streamFn, runtime, executor, staticReasoningCutDowngrade, onObtained) {
713
776
  let messages = context.messages;
714
777
  if (config.transformContext) {
715
778
  const transformed = await config.transformContext(messages, signal);
@@ -724,11 +787,15 @@ async function streamAssistantResponse(context, config, signal, emit, streamFn,
724
787
  }
725
788
  }
726
789
  const llmMessages = await config.convertToLlm(messages);
790
+ if (llmMessages[llmMessages.length - 1]?.role === "assistant") {
791
+ throw new Error("a model request must not end on the assistant's own row: the context to send is hand-built or its transcript is corrupt");
792
+ }
727
793
  const llmContext = {
728
794
  systemPrompt: context.systemPrompt,
729
795
  ...(context.systemBlocks ? { systemBlocks: context.systemBlocks } : {}),
730
796
  messages: llmMessages,
731
797
  tools: withoutRefusedToolSchemas(context.tools, context.messages),
798
+ ...(context.promptLocale !== undefined ? { promptLocale: context.promptLocale } : {}),
732
799
  };
733
800
  const streamFunction = resolveAgentCoreStreamFn(runtime, streamFn);
734
801
  const resolvedApiKey = (config.getApiKey ? await config.getApiKey(config.model.provider) : undefined) || config.apiKey;
@@ -788,6 +855,7 @@ async function streamAssistantResponse(context, config, signal, emit, streamFn,
788
855
  case "error": {
789
856
  const finalMessage = receivedFinal(await response.result());
790
857
  const cutAtSettle = signal?.aborted === true;
858
+ onObtained?.(finalMessage);
791
859
  if (executor && (finalMessage.stopReason === "error" || finalMessage.stopReason === "aborted")) {
792
860
  mergeBackAdmittedCalls(finalMessage, executor);
793
861
  }
@@ -807,6 +875,7 @@ async function streamAssistantResponse(context, config, signal, emit, streamFn,
807
875
  }
808
876
  const finalMessage = receivedFinal(await response.result());
809
877
  const cutAtSettle = signal?.aborted === true;
878
+ onObtained?.(finalMessage);
810
879
  if (executor && (finalMessage.stopReason === "error" || finalMessage.stopReason === "aborted")) {
811
880
  mergeBackAdmittedCalls(finalMessage, executor);
812
881
  }
@@ -820,6 +889,27 @@ async function streamAssistantResponse(context, config, signal, emit, streamFn,
820
889
  await emit({ type: "message_end", message: finalMessage });
821
890
  return { message: finalMessage, cutAtSettle };
822
891
  }
892
+ async function deliverGivenAnswer(context, config, given, emit) {
893
+ const message = {
894
+ role: "assistant",
895
+ content: [{ type: "text", text: given.text }],
896
+ api: config.model.api,
897
+ provider: config.model.provider,
898
+ model: config.model.id,
899
+ stopReason: "stop",
900
+ timestamp: Date.now(),
901
+ usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
902
+ answeredBy: given.by,
903
+ };
904
+ const opened = { ...message, content: [{ type: "text", text: "" }] };
905
+ context.messages.push(message);
906
+ await emit({ type: "message_start", message: { ...opened, content: [] } });
907
+ await emit({ type: "message_update", assistantMessageEvent: { type: "text_start", contentIndex: 0, partial: opened }, message: opened });
908
+ await emit({ type: "message_update", assistantMessageEvent: { type: "text_delta", contentIndex: 0, delta: given.text, partial: message }, message: { ...message } });
909
+ await emit({ type: "message_update", assistantMessageEvent: { type: "text_end", contentIndex: 0, content: given.text, partial: message }, message: { ...message } });
910
+ await emit({ type: "message_end", message });
911
+ return { message, cutAtSettle: false };
912
+ }
823
913
  function engineAbortedFinal(model) {
824
914
  return {
825
915
  role: "assistant",
@@ -1398,16 +1488,13 @@ export function readToolCallArguments(tool, toolCall, args) {
1398
1488
  }
1399
1489
  export const ROSTER_LISTING_MAX = 25;
1400
1490
  export const ROSTER_SEARCH_HINT_NAME = "ToolSearch";
1401
- function formatRosterRecovery(availableTools) {
1491
+ function formatRosterRecovery(availableTools, text) {
1402
1492
  if (availableTools.length === 0)
1403
1493
  return "";
1404
1494
  const shown = availableTools.slice(0, ROSTER_LISTING_MAX);
1405
1495
  const withheld = availableTools.length - shown.length;
1406
- const listing = withheld > 0 ? `${shown.join(", ")} … and ${withheld} more` : shown.join(", ");
1407
- const hint = availableTools.includes(ROSTER_SEARCH_HINT_NAME)
1408
- ? `. Use ${ROSTER_SEARCH_HINT_NAME} to look up a tool by name.`
1409
- : "";
1410
- return ` Available tools: ${listing}${hint}`;
1496
+ const listing = withheld > 0 ? text("core/engine.roster-listing-withheld", { shown: shown.join(", "), withheld: String(withheld) }) : shown.join(", ");
1497
+ return ` ${availableTools.includes(ROSTER_SEARCH_HINT_NAME) ? text("core/engine.roster-recovery-search", { listing, search: ROSTER_SEARCH_HINT_NAME }) : text("core/engine.roster-recovery", { listing })}`;
1411
1498
  }
1412
1499
  export const TOOL_VALIDATION_REFUSED_CODE = "tool.validation_refused";
1413
1500
  export const TOOL_INPUT_VALIDATION_TIMEOUT_MS = 10_000;
@@ -1488,20 +1575,20 @@ async function prepareToolCall(currentContext, assistantMessage, toolCall, confi
1488
1575
  const tools = currentContext.tools ?? [];
1489
1576
  const availableTools = tools.map((t) => t.name);
1490
1577
  const miss = judgeToolNameMiss(toolCall.name, mountedToolNames(tools));
1491
- const retiredClause = miss.kind === "expected-absent" ? ` That name is retired: ${miss.detail}.` : "";
1492
- return {
1493
- kind: "immediate",
1494
- result: createErrorToolResult(`Tool ${toolCall.name} not found.${retiredClause}${formatRosterRecovery(availableTools)}`, {
1495
- details: {
1496
- code: "tool.not_found",
1497
- toolName: toolCall.name,
1498
- availableTools,
1499
- absence: miss.kind,
1500
- ...(miss.kind === "expected-absent" ? { detail: miss.detail, ...(miss.successor !== undefined ? { successor: miss.successor } : {}) } : {}),
1501
- },
1502
- }),
1503
- isError: true,
1504
- };
1578
+ const text = engineTextFor(currentContext.promptLocale);
1579
+ const missSentence = miss.kind === "expected-absent" ? text("core/engine.tool-not-found-retired", { name: toolCall.name, detail: miss.detail }) : text("core/engine.tool-not-found", { name: toolCall.name });
1580
+ const result = createErrorToolResult(`${missSentence}${formatRosterRecovery(availableTools, text)}`, {
1581
+ details: {
1582
+ code: "tool.not_found",
1583
+ toolName: toolCall.name,
1584
+ availableTools,
1585
+ absence: miss.kind,
1586
+ ...(miss.kind === "expected-absent" ? { detail: miss.detail, ...(miss.successor !== undefined ? { successor: miss.successor } : {}) } : {}),
1587
+ },
1588
+ });
1589
+ if (typeof result.details === "object" && result.details !== null)
1590
+ LOOP_TOOL_MISSES.add(result.details);
1591
+ return { kind: "immediate", result, isError: true };
1505
1592
  }
1506
1593
  let gateLetGo = false;
1507
1594
  try {
@@ -1511,6 +1598,7 @@ async function prepareToolCall(currentContext, assistantMessage, toolCall, confi
1511
1598
  if (refusal !== undefined)
1512
1599
  return validationRefusedOutcome(tool, refusal);
1513
1600
  const validatedArgs = finalArgs;
1601
+ let sandboxPlan;
1514
1602
  if (config.beforeToolCall) {
1515
1603
  const beforeResult = await config.beforeToolCall({
1516
1604
  assistantMessage,
@@ -1534,6 +1622,7 @@ async function prepareToolCall(currentContext, assistantMessage, toolCall, confi
1534
1622
  return { kind: "immediate", result: blocked, isError: true };
1535
1623
  }
1536
1624
  gateLetGo = true;
1625
+ sandboxPlan = beforeResult?.sandboxPlan;
1537
1626
  const rewritten = beforeResult?.updatedInput;
1538
1627
  if (rewritten !== undefined) {
1539
1628
  const judged = structuredClone(rewritten);
@@ -1560,6 +1649,7 @@ async function prepareToolCall(currentContext, assistantMessage, toolCall, confi
1560
1649
  toolCall,
1561
1650
  tool,
1562
1651
  args: finalArgs,
1652
+ ...(sandboxPlan !== undefined ? { sandboxPlan } : {}),
1563
1653
  };
1564
1654
  }
1565
1655
  catch (error) {
@@ -1580,7 +1670,7 @@ async function executePreparedToolCall(prepared, signal, emit, executeTool, abor
1580
1670
  let outcome;
1581
1671
  let bodyStarted = false, bodyClosed = false;
1582
1672
  try {
1583
- const body = () => prepared.tool.execute(prepared.toolCall.id, prepared.args, signal, (partialResult) => {
1673
+ const body = () => runWithCommandSandboxPlan(prepared.sandboxPlan, () => prepared.tool.execute(prepared.toolCall.id, prepared.args, signal, (partialResult) => {
1584
1674
  if (!acceptingUpdates) {
1585
1675
  return;
1586
1676
  }
@@ -1602,7 +1692,7 @@ async function executePreparedToolCall(prepared, signal, emit, executeTool, abor
1602
1692
  onLateCancellation?.(reason);
1603
1693
  });
1604
1694
  updateEvents.push(delivery);
1605
- });
1695
+ }));
1606
1696
  const startBody = () => (bodyClosed ? Promise.resolve(Object.assign(createErrorToolResult("operation not executed: the execution station had already settled this call without running its body"), { isError: true })) : ((bodyStarted = true), body()));
1607
1697
  const result = executeTool !== undefined ? await executeTool({ toolCall: prepared.toolCall, tool: prepared.tool, args: prepared.args }, startBody, signal) : await body();
1608
1698
  bodyClosed = !bodyStarted;
@@ -1733,7 +1823,7 @@ export async function finalizeToolOutcome(toolCall, executed, after, media) {
1733
1823
  const mediaBlocks = toolResultMediaBlocks(result.content);
1734
1824
  if (mediaBlocks !== undefined) {
1735
1825
  const processor = await resolveImageProcessor(media?.imageProcessor);
1736
- const admitted = await admitToolResultMediaBlocks(mediaBlocks, toolCall.name, processor);
1826
+ const admitted = await admitToolResultMediaBlocks(mediaBlocks, toolCall.name, processor, toolResultBytesKeeper(media?.toolResultBytes, toolCall.id));
1737
1827
  result = { ...result, content: admitted.content };
1738
1828
  const unprocessed = firstUnprocessedOverTarget(admitted.content, processor);
1739
1829
  if (admitted.refused.length > 0) {