@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
@@ -0,0 +1,76 @@
1
+ import { ANNOUNCED_LANGUAGE_MAX_CHARS } from "../../internal/harness.js";
2
+ import { mintSystemReminder } from "../reminder-mint.js";
3
+ import { describeRejectedValue } from "../tool-search-setting.js";
4
+ import { inlineUntrusted } from "../untrusted-text.js";
5
+ import { conversationSegmentOf, restateToldSeat } from "./conversation-segment.js";
6
+ export const LANGUAGE_MAX = ANNOUNCED_LANGUAGE_MAX_CHARS;
7
+ export const LANGUAGE_CLEARED = "The language preference was cleared. Match the user's language.";
8
+ export function renderLanguageInstructions(language) {
9
+ const l = inlineUntrusted(language, LANGUAGE_MAX);
10
+ return `# Language
11
+ Always respond in ${l}. Use ${l} for all explanations, comments, and communications with the user. Technical terms and code identifiers should remain in their original form.
12
+ Maintain full orthographic correctness for ${l}, including all required diacritical marks, accents, and special characters. Never substitute accented characters with their ASCII equivalents (e.g., never write "nao" for "não", "fur" for "für", or "loeschen" for "löschen").`;
13
+ }
14
+ export function screenLanguageSeat(seat) {
15
+ if (seat === undefined)
16
+ return undefined;
17
+ const refuse = (why) => {
18
+ throw Object.assign(new Error(`TaskSpec.language ${why} — refused rather than ignored: a declared reply language the engine did not state would run as none.`), { code: "config.language_invalid" });
19
+ };
20
+ if (typeof seat !== "string" || seat.trim() === "")
21
+ return refuse(`must be a non-empty string (got ${describeRejectedValue(seat)})`);
22
+ if (seat.length > LANGUAGE_MAX)
23
+ return refuse(`is ${seat.length} characters, over the ${LANGUAGE_MAX}-character bound`);
24
+ return seat;
25
+ }
26
+ export function languageFrame(told, declared) {
27
+ if (declared !== undefined)
28
+ return told === declared ? undefined : { body: renderLanguageInstructions(declared), value: declared };
29
+ return typeof told === "string" ? { body: LANGUAGE_CLEARED, value: null } : undefined;
30
+ }
31
+ export async function prepareLanguageSeat(input) {
32
+ if (!input.personAgent || (input.declared === undefined && input.told === undefined))
33
+ return undefined;
34
+ const segment = await input.session.getBranch().then(conversationSegmentOf, () => undefined);
35
+ const told = input.told;
36
+ const inSegment = told !== undefined && (segment === undefined ? input.declared === undefined : told.segment === segment);
37
+ const owed = languageFrame(inSegment ? told.value : undefined, input.declared);
38
+ return owed === undefined && input.declared === undefined ? undefined : { ...(owed !== undefined ? { owed } : {}), segment, declared: input.declared };
39
+ }
40
+ export function languageFrameText(prepared) {
41
+ const owed = prepared.languageSeat?.owed;
42
+ return owed === undefined ? undefined : mintSystemReminder(owed.body, prepared.reminderMark);
43
+ }
44
+ export function registerLanguageReceipt(prepared, text) {
45
+ if (prepared.languageSeat?.owed !== undefined)
46
+ prepared.frameReceipts.pending.push({ source: "language", text, commit: () => settleLanguage(prepared) });
47
+ }
48
+ function settleLanguage(prepared) {
49
+ const seat = prepared.languageSeat;
50
+ const owed = seat?.owed;
51
+ if (seat === undefined || owed === undefined)
52
+ return;
53
+ seat.owed = undefined;
54
+ recordLanguage(prepared.announcedListingsRef, prepared.frameReceipts, owed.value, seat.segment);
55
+ }
56
+ function recordLanguage(ref, ledger, value, segment) {
57
+ if (segment === undefined)
58
+ return;
59
+ ref.language = { value, segment };
60
+ ledger.listingSnapshotOwed = true;
61
+ }
62
+ export function languageRestateOption(prepared) {
63
+ const seat = prepared.languageSeat;
64
+ const declared = seat?.declared;
65
+ if (seat === undefined || declared === undefined)
66
+ return {};
67
+ return {
68
+ languageRestate: () => restateToldSeat(prepared, seat, {
69
+ body: renderLanguageInstructions(declared),
70
+ value: declared,
71
+ what: "the language preference",
72
+ carried: seat.owed !== undefined,
73
+ record: (value, segment) => recordLanguage(prepared.announcedListingsRef, prepared.frameReceipts, value, segment),
74
+ }),
75
+ };
76
+ }
@@ -0,0 +1,81 @@
1
+ /**
2
+ * The DRAINED-LEG FRAME SEAT (`RunInternals.onLegFrame`): the one seat a host reads a leg's own frames through when the
3
+ * engine drains that leg's stream itself, the closed set of frames it carries, the address each frame is handed with, and
4
+ * the door both stream entries pass it through.
5
+ *
6
+ * WHICH LEGS. A leg is DRAINED when it was entered through `Runner.runTask` or `Runner.resume`: the engine iterates the
7
+ * leg's stream for the caller, so the caller holds no `TaskStream` and the leg's frames reach it only through this seat
8
+ * (the composition entries — the verify gate, the cascade — dispatch every leg that way). On `Runner.runTaskStream` /
9
+ * `Runner.resumeStream` the caller holds the stream and the same frames ride it, so the seat is REFUSED there
10
+ * (`config.invalid_argument`) rather than delivering every frame twice. The fact "this leg is drained" is the engine's
11
+ * own: the two draining entries mark the exact internals object they hand on, the door takes the mark (once — it is
12
+ * gone after the door reads it), and nothing else in the engine decides it. A copy of the object carries no mark; a
13
+ * bag the engine builds for a child or a workflow leg never carries the seat.
14
+ *
15
+ * WHAT. One frame object per offer, the very object the leg's queue received, shallow-frozen before the push; offered
16
+ * only when the queue accepted it (a closed stream refuses a late frame, and so does the seat). `at` names the leg the
17
+ * frame came from: its task id and the session its rows land in (engine facts), and the composition's label when the
18
+ * dispatcher bound one (`leg`, absent = nobody labelled this leg; the engine never mints one).
19
+ */
20
+ import type { TaskEvent } from "../types.js";
21
+ /** The frames a drained leg offers to `RunInternals.onLegFrame` — closed: a frame type outside it never reaches the seat. */
22
+ export declare const DRAINED_LEG_FRAME_TYPES: readonly ["status", "wiring_manifest", "message_committed", "workspace_changed"];
23
+ /** One frame the seat receives: a `TaskEvent` of one of {@link DRAINED_LEG_FRAME_TYPES}, the object the leg's stream carries. */
24
+ export type DrainedLegFrame = Readonly<Extract<TaskEvent, {
25
+ type: (typeof DRAINED_LEG_FRAME_TYPES)[number];
26
+ }>>;
27
+ /** The kinds of leg a composition labels: the verify gate's implementation / verifier / fix legs and a cascade's rungs. */
28
+ export declare const LEG_LABEL_KINDS: readonly ["impl", "verifier", "fix", "rung"];
29
+ /**
30
+ * A composition's label for the leg it dispatched. `round` is the gate's verification round for `impl` (0, the round
31
+ * before the first), `verifier` (the round it verifies) and `fix` (the round whose findings it answers); for `rung` it is
32
+ * the rung's place on the ladder, from 0. Minted by the dispatcher, frozen, never by the engine.
33
+ */
34
+ export interface LegLabel {
35
+ readonly kind: (typeof LEG_LABEL_KINDS)[number];
36
+ readonly round: number;
37
+ }
38
+ /** Where a frame handed to `RunInternals.onLegFrame` came from. */
39
+ export interface LegAt {
40
+ /** The leg's task id (`TaskResult.taskId` of that leg). */
41
+ readonly taskId: string;
42
+ /** The session the leg's rows land in. */
43
+ readonly sessionId: string;
44
+ /** The composition's label for the leg; absent = nobody labelled it. */
45
+ readonly leg?: LegLabel;
46
+ }
47
+ /** The run's one push of a frame of {@link DRAINED_LEG_FRAME_TYPES}: freeze, push, and offer it to the seat when the queue
48
+ * accepted it. Answers whether the queue accepted it. */
49
+ export type LegFrameOffer = (frame: DrainedLegFrame) => boolean;
50
+ /** A draining entry marks the internals object it is about to hand to the stream entry, immediately before the call. */
51
+ export declare function markDrainedLeg(internals: object | undefined): void;
52
+ /** …and clears it when that call returns or throws, so a mark the door did not take never outlives the call. */
53
+ export declare function forgetDrainedLeg(internals: object | undefined): void;
54
+ /** The stream entry a draining entry hands its leg to: the door's `entry` word. */
55
+ export type LegFrameEntry = "runTaskStream" | "resumeStream";
56
+ /**
57
+ * The ONE read of a caller's `RunInternals` bag: a shallow copy of its own enumerable members (an inherited or non-enumerable member is
58
+ * not read; an accessor is read here, once), fenced ({@link fenced}) — a bag whose read throws is refused by name, `config.invalid_argument`.
59
+ * The door reads the bag through it at both stream entries, and the resume's config judge reads a host's question through it, so the bag a
60
+ * question is judged over is the bag the door hands the leg. Module-internal: not a root export.
61
+ */
62
+ export declare function readLegInternals<T extends object>(internals: T, entry: LegFrameEntry): T;
63
+ /**
64
+ * The seat's refusal when the caller's object answers one the door's copy cannot hold ({@link seatOutsideCopy}): the ONE judgment of a
65
+ * hidden seat, read by the door at both stream entries and by every composition that dispatches its legs through a copy of the caller's
66
+ * bag (the verify gate, the cascade — `withLegIdentity`), so a seat refused by `Runner.runTask` is refused by a composition alike, and
67
+ * the lookup that finds it is fenced once, here.
68
+ */
69
+ export declare function refuseHiddenLegFrameSeat(bag: object, entry: LegFrameEntry): void;
70
+ /**
71
+ * The door every leg passes at its stream entry (`Runner.runTaskStream` before prepare, `Runner.resumeStream` at the
72
+ * admission's head, before anything is read or claimed). Takes the drained mark off the caller's object — once, whatever
73
+ * follows — and refuses a retired seat by name (`config.deps_retired_key`, read off the caller's object as every
74
+ * retired-key door reads, row by row so a lookup that throws is refused by that row's name). Then it reads the bag ONCE — a
75
+ * shallow copy of its own enumerable members, the copy the leg goes on with — and judges the seat on that copy: a seat that is
76
+ * not a function, a seat the copy cannot hold (a prototype's or a non-enumerable one, {@link refuseHiddenLegFrameSeat}), and
77
+ * the seat on a leg the engine does not drain, are refused (`config.invalid_argument`). Every read of the caller's bag here is
78
+ * fenced ({@link fenced}). Answers the copy, so the seat the door judged is the seat the leg offers its frames to: a member that
79
+ * answers the door one value and the leg another cannot pass unjudged.
80
+ */
81
+ export declare function admitLegFrameSeat<T extends object>(internals: T | undefined, entry: LegFrameEntry): T | undefined;
@@ -0,0 +1,68 @@
1
+ import { retiredKeyOf, retiredKeyRefusal } from "../retired-keys.js";
2
+ import { boundedThrownName } from "../thrown-value.js";
3
+ export const DRAINED_LEG_FRAME_TYPES = Object.freeze(["status", "wiring_manifest", "message_committed", "workspace_changed"]);
4
+ export const LEG_LABEL_KINDS = Object.freeze(["impl", "verifier", "fix", "rung"]);
5
+ const drained = new WeakSet();
6
+ export function markDrainedLeg(internals) {
7
+ if (internals !== undefined)
8
+ drained.add(internals);
9
+ }
10
+ export function forgetDrainedLeg(internals) {
11
+ if (internals !== undefined)
12
+ drained.delete(internals);
13
+ }
14
+ const RETIRED_RUN_INTERNALS_KEYS = Object.freeze({
15
+ onStatusEvent: 'a drained leg\'s frames reach one seat now — `RunInternals.onLegFrame(frame, at)`; read `frame.type === "status"` for what this seat was handed (the same frame object)',
16
+ onWiringManifest: 'a drained leg\'s frames reach one seat now — `RunInternals.onLegFrame(frame, at)`; read `frame.type === "wiring_manifest"` and `frame.manifest` for what this seat was handed, `at.leg` for the composition\'s label it took as its second argument',
17
+ });
18
+ function seatOutsideCopy(bag, name) {
19
+ if (Reflect.getOwnPropertyDescriptor(bag, name)?.enumerable === true)
20
+ return false;
21
+ return Reflect.get(bag, name) !== undefined;
22
+ }
23
+ function untouched(entry) {
24
+ return `Nothing was read or started${entry === "resumeStream" ? " (the checkpoint was not read or claimed: it is still pending)" : ""}`;
25
+ }
26
+ function fenced(read, field, what, entry) {
27
+ try {
28
+ return read();
29
+ }
30
+ catch (cause) {
31
+ const thrown = boundedThrownName(cause);
32
+ throw Object.assign(new Error(`${what} could not be read: the read threw ${thrown} — a bag whose read throws is refused rather than ignored or let out as the host's own error. ${untouched(entry)} — hand in a plain bag whose members read without throwing.`), { code: "config.invalid_argument", detail: { field, entry, thrownName: thrown } });
33
+ }
34
+ }
35
+ export function readLegInternals(internals, entry) {
36
+ return fenced(() => ({ ...internals }), "RunInternals", "RunInternals", entry);
37
+ }
38
+ export function refuseHiddenLegFrameSeat(bag, entry) {
39
+ if (!fenced(() => seatOutsideCopy(bag, "onLegFrame"), "onLegFrame", "RunInternals.onLegFrame", entry))
40
+ return;
41
+ throw Object.assign(new Error(`RunInternals.onLegFrame: seat must be an own enumerable member of the bag you hand in — this bag answers one from its prototype or as a non-enumerable property, and the leg reads its own enumerable members only, so a seat it cannot read would hear nothing; refused rather than ignored. ${untouched(entry)} — write the seat as a plain member of the bag.`), { code: "config.invalid_argument", detail: { field: "onLegFrame", entry } });
42
+ }
43
+ export function admitLegFrameSeat(internals, entry) {
44
+ if (internals === undefined)
45
+ return undefined;
46
+ const isDrained = drained.delete(internals);
47
+ for (const [key, replacement] of Object.entries(RETIRED_RUN_INTERNALS_KEYS)) {
48
+ const hit = fenced(() => retiredKeyOf(internals, { [key]: replacement }), key, `RunInternals.${key}`, entry);
49
+ if (hit !== undefined)
50
+ throw retiredKeyRefusal(hit, "RunInternals");
51
+ }
52
+ const read = readLegInternals(internals, entry);
53
+ const seat = read.onLegFrame;
54
+ if (seat === undefined) {
55
+ refuseHiddenLegFrameSeat(internals, entry);
56
+ return read;
57
+ }
58
+ if (typeof seat !== "function") {
59
+ throw Object.assign(new Error(`RunInternals.onLegFrame must be a function (got ${seat === null ? "null" : typeof seat}) — a seat the engine cannot call is refused rather than ignored`), {
60
+ code: "config.invalid_argument",
61
+ detail: { field: "onLegFrame", entry },
62
+ });
63
+ }
64
+ if (!isDrained) {
65
+ throw Object.assign(new Error(`RunInternals.onLegFrame is refused on Runner.${entry}: the seat carries the frames of a leg the engine drains itself (Runner.runTask / Runner.resume), and this entry hands you the leg's stream, where the same frames ride. ${untouched(entry)} — drop the seat here and read the stream, or enter through ${entry === "runTaskStream" ? "Runner.runTask" : "Runner.resume"}.`), { code: "config.invalid_argument", detail: { field: "onLegFrame", entry } });
66
+ }
67
+ return read;
68
+ }
@@ -0,0 +1,34 @@
1
+ /**
2
+ * The run's usage account for the MAIN loop's model calls: one function books one call at the model that made it, and the
3
+ * hops a fallback walk left behind are booked through it before the answer. The model calls made beside the main loop book
4
+ * through `side-call-account.ts` instead; both price a bill the same way (`RunState.degrade.priceOf`), and both fold a call's
5
+ * cache members through the one cache account (`cache-hit-account.ts`).
6
+ */
7
+ import type { Model, Usage } from "../../internal/llm.js";
8
+ import type { ServedReading } from "../../brain/model-lane.js";
9
+ import type { Stats } from "./assemble-result.js";
10
+ import { type CacheMemberMarks } from "./cache-hit-account.js";
11
+ import type { RunState } from "./contracts.js";
12
+ /** One main-loop call as the account booked it. `turnTotal` is the CACHE-INCLUSIVE prompt total (billing + window/budget
13
+ * denominator); `turnUncached` is the protocol-shaped miss count the `promptTokens` / `inputTokens` faces carry; `priced` = the
14
+ * model has a price table (`false` ⇒ the cost is a fabricated 0 and the disclosure faces omit it). */
15
+ export interface BookedCall {
16
+ readonly turnTotal: number;
17
+ readonly turnUncached: number;
18
+ readonly turnCostMicroUsd: number;
19
+ readonly priced: boolean;
20
+ }
21
+ /**
22
+ * Book one main-loop call of `usage` at `model`: re-priced in core from the injected pricing (the brain's own cost total charges
23
+ * cached tokens at full price for OpenAI / DeepSeek), into the leg's stats and the upcoming `turn_end` usage (a turn may make
24
+ * more than one call). Integer micro-USD, summed per call, so a mid-task model or price change is accounted correctly.
25
+ * `usageMissing` = the call's usage is a lower bound (the caller marks the turn and the leg; the cache account leaves the main
26
+ * lane out of the hit rate). A cache member the call did not report marks the turn's frame as it marks the leg's stats.
27
+ */
28
+ export declare function bookMainCall(rs: RunState, stats: Stats, model: Model, usage: Usage, usageMissing: boolean): BookedCall;
29
+ /** Carry one booking's cache marks onto the upcoming `turn_end` (the harness-handlers lane also calls it for a turn that booked no
30
+ * call at all). */
31
+ export declare function noteTurnCacheMarks(rs: RunState, marks: CacheMemberMarks): void;
32
+ /** Book the requests an answer left behind (the lane's hops, the failover decorator's gateways; none for an answer that lists none): each
33
+ * its own bill at its own model and its own `brain.call` row (latency not modeled, as on a side call); a hop whose usage is a lower bound marks the turn and the leg. */
34
+ export declare function bookLeftHops(rs: RunState, stats: Stats, reading: ServedReading | undefined): void;
@@ -0,0 +1,50 @@
1
+ import { emitTrace } from "../trace.js";
2
+ import { bookCacheOperands, cacheTraceMembersOf } from "./cache-hit-account.js";
3
+ import { usageCostMicroUsd } from "./usage-accounting.js";
4
+ export function bookMainCall(rs, stats, model, usage, usageMissing) {
5
+ const price = rs.degrade.priceOf(model);
6
+ const { totalInputTokens: turnTotal, uncachedInputTokens: turnUncached, costMicroUsd: turnCostMicroUsd } = usageCostMicroUsd(price.cacheFamily, usage, price.pricing);
7
+ if (!price.pricingConfigured)
8
+ rs.telemetry.unpricedSpend = true;
9
+ stats.tokens += usage.totalTokens || 0;
10
+ stats.promptTokens += turnUncached;
11
+ stats.totalInputTokens += turnTotal;
12
+ stats.cachedTokens += usage.cacheRead ?? 0;
13
+ stats.cacheWriteTokens += usage.cacheWrite ?? 0;
14
+ stats.cacheWriteTokensLong += usage.cacheWriteLong ?? 0;
15
+ stats.outputTokens += usage.output || 0;
16
+ stats.costMicroUsd += turnCostMicroUsd;
17
+ const marks = bookCacheOperands(stats, "main", { family: price.cacheFamily, usage }, usageMissing, turnTotal);
18
+ rs.turn.turnUsage ??= { inputTokens: 0, totalInputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, costMicroUsd: 0 };
19
+ rs.turn.turnUsage.inputTokens += turnUncached;
20
+ rs.turn.turnUsage.totalInputTokens += turnTotal;
21
+ rs.turn.turnUsage.outputTokens += usage.output || 0;
22
+ rs.turn.turnUsage.cacheReadTokens += usage.cacheRead ?? 0;
23
+ rs.turn.turnUsage.cacheWriteTokens += usage.cacheWrite ?? 0;
24
+ rs.turn.turnUsage.costMicroUsd += turnCostMicroUsd;
25
+ noteTurnCacheMarks(rs, marks);
26
+ return { turnTotal, turnUncached, turnCostMicroUsd, priced: price.pricingConfigured };
27
+ }
28
+ export function noteTurnCacheMarks(rs, marks) {
29
+ if (marks.readUnreported)
30
+ rs.turn.turnCacheMarks.cacheReadUnreported = true;
31
+ if (marks.writeUnreported)
32
+ rs.turn.turnCacheMarks.cacheWriteUnreported = true;
33
+ if (marks.totalLowerBound)
34
+ rs.turn.turnUsageMissing = true;
35
+ }
36
+ export function bookLeftHops(rs, stats, reading) {
37
+ for (const attempt of reading?.attempts ?? []) {
38
+ if (attempt.usageMissing === true) {
39
+ rs.turn.turnUsageMissing = true;
40
+ stats.usageMissing = true;
41
+ }
42
+ const billed = bookMainCall(rs, stats, attempt.model, attempt.usage, attempt.usageMissing === true);
43
+ emitTrace(rs.telemetry.tracer, () => ({
44
+ kind: "brain.call", version: 1, taskId: rs.telemetry.taskId, model: attempt.model.id, provider: attempt.model.provider, turn: stats.turns + 1,
45
+ promptTokens: billed.turnUncached, totalInputTokens: billed.turnTotal, completionTokens: attempt.usage.output || 0,
46
+ ...cacheTraceMembersOf(attempt.usage), latencyMs: 0,
47
+ ...(billed.priced ? { costMicroUsd: billed.turnCostMicroUsd } : {}), ts: Date.now(),
48
+ }));
49
+ }
50
+ }
@@ -4,9 +4,9 @@
4
4
  *
