@sema-agent/core 7.66.1 → 7.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (899) hide show
  1. package/CHANGELOG.md +3483 -0
  2. package/LICENSE +2 -1
  3. package/dist/agents/agent-definition.js +2 -1
  4. package/dist/agents/agent-transcript-tool.d.ts +1 -1
  5. package/dist/agents/agent-transcript-tool.js +4 -3
  6. package/dist/agents/builtin-agents.d.ts +10 -7
  7. package/dist/agents/builtin-agents.js +1 -0
  8. package/dist/agents/cascade.d.ts +24 -11
  9. package/dist/agents/cascade.js +21 -9
  10. package/dist/agents/child-failure.d.ts +30 -0
  11. package/dist/agents/child-failure.js +25 -1
  12. package/dist/agents/composition-placement.d.ts +6 -2
  13. package/dist/agents/composition-placement.js +7 -3
  14. package/dist/agents/cross-session-envelope.d.ts +10 -1
  15. package/dist/agents/cross-session-envelope.js +6 -2
  16. package/dist/agents/cross-session-judge.d.ts +7 -1
  17. package/dist/agents/cross-session-judge.js +1 -0
  18. package/dist/agents/cumulative-stats.d.ts +36 -2
  19. package/dist/agents/cumulative-stats.js +44 -9
  20. package/dist/agents/delegation-registry-seat.js +2 -3
  21. package/dist/agents/inherited-tool-pool.d.ts +9 -4
  22. package/dist/agents/inherited-tool-pool.js +7 -1
  23. package/dist/agents/leg-label.d.ts +28 -0
  24. package/dist/agents/leg-label.js +9 -0
  25. package/dist/agents/list-agents-tool.d.ts +1 -1
  26. package/dist/agents/list-agents-tool.js +4 -4
  27. package/dist/agents/org-delivery-gate.d.ts +129 -23
  28. package/dist/agents/org-delivery-gate.js +41 -20
  29. package/dist/agents/peer-held-queue.d.ts +15 -10
  30. package/dist/agents/peer-held-queue.js +47 -19
  31. package/dist/agents/peer-notice-route.js +2 -2
  32. package/dist/agents/peer-notices.d.ts +13 -2
  33. package/dist/agents/peer-notices.js +12 -2
  34. package/dist/agents/peer-session-drain.d.ts +65 -15
  35. package/dist/agents/peer-session-drain.js +198 -41
  36. package/dist/agents/read-inbox-tool.d.ts +3 -2
  37. package/dist/agents/read-inbox-tool.js +7 -5
  38. package/dist/agents/repair-loop.js +20 -16
  39. package/dist/agents/retain-ledger.d.ts +1 -1
  40. package/dist/agents/retain-ledger.js +2 -4
  41. package/dist/agents/root-session-lane.d.ts +27 -0
  42. package/dist/agents/root-session-lane.js +57 -0
  43. package/dist/agents/roster-store.js +1 -2
  44. package/dist/agents/send-message-tool.js +6 -4
  45. package/dist/agents/subagent.d.ts +20 -4
  46. package/dist/agents/subagent.js +218 -183
  47. package/dist/agents/tool-filter.d.ts +3 -10
  48. package/dist/agents/tool-filter.js +0 -13
  49. package/dist/agents/verifier-independence.d.ts +31 -0
  50. package/dist/agents/verifier-independence.js +23 -0
  51. package/dist/agents/verify.d.ts +23 -11
  52. package/dist/agents/verify.js +28 -12
  53. package/dist/agents/yield-adoption.d.ts +24 -0
  54. package/dist/agents/yield-adoption.js +84 -0
  55. package/dist/bench/metrics.d.ts +2 -2
  56. package/dist/brain/anthropic.d.ts +4 -2
  57. package/dist/brain/anthropic.js +49 -35
  58. package/dist/brain/brain-faces.d.ts +11 -0
  59. package/dist/brain/brain-faces.js +6 -0
  60. package/dist/brain/cache-retention.d.ts +2 -0
  61. package/dist/brain/cache-retention.js +9 -0
  62. package/dist/brain/circuit-breaker.js +51 -26
  63. package/dist/brain/errors.d.ts +15 -1
  64. package/dist/brain/errors.js +8 -0
  65. package/dist/brain/failover.d.ts +6 -0
  66. package/dist/brain/failover.js +52 -37
  67. package/dist/brain/media-degrade.d.ts +5 -0
  68. package/dist/brain/media-degrade.js +4 -0
  69. package/dist/brain/model-capability.d.ts +2 -1
  70. package/dist/brain/model-lane.d.ts +145 -0
  71. package/dist/brain/model-lane.js +444 -0
  72. package/dist/brain/open-responses.js +19 -22
  73. package/dist/brain/openai.js +23 -22
  74. package/dist/brain/provider-message.d.ts +9 -0
  75. package/dist/brain/provider-message.js +18 -0
  76. package/dist/brain/reasoning-request.d.ts +9 -7
  77. package/dist/brain/reasoning-request.js +9 -10
  78. package/dist/brain/reasoning.d.ts +47 -13
  79. package/dist/brain/reasoning.js +20 -10
  80. package/dist/brain/route-adjudicator.d.ts +8 -2
  81. package/dist/brain/route-adjudicator.js +35 -1
  82. package/dist/brain/route-conformance.js +17 -0
  83. package/dist/brain/routing.d.ts +2 -0
  84. package/dist/brain/routing.js +19 -8
  85. package/dist/brain/status-sink.d.ts +5 -4
  86. package/dist/brain/status-sink.js +2 -2
  87. package/dist/brain/stream-engine.js +8 -2
  88. package/dist/brain/stream-shared.d.ts +12 -0
  89. package/dist/brain/stream-shared.js +18 -0
  90. package/dist/brain/timeout.d.ts +28 -0
  91. package/dist/brain/timeout.js +13 -4
  92. package/dist/brain/tool-schema-projection.d.ts +2 -0
  93. package/dist/brain/tool-schema-projection.js +108 -0
  94. package/dist/brain/usage-reading.d.ts +49 -0
  95. package/dist/brain/usage-reading.js +44 -0
  96. package/dist/brain/usage-reasoning.d.ts +38 -0
  97. package/dist/brain/usage-reasoning.js +9 -0
  98. package/dist/config/catalog.d.ts +3 -0
  99. package/dist/config/catalog.js +18 -9
  100. package/dist/core/a2a.d.ts +22 -4
  101. package/dist/core/a2a.js +191 -50
  102. package/dist/core/agent-definition.d.ts +3 -1
  103. package/dist/core/agent-state.d.ts +29 -16
  104. package/dist/core/agent-state.js +36 -9
  105. package/dist/core/allow-entry.d.ts +12 -3
  106. package/dist/core/allow-entry.js +10 -3
  107. package/dist/core/approval-display.d.ts +18 -0
  108. package/dist/core/approval-display.js +26 -0
  109. package/dist/core/approval-object.js +2 -2
  110. package/dist/core/approval-route.d.ts +16 -0
  111. package/dist/core/approval-route.js +5 -0
  112. package/dist/core/approval-words.d.ts +43 -0
  113. package/dist/core/approval-words.js +37 -0
  114. package/dist/core/ask-origin.d.ts +37 -10
  115. package/dist/core/ask-origin.js +19 -7
  116. package/dist/core/ask-question.d.ts +36 -8
  117. package/dist/core/ask-question.js +24 -9
  118. package/dist/core/ask-unresolvable-notice.d.ts +3 -2
  119. package/dist/core/ask-unresolvable-notice.js +3 -2
  120. package/dist/core/attachment-source.d.ts +50 -0
  121. package/dist/core/attachment-source.js +46 -0
  122. package/dist/core/auto-compaction.d.ts +151 -40
  123. package/dist/core/auto-compaction.js +115 -50
  124. package/dist/core/auto-mode.d.ts +5 -0
  125. package/dist/core/auto-mode.js +11 -4
  126. package/dist/core/background-agent-store.d.ts +151 -23
  127. package/dist/core/background-agent-store.js +201 -61
  128. package/dist/core/background-shell.d.ts +4 -1
  129. package/dist/core/background-shell.js +1 -0
  130. package/dist/core/cache-break-detector.d.ts +49 -25
  131. package/dist/core/cache-break-detector.js +99 -44
  132. package/dist/core/caller-text.d.ts +28 -0
  133. package/dist/core/caller-text.js +12 -0
  134. package/dist/core/canonical-json.d.ts +5 -0
  135. package/dist/core/canonical-json.js +7 -0
  136. package/dist/core/checkpoint-features.d.ts +80 -9
  137. package/dist/core/checkpoint-features.js +1 -1
  138. package/dist/core/checkpoint-generation.d.ts +8 -1
  139. package/dist/core/checkpoint-generation.js +3 -0
  140. package/dist/core/checkpoint-queries.d.ts +47 -14
  141. package/dist/core/checkpoint-queries.js +63 -30
  142. package/dist/core/checkpoint-requirements.d.ts +36 -3
  143. package/dist/core/checkpoint-requirements.js +11 -1
  144. package/dist/core/checkpoint-row-verdict.d.ts +0 -2
  145. package/dist/core/checkpoint-row-verdict.js +5 -8
  146. package/dist/core/checkpoint-store.d.ts +166 -41
  147. package/dist/core/checkpoint-store.js +96 -15
  148. package/dist/core/child-clamp-seats.d.ts +10 -2
  149. package/dist/core/child-clamp-seats.js +2 -2
  150. package/dist/core/classifier-unavailable-arm.d.ts +11 -9
  151. package/dist/core/classifier-unavailable-arm.js +4 -2
  152. package/dist/core/command-sandbox-dispatch.d.ts +13 -0
  153. package/dist/core/command-sandbox-dispatch.js +8 -0
  154. package/dist/core/command-sandbox.d.ts +231 -0
  155. package/dist/core/command-sandbox.js +344 -0
  156. package/dist/core/completion-id.d.ts +21 -0
  157. package/dist/core/completion-id.js +14 -0
  158. package/dist/core/config-refusal-codes.d.ts +22 -0
  159. package/dist/core/config-refusal-codes.js +196 -0
  160. package/dist/core/context-edit.d.ts +26 -0
  161. package/dist/core/context-edit.js +4 -2
  162. package/dist/core/context-guard.d.ts +80 -7
  163. package/dist/core/context-guard.js +126 -25
  164. package/dist/core/context-settings.d.ts +32 -0
  165. package/dist/core/context-settings.js +41 -3
  166. package/dist/core/contract-faces.d.ts +22 -0
  167. package/dist/core/contract-faces.js +1 -0
  168. package/dist/core/credential-echo.d.ts +2 -2
  169. package/dist/core/credential-echo.js +2 -2
  170. package/dist/core/cross-boundary-taint.d.ts +10 -8
  171. package/dist/core/decision-receipt.d.ts +3 -2
  172. package/dist/core/decision-receipt.js +1 -1
  173. package/dist/core/definition-entry-grammar.d.ts +42 -0
  174. package/dist/core/definition-entry-grammar.js +15 -0
  175. package/dist/core/engine-attestation.d.ts +19 -4
  176. package/dist/core/engine-attestation.js +4 -0
  177. package/dist/core/engine-capabilities.d.ts +8 -1
  178. package/dist/core/engine-capabilities.js +1 -1
  179. package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
  180. package/dist/core/engine-contracts/open-face-contract.js +57 -0
  181. package/dist/core/engine-notice.d.ts +161 -33
  182. package/dist/core/exclusive-temp.d.ts +25 -0
  183. package/dist/core/exclusive-temp.js +19 -0
  184. package/dist/core/existing-target.d.ts +112 -0
  185. package/dist/core/existing-target.js +88 -0
  186. package/dist/core/file-history-store.d.ts +14 -6
  187. package/dist/core/gate-lanes.js +8 -3
  188. package/dist/core/gate-outcome.d.ts +2 -1
  189. package/dist/core/git-worktree-env.d.ts +92 -1
  190. package/dist/core/git-worktree-env.js +87 -6
  191. package/dist/core/governance-codes.d.ts +49 -8
  192. package/dist/core/governance-codes.js +59 -8
  193. package/dist/core/hands-band.d.ts +10 -6
  194. package/dist/core/hooks.d.ts +60 -6
  195. package/dist/core/hooks.js +10 -2
  196. package/dist/core/host-floor.d.ts +24 -8
  197. package/dist/core/host-floor.js +45 -16
  198. package/dist/core/human-input-projection.d.ts +7 -0
  199. package/dist/core/human-input-projection.js +11 -3
  200. package/dist/core/image-admission.d.ts +16 -4
  201. package/dist/core/image-admission.js +29 -17
  202. package/dist/core/input-author.d.ts +43 -1
  203. package/dist/core/input-author.js +19 -0
  204. package/dist/core/isolation-scope.d.ts +41 -0
  205. package/dist/core/isolation-scope.js +10 -0
  206. package/dist/core/json-schema-seats.d.ts +11 -0
  207. package/dist/core/json-schema-seats.js +5 -0
  208. package/dist/core/leg-identity.d.ts +53 -5
  209. package/dist/core/leg-identity.js +32 -1
  210. package/dist/core/locked-config.d.ts +33 -38
  211. package/dist/core/locked-config.js +21 -3
  212. package/dist/core/lsp.js +2 -1
  213. package/dist/core/mailbox-store.d.ts +111 -18
  214. package/dist/core/mailbox-store.js +101 -13
  215. package/dist/core/mcp-call-meta.js +1 -1
  216. package/dist/core/mcp-connection-pool.d.ts +8 -2
  217. package/dist/core/mcp-connection-pool.js +3 -1
  218. package/dist/core/mcp-failure.d.ts +6 -1
  219. package/dist/core/mcp-failure.js +10 -0
  220. package/dist/core/mcp-host-read.d.ts +293 -0
  221. package/dist/core/mcp-host-read.js +428 -0
  222. package/dist/core/mcp-server-link.d.ts +28 -6
  223. package/dist/core/mcp-server-link.js +35 -7
  224. package/dist/core/mcp-server-spec.d.ts +22 -29
  225. package/dist/core/mcp-server-spec.js +7 -14
  226. package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
  227. package/dist/core/mcp-server-unavailable-notice.js +15 -0
  228. package/dist/core/mcp-session-end.d.ts +5 -2
  229. package/dist/core/mcp-session-end.js +7 -2
  230. package/dist/core/mcp-tool-meta.d.ts +6 -0
  231. package/dist/core/mcp-tool-meta.js +1 -0
  232. package/dist/core/mcp.d.ts +54 -19
  233. package/dist/core/mcp.js +194 -241
  234. package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
  235. package/dist/core/memory-engine/committed-shadow-read.js +21 -0
  236. package/dist/core/memory-engine/consolidation-driver.js +2 -1
  237. package/dist/core/memory-engine/consolidation.d.ts +3 -3
  238. package/dist/core/memory-engine/control-objects.d.ts +4 -3
  239. package/dist/core/memory-engine/control-objects.js +6 -4
  240. package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
  241. package/dist/core/memory-engine/delegation-settlement.js +145 -18
  242. package/dist/core/memory-engine/distiller.d.ts +2 -1
  243. package/dist/core/memory-engine/distiller.js +10 -5
  244. package/dist/core/memory-engine/dual-root.js +2 -2
  245. package/dist/core/memory-engine/engine.d.ts +127 -33
  246. package/dist/core/memory-engine/engine.js +774 -323
  247. package/dist/core/memory-engine/entry-scan.d.ts +3 -0
  248. package/dist/core/memory-engine/entry-scan.js +8 -0
  249. package/dist/core/memory-engine/export-bundle.d.ts +4 -0
  250. package/dist/core/memory-engine/export-bundle.js +2 -0
  251. package/dist/core/memory-engine/file-backend.d.ts +62 -17
  252. package/dist/core/memory-engine/file-backend.js +155 -99
  253. package/dist/core/memory-engine/index.d.ts +1 -1
  254. package/dist/core/memory-engine/index.js +1 -1
  255. package/dist/core/memory-engine/layer-observations.d.ts +7 -1
  256. package/dist/core/memory-engine/layer-observations.js +6 -0
  257. package/dist/core/memory-engine/layout.d.ts +88 -26
  258. package/dist/core/memory-engine/layout.js +105 -29
  259. package/dist/core/memory-engine/memory-deployment.js +4 -4
  260. package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
  261. package/dist/core/memory-engine/mount-failed-notice.js +22 -0
  262. package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
  263. package/dist/core/memory-engine/origin-clearance.js +30 -10
  264. package/dist/core/memory-engine/scan.js +1 -1
  265. package/dist/core/memory-engine/scope-contract.js +4 -3
  266. package/dist/core/memory-engine/session-write-home.js +13 -1
  267. package/dist/core/memory-engine/sync-client.d.ts +1 -1
  268. package/dist/core/memory-engine/sync-client.js +3 -1
  269. package/dist/core/memory-engine/tools.d.ts +5 -4
  270. package/dist/core/memory-engine/tools.js +1 -1
  271. package/dist/core/memory-engine/types.d.ts +18 -1
  272. package/dist/core/memory-engine/types.js +1 -0
  273. package/dist/core/memory.d.ts +1 -1
  274. package/dist/core/memory.js +2 -6
  275. package/dist/core/mode-policy.d.ts +8 -1
  276. package/dist/core/mode-policy.js +6 -2
  277. package/dist/core/model-fallbacks.d.ts +103 -0
  278. package/dist/core/model-fallbacks.js +79 -0
  279. package/dist/core/model-receipt.d.ts +15 -3
  280. package/dist/core/model-receipt.js +22 -1
  281. package/dist/core/model-seat.d.ts +1 -1
  282. package/dist/core/mods/classic-events.d.ts +5 -1
  283. package/dist/core/mods/dollar.d.ts +47 -2
  284. package/dist/core/mods/dollar.js +28 -5
  285. package/dist/core/mods/kernel/budget.d.ts +6 -0
  286. package/dist/core/mods/kernel/budget.js +6 -0
  287. package/dist/core/mods/kernel/dispatch.d.ts +23 -2
  288. package/dist/core/mods/kernel/dispatch.js +104 -15
  289. package/dist/core/mods/kernel/events.d.ts +18 -1
  290. package/dist/core/mods/kernel/events.js +7 -6
  291. package/dist/core/mods/kernel/index.d.ts +2 -2
  292. package/dist/core/mods/kernel/index.js +1 -1
  293. package/dist/core/mods/kernel/receive.d.ts +2 -1
  294. package/dist/core/mods/lifecycle-stations.d.ts +13 -4
  295. package/dist/core/mods/lifecycle-stations.js +8 -3
  296. package/dist/core/mods/message-display.d.ts +81 -0
  297. package/dist/core/mods/message-display.js +369 -0
  298. package/dist/core/mods/prompt-submit.d.ts +1 -1
  299. package/dist/core/mods/prompt-submit.js +5 -2
  300. package/dist/core/mods/session-append.d.ts +2 -2
  301. package/dist/core/mods/session-append.js +2 -1
  302. package/dist/core/mods/session-compact.js +2 -2
  303. package/dist/core/mods/stations.d.ts +48 -18
  304. package/dist/core/mods/stations.js +100 -19
  305. package/dist/core/mods/stop-answers.d.ts +23 -0
  306. package/dist/core/mods/stop-answers.js +20 -0
  307. package/dist/core/mounted-mcp.d.ts +48 -8
  308. package/dist/core/mounted-mcp.js +82 -16
  309. package/dist/core/namespaced-rule-name.js +2 -1
  310. package/dist/core/own-property-receipt.js +3 -5
  311. package/dist/core/parent-spec-seat.d.ts +20 -1
  312. package/dist/core/parent-spec-seat.js +13 -3
  313. package/dist/core/park-selfcheck.js +1 -0
  314. package/dist/core/path-identity.js +2 -1
  315. package/dist/core/peer-seat.d.ts +21 -7
  316. package/dist/core/peer-seat.js +25 -16
  317. package/dist/core/permission-rule-consent.js +15 -5
  318. package/dist/core/permission-rule-model.d.ts +4 -2
  319. package/dist/core/permission-rule-model.js +43 -23
  320. package/dist/core/permission-rule-store.d.ts +31 -16
  321. package/dist/core/permission-rule-store.js +27 -18
  322. package/dist/core/present-plan-tool.d.ts +6 -1
  323. package/dist/core/present-plan-tool.js +11 -3
  324. package/dist/core/pricing.d.ts +8 -6
  325. package/dist/core/pricing.js +1 -1
  326. package/dist/core/principal-name.d.ts +13 -0
  327. package/dist/core/principal-name.js +9 -2
  328. package/dist/core/process-identity.d.ts +140 -0
  329. package/dist/core/process-identity.js +215 -0
  330. package/dist/core/protocol-http-auth.d.ts +28 -6
  331. package/dist/core/protocol-http-auth.js +22 -5
  332. package/dist/core/protocol-naming.d.ts +7 -0
  333. package/dist/core/protocol-naming.js +12 -2
  334. package/dist/core/protocol-revocation.d.ts +72 -0
  335. package/dist/core/protocol-revocation.js +98 -0
  336. package/dist/core/protocol-table.d.ts +4 -4
  337. package/dist/core/protocol-table.js +3 -2
  338. package/dist/core/push-queue.d.ts +35 -2
  339. package/dist/core/push-queue.js +60 -4
  340. package/dist/core/read-only-shell.d.ts +19 -0
  341. package/dist/core/read-only-shell.js +38 -11
  342. package/dist/core/real-approval.d.ts +26 -0
  343. package/dist/core/real-approval.js +15 -0
  344. package/dist/core/redaction-marks.d.ts +6 -2
  345. package/dist/core/redaction-marks.js +3 -0
  346. package/dist/core/reminder-mint.d.ts +6 -0
  347. package/dist/core/reminder-mint.js +9 -8
  348. package/dist/core/remote-env.d.ts +31 -15
  349. package/dist/core/remote-env.js +29 -0
  350. package/dist/core/request-copy-projection.d.ts +51 -0
  351. package/dist/core/request-copy-projection.js +410 -0
  352. package/dist/core/resume-config-judge.d.ts +69 -0
  353. package/dist/core/resume-config-judge.js +78 -0
  354. package/dist/core/resume-startup-cause.d.ts +14 -4
  355. package/dist/core/resume-startup-cause.js +12 -2
  356. package/dist/core/retention-policy.js +2 -1
  357. package/dist/core/retention.d.ts +119 -24
  358. package/dist/core/retention.js +60 -16
  359. package/dist/core/retired-keys.d.ts +0 -10
  360. package/dist/core/retired-keys.js +2 -3
  361. package/dist/core/roles.d.ts +6 -0
  362. package/dist/core/roles.js +65 -4
  363. package/dist/core/row-shape.d.ts +149 -0
  364. package/dist/core/row-shape.js +184 -0
  365. package/dist/core/runner/advertised-writable-dirs.js +10 -9
  366. package/dist/core/runner/advisor-instructions.d.ts +11 -27
  367. package/dist/core/runner/advisor-instructions.js +18 -20
  368. package/dist/core/runner/advisor-tool.js +1 -0
  369. package/dist/core/runner/announce-once-ledger.js +4 -1
  370. package/dist/core/runner/approval-feedback.d.ts +17 -8
  371. package/dist/core/runner/approval-feedback.js +18 -13
  372. package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
  373. package/dist/core/runner/approver-defect-announcer.js +22 -0
  374. package/dist/core/runner/assemble-result.d.ts +29 -14
  375. package/dist/core/runner/assemble-result.js +16 -25
  376. package/dist/core/runner/cache-hit-account.d.ts +77 -0
  377. package/dist/core/runner/cache-hit-account.js +46 -0
  378. package/dist/core/runner/call-hook-stations.d.ts +3 -2
  379. package/dist/core/runner/call-hook-stations.js +5 -4
  380. package/dist/core/runner/changed-files-scan.d.ts +43 -0
  381. package/dist/core/runner/changed-files-scan.js +34 -0
  382. package/dist/core/runner/checkpoint-scope.d.ts +33 -9
  383. package/dist/core/runner/checkpoint-scope.js +27 -1
  384. package/dist/core/runner/classifier-ladder.d.ts +2 -2
  385. package/dist/core/runner/classifier-ladder.js +18 -9
  386. package/dist/core/runner/clock-and-limits.d.ts +15 -4
  387. package/dist/core/runner/clock-and-limits.js +19 -1
  388. package/dist/core/runner/compact-session.js +84 -14
  389. package/dist/core/runner/compaction-call-options.d.ts +2 -29
  390. package/dist/core/runner/compaction-call-options.js +2 -9
  391. package/dist/core/runner/compaction-restate.d.ts +18 -2
  392. package/dist/core/runner/compaction-restate.js +36 -2
  393. package/dist/core/runner/construction-doors.js +8 -0
  394. package/dist/core/runner/context-room.d.ts +55 -0
  395. package/dist/core/runner/context-room.js +71 -0
  396. package/dist/core/runner/contracts.d.ts +313 -205
  397. package/dist/core/runner/conversation-segment.d.ts +49 -14
  398. package/dist/core/runner/conversation-segment.js +92 -19
  399. package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
  400. package/dist/core/runner/cross-boundary-lane.js +9 -6
  401. package/dist/core/runner/decide-continuation.js +1 -1
  402. package/dist/core/runner/deferred-ask.d.ts +62 -0
  403. package/dist/core/runner/deferred-ask.js +44 -0
  404. package/dist/core/runner/delegation-owner.d.ts +19 -0
  405. package/dist/core/runner/delegation-owner.js +27 -1
  406. package/dist/core/runner/denial-limit-arms.d.ts +10 -6
  407. package/dist/core/runner/denial-limit-arms.js +13 -7
  408. package/dist/core/runner/env-capability-census.d.ts +1 -1
  409. package/dist/core/runner/file-history-request.js +2 -1
  410. package/dist/core/runner/file-history-restore.d.ts +16 -2
  411. package/dist/core/runner/file-history-restore.js +9 -1
  412. package/dist/core/runner/gate-exit.d.ts +18 -5
  413. package/dist/core/runner/gate-exit.js +26 -15
  414. package/dist/core/runner/git-status-frame.d.ts +26 -8
  415. package/dist/core/runner/git-status-frame.js +14 -9
  416. package/dist/core/runner/halt-attribution.d.ts +29 -12
  417. package/dist/core/runner/halt-attribution.js +38 -11
  418. package/dist/core/runner/image.js +3 -2
  419. package/dist/core/runner/initial-run-state.d.ts +1 -1
  420. package/dist/core/runner/initial-run-state.js +4 -4
  421. package/dist/core/runner/language-frame.d.ts +66 -0
  422. package/dist/core/runner/language-frame.js +76 -0
  423. package/dist/core/runner/leg-frame.d.ts +81 -0
  424. package/dist/core/runner/leg-frame.js +68 -0
  425. package/dist/core/runner/main-call-account.d.ts +34 -0
  426. package/dist/core/runner/main-call-account.js +50 -0
  427. package/dist/core/runner/mcp-redial.d.ts +9 -7
  428. package/dist/core/runner/mcp-redial.js +20 -21
  429. package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
  430. package/dist/core/runner/memory-consolidation-driver.js +5 -3
  431. package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
  432. package/dist/core/runner/messages-omitted-seat.js +21 -0
  433. package/dist/core/runner/model-fallback-seat.d.ts +20 -0
  434. package/dist/core/runner/model-fallback-seat.js +43 -0
  435. package/dist/core/runner/model-lane-seat.d.ts +12 -0
  436. package/dist/core/runner/model-lane-seat.js +35 -0
  437. package/dist/core/runner/nested-memory-content.d.ts +33 -0
  438. package/dist/core/runner/nested-memory-content.js +171 -0
  439. package/dist/core/runner/nested-memory-lane.d.ts +181 -0
  440. package/dist/core/runner/nested-memory-lane.js +673 -0
  441. package/dist/core/runner/park-commit.d.ts +7 -0
  442. package/dist/core/runner/park-commit.js +3 -0
  443. package/dist/core/runner/prepare-advisor.d.ts +7 -9
  444. package/dist/core/runner/prepare-advisor.js +11 -5
  445. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  446. package/dist/core/runner/prepare-artifact.js +8 -3
  447. package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
  448. package/dist/core/runner/prepare-ask-lane.js +32 -28
  449. package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
  450. package/dist/core/runner/prepare-boundary-parks.js +21 -17
  451. package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
  452. package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
  453. package/dist/core/runner/prepare-config-doors.d.ts +51 -5
  454. package/dist/core/runner/prepare-config-doors.js +73 -73
  455. package/dist/core/runner/prepare-context-lane.d.ts +68 -3
  456. package/dist/core/runner/prepare-context-lane.js +137 -27
  457. package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
  458. package/dist/core/runner/prepare-defer-classify.js +9 -13
  459. package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
  460. package/dist/core/runner/prepare-delegation-surface.js +72 -64
  461. package/dist/core/runner/prepare-execution-env.js +1 -9
  462. package/dist/core/runner/prepare-file-history.d.ts +3 -2
  463. package/dist/core/runner/prepare-file-history.js +11 -4
  464. package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
  465. package/dist/core/runner/prepare-gate-stations.js +13 -13
  466. package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
  467. package/dist/core/runner/prepare-hands-readface.js +18 -12
  468. package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
  469. package/dist/core/runner/prepare-inherited-gate.js +14 -10
  470. package/dist/core/runner/prepare-lsp.js +2 -1
  471. package/dist/core/runner/prepare-memory-engine-session.js +30 -10
  472. package/dist/core/runner/prepare-memory.d.ts +4 -0
  473. package/dist/core/runner/prepare-memory.js +38 -16
  474. package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
  475. package/dist/core/runner/prepare-offload-wrappers.js +6 -5
  476. package/dist/core/runner/prepare-park-ask.d.ts +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 +13 -28
  534. package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
  535. package/dist/core/runner/run-terminal-adoption.js +14 -9
  536. package/dist/core/runner/run-tool-mount-facts.js +5 -9
  537. package/dist/core/runner/run-turn-boundary.d.ts +3 -2
  538. package/dist/core/runner/run-turn-boundary.js +112 -106
  539. package/dist/core/runner/runtask.d.ts +28 -8
  540. package/dist/core/runner/runtask.js +132 -41
  541. package/dist/core/runner/session-file-state-replay.d.ts +5 -3
  542. package/dist/core/runner/session-file-state-replay.js +10 -3
  543. package/dist/core/runner/session-rule-policy.d.ts +3 -3
  544. package/dist/core/runner/session-verb-doors.d.ts +18 -3
  545. package/dist/core/runner/session-verb-doors.js +38 -6
  546. package/dist/core/runner/shell-env-withheld.d.ts +8 -5
  547. package/dist/core/runner/shell-env-withheld.js +4 -4
  548. package/dist/core/runner/side-call-account.d.ts +12 -8
  549. package/dist/core/runner/side-call-account.js +24 -15
  550. package/dist/core/runner/stream-halt-verbs.js +1 -0
  551. package/dist/core/runner/stream-mode-verb.js +2 -1
  552. package/dist/core/runner/stream-settle-backstop.js +4 -1
  553. package/dist/core/runner/stream-steer-verb.js +35 -19
  554. package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
  555. package/dist/core/runner/sub-agent-deny-lists.js +140 -39
  556. package/dist/core/runner/teardown-bounded.d.ts +6 -0
  557. package/dist/core/runner/teardown-bounded.js +12 -7
  558. package/dist/core/runner/terminal-account.d.ts +2 -0
  559. package/dist/core/runner/terminal-account.js +6 -1
  560. package/dist/core/runner/tool-disclosure.js +2 -1
  561. package/dist/core/runner/tool-end-body.js +3 -1
  562. package/dist/core/runner/tool-face-overlay.d.ts +1 -1
  563. package/dist/core/runner/tool-face-overlay.js +1 -1
  564. package/dist/core/runner/tool-occurrence.d.ts +34 -9
  565. package/dist/core/runner/tool-occurrence.js +32 -21
  566. package/dist/core/runner/tool-progress-lane.d.ts +20 -5
  567. package/dist/core/runner/tool-progress-lane.js +27 -5
  568. package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
  569. package/dist/core/runner/tool-result-media-seat.js +17 -1
  570. package/dist/core/runner/tool-table-view.js +1 -1
  571. package/dist/core/runner/turn-attachments.d.ts +44 -71
  572. package/dist/core/runner/turn-attachments.js +52 -104
  573. package/dist/core/runner/usage-accounting.d.ts +3 -2
  574. package/dist/core/runner/usage-accounting.js +3 -2
  575. package/dist/core/runner/void-verifier-pause.js +1 -1
  576. package/dist/core/runner-deps.d.ts +42 -158
  577. package/dist/core/runtime-caps.d.ts +16 -4
  578. package/dist/core/secret-env.d.ts +20 -3
  579. package/dist/core/secret-env.js +46 -23
  580. package/dist/core/sensitive-path-policy.d.ts +8 -0
  581. package/dist/core/sensitive-path-policy.js +10 -2
  582. package/dist/core/session-checkout.d.ts +32 -27
  583. package/dist/core/session-checkout.js +109 -61
  584. package/dist/core/session-log-transfer.js +2 -1
  585. package/dist/core/session-policy-store.d.ts +24 -11
  586. package/dist/core/session-policy-store.js +11 -2
  587. package/dist/core/session-store.d.ts +16 -2
  588. package/dist/core/session-store.js +43 -17
  589. package/dist/core/session.d.ts +31 -3
  590. package/dist/core/session.js +33 -2
  591. package/dist/core/shell-run-candidates.d.ts +20 -8
  592. package/dist/core/shell-run-candidates.js +44 -21
  593. package/dist/core/side-query.d.ts +17 -5
  594. package/dist/core/side-query.js +17 -14
  595. package/dist/core/skill-grant.js +2 -3
  596. package/dist/core/skills-directory.js +3 -66
  597. package/dist/core/snapshot-frame-seat.d.ts +8 -0
  598. package/dist/core/snapshot-frame-seat.js +24 -0
  599. package/dist/core/steer-replay.d.ts +19 -3
  600. package/dist/core/steer-replay.js +8 -1
  601. package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
  602. package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
  603. package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
  604. package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
  605. package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
  606. package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
  607. package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
  608. package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
  609. package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
  610. package/dist/core/store-contracts/session-repo-contract.js +130 -5
  611. package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
  612. package/dist/core/store-contracts/session-store-contract.js +17 -0
  613. package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
  614. package/dist/core/store-contracts/task-list-store-contract.js +240 -0
  615. package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
  616. package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
  617. package/dist/core/stub-env.d.ts +2 -2
  618. package/dist/core/stub-env.js +1 -0
  619. package/dist/core/synthetic-read-verdict.d.ts +38 -28
  620. package/dist/core/synthetic-read-verdict.js +19 -28
  621. package/dist/core/task-event.d.ts +171 -19
  622. package/dist/core/task-intake.d.ts +26 -0
  623. package/dist/core/task-intake.js +31 -0
  624. package/dist/core/task-limits.d.ts +8 -6
  625. package/dist/core/task-notification.d.ts +88 -8
  626. package/dist/core/task-notification.js +45 -5
  627. package/dist/core/task-registry-agent.d.ts +24 -7
  628. package/dist/core/task-registry-agent.js +51 -28
  629. package/dist/core/task-registry-monitor.js +16 -14
  630. package/dist/core/task-registry-shared.d.ts +177 -35
  631. package/dist/core/task-registry-shared.js +44 -17
  632. package/dist/core/task-registry-workflow.js +8 -5
  633. package/dist/core/task-registry-yield.d.ts +32 -0
  634. package/dist/core/task-registry-yield.js +85 -0
  635. package/dist/core/task-registry.d.ts +88 -10
  636. package/dist/core/task-registry.js +124 -33
  637. package/dist/core/task-result.d.ts +115 -31
  638. package/dist/core/task-spec-members.d.ts +140 -1
  639. package/dist/core/task-spec-members.js +23 -8
  640. package/dist/core/task-spec.d.ts +181 -51
  641. package/dist/core/task-spec.js +1 -1
  642. package/dist/core/task-stream.d.ts +12 -2
  643. package/dist/core/terminal-cause.d.ts +12 -4
  644. package/dist/core/thrown-value.d.ts +49 -7
  645. package/dist/core/thrown-value.js +38 -2
  646. package/dist/core/tool-catalog-entries.js +13 -3
  647. package/dist/core/tool-data-door.d.ts +7 -0
  648. package/dist/core/tool-data-door.js +13 -0
  649. package/dist/core/tool-face-lists.d.ts +25 -0
  650. package/dist/core/tool-face-lists.js +38 -0
  651. package/dist/core/tool-face-reader.d.ts +0 -10
  652. package/dist/core/tool-face-reader.js +5 -3
  653. package/dist/core/tool-list-grammar.d.ts +103 -0
  654. package/dist/core/tool-list-grammar.js +130 -0
  655. package/dist/core/tool-mount-facts.d.ts +47 -0
  656. package/dist/core/tool-mount-facts.js +50 -0
  657. package/dist/core/tool-mount-plan.d.ts +196 -0
  658. package/dist/core/tool-mount-plan.js +404 -0
  659. package/dist/core/tool-mount-static.d.ts +12 -0
  660. package/dist/core/tool-mount-static.js +174 -0
  661. package/dist/core/tool-name-aliases.d.ts +60 -2
  662. package/dist/core/tool-name-aliases.js +22 -2
  663. package/dist/core/tool-name-list.d.ts +3 -0
  664. package/dist/core/tool-name-readings.d.ts +4 -0
  665. package/dist/core/tool-name-readings.js +1 -0
  666. package/dist/core/tool-policy.d.ts +246 -51
  667. package/dist/core/tool-policy.js +165 -71
  668. package/dist/core/tool-registry.d.ts +4 -11
  669. package/dist/core/tool-registry.js +0 -3
  670. package/dist/core/tool-result-bytes.d.ts +94 -0
  671. package/dist/core/tool-result-bytes.js +34 -0
  672. package/dist/core/tool-result-store.d.ts +97 -13
  673. package/dist/core/tool-result-store.js +52 -4
  674. package/dist/core/tool-roster.d.ts +71 -10
  675. package/dist/core/tool-roster.js +71 -21
  676. package/dist/core/tool-search-setting.d.ts +7 -9
  677. package/dist/core/tool-search-setting.js +23 -7
  678. package/dist/core/tool-spec.d.ts +32 -2
  679. package/dist/core/tools.js +6 -20
  680. package/dist/core/trace.d.ts +63 -11
  681. package/dist/core/trace.js +19 -0
  682. package/dist/core/types.d.ts +8 -6
  683. package/dist/core/types.js +3 -1
  684. package/dist/core/unmatched-tool-names.d.ts +37 -0
  685. package/dist/core/unmatched-tool-names.js +18 -0
  686. package/dist/core/untrusted-egress.d.ts +16 -5
  687. package/dist/core/untrusted-egress.js +202 -32
  688. package/dist/core/untrusted-text.d.ts +29 -8
  689. package/dist/core/untrusted-text.js +6 -3
  690. package/dist/core/user-attachment.d.ts +129 -35
  691. package/dist/core/user-attachment.js +124 -57
  692. package/dist/core/user-row-origin.d.ts +63 -0
  693. package/dist/core/user-row-origin.js +61 -0
  694. package/dist/core/wiring-manifest.d.ts +161 -39
  695. package/dist/core/wiring-manifest.js +42 -6
  696. package/dist/core/workflow-run-store-contract.d.ts +11 -1
  697. package/dist/core/workflow-run-store-contract.js +60 -7
  698. package/dist/core/workflow-run-store.d.ts +61 -12
  699. package/dist/core/workflow-run-store.js +100 -15
  700. package/dist/core/workspace-snapshot.d.ts +10 -14
  701. package/dist/core/workspace-snapshot.js +3 -22
  702. package/dist/core/write-protect.d.ts +3 -5
  703. package/dist/core/write-protect.js +2 -4
  704. package/dist/engine/compaction/compaction.d.ts +3 -0
  705. package/dist/engine/compaction/compaction.js +4 -3
  706. package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
  707. package/dist/engine/execution-env/node-execution-env.js +80 -27
  708. package/dist/engine/harness/agent-harness.d.ts +143 -27
  709. package/dist/engine/harness/agent-harness.js +162 -74
  710. package/dist/engine/harness/types.d.ts +84 -13
  711. package/dist/engine/harness/types.js +21 -1
  712. package/dist/engine/llm/tool-turns.d.ts +4 -0
  713. package/dist/engine/llm/tool-turns.js +7 -2
  714. package/dist/engine/llm/types.d.ts +111 -24
  715. package/dist/engine/llm/types.js +69 -5
  716. package/dist/engine/llm/validation.js +2 -1
  717. package/dist/engine/loop/agent-loop.d.ts +39 -6
  718. package/dist/engine/loop/agent-loop.js +172 -82
  719. package/dist/engine/loop/types.d.ts +43 -4
  720. package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
  721. package/dist/engine/lsp/node-lsp-manager.js +14 -10
  722. package/dist/engine/session/import-validate.js +9 -0
  723. package/dist/engine/session/memory-repo.d.ts +8 -1
  724. package/dist/engine/session/memory-repo.js +20 -12
  725. package/dist/engine/session/repo-utils.d.ts +10 -0
  726. package/dist/engine/session/repo-utils.js +11 -5
  727. package/dist/engine/session/row-cells.d.ts +32 -0
  728. package/dist/engine/session/row-cells.js +25 -0
  729. package/dist/index.d.ts +63 -34
  730. package/dist/index.js +44 -21
  731. package/dist/internal/harness.d.ts +8 -6
  732. package/dist/internal/harness.js +6 -4
  733. package/dist/internal/llm.d.ts +2 -2
  734. package/dist/internal/llm.js +1 -1
  735. package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
  736. package/dist/orchestration/governance-baseline-validity.js +33 -9
  737. package/dist/orchestration/run-workflow-tool.d.ts +2 -0
  738. package/dist/orchestration/run-workflow-tool.js +25 -12
  739. package/dist/orchestration/workflow-governance.d.ts +19 -4
  740. package/dist/orchestration/workflow-governance.js +30 -9
  741. package/dist/orchestration/workflow-primitives.d.ts +4 -1
  742. package/dist/orchestration/workflow-primitives.js +2 -2
  743. package/dist/orchestration/workflow-script-runner.d.ts +1 -1
  744. package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
  745. package/dist/orchestration/workflow-types.d.ts +21 -12
  746. package/dist/orchestration/workflow-types.js +15 -4
  747. package/dist/orchestration/workflow.d.ts +37 -7
  748. package/dist/orchestration/workflow.js +81 -35
  749. package/dist/prompt-assembly/artifact-store.js +6 -9
  750. package/dist/prompt-assembly/assemble.d.ts +4 -10
  751. package/dist/prompt-assembly/assemble.js +1 -3
  752. package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
  753. package/dist/prompt-assembly/catalog/constitution.js +2 -0
  754. package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
  755. package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
  756. package/dist/prompt-assembly/catalog/engine.js +19 -0
  757. package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
  758. package/dist/prompt-assembly/catalog/environment.js +61 -0
  759. package/dist/prompt-assembly/catalog/index.d.ts +9 -2
  760. package/dist/prompt-assembly/catalog/index.js +73 -2
  761. package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
  762. package/dist/prompt-assembly/catalog/locales/index.js +22 -0
  763. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
  764. package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
  765. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
  766. package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
  767. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
  768. package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
  769. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
  770. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
  771. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
  772. package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
  773. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
  774. package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
  775. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
  776. package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
  777. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
  778. package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
  779. package/dist/prompt-assembly/catalog/role.js +3 -6
  780. package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
  781. package/dist/prompt-assembly/catalog/schema.js +2 -0
  782. package/dist/prompt-assembly/composer.d.ts +6 -11
  783. package/dist/prompt-assembly/composer.js +7 -7
  784. package/dist/prompt-assembly/engine-text.d.ts +9 -0
  785. package/dist/prompt-assembly/engine-text.js +33 -0
  786. package/dist/prompt-assembly/event-registry.js +3 -3
  787. package/dist/prompt-assembly/explain.d.ts +1 -0
  788. package/dist/prompt-assembly/explain.js +1 -1
  789. package/dist/prompt-assembly/locale-review.d.ts +13 -0
  790. package/dist/prompt-assembly/locale-review.js +19 -0
  791. package/dist/prompt-assembly/overlay.d.ts +7 -3
  792. package/dist/prompt-assembly/overlay.js +27 -5
  793. package/dist/prompt-assembly/renderers.d.ts +4 -4
  794. package/dist/prompt-assembly/renderers.js +26 -17
  795. package/dist/prompt-assembly/role-base.d.ts +1 -1
  796. package/dist/prompt-assembly/select.d.ts +26 -5
  797. package/dist/prompt-assembly/select.js +25 -2
  798. package/dist/prompt-assembly/slots.d.ts +19 -0
  799. package/dist/prompt-assembly/slots.js +16 -0
  800. package/dist/prompt-assembly/sugar.d.ts +4 -7
  801. package/dist/prompt-assembly/sugar.js +1 -2
  802. package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
  803. package/dist/prompt-assembly/tool-catalog.js +5 -1
  804. package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
  805. package/dist/prompt-assembly/turn-snapshot.js +43 -13
  806. package/dist/prompt-assembly/types.d.ts +3 -0
  807. package/dist/prompts/cowork.d.ts +6 -25
  808. package/dist/prompts/cowork.js +10 -12
  809. package/dist/prompts/default.d.ts +10 -32
  810. package/dist/prompts/default.js +37 -63
  811. package/dist/shell/lex.d.ts +39 -13
  812. package/dist/shell/lex.js +70 -30
  813. package/dist/stores/file/background-agent-store.d.ts +5 -0
  814. package/dist/stores/file/background-agent-store.js +35 -61
  815. package/dist/stores/file/checkpoint-store.d.ts +5 -3
  816. package/dist/stores/file/checkpoint-store.js +8 -10
  817. package/dist/stores/file/fs-atomic.d.ts +27 -70
  818. package/dist/stores/file/fs-atomic.js +52 -148
  819. package/dist/stores/file/index.d.ts +12 -0
  820. package/dist/stores/file/index.js +27 -2
  821. package/dist/stores/file/mailbox-store.d.ts +10 -1
  822. package/dist/stores/file/mailbox-store.js +40 -12
  823. package/dist/stores/file/permission-rule-adopt.js +5 -2
  824. package/dist/stores/file/permission-rule-store.d.ts +81 -20
  825. package/dist/stores/file/permission-rule-store.js +126 -33
  826. package/dist/stores/file/session-policy-store.d.ts +2 -2
  827. package/dist/stores/file/session-store.d.ts +21 -2
  828. package/dist/stores/file/session-store.js +27 -14
  829. package/dist/stores/file/task-list-store.js +23 -25
  830. package/dist/stores/file/tool-result-store.d.ts +45 -7
  831. package/dist/stores/file/tool-result-store.js +99 -36
  832. package/dist/stores/file/workflow-run-store.d.ts +1 -0
  833. package/dist/stores/file/workflow-run-store.js +14 -11
  834. package/dist/tools/artifact/artifact-tool.js +2 -0
  835. package/dist/tools/artifact/local-stub.js +6 -6
  836. package/dist/tools/fs/bash-program-position.d.ts +1 -2
  837. package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
  838. package/dist/tools/fs/bash-readonly-classifier.js +50 -12
  839. package/dist/tools/fs/env-error-detail.d.ts +1 -0
  840. package/dist/tools/fs/env-error-detail.js +7 -0
  841. package/dist/tools/fs/fs-bash.d.ts +24 -6
  842. package/dist/tools/fs/fs-bash.js +73 -25
  843. package/dist/tools/fs/fs-pdf.js +6 -4
  844. package/dist/tools/fs/fs-read.d.ts +76 -31
  845. package/dist/tools/fs/fs-read.js +159 -79
  846. package/dist/tools/fs/fs-search-tools.d.ts +1 -1
  847. package/dist/tools/fs/fs-search-tools.js +3 -1
  848. package/dist/tools/fs/fs-shared.d.ts +59 -63
  849. package/dist/tools/fs/fs-shared.js +31 -18
  850. package/dist/tools/fs/fs-write.d.ts +13 -0
  851. package/dist/tools/fs/fs-write.js +69 -13
  852. package/dist/tools/fs/index.d.ts +19 -1
  853. package/dist/tools/fs/index.js +10 -2
  854. package/dist/tools/fs/pdf.js +10 -9
  855. package/dist/tools/fs/read-deny.js +4 -10
  856. package/dist/tools/fs/read-floor.d.ts +5 -4
  857. package/dist/tools/fs/removal-targets.d.ts +11 -5
  858. package/dist/tools/fs/removal-targets.js +62 -32
  859. package/dist/tools/fs/safety.d.ts +26 -19
  860. package/dist/tools/fs/safety.js +13 -8
  861. package/dist/tools/fs/search.d.ts +1 -1
  862. package/dist/tools/fs/shell-read-argv.js +1 -0
  863. package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
  864. package/dist/tools/fs/shell-read-bindings.js +667 -139
  865. package/dist/tools/fs/shell-read-check.js +1 -1
  866. package/dist/tools/fs/shell-read-judge.d.ts +4 -1
  867. package/dist/tools/fs/shell-read-judge.js +5 -1
  868. package/dist/tools/fs/shell-read-plan.d.ts +4 -0
  869. package/dist/tools/fs/shell-read-plan.js +21 -19
  870. package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
  871. package/dist/tools/fs/shell-read-sourced.js +18 -1
  872. package/dist/tools/fs/shell-read-start.d.ts +6 -6
  873. package/dist/tools/fs/shell-read-start.js +1 -6
  874. package/dist/tools/fs/shell-read-word.d.ts +4 -2
  875. package/dist/tools/fs/shell-read-word.js +7 -6
  876. package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
  877. package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
  878. package/dist/tools/fs/shell-reentry-text.js +50 -20
  879. package/dist/tools/monitor.d.ts +4 -0
  880. package/dist/tools/monitor.js +14 -4
  881. package/dist/tools/scheduler-tools.d.ts +5 -2
  882. package/dist/tools/scheduler-tools.js +8 -6
  883. package/dist/tools/task-list.d.ts +49 -20
  884. package/dist/tools/task-list.js +115 -35
  885. package/dist/tools/web.d.ts +13 -3
  886. package/dist/tools/web.js +17 -6
  887. package/dist/tools/worktree.d.ts +3 -2
  888. package/dist/tools/worktree.js +24 -25
  889. package/package.json +10 -3
  890. package/test/export-surface.snapshot.json +330 -32
  891. package/wire-changes/core-stores-sql@7.67.0.json +39 -0
  892. package/wire-changes/core@7.67.0.json +12578 -0
  893. package/wire-changes/mods-kernel@7.67.0.json +167 -0
  894. package/wire-changes/primitives@7.67.0.json +325 -0
  895. package/wire-changes/wiki-gate@7.67.0.json +1636 -0
  896. package/dist/brain/degrading.d.ts +0 -93
  897. package/dist/brain/degrading.js +0 -189
  898. package/dist/core/tool-conformance.d.ts +0 -20
  899. package/dist/core/tool-conformance.js +0 -37
