@sema-agent/core 7.66.1 → 7.67.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (904) hide show
  1. package/CHANGELOG.md +3518 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +169 -0
  71. package/dist/brain/model-lane.js +505 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +164 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +105 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +24 -25
  362. package/dist/core/roles.js +148 -21
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +23 -0
  434. package/dist/core/runner/model-fallback-seat.js +64 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +11 -3
  477. package/dist/core/runner/prepare-park-ask.js +23 -19
  478. package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
  479. package/dist/core/runner/prepare-policy-chain.js +144 -120
  480. package/dist/core/runner/prepare-project-context.d.ts +15 -53
  481. package/dist/core/runner/prepare-project-context.js +20 -83
  482. package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
  483. package/dist/core/runner/prepare-prompt-assembly.js +9 -7
  484. package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
  485. package/dist/core/runner/prepare-prompt-inputs.js +5 -3
  486. package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
  487. package/dist/core/runner/prepare-protocol-tools.js +46 -27
  488. package/dist/core/runner/prepare-question-face.d.ts +6 -5
  489. package/dist/core/runner/prepare-question-face.js +7 -6
  490. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
  491. package/dist/core/runner/prepare-suspend-saga.js +1 -1
  492. package/dist/core/runner/prepare-task.d.ts +3 -3
  493. package/dist/core/runner/prepare-task.js +113 -61
  494. package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
  495. package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
  496. package/dist/core/runner/prepare-turn-wiring.js +53 -17
  497. package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
  498. package/dist/core/runner/prepare-wiring-manifest.js +81 -42
  499. package/dist/core/runner/prepare-workspace-restore.js +3 -2
  500. package/dist/core/runner/read-root-grant.js +2 -1
  501. package/dist/core/runner/reply-pricing.d.ts +31 -18
  502. package/dist/core/runner/reply-pricing.js +10 -15
  503. package/dist/core/runner/resume-admission.js +10 -15
  504. package/dist/core/runner/resume-apply.js +20 -9
  505. package/dist/core/runner/resume-checkpoint-screen.js +2 -4
  506. package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
  507. package/dist/core/runner/resume-internals-and-config.js +37 -9
  508. package/dist/core/runner/resume-preflight.js +3 -3
  509. package/dist/core/runner/retired-runner-deps.js +3 -0
  510. package/dist/core/runner/rewind-files.js +6 -6
  511. package/dist/core/runner/run-attachment-seats.d.ts +1 -3
  512. package/dist/core/runner/run-attachment-seats.js +1 -6
  513. package/dist/core/runner/run-brain-sinks.d.ts +4 -7
  514. package/dist/core/runner/run-brain-sinks.js +7 -10
  515. package/dist/core/runner/run-clock-and-content.d.ts +8 -5
  516. package/dist/core/runner/run-clock-and-content.js +18 -3
  517. package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
  518. package/dist/core/runner/run-compaction-machinery.js +4 -19
  519. package/dist/core/runner/run-git-lane.d.ts +8 -3
  520. package/dist/core/runner/run-git-lane.js +5 -3
  521. package/dist/core/runner/run-harness-handlers.d.ts +4 -1
  522. package/dist/core/runner/run-harness-handlers.js +70 -45
  523. package/dist/core/runner/run-identity-wiring.d.ts +6 -0
  524. package/dist/core/runner/run-identity-wiring.js +17 -8
  525. package/dist/core/runner/run-leg.d.ts +5 -2
  526. package/dist/core/runner/run-leg.js +156 -71
  527. package/dist/core/runner/run-notification-lane.d.ts +1 -1
  528. package/dist/core/runner/run-notification-lane.js +22 -10
  529. package/dist/core/runner/run-recovery-lanes.js +8 -6
  530. package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
  531. package/dist/core/runner/run-settle-and-teardown.js +77 -26
  532. package/dist/core/runner/run-stop-and-final-verify.js +46 -12
  533. package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +126 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +64 -34
  730. package/dist/index.js +45 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +340 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core-stores-sql@7.67.1.json +39 -0
  893. package/wire-changes/core@7.67.0.json +12578 -0
  894. package/wire-changes/core@7.67.1.json +406 -0
  895. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  896. package/wire-changes/mods-kernel@7.67.1.json +39 -0
  897. package/wire-changes/primitives@7.67.0.json +325 -0
  898. package/wire-changes/primitives@7.67.1.json +39 -0
  899. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  900. package/wire-changes/wiki-gate@7.67.1.json +39 -0
  901. package/dist/brain/degrading.d.ts +0 -93
  902. package/dist/brain/degrading.js +0 -189
  903. package/dist/core/tool-conformance.d.ts +0 -20
  904. package/dist/core/tool-conformance.js +0 -37
@@ -1,4 +1,5 @@
1
1
  import { createAssistantMessageEventStream, } from "../internal/llm.js";
2
+ import { completeOf } from "./brain-faces.js";
2
3
  import { ZERO_USAGE } from "./errors.js";