5
5
  * Two faces change a task's MCP roster after prepare has finished — the model's `RefreshMcpTools`
6
6
  * tool and the run handle's `reconnectMcpServer` verb — and what they must do to the roster is the
7
- * same list in the same order: drop the deployment-excluded names, re-fold the safety axes (with the
8
- * non-monotone restore arm on refusal), replace the server's whole name-prefix domain at its own
9
- * anchor, rebuild the harness toolset, and re-mint the roster delta. That list lived inside the
7
+ * same list in the same order: drop the deployment-excluded names, re-fold the safety axes, replace the
8
+ * server's whole name-prefix domain at its own anchor (a listing the fold or the roster's entry bound
9
+ * refuses withdraws the domain instead), rebuild the harness toolset, and re-mint the roster delta. That list lived inside the
10
10
  * refresh tool's execute closure, where the second face could only have copied it; a copy would have
11
11
  * been a second answer to "what does a mid-task roster change consist of".
12
12
  *
@@ -75,15 +75,17 @@ export interface McpRosterReading {
75
75
  /** The names the server listed that the roster did not take (the valve's, the overlay's). */
76
76
  excluded: string[];
77
77
  }
78
- /** What one application did, for the caller's receipt. `applied:false` means the axis fold refused
79
- * and the domain was left exactly as it was (the tables restored) — no roster write happened, so `mounted` is what it held. */
78
+ /** What one application did, for the caller's receipt. `applied:false` means the listing was REFUSED — the axis fold found a
79
+ * contradiction, or the swap would have put the roster over its entry bound — and the server's domain was withdrawn: the refused
80
+ * listing lands as the empty one (`mounted` is `[]`, `removed` every name the domain held), the reading a failed dial gives.
81
+ * `refusal` is the sentence why. */
80
82
  export type McpRosterApplyOutcome = ({
81
83
  applied: true;
82
84
  } & McpRosterReading) | ({
83
85
  applied: false;
84
- foldError: string;
86
+ refusal: string;
85
87
  } & McpRosterReading);
