@draht/coding-agent 2026.9.5-1 → 2026.10.4-3

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 (1015) hide show
  1. package/CHANGELOG.md +458 -0
  2. package/dist/bun/cli.d.ts +1 -1
  3. package/dist/bun/cli.d.ts.map +1 -1
  4. package/dist/bun/cli.js +6 -3
  5. package/dist/bun/cli.js.map +1 -1
  6. package/dist/bun/sandbox-env-setup.d.ts +2 -0
  7. package/dist/bun/sandbox-env-setup.d.ts.map +1 -0
  8. package/dist/bun/sandbox-env-setup.js +4 -0
  9. package/dist/bun/sandbox-env-setup.js.map +1 -0
  10. package/dist/bundle/chunks/anthropic-messages-E2P6C3P7.js +6 -0
  11. package/dist/bundle/chunks/anthropic.js +75 -0
  12. package/dist/bundle/chunks/azure-openai-responses-JZMSTDIM.js +2 -0
  13. package/dist/bundle/chunks/bedrock-converse-stream.js +79 -0
  14. package/dist/bundle/chunks/chunk-2E5VODES.js +2 -0
  15. package/dist/bundle/chunks/chunk-2FBJKY7F.js +2 -0
  16. package/dist/bundle/chunks/chunk-2JZLKNZ4.js +3 -0
  17. package/dist/bundle/chunks/chunk-2N4I6WXC.js +2 -0
  18. package/dist/bundle/chunks/chunk-3HF756LN.js +1472 -0
  19. package/dist/bundle/chunks/chunk-5QJFWTKA.js +4 -0
  20. package/dist/bundle/chunks/chunk-63BK6WK2.js +2 -0
  21. package/dist/bundle/chunks/chunk-A4OX5CPR.js +146 -0
  22. package/dist/bundle/chunks/chunk-AFL4IDSI.js +82 -0
  23. package/dist/bundle/chunks/chunk-D3HO453P.js +42 -0
  24. package/dist/bundle/chunks/chunk-EBVYI75P.js +2 -0
  25. package/dist/bundle/chunks/chunk-FBU742QF.js +2 -0
  26. package/dist/bundle/chunks/chunk-FHX2S5IG.js +31 -0
  27. package/dist/bundle/chunks/chunk-GBFVS2SF.js +12 -0
  28. package/dist/bundle/chunks/chunk-GVXA72ZA.js +2 -0
  29. package/dist/bundle/chunks/chunk-HJ72RANT.js +2 -0
  30. package/dist/bundle/chunks/chunk-HTJ3L72O.js +2 -0
  31. package/dist/bundle/chunks/chunk-HZ2UHMBT.js +2 -0
  32. package/dist/bundle/chunks/chunk-I5OKY6RH.js +11 -0
  33. package/dist/bundle/chunks/chunk-JTLUBTZT.js +2 -0
  34. package/dist/bundle/chunks/chunk-KPO5375S.js +2 -0
  35. package/dist/bundle/chunks/chunk-KY2BG6BC.js +11 -0
  36. package/dist/bundle/chunks/chunk-LO6CVU2L.js +6 -0
  37. package/dist/bundle/chunks/chunk-QMN7OD6G.js +2 -0
  38. package/dist/bundle/chunks/chunk-SDRCE6OP.js +2 -0
  39. package/dist/bundle/chunks/chunk-SPZUYYP5.js +170 -0
  40. package/dist/bundle/chunks/chunk-UTRX2VHB.js +44 -0
  41. package/dist/bundle/chunks/chunk-V5HG6S2T.js +4 -0
  42. package/dist/bundle/chunks/chunk-VPYAVQLP.js +137 -0
  43. package/dist/bundle/chunks/chunk-VXUJMEMO.js +2 -0
  44. package/dist/bundle/chunks/chunk-XBUEMKIY.js +2 -0
  45. package/dist/bundle/chunks/chunk-XHCO4PPH.js +8 -0
  46. package/dist/bundle/chunks/chunk-XO3IECI5.js +18 -0
  47. package/dist/bundle/chunks/chunk-XOGEYN4Q.js +2 -0
  48. package/dist/bundle/chunks/cli-L74YA5GF.js +51 -0
  49. package/dist/bundle/chunks/cloudflare-workers-ai-system-one-MJKOAE5S.js +2 -0
  50. package/dist/bundle/chunks/codemode-worker.js +315 -0
  51. package/dist/bundle/chunks/execute-EMOVNTD6.js +328 -0
  52. package/dist/bundle/chunks/github-copilot.js +2 -0
  53. package/dist/bundle/chunks/google-antigravity.js +75 -0
  54. package/dist/bundle/chunks/google-gemini-cli.js +75 -0
  55. package/dist/bundle/chunks/google-generative-ai-HPNDIAZD.js +2 -0
  56. package/dist/bundle/chunks/google-vertex-KPAWJ4SP.js +2 -0
  57. package/dist/bundle/chunks/https-proxy-agent-WQIRL24U.js +13 -0
  58. package/dist/bundle/chunks/image-resize-worker.js +2 -0
  59. package/dist/bundle/chunks/jiti-loader-RKXLMQV2.js +2 -0
  60. package/dist/bundle/chunks/kimi-coding.js +2 -0
  61. package/dist/bundle/chunks/lib-ULKZYRGD.js +9 -0
  62. package/dist/bundle/chunks/llama-cpp-classify-EJ5XMSQL.js +22 -0
  63. package/dist/bundle/chunks/meta.js +2 -0
  64. package/dist/bundle/chunks/mistral-conversations-FMSPWQ7A.js +5 -0
  65. package/dist/bundle/chunks/multipart-parser-HMCXZ4BD.js +3 -0
  66. package/dist/bundle/chunks/node-4JNG6XQO.js +16 -0
  67. package/dist/bundle/chunks/node-6IIDYB3K.js +2 -0
  68. package/dist/bundle/chunks/openai-chatgpt.js +75 -0
  69. package/dist/bundle/chunks/openai-codex-responses-TU7NGPXE.js +10 -0
  70. package/dist/bundle/chunks/openai-codex.js +75 -0
  71. package/dist/bundle/chunks/openai-completions-GANCQQO5.js +7 -0
  72. package/dist/bundle/chunks/openai-responses-ASDPAX3E.js +3 -0
  73. package/dist/bundle/chunks/opencode-go.js +2 -0
  74. package/dist/bundle/chunks/openrouter-images-NROSQXMZ.js +2 -0
  75. package/dist/bundle/chunks/openrouter.js +75 -0
  76. package/dist/bundle/chunks/pi-messages-2QEJYOAO.js +8 -0
  77. package/dist/bundle/chunks/radius.js +75 -0
  78. package/dist/bundle/chunks/runtime-RYUR6LRB.js +2 -0
  79. package/dist/bundle/chunks/settings-manager-CHEMMAGQ.js +2 -0
  80. package/dist/bundle/chunks/src-KDGO7EGF.js +4 -0
  81. package/dist/bundle/chunks/typesafe-system-one-YBEEY5XU.js +2 -0
  82. package/dist/bundle/chunks/virtual-modules-OC56AAJ7.js +2 -0
  83. package/dist/bundle/chunks/xai.js +75 -0
  84. package/dist/bundle/cli-runtime.js +3 -0
  85. package/dist/bundle/cli.js +5 -0
  86. package/dist/bundle/index.js +2 -0
  87. package/dist/bundle/rpc-entry.js +3 -0
  88. package/dist/cli/args.d.ts +4 -0
  89. package/dist/cli/args.d.ts.map +1 -1
  90. package/dist/cli/args.js +72 -21
  91. package/dist/cli/args.js.map +1 -1
  92. package/dist/cli/auth-check.d.ts +19 -0
  93. package/dist/cli/auth-check.d.ts.map +1 -0
  94. package/dist/cli/auth-check.js +50 -0
  95. package/dist/cli/auth-check.js.map +1 -0
  96. package/dist/cli/auth-command.d.ts +24 -0
  97. package/dist/cli/auth-command.d.ts.map +1 -0
  98. package/dist/cli/auth-command.js +103 -0
  99. package/dist/cli/auth-command.js.map +1 -0
  100. package/dist/cli/config-selector.d.ts.map +1 -1
  101. package/dist/cli/config-selector.js +3 -2
  102. package/dist/cli/config-selector.js.map +1 -1
  103. package/dist/cli/credential-print.d.ts +5 -3
  104. package/dist/cli/credential-print.d.ts.map +1 -1
  105. package/dist/cli/credential-print.js +42 -30
  106. package/dist/cli/credential-print.js.map +1 -1
  107. package/dist/cli/file-processor.d.ts +1 -1
  108. package/dist/cli/file-processor.d.ts.map +1 -1
  109. package/dist/cli/file-processor.js +2 -1
  110. package/dist/cli/file-processor.js.map +1 -1
  111. package/dist/cli/list-models.d.ts +1 -1
  112. package/dist/cli/list-models.d.ts.map +1 -1
  113. package/dist/cli/list-models.js +2 -2
  114. package/dist/cli/list-models.js.map +1 -1
  115. package/dist/cli/session-picker.d.ts +1 -1
  116. package/dist/cli/session-picker.d.ts.map +1 -1
  117. package/dist/cli/session-picker.js.map +1 -1
  118. package/dist/cli/setup.d.ts +2 -0
  119. package/dist/cli/setup.d.ts.map +1 -0
  120. package/dist/cli/setup.js +12 -0
  121. package/dist/cli/setup.js.map +1 -0
  122. package/dist/cli/startup-ui.d.ts +2 -2
  123. package/dist/cli/startup-ui.d.ts.map +1 -1
  124. package/dist/cli/startup-ui.js +42 -33
  125. package/dist/cli/startup-ui.js.map +1 -1
  126. package/dist/cli.js +3 -12
  127. package/dist/cli.js.map +1 -1
  128. package/dist/config.d.ts +20 -4
  129. package/dist/config.d.ts.map +1 -1
  130. package/dist/config.js +42 -6
  131. package/dist/config.js.map +1 -1
  132. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  133. package/dist/core/agent-session-runtime.js +12 -3
  134. package/dist/core/agent-session-runtime.js.map +1 -1
  135. package/dist/core/agent-session-services.d.ts +1 -0
  136. package/dist/core/agent-session-services.d.ts.map +1 -1
  137. package/dist/core/agent-session-services.js +14 -0
  138. package/dist/core/agent-session-services.js.map +1 -1
  139. package/dist/core/agent-session.d.ts +237 -39
  140. package/dist/core/agent-session.d.ts.map +1 -1
  141. package/dist/core/agent-session.js +1386 -565
  142. package/dist/core/agent-session.js.map +1 -1
  143. package/dist/core/auth-storage.d.ts +20 -8
  144. package/dist/core/auth-storage.d.ts.map +1 -1
  145. package/dist/core/auth-storage.js +199 -56
  146. package/dist/core/auth-storage.js.map +1 -1
  147. package/dist/core/bug-report-upload.d.ts +11 -0
  148. package/dist/core/bug-report-upload.d.ts.map +1 -0
  149. package/dist/core/bug-report-upload.js +20 -0
  150. package/dist/core/bug-report-upload.js.map +1 -0
  151. package/dist/core/bug-report.d.ts +176 -0
  152. package/dist/core/bug-report.d.ts.map +1 -0
  153. package/dist/core/bug-report.js +292 -0
  154. package/dist/core/bug-report.js.map +1 -0
  155. package/dist/core/builtins/duet.js +2 -2
  156. package/dist/core/builtins/duet.js.map +1 -1
  157. package/dist/core/cache-stats.d.ts.map +1 -1
  158. package/dist/core/cache-stats.js +12 -1
  159. package/dist/core/cache-stats.js.map +1 -1
  160. package/dist/core/cache-warmer.d.ts +103 -0
  161. package/dist/core/cache-warmer.d.ts.map +1 -0
  162. package/dist/core/cache-warmer.js +356 -0
  163. package/dist/core/cache-warmer.js.map +1 -0
  164. package/dist/core/checkpoints/checkpoint-manager.d.ts +8 -4
  165. package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -1
  166. package/dist/core/checkpoints/checkpoint-manager.js +46 -10
  167. package/dist/core/checkpoints/checkpoint-manager.js.map +1 -1
  168. package/dist/core/checkpoints/rewind.d.ts +4 -2
  169. package/dist/core/checkpoints/rewind.d.ts.map +1 -1
  170. package/dist/core/checkpoints/rewind.js +4 -3
  171. package/dist/core/checkpoints/rewind.js.map +1 -1
  172. package/dist/core/compaction/branch-summarization.js +2 -2
  173. package/dist/core/compaction/branch-summarization.js.map +1 -1
  174. package/dist/core/compaction/compaction.d.ts +9 -6
  175. package/dist/core/compaction/compaction.d.ts.map +1 -1
  176. package/dist/core/compaction/compaction.js +196 -118
  177. package/dist/core/compaction/compaction.js.map +1 -1
  178. package/dist/core/compaction/utils.d.ts +2 -1
  179. package/dist/core/compaction/utils.d.ts.map +1 -1
  180. package/dist/core/compaction/utils.js +25 -18
  181. package/dist/core/compaction/utils.js.map +1 -1
  182. package/dist/core/context-windows.d.ts.map +1 -1
  183. package/dist/core/context-windows.js +13 -3
  184. package/dist/core/context-windows.js.map +1 -1
  185. package/dist/core/crash-log.d.ts +27 -0
  186. package/dist/core/crash-log.d.ts.map +1 -0
  187. package/dist/core/crash-log.js +140 -0
  188. package/dist/core/crash-log.js.map +1 -0
  189. package/dist/core/defaults.d.ts +1 -0
  190. package/dist/core/defaults.d.ts.map +1 -1
  191. package/dist/core/defaults.js +9 -0
  192. package/dist/core/defaults.js.map +1 -1
  193. package/dist/core/experimental.js +1 -1
  194. package/dist/core/experimental.js.map +1 -1
  195. package/dist/core/export-html/template.css +10 -0
  196. package/dist/core/export-html/template.js +72 -18
  197. package/dist/core/extensions/index.d.ts +2 -2
  198. package/dist/core/extensions/index.d.ts.map +1 -1
  199. package/dist/core/extensions/index.js +1 -1
  200. package/dist/core/extensions/index.js.map +1 -1
  201. package/dist/core/extensions/jiti-loader.d.ts +2 -0
  202. package/dist/core/extensions/jiti-loader.d.ts.map +1 -0
  203. package/dist/core/extensions/jiti-loader.js +5 -0
  204. package/dist/core/extensions/jiti-loader.js.map +1 -0
  205. package/dist/core/extensions/loader.d.ts.map +1 -1
  206. package/dist/core/extensions/loader.js +228 -89
  207. package/dist/core/extensions/loader.js.map +1 -1
  208. package/dist/core/extensions/runner.d.ts +47 -8
  209. package/dist/core/extensions/runner.d.ts.map +1 -1
  210. package/dist/core/extensions/runner.js +376 -104
  211. package/dist/core/extensions/runner.js.map +1 -1
  212. package/dist/core/extensions/types.d.ts +521 -88
  213. package/dist/core/extensions/types.d.ts.map +1 -1
  214. package/dist/core/extensions/types.js +3 -0
  215. package/dist/core/extensions/types.js.map +1 -1
  216. package/dist/core/extensions/virtual-modules.d.ts +3 -0
  217. package/dist/core/extensions/virtual-modules.d.ts.map +1 -0
  218. package/dist/core/extensions/virtual-modules.js +37 -0
  219. package/dist/core/extensions/virtual-modules.js.map +1 -0
  220. package/dist/core/extensions/wrapper.d.ts +2 -2
  221. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  222. package/dist/core/extensions/wrapper.js +3 -22
  223. package/dist/core/extensions/wrapper.js.map +1 -1
  224. package/dist/core/footer-data-provider.d.ts +1 -1
  225. package/dist/core/footer-data-provider.js +19 -18
  226. package/dist/core/footer-data-provider.js.map +1 -1
  227. package/dist/core/index.d.ts +2 -1
  228. package/dist/core/index.d.ts.map +1 -1
  229. package/dist/core/index.js.map +1 -1
  230. package/dist/core/keybindings.d.ts +83 -13
  231. package/dist/core/keybindings.d.ts.map +1 -1
  232. package/dist/core/keybindings.js +33 -7
  233. package/dist/core/keybindings.js.map +1 -1
  234. package/dist/core/mcp-servers.d.ts +119 -0
  235. package/dist/core/mcp-servers.d.ts.map +1 -0
  236. package/dist/core/mcp-servers.js +191 -0
  237. package/dist/core/mcp-servers.js.map +1 -0
  238. package/dist/core/messages.d.ts +1 -1
  239. package/dist/core/messages.d.ts.map +1 -1
  240. package/dist/core/messages.js +1 -0
  241. package/dist/core/messages.js.map +1 -1
  242. package/dist/core/model-config.d.ts +202 -20
  243. package/dist/core/model-config.d.ts.map +1 -1
  244. package/dist/core/model-config.js +53 -18
  245. package/dist/core/model-config.js.map +1 -1
  246. package/dist/core/model-registry.d.ts +19 -2
  247. package/dist/core/model-registry.d.ts.map +1 -1
  248. package/dist/core/model-registry.js +39 -2
  249. package/dist/core/model-registry.js.map +1 -1
  250. package/dist/core/model-resolver.d.ts +7 -5
  251. package/dist/core/model-resolver.d.ts.map +1 -1
  252. package/dist/core/model-resolver.js +29 -17
  253. package/dist/core/model-resolver.js.map +1 -1
  254. package/dist/core/model-runtime.d.ts +79 -20
  255. package/dist/core/model-runtime.d.ts.map +1 -1
  256. package/dist/core/model-runtime.js +460 -134
  257. package/dist/core/model-runtime.js.map +1 -1
  258. package/dist/core/models-store.d.ts +12 -7
  259. package/dist/core/models-store.d.ts.map +1 -1
  260. package/dist/core/models-store.js +87 -18
  261. package/dist/core/models-store.js.map +1 -1
  262. package/dist/core/multi-agent/fsm.js +8 -3
  263. package/dist/core/multi-agent/fsm.js.map +1 -1
  264. package/dist/core/multi-agent/mailbox.js +1 -3
  265. package/dist/core/multi-agent/mailbox.js.map +1 -1
  266. package/dist/core/multi-agent/permission-gate.d.ts +5 -2
  267. package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
  268. package/dist/core/multi-agent/permission-gate.js +597 -34
  269. package/dist/core/multi-agent/permission-gate.js.map +1 -1
  270. package/dist/core/multi-agent/task-board.js +2 -4
  271. package/dist/core/multi-agent/task-board.js.map +1 -1
  272. package/dist/core/multi-agent/worktree.js +1 -3
  273. package/dist/core/multi-agent/worktree.js.map +1 -1
  274. package/dist/core/nested-tool-calls.d.ts +102 -0
  275. package/dist/core/nested-tool-calls.d.ts.map +1 -0
  276. package/dist/core/nested-tool-calls.js +178 -0
  277. package/dist/core/nested-tool-calls.js.map +1 -0
  278. package/dist/core/package-manager.d.ts +10 -0
  279. package/dist/core/package-manager.d.ts.map +1 -1
  280. package/dist/core/package-manager.js +149 -33
  281. package/dist/core/package-manager.js.map +1 -1
  282. package/dist/core/pi-manifest.d.ts.map +1 -1
  283. package/dist/core/pi-manifest.js +13 -12
  284. package/dist/core/pi-manifest.js.map +1 -1
  285. package/dist/core/prompt-templates.d.ts +6 -1
  286. package/dist/core/prompt-templates.d.ts.map +1 -1
  287. package/dist/core/prompt-templates.js +63 -37
  288. package/dist/core/prompt-templates.js.map +1 -1
  289. package/dist/core/provider-attribution.js +5 -5
  290. package/dist/core/provider-attribution.js.map +1 -1
  291. package/dist/core/provider-composer.d.ts +44 -20
  292. package/dist/core/provider-composer.d.ts.map +1 -1
  293. package/dist/core/provider-composer.js +151 -51
  294. package/dist/core/provider-composer.js.map +1 -1
  295. package/dist/core/radius.d.ts +13 -0
  296. package/dist/core/radius.d.ts.map +1 -1
  297. package/dist/core/radius.js +19 -0
  298. package/dist/core/radius.js.map +1 -1
  299. package/dist/core/remote-catalog-provider.d.ts +10 -3
  300. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  301. package/dist/core/remote-catalog-provider.js +105 -81
  302. package/dist/core/remote-catalog-provider.js.map +1 -1
  303. package/dist/core/resource-loader.d.ts +7 -1
  304. package/dist/core/resource-loader.d.ts.map +1 -1
  305. package/dist/core/resource-loader.js +219 -42
  306. package/dist/core/resource-loader.js.map +1 -1
  307. package/dist/core/runtime-credentials.d.ts +5 -5
  308. package/dist/core/runtime-credentials.d.ts.map +1 -1
  309. package/dist/core/runtime-credentials.js +13 -9
  310. package/dist/core/runtime-credentials.js.map +1 -1
  311. package/dist/core/sandbox/executor.js +1 -0
  312. package/dist/core/sandbox/executor.js.map +1 -1
  313. package/dist/core/sdk.d.ts +7 -5
  314. package/dist/core/sdk.d.ts.map +1 -1
  315. package/dist/core/sdk.js +100 -52
  316. package/dist/core/sdk.js.map +1 -1
  317. package/dist/core/session-cwd.js +1 -0
  318. package/dist/core/session-cwd.js.map +1 -1
  319. package/dist/core/session-export.d.ts +8 -0
  320. package/dist/core/session-export.d.ts.map +1 -0
  321. package/dist/core/session-export.js +33 -0
  322. package/dist/core/session-export.js.map +1 -0
  323. package/dist/core/session-manager.d.ts +75 -15
  324. package/dist/core/session-manager.d.ts.map +1 -1
  325. package/dist/core/session-manager.js +314 -144
  326. package/dist/core/session-manager.js.map +1 -1
  327. package/dist/core/settings-diagnostics.d.ts +9 -0
  328. package/dist/core/settings-diagnostics.d.ts.map +1 -0
  329. package/dist/core/settings-diagnostics.js +21 -0
  330. package/dist/core/settings-diagnostics.js.map +1 -0
  331. package/dist/core/settings-manager.d.ts +84 -4
  332. package/dist/core/settings-manager.d.ts.map +1 -1
  333. package/dist/core/settings-manager.js +239 -25
  334. package/dist/core/settings-manager.js.map +1 -1
  335. package/dist/core/skills.d.ts.map +1 -1
  336. package/dist/core/skills.js +51 -33
  337. package/dist/core/skills.js.map +1 -1
  338. package/dist/core/slash-commands.d.ts.map +1 -1
  339. package/dist/core/slash-commands.js +3 -1
  340. package/dist/core/slash-commands.js.map +1 -1
  341. package/dist/core/soak/soak-log.js +6 -0
  342. package/dist/core/soak/soak-log.js.map +1 -1
  343. package/dist/core/socket-server/socket-server.js +11 -0
  344. package/dist/core/socket-server/socket-server.js.map +1 -1
  345. package/dist/core/socket-server/types.d.ts +2 -1
  346. package/dist/core/socket-server/types.d.ts.map +1 -1
  347. package/dist/core/socket-server/types.js.map +1 -1
  348. package/dist/core/source-info.d.ts +8 -0
  349. package/dist/core/source-info.d.ts.map +1 -1
  350. package/dist/core/source-info.js +16 -0
  351. package/dist/core/source-info.js.map +1 -1
  352. package/dist/core/system-prompt.d.ts +49 -6
  353. package/dist/core/system-prompt.d.ts.map +1 -1
  354. package/dist/core/system-prompt.js +126 -89
  355. package/dist/core/system-prompt.js.map +1 -1
  356. package/dist/core/tools/bash.d.ts +32 -2
  357. package/dist/core/tools/bash.d.ts.map +1 -1
  358. package/dist/core/tools/bash.js +82 -143
  359. package/dist/core/tools/bash.js.map +1 -1
  360. package/dist/core/tools/edit-diff.d.ts +0 -5
  361. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  362. package/dist/core/tools/edit-diff.js +2 -5
  363. package/dist/core/tools/edit-diff.js.map +1 -1
  364. package/dist/core/tools/edit.d.ts +5 -12
  365. package/dist/core/tools/edit.d.ts.map +1 -1
  366. package/dist/core/tools/edit.js +19 -171
  367. package/dist/core/tools/edit.js.map +1 -1
  368. package/dist/core/tools/find.d.ts +4 -0
  369. package/dist/core/tools/find.d.ts.map +1 -1
  370. package/dist/core/tools/find.js +11 -58
  371. package/dist/core/tools/find.js.map +1 -1
  372. package/dist/core/tools/grep.d.ts +4 -0
  373. package/dist/core/tools/grep.d.ts.map +1 -1
  374. package/dist/core/tools/grep.js +10 -62
  375. package/dist/core/tools/grep.js.map +1 -1
  376. package/dist/core/tools/index.d.ts +4 -1
  377. package/dist/core/tools/index.d.ts.map +1 -1
  378. package/dist/core/tools/index.js +18 -1
  379. package/dist/core/tools/index.js.map +1 -1
  380. package/dist/core/tools/ls.d.ts +4 -0
  381. package/dist/core/tools/ls.d.ts.map +1 -1
  382. package/dist/core/tools/ls.js +9 -50
  383. package/dist/core/tools/ls.js.map +1 -1
  384. package/dist/core/tools/output-accumulator.d.ts +11 -0
  385. package/dist/core/tools/output-accumulator.d.ts.map +1 -1
  386. package/dist/core/tools/output-accumulator.js +54 -12
  387. package/dist/core/tools/output-accumulator.js.map +1 -1
  388. package/dist/core/tools/powershell.d.ts +16 -0
  389. package/dist/core/tools/powershell.d.ts.map +1 -0
  390. package/dist/core/tools/powershell.js +39 -0
  391. package/dist/core/tools/powershell.js.map +1 -0
  392. package/dist/core/tools/read.d.ts +8 -1
  393. package/dist/core/tools/read.d.ts.map +1 -1
  394. package/dist/core/tools/read.js +16 -123
  395. package/dist/core/tools/read.js.map +1 -1
  396. package/dist/core/tools/render-utils.d.ts +6 -0
  397. package/dist/core/tools/render-utils.d.ts.map +1 -1
  398. package/dist/core/tools/render-utils.js +26 -0
  399. package/dist/core/tools/render-utils.js.map +1 -1
  400. package/dist/core/tools/renderers/bash.d.ts +12 -0
  401. package/dist/core/tools/renderers/bash.d.ts.map +1 -0
  402. package/dist/core/tools/renderers/bash.js +117 -0
  403. package/dist/core/tools/renderers/bash.js.map +1 -0
  404. package/dist/core/tools/renderers/edit.d.ts +23 -0
  405. package/dist/core/tools/renderers/edit.d.ts.map +1 -0
  406. package/dist/core/tools/renderers/edit.js +167 -0
  407. package/dist/core/tools/renderers/edit.js.map +1 -0
  408. package/dist/core/tools/renderers/find.d.ts +10 -0
  409. package/dist/core/tools/renderers/find.d.ts.map +1 -0
  410. package/dist/core/tools/renderers/find.js +64 -0
  411. package/dist/core/tools/renderers/find.js.map +1 -0
  412. package/dist/core/tools/renderers/grep.d.ts +10 -0
  413. package/dist/core/tools/renderers/grep.d.ts.map +1 -0
  414. package/dist/core/tools/renderers/grep.js +69 -0
  415. package/dist/core/tools/renderers/grep.js.map +1 -0
  416. package/dist/core/tools/renderers/index.d.ts +28 -0
  417. package/dist/core/tools/renderers/index.d.ts.map +1 -0
  418. package/dist/core/tools/renderers/index.js +47 -0
  419. package/dist/core/tools/renderers/index.js.map +1 -0
  420. package/dist/core/tools/renderers/ls.d.ts +10 -0
  421. package/dist/core/tools/renderers/ls.d.ts.map +1 -0
  422. package/dist/core/tools/renderers/ls.js +58 -0
  423. package/dist/core/tools/renderers/ls.js.map +1 -0
  424. package/dist/core/tools/renderers/read.d.ts +11 -0
  425. package/dist/core/tools/renderers/read.d.ts.map +1 -0
  426. package/dist/core/tools/renderers/read.js +130 -0
  427. package/dist/core/tools/renderers/read.js.map +1 -0
  428. package/dist/core/tools/renderers/write.d.ts +10 -0
  429. package/dist/core/tools/renderers/write.d.ts.map +1 -0
  430. package/dist/core/tools/renderers/write.js +153 -0
  431. package/dist/core/tools/renderers/write.js.map +1 -0
  432. package/dist/core/tools/tool-definition-wrapper.d.ts +5 -3
  433. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  434. package/dist/core/tools/tool-definition-wrapper.js +3 -1
  435. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  436. package/dist/core/tools/truncate.d.ts +14 -0
  437. package/dist/core/tools/truncate.d.ts.map +1 -1
  438. package/dist/core/tools/truncate.js +29 -0
  439. package/dist/core/tools/truncate.js.map +1 -1
  440. package/dist/core/tools/write.d.ts +4 -0
  441. package/dist/core/tools/write.d.ts.map +1 -1
  442. package/dist/core/tools/write.js +12 -147
  443. package/dist/core/tools/write.js.map +1 -1
  444. package/dist/core/trust-manager.d.ts.map +1 -1
  445. package/dist/core/trust-manager.js +4 -1
  446. package/dist/core/trust-manager.js.map +1 -1
  447. package/dist/core/usage-totals.d.ts +3 -1
  448. package/dist/core/usage-totals.d.ts.map +1 -1
  449. package/dist/core/usage-totals.js +28 -1
  450. package/dist/core/usage-totals.js.map +1 -1
  451. package/dist/core/virtual-models.d.ts +117 -0
  452. package/dist/core/virtual-models.d.ts.map +1 -0
  453. package/dist/core/virtual-models.js +124 -0
  454. package/dist/core/virtual-models.js.map +1 -0
  455. package/dist/experimental/micro/api.d.ts +81 -0
  456. package/dist/experimental/micro/api.d.ts.map +1 -0
  457. package/dist/experimental/micro/api.js +2 -0
  458. package/dist/experimental/micro/api.js.map +1 -0
  459. package/dist/experimental/micro/main.d.ts +3 -0
  460. package/dist/experimental/micro/main.d.ts.map +1 -0
  461. package/dist/experimental/micro/main.js +21 -0
  462. package/dist/experimental/micro/main.js.map +1 -0
  463. package/dist/experimental/micro/models.d.ts +11 -0
  464. package/dist/experimental/micro/models.d.ts.map +1 -0
  465. package/dist/experimental/micro/models.js +95 -0
  466. package/dist/experimental/micro/models.js.map +1 -0
  467. package/dist/experimental/micro/runtime.d.ts +12 -0
  468. package/dist/experimental/micro/runtime.d.ts.map +1 -0
  469. package/dist/experimental/micro/runtime.js +465 -0
  470. package/dist/experimental/micro/runtime.js.map +1 -0
  471. package/dist/experimental/micro/sessions.d.ts +10 -0
  472. package/dist/experimental/micro/sessions.d.ts.map +1 -0
  473. package/dist/experimental/micro/sessions.js +41 -0
  474. package/dist/experimental/micro/sessions.js.map +1 -0
  475. package/dist/experimental/micro/tools.d.ts +10 -0
  476. package/dist/experimental/micro/tools.d.ts.map +1 -0
  477. package/dist/experimental/micro/tools.js +96 -0
  478. package/dist/experimental/micro/tools.js.map +1 -0
  479. package/dist/experimental/micro/tui.d.ts +3 -0
  480. package/dist/experimental/micro/tui.d.ts.map +1 -0
  481. package/dist/experimental/micro/tui.js +510 -0
  482. package/dist/experimental/micro/tui.js.map +1 -0
  483. package/dist/experimental/mini/main.d.ts +7 -0
  484. package/dist/experimental/mini/main.d.ts.map +1 -0
  485. package/dist/experimental/mini/main.js +21 -0
  486. package/dist/experimental/mini/main.js.map +1 -0
  487. package/dist/experimental/mini/server/entry.d.ts +3 -0
  488. package/dist/experimental/mini/server/entry.d.ts.map +1 -0
  489. package/dist/experimental/mini/server/entry.js +11 -0
  490. package/dist/experimental/mini/server/entry.js.map +1 -0
  491. package/dist/experimental/mini/server/run.d.ts +13 -0
  492. package/dist/experimental/mini/server/run.d.ts.map +1 -0
  493. package/dist/experimental/mini/server/run.js +150 -0
  494. package/dist/experimental/mini/server/run.js.map +1 -0
  495. package/dist/experimental/mini/shared/protocol.d.ts +127 -0
  496. package/dist/experimental/mini/shared/protocol.d.ts.map +1 -0
  497. package/dist/experimental/mini/shared/protocol.js +13 -0
  498. package/dist/experimental/mini/shared/protocol.js.map +1 -0
  499. package/dist/experimental/mini/shared/rpc.d.ts +49 -0
  500. package/dist/experimental/mini/shared/rpc.d.ts.map +1 -0
  501. package/dist/experimental/mini/shared/rpc.js +171 -0
  502. package/dist/experimental/mini/shared/rpc.js.map +1 -0
  503. package/dist/experimental/mini/shared/transport.d.ts +35 -0
  504. package/dist/experimental/mini/shared/transport.d.ts.map +1 -0
  505. package/dist/experimental/mini/shared/transport.js +94 -0
  506. package/dist/experimental/mini/shared/transport.js.map +1 -0
  507. package/dist/experimental/mini/tui/run.d.ts +9 -0
  508. package/dist/experimental/mini/tui/run.d.ts.map +1 -0
  509. package/dist/experimental/mini/tui/run.js +62 -0
  510. package/dist/experimental/mini/tui/run.js.map +1 -0
  511. package/dist/experimental/mini/tui/session.d.ts +26 -0
  512. package/dist/experimental/mini/tui/session.d.ts.map +1 -0
  513. package/dist/experimental/mini/tui/session.js +94 -0
  514. package/dist/experimental/mini/tui/session.js.map +1 -0
  515. package/dist/experimental/mini/tui/view.d.ts +10 -0
  516. package/dist/experimental/mini/tui/view.d.ts.map +1 -0
  517. package/dist/experimental/mini/tui/view.js +461 -0
  518. package/dist/experimental/mini/tui/view.js.map +1 -0
  519. package/dist/experimental/mini/worker/entry.d.ts +3 -0
  520. package/dist/experimental/mini/worker/entry.d.ts.map +1 -0
  521. package/dist/experimental/mini/worker/entry.js +10 -0
  522. package/dist/experimental/mini/worker/entry.js.map +1 -0
  523. package/dist/experimental/mini/worker/lane-service.d.ts +44 -0
  524. package/dist/experimental/mini/worker/lane-service.d.ts.map +1 -0
  525. package/dist/experimental/mini/worker/lane-service.js +97 -0
  526. package/dist/experimental/mini/worker/lane-service.js.map +1 -0
  527. package/dist/experimental/mini/worker/models-service.d.ts +19 -0
  528. package/dist/experimental/mini/worker/models-service.d.ts.map +1 -0
  529. package/dist/experimental/mini/worker/models-service.js +136 -0
  530. package/dist/experimental/mini/worker/models-service.js.map +1 -0
  531. package/dist/experimental/mini/worker/run.d.ts +14 -0
  532. package/dist/experimental/mini/worker/run.d.ts.map +1 -0
  533. package/dist/experimental/mini/worker/run.js +88 -0
  534. package/dist/experimental/mini/worker/run.js.map +1 -0
  535. package/dist/extensions/codemode/execute.d.ts +16 -0
  536. package/dist/extensions/codemode/execute.d.ts.map +1 -0
  537. package/dist/extensions/codemode/execute.js +429 -0
  538. package/dist/extensions/codemode/execute.js.map +1 -0
  539. package/dist/extensions/codemode/execute.lazy.d.ts +3 -0
  540. package/dist/extensions/codemode/execute.lazy.d.ts.map +1 -0
  541. package/dist/extensions/codemode/execute.lazy.js +3 -0
  542. package/dist/extensions/codemode/execute.lazy.js.map +1 -0
  543. package/dist/extensions/codemode/index.d.ts +21 -0
  544. package/dist/extensions/codemode/index.d.ts.map +1 -0
  545. package/dist/extensions/codemode/index.js +31 -0
  546. package/dist/extensions/codemode/index.js.map +1 -0
  547. package/dist/extensions/codemode/renderer.d.ts +12 -0
  548. package/dist/extensions/codemode/renderer.d.ts.map +1 -0
  549. package/dist/extensions/codemode/renderer.js +137 -0
  550. package/dist/extensions/codemode/renderer.js.map +1 -0
  551. package/dist/extensions/codemode/tool.d.ts +123 -0
  552. package/dist/extensions/codemode/tool.d.ts.map +1 -0
  553. package/dist/extensions/codemode/tool.js +315 -0
  554. package/dist/extensions/codemode/tool.js.map +1 -0
  555. package/dist/extensions/codemode/worker.d.ts +7 -0
  556. package/dist/extensions/codemode/worker.d.ts.map +1 -0
  557. package/dist/extensions/codemode/worker.js +7 -0
  558. package/dist/extensions/codemode/worker.js.map +1 -0
  559. package/dist/extensions/index.d.ts.map +1 -1
  560. package/dist/extensions/index.js +9 -1
  561. package/dist/extensions/index.js.map +1 -1
  562. package/dist/extensions/llama/client.d.ts +8 -0
  563. package/dist/extensions/llama/client.d.ts.map +1 -1
  564. package/dist/extensions/llama/client.js +13 -0
  565. package/dist/extensions/llama/client.js.map +1 -1
  566. package/dist/extensions/llama/huggingface.js +2 -0
  567. package/dist/extensions/llama/huggingface.js.map +1 -1
  568. package/dist/extensions/llama/index.d.ts.map +1 -1
  569. package/dist/extensions/llama/index.js +13 -2
  570. package/dist/extensions/llama/index.js.map +1 -1
  571. package/dist/extensions/llama/provider.d.ts +4 -2
  572. package/dist/extensions/llama/provider.d.ts.map +1 -1
  573. package/dist/extensions/llama/provider.js +119 -17
  574. package/dist/extensions/llama/provider.js.map +1 -1
  575. package/dist/extensions/llama/ui.js +28 -12
  576. package/dist/extensions/llama/ui.js.map +1 -1
  577. package/dist/extensions/mcp/cli.d.ts +21 -0
  578. package/dist/extensions/mcp/cli.d.ts.map +1 -0
  579. package/dist/extensions/mcp/cli.js +500 -0
  580. package/dist/extensions/mcp/cli.js.map +1 -0
  581. package/dist/extensions/mcp/cli.lazy.d.ts +3 -0
  582. package/dist/extensions/mcp/cli.lazy.d.ts.map +1 -0
  583. package/dist/extensions/mcp/cli.lazy.js +3 -0
  584. package/dist/extensions/mcp/cli.lazy.js.map +1 -0
  585. package/dist/extensions/mcp/config.d.ts +72 -0
  586. package/dist/extensions/mcp/config.d.ts.map +1 -0
  587. package/dist/extensions/mcp/config.js +158 -0
  588. package/dist/extensions/mcp/config.js.map +1 -0
  589. package/dist/extensions/mcp/index.d.ts +76 -0
  590. package/dist/extensions/mcp/index.d.ts.map +1 -0
  591. package/dist/extensions/mcp/index.js +1055 -0
  592. package/dist/extensions/mcp/index.js.map +1 -0
  593. package/dist/extensions/mcp/log.d.ts +16 -0
  594. package/dist/extensions/mcp/log.d.ts.map +1 -0
  595. package/dist/extensions/mcp/log.js +66 -0
  596. package/dist/extensions/mcp/log.js.map +1 -0
  597. package/dist/extensions/mcp/oauth.d.ts +96 -0
  598. package/dist/extensions/mcp/oauth.d.ts.map +1 -0
  599. package/dist/extensions/mcp/oauth.js +333 -0
  600. package/dist/extensions/mcp/oauth.js.map +1 -0
  601. package/dist/extensions/mcp/resources.d.ts +43 -0
  602. package/dist/extensions/mcp/resources.d.ts.map +1 -0
  603. package/dist/extensions/mcp/resources.js +262 -0
  604. package/dist/extensions/mcp/resources.js.map +1 -0
  605. package/dist/extensions/mcp/runtime.d.ts +98 -0
  606. package/dist/extensions/mcp/runtime.d.ts.map +1 -0
  607. package/dist/extensions/mcp/runtime.js +394 -0
  608. package/dist/extensions/mcp/runtime.js.map +1 -0
  609. package/dist/extensions/mcp/runtime.lazy.d.ts +3 -0
  610. package/dist/extensions/mcp/runtime.lazy.d.ts.map +1 -0
  611. package/dist/extensions/mcp/runtime.lazy.js +3 -0
  612. package/dist/extensions/mcp/runtime.lazy.js.map +1 -0
  613. package/dist/extensions/mcp/tools.d.ts +84 -0
  614. package/dist/extensions/mcp/tools.d.ts.map +1 -0
  615. package/dist/extensions/mcp/tools.js +251 -0
  616. package/dist/extensions/mcp/tools.js.map +1 -0
  617. package/dist/extensions/mcp/ui.d.ts +60 -0
  618. package/dist/extensions/mcp/ui.d.ts.map +1 -0
  619. package/dist/extensions/mcp/ui.js +174 -0
  620. package/dist/extensions/mcp/ui.js.map +1 -0
  621. package/dist/extensions/stub-provider/provider.d.ts +2 -2
  622. package/dist/extensions/stub-provider/provider.d.ts.map +1 -1
  623. package/dist/extensions/stub-provider/provider.js +2 -1
  624. package/dist/extensions/stub-provider/provider.js.map +1 -1
  625. package/dist/extensions/tool-search/index.d.ts +12 -0
  626. package/dist/extensions/tool-search/index.d.ts.map +1 -0
  627. package/dist/extensions/tool-search/index.js +15 -0
  628. package/dist/extensions/tool-search/index.js.map +1 -0
  629. package/dist/extensions/tool-search/tool.d.ts +73 -0
  630. package/dist/extensions/tool-search/tool.d.ts.map +1 -0
  631. package/dist/extensions/tool-search/tool.js +189 -0
  632. package/dist/extensions/tool-search/tool.js.map +1 -0
  633. package/dist/index.d.ts +20 -11
  634. package/dist/index.d.ts.map +1 -1
  635. package/dist/index.js +12 -6
  636. package/dist/index.js.map +1 -1
  637. package/dist/main.d.ts +4 -0
  638. package/dist/main.d.ts.map +1 -1
  639. package/dist/main.js +123 -51
  640. package/dist/main.js.map +1 -1
  641. package/dist/migrations.d.ts +1 -1
  642. package/dist/migrations.js +7 -6
  643. package/dist/migrations.js.map +1 -1
  644. package/dist/modes/index.d.ts +1 -0
  645. package/dist/modes/index.d.ts.map +1 -1
  646. package/dist/modes/index.js.map +1 -1
  647. package/dist/modes/interactive/bug-report.d.ts +19 -0
  648. package/dist/modes/interactive/bug-report.d.ts.map +1 -0
  649. package/dist/modes/interactive/bug-report.js +211 -0
  650. package/dist/modes/interactive/bug-report.js.map +1 -0
  651. package/dist/modes/interactive/chat-viewport.d.ts +20 -0
  652. package/dist/modes/interactive/chat-viewport.d.ts.map +1 -0
  653. package/dist/modes/interactive/chat-viewport.js +28 -0
  654. package/dist/modes/interactive/chat-viewport.js.map +1 -0
  655. package/dist/modes/interactive/components/armin.js +10 -6
  656. package/dist/modes/interactive/components/armin.js.map +1 -1
  657. package/dist/modes/interactive/components/assistant-message.d.ts +6 -2
  658. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  659. package/dist/modes/interactive/components/assistant-message.js +38 -15
  660. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  661. package/dist/modes/interactive/components/bash-execution.js +9 -4
  662. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  663. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  664. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  665. package/dist/modes/interactive/components/branch-summary-message.d.ts +1 -1
  666. package/dist/modes/interactive/components/branch-summary-message.d.ts.map +1 -1
  667. package/dist/modes/interactive/components/branch-summary-message.js +15 -6
  668. package/dist/modes/interactive/components/branch-summary-message.js.map +1 -1
  669. package/dist/modes/interactive/components/compaction-summary-message.d.ts +1 -1
  670. package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +1 -1
  671. package/dist/modes/interactive/components/compaction-summary-message.js +15 -6
  672. package/dist/modes/interactive/components/compaction-summary-message.js.map +1 -1
  673. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  674. package/dist/modes/interactive/components/config-selector.js +35 -8
  675. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  676. package/dist/modes/interactive/components/countdown-timer.js +5 -0
  677. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  678. package/dist/modes/interactive/components/custom-editor.d.ts +10 -1
  679. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  680. package/dist/modes/interactive/components/custom-editor.js +54 -2
  681. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  682. package/dist/modes/interactive/components/custom-entry.js +4 -1
  683. package/dist/modes/interactive/components/custom-entry.js.map +1 -1
  684. package/dist/modes/interactive/components/custom-message.js +7 -1
  685. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  686. package/dist/modes/interactive/components/daxnuts.js +8 -6
  687. package/dist/modes/interactive/components/daxnuts.js.map +1 -1
  688. package/dist/modes/interactive/components/dynamic-border.js +1 -0
  689. package/dist/modes/interactive/components/dynamic-border.js.map +1 -1
  690. package/dist/modes/interactive/components/extension-editor.d.ts +4 -1
  691. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  692. package/dist/modes/interactive/components/extension-editor.js +14 -3
  693. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  694. package/dist/modes/interactive/components/extension-input.d.ts +2 -0
  695. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  696. package/dist/modes/interactive/components/extension-input.js +14 -2
  697. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  698. package/dist/modes/interactive/components/extension-selector.d.ts +1 -0
  699. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  700. package/dist/modes/interactive/components/extension-selector.js +16 -1
  701. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  702. package/dist/modes/interactive/components/first-time-setup.d.ts +4 -4
  703. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -1
  704. package/dist/modes/interactive/components/first-time-setup.js +12 -4
  705. package/dist/modes/interactive/components/first-time-setup.js.map +1 -1
  706. package/dist/modes/interactive/components/footer.d.ts +7 -0
  707. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  708. package/dist/modes/interactive/components/footer.js +51 -6
  709. package/dist/modes/interactive/components/footer.js.map +1 -1
  710. package/dist/modes/interactive/components/index.d.ts +1 -1
  711. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  712. package/dist/modes/interactive/components/index.js.map +1 -1
  713. package/dist/modes/interactive/components/login-dialog.js +9 -3
  714. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  715. package/dist/modes/interactive/components/markdown-transform.d.ts +3 -0
  716. package/dist/modes/interactive/components/markdown-transform.d.ts.map +1 -0
  717. package/dist/modes/interactive/components/markdown-transform.js +19 -0
  718. package/dist/modes/interactive/components/markdown-transform.js.map +1 -0
  719. package/dist/modes/interactive/components/mermaid.d.ts +11 -0
  720. package/dist/modes/interactive/components/mermaid.d.ts.map +1 -0
  721. package/dist/modes/interactive/components/mermaid.js +75 -0
  722. package/dist/modes/interactive/components/mermaid.js.map +1 -0
  723. package/dist/modes/interactive/components/model-selector.d.ts +10 -4
  724. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  725. package/dist/modes/interactive/components/model-selector.js +101 -40
  726. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  727. package/dist/modes/interactive/components/oauth-selector.js +11 -3
  728. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  729. package/dist/modes/interactive/components/scoped-models-selector.d.ts +4 -0
  730. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  731. package/dist/modes/interactive/components/scoped-models-selector.js +60 -32
  732. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  733. package/dist/modes/interactive/components/session-selector.d.ts +5 -5
  734. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  735. package/dist/modes/interactive/components/session-selector.js +128 -78
  736. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  737. package/dist/modes/interactive/components/settings-selector.d.ts +23 -4
  738. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  739. package/dist/modes/interactive/components/settings-selector.js +230 -67
  740. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  741. package/dist/modes/interactive/components/settings-submenu.d.ts +72 -0
  742. package/dist/modes/interactive/components/settings-submenu.d.ts.map +1 -0
  743. package/dist/modes/interactive/components/settings-submenu.js +165 -0
  744. package/dist/modes/interactive/components/settings-submenu.js.map +1 -0
  745. package/dist/modes/interactive/components/show-images-selector.js +1 -0
  746. package/dist/modes/interactive/components/show-images-selector.js.map +1 -1
  747. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  748. package/dist/modes/interactive/components/skill-invocation-message.js +14 -5
  749. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  750. package/dist/modes/interactive/components/status-indicator.d.ts +3 -1
  751. package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -1
  752. package/dist/modes/interactive/components/status-indicator.js +12 -3
  753. package/dist/modes/interactive/components/status-indicator.js.map +1 -1
  754. package/dist/modes/interactive/components/theme-selector.js +2 -0
  755. package/dist/modes/interactive/components/theme-selector.js.map +1 -1
  756. package/dist/modes/interactive/components/themed-text.d.ts +17 -0
  757. package/dist/modes/interactive/components/themed-text.d.ts.map +1 -0
  758. package/dist/modes/interactive/components/themed-text.js +29 -0
  759. package/dist/modes/interactive/components/themed-text.js.map +1 -0
  760. package/dist/modes/interactive/components/thinking-selector.d.ts +15 -3
  761. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  762. package/dist/modes/interactive/components/thinking-selector.js +76 -18
  763. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  764. package/dist/modes/interactive/components/tool-execution.d.ts +21 -4
  765. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  766. package/dist/modes/interactive/components/tool-execution.js +78 -52
  767. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  768. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  769. package/dist/modes/interactive/components/tree-selector.js +44 -18
  770. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  771. package/dist/modes/interactive/components/trust-selector.js +8 -2
  772. package/dist/modes/interactive/components/trust-selector.js.map +1 -1
  773. package/dist/modes/interactive/components/user-message-selector.js +6 -3
  774. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  775. package/dist/modes/interactive/components/user-message.d.ts +3 -1
  776. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  777. package/dist/modes/interactive/components/user-message.js +12 -2
  778. package/dist/modes/interactive/components/user-message.js.map +1 -1
  779. package/dist/modes/interactive/components/visual-truncate.d.ts +27 -3
  780. package/dist/modes/interactive/components/visual-truncate.d.ts.map +1 -1
  781. package/dist/modes/interactive/components/visual-truncate.js +39 -6
  782. package/dist/modes/interactive/components/visual-truncate.js.map +1 -1
  783. package/dist/modes/interactive/external-editor.d.ts.map +1 -1
  784. package/dist/modes/interactive/external-editor.js +2 -1
  785. package/dist/modes/interactive/external-editor.js.map +1 -1
  786. package/dist/modes/interactive/interactive-mode.d.ts +69 -5
  787. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  788. package/dist/modes/interactive/interactive-mode.js +1314 -593
  789. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  790. package/dist/modes/interactive/model-catalog-refresh.d.ts +7 -0
  791. package/dist/modes/interactive/model-catalog-refresh.d.ts.map +1 -0
  792. package/dist/modes/interactive/model-catalog-refresh.js +34 -0
  793. package/dist/modes/interactive/model-catalog-refresh.js.map +1 -0
  794. package/dist/modes/interactive/session-share.d.ts +23 -0
  795. package/dist/modes/interactive/session-share.d.ts.map +1 -0
  796. package/dist/modes/interactive/session-share.js +130 -0
  797. package/dist/modes/interactive/session-share.js.map +1 -0
  798. package/dist/modes/interactive/theme/dark.json +54 -63
  799. package/dist/modes/interactive/theme/light.json +52 -60
  800. package/dist/modes/interactive/theme/system-theme.d.ts +54 -0
  801. package/dist/modes/interactive/theme/system-theme.d.ts.map +1 -0
  802. package/dist/modes/interactive/theme/system-theme.js +535 -0
  803. package/dist/modes/interactive/theme/system-theme.js.map +1 -0
  804. package/dist/modes/interactive/theme/theme-controller.d.ts +59 -7
  805. package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -1
  806. package/dist/modes/interactive/theme/theme-controller.js +164 -51
  807. package/dist/modes/interactive/theme/theme-controller.js.map +1 -1
  808. package/dist/modes/interactive/theme/theme-json.d.ts +85 -0
  809. package/dist/modes/interactive/theme/theme-json.d.ts.map +1 -0
  810. package/dist/modes/interactive/theme/theme-json.js +132 -0
  811. package/dist/modes/interactive/theme/theme-json.js.map +1 -0
  812. package/dist/modes/interactive/theme/theme-schema.json +24 -3
  813. package/dist/modes/interactive/theme/theme.d.ts +80 -42
  814. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  815. package/dist/modes/interactive/theme/theme.js +274 -417
  816. package/dist/modes/interactive/theme/theme.js.map +1 -1
  817. package/dist/modes/interactive/tui-renderer.d.ts +22 -0
  818. package/dist/modes/interactive/tui-renderer.d.ts.map +1 -0
  819. package/dist/modes/interactive/tui-renderer.js +67 -0
  820. package/dist/modes/interactive/tui-renderer.js.map +1 -0
  821. package/dist/modes/json-event.d.ts +34 -0
  822. package/dist/modes/json-event.d.ts.map +1 -0
  823. package/dist/modes/json-event.js +29 -0
  824. package/dist/modes/json-event.js.map +1 -0
  825. package/dist/modes/print-mode.d.ts +1 -1
  826. package/dist/modes/print-mode.d.ts.map +1 -1
  827. package/dist/modes/print-mode.js +12 -2
  828. package/dist/modes/print-mode.js.map +1 -1
  829. package/dist/modes/rpc/rpc-client.d.ts +17 -9
  830. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  831. package/dist/modes/rpc/rpc-client.js +27 -15
  832. package/dist/modes/rpc/rpc-client.js.map +1 -1
  833. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  834. package/dist/modes/rpc/rpc-mode.js +14 -12
  835. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  836. package/dist/modes/rpc/rpc-types.d.ts +22 -1
  837. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  838. package/dist/modes/rpc/rpc-types.js.map +1 -1
  839. package/dist/package-manager-cli.d.ts +1 -0
  840. package/dist/package-manager-cli.d.ts.map +1 -1
  841. package/dist/package-manager-cli.js +217 -63
  842. package/dist/package-manager-cli.js.map +1 -1
  843. package/dist/prompts/commands/plan-phase.md +1 -0
  844. package/dist/prompts/commands/review.md +2 -0
  845. package/dist/prompts/commands/verify-work.md +1 -0
  846. package/dist/prompts/commands/why.md +4 -0
  847. package/dist/rpc-entry.js +1 -0
  848. package/dist/rpc-entry.js.map +1 -1
  849. package/dist/skills/blast-radius/SKILL.md +1 -0
  850. package/dist/skills/explainers/SKILL.md +65 -0
  851. package/dist/skills/unslop/SKILL.md +19 -1
  852. package/dist/utils/abort.d.ts +5 -0
  853. package/dist/utils/abort.d.ts.map +1 -0
  854. package/dist/utils/abort.js +48 -0
  855. package/dist/utils/abort.js.map +1 -0
  856. package/dist/utils/changelog.js +1 -1
  857. package/dist/utils/changelog.js.map +1 -1
  858. package/dist/utils/child-process.d.ts +1 -1
  859. package/dist/utils/child-process.js +1 -1
  860. package/dist/utils/child-process.js.map +1 -1
  861. package/dist/utils/clipboard-command.d.ts +7 -0
  862. package/dist/utils/clipboard-command.d.ts.map +1 -0
  863. package/dist/utils/clipboard-command.js +45 -0
  864. package/dist/utils/clipboard-command.js.map +1 -0
  865. package/dist/utils/clipboard-image.d.ts.map +1 -1
  866. package/dist/utils/clipboard-image.js +60 -91
  867. package/dist/utils/clipboard-image.js.map +1 -1
  868. package/dist/utils/clipboard.d.ts +2 -0
  869. package/dist/utils/clipboard.d.ts.map +1 -1
  870. package/dist/utils/clipboard.js +116 -121
  871. package/dist/utils/clipboard.js.map +1 -1
  872. package/dist/utils/draht-user-agent.d.ts +2 -0
  873. package/dist/utils/draht-user-agent.d.ts.map +1 -0
  874. package/dist/utils/draht-user-agent.js +5 -0
  875. package/dist/utils/draht-user-agent.js.map +1 -0
  876. package/dist/utils/exif-orientation.d.ts +2 -1
  877. package/dist/utils/exif-orientation.d.ts.map +1 -1
  878. package/dist/utils/exif-orientation.js.map +1 -1
  879. package/dist/utils/frontmatter.d.ts.map +1 -1
  880. package/dist/utils/frontmatter.js +2 -1
  881. package/dist/utils/frontmatter.js.map +1 -1
  882. package/dist/utils/management-http.d.ts +25 -0
  883. package/dist/utils/management-http.d.ts.map +1 -0
  884. package/dist/utils/management-http.js +54 -0
  885. package/dist/utils/management-http.js.map +1 -0
  886. package/dist/utils/mime.js +1 -1
  887. package/dist/utils/mime.js.map +1 -1
  888. package/dist/utils/paths.d.ts +4 -3
  889. package/dist/utils/paths.d.ts.map +1 -1
  890. package/dist/utils/paths.js +15 -4
  891. package/dist/utils/paths.js.map +1 -1
  892. package/dist/utils/photon.d.ts +2 -1
  893. package/dist/utils/photon.d.ts.map +1 -1
  894. package/dist/utils/photon.js.map +1 -1
  895. package/dist/utils/shell.d.ts +4 -3
  896. package/dist/utils/shell.d.ts.map +1 -1
  897. package/dist/utils/shell.js +20 -35
  898. package/dist/utils/shell.js.map +1 -1
  899. package/dist/utils/syntax-highlight.d.ts +1 -0
  900. package/dist/utils/syntax-highlight.d.ts.map +1 -1
  901. package/dist/utils/syntax-highlight.js +62 -1
  902. package/dist/utils/syntax-highlight.js.map +1 -1
  903. package/dist/utils/text.d.ts +8 -0
  904. package/dist/utils/text.d.ts.map +1 -0
  905. package/dist/utils/text.js +9 -0
  906. package/dist/utils/text.js.map +1 -0
  907. package/dist/utils/tool-result-images.d.ts +21 -0
  908. package/dist/utils/tool-result-images.d.ts.map +1 -0
  909. package/dist/utils/tool-result-images.js +48 -0
  910. package/dist/utils/tool-result-images.js.map +1 -0
  911. package/dist/utils/tools-manager.d.ts +11 -1
  912. package/dist/utils/tools-manager.d.ts.map +1 -1
  913. package/dist/utils/tools-manager.js +53 -36
  914. package/dist/utils/tools-manager.js.map +1 -1
  915. package/dist/utils/version-check.d.ts +4 -1
  916. package/dist/utils/version-check.d.ts.map +1 -1
  917. package/dist/utils/version-check.js +30 -9
  918. package/dist/utils/version-check.js.map +1 -1
  919. package/dist/utils/wsl.d.ts +3 -0
  920. package/dist/utils/wsl.d.ts.map +1 -0
  921. package/dist/utils/wsl.js +15 -0
  922. package/dist/utils/wsl.js.map +1 -0
  923. package/dist/utils/zip.d.ts +7 -0
  924. package/dist/utils/zip.d.ts.map +1 -0
  925. package/dist/utils/zip.js +60 -0
  926. package/dist/utils/zip.js.map +1 -0
  927. package/docs/cli-integration.md +106 -0
  928. package/docs/cli.md +374 -0
  929. package/docs/compaction.md +91 -29
  930. package/docs/configuration.md +47 -0
  931. package/docs/containerization.md +100 -66
  932. package/docs/custom-provider.md +109 -707
  933. package/docs/docs.json +155 -99
  934. package/docs/environment-variables.md +30 -17
  935. package/docs/extensions.md +169 -2811
  936. package/docs/how-pi-works.md +53 -0
  937. package/docs/images/interactive-mode.png +0 -0
  938. package/docs/index.md +25 -69
  939. package/docs/json.md +197 -56
  940. package/docs/keybindings.md +89 -93
  941. package/docs/llama-cpp.md +18 -3
  942. package/docs/mcp.md +231 -0
  943. package/docs/message-types.md +261 -0
  944. package/docs/models.md +94 -478
  945. package/docs/packages.md +67 -163
  946. package/docs/prompt-templates.md +31 -68
  947. package/docs/providers.md +118 -215
  948. package/docs/quickstart.md +55 -108
  949. package/docs/rpc-commands.md +860 -0
  950. package/docs/rpc-extension-ui.md +200 -0
  951. package/docs/rpc.md +139 -1518
  952. package/docs/sdk.md +79 -1127
  953. package/docs/security.md +76 -32
  954. package/docs/session-format.md +73 -219
  955. package/docs/sessions.md +36 -116
  956. package/docs/settings.md +124 -257
  957. package/docs/shell-aliases.md +85 -5
  958. package/docs/skills.md +52 -189
  959. package/docs/slash-commands.md +61 -0
  960. package/docs/terminal-setup.md +132 -61
  961. package/docs/termux.md +74 -84
  962. package/docs/themes.md +91 -252
  963. package/docs/tmux.md +31 -39
  964. package/docs/tui.md +74 -891
  965. package/docs/usage.md +54 -255
  966. package/docs/virtual-models.md +114 -0
  967. package/docs/windows.md +57 -7
  968. package/examples/extensions/antigravity-image-gen.ts +9 -9
  969. package/examples/extensions/bash-spawn-hook.ts +1 -1
  970. package/examples/extensions/border-status-editor.ts +1 -1
  971. package/examples/extensions/built-in-tool-renderer.ts +16 -40
  972. package/examples/extensions/custom-compaction.ts +1 -16
  973. package/examples/extensions/custom-provider-anthropic/index.ts +20 -13
  974. package/examples/extensions/custom-provider-gitlab-duo/index.ts +4 -3
  975. package/examples/extensions/custom-provider-gitlab-duo/test.ts +5 -5
  976. package/examples/extensions/debug-provider.ts +90 -0
  977. package/examples/extensions/doom-overlay/wad-finder.ts +7 -3
  978. package/examples/extensions/dynamic-resources/dynamic.json +3 -1
  979. package/examples/extensions/git-checkpoint.ts +2 -2
  980. package/examples/extensions/handoff.ts +2 -11
  981. package/examples/extensions/jev-router.ts +113 -0
  982. package/examples/extensions/minimal-mode.ts +24 -96
  983. package/examples/extensions/notify.ts +3 -1
  984. package/examples/extensions/prompt-customizer.ts +19 -67
  985. package/examples/extensions/qna.ts +3 -7
  986. package/examples/extensions/subagent/agents.ts +40 -9
  987. package/examples/extensions/subagent/index.ts +27 -4
  988. package/examples/extensions/summarize.ts +7 -18
  989. package/examples/extensions/titlebar-spinner.ts +1 -1
  990. package/examples/rpc-client.ts +35 -0
  991. package/examples/rpc-extension-ui.ts +38 -9
  992. package/examples/sdk/02-custom-model.ts +1 -2
  993. package/examples/sdk/06-extensions.ts +1 -1
  994. package/examples/sdk/09-api-keys-and-oauth.ts +1 -1
  995. package/examples/sdk/12-full-control.ts +1 -1
  996. package/examples/sdk/14-codemode-mcp.ts +61 -0
  997. package/package.json +25 -30
  998. package/prompts/commands/plan-phase.md +1 -0
  999. package/prompts/commands/review.md +2 -0
  1000. package/prompts/commands/verify-work.md +1 -0
  1001. package/prompts/commands/why.md +4 -0
  1002. package/skills/blast-radius/SKILL.md +1 -0
  1003. package/skills/explainers/SKILL.md +65 -0
  1004. package/skills/unslop/SKILL.md +19 -1
  1005. package/dist/utils/clipboard-native.d.ts +0 -11
  1006. package/dist/utils/clipboard-native.d.ts.map +0 -1
  1007. package/dist/utils/clipboard-native.js +0 -20
  1008. package/dist/utils/clipboard-native.js.map +0 -1
  1009. package/dist/utils/pi-user-agent.d.ts +0 -2
  1010. package/dist/utils/pi-user-agent.d.ts.map +0 -1
  1011. package/dist/utils/pi-user-agent.js +0 -5
  1012. package/dist/utils/pi-user-agent.js.map +0 -1
  1013. package/docs/development.md +0 -71
  1014. package/docs/tree.md +0 -231
  1015. package/examples/extensions/kimi-deferred-tools.ts +0 -61