@@ -1,10 +1,12 @@
1
1
  import {} from "../internal/llm.js";
2
2
  import { BrainError } from "./errors.js";
3
3
  import { DEGENERATE_MESSAGE, trimDegenerateTail } from "./repetition.js";
4
- import { STREAM_TORN_WARNING, createRepetitionPoll, droppedFramesNote, modelOutputInvalidOf, noteResponseModel, nameMissingCause, parseStreamedToolArgs, placeTurnNotes } from "./stream-shared.js";
4
+ import { STREAM_TORN_WARNING, createRepetitionPoll, droppedFramesNote, memberReader, modelOutputInvalidOf, noteResponseModel, nameMissingCause, parseStreamedToolArgs, placeTurnNotes } from "./stream-shared.js";
5
+ import { reasoningTokensOf } from "./usage-reasoning.js";
6
+ import { usageOfStatement } from "./usage-reading.js";
5
7
  import { admitToolCallId, providerResultIds, providerToolCallId, responseToolCallIds } from "./tool-call-id.js";
6
8
  import { emitBrainTelemetry } from "./status-sink.js";
7
- import { errorResultMediaNote, IMAGE_OMITTED_NO_VISION, imageWithholdOf, imagesOmittedNoVisionNote, reportImagesWithheld, sendableImages } from "./media-degrade.js";
9
+ import { errorResultMediaNote, IMAGE_OMITTED_NO_VISION, imageWithholdOf, imagesOmittedNoVisionNote, reportImagesWithheld, sendableImages, toolImagesPrefix } from "./media-degrade.js";
8
10
  import { OUTPUT_CAP_KEYS, RESPONSES_RESERVED, applyExtraBody, declaredRequestValues, effectiveOutputCap, headerBagOnce, lockHeader, mergeHeaders } from "./request-params.js";
