@sema-agent/core 7.67.3 → 7.68.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 (496) hide show
  1. package/CHANGELOG.md +1516 -0
  2. package/README.md +18 -9
  3. package/README.zh-CN.md +16 -8
  4. package/dist/agents/agent-definition.d.ts +1 -1
  5. package/dist/agents/agent-definition.js +4 -1
  6. package/dist/agents/cascade.d.ts +2 -2
  7. package/dist/agents/cascade.js +3 -1
  8. package/dist/agents/cumulative-stats.d.ts +2 -1
  9. package/dist/agents/cumulative-stats.js +4 -1
  10. package/dist/agents/list-agents-tool.d.ts +30 -0
  11. package/dist/agents/list-agents-tool.js +45 -3
  12. package/dist/agents/peer-admission.d.ts +2 -2
  13. package/dist/agents/peer-session-drain.d.ts +2 -0
  14. package/dist/agents/peer-session-drain.js +1 -0
  15. package/dist/agents/repair-loop.js +3 -1
  16. package/dist/agents/retain-ledger.d.ts +61 -8
  17. package/dist/agents/retain-ledger.js +25 -3
  18. package/dist/agents/roster-store.d.ts +4 -2
  19. package/dist/agents/send-message-tool.d.ts +1 -1
  20. package/dist/agents/send-message-tool.js +20 -15
  21. package/dist/agents/subagent-steps.js +2 -10
  22. package/dist/agents/subagent.d.ts +3 -0
  23. package/dist/agents/subagent.js +106 -76
  24. package/dist/agents/tool-filter.d.ts +20 -11
  25. package/dist/agents/tool-filter.js +8 -4
  26. package/dist/agents/verify.d.ts +3 -1
  27. package/dist/agents/verify.js +2 -0
  28. package/dist/brain/anthropic.js +4 -4
  29. package/dist/brain/open-responses.js +3 -1
  30. package/dist/brain/openai.js +3 -1
  31. package/dist/brain/reasoning-request.d.ts +73 -19
  32. package/dist/brain/reasoning-request.js +164 -72
  33. package/dist/brain/reasoning-stamp.d.ts +26 -0
  34. package/dist/brain/reasoning-stamp.js +10 -0
  35. package/dist/brain/reasoning.d.ts +95 -162
  36. package/dist/brain/reasoning.js +31 -86
  37. package/dist/brain/route-adjudicator.d.ts +9 -7
  38. package/dist/brain/route-adjudicator.js +12 -10
  39. package/dist/brain/status-sink.d.ts +19 -64
  40. package/dist/brain/status-sink.js +5 -21
  41. package/dist/brain/stream-engine.d.ts +11 -2
  42. package/dist/brain/stream-engine.js +10 -0
  43. package/dist/core/a2a.d.ts +17 -5
  44. package/dist/core/a2a.js +11 -3
  45. package/dist/core/allow-entry.d.ts +35 -15
  46. package/dist/core/allow-entry.js +47 -60
  47. package/dist/core/ask-headline.d.ts +68 -0
  48. package/dist/core/ask-headline.js +23 -0
  49. package/dist/core/ask-origin.d.ts +36 -8
  50. package/dist/core/ask-origin.js +17 -10
  51. package/dist/core/ask-question.d.ts +34 -7
  52. package/dist/core/ask-question.js +10 -1
  53. package/dist/core/ask-unresolvable-notice.d.ts +7 -0
  54. package/dist/core/ask-unresolvable-notice.js +9 -3
  55. package/dist/core/auto-strip.d.ts +53 -0
  56. package/dist/core/auto-strip.js +76 -0
  57. package/dist/core/background-agent-store.d.ts +45 -5
  58. package/dist/core/background-agent-store.js +69 -15
  59. package/dist/core/background-shell.d.ts +2 -2
  60. package/dist/core/caller-text.js +2 -2
  61. package/dist/core/canonical-json.d.ts +13 -0
  62. package/dist/core/canonical-json.js +7 -0
  63. package/dist/core/checkpoint-features.d.ts +66 -20
  64. package/dist/core/checkpoint-features.js +12 -1
  65. package/dist/core/checkpoint-generation.d.ts +1 -1
  66. package/dist/core/checkpoint-queries.d.ts +1 -1
  67. package/dist/core/checkpoint-queries.js +4 -1
  68. package/dist/core/checkpoint-requirements.d.ts +25 -1
  69. package/dist/core/checkpoint-requirements.js +5 -1
  70. package/dist/core/checkpoint-row-verdict.d.ts +1 -0
  71. package/dist/core/checkpoint-row-verdict.js +4 -0
  72. package/dist/core/checkpoint-store.d.ts +66 -38
  73. package/dist/core/checkpoint-store.js +15 -6
  74. package/dist/core/child-clamp-seats.d.ts +6 -0
  75. package/dist/core/child-clamp-seats.js +1 -0
  76. package/dist/core/config-refusal-codes.d.ts +1 -1
  77. package/dist/core/config-refusal-codes.js +1 -0
  78. package/dist/core/delegation-frames.d.ts +9 -12
  79. package/dist/core/delegation-frames.js +9 -8
  80. package/dist/core/engine-capabilities.d.ts +21 -8
  81. package/dist/core/engine-capabilities.js +1 -1
  82. package/dist/core/engine-notice.d.ts +147 -34
  83. package/dist/core/engine-notice.js +27 -16
  84. package/dist/core/engine-storage-backend.d.ts +2 -1
  85. package/dist/core/env-budget.js +3 -3
  86. package/dist/core/env-knob-announce.d.ts +10 -10
  87. package/dist/core/env-knob-announce.js +3 -6
  88. package/dist/core/file-history-store.d.ts +29 -4
  89. package/dist/core/file-history-store.js +13 -0
  90. package/dist/core/frame-settlement.d.ts +2 -1
  91. package/dist/core/gate-fold.js +1 -1
  92. package/dist/core/gate-lanes.js +56 -49
  93. package/dist/core/governance-codes.d.ts +39 -3
  94. package/dist/core/governance-codes.js +61 -3
  95. package/dist/core/hooks.d.ts +29 -11
  96. package/dist/core/hooks.js +5 -2
  97. package/dist/core/human-input-projection.js +3 -3
  98. package/dist/core/input-author.d.ts +17 -3
  99. package/dist/core/input-author.js +15 -3
  100. package/dist/core/leg-identity.d.ts +10 -28
  101. package/dist/core/leg-identity.js +1 -21
  102. package/dist/core/lsp.d.ts +18 -13
  103. package/dist/core/lsp.js +30 -22
  104. package/dist/core/mailbox-store.d.ts +1 -1
  105. package/dist/core/mailbox-store.js +4 -4
  106. package/dist/core/mcp-connection-pool.d.ts +93 -4
  107. package/dist/core/mcp-connection-pool.js +104 -1
  108. package/dist/core/mcp-failure.d.ts +38 -12
  109. package/dist/core/mcp-failure.js +9 -13
  110. package/dist/core/mcp-probe.d.ts +4 -3
  111. package/dist/core/mcp-server-link.d.ts +4 -2
  112. package/dist/core/mcp-server-link.js +4 -5
  113. package/dist/core/mcp-server-spec.d.ts +3 -3
  114. package/dist/core/mcp-server-unavailable-notice.d.ts +22 -8
  115. package/dist/core/mcp-server-unavailable-notice.js +18 -4
  116. package/dist/core/mcp.d.ts +40 -6
  117. package/dist/core/mcp.js +39 -13
  118. package/dist/core/memory-engine/content-origin.js +2 -2
  119. package/dist/core/memory-engine/control-objects.d.ts +2 -4
  120. package/dist/core/memory-engine/control-objects.js +2 -10
  121. package/dist/core/memory-engine/delegation-settlement.js +6 -1
  122. package/dist/core/memory-engine/dual-root.js +3 -0
  123. package/dist/core/memory-engine/engine.d.ts +6 -4
  124. package/dist/core/memory-engine/engine.js +32 -29
  125. package/dist/core/memory-engine/file-backend.d.ts +20 -5
  126. package/dist/core/memory-engine/file-backend.js +21 -31
  127. package/dist/core/memory-engine/frontmatter.d.ts +2 -0
  128. package/dist/core/memory-engine/frontmatter.js +4 -0
  129. package/dist/core/memory-engine/layout.d.ts +114 -20
  130. package/dist/core/memory-engine/layout.js +340 -22
  131. package/dist/core/memory-engine/memory-deployment.d.ts +7 -5
  132. package/dist/core/memory-engine/mount-failed-notice.d.ts +19 -7
  133. package/dist/core/memory-engine/mount-failed-notice.js +43 -10
  134. package/dist/core/memory-engine/sync-client.js +4 -5
  135. package/dist/core/model-fallbacks.d.ts +5 -1
  136. package/dist/core/model-fallbacks.js +3 -3
  137. package/dist/core/model-receipt.d.ts +2 -1
  138. package/dist/core/model-receipt.js +12 -1
  139. package/dist/core/mods/kernel/dispatch.d.ts +2 -2
  140. package/dist/core/mods/kernel/dispatch.js +14 -6
  141. package/dist/core/mods/kernel/events.d.ts +8 -5
  142. package/dist/core/mods/kernel/events.js +2 -2
  143. package/dist/core/mods/kernel/index.d.ts +1 -1
  144. package/dist/core/mods/kernel/registration.d.ts +9 -0
  145. package/dist/core/mods/package.js +1 -1
  146. package/dist/core/mods/session-append.d.ts +4 -2
  147. package/dist/core/mods/session-append.js +3 -0
  148. package/dist/core/mods/stations.d.ts +7 -11
  149. package/dist/core/mods/stations.js +4 -7
  150. package/dist/core/mods/tool-call.d.ts +10 -8
  151. package/dist/core/mods/tool-call.js +15 -18
  152. package/dist/core/mounted-mcp.d.ts +0 -4
  153. package/dist/core/mounted-mcp.js +1 -1
  154. package/dist/core/park-noun.d.ts +24 -0
  155. package/dist/core/park-noun.js +21 -0
  156. package/dist/core/park-resumability.d.ts +60 -0
  157. package/dist/core/park-resumability.js +30 -0
  158. package/dist/core/permission-rule-provider.d.ts +24 -2
  159. package/dist/core/permission-rule-provider.js +11 -8
  160. package/dist/core/permission-rule-store.d.ts +8 -1
  161. package/dist/core/permission-rule-store.js +2 -3
  162. package/dist/core/permission-rules.d.ts +2 -1
  163. package/dist/core/permission-rules.js +8 -4
  164. package/dist/core/persisted-rule-arms.d.ts +3 -0
  165. package/dist/core/persisted-rule-arms.js +2 -1
  166. package/dist/core/present-plan-tool.d.ts +47 -3
  167. package/dist/core/present-plan-tool.js +62 -4
  168. package/dist/core/principal-name.d.ts +1 -1
  169. package/dist/core/principal-name.js +5 -5
  170. package/dist/core/process-identity.js +10 -5
  171. package/dist/core/protocol-http-auth.d.ts +20 -14
  172. package/dist/core/protocol-http-auth.js +70 -50
  173. package/dist/core/read-only-shell.js +9 -5
  174. package/dist/core/redaction-marks.d.ts +4 -26
  175. package/dist/core/redaction-marks.js +9 -21
  176. package/dist/core/remote-env.d.ts +43 -16
  177. package/dist/core/remote-env.js +1 -1
  178. package/dist/core/request-copy-projection.d.ts +1 -1
  179. package/dist/core/request-copy-projection.js +40 -50
  180. package/dist/core/resume-config-judge.js +1 -1
  181. package/dist/core/resume-startup-cause.d.ts +35 -18
  182. package/dist/core/resume-startup-cause.js +13 -10
  183. package/dist/core/retention.d.ts +167 -25
  184. package/dist/core/retention.js +100 -20
  185. package/dist/core/roles.d.ts +6 -0
  186. package/dist/core/roles.js +11 -5
  187. package/dist/core/rule-lane-reads.d.ts +3 -0
  188. package/dist/core/rule-lane-reads.js +5 -1
  189. package/dist/core/rule-store-fault.d.ts +70 -0
  190. package/dist/core/rule-store-fault.js +102 -0
  191. package/dist/core/runner/advertised-writable-dirs.js +16 -31
  192. package/dist/core/runner/announce-once-ledger.d.ts +19 -2
  193. package/dist/core/runner/announce-once-ledger.js +24 -2
  194. package/dist/core/runner/assemble-result.d.ts +6 -0
  195. package/dist/core/runner/assemble-result.js +1 -1
  196. package/dist/core/runner/auto-strip-notice.d.ts +36 -0
  197. package/dist/core/runner/auto-strip-notice.js +59 -0
  198. package/dist/core/runner/branch-window.d.ts +3 -0
  199. package/dist/core/runner/branch-window.js +37 -0
  200. package/dist/core/runner/caller-roster.d.ts +8 -3
  201. package/dist/core/runner/capability-withheld-seat.js +3 -9
  202. package/dist/core/runner/clock-and-limits.d.ts +22 -1
  203. package/dist/core/runner/clock-and-limits.js +30 -0
  204. package/dist/core/runner/contracts.d.ts +58 -35
  205. package/dist/core/runner/credential-refusal-seat.d.ts +2 -0
  206. package/dist/core/runner/credential-refusal-seat.js +47 -0
  207. package/dist/core/runner/cross-boundary-lane.js +6 -4
  208. package/dist/core/runner/decide-continuation.js +1 -1
  209. package/dist/core/runner/file-history-restore.d.ts +53 -2
  210. package/dist/core/runner/file-history-restore.js +29 -10
  211. package/dist/core/runner/forward-sink.d.ts +14 -1
  212. package/dist/core/runner/forward-sink.js +14 -12
  213. package/dist/core/runner/gate-exit.d.ts +8 -7
  214. package/dist/core/runner/gate-exit.js +13 -13
  215. package/dist/core/runner/git-status-frame.js +2 -4
  216. package/dist/core/runner/initial-run-state.js +1 -1
  217. package/dist/core/runner/main-call-account.d.ts +3 -1
  218. package/dist/core/runner/main-call-account.js +5 -3
  219. package/dist/core/runner/mcp-redial.d.ts +2 -5
  220. package/dist/core/runner/mcp-redial.js +2 -2
  221. package/dist/core/runner/nested-memory-content.d.ts +7 -1
  222. package/dist/core/runner/nested-memory-content.js +73 -13
  223. package/dist/core/runner/nested-memory-lane.d.ts +44 -19
  224. package/dist/core/runner/nested-memory-lane.js +152 -76
  225. package/dist/core/runner/park-commit.js +3 -1
  226. package/dist/core/runner/permission-rule-lanes.d.ts +8 -2
  227. package/dist/core/runner/permission-rule-lanes.js +29 -3
  228. package/dist/core/runner/person-path-rows.d.ts +3 -11
  229. package/dist/core/runner/person-path-rows.js +21 -24
  230. package/dist/core/runner/prepare-acquire-reconcile.js +3 -1
  231. package/dist/core/runner/prepare-artifact.d.ts +1 -1
  232. package/dist/core/runner/prepare-artifact.js +20 -14
  233. package/dist/core/runner/prepare-ask-lane.d.ts +9 -6
  234. package/dist/core/runner/prepare-ask-lane.js +6 -5
  235. package/dist/core/runner/prepare-boundary-parks.d.ts +7 -1
  236. package/dist/core/runner/prepare-boundary-parks.js +27 -24
  237. package/dist/core/runner/prepare-caps-and-workflow.d.ts +5 -2
  238. package/dist/core/runner/prepare-caps-and-workflow.js +4 -3
  239. package/dist/core/runner/prepare-config-doors.d.ts +9 -24
  240. package/dist/core/runner/prepare-config-doors.js +58 -41
  241. package/dist/core/runner/prepare-context-lane.d.ts +2 -2
  242. package/dist/core/runner/prepare-context-lane.js +3 -5
  243. package/dist/core/runner/prepare-defer-classify.d.ts +1 -1
  244. package/dist/core/runner/prepare-defer-classify.js +1 -1
  245. package/dist/core/runner/prepare-delegation-surface.d.ts +2 -2
  246. package/dist/core/runner/prepare-delegation-surface.js +3 -2
  247. package/dist/core/runner/prepare-file-history.d.ts +62 -26
  248. package/dist/core/runner/prepare-file-history.js +117 -46
  249. package/dist/core/runner/prepare-gate-stations.d.ts +4 -0
  250. package/dist/core/runner/prepare-gate-stations.js +6 -5
  251. package/dist/core/runner/prepare-hands-readface.d.ts +9 -4
  252. package/dist/core/runner/prepare-hands-readface.js +8 -4
  253. package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
  254. package/dist/core/runner/prepare-inherited-gate.js +6 -6
  255. package/dist/core/runner/prepare-listings.d.ts +1 -1
  256. package/dist/core/runner/prepare-listings.js +1 -1
  257. package/dist/core/runner/prepare-memory.js +2 -2
  258. package/dist/core/runner/prepare-offload-wrappers.d.ts +1 -1
  259. package/dist/core/runner/prepare-offload-wrappers.js +1 -1
  260. package/dist/core/runner/prepare-park-ask.d.ts +10 -3
  261. package/dist/core/runner/prepare-park-ask.js +7 -9
  262. package/dist/core/runner/prepare-policy-chain.d.ts +18 -9
  263. package/dist/core/runner/prepare-policy-chain.js +18 -13
  264. package/dist/core/runner/prepare-project-context.d.ts +1 -1
  265. package/dist/core/runner/prepare-project-context.js +5 -3
  266. package/dist/core/runner/prepare-prompt-assembly.js +2 -1
  267. package/dist/core/runner/prepare-prompt-inputs.d.ts +2 -2
  268. package/dist/core/runner/prepare-prompt-inputs.js +1 -1
  269. package/dist/core/runner/prepare-protocol-tools.d.ts +4 -5
  270. package/dist/core/runner/prepare-protocol-tools.js +7 -7
  271. package/dist/core/runner/prepare-question-face.d.ts +4 -2
  272. package/dist/core/runner/prepare-run-refs.d.ts +7 -2
  273. package/dist/core/runner/prepare-run-refs.js +8 -7
  274. package/dist/core/runner/prepare-safety-scan.d.ts +4 -3
  275. package/dist/core/runner/prepare-suspend-saga.d.ts +3 -7
  276. package/dist/core/runner/prepare-suspend-saga.js +4 -3
  277. package/dist/core/runner/prepare-task.js +66 -53
  278. package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +3 -2
  279. package/dist/core/runner/prepare-tool-disclosure-mount.js +2 -1
  280. package/dist/core/runner/prepare-turn-wiring.d.ts +3 -1
  281. package/dist/core/runner/prepare-turn-wiring.js +1 -1
  282. package/dist/core/runner/prepare-wiring-manifest.d.ts +9 -4
  283. package/dist/core/runner/prepare-wiring-manifest.js +14 -6
  284. package/dist/core/runner/prepare-workspace-restore.d.ts +4 -4
  285. package/dist/core/runner/prepare-workspace-restore.js +15 -6
  286. package/dist/core/runner/remote-env-retry.d.ts +3 -3
  287. package/dist/core/runner/restore-seat.d.ts +41 -0
  288. package/dist/core/runner/restore-seat.js +38 -0
  289. package/dist/core/runner/resume-admission.js +1 -1
  290. package/dist/core/runner/resume-apply.js +4 -3
  291. package/dist/core/runner/resume-checkpoint-screen.js +2 -1
  292. package/dist/core/runner/resume-internals-and-config.js +2 -1
  293. package/dist/core/runner/resume-preflight.js +2 -1
  294. package/dist/core/runner/rewind-files.js +22 -6
  295. package/dist/core/runner/rule-store-unreadable-notice.d.ts +8 -0
  296. package/dist/core/runner/rule-store-unreadable-notice.js +11 -0
  297. package/dist/core/runner/run-brain-sinks.d.ts +3 -6
  298. package/dist/core/runner/run-brain-sinks.js +6 -6
  299. package/dist/core/runner/run-compaction-machinery.d.ts +2 -2
  300. package/dist/core/runner/run-git-lane.d.ts +2 -0
  301. package/dist/core/runner/run-git-lane.js +2 -1
  302. package/dist/core/runner/run-harness-handlers.js +5 -4
  303. package/dist/core/runner/run-identity-wiring.js +20 -12
  304. package/dist/core/runner/run-leg.js +31 -72
  305. package/dist/core/runner/run-notification-lane.d.ts +3 -0
  306. package/dist/core/runner/run-notification-lane.js +2 -4
  307. package/dist/core/runner/run-reasoning-seat.d.ts +5 -6
  308. package/dist/core/runner/run-reasoning-seat.js +13 -18
  309. package/dist/core/runner/run-settle-and-teardown.js +13 -9
  310. package/dist/core/runner/run-terminal-adoption.js +4 -8
  311. package/dist/core/runner/run-turn-boundary.js +6 -3
  312. package/dist/core/runner/runtask.d.ts +9 -4
  313. package/dist/core/runner/runtask.js +29 -22
  314. package/dist/core/runner/session-rule-policy.d.ts +11 -1
  315. package/dist/core/runner/shell-env-withheld.js +2 -7
  316. package/dist/core/runner/side-call-account.d.ts +5 -6
  317. package/dist/core/runner/side-call-account.js +2 -2
  318. package/dist/core/runner/stream-lifecycle-verbs.d.ts +3 -0
  319. package/dist/core/runner/stream-lifecycle-verbs.js +5 -3
  320. package/dist/core/runner/stream-settle-backstop.js +4 -6
  321. package/dist/core/runner/stream-steer-verb.d.ts +1 -1
  322. package/dist/core/runner/stream-steer-verb.js +4 -4
  323. package/dist/core/runner/sub-agent-deny-lists.d.ts +8 -3
  324. package/dist/core/runner/sub-agent-deny-lists.js +7 -4
  325. package/dist/core/runner/teardown-bounded.d.ts +7 -0
  326. package/dist/core/runner/teardown-bounded.js +7 -0
  327. package/dist/core/runner/terminal-account.js +41 -13
  328. package/dist/core/runner/terminal-projection.d.ts +1 -5
  329. package/dist/core/runner/tool-end-body.d.ts +9 -3
  330. package/dist/core/runner/tool-end-body.js +6 -3
  331. package/dist/core/runner/tool-output-projection.d.ts +13 -4
  332. package/dist/core/runner/tool-output-projection.js +10 -14
  333. package/dist/core/runner/turn-attachments.d.ts +3 -2
  334. package/dist/core/runner/turn-attachments.js +12 -5
  335. package/dist/core/runner-deps.d.ts +6 -6
  336. package/dist/core/runtime-caps.d.ts +2 -1
  337. package/dist/core/secret-env.d.ts +20 -3
  338. package/dist/core/secret-env.js +13 -15
  339. package/dist/core/session-checkout.d.ts +115 -15
  340. package/dist/core/session-checkout.js +435 -136
  341. package/dist/core/session-policy-store.js +21 -3
  342. package/dist/core/session-reconcile.js +1 -0
  343. package/dist/core/session-store.js +2 -0
  344. package/dist/core/session.d.ts +11 -1
  345. package/dist/core/shell-run-candidates.d.ts +1 -0
  346. package/dist/core/shell-run-candidates.js +1 -1
  347. package/dist/core/shutdown-debug.d.ts +6 -5
  348. package/dist/core/shutdown-debug.js +5 -1
  349. package/dist/core/skill-grant.js +4 -1
  350. package/dist/core/skills-directory.js +5 -3
  351. package/dist/core/spec-contract.d.ts +1 -1
  352. package/dist/core/store-contracts/checkpoint-store-contract.js +2 -7
  353. package/dist/core/store-contracts/file-history-store-contract.js +26 -2
  354. package/dist/core/store-contracts/session-deletion-cascade-contract.js +130 -14
  355. package/dist/core/store-contracts/task-list-store-contract.d.ts +2 -1
  356. package/dist/core/store-contracts/task-list-store-contract.js +28 -1
  357. package/dist/core/task-event.d.ts +48 -27
  358. package/dist/core/task-notification.d.ts +15 -9
  359. package/dist/core/task-notification.js +12 -0
  360. package/dist/core/task-registry-agent.d.ts +24 -22
  361. package/dist/core/task-registry-agent.js +65 -46
  362. package/dist/core/task-registry-shared.d.ts +17 -5
  363. package/dist/core/task-registry.d.ts +17 -6
  364. package/dist/core/task-registry.js +6 -1
  365. package/dist/core/task-result.d.ts +71 -25
  366. package/dist/core/task-spec-members.d.ts +0 -1
  367. package/dist/core/task-spec-members.js +1 -1
  368. package/dist/core/task-spec.d.ts +60 -52
  369. package/dist/core/task-stream.d.ts +45 -12
  370. package/dist/core/terminal-cause.d.ts +45 -8
  371. package/dist/core/terminal-cause.js +5 -0
  372. package/dist/core/tool-card-bound.d.ts +32 -0
  373. package/dist/core/tool-card-bound.js +33 -0
  374. package/dist/core/tool-catalog-entries.d.ts +9 -0
  375. package/dist/core/tool-catalog-entries.js +48 -0
  376. package/dist/core/tool-errors.d.ts +4 -3
  377. package/dist/core/tool-face.d.ts +3 -3
  378. package/dist/core/tool-mount-facts.d.ts +3 -2
  379. package/dist/core/tool-mount-facts.js +1 -1
  380. package/dist/core/tool-mount-static.js +7 -5
  381. package/dist/core/tool-policy.d.ts +21 -19
  382. package/dist/core/tool-policy.js +5 -6
  383. package/dist/core/tool-registry.d.ts +3 -1
  384. package/dist/core/tool-registry.js +15 -1
  385. package/dist/core/tool-result-store.d.ts +9 -3
  386. package/dist/core/tool-result-store.js +14 -1
  387. package/dist/core/tool-roster.d.ts +6 -0
  388. package/dist/core/tool-roster.js +18 -0
  389. package/dist/core/tool-spec.d.ts +17 -8
  390. package/dist/core/trace.d.ts +35 -31
  391. package/dist/core/types.d.ts +2 -2
  392. package/dist/core/untrusted-egress.d.ts +10 -9
  393. package/dist/core/untrusted-egress.js +9 -9
  394. package/dist/core/untrusted-text.d.ts +0 -18
  395. package/dist/core/untrusted-text.js +7 -3
  396. package/dist/core/user-attachment.d.ts +9 -6
  397. package/dist/core/user-attachment.js +12 -10
  398. package/dist/core/user-row-origin.d.ts +44 -25
  399. package/dist/core/user-row-origin.js +30 -20
  400. package/dist/core/wiring-manifest.d.ts +26 -7
  401. package/dist/core/wiring-manifest.js +14 -11
  402. package/dist/core/workspace-snapshot.d.ts +3 -1
  403. package/dist/core/workspace-snapshot.js +1 -0
  404. package/dist/engine/execution-env/node-execution-env.d.ts +23 -16
  405. package/dist/engine/execution-env/node-execution-env.js +127 -67
  406. package/dist/engine/harness/agent-harness.d.ts +4 -5
  407. package/dist/engine/harness/agent-harness.js +2 -7
  408. package/dist/engine/harness/types.d.ts +51 -19
  409. package/dist/engine/harness/types.js +28 -1
  410. package/dist/engine/llm/types.d.ts +26 -14
  411. package/dist/engine/llm/types.js +2 -2
  412. package/dist/engine/loop/agent-loop.d.ts +2 -2
  413. package/dist/engine/loop/agent-loop.js +51 -275
  414. package/dist/engine/loop/types.d.ts +0 -18
  415. package/dist/engine/session/import-validate.d.ts +3 -0
  416. package/dist/engine/session/import-validate.js +34 -2
  417. package/dist/engine/session/repo-utils.d.ts +42 -4
  418. package/dist/engine/session/repo-utils.js +33 -5
  419. package/dist/engine/session/session.d.ts +41 -14
  420. package/dist/engine/session/session.js +96 -25
  421. package/dist/index.d.ts +21 -16
  422. package/dist/index.js +16 -10
  423. package/dist/orchestration/run-spec.d.ts +1 -1
  424. package/dist/orchestration/run-workflow-tool.d.ts +12 -9
  425. package/dist/orchestration/run-workflow-tool.js +15 -19
  426. package/dist/orchestration/workflow-governance.js +13 -21
  427. package/dist/orchestration/workflow-observe.d.ts +4 -3
  428. package/dist/orchestration/workflow-primitives.d.ts +1 -1
  429. package/dist/orchestration/workflow-record-artifact.d.ts +14 -0
  430. package/dist/orchestration/workflow-record-artifact.js +32 -0
  431. package/dist/orchestration/workflow-script-store.d.ts +9 -0
  432. package/dist/orchestration/workflow-script-store.js +20 -1
  433. package/dist/orchestration/workflow-types.d.ts +33 -3
  434. package/dist/orchestration/workflow.d.ts +24 -14
  435. package/dist/orchestration/workflow.js +52 -23
  436. package/dist/prompt-assembly/artifact.js +4 -8
  437. package/dist/prompt-assembly/catalog/engine.d.ts +263 -0
  438. package/dist/prompt-assembly/catalog/engine.js +30 -0
  439. package/dist/prompt-assembly/catalog/index.d.ts +1 -1
  440. package/dist/prompt-assembly/catalog/index.js +2 -2
  441. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +1 -1
  442. package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +29 -0
  443. package/dist/prompt-assembly/epoch.js +6 -8
  444. package/dist/prompt-assembly/turn-snapshot.js +8 -9
  445. package/dist/stores/file/background-agent-store.js +5 -6
  446. package/dist/stores/file/checkpoint-store.d.ts +0 -4
  447. package/dist/stores/file/checkpoint-store.js +7 -3
  448. package/dist/stores/file/file-history-store.d.ts +8 -0
  449. package/dist/stores/file/file-history-store.js +72 -0
  450. package/dist/stores/file/fs-atomic.js +17 -12
  451. package/dist/stores/file/index.js +11 -5
  452. package/dist/stores/file/mailbox-store.js +13 -4
  453. package/dist/stores/file/permission-rule-store.js +14 -13
  454. package/dist/stores/file/shared-ledger.d.ts +4 -0
  455. package/dist/stores/file/shared-ledger.js +4 -0
  456. package/dist/stores/file/task-list-store.js +12 -3
  457. package/dist/stores/file/workflow-run-store.js +1 -0
  458. package/dist/tools/fs/bash-program-position.d.ts +4 -2
  459. package/dist/tools/fs/bash-program-position.js +1 -1
  460. package/dist/tools/fs/bash-readonly-classifier.js +1 -1
  461. package/dist/tools/fs/bound-open.d.ts +97 -0
  462. package/dist/tools/fs/bound-open.js +103 -0
  463. package/dist/tools/fs/containment-face.d.ts +2 -2
  464. package/dist/tools/fs/fs-pdf.d.ts +7 -1
  465. package/dist/tools/fs/fs-pdf.js +31 -23
  466. package/dist/tools/fs/fs-read.d.ts +24 -17
  467. package/dist/tools/fs/fs-read.js +84 -53
  468. package/dist/tools/fs/fs-shared.d.ts +14 -12
  469. package/dist/tools/fs/fs-shared.js +5 -4
  470. package/dist/tools/fs/fs-write.d.ts +2 -2
  471. package/dist/tools/fs/fs-write.js +20 -12
  472. package/dist/tools/fs/index.d.ts +4 -4
  473. package/dist/tools/fs/index.js +2 -2
  474. package/dist/tools/fs/notebook.d.ts +1 -1
  475. package/dist/tools/fs/pdf.d.ts +12 -3
  476. package/dist/tools/fs/pdf.js +22 -9
  477. package/dist/tools/fs/read-deny-home.d.ts +3 -2
  478. package/dist/tools/fs/read-deny-home.js +8 -11
  479. package/dist/tools/fs/safety.d.ts +3 -2
  480. package/dist/tools/fs/shell-read-check.js +10 -9
  481. package/dist/tools/monitor.d.ts +6 -5
  482. package/dist/tools/task-list.d.ts +16 -6
  483. package/dist/tools/task-list.js +4 -0
  484. package/dist/tools/web.d.ts +9 -1
  485. package/dist/tools/web.js +8 -3
  486. package/dist/tools/worktree.d.ts +7 -5
  487. package/dist/tools/worktree.js +4 -3
  488. package/package.json +4 -3
  489. package/test/export-surface.snapshot.json +93 -7
  490. package/wire-changes/core-stores-sql@7.68.0.json +39 -0
  491. package/wire-changes/core@7.68.0.json +4257 -0
  492. package/wire-changes/mods-kernel@7.68.0.json +129 -0
  493. package/wire-changes/primitives@7.68.0.json +253 -0
  494. package/wire-changes/wiki-gate@7.68.0.json +39 -0
  495. package/dist/core/runner/credential-origin-seat.d.ts +0 -2
  496. package/dist/core/runner/credential-origin-seat.js +0 -20