package/docs/models.md CHANGED
@@ -1,546 +1,162 @@
1
- # Custom Models
1
+ # Choose a Model
2
2
 
3
- Add custom providers and models (Ollama, vLLM, LM Studio, proxies) via `~/.draht/agent/models.json`.
3
+ For a built-in provider, start with `/login`, then choose a model with `/model`. Use custom model configuration only when draht does not already include the provider or endpoint you need.
4
4
 
5
- ## Table of Contents
5
+ ## Choose a connection
6
6
 
7
- - [Minimal Example](#minimal-example)
8
- - [Full Example](#full-example)
9
- - [Supported APIs](#supported-apis)
10
- - [Provider Configuration](#provider-configuration)
11
- - [Model Configuration](#model-configuration)
12
- - [Overriding Built-in Providers](#overriding-built-in-providers)
13
- - [Per-model Overrides](#per-model-overrides)
14
- - [Anthropic Messages Compatibility](#anthropic-messages-compatibility)
15
- - [OpenAI Compatibility](#openai-compatibility)
7
+ | What you have | Recommended setup |
8
+ |---|---|
9
+ | A supported subscription | Sign in through `/login` |
10
+ | A provider API key | Store it through `/login` or set its environment variable |
11
+ | A local GGUF model | Connect draht to the llama.cpp router |
12
+ | An OpenAI-, Anthropic-, or Google-compatible endpoint | Add it to `models.json` |
13
+ | A provider with a custom protocol or authentication flow | Build or install a provider extension |
16
14
 
17
- ## Minimal Example
15
+ Run `draht --list-models [search]` to list available providers and model IDs. draht starts with its bundled catalog. A remote catalog overlay is off by default; set `DRAHT_MODEL_CATALOG_BASE_URL` to a self-hosted catalog endpoint to enable it. Cached catalog data remains available offline; with an overlay configured, run `draht update --models` to force a refresh.
18
16
 
19
- For local models (Ollama, LM Studio, vLLM), only `id` is required per model:
17
+ ## Authenticate
20
18
 
21
- ```json
22
- {
23
- "providers": {
24
- "ollama": {
25
- "baseUrl": "http://localhost:11434/v1",
26
- "api": "openai-completions",
27
- "apiKey": "ollama",
28
- "models": [
29
- { "id": "llama3.1:8b" },
30
- { "id": "qwen2.5-coder:7b" }
31
- ]
32
- }
33
- }
34
- }
35
- ```
19
+ Run `/login` and select a provider. draht stores credentials in [`auth.json`](configuration.md#agent-directory). Run `/logout` to remove stored credentials for a provider.
36
20
 
37
- The `apiKey` is required but Ollama ignores it, so any value works.
21
+ You can instead provide an API key through the provider's environment variable. This is useful in CI and other environments where draht should not write credentials. [Provider Authentication](providers.md) lists the variables and cloud-provider setup.
38
22
 
39
- Some OpenAI-compatible servers do not understand the `developer` role used for reasoning-capable models. For those providers, set `compat.supportsDeveloperRole` to `false` so draht sends the system prompt as a `system` message instead. If the server also does not support `reasoning_effort`, set `compat.supportsReasoningEffort` to `false` too.
23
+ When several credential sources are configured, draht uses a runtime `--api-key` first, then a stored `auth.json` credential, an `apiKey` from `models.json`, and finally the provider's environment variables or ambient cloud credentials. Provider extensions can define their own authentication behavior.
40
24
 
41
- You can set `compat` at the provider level to apply to all models, or at the model level to override a specific model. This commonly applies to Ollama, vLLM, SGLang, and similar OpenAI-compatible servers.
25
+ Keep `auth.json` and any credential commands private. Project settings and extensions can execute inside the draht process after you trust a project. Review [Security](security.md) before loading configuration from an untrusted directory.
42
26
 
43
- ```json
44
- {
45
- "providers": {
46
- "ollama": {
47
- "baseUrl": "http://localhost:11434/v1",
48
- "api": "openai-completions",
49
- "apiKey": "ollama",
50
- "compat": {
51
- "supportsDeveloperRole": false,
52
- "supportsReasoningEffort": false
53
- },
54
- "models": [
55
- {
56
- "id": "gpt-oss:20b",
57
- "reasoning": true
58
- }
59
- ]
60
- }
61
- }
62
- }
63
- ```
64
-
65
- ## Full Example
27
+ ## Select a model
66
28
 
67
- Override defaults when you need specific values:
29
+ Run `/model` to search available models. The picker shows models whose providers have usable authentication. Press `Ctrl+S` on a model to save it as the default for new sessions.
68
30
 
69
- ```json
70
- {
71
- "providers": {
72
- "ollama": {
73
- "baseUrl": "http://localhost:11434/v1",
74
- "api": "openai-completions",
75
- "apiKey": "ollama",
76
- "models": [
77
- {
78
- "id": "llama3.1:8b",
79
- "name": "Llama 3.1 8B (Local)",
80
- "reasoning": false,
81
- "input": ["text"],
82
- "contextWindow": 128000,
83
- "maxTokens": 32000,
84
- "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
85
- }
86
- ]
87
- }
88
- }
89
- }
90
- ```
31
+ Run `/thinking` to select the thinking level for the current model. Press `Ctrl+S` there to save the startup level. draht limits the choices to levels supported by the selected model.
91
32
 
92
- The file reloads each time you open `/model`. Edit during session; no restart needed.
33
+ `Ctrl+P` cycles through available models. Use `/scoped-models` to control that cycle and save the selection, or configure model patterns through [Settings](settings.md#model-cycling).
93
34
 
94
- ## Google AI Studio Example
35
+ A session records model and thinking-level changes. Resuming the session restores them without changing defaults for new sessions.
95
36
 
96
- Use `google-generative-ai` with a `baseUrl` to add models from Google AI Studio, including custom Gemma 4 entries:
37
+ In interactive mode, direct OpenAI GPT-5.4, GPT-5.5, and GPT-5.6 Sol/Terra/Luna can switch between their 272K standard and 1.05M extended windows without editing `models.json`. OpenAI Codex GPT-5.6 Sol/Terra/Luna can switch between the 372K catalog default and 1.05M. Press `Ctrl+Shift+L` by default, or customize the `app.context.cycle` action in [`keybindings.json`](keybindings.md).
97
38
 
98
- ```json
99
- {
100
- "providers": {
101
- "my-google": {
102
- "baseUrl": "https://generativelanguage.googleapis.com/v1beta",
103
- "api": "google-generative-ai",
104
- "apiKey": "$GEMINI_API_KEY",
105
- "models": [
106
- {
107
- "id": "gemma-4-31b-it",
108
- "name": "Gemma 4 31B",
109
- "input": ["text", "image"],
110
- "contextWindow": 262144,
111
- "reasoning": true
112
- }
113
- ]
114
- }
115
- }
116
- }
117
- ```
118
-
119
- The `baseUrl` is required when adding custom models to the `google-generative-ai` API type.
120
-
121
- ## Supported APIs
122
-
123
- | API | Description |
124
- |-----|-------------|
125
- | `openai-completions` | OpenAI Chat Completions (most compatible) |
126
- | `openai-responses` | OpenAI Responses API |
127
- | `anthropic-messages` | Anthropic Messages API |
128
- | `google-generative-ai` | Google Generative AI |
129
-
130
- Set `api` at provider level (default for all models) or model level (override per model).
131
-
132
- ## Provider Configuration
133
-
134
- | Field | Description |
135
- |-------|-------------|
136
- | `baseUrl` | API endpoint URL |
137
- | `api` | API type (see above) |
138
- | `apiKey` | API key (see value resolution below) |
139
- | `headers` | Custom headers (see value resolution below) |
140
- | `authHeader` | Set `true` to add `Authorization: Bearer <apiKey>` automatically |
141
- | `models` | Array of model configurations |
142
- | `modelOverrides` | Per-model overrides for built-in or extension-registered models on this provider |
143
-
144
- ### Value Resolution
145
-
146
- The `apiKey` and `headers` fields support command execution, environment interpolation, and literals:
39
+ The selected window is stored in the session. Switching to a smaller window prompts for compaction when the current context would not fit. Long-context pricing metadata remains active, and the interactive status message shows the input threshold where higher pricing begins.
147
40
 
148
- - **Shell command:** `"!command"` at the start executes the whole value as a command and uses stdout
149
- ```json
150
- "apiKey": "!security find-generic-password -ws 'anthropic'"
151
- "apiKey": "!op read 'op://vault/item/credential'"
152
- ```
153
- - **Environment interpolation:** `"$ENV_VAR"` or `"${ENV_VAR}"` uses the value of the named variable. Interpolation works inside larger literals.
154
- ```json
155
- "apiKey": "$MY_API_KEY"
156
- "apiKey": "${KEY_PREFIX}_${KEY_SUFFIX}"
157
- ```
158
- `$FOO_BAR` is the variable `FOO_BAR`; use `${FOO}_BAR` when `BAR` is literal text. Missing environment variables make the value unresolved.
159
- - **Escapes:** `"$$"` emits a literal `"$"`; `"$!"` emits a literal `"!"` without triggering command execution.
160
- ```json
161
- "apiKey": "$$literal-dollar-prefix"
162
- "apiKey": "$!literal-bang-prefix"
163
- ```
164
- - **Literal value:** Used directly
165
- ```json
166
- "apiKey": "sk-..."
167
- ```
41
+ ## Connect local models
168
42
 
169
- Legacy uppercase env-var-like values such as `MY_API_KEY` are migrated to `$MY_API_KEY` on startup.
43
+ draht integrates directly with the llama.cpp router. The router discovers GGUF files and loads models on demand. draht's `/llama` command manages the router, while `/model` selects one of its loaded models.
170
44
 
171
- For `models.json`, shell commands are resolved at request time. draht intentionally does not apply built-in TTL, stale reuse, or recovery logic for arbitrary commands. Different commands need different caching and failure strategies, and draht cannot infer the right one.
45
+ Follow [Local Models with llama.cpp](llama-cpp.md) for server startup, model layout, downloads, and connection troubleshooting.
172
46
 
173
- If your command is slow, expensive, rate-limited, or should keep using a previous value on transient failures, wrap it in your own script or command that implements the caching or TTL behavior you want.
47
+ For Ollama, LM Studio, vLLM, SGLang, and other compatible servers, [configure a compatible endpoint](#configure-a-compatible-endpoint) in `models.json`.
174
48
 
175
- `/model` availability checks use configured auth presence and do not execute shell commands.
49
+ ## Configure a compatible endpoint
176
50
 
177
- ### Custom Headers
51
+ Use [`models.json`](configuration.md#agent-directory) when an endpoint speaks an API draht already supports. This includes most Ollama, LM Studio, vLLM, SGLang, and proxy deployments.
178
52
 
179
53
  ```json
180
54
  {
181
55
  "providers": {
182
- "custom-proxy": {
183
- "baseUrl": "https://proxy.example.com/v1",
184
- "apiKey": "$MY_API_KEY",
185
- "api": "anthropic-messages",
186
- "headers": {
187
- "x-portkey-api-key": "$PORTKEY_API_KEY",
188
- "x-secret": "!op read 'op://vault/item/secret'"
189
- },
190
- "models": [...]
56
+ "ollama": {
57
+ "baseUrl": "http://localhost:11434/v1",
58
+ "api": "openai-completions",
59
+ "apiKey": "ollama",
60
+ "models": [
61
+ { "id": "qwen2.5-coder:7b" }
62
+ ]
191
63
  }
192
64
  }
193
65
  }
194
66
  ```
195
67
 
196
- ## Model Configuration
197
-
198
- | Field | Required | Default | Description |
199
- |-------|----------|---------|-------------|
200
- | `id` | Yes | — | Model identifier (passed to the API) |
201
- | `name` | No | `id` | Human-readable model label. Used for matching (`--model` patterns) and shown as secondary model detail text. |
202
- | `api` | No | provider's `api` | Override provider's API for this model |
203
- | `reasoning` | No | `false` | Supports extended thinking |
204
- | `thinkingLevelMap` | No | omitted | Maps draht thinking levels to provider values and marks unsupported levels (see below) |
205
- | `input` | No | `["text"]` | Input types: `["text"]` or `["text", "image"]` |
206
- | `contextWindow` | No | `128000` | Context window size in tokens |
207
- | `maxTokens` | No | `16384` | Maximum output tokens |
208
- | `cost` | No | all zeros | Per-million-token rates with optional request-wide input pricing tiers |
209
- | `compat` | No | provider `compat` | Provider compatibility overrides. Merged with provider-level `compat` when both are set. |
210
-
211
- A cost tier supplies a complete alternate rate set and applies to the full request when total input usage (`input + cacheRead + cacheWrite`) exceeds `inputTokensAbove`. When multiple tiers match, the highest threshold wins.
212
-
213
- ```json
214
- {
215
- "cost": {
216
- "input": 5,
217
- "output": 30,
218
- "cacheRead": 0.5,
219
- "cacheWrite": 6.25,
220
- "tiers": [
221
- {
222
- "inputTokensAbove": 272000,
223
- "input": 10,
224
- "output": 45,
225
- "cacheRead": 1,
226
- "cacheWrite": 12.5
227
- }
228
- ]
229
- }
230
- }
231
- ```
232
-
233
- Current behavior:
234
- - `/model`, `--list-models`, and the interactive footer display entries by model `id`.
235
- - The configured `name` is used for model matching and secondary model detail text. It does not replace the footer/status-bar model id.
68
+ The dummy key makes the model available to draht; Ollama ignores it. For an authenticated endpoint, `apiKey` and header values can use `$NAME` or `${NAME}` environment interpolation, a literal value, or a leading `!command`. Commands in `models.json` run at request time and are not cached by draht.
236
69
 
237
- ### Thinking Level Map
70
+ Opening `/model` reloads the file. A `models` entry adds or replaces a model with the same ID on that provider. Use `modelOverrides` to change metadata for an existing built-in or extension-provided model without replacing the provider's model list. Unknown override IDs are ignored.
238
71
 
239
- Use `thinkingLevelMap` on a model to describe model-specific thinking controls. Keys are draht thinking levels: `off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`. Maps may contain holes; for example, a model can expose `high` and `max` without exposing `xhigh`.
72
+ ### Describe model input and caching
240
73
 
241
- Values are tristate:
242
-
243
- | Value | Meaning |
244
- |-------|---------|
245
- | omitted | Standard levels through `high` use the provider's default mapping; extended `xhigh` and `max` levels are unsupported |
246
- | string | Level is supported and this value is sent to the provider |
247
- | `null` | Level is unsupported and hidden/skipped/clamped away |
248
-
249
- Example for a model that only supports off, high, and max reasoning:
74
+ Use `inputLimits.images.resize` to control how draht encodes new image attachments, `read` results, and tool-result images before storing them in conversation history:
250
75
 
251
76
  ```json
252
77
  {
253
- "id": "deepseek-v4-pro",
254
- "reasoning": true,
255
- "thinkingLevelMap": {
256
- "minimal": null,
257
- "low": null,
258
- "medium": null,
259
- "high": "high",
260
- "xhigh": null,
261
- "max": "max"
262
- }
263
- }
264
- ```
265
-
266
- Example for a model where thinking cannot be disabled:
267
-
268
- ```json
269
- {
270
- "id": "always-thinking-model",
271
- "reasoning": true,
272
- "thinkingLevelMap": {
273
- "off": null
274
- }
275
- }
276
- ```
277
-
278
- Migration: older configs that used `compat.reasoningEffortMap` should move that mapping to model-level `thinkingLevelMap`. Use `null` for levels that should not appear in the UI.
279
-
280
- ## Overriding Built-in Providers
281
-
282
- Route a built-in provider through a proxy without redefining models:
283
-
284
- ```json
285
- {
286
- "providers": {
287
- "anthropic": {
288
- "baseUrl": "https://my-proxy.example.com/v1"
289
- }
290
- }
291
- }
292
- ```
293
-
294
- All built-in Anthropic models remain available. Existing OAuth or API key auth continues to work.
295
-
296
- To merge custom models into a built-in provider, include the `models` array:
297
-
298
- ```json
299
- {
300
- "providers": {
301
- "anthropic": {
302
- "baseUrl": "https://my-proxy.example.com/v1",
303
- "apiKey": "$ANTHROPIC_API_KEY",
304
- "api": "anthropic-messages",
305
- "models": [...]
78
+ "id": "vision-model",
79
+ "input": ["text", "image"],
80
+ "inputLimits": {
81
+ "images": {
82
+ "resize": {
83
+ "maxWidth": 1568,
84
+ "maxHeight": 1568,
85
+ "maxBytes": 524288,
86
+ "jpegQuality": 75
87
+ }
306
88
  }
307
89
  }
308
90
  }
309
91
  ```
310
92
 
311
- Merge semantics:
312
- - Built-in models are kept.
313
- - Custom models are upserted by `id` within the provider.
314
- - If a custom model `id` matches a built-in model `id`, the custom model replaces that built-in model.
315
- - If a custom model `id` is new, it is added alongside built-in models.
93
+ `maxBytes` limits the base64-encoded payload. Omitted resize fields use conservative defaults of 2000 by 2000 pixels, 4.5 MiB encoded, and JPEG quality 80. Images are encoded once; changing models does not rewrite historical images. The catalog can also describe hard request limits with `inputLimits.maxRequestBytes`, `images.maxPerMessage`, and `images.maxPerRequest`, but draht does not yet rewrite or reject history based on them.
316
94
 
317
- ## Per-model Overrides
95
+ <a id="prompt-cache-lifetimes"></a>
318
96
 
319
- Use `modelOverrides` to customize built-in models and matching extension-registered models without replacing the provider's full model list.
97
+ Use `promptCache` to declare the provider's best-effort cache lifetime in seconds for the `short` or `long` retention tier:
320
98
 
321
99
  ```json
322
- {
323
- "providers": {
324
- "openrouter": {
325
- "modelOverrides": {
326
- "anthropic/claude-sonnet-4": {
327
- "name": "Claude Sonnet 4 (Bedrock Route)",
328
- "compat": {
329
- "openRouterRouting": {
330
- "only": ["amazon-bedrock"]
331
- }
332
- }
333
- }
334
- }
335
- }
336
- }
337
- }
100
+ { "id": "claude-sonnet-5", "promptCache": { "short": 300, "long": 3600 } }
338
101
  ```
339
102
 
340
- `modelOverrides` supports these fields per model: `name`, `reasoning`, `thinkingLevelMap`, `input`, `cost` (partial), `contextWindow`, `maxTokens`, `headers`, `compat`.
341
-
342
- Direct OpenAI GPT-5.6 Sol, Terra, and Luna default to a `272000` context window so requests remain within OpenAI's short-context pricing tier. To opt into OpenAI's 1.05M context window, increase it for each model you use:
343
-
344
- ```json
345
- {
346
- "providers": {
347
- "openai": {
348
- "modelOverrides": {
349
- "gpt-5.6-sol": {
350
- "contextWindow": 1050000
351
- }
352
- }
353
- }
354
- }
355
- }
356
- ```
103
+ Choose the conservative end of any published range. A model without a lifetime for the active tier is not eligible for cache warming. A `modelOverrides` entry can set `inputLimits` or `promptCache` for a built-in or extension model, including a model accessed through a validated proxy. See [`cacheWarming`](settings.md#model-and-thinking).
357
104
 
358
- The override preserves the built-in pricing metadata. Requests with more than 272K total input tokens use GPT-5.6's long-context rates for the entire request. Apply the same override to `gpt-5.6-terra` or `gpt-5.6-luna` when needed.
105
+ Compatibility settings should describe verified differences in the endpoint's request or response behavior. Do not enable them based only on an endpoint advertising OpenAI or Anthropic compatibility.
359
106
 
360
- In interactive mode, direct OpenAI GPT-5.4, GPT-5.5, and GPT-5.6 Sol/Terra/Luna can switch between their 272K standard and 1.05M extended windows without editing `models.json`. OpenAI Codex GPT-5.6 Sol/Terra/Luna can switch between the 372K catalog default and 1.05M. Press Ctrl+Shift+L by default, or customize the `app.context.cycle` action in `~/.draht/agent/keybindings.json`.
107
+ ## Use classifier models
361
108
 
362
- The selected window is stored in the session. Switching to a smaller window prompts for compaction when the current context would not fit. Long-context pricing metadata remains active, and the interactive status message shows the input threshold where higher pricing begins.
109
+ Classifier models do not chat. They answer typed questions about JSON state: pick one of several choices, answer yes or no, or give a score, each with probabilities. draht includes TypeSafe's Jev model from these providers:
363
110
 
364
- Behavior notes:
365
- - `modelOverrides` are applied to built-in provider models and matching extension-registered provider models.
366
- - Unknown model IDs are ignored.
367
- - You can combine provider-level `baseUrl`/`headers` with `modelOverrides`.
368
- - Overriding `name` changes model matching and secondary detail text only; the footer and primary model lists continue to show the model `id`.
369
- - If `models` is also defined for a provider, custom models are merged after built-in overrides. A custom model with the same `id` replaces the overridden built-in model entry.
111
+ | Provider | Model IDs | Authentication |
112
+ |---|---|---|
113
+ | `typesafe` | `jev-latest` | `TYPESAFE_API_KEY` |
114
+ | `openrouter` | `typesafe/jev-1.13`, `~typesafe/jev-latest` | `OPENROUTER_API_KEY` or `/login` |
115
+ | `cloudflare-workers-ai` | `typesafe/jev` | `CLOUDFLARE_API_KEY` and `CLOUDFLARE_ACCOUNT_ID` |
116
+ | `vercel-ai-gateway` | `typesafe-ai/jev` | `AI_GATEWAY_API_KEY` |
117
+ | `opencode` | `jev-1.13`, `jev-1.13-free` | `OPENCODE_API_KEY` |
370
118
 
371
- ## Anthropic Messages Compatibility
119
+ Chat models on a [llama.cpp router](llama-cpp.md#classification) are also listed as classifier models.
372
120
 
373
- For providers or proxies using `api: "anthropic-messages"`, use `compat` to control Anthropic-specific request compatibility.
121
+ Classifier models do not appear in `/model`. The model reaches them through the [`codemode`](cli.md#enable-codemode) tool, which is off unless an MCP server turned it on. Enable it with `"defaultTools": ["+codemode"]` in [settings](settings.md#tools). Scripts then list classifier models with `models.getAvailableOfType("classifier")` and call `models.classify(model, { state, questions })`:
374
122
 
375
- By default draht sends per-tool `eager_input_streaming: true`. If a proxy or Anthropic-compatible backend rejects that field, set `supportsEagerToolInputStreaming` to `false`. draht will omit `tools[].eager_input_streaming` and send the legacy `fine-grained-tool-streaming-2025-05-14` beta header for tool-enabled requests instead.
123
+ ```js
124
+ const jev = await models.getModelOfType("classifier", "typesafe", "jev-latest");
125
+ const result = await models.classify(jev, {
126
+ state: { message: "The change works, thanks." },
127
+ questions: {
128
+ approved: {
129
+ type: "bool",
130
+ instructions: "Does the user approve of the result?",
131
+ criteria: { true: "Approval", false: "No approval" },
132
+ },
133
+ },
134
+ });
135
+ return result.answers;
136
+ ```
376
137
 
377
- Some Anthropic models require adaptive thinking (`thinking.type: "adaptive"` plus `output_config.effort`) instead of the legacy budget-based thinking payload. Built-in models set this automatically. For custom providers or aliases that route to those models, set `forceAdaptiveThinking` to `true`.
138
+ When the service reports token counts, as all System One services do, `result.usage` carries them with their cost. draht adds the usage of a script's classifier calls to the `codemode` tool result, so it counts toward the session cost in the footer and `/session`. The cost uses the model's catalog price; models without one, such as TypeSafe's direct `jev-latest`, report tokens at no cost.
378
139
 
379
- Some Anthropic-compatible providers emit thinking blocks with empty signatures and still expect them on replay. Set `allowEmptySignature` to `true` only for those providers; real Anthropic rejects empty thinking signatures.
140
+ Extensions call classifiers through `ctx.modelRegistry.classify()`, without codemode. [Virtual models](virtual-models.md#route-requests) can use them to route requests; see the `jev-router.ts` example.
380
141
 
381
- Built-in Anthropic models enable `supportsStrictTools` in their model metadata. Custom Anthropic-compatible models must set it to `true` when their endpoint accepts strict JSON-schema tool definitions.
142
+ ## Add a custom provider
382
143
 
383
- ```json
384
- {
385
- "providers": {
386
- "anthropic-proxy": {
387
- "baseUrl": "https://proxy.example.com",
388
- "api": "anthropic-messages",
389
- "apiKey": "$ANTHROPIC_PROXY_KEY",
390
- "compat": {
391
- "supportsEagerToolInputStreaming": false,
392
- "supportsLongCacheRetention": true,
393
- "forceAdaptiveThinking": true,
394
- "allowEmptySignature": true
395
- },
396
- "models": [
397
- {
398
- "id": "claude-opus-4-7",
399
- "reasoning": true,
400
- "input": ["text", "image"]
401
- }
402
- ]
403
- }
404
- }
405
- }
406
- ```
144
+ Use an extension when the provider needs custom streaming, model discovery, or authentication behavior. See [Custom Providers](custom-provider.md) for the extension workflow.
407
145
 
408
- | Field | Description |
409
- |-------|-------------|
410
- | `supportsEagerToolInputStreaming` | Whether the provider accepts per-tool `eager_input_streaming`. Default: `true`. Set to `false` to omit that field and use the legacy fine-grained tool streaming beta header on tool-enabled requests. |
411
- | `supportsLongCacheRetention` | Whether the provider accepts Anthropic long cache retention (`cache_control.ttl: "1h"`) when cache retention is `long`. Default: `true`. |
412
- | `sendSessionAffinityHeaders` | Whether to send `x-session-affinity` from the session id when caching is enabled. Default: auto-detected for known providers. |
413
- | `supportsCacheControlOnTools` | Whether the provider accepts Anthropic-style `cache_control` markers on tool definitions. Default: `true`. |
414
- | `forceAdaptiveThinking` | Whether to send adaptive thinking (`thinking.type: "adaptive"` plus `output_config.effort`) for this model. Built-in adaptive models set this automatically. Default: `false`. |
415
- | `allowEmptySignature` | Whether to replay empty thinking signatures as `signature: ""` instead of converting thinking to text. Default: `false`. |
416
- | `supportsStrictTools` | Whether the provider accepts strict JSON-schema tool definitions. Default: `false`; built-in Anthropic models enable it in generated metadata. |
146
+ ## Troubleshooting
417
147
 
418
- ## OpenAI Compatibility
148
+ ### A model does not appear
419
149
 
420
- For providers with partial OpenAI compatibility, use the `compat` field.
150
+ Confirm that its provider has usable authentication. Custom models can load from `models.json` but remain unavailable in `/model` until draht can resolve credentials. For llama.cpp, only models currently loaded by the router appear.
421
151
 
422
- - Provider-level `compat` applies defaults to all models under that provider.
423
- - Model-level `compat` overrides provider-level values for that model.
152
+ ### Authentication works in one shell only
424
153
 
425
- ```json
426
- {
427
- "providers": {
428
- "local-llm": {
429
- "baseUrl": "http://localhost:8080/v1",
430
- "api": "openai-completions",
431
- "compat": {
432
- "supportsUsageInStreaming": false,
433
- "maxTokensField": "max_tokens"
434
- },
435
- "models": [...]
436
- }
437
- }
438
- }
439
- ```
154
+ Check whether the key came from an environment variable rather than `auth.json`. Environment variables must be present in the process that starts draht.
440
155
 
441
- | Field | Description |
442
- |-------|-------------|
443
- | `supportsStore` | Provider supports `store` field |
444
- | `supportsDeveloperRole` | Use `developer` vs `system` role |
445
- | `supportsReasoningEffort` | Support for `reasoning_effort` parameter |
446
- | `supportsUsageInStreaming` | Supports `stream_options: { include_usage: true }` (default: `true`) |
447
- | `maxTokensField` | Use `max_completion_tokens` or `max_tokens` |
448
- | `requiresToolResultName` | Include `name` on tool result messages |
449
- | `requiresAssistantAfterToolResult` | Insert an assistant message before a user message after tool results |
450
- | `requiresThinkingAsText` | Convert thinking blocks to plain text |
451
- | `requiresReasoningContentOnAssistantMessages` | Include empty `reasoning_content` on all replayed assistant messages when reasoning is enabled |
452
- | `thinkingFormat` | Use `reasoning_effort`, `openrouter`, `deepseek`, `together`, `zai`, `qwen`, or `qwen-chat-template` thinking parameters |
453
- | `cacheControlFormat` | Use Anthropic-style `cache_control` markers on the system prompt, last tool definition, and last user, assistant, or tool-result text content. Currently only `anthropic` is supported. |
454
- | `sendSessionAffinityHeaders` | For `openai-completions`, send session-affinity headers from the session id when caching is enabled. Default: `false`. |
455
- | `sessionAffinityFormat` | For `openai-completions` and `openai-responses`, the session-affinity header format: `openai` sends `session_id`/`x-client-request-id` (completions also `x-session-affinity`), `openai-nosession` omits the underscore-containing `session_id` header, `openrouter` sends `x-session-id`. Does not affect the `prompt_cache_key` body param. Default: auto-detected. |
456
- | `supportsStrictMode` | Whether the provider accepts strict JSON-schema function tool definitions. Defaults depend on the API; built-in OpenAI models carry explicit capability metadata. |
457
- | `supportsOpenAIGrammarTools` | Whether OpenAI-compatible APIs emit custom Lark/regex grammar tools. When `false`, grammar-constrained tools fall back to normal function tools. Default: `false`; the built-in model catalog enables it for GPT-5+ models on OpenAI, OpenAI Codex, Azure OpenAI, GitHub Copilot, opencode, and Cloudflare AI Gateway. |
458
- | `deferredToolsMode` | Use provider-specific deferred tool serialization. Currently only `"kimi"` is supported for Kimi's OpenAI-compatible Chat Completions format. |
459
- | `supportsLongCacheRetention` | Whether the provider accepts long cache retention when cache retention is `long`: `prompt_cache_retention: "24h"` for OpenAI prompt caching, or `cache_control.ttl: "1h"` when `cacheControlFormat` is `anthropic`. Default: `true`. |
460
- | `openRouterRouting` | OpenRouter provider routing preferences. This object is sent as-is in the `provider` field of the [OpenRouter API request](https://openrouter.ai/docs/guides/routing/provider-selection). |
461
- | `vercelGatewayRouting` | Vercel AI Gateway routing config for provider selection (`only`, `order`) |
462
-
463
- `openrouter` uses `reasoning: { effort }`. `together` uses `reasoning: { enabled }` and also `reasoning_effort` when `supportsReasoningEffort` is enabled. `qwen` uses top-level `enable_thinking`. Use `qwen-chat-template` for local Qwen-compatible servers that require `chat_template_kwargs.enable_thinking`.
464
-
465
- `cacheControlFormat: "anthropic"` is for OpenAI-compatible providers that expose Anthropic-style prompt caching through `cache_control` markers on text content and tool definitions.
466
-
467
- Example:
156
+ ### Sign-in opens a browser on a remote machine
468
157
 
469
- ```json
470
- {
471
- "providers": {
472
- "openrouter": {
473
- "baseUrl": "https://openrouter.ai/api/v1",
474
- "apiKey": "$OPENROUTER_API_KEY",
475
- "api": "openai-completions",
476
- "models": [
477
- {
478
- "id": "openrouter/anthropic/claude-3.5-sonnet",
479
- "name": "OpenRouter Claude 3.5 Sonnet",
480
- "compat": {
481
- "openRouterRouting": {
482
- "allow_fallbacks": true,
483
- "require_parameters": false,
484
- "data_collection": "deny",
485
- "zdr": true,
486
- "enforce_distillable_text": false,
487
- "order": ["anthropic", "amazon-bedrock", "google-vertex"],
488
- "only": ["anthropic", "amazon-bedrock"],
489
- "ignore": ["gmicloud", "friendli"],
490
- "quantizations": ["fp16", "bf16"],
491
- "sort": {
492
- "by": "price",
493
- "partition": "model"
494
- },
495
- "max_price": {
496
- "prompt": 10,
497
- "completion": 20
498
- },
499
- "preferred_min_throughput": {
500
- "p50": 100,
501
- "p90": 50
502
- },
503
- "preferred_max_latency": {
504
- "p50": 1,
505
- "p90": 3,
506
- "p99": 5
507
- }
508
- }
509
- }
510
- }
511
- ]
512
- }
513
- }
514
- }
515
- ```
158
+ Complete the provider's headless authentication flow when available. Some providers let you paste the final redirect URL or authorization code back into draht. See [Authenticate interactively](providers.md#authenticate-interactively).
516
159
 
517
- Vercel AI Gateway example:
160
+ ### A compatible endpoint rejects requests
518
161
 
519
- ```json
520
- {
521
- "providers": {
522
- "vercel-ai-gateway": {
523
- "baseUrl": "https://ai-gateway.vercel.sh/v1",
524
- "apiKey": "$AI_GATEWAY_API_KEY",
525
- "api": "openai-completions",
526
- "models": [
527
- {
528
- "id": "moonshotai/kimi-k2.5",
529
- "name": "Kimi K2.5 (Fireworks via Vercel)",
530
- "reasoning": true,
531
- "input": ["text", "image"],
532
- "cost": { "input": 0.6, "output": 3, "cacheRead": 0, "cacheWrite": 0 },
533
- "contextWindow": 262144,
534
- "maxTokens": 262144,
535
- "compat": {
536
- "vercelGatewayRouting": {
537
- "only": ["fireworks", "novita"],
538
- "order": ["fireworks", "novita"]
539
- }
540
- }
541
- }
542
- ]
543
- }
544
- }
545
- }
546
- ```
162
+ Check its API type and compatibility settings in `models.json`. The upstream server must support the corresponding request fields and behavior.