9
11
  import { admitRouteRequest, applyRouteCredentialHeaders, assertServableRequestRoot, brainConfigSnapshot, createBrainRouteJudge, joinRequestUrl, resolveRequestRootOf, resolveRouteCredential } from "./route-adjudicator.js";
10
12
  import { requestRouteOf } from "./request-route.js";
@@ -13,6 +15,7 @@ import { applyReasoningToRequest } from "./reasoning-request.js";
13
15
  import { runStreamingBrain } from "./stream-engine.js";
14
16
  import { refuseRetiredTimeoutKnobs } from "./timeout.js";
15
17
  import { resolveFetch } from "./transport.js";
18
+ import { projectToolSchema } from "./tool-schema-projection.js";
16
19
  const OPEN_RESPONSES_KEY_HEADER = "authorization";
17
20
  const DEGENERATE_POLL_CHARS = 64;
18
21
  const MALFORMED_SAMPLE_CHARS = 160;
@@ -76,7 +79,7 @@ function toResponsesInput(ctx, model, replayReasoning, toolNames) {
76
79
  type: "message",
77
80
  role: "user",
78
81
  content: [
79
- { type: "input_text", text: `[Image${pendingImages.length > 1 ? "s" : ""} from tool result ${ids}]` },
82
+ { type: "input_text", text: toolImagesPrefix(pendingImages.length, ids, ctx.promptLocale) },
80
83
  ...pendingImages.map((i) => ({ type: "input_image", image_url: `data:${i.mimeType};base64,${i.data}` })),
81
84
  ],
82
85
  });