@@ -1,91 +1,141 @@
1
1
  import { headerListEntries, lockHeader, takeHeaderSpellings } from "./request-params.js";
2
- import { MIN_THINKING_TOKENS, RESPONSES_APIS, budgetCapSkipsThinking, completionsFormatOf, declaredEffortLevels, declaredOffSpelling, mintEffortWireValue, offSpelling, reasoningBudgetShare, reasoningRequestCarried, resolveEffort, } from "./reasoning.js";
2
+ import { describeRejectedValue } from "../core/tool-search-setting.js";
3
+ import { MIN_THINKING_TOKENS, RESPONSES_APIS, THINKING_LEVELS, budgetCapSkipsThinking, completionsFormatOf, declaredEffortLevels, declaredOffSpelling, judgeThinkingLevel, mintEffortWireValue, offSpelling, reasoningBudgetShare, reasoningRequestCarried, resolveEffort, sanitizeEffortLevels, } from "./reasoning.js";
3
4
  export function lowestReasoningSeat(model) {
4
5
  return offSpelling(model).spelled ? "off" : "low";
5
6
  }
6
7
  const BETA_EFFORT = "effort-2025-11-24";
7
8
  const BETA_CONTEXT_MANAGEMENT = "context-management-2025-06-27";
8
9
  const BETA_INTERLEAVED_THINKING = "interleaved-thinking-2025-05-14";
