@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,5 +1,6 @@
1
1
  import {} from "../internal/llm.js";
2
2
  import { BrainError } from "./errors.js";
3
+ import { cacheRetentionDefect } from "./cache-retention.js";
3
4
  import { startsWithInputTooLongAnchor } from "./input-too-long.js";
4
5
  import { DEGENERATE_MESSAGE, trimDegenerateTail } from "./repetition.js";
5
6
  import { NO_WORD, STREAM_TORN_WARNING, createRepetitionPoll, createStreamEndLedger, droppedFramesNote, endingInNoWord, endingWordOf, memberReader, modelOutputInvalidOf, noteResponseModel, nameMissingCause, parseStreamedToolArgs, placeTurnNotes, truncationCauseClause } from "./stream-shared.js";
@@ -11,10 +12,24 @@ import { admitRouteRequest, applyRouteCredentialHeaders, assertServableRequestRo
11
12
  import { requestRouteOf } from "./request-route.js";
12
13
  import { NAMES_AS_WRITTEN, judgeInBandError, resolveProviderDialect, endpointToolNames } from "./provider-dialect.js";
13
14
  import { applyReasoningToRequest, mergeReasoningHeaders } from "./reasoning-request.js";
15
+ import { reasoningTokensOf } from "./usage-reasoning.js";
16
+ import { usageOfStatement } from "./usage-reading.js";
14
17
  import { runStreamingBrain } from "./stream-engine.js";
15
18
  import { refuseRetiredTimeoutKnobs } from "./timeout.js";
16
19
  import { resolveFetch } from "./transport.js";
20
+ import { projectToolSchema } from "./tool-schema-projection.js";
17
21
  const EPHEMERAL = { type: "ephemeral" };
22
+ const CACHE_CONTROL_OF_RETENTION = Object.freeze({
23
+ short: EPHEMERAL,
24
+ long: Object.freeze({ type: "ephemeral", ttl: "1h" }),
25
+ none: undefined,
26
+ });
27
+ function cacheControlFor(cacheBreakpoints, retention) {
28
+ const defect = cacheRetentionDefect(retention, "StreamOptions.cacheRetention");
29
+ if (defect !== undefined)
30
+ throw new BrainError("invalid_request", `config.invalid_argument: ${defect}`);
31
+ return cacheBreakpoints ? CACHE_CONTROL_OF_RETENTION[retention ?? "short"] : undefined;
32
+ }
18
33
  const DOCUMENT_OMITTED_NO_VISION = "[PDF document omitted: the serving model does not support document input; extract the text via Bash instead (e.g. `pdftotext`).]";
19
34
  function textOf(content) {
20
35
  return typeof content === "string"
@@ -151,15 +166,15 @@ function toAnthropicMessages(ctx, model, toolNames) {
151
166
  }
152
167
  return merged;
153
168
  }
154
- function toAnthropicTools(ctx, cacheBreakpoints, toolNames) {
169
+ function toAnthropicTools(ctx, cacheControl, toolNames) {
155
170
  if (!ctx.tools || ctx.tools.length === 0) {
156
171
  return undefined;
157
172
  }
158
173
  return ctx.tools.map((t, i) => ({
159
174
  name: toolNames.sent(t.name),
160
175
  description: t.description,
161
- input_schema: t.parameters,
162
- ...(cacheBreakpoints && i === ctx.tools.length - 1 ? { cache_control: EPHEMERAL } : {}),
176
+ input_schema: projectToolSchema(t.parameters),
177
+ ...(cacheControl !== undefined && i === ctx.tools.length - 1 ? { cache_control: cacheControl } : {}),
163
178
  }));
164
179
  }
165
180
  const NO_CONTENT = "(no content)";
@@ -185,30 +200,17 @@ function anthropicStreamErrorCode(t) {
185
200
  return "server";
186
201
  }
187
202
  }
188
- function computeUsage(model, u) {
189
- const input = u.input_tokens ?? 0;
190
- const output = u.output_tokens ?? 0;
191
- const cacheRead = u.cache_read_input_tokens ?? 0;
192
- const cacheWrite = u.cache_creation_input_tokens ?? 0;
193
- const c = model.cost;
194
- const costInput = (input / 1e6) * (c?.input ?? 0);
195
- const costOutput = (output / 1e6) * (c?.output ?? 0);
196
- const costCacheRead = (cacheRead / 1e6) * (c?.cacheRead ?? 0);
197
- const costCacheWrite = (cacheWrite / 1e6) * (c?.cacheWrite ?? 0);
198
- return {
199
- input,
200
- output,
201
- cacheRead,
202
- cacheWrite,
203
- totalTokens: input + output + cacheRead + cacheWrite,
204
- cost: {
205
- input: costInput,
206
- output: costOutput,
207
- cacheRead: costCacheRead,
208
- cacheWrite: costCacheWrite,
209
- total: costInput + costOutput + costCacheRead + costCacheWrite,
210
- },
211
- };
203
+ function reasoningOf(u) {
204
+ return reasoningTokensOf(u.output_tokens ?? 0, u.thinking_tokens);
205
+ }
206
+ function reportedUsageOf(model, u) {
207
+ return usageOfStatement(model, "input-excludes-cached", {
208
+ input: u.input_tokens,
209
+ output: u.output_tokens,
210
+ cacheRead: u.cache_read_input_tokens,
211
+ cacheWrite: u.cache_creation_input_tokens,
212
+ cacheWriteLong: u.ephemeral_1h_input_tokens,
213
+ }, reasoningOf(u));
212
214
  }
213
215
  function closeToolUseBlock(acc, responseIds, closed) {
214
216
  if (acc.closedTc)
@@ -251,6 +253,8 @@ function readEvent(raw) {
251
253
  output_tokens: usageSeat.count(u.output_tokens),
252
254
  cache_read_input_tokens: usageSeat.count(u.cache_read_input_tokens),
253
255
  cache_creation_input_tokens: usageSeat.count(u.cache_creation_input_tokens),
256
+ ephemeral_1h_input_tokens: usageSeat.count(usageSeat.object(u.cache_creation)?.ephemeral_1h_input_tokens),
257
+ thinking_tokens: usageSeat.claimIn(u.output_tokens_details, "thinking_tokens"),
254
258
  };
255
259
  };
256
260
  const done = (event) => ({ event, outOfShape: frame.outOfShape, usageUnreadable: usageSeat.outOfShape });
@@ -347,14 +351,15 @@ export function createAnthropicBrain(given = {}) {
347
351
  const routeAdmission = admitRouteRequest(routed, routeCredential, { baseUrl: config.baseUrl, laneDefault: ANTHROPIC_DEFAULT_BASE_URL });
348
352
  const apiKey = routeCredential.apiKey;
349
353
  const nonEmptyBlocks = context.systemBlocks?.filter((b) => b.text.length > 0);
354
+ const cacheControl = cacheControlFor(cacheBreakpoints, options?.cacheRetention);
350
355
  const system = nonEmptyBlocks?.length
351
356
  ? nonEmptyBlocks.map((b) => ({
352
357
  type: "text",
353
358
  text: b.text,
354
- ...(cacheBreakpoints && b.cacheControlBoundary ? { cache_control: EPHEMERAL } : {}),
359
+ ...(cacheControl !== undefined && b.cacheControlBoundary ? { cache_control: cacheControl } : {}),
355
360
  }))
356
361
  : context.systemPrompt
357
- ? [{ type: "text", text: context.systemPrompt, ...(cacheBreakpoints ? { cache_control: EPHEMERAL } : {}) }]
362
+ ? [{ type: "text", text: context.systemPrompt, ...(cacheControl !== undefined ? { cache_control: cacheControl } : {}) }]
358
363
  : undefined;
359
364
  const body = {
360
365
  model: model.id,
@@ -364,7 +369,7 @@ export function createAnthropicBrain(given = {}) {
364
369
  };
365
370
  if (system)
366
371
  body.system = system;
367
- const tools = toAnthropicTools(context, cacheBreakpoints, builtToolNames);
372
+ const tools = toAnthropicTools(context, cacheControl, builtToolNames);
368
373
  if (tools)
369
374
  body.tools = tools;
370
375
  const anthCompat = (model.compat ?? {});
@@ -452,11 +457,14 @@ export function createAnthropicBrain(given = {}) {
452
457
  let messageStopped = false;
453
458
  const afterEnd = createStreamEndLedger(ctrl.providerWords);
454
459
  const streamEnded = () => stopReason != null || messageStopped;
460
+ const endedWhole = () => streamEnded() && (messageStopped || ![...blocks.values()].some((b) => b.stopped !== true));
455
461
  const mergeDeltaUsage = (u) => {
456
462
  if (!u)
457
463
  return;
458
464
  if (u.output_tokens !== undefined)
459
465
  usageRaw.output_tokens = u.output_tokens;
466
+ if (u.thinking_tokens !== undefined)
467
+ usageRaw.thinking_tokens = u.thinking_tokens;
460
468
  if (u.input_tokens != null && u.input_tokens > 0)
461
469
  usageRaw.input_tokens = u.input_tokens;
462
470
  if (u.cache_read_input_tokens != null && u.cache_read_input_tokens > 0)
@@ -464,11 +472,13 @@ export function createAnthropicBrain(given = {}) {
464
472
  if (u.cache_creation_input_tokens != null && u.cache_creation_input_tokens > 0) {
465
473
  usageRaw.cache_creation_input_tokens = u.cache_creation_input_tokens;
466
474
  }
475
+ if (u.ephemeral_1h_input_tokens != null && u.ephemeral_1h_input_tokens > 0)
476
+ usageRaw.ephemeral_1h_input_tokens = u.ephemeral_1h_input_tokens;
477
+ };
478
+ const reportedUsage = () => {
479
+ const reading = reportedUsageOf(model, usageRaw);
480
+ return { usage: reading.usage, ...(reading.missing || usageUnreadable ? { usageMissing: true } : {}) };
467
481
  };
468
- const reportedUsage = () => ({
469
- usage: computeUsage(model, usageRaw),
470
- ...(Object.keys(usageRaw).length === 0 || usageUnreadable ? { usageMissing: true } : {}),
471
- });
472
482
  const wordOf = (v) => (typeof v === "string" && v !== "" ? v : NO_WORD);
473
483
  const refuseAfterEnd = ({ event: evt, outOfShape }) => {
474
484
  switch (evt.kind) {
@@ -495,6 +505,9 @@ export function createAnthropicBrain(given = {}) {
495
505
  case "unreadable":
496
506
  afterEnd.note("content", NO_WORD);
497
507
  return;
508
+ case "message_stop":
509
+ messageStopped = true;
510
+ return;
498
511
  default:
499
512
  return;
500
513
  }
@@ -587,6 +600,7 @@ export function createAnthropicBrain(given = {}) {
587
600
  usageRaw.input_tokens = u.input_tokens;
588
601
  usageRaw.cache_read_input_tokens = u.cache_read_input_tokens;
589
602
  usageRaw.cache_creation_input_tokens = u.cache_creation_input_tokens;
603
+ usageRaw.ephemeral_1h_input_tokens = u.ephemeral_1h_input_tokens;
590
604
  }
591
605
  break;
592
606
  }
@@ -813,7 +827,7 @@ export function createAnthropicBrain(given = {}) {
813
827
  emptyNoFinish ||
814
828
  (toolError !== undefined && noUsableContent) ||
815
829
  (truncatedEmpty && !dynamicCut && !staticReasoningCut);
816
- const tornWithContent = !errored && opts?.truncated !== true && !streamEnded() && !noUsableContent && !degenerate;
830
+ const tornWithContent = !errored && opts?.truncated !== true && !endedWhole() && !noUsableContent && !degenerate;
817
831
  const errorMessageOut = tornWithContent ? (errorMessage ? `${errorMessage}\n${STREAM_TORN_WARNING}` : STREAM_TORN_WARNING) : errorMessage;
818
832
  const errorKind = degenerate
819
833
  ? "degenerate"
@@ -0,0 +1,11 @@
1
+ /**
2
+ * A Brain's non-streaming face, read the one way every layer that dispatches a request to a Brain reads it — the routing, failover
3
+ * and circuit-breaker decorators and the engine's model lane: the Brain's own `complete` when it has one, called on that Brain and
4
+ * its message returned exactly as it answered (the Brain contract, `core/model-seat.ts`: the summary path's recovery reads
5
+ * `errorKind` off it), else the Brain's `stream` read to its final message — the derivation `brainToRuntime` applies to a Brain
6
+ * with no `complete`. A decorator therefore always has a `complete` face: what a request reaches through it is the face the Brain
7
+ * that serves the request has, decided per request (a router cannot know before it is asked which line serves a model).
8
+ */
9
+ import type { CompleteSimpleFn } from "../internal/llm.js";
10
+ import type { Brain } from "../core/types.js";
11
+ export declare function completeOf(brain: Brain): CompleteSimpleFn;
@@ -0,0 +1,6 @@
1
+ export function completeOf(brain) {
2
+ const own = brain.complete;
3
+ if (own !== undefined)
4
+ return (model, context, options) => own.call(brain, model, context, options);
5
+ return async (model, context, options) => (await brain.stream(model, context, options)).result();
6
+ }
@@ -0,0 +1,2 @@
1
+ /** Why `value` is not a retention value `field` can carry, or `undefined` when it is one (absent included). */
2
+ export declare function cacheRetentionDefect(value: unknown, field: string): string | undefined;
@@ -0,0 +1,9 @@
1
+ import { CACHE_RETENTION_WORDS, isCacheRetention } from "../internal/llm.js";
2
+ import { describeRejectedValue } from "../core/tool-search-setting.js";
3
+ const SHOWN_STRING_MAX = 40;
4
+ export function cacheRetentionDefect(value, field) {
5
+ if (value === undefined || isCacheRetention(value))
6
+ return undefined;
7
+ const shown = typeof value === "string" && value.length > SHOWN_STRING_MAX ? `a string of ${value.length} characters` : describeRejectedValue(value);
8
+ return `${field} must be one of ${CACHE_RETENTION_WORDS.join(" | ")}, or absent (got ${shown}) — a retention value the engine cannot read is refused rather than sent as the default.`;
9
+ }
@@ -1,5 +1,6 @@
1
1
  import { createAssistantMessageEventStream } from "../internal/llm.js";
2
- import { abortLikeName, brainErrorCodeOf, IN_BAND_OUTPUT_CODES, ZERO_USAGE, extractErrorCode } from "./errors.js";
2
+ import { completeOf } from "./brain-faces.js";
3
+ import { abortLikeName, brainErrorCodeOf, codedAbortOf, IN_BAND_OUTPUT_CODES, ZERO_USAGE, extractErrorCode } from "./errors.js";
3
4
  import { emitBrainStatus, emitBrainTelemetry } from "./status-sink.js";
4
5
  import { thrownText } from "../core/thrown-value.js";
5
6
  export const CIRCUIT_OPEN_MARKER = "circuit open for ";
@@ -12,7 +13,7 @@ class InMemoryBreakerState {
12
13
  this.m.set(k, s);
13
14
  }
14
15
  }
15
- function errorAssistantMessage(model, code, detail, stopReason = "error") {
16
+ function errorAssistantMessage(model, code, detail, stopReason, sent) {
16
17
  return {
17
18
  role: "assistant",
18
19
  content: [{ type: "text", text: "" }],
@@ -22,6 +23,7 @@ function errorAssistantMessage(model, code, detail, stopReason = "error") {
22
23
  stopReason,
23
24
  errorMessage: `[${code}] ${detail}`,
24
25
  usage: ZERO_USAGE,
26
+ ...(sent ? { usageMissing: true } : {}),
25
27
  timestamp: Date.now(),
26
28
  };
27
29
  }
@@ -103,23 +105,42 @@ export function createCircuitBreakerBrain(inner, opts = {}) {
103
105
  state.set(key, { phase: "closed", failures: 0 });
104
106
  }
105
107
  };
108
+ const admit = (model, key, options) => {
109
+ const bypass = options?.resilience?.bypassBreaker === true;
110
+ const decision = bypass ? { pass: true } : tryPass(key);
111
+ if (decision.pass)
112
+ return { key, bypass };
113
+ emitBrainStatus({
114
+ phase: "circuit_open",
115
+ detail: "repeated errors, pausing briefly",
116
+ ...(decision.retryInMs !== undefined
117
+ ? { retryInMs: decision.retryInMs, retryInSec: Math.ceil(decision.retryInMs / 1000) }
118
+ : {}),
119
+ });
120
+ return { refused: errorAssistantMessage(model, "network", `${CIRCUIT_OPEN_MARKER}${key}`, "error", false) };
121
+ };
122
+ const answeredCode = (message, options) => {
123
+ const failed = message.stopReason === "error" && options?.signal?.aborted !== true;
124
+ const rawCode = extractErrorCode(message.errorMessage);
125
+ const breakerCode = rawCode === undefined ? "http" : IN_BAND_OUTPUT_CODES.has(rawCode) && !countCodes.has(rawCode) ? "http" : rawCode;
126
+ return failed ? breakerCode : options?.signal?.aborted ? (codedAbortOf(options.signal) ?? "http") : undefined;
127
+ };
128
+ const thrownAnswer = (model, e, key, bypass, options) => {
129
+ const aborted = options?.signal?.aborted === true || abortLikeName(e) === "AbortError";
130
+ const code = brainErrorCodeOf(e) ?? "network";
131
+ record(key, aborted ? (codedAbortOf(options?.signal) ?? "http") : code, !bypass);
132
+ return errorAssistantMessage(model, code, thrownText(e), aborted ? "aborted" : "error", true);
133
+ };
106
134
  const stream = (model, context, options) => {
107
135
  const out = createAssistantMessageEventStream();
108
136
  const key = keyOf(model);
109
137
  void (async () => {
110
- const bypass = options?.resilience?.bypassBreaker === true;
111
- const decision = bypass ? { pass: true } : tryPass(key);
112
- if (!decision.pass) {
113
- emitBrainStatus({
114
- phase: "circuit_open",
115
- detail: "repeated errors, pausing briefly",
116
- ...(decision.retryInMs !== undefined
117
- ? { retryInMs: decision.retryInMs, retryInSec: Math.ceil(decision.retryInMs / 1000) }
118
- : {}),
119
- });
120
- out.push({ type: "error", reason: "error", error: errorAssistantMessage(model, "network", `${CIRCUIT_OPEN_MARKER}${key}`) });
138
+ const admitted = admit(model, key, options);
139
+ if ("refused" in admitted) {
140
+ out.push({ type: "error", reason: "error", error: admitted.refused });
121
141
  return;
122
142
  }
143
+ const { bypass } = admitted;
123
144
  try {
124
145
  const inner_ = await inner.stream(model, context, options);
125
146
  let terminal;
@@ -131,10 +152,7 @@ export function createCircuitBreakerBrain(inner, opts = {}) {
131
152
  out.push(ev);
132
153
  }
133
154
  const message = await inner_.result();
134
- const failed = message.stopReason === "error" && options?.signal?.aborted !== true;
135
- const rawCode = extractErrorCode(message.errorMessage);
136
- const breakerCode = rawCode === undefined ? "http" : IN_BAND_OUTPUT_CODES.has(rawCode) && !countCodes.has(rawCode) ? "http" : rawCode;
137
- record(key, failed ? breakerCode : options?.signal?.aborted ? "http" : undefined, !bypass);
155
+ record(key, answeredCode(message, options), !bypass);
138
156
  try {
139
157
  out.push(terminal ?? { type: "done", reason: message.stopReason, message });
140
158
  }
@@ -142,18 +160,25 @@ export function createCircuitBreakerBrain(inner, opts = {}) {
142
160
  }
143
161
  }
144
162
  catch (e) {
145
- const aborted = options?.signal?.aborted === true || abortLikeName(e) === "AbortError";
146
- const code = brainErrorCodeOf(e) ?? "network";
147
- record(key, aborted ? "http" : code, !bypass);
148
- out.push({
149
- type: "error",
150
- reason: aborted ? "aborted" : "error",
151
- error: errorAssistantMessage(model, code, thrownText(e), aborted ? "aborted" : "error"),
152
- });
163
+ const message = thrownAnswer(model, e, key, bypass, options);
164
+ out.push({ type: "error", reason: message.stopReason === "aborted" ? "aborted" : "error", error: message });
153
165
  }
154
166
  })();
155
167
  return out;
156
168
  };
169
+ const complete = async (model, context, options) => {
170
+ const admitted = admit(model, keyOf(model), options);
171
+ if ("refused" in admitted)
172
+ return admitted.refused;
173
+ try {
174
+ const message = await completeOf(inner)(model, context, options);
175
+ record(admitted.key, answeredCode(message, options), !admitted.bypass);
176
+ return message;
177
+ }
178
+ catch (e) {
179
+ return thrownAnswer(model, e, admitted.key, admitted.bypass, options);
180
+ }
181
+ };
157
182
  const adjudicateRoute = (model, perModelAuth) => inner.adjudicateRoute?.(model, perModelAuth);
158
- return { stream, adjudicateRoute };
183
+ return { stream, complete, adjudicateRoute };
159
184
  }
@@ -8,7 +8,10 @@
8
8
  import type { Usage } from "../internal/llm.js";
9
9
  import type { ProviderCondition, ProviderConditionSource } from "./provider-dialect.js";
10
10
  /** A zeroed `Usage` for synthetic error/short-circuit assistant messages (no tokens spent). Shared by
11
- * the circuit-breaker, degradation, and routing brains so the empty-usage shape lives in one place. */
11
+ * the circuit-breaker, degradation, and routing brains so the empty-usage shape lives in one place.
12
+ * Every member is a KNOWN zero — no request went out, so nothing was read from or written to a cache either (the cache
13
+ * members are present, unlike a usage no frame reported). Where a request may have gone out, the message carries
14
+ * `usageMissing` beside it and every member is then a lower bound. */
12
15
  export declare const ZERO_USAGE: Usage;
13
16
  /** The single source of truth for brain error codes — the type, the `[code]` parser, and the prefix
14
17
  * stripper all derive from this one list, so adding a code can't silently diverge across call sites.
@@ -77,6 +80,9 @@ export declare class BrainError extends Error {
77
80
  readonly providerConditionSource?: ProviderConditionSource;
78
81
  /** With a `quota_exhausted` condition whose evidence stated it: when the quota lifts, wall-clock epoch ms. */
79
82
  readonly providerResetAtMs?: number;
83
+ /** The provider's own sentence for the failure, read off its error envelope and carried through the one pass (`provider-message.ts`). Lifted
84
+ * onto `AssistantMessage.providerMessage`. Absent when the response stated no trusted sentence. */
85
+ readonly providerMessage?: string;
80
86
  /** The failed response's body did not end (cut at the read bound, torn, unreadable), so it stated nothing: no
81
87
  * verdict, word or context-limit reading came from it, and the prefix quoted in the message is no evidence
82
88
  * either. Lifted onto `AssistantMessage.errorBodyIncomplete`. */
@@ -98,6 +104,7 @@ export declare class BrainError extends Error {
98
104
  source: ProviderConditionSource;
99
105
  resetAtMs?: number;
100
106
  };
107
+ providerMessage?: string;
101
108
  errorBodyIncomplete?: boolean;
102
109
  imageUnprocessable?: boolean;
103
110
  toolSchemaRefused?: string;
@@ -265,6 +272,13 @@ export declare function abortLikeName(err: unknown): "AbortError" | "TimeoutErro
265
272
  * rather than testing `instanceof BrainError`, which walks a chain a revoked proxy traps — and the one
266
273
  * site that did so sits in an async IIFE with no `.catch`. */
267
274
  export declare function brainErrorCodeOf(e: unknown): BrainErrorCode | undefined;
275
+ /**
276
+ * What an aborted call's signal says about the failure: the brain code its abort REASON carries, else `undefined`. The one reading
277
+ * of an aborted call at every observation edge (a circuit breaker, the model lane): an abort whose reason is a coded brain failure
278
+ * — the model lane cutting a hop at its first-token deadline aborts with a `network` `BrainError` — is that failure; any other
279
+ * abort (a caller cancelling, which hands no coded reason) is neutral. Not aborted ⇒ `undefined`.
280
+ */
281
+ export declare function codedAbortOf(signal: AbortSignal | undefined): BrainErrorCode | undefined;
268
282
  /** What a thrown brain failure says about itself in machine words: its code, and the structural cause its minter
269
283
  * declared (input too long, or ruled out; an image the provider could not process). Empty for a value that carries no
270
284
  * brain code. */
@@ -22,6 +22,7 @@ export class BrainError extends Error {
22
22
  providerCondition;
23
23
  providerConditionSource;
24
24
  providerResetAtMs;
25
+ providerMessage;
25
26
  errorBodyIncomplete;
26
27
  imageUnprocessable;
27
28
  toolSchemaRefused;
@@ -44,6 +45,8 @@ export class BrainError extends Error {
44
45
  if (opts.verdict.resetAtMs !== undefined)
45
46
  this.providerResetAtMs = opts.verdict.resetAtMs;
46
47
  }
48
+ if (typeof opts?.providerMessage === "string")
49
+ this.providerMessage = opts.providerMessage;
47
50
  if (opts?.errorBodyIncomplete === true)
48
51
  this.errorBodyIncomplete = true;
49
52
  if (opts?.imageUnprocessable === true)
@@ -253,6 +256,11 @@ export function brainErrorCodeOf(e) {
253
256
  const code = readMember(e, "code");
254
257
  return typeof code === "string" && BRAIN_ERROR_CODES.includes(code) ? code : undefined;
255
258
  }
259
+ export function codedAbortOf(signal) {
260
+ if (signal === undefined || signal.aborted !== true)
261
+ return undefined;
262
+ return brainErrorCodeOf(signal.reason);
263
+ }
256
264
  export function thrownBrainFailure(e) {
257
265
  const code = brainErrorCodeOf(e);
258
266
  if (code === undefined)
@@ -11,6 +11,12 @@ import type { Brain } from "../core/types.js";
11
11
  * (including a mid-stream error or abort) is propagated rather than restarted, so the consumer never
12
12
  * sees duplicate `start`/text events. The last brain's result is always final.
13
13
  *
14
+ * The non-streaming face walks the same brains the same way, each through ITS non-streaming face (`completeOf`): a message that
15
+ * carries content is the answer, whatever its outcome.
16
+ *
17
+ * Every gateway moved off is listed on the answer (the model lane's left-behind list: `leftEntriesOf` / `carryLeftBehind`), with the
18
+ * usage its own message reported — what a failed attempt cost is billed, at the request's model.
19
+ *
14
20
  * Each underlying brain keeps its own retry policy (e.g. `createOpenAIBrain({ maxRetries })`);
15
21
  * failover is the cross-gateway layer on top.
16
22
  */
@@ -1,12 +1,23 @@
1
- import { createAssistantMessageEventStream, } from "../internal/llm.js";
1
+ import { createAssistantMessageEventStream } from "../internal/llm.js";
2
2
  import { abortLikeName, extractErrorCode } from "./errors.js";
3
3
  import { emitBrainTelemetry } from "./status-sink.js";
4
- import { passthroughStream } from "./degrading.js";
5
- import { thrownText } from "../core/thrown-value.js";
4
+ import { carriesContent, carryLeftBehind, errorMessageOf, gateReadingOf, leftEntriesOf, passthroughStream, terminalMessage, terminalOf, } from "./model-lane.js";
5
+ import { completeOf } from "./brain-faces.js";
6
+ import { GATEWAY_HOP_GATE } from "../core/model-fallbacks.js";
6
7
  export function createFailoverBrain(brains) {
7
8
  if (brains.length === 0) {
8
9
  throw new Error("createFailoverBrain: need at least one brain");
9
10
  }
11
+ const reportServed = (i, lastFailedCode) => {
12
+ if (i === 0)
13
+ return;
14
+ emitBrainTelemetry({
15
+ kind: "failover",
16
+ servedIndex: i,
17
+ total: brains.length,
18
+ ...(lastFailedCode !== undefined ? { errorCode: lastFailedCode } : {}),
19
+ });
20
+ };
10
21
  const stream = (model, context, options) => {
11
22
  if (options?.resilience?.allowFailover === false) {
12
23
  return passthroughStream(brains[0], model, context, options);
@@ -14,10 +25,11 @@ export function createFailoverBrain(brains) {
14
25
  const out = createAssistantMessageEventStream();
15
26
  void (async () => {
16
27
  let lastFailedCode;
28
+ const left = [];
17
29
  try {
18
- for (let i = 0; i < brains.length; i++) {
30
+ for (const [i, brain] of brains.entries()) {
19
31
  const isLast = i === brains.length - 1;
20
- const inner = await brains[i].stream(model, context, options);
32
+ const inner = await brain.stream(model, context, options);
21
33
  let sawContent = false;
22
34
  let heldStart;
23
35
  let terminal;
@@ -38,52 +50,55 @@ export function createFailoverBrain(brains) {
38
50
  out.push(ev);
39
51
  }
40
52
  const message = await inner.result();
41
- const cleanUpfrontFailure = message.stopReason === "error" &&
42
- options?.signal?.aborted !== true &&
43
- !sawContent &&
44
- message.errorKind !== "length_empty" &&
45
- message.errorKind !== "image_unprocessable" &&
46
- message.errorKind !== "tool_schema_refused";
53
+ const cleanUpfrontFailure = !sawContent && gateReadingOf(message, i, false, options?.signal?.aborted === true, GATEWAY_HOP_GATE) !== undefined;
47
54
  if (cleanUpfrontFailure && !isLast) {
48
55
  lastFailedCode = extractErrorCode(message.errorMessage);
56
+ left.push(...leftEntriesOf(message, model.id));
49
57
  continue;
50
58
  }
51
- if (i > 0) {
52
- emitBrainTelemetry({
53
- kind: "failover",
54
- servedIndex: i,
55
- total: brains.length,
56
- ...(lastFailedCode !== undefined ? { errorCode: lastFailedCode } : {}),
57
- });
58
- }
59
+ reportServed(i, lastFailedCode);
60
+ const served = terminal ?? terminalOf(message);
61
+ carryLeftBehind(terminalMessage(served, message), left);
59
62
  if (!sawContent && heldStart)
60
63
  out.push(heldStart);
61
- out.push(terminal ?? {
62
- type: "done",
63
- reason: message.stopReason,
64
- message,
65
- });
64
+ out.push(served);
66
65
  return;
67
66
  }
68
67
  }
69
68
  catch (e) {
70
69
  const aborted = options?.signal?.aborted === true || abortLikeName(e) !== undefined;
71
- const errorMsg = {
72
- role: "assistant",
73
- content: [{ type: "text", text: "" }],
74
- api: model.api,
75
- provider: model.provider,
76
- model: model.id,
77
- stopReason: aborted ? "aborted" : "error",
78
- errorMessage: thrownText(e),
79
- usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
80
- timestamp: Date.now(),
81
- };
82
- out.push({ type: "error", reason: aborted ? "aborted" : "error", error: errorMsg });
70
+ const shell = errorMessageOf(model, e, aborted);
71
+ carryLeftBehind(shell, left);
72
+ out.push({ type: "error", reason: aborted ? "aborted" : "error", error: shell });
83
73
  }
84
74
  })();
85
75
  return out;
86
76
  };
77
+ const complete = async (model, context, options) => {
78
+ const span = options?.resilience?.allowFailover === false ? 1 : brains.length;
79
+ let lastFailedCode;
80
+ const left = [];
81
+ for (let i = 0;; i++) {
82
+ let message;
83
+ try {
84
+ message = await completeOf(brains[i])(model, context, options);
85
+ }
86
+ catch (e) {
87
+ const shell = errorMessageOf(model, e, options?.signal?.aborted === true || abortLikeName(e) !== undefined);
88
+ carryLeftBehind(shell, left);
89
+ return shell;
90
+ }
91
+ const cleanUpfrontFailure = !carriesContent(message) && gateReadingOf(message, i, false, options?.signal?.aborted === true, GATEWAY_HOP_GATE) !== undefined;
92
+ if (cleanUpfrontFailure && i < span - 1) {
93
+ lastFailedCode = extractErrorCode(message.errorMessage);
94
+ left.push(...leftEntriesOf(message, model.id));
95
+ continue;
96
+ }
97
+ reportServed(i, lastFailedCode);
98
+ carryLeftBehind(message, left);
99
+ return message;
100
+ }
101
+ };
87
102
  const adjudicateRoute = (model, perModelAuth) => {
88
103
  let firstRefusal;
89
104
  let sawUnjudged = false;
@@ -99,5 +114,5 @@ export function createFailoverBrain(brains) {
99
114
  }
100
115
  return sawUnjudged ? undefined : firstRefusal;
101
116
  };
102
- return { stream, adjudicateRoute };
117
+ return { stream, complete, adjudicateRoute };
103
118
  }
@@ -7,6 +7,7 @@
7
7
  * sentence that drifts is a string consumers grep for.
8
8
  */
9
9
  import type { Model } from "../internal/llm.js";
10
+ import type { RenderedLocale } from "../prompt-assembly/catalog/schema.js";
10
11
  import { type CapabilityDeclaration } from "./model-capability.js";
11
12
  /** Why a request's images are withheld from the SERVING model: the entry's image declaration, when it is not held
12
13
  * (the withheld-capability report's `cause`, `status-sink.ts`). */
@@ -31,6 +32,10 @@ export declare function reportImagesWithheld(withhold: ImageWithhold, count: num
31
32
  export declare const IMAGE_OMITTED_NO_VISION = "[image omitted: the serving model does not support image input]";
32
33
  /** {@link IMAGE_OMITTED_NO_VISION}, counted — a batch of dropped images states how many were lost. */
33
34
  export declare function imagesOmittedNoVisionNote(count: number): string;
35
+ /** The provenance line before a tool's images where a lane carries them in a synthetic user message (the endpoint
36
+ * takes images only on a user message): the catalog's image-prefix message for one image or several, naming the
37
+ * tool calls (`ids`) they came from — in the request's locale (`Context.promptLocale`; absent ⇒ canonical). */
38
+ export declare function toolImagesPrefix(count: number, ids: string, locale?: RenderedLocale): string;
34
39
  /** An image content block carrying both wire fields — the only shape any lane can actually send. */
35
40
  export interface SendableImage {
36
41
  type: "image";
@@ -1,3 +1,4 @@
1
+ import { engineTextFor } from "../prompt-assembly/engine-text.js";
1
2
  import { capabilityHeld, capabilityOf } from "./model-capability.js";
2
3
  import { emitBrainTelemetry, reportCapabilityWithheld } from "./status-sink.js";
3
4
  export function imageWithholdOf(model) {
@@ -16,6 +17,9 @@ export const IMAGE_OMITTED_NO_VISION = "[image omitted: the serving model does n
16
17
  export function imagesOmittedNoVisionNote(count) {
17
18
  return count > 1 ? `[${count} images omitted: the serving model does not support image input]` : IMAGE_OMITTED_NO_VISION;
18
19
  }
20
+ export function toolImagesPrefix(count, ids, locale) {
21
+ return engineTextFor(locale)(count > 1 ? "core/engine.image-prefix-many" : "core/engine.image-prefix-one", { ids });
22
+ }
19
23
  export function sendableImages(blocks) {
20
24
  const out = [];
21
25
  for (const b of blocks) {
@@ -21,7 +21,8 @@ export type CapabilityDeclaration = (typeof CAPABILITY_DECLARATIONS)[number];
21
21
  /**
22
22
  * What the engine does with a capability the entry does not declare, per capability — the only place this is said.
23
23
  * Image input is used (an entry that never filled in `input` keeps the images it was always sent). Reasoning is not:
24
- * no thinking keys go out for an entry that does not declare `reasoning` (the request is the provider's default).
24
+ * no key that turns thinking on goes out for an entry that does not declare `reasoning` (the request is the provider's
25
+ * default); the explicit off is sent to it only where the entry names its wire's dialect (`offSpelling`, brain/reasoning.ts).
25
26
  */
26
27
  export declare const UNKNOWN_CAPABILITY_READS: Readonly<Record<ModelCapability, "held" | "not_held">>;
27
28
  /** The part of a model this module reads (`id` only names the model in a refusal; the structural readers that take a