@@ -152,26 +155,19 @@ function toResponsesTools(ctx, toolNames) {
152
155
  type: "function",
153
156
  name: toolNames.sent(t.name),
154
157
  description: t.description,
155
- parameters: t.parameters,
158
+ parameters: projectToolSchema(t.parameters),
156
159
  strict: false,
157
160
  }));
158
161
  }
159
- function computeUsage(model, raw) {
160
- const input = raw?.input_tokens ?? 0;
161
- const output = raw?.output_tokens ?? 0;
162
- const total = raw?.total_tokens ?? input + output;
163
- const cacheRead = raw?.input_tokens_details?.cached_tokens ?? 0;
164
- const c = model.cost;
165
- const costInput = (input / 1e6) * (c?.input ?? 0);
166
- const costOutput = (output / 1e6) * (c?.output ?? 0);
167
- return {
168
- input,
169
- output,
170
- cacheRead,
171
- cacheWrite: 0,
172
- totalTokens: total,
173
- cost: { input: costInput, output: costOutput, cacheRead: 0, cacheWrite: 0, total: costInput + costOutput },
174
- };
162
+ function reasoningOf(raw) {
163
+ if (raw === undefined)
164
+ return { unreadable: false };
165
+ const claimed = memberReader().claimIn(raw.output_tokens_details, "reasoning_tokens");
166
+ const { reasoning, unreadable } = reasoningTokensOf(typeof raw.output_tokens === "number" ? raw.output_tokens : 0, claimed);
167
+ return { ...(reasoning !== undefined ? { reasoning } : {}), unreadable };
168
+ }
169
+ function reportedUsageOf(model, raw) {
170
+ return usageOfStatement(model, "input-includes-cached", { input: raw?.input_tokens, output: raw?.output_tokens, cacheRead: raw?.input_tokens_details?.cached_tokens, total: raw?.total_tokens }, reasoningOf(raw));
175
171
  }
176
172
  function responsesErrorCode(code) {
177
173
  switch (code) {
@@ -735,6 +731,7 @@ export function createOpenResponsesBrain(given = {}) {
735
731
  ? "length_empty"
736
732
  : undefined;
737
733
  const capFacts = { capStop: truncated, outputTokens: usageRaw?.output_tokens, capTokens: sentMaxTokens };
734
+ const usageReading = reportedUsageOf(model, usageRaw);
738
735
  const modelOutputInvalid = errored && toolError !== undefined && !degenerate && !safetyCut && !refused ? modelOutputInvalidOf({ truncated: malformed.length, unnamed: unnamed.length }, capFacts) : undefined;
739
736
  const diagnostics = capabilityNotes.length > 0
740
737
  ? [...(partial.diagnostics ?? []), { type: CAPABILITY_DIAGNOSTIC_TYPE, timestamp: Date.now(), details: { notes: [...capabilityNotes] } }]
@@ -743,8 +740,8 @@ export function createOpenResponsesBrain(given = {}) {
743
740
  ...partial,
744
741
  content: finalContent.length > 0 ? finalContent : [{ type: "text", text: "" }],
745
742
  stopReason: errored ? "error" : mapTerminalStopReason(incompleteReason, toolCalls.length > 0),
746
- usage: computeUsage(model, usageRaw),
747
- ...(usageRaw === undefined ? { usageMissing: true } : {}),
743
+ usage: usageReading.usage,
744
+ ...(usageReading.missing ? { usageMissing: true } : {}),
748
745
  timestamp: Date.now(),
749
746
  ...(responseId !== undefined ? { responseId } : {}),
750
747
  ...(errorMessageOut ? { errorMessage: errorMessageOut } : {}),
@@ -4,17 +4,20 @@ import { DEGENERATE_MESSAGE, trimDegenerateTail } from "./repetition.js";
4
4
  import { NO_WORD, STREAM_TORN_WARNING, createRepetitionPoll, createStreamEndLedger, droppedFramesNote, echoFoldedWord, endingWordOf, memberReader, modelOutputInvalidOf, noteResponseModel, nameMissingCause, parseStreamedToolArgs, placeTurnNotes, truncationCauseClause } from "./stream-shared.js";
5
5
  import { admitToolCallId, providerResultIds, providerToolCallId, responseToolCallIds } from "./tool-call-id.js";
6
6
  import { emitBrainTelemetry } from "./status-sink.js";
7
- import { errorResultMediaNote, IMAGE_OMITTED_NO_VISION, imageWithholdOf, imagesOmittedNoVisionNote, reportImagesWithheld, sendableImages } from "./media-degrade.js";
7
+ import { errorResultMediaNote, IMAGE_OMITTED_NO_VISION, imageWithholdOf, imagesOmittedNoVisionNote, reportImagesWithheld, sendableImages, toolImagesPrefix } from "./media-degrade.js";
8
8
  import { capabilityHeld } from "./model-capability.js";
9
9
  import { OPENAI_RESERVED, OUTPUT_CAP_KEYS, applyExtraBody, declaredRequestValues, effectiveOutputCap, headerBagOnce, lockHeader, mergeHeaders } from "./request-params.js";
10
10
  import { BrainError, providerErrorWord } from "./errors.js";
11
11
  import { NAMES_AS_WRITTEN, inBandProviderError, resolveProviderDialect, endpointToolNames } from "./provider-dialect.js";
12
12
  import { admitRouteRequest, applyRouteCredentialHeaders, assertServableRequestRoot, brainConfigSnapshot, createBrainRouteJudge, joinRequestUrl, resolveRequestRootOf, resolveRouteCredential } from "./route-adjudicator.js";
13
13
  import { requestRouteOf } from "./request-route.js";
14
+ import { reasoningTokensOf } from "./usage-reasoning.js";
15
+ import { usageOfStatement } from "./usage-reading.js";
14
16
  import { applyReasoningToRequest } from "./reasoning-request.js";
15
17
  import { runStreamingBrain } from "./stream-engine.js";
16
18
  import { refuseRetiredTimeoutKnobs } from "./timeout.js";
17
19
  import { resolveFetch } from "./transport.js";
20
+ import { projectToolSchema } from "./tool-schema-projection.js";
18
21
  const OPENAI_KEY_HEADER = "authorization";
19
22
  function closeToolCallAccum(acc, responseIds, closed) {
20
23
  if (acc.closedTc)
@@ -97,7 +100,7 @@ function toOpenAIMessages(ctx, replayThinking = true, model, toolNames) {
97
100
  out.push({
98
101
  role: "user",
99
102
  content: [
100
- { type: "text", text: `[Image${pendingImages.length > 1 ? "s" : ""} from tool result ${ids}]` },
103
+ { type: "text", text: toolImagesPrefix(pendingImages.length, ids, ctx.promptLocale) },
101
104
  ...pendingImages.map((i) => ({ type: "image_url", image_url: { url: `data:${i.mimeType};base64,${i.data}` } })),
102
105
  ],
103
106
  });
@@ -177,7 +180,7 @@ function toOpenAITools(ctx, toolNames) {
177
180
  }
178
181
  return ctx.tools.map((t) => ({
179
182
  type: "function",
180
- function: { name: toolNames.sent(t.name), description: t.description, parameters: t.parameters },
183
+ function: { name: toolNames.sent(t.name), description: t.description, parameters: projectToolSchema(t.parameters) },
181
184
  }));
182
185
  }
183
186
  const FINISH_REASON_READINGS = Object.freeze({
@@ -207,12 +210,15 @@ function offeredOf(delta) {
207
210
  const present = (o) => Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
208
211
  function readUsage(seat, u) {
209
212
  const details = seat.object(u.prompt_tokens_details);
213
+ const nested = seat.claimIn(u.completion_tokens_details, "reasoning_tokens");
210
214
  return present({
211
215
  prompt_tokens: seat.count(u.prompt_tokens),
212
216
  completion_tokens: seat.count(u.completion_tokens),
213
217
  total_tokens: seat.count(u.total_tokens),
214
218
  prompt_tokens_details: details === undefined ? undefined : present({ cached_tokens: seat.count(details.cached_tokens) }),
215
219
  prompt_cache_hit_tokens: seat.count(u.prompt_cache_hit_tokens),
220
+ completion_tokens_details: nested === undefined ? undefined : { reasoning_tokens: nested },
221
+ reasoning_tokens: seat.claim(u.reasoning_tokens),
216
222
  });
217
223
  }
218
224
  function readChunk(raw) {
@@ -269,22 +275,16 @@ function mapFinishReason(reason, hadToolCalls) {
269
275
  }
270
276
  return "stop";
271
277
  }
272
- function computeUsage(model, raw) {
273
- const input = raw?.prompt_tokens ?? 0;
274
- const output = raw?.completion_tokens ?? 0;
275
- const total = raw?.total_tokens ?? input + output;
276
- const cacheRead = raw?.prompt_tokens_details?.cached_tokens ?? raw?.prompt_cache_hit_tokens ?? 0;
277
- const c = model.cost;
278
- const costInput = (input / 1e6) * (c?.input ?? 0);
279
- const costOutput = (output / 1e6) * (c?.output ?? 0);
280
- return {
281
- input,
282
- output,
283
- cacheRead,
284
- cacheWrite: 0,
285
- totalTokens: total,
286
- cost: { input: costInput, output: costOutput, cacheRead: 0, cacheWrite: 0, total: costInput + costOutput },
287
- };
278
+ function reasoningOf(raw) {
279
+ return reasoningTokensOf(raw?.completion_tokens ?? 0, raw?.completion_tokens_details?.reasoning_tokens, raw?.reasoning_tokens);
280
+ }
281
+ function reportedUsageOf(model, raw) {
282
+ return usageOfStatement(model, "input-includes-cached", {
283
+ input: raw?.prompt_tokens,
284
+ output: raw?.completion_tokens,
285
+ cacheRead: raw?.prompt_tokens_details?.cached_tokens ?? raw?.prompt_cache_hit_tokens,
286
+ total: raw?.total_tokens,
287
+ }, reasoningOf(raw));
288
288
  }
289
289
  export function inferMaxTokensField(modelId) {
290
290
  const id = modelId.toLowerCase();
@@ -646,9 +646,10 @@ export function createOpenAIBrain(given = {}) {
646
646
  notes.push({ cause: "bad_frame", count: malformedFrames, text: droppedFramesNote(malformedFrames, malformedSample) });
647
647
  }
648
648
  placeTurnNotes(partial, finalContent, notes);
649
- const usageMissing = usageRaw === undefined || usageUnreadable;
649
+ const usageReading = reportedUsageOf(model, usageRaw);
650
+ const usageMissing = usageReading.missing || usageUnreadable;
650
651
  if (inBandError !== undefined) {
651
- ctrl.keepOutput({ content: finalContent, usage: computeUsage(model, usageRaw), ...(usageMissing ? { usageMissing: true } : {}) });
652
+ ctrl.keepOutput({ content: finalContent, usage: usageReading.usage, ...(usageMissing ? { usageMissing: true } : {}) });
652
653
  throw inBandError;
653
654
  }
654
655
  const truncatedEmpty = finishReason === "length" && noUsableContent && !toolError;
@@ -710,7 +711,7 @@ export function createOpenAIBrain(given = {}) {
710
711
  ...partial,
711
712
  content: finalContent.length > 0 ? finalContent : [{ type: "text", text: "" }],
712
713
  stopReason: errored ? "error" : mapFinishReason(finishReason, toolCalls.length > 0),
713
- usage: computeUsage(model, usageRaw),
714
+ usage: usageReading.usage,
714
715
  ...(usageMissing ? { usageMissing: true } : {}),
715
716
  timestamp: Date.now(),
716
717
  ...(errorMessageOut ? { errorMessage: errorMessageOut } : {}),
@@ -0,0 +1,9 @@
1
+ import { type FailedBody } from "./errors.js";
2
+ /** The bound on a carried sentence, in code points (the pass cuts after masking, so a cut leaves no part of a credential). */
3
+ export declare const PROVIDER_MESSAGE_MAX_CHARS = 240;
4
+ /** A sentence through the one pass; `undefined` for a value that is not a string, or says nothing once the pass has folded it. */
5
+ export declare function providerMessageOf(sentence: unknown, declared: readonly string[]): string | undefined;
6
+ /** The sentence a failed response's envelope states, as the engine carries it; `declared` = the request's declared values. */
7
+ export declare function readProviderMessage(body: FailedBody | undefined, declared: readonly string[]): string | undefined;
8
+ /** A value that crossed a seat the engine did not mint (a host Brain's message or status): the same pass, no declared values. */
9
+ export declare function admittedProviderMessage(value: unknown): string | undefined;
@@ -0,0 +1,18 @@
1
+ import { remoteWords } from "../core/protocol-http-auth.js";
2
+ import { egressText } from "../core/untrusted-egress.js";
3
+ import { inlineUntrusted } from "../core/untrusted-text.js";
4
+ import { statedEnvelope } from "./errors.js";
5
+ export const PROVIDER_MESSAGE_MAX_CHARS = 240;
6
+ export function providerMessageOf(sentence, declared) {
7
+ if (typeof sentence !== "string")
8
+ return undefined;
9
+ const folded = inlineUntrusted(sentence, Number.POSITIVE_INFINITY);
10
+ const carried = inlineUntrusted(egressText("human", remoteWords(folded, declared)), PROVIDER_MESSAGE_MAX_CHARS);
11
+ return carried === "" ? undefined : carried;
12
+ }
13
+ export function readProviderMessage(body, declared) {
14
+ return providerMessageOf(statedEnvelope(body)?.message, declared);
15
+ }
16
+ export function admittedProviderMessage(value) {
17
+ return providerMessageOf(value, []);
18
+ }
@@ -8,17 +8,18 @@ import { type OffCapabilityModel, type ReasoningWireFacts } from "./reasoning.js
8
8
  *
9
9
  * What is decided elsewhere and only READ here: whether the request carries thinking at all
10
10
  * ({@link reasoningRequestCarried}), the tier clamp and the `thinkingLevelMap` translation
11
- * ({@link mintEffortWireValue}), and whether "off" has a deployment-declared spelling ({@link declaredOffSpelling}).
11
+ * ({@link mintEffortWireValue}), and whether the wire spells "off" at all ({@link offSpelling}).
12
12
  */
13
13
  /** The tiers a request for the answer alone can ask for: `off` where the wire spells it, `low` where it cannot. */
14
14
  export type ReasoningSeat = "off" | "low";
15
15
  /**
16
- * The lowest reasoning tier a request for the answer alone can take on this model's wire — one predicate: does the wire
17
- * spell off ({@link thinkingOffSpelled})? Yes ⇒ `"off"`, and the output cap needs room for the answer only. No ⇒ `"low"`:
16
+ * The lowest reasoning tier a request for the answer alone can take on this model's wire — one table: does the wire
17
+ * spell off ({@link offSpelling})? Yes ⇒ `"off"`, and the output cap needs room for the answer only. No ⇒ `"low"`:
18
18
  * a model whose thinking the wire cannot turn off is asked for the least it can grade, and the cap needs room for that
19
19
  * thinking too — `AUTO_MODE_CLASSIFIER_LOW_REASONING_BUDGET_TOKENS` is the allowance the engine's own side requests add.
20
- * A model that declares no reasoning is on the `low` seat as well: its wire carries nothing either way, so the request is
21
- * the gateway's default, and a default-on gateway thinks.
20
+ * A model whose wire names no dialect — a completions model that does not hold reasoning and declares no
21
+ * `compat.thinkingFormat` — is on the `low` seat as well: its wire carries nothing either way, so the request is the
22
+ * gateway's default, and a default-on gateway thinks.
22
23
  *
23
24
  * Callers pass the seat as `level` to {@link applyReasoningToRequest}; the classifier's seat tier is this verdict.
24
25
  */
@@ -77,8 +78,9 @@ export interface AppliedReasoning {
77
78
  *
78
79
  * It answers the question a host that builds its own request has — "which keys does THIS model take for THIS tier?" —
79
80
  * from the same table the engine's brains read, so a host never keeps a copy of a dialect. Absence is meaningful:
80
- * a model that does not declare `reasoning`, a `level` that is `undefined` or not a real tier, and a tier the wire
81
- * cannot carry write nothing, and the provider's default governs.
81
+ * an enabling tier on a model that does not hold `reasoning`, `off` where the wire has no spelling for it
82
+ * ({@link offSpelling}), a `level` that is `undefined` or not a real tier, and a tier the wire cannot carry write
83
+ * nothing, and the provider's default governs.
82
84
  *
83
85
  * @example
84
86
  * const { body, headers } = applyReasoningToRequest({ api: model.api, model, level: "low", body: { model: model.id, max_tokens: 2304, messages } });
@@ -1,8 +1,7 @@
1
- import { capabilityHeld } from "./model-capability.js";
2
1
  import { headerListEntries, lockHeader, takeHeaderSpellings } from "./request-params.js";
3
- import { MIN_THINKING_TOKENS, RESPONSES_APIS, budgetCapSkipsThinking, completionsFormatOf, declaredEffortLevels, declaredOffSpelling, mintEffortWireValue, reasoningBudgetShare, reasoningRequestCarried, resolveEffort, thinkingOffSpelled, } from "./reasoning.js";
2
+ import { MIN_THINKING_TOKENS, RESPONSES_APIS, budgetCapSkipsThinking, completionsFormatOf, declaredEffortLevels, declaredOffSpelling, mintEffortWireValue, offSpelling, reasoningBudgetShare, reasoningRequestCarried, resolveEffort, } from "./reasoning.js";
4
3
  export function lowestReasoningSeat(model) {
5
- return thinkingOffSpelled(model) ? "off" : "low";
4
+ return offSpelling(model).spelled ? "off" : "low";
6
5
  }
7
6
  const BETA_EFFORT = "effort-2025-11-24";
8
7
  const BETA_CONTEXT_MANAGEMENT = "context-management-2025-06-27";
@@ -63,8 +62,8 @@ function applyCompletions(input, body) {
63
62
  const { model, level } = input;
64
63
  const compat = (model.compat ?? {});
65
64
  const dialect = completionsDialectOf(compat);
66
- if (capabilityHeld(model, "reasoning") && level === "off")
67
- return bodyOnly(body, dialect?.off(body, model));
65
+ if (level === "off")
66
+ return bodyOnly(body, offSpelling(model, input.api).spelled ? dialect?.off(body, model) : undefined);
68
67
  if (!reasoningRequestCarried(model, level))
69
68
  return bodyOnly(body);
70
69
  const supportsEffort = compat.supportsReasoningEffort ?? true;
@@ -73,14 +72,14 @@ function applyCompletions(input, body) {
73
72
  }
74
73
  function applyResponses(input, body) {
75
74
  const { model, level } = input;
76
- const effort = responsesEffort(model, level);
75
+ const effort = responsesEffort(model, level, input.api);
77
76
  if (effort !== undefined)
78
77
  body.reasoning = { effort };
79
78
  return bodyOnly(body, effort);
80
79
  }
81
- function responsesEffort(model, level) {
82
- if (capabilityHeld(model, "reasoning") && level === "off")
83
- return declaredOffSpelling(model);
80
+ function responsesEffort(model, level, api) {
81
+ if (level === "off")
82
+ return offSpelling(model, api).spelled ? declaredOffSpelling(model) : undefined;
84
83
  const compat = (model.compat ?? {});
85
84
  if (compat.supportsReasoningEffort === false)
86
85
  return undefined;
@@ -130,7 +129,7 @@ function applyMessages(input, body) {
130
129
  if (thinkingOn)
131
130
  delete body.temperature;
132
131
  }
133
- else if (capabilityHeld(model, "reasoning") && level === "off" && compat.thinkingMode !== "adaptive") {
132
+ else if (level === "off" && offSpelling(model, input.api).spelled) {
134
133
  body.thinking = { type: "disabled" };
135
134
  }
136
135
  const betas = [];
@@ -134,26 +134,60 @@ export interface OffCapabilityModel {
134
134
  */
135
135
  export declare function declaredOffSpelling(model: OffCapabilityModel): string | undefined;
136
136
  /**
137
- * Whether the wire will CARRY a disable key for this model — off is SPELLED, never assumed. Per wire: the
138
- * anthropic budget form spells `{type:"disabled"}` (the ADAPTIVE form rejects it — those models think on
139
- * every request); deepseek `{type:"disabled"}`, the binary enable keys at `false`, openrouter/together
140
- * `reasoning:{enabled:false}` all spell it; the effort-only wires (stock openai completions, the Responses
141
- * lane) spell it only through a deployment-declared off spelling ({@link declaredOffSpelling}).
137
+ * The model-entry input a wire still needs before it can spell the explicit `"off"` tier — what an operator would add:
138
+ * `compat.thinkingFormat` (a completions model that names no dialect the engine can read: none declared on a model that does
139
+ * not hold reasoning, or a name outside the closed set), `thinkingLevelMap.off` (an effort-only wire — stock openai completions,
140
+ * the Responses lane — with no declared off value), or `none` (no declaration spells it: the anthropic adaptive form, an
141
+ * effort-only endpoint that takes no effort value, a Messages or Responses model that does not hold reasoning).
142
+ */
143
+ export type OffSpellingMissing = "compat.thinkingFormat" | "thinkingLevelMap.off" | "none";
144
+ /** {@link offSpelling}'s answer: the wire spells off, or it does not and this is the input it lacks. */
145
+ export type OffSpelling = {
146
+ readonly spelled: true;
147
+ } | {
148
+ readonly spelled: false;
149
+ readonly missing: OffSpellingMissing;
150
+ };
151
+ /**
152
+ * THE off-spelling table — whether the wire will CARRY a disable key for this model, and, when it will not, which declared input
153
+ * it lacks. Off is SPELLED, never assumed. Per wire:
154
+ *
155
+ * - Messages: the budget form spells `{type:"disabled"}` on a model that holds reasoning; the ADAPTIVE form rejects it (those
156
+ * models think on every request) — `none`. A Messages model that does not hold reasoning is sent nothing (`none`).
157
+ * - Responses: effort-only — spelled through a deployment-declared off value ({@link declaredOffSpelling}) on a model that holds
158
+ * reasoning, else `thinkingLevelMap.off` (or `none` where the endpoint takes no effort value at all). A Responses model that
159
+ * does not hold reasoning is sent nothing (`none`).
160
+ * - Chat completions: the dialect is the operator's EXPLICIT `compat.thinkingFormat`, whatever the model's `reasoning`
161
+ * declaration says — a declared dialect is how its disable key is spelled, and sending it never asks the model to think. With
162
+ * no format declared, a model that holds reasoning is on the default (`openai`) dialect, and one that does not is left to its
163
+ * provider's default: the engine does not guess a dialect for it (`compat.thinkingFormat`). A name outside the closed set
164
+ * ({@link completionsFormatOf}) is no dialect (`compat.thinkingFormat`). On the dialect: deepseek `{type:"disabled"}`, the
165
+ * binary enable keys at `false` and openrouter / together `reasoning:{enabled:false}` always spell it; stock openai is
166
+ * effort-only (`thinkingLevelMap.off`, or `none`).
142
167
  *
143
- * A model that does not hold reasoning (declared false, or undeclared — `capabilityHeld`) spells NOTHING: every applier returns before writing any key for it, so
144
- * the request is the gateway's own default — and a default-on gateway thinks regardless (three of four live
145
- * endpoints, 2026-09-15). This arm used to answer `true` ("a non-reasoning model never thinks"): the engine
146
- * may size a request by what it SENT, never by what it hopes a gateway does when told nothing. What this
147
- * table cannot see is a gateway that IGNORES the key it was sent — the classifier's re-ask on a no-verdict
148
- * reply is the seat that learns that from the reply.
168
+ * The reasoning declaration decides whether thinking can be turned ON (`reasoningRequestCarried`); it gates off only where the
169
+ * wire has no declared dialect to spell it in. The engine sizes a request by what it SENT, never by what it hopes a gateway does
170
+ * when told nothing — a default-on gateway thinks on a request that carries no key (three of four live endpoints, 2026-09-15).
171
+ * What this table cannot see is a gateway that IGNORES the key it was sent — the classifier's re-ask on a no-verdict reply is
172
+ * the seat that learns that from the reply.
173
+ *
174
+ * Read by {@link thinkingOffSpelled}, by every explicit-off arm of the wire applier (`applyReasoningToRequest`, in
175
+ * reasoning-request.ts), and by the classifier's defaulted-seat sentence, which names {@link OffSpellingMissing} — one table, so
176
+ * what the wire carries, what the capability answer claims and what the sentence asks an operator to declare cannot disagree.
177
+ *
178
+ * The wire family is the entry's own `api` unless the caller names it: the applier passes the request's family, which is what
179
+ * picks its lane, so a host whose model slice carries no `api` is judged on the family it asked for.
180
+ */
181
+ export declare function offSpelling(model: OffCapabilityModel, api?: string | undefined): OffSpelling;
182
+ /**
183
+ * Whether the wire will CARRY a disable key for this model — {@link offSpelling}'s `spelled`.
149
184
  *
150
185
  * THE answer to "can this model's thinking be turned off", for every reader: the engine's seats, and a host that serves a model
151
186
  * listing (the Claude Code catalog row calls it `supportsThinkingOff`; a host wraps this answer under that name, beside `reasoning`
152
187
  * — `reasoning: true` with this `false` is a model that cannot be turned off). It is DERIVED from the wire table — the API
153
188
  * family, `compat` and `thinkingLevelMap.off` of the entry, and its `reasoning` declaration — so the catalog row grows no key for
154
189
  * it, the way {@link reasoningEffortLevelsOf} derives the supported tiers: a second, declared copy could only disagree with the
155
- * wire. A completions model whose `compat.thinkingFormat` names no dialect ({@link completionsFormatOf}) carries no key on the
156
- * wire, so it answers `false`.
190
+ * wire.
157
191
  */
158
192
  export declare function thinkingOffSpelled(model: OffCapabilityModel): boolean;
159
193
  /**
@@ -45,18 +45,28 @@ export function declaredOffSpelling(model) {
45
45
  const mapped = model.thinkingLevelMap?.off;
46
46
  return typeof mapped === "string" && mapped !== "" ? mapped : undefined;
47
47
  }
48
- export function thinkingOffSpelled(model) {
49
- if (!capabilityHeld(model, "reasoning"))
50
- return false;
48
+ const OFF_SPELLED = Object.freeze({ spelled: true });
49
+ const offMissing = (missing) => Object.freeze({ spelled: false, missing });
50
+ function effortWireOff(model) {
51
+ if (declaredOffSpelling(model) !== undefined)
52
+ return OFF_SPELLED;
53
+ return (model.compat ?? {}).supportsReasoningEffort === false ? offMissing("none") : offMissing("thinkingLevelMap.off");
54
+ }
55
+ export function offSpelling(model, api = model.api) {
51
56
  const compat = (model.compat ?? {});
52
- if (model.api === "anthropic-messages")
53
- return compat.thinkingMode !== "adaptive";
54
- if (model.api !== undefined && RESPONSES_APIS.has(model.api))
55
- return declaredOffSpelling(model) !== undefined;
56
- const format = completionsFormatOf(compat);
57
+ const held = capabilityHeld(model, "reasoning");
58
+ if (api === "anthropic-messages")
59
+ return held && compat.thinkingMode !== "adaptive" ? OFF_SPELLED : offMissing("none");
60
+ if (api !== undefined && RESPONSES_APIS.has(api))
61
+ return held ? effortWireOff(model) : offMissing("none");
62
+ const declaredFormat = (compat.thinkingFormat ?? undefined) !== undefined;
63
+ const format = declaredFormat || held ? completionsFormatOf(compat) : undefined;
57
64
  if (format === undefined)
58
- return false;
59
- return COMPLETIONS_OFF_SPELLING[format] === "declared" ? declaredOffSpelling(model) !== undefined : true;
65
+ return offMissing("compat.thinkingFormat");
66
+ return COMPLETIONS_OFF_SPELLING[format] === "declared" ? effortWireOff(model) : OFF_SPELLED;
67
+ }
68
+ export function thinkingOffSpelled(model) {
69
+ return offSpelling(model).spelled;
60
70
  }
61
71
  export function declaredEffortLevels(v) {
62
72
  return Array.isArray(v) && v.length > 0 ? v : undefined;
@@ -32,6 +32,10 @@
32
32
  * root — an entry carrying its own `baseUrl` — is the torn pair this module exists to stop
33
33
  * (`route.credential_mismatch`), whether or not the deployment wrote its root down. A key on the
34
34
  * config with the URL only on the model is that torn pair: nothing says the key belongs there.
35
+ * - either source, before the credential's root is compared → a request that carries a credential to a root it would reach in
36
+ * the clear across a network — not https, and not plain http to this machine (`crossesNetworkInClear`, the question the
37
+ * protocol chains ask) — is refused (`config.protocol_plaintext_credentials`, the protocol chains' own code), wherever its
38
+ * credential is paired; only loopback is exempt (RFC 1918 and cluster addresses are not).
35
39
  * - `absent` → OK for keyless deployments (nothing to protect); refused as
36
40
  * `route.credential_missing` only where an entry declares its OWN URL away from a DECLARED
37
41
  * deployment root — a distinct endpoint with no credential route is a configuration hole, and a
@@ -207,7 +211,9 @@ export declare const KEYLESS_EXIT = "hand it none \u2014 answer an empty apiKey
207
211
  * nothing, so a pre-flight, the read face ({@link routePairingStatus}) and any consumer may call it freely — same
208
212
  * inputs and same table, same verdict. A per-model credential {@link resolveRouteCredential} resolved with a key beside
209
213
  * its own header is refused first (`route.credential_answer_conflict`, both header names in the fix — wherever the
210
- * request goes, since the request itself is contradictory); otherwise it is judged against the origin it is bound to
214
+ * request goes, since the request itself is contradictory). Then, for a credential of either source, over what
215
+ * ({@link plaintextRefusal}: a credential is never sent across a network in the clear); then to whom: a per-model
216
+ * credential is judged against the origin it is bound to
211
217
  * (refused when that is another one); one not bound yet, or built by hand (no resolution facts — the published corpus
212
218
  * is such input), is servable. Every refusal is a verdict: the law throws on garbage alone. The table is written by a first-party brain's request gate ({@link admitRouteRequest}), when the engine commits the request to be sent, and by the
213
219
  * host's explicit rebind ({@link rebindCredentialOrigin}) — never by a judgment. The verdict reports nothing either: the
@@ -350,7 +356,7 @@ export declare function createBrainRouteJudge(config: {
350
356
  * `judge` is a brain's optional `adjudicateRoute` face; absent ⇒ `"unknown"` (a custom brain core
351
357
  * cannot see into — never guessed at).
352
358
  */
353
- export type RoutePairingStatus = `ok:${RoutePairingPosture}` | `broken:${"credential_mismatch" | "credential_missing" | "credential_origin_mismatch" | "credential_answer_conflict"}` | "unknown";
359
+ export type RoutePairingStatus = `ok:${RoutePairingPosture}` | `broken:${"credential_mismatch" | "credential_missing" | "credential_origin_mismatch" | "credential_answer_conflict" | "protocol_plaintext_credentials"}` | "unknown";
354
360
  export declare function routePairingStatus(brain: {
355
361
  adjudicateRoute?: (model: Model, perModelAuth?: {
356
362
  apiKey?: string;
@@ -1,3 +1,4 @@
1
+ import { describeRejectedValue } from "../core/tool-search-setting.js";
1
2
  import { createHash } from "node:crypto";
2
3
  import { BrainError } from "./errors.js";
3
4
  import { reportCredentialOriginRefusal } from "./status-sink.js";
@@ -7,6 +8,7 @@ import { deliverEngineNotice } from "../core/engine-notice.js";
7
8
  import { uuidv7 } from "../engine/session/uuid.js";
8
9
  import { REDACTION_MARKS, WITHHELD_VALUE_MARK } from "../core/redaction-marks.js";
9
10
  import { CREDENTIAL_VOCABULARY } from "@sema-agent/primitives";
11
+ import { PROTOCOL_PLAINTEXT_CREDENTIALS_CODE, crossesNetworkInClear } from "../core/protocol-http-auth.js";
10
12
  const REDACTED_VALUE = WITHHELD_VALUE_MARK;
11
13
  const REDACTED_CREDENTIALS = REDACTION_MARKS.credentials;
12
14
  function servableParse(raw) {
@@ -160,7 +162,7 @@ function judgeRequestRoot(url, seat) {
160
162
  }
161
163
  export function joinRequestUrl(root, suffix) {
162
164
  if (typeof suffix !== "string" || /[?#]/.test(suffix)) {
163
- throw new TypeError(`request URL: the endpoint suffix must be a path (got ${typeof suffix === "string" ? JSON.stringify(suffix) : typeof suffix}) — ` +
165
+ throw new TypeError(`request URL: the endpoint suffix must be a path (got ${describeRejectedValue(suffix)}) — ` +
164
166
  `a request's query belongs to its ROOT, which declares it once for every request`);
165
167
  }
166
168
  const judged = judgeRequestRoot(root, "the request root");
@@ -312,11 +314,36 @@ export function resolveRouteCredential(input) {
312
314
  return { source: "absent" };
313
315
  }
314
316
  export const KEYLESS_EXIT = "hand it none — answer an empty apiKey and no credential header (this works under any brain; a brain configured with neither a baseUrl nor a credential of its own also accepts no apiKey at all), because a placeholder word handed in its place is still a credential and binds like any other";
317
+ function plaintextRefusal(model, credential, request, shown) {
318
+ if (credential.apiKey === undefined && credential.headersBorne !== true)
319
+ return undefined;
320
+ const parsed = request === "" ? undefined : servableParse(request);
321
+ if (parsed === undefined || !crossesNetworkInClear(parsed))
322
+ return undefined;
323
+ const carried = credential.apiKey !== undefined ? "its key" : "its credential header";
324
+ const without = credential.source === "deployment-config"
325
+ ? "construct the brain with no apiKey and no credential header"
326
+ : KEYLESS_EXIT;
327
+ return {
328
+ ok: false,
329
+ code: PROTOCOL_PLAINTEXT_CREDENTIALS_CODE,
330
+ detail: {
331
+ modelId: model.id,
332
+ entryBaseUrl: shown.entry,
333
+ requestBaseUrl: shown.request,
334
+ configBaseUrl: shown.declared,
335
+ fixHint: `model "${model.id}" targets ${shown.request}, which is not https and not this machine — the request would carry ${carried} ` +
336
+ `across a network in the clear: declare the root as an https url, or serve the endpoint on this machine (localhost, ` +
337
+ `127.0.0.0/8, ::1); if the endpoint takes no credential, ${without}`,
338
+ },
339
+ };
340
+ }
315
341
  export function adjudicateModelRoute(model, credential, config) {
316
342
  const { entry, declared, deploymentRoot, request } = routeHalves(model, config);
317
343
  const entryShown = displayUrlOf(entry);
318
344
  const declaredShown = displayUrlOf(declared);
319
345
  const requestShown = displayUrlOf(request);
346
+ const shown = { entry: entryShown, request: requestShown, declared: declaredShown };
320
347
  if (credential.source === "per-model") {
321
348
  const facts = resolvedCredentialFacts.get(credential);
322
349
  const conflict = facts?.keyHeaderConflict;
@@ -334,6 +361,9 @@ export function adjudicateModelRoute(model, credential, config) {
334
361
  },
335
362
  };
336
363
  }
364
+ const plaintext = plaintextRefusal(model, credential, request, shown);
365
+ if (plaintext !== undefined)
366
+ return plaintext;
337
367
  const identities = facts?.identities;
338
368
  const requestOrigin = routeOriginOf(request);
339
369
  if (identities === undefined || requestOrigin === "")
@@ -364,6 +394,9 @@ export function adjudicateModelRoute(model, credential, config) {
364
394
  };
365
395
  }
366
396
  if (credential.source === "deployment-config") {
397
+ const plaintext = plaintextRefusal(model, credential, request, shown);
398
+ if (plaintext !== undefined)
399
+ return plaintext;
367
400
  if (request !== "" && request === deploymentRoot)
368
401
  return { ok: true, posture: "paired" };
369
402
  const pairedWith = declared !== ""
@@ -526,6 +559,7 @@ const BROKEN_PAIRING_STATUS = {
526
559
  "route.credential_missing": "broken:credential_missing",
527
560
  "route.credential_origin_mismatch": "broken:credential_origin_mismatch",
528
561
  "route.credential_answer_conflict": "broken:credential_answer_conflict",
562
+ "config.protocol_plaintext_credentials": "broken:protocol_plaintext_credentials",
529
563
  };
530
564
  export function routePairingStatus(brain, model, perModelAuth) {
531
565
  const verdict = brain.adjudicateRoute?.(model, perModelAuth);
@@ -160,4 +160,21 @@ export const ROUTE_ADJUDICATION_CONFORMANCE_CORPUS = [
160
160
  expect: { ok: false, code: "route.credential_missing" },
161
161
  leg: "derived",
162
162
  },
163
+ {
164
+ name: "plaintext-credential-off-machine",
165
+ intent: "a credential (here the deployment key, on its own paired root) to a plain-http root off this machine is refused: it would cross the network in the clear — a private-range address is not exempt",
166
+ model: { id: "m-lan", baseUrl: "" },
167
+ credential: { source: "deployment-config", apiKey: "k-lan" },
168
+ config: { baseUrl: "http://10.0.0.5:8150/v1" },
169
+ expect: { ok: false, code: "config.protocol_plaintext_credentials" },
170
+ leg: "named",
171
+ },
172
+ {
173
+ name: "plaintext-credential-loopback",
174
+ intent: "the same credential over plain http to this machine is servable: loopback is the one plain-http root a credential may ride to",
175
+ model: { id: "m-local", baseUrl: "http://127.0.0.1:8000/v1" },
176
+ credential: { source: "per-model", apiKey: "k-local" },
177
+ config: {},
178
+ expect: { ok: true, posture: "per-model" },
179
+ },
163
180
  ];
@@ -10,6 +10,8 @@ type RouteWords = {
10
10
  readonly provider?: string | undefined;
11
11
  readonly api?: string | undefined;
12
12
  };
13
+ /** Whether a value is a brain — an object with a `stream` function, the one face the Brain contract requires. A mounted route whose value is not one fails its request loudly, never by a throw; a seat handed to a factory that is not one is refused where the factory is built. */
14
+ export declare function isBrain(value: unknown): value is Brain;
13
15
  /**
14
16
  * THE judge of which line serves a model: the model's route word (`provider`, or `api` when `by` says so) IF the route table
15
17
  * has an OWN route under that word, else `undefined` — the fallback (the deployment's gateway) serves it. A word the model