9
- function put(body, key, value) {
10
- body[key] = value;
11
- return undefined;
10
+ const CAP_BLIND = MIN_THINKING_TOKENS * 2;
11
+ function saidOf(tier, wrote) {
12
+ if (wrote.tierKey)
13
+ return tier;
14
+ if (wrote.switched)
15
+ return tier === "off" ? "off" : "on";
16
+ return "provider_default";
17
+ }
18
+ function refuseInput(field, sentence) {
19
+ const e = new Error(`applyReasoningToRequest: ${sentence}`);
20
+ e.code = "config.invalid_argument";
21
+ e.detail = { field };
22
+ throw e;
23
+ }
24
+ function refuseBody(field, why, value) {
25
+ return refuseInput(field, `${field} ${why} (got ${describeRejectedValue(value)})`);
12
26
  }
13
- function withTemplateKwarg(body, enabled) {
14
- const kwargs = (typeof body.chat_template_kwargs === "object" && body.chat_template_kwargs) || {};
15
- return put(body, "chat_template_kwargs", { ...kwargs, enable_thinking: enabled });
27
+ const isPlainObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
28
+ function mergeInto(body, key, members) {
29
+ const held = body[key];
30
+ if (held !== undefined && !isPlainObject(held))
31
+ refuseBody(`body.${key}`, "must be an object when present (the thinking keys are written into it)", held);
32
+ body[key] = { ...(held ?? {}), ...members };
33
+ }
34
+ const isThinkingEdit = (edit) => isPlainObject(edit) && typeof edit.type === "string" && edit.type.startsWith("clear_thinking_");
35
+ const OWNED_MEMBERS = {
36
+ completions: ["reasoning_effort", "thinking", "reasoning", "enable_thinking", "chat_template_kwargs.enable_thinking"],
37
+ responses: ["reasoning.effort"],
38
+ messages: ["thinking", "output_config.effort", "context_management.edits"],
39
+ };
40
+ function refuseOwnedMembers(lane, body) {
41
+ for (const path of OWNED_MEMBERS[lane]) {
42
+ const [head, member] = path.split(".");
43
+ const outer = body[head];
44
+ let value = outer;
45
+ if (member !== undefined)
46
+ value = isPlainObject(outer) ? outer[member] : undefined;
47
+ if (path === "context_management.edits")
48
+ value = Array.isArray(value) ? value.find(isThinkingEdit) : undefined;
49
+ if (value !== undefined)
50
+ refuseBody(`body.${path}`, "is written by the applier from the requested tier and may not be supplied in the body", value);
51
+ }
16
52
  }
53
+ const wroteNothing = { effort: undefined, switched: false };
17
54
  function withEffort(body, effort, supportsEffort) {
18
55
  if (!supportsEffort || effort === undefined)
19
- return undefined;
56
+ return wroteNothing;
20
57
  body.reasoning_effort = effort;
21
- return effort;
58
+ return { effort, switched: false };
59
+ }
60
+ function switchedWith(body, key, members) {
61
+ mergeInto(body, key, members);
62
+ return { effort: undefined, switched: true };
63
+ }
64
+ function putSwitch(body, key, value) {
65
+ body[key] = value;
66
+ return { effort: undefined, switched: true };
22
67
  }
23
68
  const COMPLETIONS_DIALECT = {
24
69
  openai: {
25
70
  off: (body, model) => {
26
71
  const spelling = declaredOffSpelling(model);
27
- return spelling === undefined ? undefined : withEffort(body, spelling, true);
72
+ return spelling === undefined ? wroteNothing : withEffort(body, spelling, true);
28
73
  },
29
74
  on: withEffort,
30
75
  },
31
76
  openrouter: {
32
- off: (body) => put(body, "reasoning", { enabled: false }),
77
+ off: (body) => putSwitch(body, "reasoning", { enabled: false }),
33
78
  on: (body, effort) => {
34
- put(body, "reasoning", { effort });
35
- return effort;
79
+ putSwitch(body, "reasoning", effort === undefined ? {} : { effort });
80
+ return { effort, switched: true };
36
81
  },
37
82
  },
38
83
  deepseek: {
39
- off: (body) => put(body, "thinking", { type: "disabled" }),
84
+ off: (body) => putSwitch(body, "thinking", { type: "disabled" }),
40
85
  on: (body, effort, supportsEffort) => {
41
- put(body, "thinking", { type: "enabled" });
42
- return withEffort(body, effort, supportsEffort);
86
+ putSwitch(body, "thinking", { type: "enabled" });
87
+ return { effort: withEffort(body, effort, supportsEffort).effort, switched: true };
43
88
  },
44
89
  },
45
90
  together: {
46
- off: (body) => put(body, "reasoning", { enabled: false }),
91
+ off: (body) => putSwitch(body, "reasoning", { enabled: false }),
47
92
  on: (body, effort, supportsEffort) => {
48
- put(body, "reasoning", { enabled: true });
49
- return withEffort(body, effort, supportsEffort);
93
+ putSwitch(body, "reasoning", { enabled: true });
94
+ return { effort: withEffort(body, effort, supportsEffort).effort, switched: true };
50
95
  },
51
96
  },
52
- qwen: { off: (body) => put(body, "enable_thinking", false), on: (body) => put(body, "enable_thinking", true) },
53
- zai: { off: (body) => put(body, "enable_thinking", false), on: (body) => put(body, "enable_thinking", true) },
54
- "qwen-chat-template": { off: (body) => withTemplateKwarg(body, false), on: (body) => withTemplateKwarg(body, true) },
97
+ qwen: { off: (body) => putSwitch(body, "enable_thinking", false), on: (body) => putSwitch(body, "enable_thinking", true) },
98
+ zai: { off: (body) => putSwitch(body, "enable_thinking", false), on: (body) => putSwitch(body, "enable_thinking", true) },
99
+ "qwen-chat-template": {
100
+ off: (body) => switchedWith(body, "chat_template_kwargs", { enable_thinking: false }),
101
+ on: (body) => switchedWith(body, "chat_template_kwargs", { enable_thinking: true }),
102
+ },
55
103
  };
56
- function completionsDialectOf(compat) {
104
+ function applyCompletions(input, level, body) {
105
+ const { model } = input;
106
+ const compat = (model.compat ?? {});
57
107
  const format = completionsFormatOf(compat);
58
- return format === undefined ? undefined : COMPLETIONS_DIALECT[format];
108
+ const dialect = COMPLETIONS_DIALECT[format];
109
+ let tier = "off";
110
+ let wrote = wroteNothing;
111
+ if (level === "off") {
112
+ if (offSpelling(model, input.api).spelled)
113
+ wrote = dialect.off(body, model);
114
+ }
115
+ else if (reasoningRequestCarried(model, level)) {
116
+ const mint = mintEffortWireValue(level, model, compat.reasoningEffortLevels);
117
+ tier = mint.resolution.effective;
118
+ wrote = dialect.on(body, mint.wireValue, compat.supportsReasoningEffort ?? true);
119
+ }
120
+ const said = saidOf(tier, { tierKey: wrote.effort !== undefined, switched: wrote.switched });
121
+ return { body, headers: {}, effort: wrote.effort, carried: { said, format } };
59
122
  }
60
- const bodyOnly = (body, effort) => ({ body, headers: {}, effort, wireFacts: undefined });
61
- function applyCompletions(input, body) {
62
- const { model, level } = input;
123
+ function applyResponses(input, level, body) {
124
+ const { model } = input;
63
125
  const compat = (model.compat ?? {});
64
- const dialect = completionsDialectOf(compat);
65
- if (level === "off")
66
- return bodyOnly(body, offSpelling(model, input.api).spelled ? dialect?.off(body, model) : undefined);
67
- if (!reasoningRequestCarried(model, level))
68
- return bodyOnly(body);
69
- const supportsEffort = compat.supportsReasoningEffort ?? true;
70
- const wire = mintEffortWireValue(level, model, compat.reasoningEffortLevels).wireValue;
71
- return bodyOnly(body, dialect?.on(body, wire, supportsEffort));
72
- }
73
- function applyResponses(input, body) {
74
- const { model, level } = input;
75
- const effort = responsesEffort(model, level, input.api);
126
+ let tier = "off";
127
+ let effort;
128
+ if (level === "off") {
129
+ effort = offSpelling(model, input.api).spelled ? declaredOffSpelling(model) : undefined;
130
+ }
131
+ else if (compat.supportsReasoningEffort !== false && reasoningRequestCarried(model, level)) {
132
+ const mint = mintEffortWireValue(level, model, compat.reasoningEffortLevels);
133
+ tier = mint.resolution.effective;
134
+ effort = mint.wireValue;
135
+ }
76
136
  if (effort !== undefined)
77
- body.reasoning = { effort };
78
- return bodyOnly(body, effort);
79
- }
80
- function responsesEffort(model, level, api) {
81
- if (level === "off")
82
- return offSpelling(model, api).spelled ? declaredOffSpelling(model) : undefined;
83
- const compat = (model.compat ?? {});
84
- if (compat.supportsReasoningEffort === false)
85
- return undefined;
86
- if (!reasoningRequestCarried(model, level))
87
- return undefined;
88
- return mintEffortWireValue(level, model, compat.reasoningEffortLevels).wireValue;
137
+ mergeInto(body, "reasoning", { effort });
138
+ return { body, headers: {}, effort, carried: { said: saidOf(tier, { tierKey: effort !== undefined, switched: false }), format: "responses" } };
89
139
  }
90
140
  function thinkingBudget(maxTokens, share, fixed, hardCap) {
91
141
  const max = hardCap ? maxTokens : Math.max(maxTokens, MIN_THINKING_TOKENS * 2);
@@ -93,37 +143,37 @@ function thinkingBudget(maxTokens, share, fixed, hardCap) {
93
143
  const budget = Math.min(Math.max(MIN_THINKING_TOKENS, want), max - 1);
94
144
  return { max, budget };
95
145
  }
96
- function applyMessages(input, body) {
97
- const { model, level } = input;
146
+ function applyMessages(input, level, body) {
147
+ const { model } = input;
98
148
  const compat = (model.compat ?? {});
99
- let wireFacts;
149
+ const declaredEffort = declaredEffortLevels(compat.effortLevels);
150
+ let tier = "off";
100
151
  let thinkingOn = false;
152
+ let budgetIsTier = false;
101
153
  if (reasoningRequestCarried(model, level)) {
154
+ tier = level;
102
155
  if (compat.thinkingMode === "adaptive") {
103
156
  body.thinking = { type: "adaptive" };
104
157
  thinkingOn = true;
105
158
  }
106
159
  else {
107
160
  if (body.max_tokens === undefined || body.max_tokens === null) {
108
- throw new TypeError("applyReasoningToRequest: the Messages budget form needs a body.max_tokens (it sizes the thinking budget)");
161
+ refuseInput("body.max_tokens", "the Messages budget form needs a body.max_tokens (it sizes the thinking budget)");
109
162
  }
110
163
  const maxTokens = body.max_tokens;
111
164
  const hardCap = input.budget?.capIsHard ?? true;
112
- wireFacts = { outputCapTokens: maxTokens, hardOutputCap: hardCap };
113
- if (budgetCapSkipsThinking(wireFacts.outputCapTokens, wireFacts.hardOutputCap)) {
114
- delete body.thinking;
115
- }
116
- else {
165
+ if (!budgetCapSkipsThinking(maxTokens, hardCap)) {
117
166
  const share = input.budget?.share ?? reasoningBudgetShare(level);
118
167
  const { max, budget } = thinkingBudget(maxTokens, share, input.budget?.tokens, hardCap);
119
168
  if (!Number.isFinite(Number(max)) || !Number.isFinite(budget)) {
120
169
  const shown = (value) => (typeof value === "string" ? JSON.stringify(value) : String(value));
121
- throw new TypeError(`applyReasoningToRequest: the Messages budget form cannot size a thinking budget from body.max_tokens ${shown(body.max_tokens)}, ` +
170
+ refuseInput(!Number.isFinite(Number(max)) ? "body.max_tokens" : input.budget?.tokens !== undefined ? "budget.tokens" : "budget.share", `the Messages budget form cannot size a thinking budget from body.max_tokens ${shown(body.max_tokens)}, ` +
122
171
  `budget.share ${shown(share)}, budget.tokens ${shown(input.budget?.tokens)} (cap ${shown(max)}, budget ${shown(budget)}); each must read as a finite number`);
123
172
  }
124
173
  body.max_tokens = max;
125
174
  body.thinking = { type: "enabled", budget_tokens: budget };
126
175
  thinkingOn = true;
176
+ budgetIsTier = input.budget?.share === undefined && input.budget?.tokens === undefined;
127
177
  }
128
178
  }
129
179
  if (thinkingOn)
@@ -134,28 +184,70 @@ function applyMessages(input, body) {
134
184
  }
135
185
  const betas = [];
136
186
  let effort;
137
- const declaredEffort = declaredEffortLevels(compat.effortLevels);
138
187
  if (declaredEffort !== undefined && reasoningRequestCarried(model, level)) {
139
- const { effective } = resolveEffort(level, declaredEffort);
140
- effort = effective === "minimal" ? "low" : effective;
141
- body.output_config = { effort };
188
+ const tiers = [...new Set(sanitizeEffortLevels(declaredEffort).map((t) => (t === "minimal" ? "low" : t)))];
189
+ tier = resolveEffort(level, tiers).effective;
190
+ effort = tier;
191
+ mergeInto(body, "output_config", { effort });
142
192
  betas.push(BETA_EFFORT);
143
193
  }
144
194
  if (compat.contextManagement && thinkingOn) {
145
- body.context_management = { edits: [{ type: "clear_thinking_20251015", keep: "all" }] };
195
+ const held = body.context_management;
196
+ const edits = isPlainObject(held) ? held.edits : undefined;
197
+ if (edits !== undefined && !Array.isArray(edits))
198
+ refuseBody("body.context_management.edits", "must be an array when present (the thinking edit is written into it)", edits);
199
+ mergeInto(body, "context_management", { edits: [{ type: "clear_thinking_20251015", keep: "all" }, ...(edits ?? [])] });
146
200
  betas.push(BETA_CONTEXT_MANAGEMENT);
147
201
  }
148
202
  if (compat.interleavedThinking)
149
203
  betas.push(BETA_INTERLEAVED_THINKING);
150
- return { body, headers: betas.length > 0 ? { "anthropic-beta": betas.join(",") } : {}, effort, wireFacts };
204
+ const said = saidOf(tier, { tierKey: effort !== undefined || budgetIsTier, switched: body.thinking !== undefined });
205
+ return { body, headers: betas.length > 0 ? { "anthropic-beta": betas.join(",") } : {}, effort, carried: { said, format: declaredEffort !== undefined ? "effort" : "budget" } };
151
206
  }
152
207
  export function applyReasoningToRequest(input) {
208
+ const level = judgeThinkingLevel(input.level, "applyReasoningToRequest.level");
209
+ const lane = input.api === "anthropic-messages" ? "messages" : RESPONSES_APIS.has(input.api) ? "responses" : "completions";
210
+ refuseOwnedMembers(lane, input.body);
153
211
  const body = { ...input.body };
154
- if (input.api === "anthropic-messages")
155
- return applyMessages(input, body);
156
- if (RESPONSES_APIS.has(input.api))
157
- return applyResponses(input, body);
158
- return applyCompletions(input, body);
212
+ if (lane === "messages")
213
+ return applyMessages(input, level, body);
214
+ if (lane === "responses")
215
+ return applyResponses(input, level, body);
216
+ return applyCompletions(input, level, body);
217
+ }
218
+ export function resolutionOf(requested, carried, endpoint) {
219
+ const effective = carried.said;
220
+ return {
221
+ requested,
222
+ effective,
223
+ graded: effective !== "off" && THINKING_LEVELS.includes(effective),
224
+ clamped: effective !== requested,
225
+ format: carried.format,
226
+ endpoint,
227
+ ...(effective === "provider_default" ? { dropped: true } : {}),
228
+ };
229
+ }
230
+ export function resolveReasoning(requested, model, facts) {
231
+ judgeThinkingLevel(requested, "resolveReasoning.requested");
232
+ const api = model.api ?? "unknown";
233
+ const { carried } = applyReasoningToRequest({
234
+ api,
235
+ model,
236
+ level: requested,
237
+ body: { max_tokens: facts?.outputCapTokens ?? CAP_BLIND },
238
+ budget: { capIsHard: facts?.hardOutputCap ?? false },
239
+ });
240
+ return resolutionOf(requested, carried, api);
241
+ }
242
+ export function reasoningEffortLevelsOf(model) {
243
+ const api = model.api ?? "unknown";
244
+ const honored = THINKING_LEVELS.filter((t) => {
245
+ if (t === "off")
246
+ return false;
247
+ const applied = applyReasoningToRequest({ api, model, level: t, body: { max_tokens: CAP_BLIND }, budget: { capIsHard: false } });
248
+ return applied.effort !== undefined && applied.carried.said === t;
249
+ });
250
+ return honored.length > 0 ? honored : undefined;
159
251
  }
160
252
  export function mergeReasoningHeaders(headers, patch) {
161
253
  for (const [name, value] of Object.entries(patch)) {
@@ -0,0 +1,26 @@
1
+ import type { ThinkingLevel } from "../internal/harness-types.js";
2
+ import type { AssistantMessage, Model } from "../internal/llm.js";
3
+ import type { ReasoningCarriage } from "./reasoning-request.js";
4
+ /**
5
+ * What one request carried for its tier, as its builder hands it to the stream engine (`SSERequest.reasoning`): the tier the
6
+ * request was built for and what its thinking keys say. A request built with no tier carries none — there is nothing to
7
+ * resolve, so the type has no absent tier.
8
+ */
9
+ export interface RequestReasoning {
10
+ readonly level: ThinkingLevel;
11
+ readonly carried: ReasoningCarriage;
12
+ }
13
+ /**
14
+ * The reasoning stamp on a request's terminal message: the {@link RequestReasoning} of the request the engine committed to
15
+ * send, and the `Model` object the engine was handed for it. A reader judges whose request it was by that object, never by an
16
+ * id (two catalog entries may share a wire id).
17
+ */
18
+ export interface ReasoningStamp extends RequestReasoning {
19
+ readonly model: Model;
20
+ }
21
+ /** The request's reasoning, when the request was built with a tier; `undefined` when it was built with none. */
22
+ export declare function requestReasoning(level: ThinkingLevel | undefined, carried: ReasoningCarriage): RequestReasoning | undefined;
23
+ /** Stamp a terminal message with the reasoning of the request that produced it (the stream engine's one stamping point). */
24
+ export declare function stampReasoning(message: AssistantMessage, stamp: ReasoningStamp): void;
25
+ /** The reasoning stamp a message carries, if any: only a terminal message the stream engine produced, as that very object. */
26
+ export declare function reasoningStampOf(message: unknown): ReasoningStamp | undefined;
@@ -0,0 +1,10 @@
1
+ const stamps = new WeakMap();
2
+ export function requestReasoning(level, carried) {
3
+ return level === undefined ? undefined : { level, carried };
4
+ }
5
+ export function stampReasoning(message, stamp) {
6
+ stamps.set(message, stamp);
7
+ }
8
+ export function reasoningStampOf(message) {
9
+ return typeof message === "object" && message !== null ? stamps.get(message) : undefined;
10
+ }