86
- /** What the roster holds of one server with no swap made — the reading of an arm that asserted no roster (a failed refresh, a refused re-dial, a fold refusal).
88
+ /** What the roster holds of one server with no swap made — the reading of an arm that asserted no roster (a failed refresh, a refused re-dial).
87
89
  * A name no server is declared under holds nothing, even when it mints a declared server's prefix. */
88
90
  export declare function rosterHolding(input: Pick<McpRosterApplyInput, "roster" | "declared">, serverName: string): McpRosterReading;
89
91
  /** A refresh or re-dial result read off the roster instead of the server's own listing: `toolCount` is the tools mounted, `added` /
@@ -1,5 +1,5 @@
1
1
  import { valveLeaves } from "../../agents/tool-filter.js";
2
- import { instructionsTaught, instructionsTold, tellInstructions, toolNamesOfServer, withdrawInstructionAdds } from "../mounted-mcp.js";
2
+ import { instructionsTaught, tellInstructions, toolNamesOfServer, withdrawInstructionAdds } from "../mounted-mcp.js";
3
3
  import { deliverEngineNotice } from "../types.js";
4
4
  import { thrownText } from "../thrown-value.js";
5
5
  export function rosterHolding(input, serverName) {
@@ -16,7 +16,7 @@ export function settledOnRoster(result, reading, roster) {
16
16
  function settleInstructions(lane, delta, taught) {
17
17
  if (!taught)
18
18
  return withdrawInstructionAdds(lane, delta.server);
19
- if (delta.instructions !== undefined && !instructionsTold(lane, delta.server) && !lane.pendingAdds.some((e) => e.server === delta.server))
19
+ if (delta.instructions !== undefined)
20
20
  tellInstructions(lane, delta.instructions);
21
21
  }
22
22
  export function applyMcpRosterDelta(input, delta) {
@@ -26,35 +26,34 @@ export function applyMcpRosterDelta(input, delta) {
26
26
  const leaves = valveLeaves(spec, toolFaceSnapshot.selector);
27
27
  const pushable = delta.tools.filter(leaves);
28
28
  const valveExcluded = delta.tools.filter((t) => !leaves(t)).map((t) => t.name);
29
- const domainSnapshot = (m) => new Map([...m].filter(([name]) => name.startsWith(delta.prefix)));
30
- const restoreDomain = (m, snap) => {
29
+ const clearDomain = (m) => {
31
30
  for (const name of [...m.keys()])
32
31
  if (name.startsWith(delta.prefix))
33
32
  m.delete(name);
34
- for (const [name, v] of snap)
35
- m.set(name, v);
36
33
  };
37
- const priorDomainEffects = domainSnapshot(toolEffects);
38
- const priorDomainNegatives = domainSnapshot(axisExplicitNegatives);
39
- for (const name of priorDomainEffects.keys())
40
- toolEffects.delete(name);
41
- for (const name of priorDomainNegatives.keys())
42
- axisExplicitNegatives.delete(name);
34
+ clearDomain(toolEffects);
35
+ clearDomain(axisExplicitNegatives);
36
+ const meta = { source: "mcp", mountedBy: "optional", origin: { peer: delta.server } };
37
+ let refusal;
43
38
  try {
44
39
  foldProtocolAxes(delta.axes.filter((a) => !valveExcluded.includes(a.name)), "MCP");
40
+ roster.replaceDomain(delta.prefix, withFaces(pushable, delta.server).map((t) => remoteToolOffload(t)), meta);
45
41
  }
46
- catch (foldErr) {
47
- restoreDomain(toolEffects, priorDomainEffects);
48
- restoreDomain(axisExplicitNegatives, priorDomainNegatives);
49
- settleInstructions(input.instructionsDelta, delta, instructionsTaught(leaves, delta.server, roster.tools, delta.tools));
50
- return { applied: false, foldError: thrownText(foldErr), ...rosterHolding(input, delta.server) };
42
+ catch (refused) {
43
+ refusal = thrownText(refused);
51
44
  }
52
- roster.replaceDomain(delta.prefix, withFaces(pushable, delta.server).map((t) => remoteToolOffload(t)), { source: "mcp", mountedBy: "optional", origin: { peer: delta.server } });
45
+ if (refusal !== undefined) {
46
+ clearDomain(toolEffects);
47
+ clearDomain(axisExplicitNegatives);
48
+ roster.replaceDomain(delta.prefix, [], meta);
49
+ }
50
+ const listed = refusal === undefined ? delta.tools : [];
53
51
  const mounted = domainNow();
54
52
  const heldNow = new Set(mounted);
55
53
  const heldBefore = new Set(before);
56
- settleInstructions(input.instructionsDelta, delta, instructionsTaught(leaves, delta.server, roster.tools, delta.tools));
57
- return { applied: true, mounted, added: mounted.filter((n) => !heldBefore.has(n)), removed: before.filter((n) => !heldNow.has(n)), excluded: delta.tools.map((t) => t.name).filter((n) => !heldNow.has(n)) };
54
+ settleInstructions(input.instructionsDelta, delta, instructionsTaught(leaves, delta.server, roster.tools, listed));
55
+ const reading = { mounted, added: mounted.filter((n) => !heldBefore.has(n)), removed: before.filter((n) => !heldNow.has(n)), excluded: listed.map((t) => t.name).filter((n) => !heldNow.has(n)) };
56
+ return refusal === undefined ? { applied: true, ...reading } : { applied: false, refusal, ...reading };
58
57
  }
59
58
  export async function commitMcpRosterChanges(input) {
60
59
  await input.rebuildHarnessToolsRef.current?.();
@@ -71,7 +70,7 @@ export async function redialMcpServer(input, server) {
71
70
  const outcome = applyMcpRosterDelta(input, { server: listed.server, prefix: listed.prefix, tools: listed.tools, axes: listed.axes ?? [], dropped: listed.dropped ?? [] });
72
71
  result = settledOnRoster(listed, outcome, input.roster);
73
72
  if (!outcome.applied)
74
- input.deps.onError?.(Object.assign(new Error(`MCP re-dial of "${server}" connected but its safety-axis fold refused, so its tools were not mounted: ${outcome.foldError}`), { code: "mcp.server_unavailable" }), { phase: "mcp", sessionId: input.sessionId });
73
+ input.deps.onError?.(Object.assign(new Error(`MCP re-dial of "${server}" connected but its tool listing was refused, so none of its tools are mounted: ${outcome.refusal}`), { code: "mcp.server_unavailable" }), { phase: "mcp", sessionId: input.sessionId });
75
74
  const ungated = await commitMcpRosterChanges(input);
76
75
  if (ungated !== undefined)
77
76
  input.deps.onError?.(Object.assign(new Error(ungated), { code: "mcp.server_unavailable" }), { phase: "mcp", sessionId: input.sessionId });
@@ -22,6 +22,8 @@ import type { EngineNotice } from "../engine-notice.js";
22
22
  /** The slice of `RunnerDeps` this resolver reads (pass the deps object itself). */