3
4
  function errorMessage(who, text) {
4
5
  return {
@@ -20,7 +21,7 @@ function spelled(word) {
20
21
  function routeKeyOf(model, by) {
21
22
  return by === "api" ? model.api : model.provider;
22
23
  }
23
- function isBrain(value) {
24
+ export function isBrain(value) {
24
25
  return value !== null && typeof value === "object" && typeof value.stream === "function";
25
26
  }
26
27
  export function brainLaneOf(model, routes, by = "provider") {
@@ -36,17 +37,15 @@ export function createRoutingBrain(routes, opts = {}) {
36
37
  const routed = routes[lane];
37
38
  return isBrain(routed) ? { target: routed } : { broken: `route ${by}="${lane}" is mounted but its value is not a brain` };
38
39
  };
39
- const stream = (model, context, options) => {
40
+ const place = (model) => {
40
41
  const reject = (text, named) => {
41
- const out = createAssistantMessageEventStream();
42
42
  try {
43
43
  const wordOf = (field) => (field === by && named !== undefined ? named.value : model[field]);
44
- out.push({ type: "error", reason: "error", error: errorMessage({ api: wordOf("api"), provider: wordOf("provider"), id: wordOf("id") }, text) });
44
+ return { refused: errorMessage({ api: wordOf("api"), provider: wordOf("provider"), id: wordOf("id") }, text) };
45
45
  }
46
46
  catch {
47
- out.push({ type: "error", reason: "error", error: errorMessage(BLANK_IDENTITY, `${text} (the model's own words could not be read either)`) });
47
+ return { refused: errorMessage(BLANK_IDENTITY, `${text} (the model's own words could not be read either)`) };
48
48
  }
49
- return out;
50
49
  };
51
50
  let word;
52
51
  try {
@@ -67,11 +66,23 @@ export function createRoutingBrain(routes, opts = {}) {
67
66
  const target = "target" in resolved ? resolved.target : undefined;
68
67
  if (!target)
69
68
  return reject("broken" in resolved ? `createRoutingBrain: ${resolved.broken}` : `createRoutingBrain: no brain for ${by}="${spelled(named)}"`, word);
70
- return target.stream(model, context, options);
69
+ return { target };
70
+ };
71
+ const stream = (model, context, options) => {
72
+ const placed = place(model);
73
+ if ("target" in placed)
74
+ return placed.target.stream(model, context, options);
75
+ const out = createAssistantMessageEventStream();
76
+ out.push({ type: "error", reason: "error", error: placed.refused });
77
+ return out;
78
+ };
79
+ const complete = async (model, context, options) => {
80
+ const placed = place(model);
81
+ return "target" in placed ? completeOf(placed.target)(model, context, options) : placed.refused;
71
82
  };
72
83
  const adjudicateRoute = (model, perModelAuth) => {
73
84
  const resolved = resolveTarget(model);
74
85
  return "target" in resolved ? resolved.target?.adjudicateRoute?.(model, perModelAuth) : undefined;
75
86
  };
76
- return { stream, adjudicateRoute };
87
+ return { stream, complete, adjudicateRoute };
77
88
  }
@@ -6,11 +6,12 @@ import type { CapabilityDeclaration, ModelCapability } from "./model-capability.
6
6
  * reaches THIS task's sink and nothing else. */
7
7
  export declare function runWithStatusSink<T>(emit: (s: BrainStatus) => void, fn: () => Promise<T>): Promise<T>;
8
8
  /**
9
- * Run `fn` with every liveness frame its brain calls report stamped with `seat` ({@link BrainStatus.seat}): a nested scope over
10
- * the ACTIVE sink (the frames still reach the task's stream, unlike a derived leg's no-op shield). A frame that names a seat keeps
11
- * its own; the stamp is applied at emit time, so a timer-fired frame carries it; outside a sink the call runs unchanged.
9
+ * Run `fn` with every liveness frame its brain calls report stamped with `seat` ({@link BrainStatus.seat}) and, when the seat's
10
+ * call is about one tool call, that call's id ({@link BrainStatus.toolCallId}): a nested scope over the ACTIVE sink (the frames
11
+ * still reach the task's stream, unlike a derived leg's no-op shield). A frame that names a seat keeps its own seat and call; the
12
+ * stamp is applied at emit time, so a timer-fired frame carries it; outside a sink the call runs unchanged.
12
13
  */
13
- export declare function withStatusSeat<T>(seat: BrainStatusSeat, fn: () => T): T;
14
+ export declare function withStatusSeat<T>(seat: BrainStatusSeat, fn: () => T, toolCallId?: string): T;
14
15
  /**
15
16
  * Report a brain-layer liveness status to the active per-task sink, if any. A no-op outside a
16
17
  * {@link runWithStatusSink} scope (e.g. compaction's `complete`, or a brain used standalone).
@@ -3,11 +3,11 @@ const statusSinkStore = new AsyncLocalStorage();
3
3
  export function runWithStatusSink(emit, fn) {
4
4
  return statusSinkStore.run({ emit }, fn);
5
5
  }
6
- export function withStatusSeat(seat, fn) {
6
+ export function withStatusSeat(seat, fn, toolCallId) {
7
7
  const outer = statusSinkStore.getStore();
8
8
  if (outer === undefined)
9
9
  return fn();
10
- return statusSinkStore.run({ emit: (s) => outer.emit(s.seat === undefined ? { ...s, seat } : s) }, fn);
10
+ return statusSinkStore.run({ emit: (s) => outer.emit(s.seat === undefined ? { ...s, seat, ...(toolCallId !== undefined ? { toolCallId } : {}) } : s) }, fn);
11
11
  }
12
12
  export function bindBrainStatusEmitter() {
13
13
  const sink = statusSinkStore.getStore();
@@ -10,6 +10,7 @@ import { bindBrainStatusEmitter, emitBrainStatus, emitBrainTelemetry, reportExtr
10
10
  import { createAttemptController, firstByteWindow, refuseRetiredTimeoutKnobs, resolveFirstByteRetries, resolveWatchdogMs, STALL_FIRST_BYTE_MS, STALL_FIRST_TOKEN_MS, STALL_IDLE_MS, } from "./timeout.js";
11
11
  import { readMember, thrownText } from "../core/thrown-value.js";
12
12
  import { remoteWords } from "../core/protocol-http-auth.js";
13
+ import { admittedProviderMessage, readProviderMessage } from "./provider-message.js";
13
14
  const DEFAULT_MAX_RETRIES = 10;
14
15
  const MAX_RETRIES_ENV_CEILING = 15;
15
16
  const MAX_RETRIES_ENV = "SEMA_MAX_RETRIES";
@@ -200,8 +201,6 @@ const THINKING_RETRY_BUDGET = 2;
200
201
  const EMPTY_USAGE = {
201
202
  input: 0,
202
203
  output: 0,
203
- cacheRead: 0,
204
- cacheWrite: 0,
205
204
  totalTokens: 0,
206
205
  cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
207
206
  };
@@ -369,6 +368,9 @@ export function runStreamingBrain(args) {
369
368
  if (typeof resetAtMs === "number" && Number.isFinite(resetAtMs))
370
369
  errorMsg.providerResetAtMs = resetAtMs;
371
370
  }
371
+ const providerMessage = admittedProviderMessage(readMember(err, "providerMessage"));
372
+ if (providerMessage !== undefined)
373
+ errorMsg.providerMessage = providerMessage;
372
374
  }
373
375
  }
374
376
  if (kept === undefined || kept.usageMissing === true)
@@ -632,6 +634,7 @@ export function runStreamingBrain(args) {
632
634
  errorBody = await readErrorBody(r, signal);
633
635
  const judge = () => r !== undefined && namesTheFailure(r.status) ? judgeHttpFailure({ dialect, status: r.status, headers: r.headers, body: errorBody }) : undefined;
634
636
  const verdict = judge();
637
+ const retryMessage = verdict !== undefined ? readProviderMessage(errorBody, req.declared) : undefined;
635
638
  const retryableByCondition = netErr !== undefined || (verdict !== undefined && PROVIDER_CONDITION_TRAITS[verdict.condition].retryable);
636
639
  const retryable = shouldRetryHeaderVerdict(r) ?? retryableByCondition;
637
640
  const connectReading = netErr !== undefined ? readConnectFailure(netErr) : undefined;
@@ -678,6 +681,7 @@ export function runStreamingBrain(args) {
678
681
  errClass,
679
682
  ...(retryStatus !== undefined ? { errorStatus: retryStatus } : {}),
680
683
  ...(verdict !== undefined ? { providerCondition: verdict.condition, providerConditionSource: verdict.source } : {}),
684
+ ...(retryMessage !== undefined ? { providerMessage: retryMessage } : {}),
681
685
  }));
682
686
  attempt++;
683
687
  continue;
@@ -694,6 +698,7 @@ export function runStreamingBrain(args) {
694
698
  const status = r?.status ?? 0;
695
699
  const itl = terminalVerdict?.inputTooLong ?? "no";
696
700
  const providerCode = refusedTheRequest(status) ? readProviderErrorCode(errorBody) : undefined;
701
+ const terminalMessage = terminalVerdict !== undefined ? readProviderMessage(errorBody, req.declared) : undefined;
697
702
  const refusedTool = terminalVerdict?.toolSchemaAt !== undefined ? req.toolNames?.[terminalVerdict.toolSchemaAt] : undefined;
698
703
  throw new BrainError(classifyHttp(status), `${httpLabel} HTTP ${status || "ERR"}: ${detail.slice(0, 500)}${overflowDeclineNote}`, status, {
699
704
  apiError: true,
@@ -702,6 +707,7 @@ export function runStreamingBrain(args) {
702
707
  ...(refusedTool !== undefined ? { toolSchemaRefused: refusedTool } : {}),
703
708
  ...(providerCode !== undefined ? { providerCode } : {}),
704
709
  ...(terminalVerdict !== undefined ? { verdict: { condition: terminalVerdict.condition, source: terminalVerdict.source, ...(terminalVerdict.resetAtMs !== undefined ? { resetAtMs: terminalVerdict.resetAtMs } : {}) } } : {}),
710
+ ...(terminalMessage !== undefined ? { providerMessage: terminalMessage } : {}),
705
711
  ...(errorBody !== undefined && !errorBody.endedNormally ? { errorBodyIncomplete: true } : {}),
706
712
  });
707
713
  }
@@ -106,6 +106,18 @@ export interface MemberReader {
106
106
  array(v: unknown): readonly unknown[] | undefined;
107
107
  word(v: unknown): string | undefined;
108
108
  count(v: unknown): number | undefined;
109
+ /**
110
+ * A member whose own law lives in a reading elsewhere (the reasoning count: `reasoningTokensOf`): absent and `null` state
111
+ * nothing (`undefined`); anything else is a STATEMENT and is handed on as it came — in no count shape included, so that reading
112
+ * can tell "said nothing" from "said something it cannot read". A statement in no count shape is recorded (`outOfShape`) as
113
+ * `count` records one.
114
+ */
115
+ claim(v: unknown): unknown;
116
+ /**
117
+ * {@link claim} of `container[key]`. A container in no object shape may have held the member: it states something in no count
118
+ * shape (a value that is no count whatever the container was — `5` would otherwise read as a count), recorded — not an absence.
119
+ */
120
+ claimIn(container: unknown, key: string): unknown;
109
121
  /** Did a member this reader read hold a value in no shape? */
110
122
  readonly outOfShape: boolean;
111
123
  }
@@ -50,6 +50,7 @@ export function truncationCauseClause(facts) {
50
50
  }
51
51
  const isCount = (v) => typeof v === "number" && Number.isInteger(v) && v >= 0;
52
52
  const countOf = (v) => (isCount(v) ? v : undefined);
53
+ const NOT_A_COUNT = Symbol("a container in no object shape");
53
54
  export function memberReader() {
54
55
  let outOfShape = false;
55
56
  const take = (v, inShape) => {
@@ -60,11 +61,28 @@ export function memberReader() {
60
61
  outOfShape = true;
61
62
  return undefined;
62
63
  };
64
+ const claim = (v) => {
65
+ if (v === null || v === undefined)
66
+ return undefined;
67
+ if (!isCount(v))
68
+ outOfShape = true;
69
+ return v;
70
+ };
63
71
  return {
64
72
  object: (v) => take(v, (x) => typeof x === "object" && !Array.isArray(x)),
65
73
  array: (v) => take(v, Array.isArray),
66
74
  word: (v) => take(v, (x) => typeof x === "string"),
67
75
  count: (v) => take(v, isCount),
76
+ claim,
77
+ claimIn: (container, key) => {
78
+ if (container === null || container === undefined)
79
+ return undefined;
80
+ if (typeof container !== "object" || Array.isArray(container)) {
81
+ outOfShape = true;
82
+ return NOT_A_COUNT;
83
+ }
84
+ return claim(container[key]);
85
+ },
68
86
  get outOfShape() {
69
87
  return outOfShape;
70
88
  },
@@ -268,6 +268,34 @@ export interface BrainCallGuardrailRef {
268
268
  /** Set once, by the first call the guardrail gave up on. Absent ⇒ the guardrail never fired. */
269
269
  timedOut?: BrainCallGuardrailTimeoutError;
270
270
  }
271
+ /**
272
+ * A deadline over the await points of ONE brain call — the race primitive the engine-side guardrail and the model lane's per-hop
273
+ * first-token deadline share. On expiry it does the two independent things the guardrail note describes: it aborts the signal it
274
+ * handed the brain WITH the expiry error as the abort's reason (a cooperative brain cuts its own request, and an observer that reads
275
+ * `signal.reason` — a circuit breaker — sees a coded failure, not a cancellation), and it rejects every raced await with that error,
276
+ * whatever the brain does.
277
+ */
278
+ export interface BrainCallDeadline {
279
+ /** The signal handed to the brain: outer aborts forward into it, and expiry aborts it (leg a). */
280
+ signal: AbortSignal;
281
+ /** Await `p`, but never past the deadline — and once expired, NOTHING from the brain is accepted. */
282
+ race: <T>(p: Promise<T>) => Promise<T>;
283
+ /** Whether the deadline fired. */
284
+ expired: () => boolean;
285
+ /** Stop the clock only: the deadline will not fire, and outer aborts still reach the brain's signal (the call goes on). */
286
+ stopClock: () => void;
287
+ /** Idempotent: stop the timer and drop the outer-abort listener (the call is over). */
288
+ disarm: () => void;
289
+ /** The brain's terminal event passed: its answer is in, so leaving the call now abandons nothing. The timer keeps bounding
290
+ * `result()`. */
291
+ answered: () => void;
292
+ /** The engine leaves the call. Before its answer is in, the brain's signal is aborted first — once the outer-abort listener is
293
+ * dropped nothing else would tell the brain its call is unwanted — then the gate is disarmed; after it, only disarmed. */
294
+ abandon: () => void;
295
+ }
296
+ /** Arm a {@link BrainCallDeadline} of `limitMs` over a call whose caller holds `outerSignal`; `expire` mints the error the expiry
297
+ * aborts the brain's signal with and rejects every raced await with (called once, when the deadline fires). */
298
+ export declare function armBrainCallDeadline(limitMs: number, outerSignal: AbortSignal | undefined, expire: () => Error): BrainCallDeadline;
271
299
  /**
272
300
  * Wrap a {@link StreamFn} so the ENGINE never waits longer than `limitMs` for one brain call.
273
301
  *
@@ -41,8 +41,7 @@ export function resolveFirstByteRetries(value) {
41
41
  return FIRST_BYTE_RETRY_BUDGET;
42
42
  if (value === 0 || value === 1)
43
43
  return value;
44
- const shown = typeof value === "string" ? JSON.stringify(value) : typeof value === "bigint" ? `${value}n` : typeof value === "object" && value !== null ? "an object" : String(value);
45
- const e = new Error(`firstByteRetries must be 0 or 1 (got ${shown}) — 1 re-sends a first-byte stall once at a widened window (the default), 0 ends the call at the first window so the caller's own failover takes it`);
44
+ const e = new Error(`firstByteRetries must be 0 or 1 (got ${describeRejectedValue(value)}) — 1 re-sends a first-byte stall once at a widened window (the default), 0 ends the call at the first window so the caller's own failover takes it`);
46
45
  e.code = "config.stall_timeout_invalid";
47
46
  throw e;
48
47
  }
@@ -212,6 +211,13 @@ export function resolveBrainCallGuardrailMs(knob) {
212
211
  return knob;
213
212
  }
214
213
  function armCallGuardrail(limitMs, outerSignal, ref) {
214
+ return armBrainCallDeadline(limitMs, outerSignal, () => {
215
+ const err = new BrainCallGuardrailTimeoutError(limitMs);
216
+ ref.timedOut ??= err;
217
+ return err;
218
+ });
219
+ }
220
+ export function armBrainCallDeadline(limitMs, outerSignal, expire) {
215
221
  const ac = new AbortController();
216
222
  if (outerSignal !== undefined) {
217
223
  if (outerSignal.aborted)
@@ -231,9 +237,8 @@ function armCallGuardrail(limitMs, outerSignal, ref) {
231
237
  });
232
238
  expiry.catch(() => undefined);
233
239
  const timer = setTimeout(() => {
234
- const err = new BrainCallGuardrailTimeoutError(limitMs);
240
+ const err = expire();
235
241
  expired = err;
236
- ref.timedOut ??= err;
237
242
  ac.abort(err);
238
243
  rejectExpiry(err);
239
244
  }, limitMs);
@@ -247,6 +252,10 @@ function armCallGuardrail(limitMs, outerSignal, ref) {
247
252
  throw expired;
248
253
  return value;
249
254
  },
255
+ expired: () => expired !== undefined,
256
+ stopClock: () => {
257
+ clearTimeout(timer);
258
+ },
250
259
  disarm,
251
260
  answered: () => {
252
261
  over = true;
@@ -0,0 +1,2 @@
1
+ /** A tool input schema as the model is shown it (module doc). Pure: the declared schema is never written. */
2
+ export declare function projectToolSchema<T>(schema: T): T;
@@ -0,0 +1,108 @@
1
+ import { unescape as percentDecoded } from "node:querystring";
2
+ import { JSON_SCHEMA_SUBSCHEMA_SEATS } from "../core/json-schema-seats.js";
3
+ const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
4
+ const REFERENCE_KEYWORDS = ["$ref", "$dynamicRef"];
5
+ const token = (t) => `/${String(t).replace(/~/g, "~0").replace(/\//g, "~1")}`;
6
+ function typeWordOf(value, declared) {
7
+ const own = typeof value === "string" || typeof value === "boolean" ? typeof value : typeof value === "number" && Number.isFinite(value) ? "number" : undefined;
8
+ if (own === undefined)
9
+ return undefined;
10
+ if (declared === undefined || declared === own)
11
+ return own;
12
+ return declared === "integer" && own === "number" && Number.isInteger(value) ? "integer" : undefined;
13
+ }
14
+ function valueSetOf(node) {
15
+ if (!isRecord(node))
16
+ return undefined;
17
+ const keys = Object.keys(node).filter((k) => k !== "type");
18
+ if (keys.length !== 1 || (keys[0] !== "const" && keys[0] !== "enum"))
19
+ return undefined;
20
+ const values = keys[0] === "const" ? [node.const] : node.enum;
21
+ if (!Array.isArray(values) || values.length === 0)
22
+ return undefined;
23
+ const words = new Set(values.map((v) => typeWordOf(v, node.type)));
24
+ const [type] = words;
25
+ return words.size === 1 && type !== undefined ? { type, values: values } : undefined;
26
+ }
27
+ function foldedUnion(node) {
28
+ if (!Array.isArray(node.anyOf) || node.anyOf.length === 0 || Object.hasOwn(node, "enum"))
29
+ return undefined;
30
+ const sets = node.anyOf.map(valueSetOf);
31
+ const type = sets[0]?.type;
32
+ if (type === undefined || !sets.every((s) => s?.type === type))
33
+ return undefined;
34
+ const values = [...new Set(sets.flatMap((s) => s.values))];
35
+ const out = {};
36
+ for (const [k, v] of Object.entries(node)) {
37
+ if (k !== "anyOf")
38
+ out[k] = v;
39
+ else {
40
+ if (!Object.hasOwn(node, "type"))
41
+ out.type = type;
42
+ out.enum = values;
43
+ }
44
+ }
45
+ return out;
46
+ }
47
+ function* children(node, pointer) {
48
+ for (const [key, value] of Object.entries(node)) {
49
+ const seat = JSON_SCHEMA_SUBSCHEMA_SEATS.get(key);
50
+ if (seat === undefined)
51
+ continue;
52
+ const at = pointer + token(key);
53
+ if (seat === "schema" && !Array.isArray(value))
54
+ yield [key, undefined, value, at];
55
+ else if (Array.isArray(value))
56
+ for (const [i, sub] of value.entries())
57
+ yield [key, i, sub, at + token(i)];
58
+ else if (isRecord(value))
59
+ for (const [name, sub] of Object.entries(value))
60
+ yield [key, name, sub, at + token(name)];
61
+ }
62
+ }
63
+ function keptUnions(root) {
64
+ const kept = new Set();
65
+ const seen = new Set();
66
+ const visit = (node) => {
67
+ if (!isRecord(node) || seen.has(node))
68
+ return;
69
+ seen.add(node);
70
+ for (const k of REFERENCE_KEYWORDS) {
71
+ const ref = node[k];
72
+ if (typeof ref !== "string" || !ref.startsWith("#/"))
73
+ continue;
74
+ const tokens = percentDecoded(ref.slice(1)).split("/").slice(1);
75
+ tokens.forEach((t, i) => t === "anyOf" && kept.add(tokens.slice(0, i).map((x) => `/${x}`).join("")));
76
+ }
77
+ for (const [, , sub] of children(node, ""))
78
+ visit(sub);
79
+ };
80
+ visit(root);
81
+ return kept;
82
+ }
83
+ function project(node, pointer, walk) {
84
+ if (!isRecord(node) || walk.ancestors.has(node))
85
+ return node;
86
+ walk.ancestors.add(node);
87
+ let out;
88
+ for (const [key, name, sub, at] of children(node, pointer)) {
89
+ const next = project(sub, at, walk);
90
+ if (next === sub)
91
+ continue;
92
+ out ??= { ...node };
93
+ if (name === undefined)
94
+ out[key] = next;
95
+ else {
96
+ const declared = node[key];
97
+ if (out[key] === declared)
98
+ out[key] = Array.isArray(declared) ? [...declared] : { ...declared };
99
+ out[key][name] = next;
100
+ }
101
+ }
102
+ walk.ancestors.delete(node);
103
+ const current = out ?? node;
104
+ return walk.kept.has(pointer) ? current : (foldedUnion(current) ?? current);
105
+ }
106
+ export function projectToolSchema(schema) {
107
+ return project(schema, "", { ancestors: new Set(), kept: keptUnions(schema) });
108
+ }
@@ -0,0 +1,49 @@
1
+ /**
2
+ * The ONE reading of what a provider's usage frames stated, for the three first-party wire adapters: each adapter merges its own
3
+ * frames and maps its own spellings onto a {@link UsageStatement}; what a statement MEANS is decided here, once.
4
+ *
5
+ * The law, member by member:
6
+ * - a member is STATED when a frame carried a count for it; `undefined` / `null` state nothing. A member that holds something that
7
+ * is no count (a string, a fraction, a negative) is a statement nobody can read: the usage is unknown (`missing`) and the member
8
+ * reads as not stated;
9
+ * - `input` and `output` are the necessary operands of every total: either one not stated makes the usage `missing` (its numbers
10
+ * are then a lower bound, as everywhere a usage is `usageMissing`) and reads as 0 in those numbers;
11
+ * - `cacheRead` and `cacheWrite` are left ABSENT on the {@link Usage} when not stated — absent is "not reported", never 0 (the
12
+ * same law `Usage.reasoning` follows). A stated 0 is a measured 0 and is kept.
13
+ * - `cacheWriteLong` is the part of `cacheWrite` the wire says was written at the one-hour lifetime: a SUBSET of it, absent when
14
+ * the wire did not state the split, and read by the subset law `reasoning` follows — a count beyond the writes it is a part of
15
+ * (or one with no write count beside it, a stated 0 included) is not recorded and the usage is unknown (`missing`). The write count stays the
16
+ * total of both lifetimes; the cost lines price the two parts at their own rates.
17
+ *
18
+ * Merging is the adapter's business, and so is deciding what counts as a statement across frames (the Anthropic closing frame's
19
+ * 0 for an input or a cache count says "unchanged", not "0", so the adapter does not take it). This reading only sees the
20
+ * merged statement.
21
+ *
22
+ * How the wire counts its input against the cache is its {@link CacheFamily}: an `input-excludes-cached` wire (Anthropic) adds the
23
+ * cache counts to its total and prices them at their own rates; an `input-includes-cached` wire (the OpenAI shapes) states its
24
+ * own total when it has one and prices the cached part inside `input` (its cache cost lines are 0).
25
+ */
26
+ import type { Model, Usage } from "../internal/llm.js";
27
+ import type { CacheFamily } from "../core/runner/usage-accounting.js";
28
+ import { type ReasoningReading } from "./usage-reasoning.js";
29
+ /** What a provider's merged usage frames carried, per member, as it came (`undefined` = the member was not stated). */
30
+ export interface UsageStatement {
31
+ readonly input?: unknown;
32
+ readonly output?: unknown;
33
+ readonly cacheRead?: unknown;
34
+ readonly cacheWrite?: unknown;
35
+ /** The part of `cacheWrite` the wire says was written at the one-hour lifetime; absent ⇒ the wire did not state the split. */
36
+ readonly cacheWriteLong?: unknown;
37
+ /** The wire's own total, on a wire that states one (the OpenAI shapes); absent ⇒ the total is the sum of the stated parts. */
38
+ readonly total?: unknown;
39
+ }
40
+ /** The reading of one statement: the usage to record, and whether it is unknown (`missing` — the adapter's `usageMissing`). */
41
+ export interface UsageReading {
42
+ readonly usage: Usage;
43
+ readonly missing: boolean;
44
+ }
45
+ /**
46
+ * Read `statement` under the wire's cache family, at `model`'s declared price; `reasoning` is the wire's reasoning reading (its
47
+ * `unreadable` makes the usage unknown, as it always has).
48
+ */
49
+ export declare function usageOfStatement(model: Model, family: CacheFamily, statement: UsageStatement, reasoning: ReasoningReading): UsageReading;
@@ -0,0 +1,44 @@
1
+ import { isExactCount } from "./usage-reasoning.js";
2
+ export function usageOfStatement(model, family, statement, reasoning) {
3
+ let unreadable = false;
4
+ const stated = (v) => {
5
+ if (v === undefined || v === null)
6
+ return undefined;
7
+ if (isExactCount(v))
8
+ return v;
9
+ unreadable = true;
10
+ return undefined;
11
+ };
12
+ const inputStated = stated(statement.input);
13
+ const outputStated = stated(statement.output);
14
+ const cacheRead = stated(statement.cacheRead);
15
+ const cacheWrite = stated(statement.cacheWrite);
16
+ const longStated = stated(statement.cacheWriteLong);
17
+ const subsetBroken = longStated !== undefined && (cacheWrite === undefined || longStated > cacheWrite);
18
+ if (subsetBroken)
19
+ unreadable = true;
20
+ const cacheWriteLong = subsetBroken ? undefined : longStated;
21
+ const totalStated = stated(statement.total);
22
+ const input = inputStated ?? 0;
23
+ const output = outputStated ?? 0;
24
+ const c = model.cost;
25
+ const costInput = (input / 1e6) * (c?.input ?? 0);
26
+ const costOutput = (output / 1e6) * (c?.output ?? 0);
27
+ const excludes = family === "input-excludes-cached";
28
+ const totalTokens = excludes ? input + output + (cacheRead ?? 0) + (cacheWrite ?? 0) : (totalStated ?? input + output);
29
+ const costCacheRead = excludes ? ((cacheRead ?? 0) / 1e6) * (c?.cacheRead ?? 0) : 0;
30
+ const costCacheWrite = excludes
31
+ ? (((cacheWrite ?? 0) - (cacheWriteLong ?? 0)) / 1e6) * (c?.cacheWrite ?? 0) + ((cacheWriteLong ?? 0) / 1e6) * (c?.cacheWriteLong ?? c?.cacheWrite ?? 0)
32
+ : 0;
33
+ const usage = {
34
+ input,
35
+ output,
36
+ ...(cacheRead !== undefined ? { cacheRead } : {}),
37
+ ...(cacheWrite !== undefined ? { cacheWrite } : {}),
38
+ ...(cacheWriteLong !== undefined ? { cacheWriteLong } : {}),
39
+ totalTokens,
40
+ ...(reasoning.reasoning !== undefined ? { reasoning: reasoning.reasoning } : {}),
41
+ cost: { input: costInput, output: costOutput, cacheRead: costCacheRead, cacheWrite: costCacheWrite, total: costInput + costOutput + costCacheRead + costCacheWrite },
42
+ };
43
+ return { usage, missing: inputStated === undefined || outputStated === undefined || unreadable || reasoning.unreadable };
44
+ }
@@ -0,0 +1,38 @@
1
+ /**
2
+ * How many of a reply's output tokens the provider spent reasoning, read ONE way for every reader of a provider's usage in
3
+ * this tree: the three wire adapters and the failover lane's copy of a message's usage.
4
+ *
5
+ * `Usage.reasoning` is a SUBSET of `Usage.output`: it is never added to the totals and never priced (output already counts it).
6
+ * It is also absent, not zero, when the provider said nothing — a measured zero and "not reported" are different statements.
7
+ *
8
+ * The wire spellings stay each adapter's own (the member is read where its provider names it, in the shape judge that
9
+ * adapter already uses); what lives here is the part that must be the same everywhere:
10
+ * - priority — the first spelling that stated anything is the provider's statement, later ones are not consulted. A spelling that
11
+ * stated something in no count shape (a string, an object, `null` here, a container that could not hold it) STATES: it is the
12
+ * statement, and it is unreadable — it is never skipped for the next spelling's count, so the gates hand a statement on as it
13
+ * came and only an ABSENT spelling is `undefined`;
14
+ * - the count's own law — a whole number from zero that a number states exactly (no more than 2^53 - 1: past it the wire's
15
+ * digits were rounded on the way in, so the value read is not the value sent, and "equal to the output" proves nothing);
16
+ * - the subset law — a count larger than the output it is a part of cannot be that part.
17
+ * A count that breaks either law is not clamped (that would book a number the provider never said) and not kept (the usage
18
+ * would contradict itself): the member is left absent and the reading says `unreadable`, which each caller turns into the
19
+ * usage-unknown mark it already uses for a usage member in no shape.
20
+ */
21
+ /** The reading of one usage's reasoning count. */
22
+ export interface ReasoningReading {
23
+ /** The count to record: set only when a spelling carried a count that is exact and fits within the output. */
24
+ readonly reasoning?: number;
25
+ /** A spelling carried a count that cannot be recorded: not an exact whole number from zero, or larger than the output it is a part of. */
26
+ readonly unreadable: boolean;
27
+ }
28
+ /** A whole number from zero that a number states exactly: the one count law of every token member a usage reading records. */
29
+ export declare const isExactCount: (v: unknown) => v is number;
30
+ /**
31
+ * @param output the usage's output count (an absent output reads as 0 — a reasoning count with no output beside it is unreadable)
32
+ * @param spellings what the provider's spellings carried, highest priority first; `undefined` = that spelling absent (a wire gate
33
+ * reads an absent member and a `null` as `undefined` and hands every other value on as it came). Anything
34
+ * but an exact count (a string, `null`, an object, a fraction, a negative, a number past 2^53 - 1) is unreadable: the count's own
35
+ * law is judged here whatever shape judge the caller ran first, so a caller whose reader is looser (the wire readers accept any
36
+ * whole number) or has none (the lane copy) is held to the same law.
37
+ */
38
+ export declare function reasoningTokensOf(output: number | undefined, ...spellings: readonly unknown[]): ReasoningReading;
@@ -0,0 +1,9 @@
1
+ export const isExactCount = (v) => Number.isSafeInteger(v) && v >= 0;
2
+ export function reasoningTokensOf(output, ...spellings) {
3
+ const claimed = spellings.find((count) => count !== undefined);
4
+ if (claimed === undefined)
5
+ return { unreadable: false };
6
+ if (!isExactCount(claimed) || claimed > (output ?? 0))
7
+ return { unreadable: true };
8
+ return { reasoning: claimed, unreadable: false };
9
+ }
@@ -26,6 +26,9 @@ export interface ConfigKnob {
26
26
  key: string;
27
27
  /** The recommended value. `null` = deliberately UNSET (the summary says what unset means). */
28
28
  recommended: number | boolean | string | null;
29
+ /** What the engine applies when nothing sets the knob (`null` = no bound): one fixed value, absent where it is derived (the
30
+ * summary says how). A fact about the engine, where {@link recommended} is advice; `config.assembled` reports `default` from here. */
31
+ default?: number | boolean | string | null;
29
32
  unit?: "turns" | "seconds" | "ms" | "days" | "usd" | "tokens" | "count";
30
33
  /** What kind of knob this is: a runaway safety net, a spend bound, a behavior switch, retention. */
31
34
  kind: "safety-net" | "budget" | "behavior" | "retention";