23
23
  export interface MemoryConsolidationDriverDeps {
24
24
  brain: Brain;
25
+ modelFallback?: unknown;
26
+ cacheRetention?: unknown;
25
27
  models?: Record<string, Model>;
26
28
  tiers?: Record<string, ModelRef>;
27
29
  roles?: ModelRoles;
@@ -1,4 +1,6 @@
1
+ import { describeRejectedValue } from "../tool-search-setting.js";
1
2
  import { brainToRuntime } from "../runtime.js";
3
+ import { modelLaneBrainOf } from "./model-lane-seat.js";
2
4
  import { catalogOfDeps, resolveTaskModel, roleModelIfSet, unheldChainRefusal } from "../roles.js";
3
5
  import { isAliasModelId, openAiCompatChatSeat } from "../memory-engine/distiller.js";
4
6
  import { runMemoryConsolidationDriver } from "../memory-engine/consolidation-driver.js";
@@ -20,7 +22,7 @@ export function resolveMemoryConsolidationDriver(deps) {
20
22
  let model;
21
23
  if (typeof seat?.chat === "function") {
22
24
  if (typeof seat.model !== "string" || seat.model.trim() === "" || isAliasModelId(seat.model)) {
23
- throw seatRefusal(`memoryConsolidationDriver.chat is a bare function, so memoryConsolidationDriver.model must carry the EXPLICIT model id it serves (got ${JSON.stringify(seat.model)}).`);
25
+ throw seatRefusal(`memoryConsolidationDriver.chat is a bare function, so memoryConsolidationDriver.model must carry the EXPLICIT model id it serves (got ${describeRejectedValue(seat.model)}).`);
24
26
  }
25
27
  chat = seat.chat;
26
28
  model = seat.model;
@@ -39,7 +41,7 @@ export function resolveMemoryConsolidationDriver(deps) {
39
41
  throw seatRefusal(`the resolved consolidation model id ${JSON.stringify(resolved.id)} is an alias spelling — an alias can be re-pointed upstream and would move the run with no trace in the archive; bind an explicit id.`);
40
42
  }
41
43
  model = resolved.id;
42
- const runtime = brainToRuntime(deps.brain);
44
+ const runtime = brainToRuntime(modelLaneBrainOf(deps));
43
45
  chat = async (req) => {
44
46
  const auth = await deps.getApiKeyAndHeaders?.(resolved);
45
47
  const message = await runtime.completeSimple(resolved, { systemPrompt: req.system, messages: [{ role: "user", content: req.user, timestamp: Date.now() }] }, { temperature: req.temperature, maxTokens: req.maxTokens, reasoning: resolveTaskModel({ model: resolved }, {}).thinking, apiKey: auth?.apiKey, headers: auth?.headers });
@@ -111,7 +113,7 @@ export function assertAutoConsolidationWirable(deps) {
111
113
  if (raw === undefined)
112
114
  return;
113
115
  if (typeof raw !== "boolean") {
114
- throw autoRunRefusal(`RunnerDeps.autoRunOnRecommendation must be a boolean when present (got ${JSON.stringify(raw)}) — a non-boolean would silently read as off, arming or disarming whole-library egress by accident.`);
116
+ throw autoRunRefusal(`RunnerDeps.autoRunOnRecommendation must be a boolean when present (got ${describeRejectedValue(raw)}) — a non-boolean would silently read as off, arming or disarming whole-library egress by accident.`);
115
117
  }
116
118
  if (raw !== true)
117
119
  return;
@@ -0,0 +1,2 @@
1
+ import type { NoticeSeatInput } from "./notice-seat-input.js";
2
+ export declare function createMessagesOmittedSeat(ids: NoticeSeatInput): (omitted: number) => void;
@@ -0,0 +1,21 @@
1
+ import { deliverEngineNotice } from "../engine-notice.js";
2
+ export function createMessagesOmittedSeat(ids) {
3
+ let inStretch = false;
4
+ return (omitted) => {
5
+ if (omitted <= 0) {
6
+ inStretch = false;
7
+ return;
8
+ }
9
+ if (inStretch)
10
+ return;
11
+ inStretch = true;
12
+ const what = omitted === 1 ? "1 earlier message was" : `${omitted} earlier messages were`;
13
+ deliverEngineNotice(ids.onNotice, {
14
+ code: "context.messages_omitted",
15
+ message: `This conversation no longer fits what the model can read in one request, and compaction did not make it fit, so ${what} ` +
16
+ `left out of what the model sees (the oldest go first; the model is told that earlier messages were omitted). The session ` +
17
+ `still holds every message. Said once until a request fits again.`,
18
+ detail: { omitted, sessionId: ids.sessionId, runId: ids.runId },
19
+ });
20
+ };
21
+ }
@@ -0,0 +1,23 @@
1
+ /**
2
+ * The leg's announcement of a walked model request — `model.fallback` (audience `user`): the requested model could not serve,
3
+ * and either a fallback model answered (`outcome: "served"`) or none could (`"exhausted"`). Read off the answer at the
4
+ * accounting points that read every answer (the main loop's, and the side-call lanes' book), so the lane that made the call
5
+ * is named: the marker for a walk that tried a hop, and the statement of a walk that sent none (every later hop's route refused
6
+ * before sending — `exhausted` with no hop tried, no `to`). Fires ONCE PER LEG PER (from, to, reason, outcome).
7
+ */
8
+ import { type EngineNotice } from "../engine-notice.js";
9
+ import type { Model } from "../../internal/llm.js";
10
+ import type { ServedReading } from "../../brain/model-lane.js";
11
+ import type { UsageLane } from "./side-call-account.js";
12
+ /** Which call of the leg the request was: the lane it is booked on. */
13
+ export type ModelFallbackLane = UsageLane;
14
+ export interface ModelFallbackSeat {
15
+ /** Announce a walk on the answer to a request for `requested` on `lane`, unless this leg already announced the same walk. */
16
+ observe(lane: ModelFallbackLane, requested: Model, reading: ServedReading): void;
17
+ }
18
+ /** `alert` is the leg's operational alert for a walk that sent no hop on the main lane (a walk that tried one has its own, with the
19
+ * switch it records): told the announced sentence, once. */
20
+ export declare function createModelFallbackSeat(onNotice: ((notice: EngineNotice) => void) | undefined, ids: {
21
+ sessionId: string;
22
+ runId?: string;
23
+ }, alert?: (sentence: string) => void): ModelFallbackSeat;
@@ -0,0 +1,64 @@
1
+ import { deliverEngineNotice } from "../engine-notice.js";
2
+ function windowOf(model) {
3
+ const w = model?.contextWindow;
4
+ return typeof w === "number" && Number.isFinite(w) && w > 0 ? w : undefined;
5
+ }
6
+ const refusedListOf = (skipped) => skipped.map((s) => (s.code !== undefined ? `${s.model} (${s.code})` : s.model)).join(", ");
7
+ export function createModelFallbackSeat(onNotice, ids, alert) {
8
+ const announced = new Set();
9
+ const once = (key) => {
10
+ const k = key.join("\u0000");
11
+ if (announced.has(k))
12
+ return false;
13
+ announced.add(k);
14
+ return true;
15
+ };
16
+ const attribution = { sessionId: ids.sessionId, ...(ids.runId !== undefined ? { runId: ids.runId } : {}) };
17
+ return {
18
+ observe(lane, requested, reading) {
19
+ const fromWindow = windowOf(requested);
20
+ const d = reading.degraded;
21
+ if (d === undefined) {
22
+ const u = reading.unsent;
23
+ if (u === undefined || !once([u.from, "", u.reason, "unsent"]))
24
+ return;
25
+ const message = `${u.from} could not serve this request (${u.reason}); none of its fallbacks was sent — its route was refused before sending: ${refusedListOf(u.skipped)}; the request ended with ${u.from}'s own failure.`;
26
+ deliverEngineNotice(onNotice, {
27
+ code: "model.fallback",
28
+ message,
29
+ detail: { from: u.from, reason: u.reason, outcome: "exhausted", chain: [], skipped: u.skipped.map((s) => ({ ...s })), lane, ...(fromWindow !== undefined ? { fromWindow } : {}), ...attribution },
30
+ });
31
+ if (lane === "main")
32
+ alert?.(message);
33
+ return;
34
+ }
35
+ const outcome = d.outcome ?? "served";
36
+ if (!once([d.from, d.to, d.reason, outcome]))
37
+ return;
38
+ const to = outcome === "served" ? reading.served : undefined;
39
+ const toWindow = windowOf(to);
40
+ const smaller = fromWindow !== undefined && toWindow !== undefined && toWindow < fromWindow ? ` ${d.to} has a smaller context window (${toWindow} tokens; ${d.from} has ${fromWindow}).` : "";
41
+ const skipped = d.skipped ?? [];
42
+ const refused = skipped.length > 0 ? ` Not tried — its route was refused before sending: ${refusedListOf(skipped)}.` : "";
43
+ const message = outcome === "served"
44
+ ? `${d.from} could not serve this request (${d.reason}); its fallback ${d.to} answered instead.${smaller}${refused}`
45
+ : `${d.from} could not serve this request (${d.reason}), and none of its fallbacks could (tried ${(d.chain ?? [d.to]).join(", ")}); the request ended with ${d.from}'s own failure.${refused}`;
46
+ deliverEngineNotice(onNotice, {
47
+ code: "model.fallback",
48
+ message,
49
+ detail: {
50
+ from: d.from,
51
+ to: d.to,
52
+ reason: d.reason,
53
+ outcome,
54
+ chain: [...(d.chain ?? [])],
55
+ ...(skipped.length > 0 ? { skipped: skipped.map((s) => ({ ...s })) } : {}),
56
+ lane,
57
+ ...(fromWindow !== undefined ? { fromWindow } : {}),
58
+ ...(toWindow !== undefined ? { toWindow } : {}),
59
+ ...attribution,
60
+ },
61
+ });
62
+ },
63
+ };
64
+ }
@@ -0,0 +1,12 @@
1
+ import type { CacheRetention } from "../../internal/llm.js";
2
+ import type { Brain } from "../types.js";
3
+ /** The deployment's retention word as `field` carries it: absent ⇒ `undefined`, a word ⇒ the word, anything else refused
4
+ * (`config.invalid_argument`, `detail.field`) — the construction door's screen and every read of the Brain seat ask here. */
5
+ export declare function receiveCacheRetention(value: unknown, field: string): CacheRetention | undefined;
6
+ /** The model lane over a deps bag's Brain seat and its fallback policy (`RunnerDeps.modelFallback`; absent ⇒ the default gate),
7
+ * writing the bag's retention word (`RunnerDeps.cacheRetention`) on every call when it sets one. */
8
+ export declare function modelLaneBrainOf(deps: {
9
+ readonly brain: Brain;
10
+ readonly modelFallback?: unknown;
11
+ readonly cacheRetention?: unknown;
12
+ }): Brain;