@draht/coding-agent 2026.10.20 → 2026.10.23-1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (744) hide show
  1. package/CHANGELOG.md +138 -0
  2. package/agents/advisor.md +2 -2
  3. package/agents/architect.md +11 -33
  4. package/agents/debugger.md +13 -54
  5. package/agents/git-committer.md +18 -42
  6. package/agents/implementer.md +14 -36
  7. package/agents/investigator.md +12 -63
  8. package/agents/reviewer.md +16 -44
  9. package/agents/security-auditor.md +22 -56
  10. package/agents/spec-reviewer.md +13 -53
  11. package/agents/verifier.md +14 -33
  12. package/bin/drahtbank.mjs +4 -0
  13. package/dist/agents/advisor.md +2 -2
  14. package/dist/agents/architect.md +11 -33
  15. package/dist/agents/debugger.md +13 -54
  16. package/dist/agents/git-committer.md +18 -42
  17. package/dist/agents/implementer.md +14 -36
  18. package/dist/agents/investigator.md +12 -63
  19. package/dist/agents/reviewer.md +16 -44
  20. package/dist/agents/security-auditor.md +22 -56
  21. package/dist/agents/spec-reviewer.md +13 -53
  22. package/dist/agents/verifier.md +14 -33
  23. package/dist/bundle/chunks/anthropic-messages-G57VPNTF.js +6 -0
  24. package/dist/bundle/chunks/anthropic.js +1 -1
  25. package/dist/bundle/chunks/azure-openai-responses-AYUCZ5WN.js +2 -0
  26. package/dist/bundle/chunks/bedrock-converse-stream.js +31 -28
  27. package/dist/bundle/chunks/chunk-2JZLKNZ4.js +3 -0
  28. package/dist/bundle/chunks/chunk-3GDEPGTR.js +16 -0
  29. package/dist/bundle/chunks/chunk-5JW3NSTV.js +2 -0
  30. package/dist/bundle/chunks/{chunk-KVH4HR57.js → chunk-6WESOD4H.js} +1 -1
  31. package/dist/bundle/chunks/chunk-76YNMQ57.js +2 -0
  32. package/dist/bundle/chunks/chunk-AC3MSTC6.js +2 -0
  33. package/dist/bundle/chunks/chunk-ACLWH5WQ.js +2 -0
  34. package/dist/bundle/chunks/chunk-BL72B6LV.js +82 -0
  35. package/dist/bundle/chunks/chunk-CLKG6K6Z.js +7 -0
  36. package/dist/bundle/chunks/chunk-DN7SM3LX.js +479 -0
  37. package/dist/bundle/chunks/{chunk-D6TMD5Q2.js → chunk-DOUMZTXH.js} +10 -10
  38. package/dist/bundle/chunks/chunk-DQ4G4IS4.js +20 -0
  39. package/dist/bundle/chunks/chunk-E4VZJRJ2.js +9 -0
  40. package/dist/bundle/chunks/chunk-FOYIPAAD.js +6 -0
  41. package/dist/bundle/chunks/chunk-FXCTQRNN.js +2 -0
  42. package/dist/bundle/chunks/chunk-GBFVS2SF.js +12 -0
  43. package/dist/bundle/chunks/chunk-GQXRTK54.js +20 -0
  44. package/dist/bundle/chunks/chunk-IGO52ZOY.js +132 -0
  45. package/dist/bundle/chunks/chunk-IT4RIOZD.js +2 -0
  46. package/dist/bundle/chunks/chunk-JJKPUMH2.js +1424 -0
  47. package/dist/bundle/chunks/chunk-JNWRE5F4.js +2 -0
  48. package/dist/bundle/chunks/chunk-KSGHCBHT.js +2 -0
  49. package/dist/bundle/chunks/chunk-LO6CVU2L.js +6 -0
  50. package/dist/bundle/chunks/chunk-MBFTIGLS.js +2 -0
  51. package/dist/bundle/chunks/chunk-N26RGV3K.js +11 -0
  52. package/dist/bundle/chunks/{chunk-KPO5375S.js → chunk-RCRGGYLW.js} +1 -1
  53. package/dist/bundle/chunks/chunk-UCJ7FLSO.js +166 -0
  54. package/dist/bundle/chunks/chunk-USCN7R2E.js +2 -0
  55. package/dist/bundle/chunks/chunk-WFHH5SX6.js +4 -0
  56. package/dist/bundle/chunks/chunk-WYWBXNDO.js +6 -0
  57. package/dist/bundle/chunks/chunk-ZRPAOMVB.js +2 -0
  58. package/dist/bundle/chunks/{cli-PYJB6AQ3.js → cli-HTUB6WOG.js} +6 -6
  59. package/dist/bundle/chunks/cloudflare-workers-ai-system-one-RRSO6OXX.js +2 -0
  60. package/dist/bundle/chunks/codemode-worker.js +188 -21
  61. package/dist/bundle/chunks/execute-UUPNZJJG.js +31 -0
  62. package/dist/bundle/chunks/github-copilot.js +1 -1
  63. package/dist/bundle/chunks/google-generative-ai-VJSS5EBX.js +2 -0
  64. package/dist/bundle/chunks/google-vertex-K23DBWTT.js +2 -0
  65. package/dist/bundle/chunks/https-proxy-agent-WQIRL24U.js +13 -0
  66. package/dist/bundle/chunks/image-resize-worker.js +1 -1
  67. package/dist/bundle/chunks/lib-ULKZYRGD.js +9 -0
  68. package/dist/bundle/chunks/{llama-cpp-classify-EJ5XMSQL.js → llama-cpp-classify-3VDXTYVJ.js} +3 -3
  69. package/dist/bundle/chunks/mistral-conversations-SKVQJGFZ.js +5 -0
  70. package/dist/bundle/chunks/{multipart-parser-AZP5BX2W.js → multipart-parser-HMCXZ4BD.js} +1 -1
  71. package/dist/bundle/chunks/node-DXZFQBEO.js +16 -0
  72. package/dist/bundle/chunks/{node-C2JGH2OB.js → node-LBZLUIBE.js} +1 -1
  73. package/dist/bundle/chunks/openai-chatgpt.js +1 -1
  74. package/dist/bundle/chunks/openai-codex-responses-LV4RIZL3.js +10 -0
  75. package/dist/bundle/chunks/openai-codex.js +1 -1
  76. package/dist/bundle/chunks/openai-completions-PUIR2V25.js +7 -0
  77. package/dist/bundle/chunks/openai-decisions-2DJLSYQF.js +5 -0
  78. package/dist/bundle/chunks/openai-responses-6ESQOXAF.js +4 -0
  79. package/dist/bundle/chunks/opencode-go.js +1 -1
  80. package/dist/bundle/chunks/openrouter-images-TVXBMY3V.js +2 -0
  81. package/dist/bundle/chunks/pi-messages-XS7FDWQI.js +8 -0
  82. package/dist/bundle/chunks/runtime-IB3XQ7E3.js +2 -0
  83. package/dist/bundle/chunks/runtime-LB35PK4J.js +3 -0
  84. package/dist/bundle/chunks/settings-manager-YNY5F4RU.js +2 -0
  85. package/dist/bundle/chunks/src-KDGO7EGF.js +4 -0
  86. package/dist/bundle/chunks/typesafe-system-one-67GAWZXE.js +2 -0
  87. package/dist/bundle/chunks/virtual-modules-U4CBGVMI.js +2 -0
  88. package/dist/bundle/cli-runtime.js +1 -1
  89. package/dist/bundle/index.js +1 -1
  90. package/dist/bundle/rpc-entry.js +1 -1
  91. package/dist/cli/args.d.ts +2 -1
  92. package/dist/cli/args.d.ts.map +1 -1
  93. package/dist/cli/args.js +30 -8
  94. package/dist/cli/args.js.map +1 -1
  95. package/dist/cli/credential-print.d.ts.map +1 -1
  96. package/dist/cli/credential-print.js +4 -4
  97. package/dist/cli/credential-print.js.map +1 -1
  98. package/dist/config.d.ts +18 -1
  99. package/dist/config.d.ts.map +1 -1
  100. package/dist/config.js +44 -6
  101. package/dist/config.js.map +1 -1
  102. package/dist/core/agent-session.d.ts +65 -8
  103. package/dist/core/agent-session.d.ts.map +1 -1
  104. package/dist/core/agent-session.js +240 -102
  105. package/dist/core/agent-session.js.map +1 -1
  106. package/dist/core/auth-storage.d.ts.map +1 -1
  107. package/dist/core/auth-storage.js +20 -13
  108. package/dist/core/auth-storage.js.map +1 -1
  109. package/dist/core/bash-executor.d.ts.map +1 -1
  110. package/dist/core/bash-executor.js +42 -52
  111. package/dist/core/bash-executor.js.map +1 -1
  112. package/dist/core/bug-report.d.ts +9 -1
  113. package/dist/core/bug-report.d.ts.map +1 -1
  114. package/dist/core/builtins/completion-checks.d.ts +3 -0
  115. package/dist/core/builtins/completion-checks.d.ts.map +1 -0
  116. package/dist/core/builtins/completion-checks.js +142 -0
  117. package/dist/core/builtins/completion-checks.js.map +1 -0
  118. package/dist/core/builtins/duet.d.ts.map +1 -1
  119. package/dist/core/builtins/duet.js +7 -5
  120. package/dist/core/builtins/duet.js.map +1 -1
  121. package/dist/core/builtins/git-safety.d.ts +3 -0
  122. package/dist/core/builtins/git-safety.d.ts.map +1 -0
  123. package/dist/core/builtins/git-safety.js +34 -0
  124. package/dist/core/builtins/git-safety.js.map +1 -0
  125. package/dist/core/builtins/index.d.ts.map +1 -1
  126. package/dist/core/builtins/index.js +4 -0
  127. package/dist/core/builtins/index.js.map +1 -1
  128. package/dist/core/client-identity.d.ts +8 -0
  129. package/dist/core/client-identity.d.ts.map +1 -0
  130. package/dist/core/client-identity.js +15 -0
  131. package/dist/core/client-identity.js.map +1 -0
  132. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  133. package/dist/core/compaction/branch-summarization.js +1 -2
  134. package/dist/core/compaction/branch-summarization.js.map +1 -1
  135. package/dist/core/compaction/compaction.d.ts +2 -2
  136. package/dist/core/compaction/compaction.d.ts.map +1 -1
  137. package/dist/core/compaction/compaction.js +20 -15
  138. package/dist/core/compaction/compaction.js.map +1 -1
  139. package/dist/core/compaction/utils.d.ts +6 -0
  140. package/dist/core/compaction/utils.d.ts.map +1 -1
  141. package/dist/core/compaction/utils.js +7 -8
  142. package/dist/core/compaction/utils.js.map +1 -1
  143. package/dist/core/export-html/index.d.ts.map +1 -1
  144. package/dist/core/export-html/index.js +2 -0
  145. package/dist/core/export-html/index.js.map +1 -1
  146. package/dist/core/export-html/template.html +1 -0
  147. package/dist/core/export-html/template.js +23 -17
  148. package/dist/core/export-html/tool-renderer.d.ts +3 -3
  149. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  150. package/dist/core/export-html/tool-renderer.js +5 -3
  151. package/dist/core/export-html/tool-renderer.js.map +1 -1
  152. package/dist/core/export-html/vendor/marked-cjk-friendly.min.js +6 -0
  153. package/dist/core/export-html/vendor/marked.min.js +30 -29
  154. package/dist/core/extensions/index.d.ts +1 -1
  155. package/dist/core/extensions/index.d.ts.map +1 -1
  156. package/dist/core/extensions/index.js.map +1 -1
  157. package/dist/core/extensions/loader.d.ts.map +1 -1
  158. package/dist/core/extensions/loader.js +7 -0
  159. package/dist/core/extensions/loader.js.map +1 -1
  160. package/dist/core/extensions/runner.d.ts +6 -2
  161. package/dist/core/extensions/runner.d.ts.map +1 -1
  162. package/dist/core/extensions/runner.js +16 -4
  163. package/dist/core/extensions/runner.js.map +1 -1
  164. package/dist/core/extensions/types.d.ts +61 -7
  165. package/dist/core/extensions/types.d.ts.map +1 -1
  166. package/dist/core/extensions/types.js.map +1 -1
  167. package/dist/core/extensions/virtual-modules.d.ts.map +1 -1
  168. package/dist/core/extensions/virtual-modules.js +2 -0
  169. package/dist/core/extensions/virtual-modules.js.map +1 -1
  170. package/dist/core/key-id-schema.d.ts +6 -0
  171. package/dist/core/key-id-schema.d.ts.map +1 -0
  172. package/dist/core/key-id-schema.js +16 -0
  173. package/dist/core/key-id-schema.js.map +1 -0
  174. package/dist/core/keybindings-schema.d.ts +4 -0
  175. package/dist/core/keybindings-schema.d.ts.map +1 -0
  176. package/dist/core/keybindings-schema.js +16 -0
  177. package/dist/core/keybindings-schema.js.map +1 -0
  178. package/dist/core/keybindings.d.ts +242 -75
  179. package/dist/core/keybindings.d.ts.map +1 -1
  180. package/dist/core/keybindings.js +30 -23
  181. package/dist/core/keybindings.js.map +1 -1
  182. package/dist/core/mcp-servers.d.ts +22 -0
  183. package/dist/core/mcp-servers.d.ts.map +1 -1
  184. package/dist/core/mcp-servers.js +72 -11
  185. package/dist/core/mcp-servers.js.map +1 -1
  186. package/dist/core/model-config.d.ts +1623 -74
  187. package/dist/core/model-config.d.ts.map +1 -1
  188. package/dist/core/model-config.js +70 -184
  189. package/dist/core/model-config.js.map +1 -1
  190. package/dist/core/model-registry.d.ts +3 -1
  191. package/dist/core/model-registry.d.ts.map +1 -1
  192. package/dist/core/model-registry.js +4 -0
  193. package/dist/core/model-registry.js.map +1 -1
  194. package/dist/core/model-resolver.d.ts +56 -43
  195. package/dist/core/model-resolver.d.ts.map +1 -1
  196. package/dist/core/model-resolver.js +253 -358
  197. package/dist/core/model-resolver.js.map +1 -1
  198. package/dist/core/model-runtime.d.ts.map +1 -1
  199. package/dist/core/model-runtime.js +19 -10
  200. package/dist/core/model-runtime.js.map +1 -1
  201. package/dist/core/nested-tool-calls.d.ts +1 -0
  202. package/dist/core/nested-tool-calls.d.ts.map +1 -1
  203. package/dist/core/nested-tool-calls.js +1 -0
  204. package/dist/core/nested-tool-calls.js.map +1 -1
  205. package/dist/core/package-manager.js +3 -3
  206. package/dist/core/package-manager.js.map +1 -1
  207. package/dist/core/polyphase/keyword.js +1 -1
  208. package/dist/core/polyphase/keyword.js.map +1 -1
  209. package/dist/core/polyphase/model-selection.d.ts.map +1 -1
  210. package/dist/core/polyphase/model-selection.js +15 -7
  211. package/dist/core/polyphase/model-selection.js.map +1 -1
  212. package/dist/core/polyphase/workflow/prelude.d.ts +2 -0
  213. package/dist/core/polyphase/workflow/prelude.d.ts.map +1 -1
  214. package/dist/core/polyphase/workflow/prelude.js +12 -16
  215. package/dist/core/polyphase/workflow/prelude.js.map +1 -1
  216. package/dist/core/polyphase/workflow/runtime.d.ts.map +1 -1
  217. package/dist/core/polyphase/workflow/runtime.js +2 -1
  218. package/dist/core/polyphase/workflow/runtime.js.map +1 -1
  219. package/dist/core/project-trust.d.ts.map +1 -1
  220. package/dist/core/project-trust.js +2 -1
  221. package/dist/core/project-trust.js.map +1 -1
  222. package/dist/core/prompt-templates.d.ts.map +1 -1
  223. package/dist/core/prompt-templates.js +7 -2
  224. package/dist/core/prompt-templates.js.map +1 -1
  225. package/dist/core/provider-composer.d.ts +2 -1
  226. package/dist/core/provider-composer.d.ts.map +1 -1
  227. package/dist/core/provider-composer.js +13 -0
  228. package/dist/core/provider-composer.js.map +1 -1
  229. package/dist/core/radius.d.ts +2 -0
  230. package/dist/core/radius.d.ts.map +1 -1
  231. package/dist/core/radius.js +2 -0
  232. package/dist/core/radius.js.map +1 -1
  233. package/dist/core/remote-catalog-provider.d.ts +12 -1
  234. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  235. package/dist/core/remote-catalog-provider.js +84 -24
  236. package/dist/core/remote-catalog-provider.js.map +1 -1
  237. package/dist/core/resource-loader.d.ts +3 -0
  238. package/dist/core/resource-loader.d.ts.map +1 -1
  239. package/dist/core/resource-loader.js +7 -4
  240. package/dist/core/resource-loader.js.map +1 -1
  241. package/dist/core/sdk.d.ts +13 -4
  242. package/dist/core/sdk.d.ts.map +1 -1
  243. package/dist/core/sdk.js +27 -15
  244. package/dist/core/sdk.js.map +1 -1
  245. package/dist/core/settings-defaults.d.ts +65 -0
  246. package/dist/core/settings-defaults.d.ts.map +1 -0
  247. package/dist/core/settings-defaults.js +66 -0
  248. package/dist/core/settings-defaults.js.map +1 -0
  249. package/dist/core/settings-manager.d.ts +17 -178
  250. package/dist/core/settings-manager.d.ts.map +1 -1
  251. package/dist/core/settings-manager.js +86 -57
  252. package/dist/core/settings-manager.js.map +1 -1
  253. package/dist/core/settings-schema.d.ts +269 -0
  254. package/dist/core/settings-schema.d.ts.map +1 -0
  255. package/dist/core/settings-schema.js +318 -0
  256. package/dist/core/settings-schema.js.map +1 -0
  257. package/dist/core/skills.d.ts +4 -1
  258. package/dist/core/skills.d.ts.map +1 -1
  259. package/dist/core/skills.js +6 -1
  260. package/dist/core/skills.js.map +1 -1
  261. package/dist/core/system-prompt.d.ts +6 -0
  262. package/dist/core/system-prompt.d.ts.map +1 -1
  263. package/dist/core/system-prompt.js +10 -5
  264. package/dist/core/system-prompt.js.map +1 -1
  265. package/dist/core/tools/bash.d.ts.map +1 -1
  266. package/dist/core/tools/bash.js +3 -5
  267. package/dist/core/tools/bash.js.map +1 -1
  268. package/dist/core/tools/grep.d.ts +8 -0
  269. package/dist/core/tools/grep.d.ts.map +1 -1
  270. package/dist/core/tools/grep.js +19 -7
  271. package/dist/core/tools/grep.js.map +1 -1
  272. package/dist/core/tools/index.d.ts +2 -0
  273. package/dist/core/tools/index.d.ts.map +1 -1
  274. package/dist/core/tools/index.js +2 -0
  275. package/dist/core/tools/index.js.map +1 -1
  276. package/dist/core/tools/output-accumulator.d.ts.map +1 -1
  277. package/dist/core/tools/output-accumulator.js +4 -10
  278. package/dist/core/tools/output-accumulator.js.map +1 -1
  279. package/dist/core/tools/path-utils.d.ts +1 -1
  280. package/dist/core/tools/path-utils.d.ts.map +1 -1
  281. package/dist/core/tools/path-utils.js +6 -6
  282. package/dist/core/tools/path-utils.js.map +1 -1
  283. package/dist/core/tools/read.d.ts +13 -0
  284. package/dist/core/tools/read.d.ts.map +1 -1
  285. package/dist/core/tools/read.js +32 -2
  286. package/dist/core/tools/read.js.map +1 -1
  287. package/dist/core/tools/render-utils.d.ts +20 -0
  288. package/dist/core/tools/render-utils.d.ts.map +1 -1
  289. package/dist/core/tools/render-utils.js +67 -0
  290. package/dist/core/tools/render-utils.js.map +1 -1
  291. package/dist/core/tools/renderers/bash.d.ts.map +1 -1
  292. package/dist/core/tools/renderers/bash.js +7 -35
  293. package/dist/core/tools/renderers/bash.js.map +1 -1
  294. package/dist/core/tools/renderers/edit.d.ts.map +1 -1
  295. package/dist/core/tools/renderers/edit.js +5 -4
  296. package/dist/core/tools/renderers/edit.js.map +1 -1
  297. package/dist/core/tools/renderers/index.d.ts +2 -2
  298. package/dist/core/tools/renderers/index.d.ts.map +1 -1
  299. package/dist/core/tools/renderers/index.js.map +1 -1
  300. package/dist/core/tools/renderers/read.d.ts.map +1 -1
  301. package/dist/core/tools/renderers/read.js +7 -11
  302. package/dist/core/tools/renderers/read.js.map +1 -1
  303. package/dist/extensions/codemode/execute.d.ts.map +1 -1
  304. package/dist/extensions/codemode/execute.js +391 -80
  305. package/dist/extensions/codemode/execute.js.map +1 -1
  306. package/dist/extensions/codemode/index.d.ts.map +1 -1
  307. package/dist/extensions/codemode/index.js +3 -1
  308. package/dist/extensions/codemode/index.js.map +1 -1
  309. package/dist/extensions/codemode/renderer.d.ts +2 -2
  310. package/dist/extensions/codemode/renderer.d.ts.map +1 -1
  311. package/dist/extensions/codemode/renderer.js +9 -3
  312. package/dist/extensions/codemode/renderer.js.map +1 -1
  313. package/dist/extensions/codemode/tool.d.ts +22 -21
  314. package/dist/extensions/codemode/tool.d.ts.map +1 -1
  315. package/dist/extensions/codemode/tool.js +96 -123
  316. package/dist/extensions/codemode/tool.js.map +1 -1
  317. package/dist/extensions/llama/provider.d.ts.map +1 -1
  318. package/dist/extensions/llama/provider.js +34 -11
  319. package/dist/extensions/llama/provider.js.map +1 -1
  320. package/dist/extensions/mcp/cli.d.ts.map +1 -1
  321. package/dist/extensions/mcp/cli.js +27 -33
  322. package/dist/extensions/mcp/cli.js.map +1 -1
  323. package/dist/extensions/mcp/config.d.ts +15 -3
  324. package/dist/extensions/mcp/config.d.ts.map +1 -1
  325. package/dist/extensions/mcp/config.js +49 -12
  326. package/dist/extensions/mcp/config.js.map +1 -1
  327. package/dist/extensions/mcp/index.d.ts +4 -1
  328. package/dist/extensions/mcp/index.d.ts.map +1 -1
  329. package/dist/extensions/mcp/index.js +279 -129
  330. package/dist/extensions/mcp/index.js.map +1 -1
  331. package/dist/extensions/mcp/oauth.d.ts +21 -11
  332. package/dist/extensions/mcp/oauth.d.ts.map +1 -1
  333. package/dist/extensions/mcp/oauth.js +166 -45
  334. package/dist/extensions/mcp/oauth.js.map +1 -1
  335. package/dist/extensions/mcp/resources.d.ts +3 -10
  336. package/dist/extensions/mcp/resources.d.ts.map +1 -1
  337. package/dist/extensions/mcp/resources.js +4 -5
  338. package/dist/extensions/mcp/resources.js.map +1 -1
  339. package/dist/extensions/mcp/runtime.d.ts +7 -7
  340. package/dist/extensions/mcp/runtime.d.ts.map +1 -1
  341. package/dist/extensions/mcp/runtime.js +31 -45
  342. package/dist/extensions/mcp/runtime.js.map +1 -1
  343. package/dist/extensions/mcp/tools.d.ts +7 -5
  344. package/dist/extensions/mcp/tools.d.ts.map +1 -1
  345. package/dist/extensions/mcp/tools.js +87 -29
  346. package/dist/extensions/mcp/tools.js.map +1 -1
  347. package/dist/extensions/mcp/ui.d.ts +3 -3
  348. package/dist/extensions/mcp/ui.d.ts.map +1 -1
  349. package/dist/extensions/mcp/ui.js +18 -6
  350. package/dist/extensions/mcp/ui.js.map +1 -1
  351. package/dist/extensions/tool-search/tool.d.ts +0 -2
  352. package/dist/extensions/tool-search/tool.d.ts.map +1 -1
  353. package/dist/extensions/tool-search/tool.js +2 -4
  354. package/dist/extensions/tool-search/tool.js.map +1 -1
  355. package/dist/hooks/checks/checks-runtime.cjs +215 -0
  356. package/dist/hooks/checks/git-safety.cjs +198 -0
  357. package/dist/hooks/checks/git-safety.d.cts +1 -0
  358. package/dist/hooks/gsd/draht-post-task.js +78 -39
  359. package/dist/hooks/gsd/draht-quality-gate.js +210 -122
  360. package/dist/hooks/gsd/package.json +3 -0
  361. package/dist/index.d.ts +5 -4
  362. package/dist/index.d.ts.map +1 -1
  363. package/dist/index.js +3 -2
  364. package/dist/index.js.map +1 -1
  365. package/dist/main.d.ts.map +1 -1
  366. package/dist/main.js +11 -3
  367. package/dist/main.js.map +1 -1
  368. package/dist/modes/interactive/components/auth-url.d.ts +14 -0
  369. package/dist/modes/interactive/components/auth-url.d.ts.map +1 -0
  370. package/dist/modes/interactive/components/auth-url.js +37 -0
  371. package/dist/modes/interactive/components/auth-url.js.map +1 -0
  372. package/dist/modes/interactive/components/bash-execution.d.ts +5 -1
  373. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
  374. package/dist/modes/interactive/components/bash-execution.js +17 -14
  375. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  376. package/dist/modes/interactive/components/branch-summary-message.d.ts +2 -1
  377. package/dist/modes/interactive/components/branch-summary-message.d.ts.map +1 -1
  378. package/dist/modes/interactive/components/branch-summary-message.js +5 -2
  379. package/dist/modes/interactive/components/branch-summary-message.js.map +1 -1
  380. package/dist/modes/interactive/components/compaction-summary-message.d.ts +2 -1
  381. package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +1 -1
  382. package/dist/modes/interactive/components/compaction-summary-message.js +5 -2
  383. package/dist/modes/interactive/components/compaction-summary-message.js.map +1 -1
  384. package/dist/modes/interactive/components/custom-entry.d.ts +3 -1
  385. package/dist/modes/interactive/components/custom-entry.d.ts.map +1 -1
  386. package/dist/modes/interactive/components/custom-entry.js +8 -2
  387. package/dist/modes/interactive/components/custom-entry.js.map +1 -1
  388. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  389. package/dist/modes/interactive/components/custom-message.js +1 -0
  390. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  391. package/dist/modes/interactive/components/login-dialog.d.ts +3 -0
  392. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  393. package/dist/modes/interactive/components/login-dialog.js +38 -10
  394. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  395. package/dist/modes/interactive/components/oauth-selector.d.ts +8 -2
  396. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  397. package/dist/modes/interactive/components/oauth-selector.js +24 -21
  398. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  399. package/dist/modes/interactive/components/radius-login-selector.d.ts +15 -0
  400. package/dist/modes/interactive/components/radius-login-selector.d.ts.map +1 -0
  401. package/dist/modes/interactive/components/radius-login-selector.js +85 -0
  402. package/dist/modes/interactive/components/radius-login-selector.js.map +1 -0
  403. package/dist/modes/interactive/components/settings-selector.d.ts +3 -3
  404. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  405. package/dist/modes/interactive/components/settings-selector.js +9 -8
  406. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  407. package/dist/modes/interactive/components/skill-invocation-message.d.ts +2 -1
  408. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  409. package/dist/modes/interactive/components/skill-invocation-message.js +5 -2
  410. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  411. package/dist/modes/interactive/components/status-indicator.d.ts +1 -1
  412. package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -1
  413. package/dist/modes/interactive/components/status-indicator.js +2 -2
  414. package/dist/modes/interactive/components/status-indicator.js.map +1 -1
  415. package/dist/modes/interactive/components/tool-execution.d.ts +12 -13
  416. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  417. package/dist/modes/interactive/components/tool-execution.js +32 -45
  418. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  419. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  420. package/dist/modes/interactive/components/tree-selector.js +2 -9
  421. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  422. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  423. package/dist/modes/interactive/components/user-message.js +5 -4
  424. package/dist/modes/interactive/components/user-message.js.map +1 -1
  425. package/dist/modes/interactive/interactive-mode.d.ts +43 -48
  426. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  427. package/dist/modes/interactive/interactive-mode.js +362 -278
  428. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  429. package/dist/modes/interactive/program-status-reporter.d.ts +34 -0
  430. package/dist/modes/interactive/program-status-reporter.d.ts.map +1 -0
  431. package/dist/modes/interactive/program-status-reporter.js +110 -0
  432. package/dist/modes/interactive/program-status-reporter.js.map +1 -0
  433. package/dist/modes/interactive/theme/dark.json +1 -1
  434. package/dist/modes/interactive/theme/light.json +1 -1
  435. package/dist/modes/interactive/theme/system-theme.d.ts +2 -1
  436. package/dist/modes/interactive/theme/system-theme.d.ts.map +1 -1
  437. package/dist/modes/interactive/theme/system-theme.js +16 -5
  438. package/dist/modes/interactive/theme/system-theme.js.map +1 -1
  439. package/dist/modes/interactive/theme/theme-schema.d.ts +28 -0
  440. package/dist/modes/interactive/theme/theme-schema.d.ts.map +1 -0
  441. package/dist/modes/interactive/theme/theme-schema.js +105 -0
  442. package/dist/modes/interactive/theme/theme-schema.js.map +1 -0
  443. package/dist/modes/interactive/theme/theme-tokens.d.ts +257 -0
  444. package/dist/modes/interactive/theme/theme-tokens.d.ts.map +1 -0
  445. package/dist/modes/interactive/theme/theme-tokens.js +94 -0
  446. package/dist/modes/interactive/theme/theme-tokens.js.map +1 -0
  447. package/dist/modes/interactive/theme/theme.d.ts +13 -16
  448. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  449. package/dist/modes/interactive/theme/theme.js +22 -29
  450. package/dist/modes/interactive/theme/theme.js.map +1 -1
  451. package/dist/modes/print-mode.d.ts.map +1 -1
  452. package/dist/modes/print-mode.js +4 -0
  453. package/dist/modes/print-mode.js.map +1 -1
  454. package/dist/package-manager-cli.d.ts.map +1 -1
  455. package/dist/package-manager-cli.js +26 -1
  456. package/dist/package-manager-cli.js.map +1 -1
  457. package/dist/prompts/commands/atomic-commit.md +8 -6
  458. package/dist/prompts/commands/brainstorm.md +5 -149
  459. package/dist/prompts/commands/create-verification-skill.md +8 -48
  460. package/dist/prompts/commands/discuss-phase.md +6 -10
  461. package/dist/prompts/commands/execute-phase.md +18 -45
  462. package/dist/prompts/commands/fix.md +16 -128
  463. package/dist/prompts/commands/grill.md +6 -53
  464. package/dist/prompts/commands/init-project.md +13 -18
  465. package/dist/prompts/commands/map-codebase.md +3 -3
  466. package/dist/prompts/commands/new-project.md +12 -17
  467. package/dist/prompts/commands/next-milestone.md +4 -8
  468. package/dist/prompts/commands/orchestrate-loop.md +12 -12
  469. package/dist/prompts/commands/orchestrate.md +12 -11
  470. package/dist/prompts/commands/pause-work.md +1 -1
  471. package/dist/prompts/commands/plan-phase.md +15 -37
  472. package/dist/prompts/commands/quick.md +11 -64
  473. package/dist/prompts/commands/resolve-conflicts.md +2 -15
  474. package/dist/prompts/commands/triage.md +3 -14
  475. package/dist/prompts/commands/verify-work.md +15 -63
  476. package/dist/prompts/commands/why.md +18 -118
  477. package/dist/skills/atomic-reasoning/SKILL.md +6 -105
  478. package/dist/skills/blast-radius/SKILL.md +1 -1
  479. package/dist/skills/epistemics/SKILL.md +12 -87
  480. package/dist/skills/explainers/SKILL.md +1 -1
  481. package/dist/skills/typescript-discipline/SKILL.md +12 -42
  482. package/dist/skills/typescript-discipline/references/patterns.md +25 -266
  483. package/dist/skills/unslop/SKILL.md +14 -105
  484. package/dist/utils/ansi.d.ts +8 -0
  485. package/dist/utils/ansi.d.ts.map +1 -1
  486. package/dist/utils/ansi.js +30 -11
  487. package/dist/utils/ansi.js.map +1 -1
  488. package/dist/utils/clipboard-command.d.ts.map +1 -1
  489. package/dist/utils/clipboard-command.js +3 -0
  490. package/dist/utils/clipboard-command.js.map +1 -1
  491. package/dist/utils/clipboard.d.ts.map +1 -1
  492. package/dist/utils/clipboard.js +18 -12
  493. package/dist/utils/clipboard.js.map +1 -1
  494. package/dist/utils/draht-user-agent.d.ts +1 -0
  495. package/dist/utils/draht-user-agent.d.ts.map +1 -1
  496. package/dist/utils/draht-user-agent.js +3 -2
  497. package/dist/utils/draht-user-agent.js.map +1 -1
  498. package/dist/utils/image-convert.d.ts +12 -0
  499. package/dist/utils/image-convert.d.ts.map +1 -1
  500. package/dist/utils/image-convert.js +45 -6
  501. package/dist/utils/image-convert.js.map +1 -1
  502. package/dist/utils/image-resize-core.d.ts +12 -0
  503. package/dist/utils/image-resize-core.d.ts.map +1 -1
  504. package/dist/utils/image-resize-core.js +5 -0
  505. package/dist/utils/image-resize-core.js.map +1 -1
  506. package/dist/utils/image-resize-worker.js +3 -2
  507. package/dist/utils/image-resize-worker.js.map +1 -1
  508. package/dist/utils/image-resize.d.ts.map +1 -1
  509. package/dist/utils/image-resize.js +9 -10
  510. package/dist/utils/image-resize.js.map +1 -1
  511. package/dist/utils/output-files.d.ts +15 -0
  512. package/dist/utils/output-files.d.ts.map +1 -0
  513. package/dist/utils/output-files.js +30 -0
  514. package/dist/utils/output-files.js.map +1 -0
  515. package/dist/utils/shell.d.ts.map +1 -1
  516. package/dist/utils/shell.js +43 -13
  517. package/dist/utils/shell.js.map +1 -1
  518. package/dist/utils/syntax-highlight.d.ts.map +1 -1
  519. package/dist/utils/syntax-highlight.js +6 -1
  520. package/dist/utils/syntax-highlight.js.map +1 -1
  521. package/dist/utils/tools-manager.d.ts.map +1 -1
  522. package/dist/utils/tools-manager.js +4 -3
  523. package/dist/utils/tools-manager.js.map +1 -1
  524. package/docs/cli-integration.md +1 -1
  525. package/docs/cli.md +30 -26
  526. package/docs/codemode.md +230 -0
  527. package/docs/compaction.md +5 -5
  528. package/docs/containerization.md +1 -1
  529. package/docs/custom-provider.md +53 -1
  530. package/docs/docs.json +17 -1
  531. package/docs/drahtbank.md +163 -0
  532. package/docs/environment-variables.md +5 -2
  533. package/docs/extensions.md +143 -13
  534. package/docs/index.md +1 -1
  535. package/docs/json.md +3 -3
  536. package/docs/keybindings.md +9 -5
  537. package/docs/llama-cpp.md +9 -2
  538. package/docs/mcp.md +59 -3
  539. package/docs/message-types.md +22 -4
  540. package/docs/models-configuration.md +187 -0
  541. package/docs/models.md +67 -4
  542. package/docs/nvidia-rtx-llama-cpp.md +96 -0
  543. package/docs/providers.md +70 -5
  544. package/docs/sdk.md +1 -1
  545. package/docs/settings.md +10 -8
  546. package/docs/terminal-setup.md +14 -0
  547. package/docs/themes.md +4 -2
  548. package/docs/tui.md +71 -1
  549. package/docs/usage.md +1 -1
  550. package/docs/windows.md +16 -2
  551. package/eval/drahtbank/adapters.d.mts +35 -0
  552. package/eval/drahtbank/adapters.mjs +192 -0
  553. package/eval/drahtbank/bank.d.mts +141 -0
  554. package/eval/drahtbank/bank.mjs +515 -0
  555. package/eval/drahtbank/cases-v2.d.mts +28 -0
  556. package/eval/drahtbank/cases-v2.mjs +164 -0
  557. package/eval/drahtbank/cases.d.mts +17 -0
  558. package/eval/drahtbank/cases.mjs +198 -0
  559. package/eval/drahtbank/cli.mjs +120 -0
  560. package/eval/drahtbank/grading-v2.d.mts +26 -0
  561. package/eval/drahtbank/grading-v2.mjs +227 -0
  562. package/eval/drahtbank/isolated-tools.ts +223 -0
  563. package/eval/drahtbank/isolation-worker.mjs +53 -0
  564. package/eval/drahtbank/isolation.d.mts +52 -0
  565. package/eval/drahtbank/isolation.mjs +345 -0
  566. package/eval/drahtbank/runtime-checks.d.mts +15 -0
  567. package/eval/drahtbank/runtime-checks.mjs +187 -0
  568. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  569. package/examples/extensions/minimal-mode.ts +4 -5
  570. package/examples/extensions/overlay-test.ts +2 -2
  571. package/examples/extensions/plan-mode/index.ts +6 -2
  572. package/examples/extensions/subagent/index.ts +4 -6
  573. package/hooks/checks/checks-runtime.cjs +215 -0
  574. package/hooks/checks/git-safety.cjs +198 -0
  575. package/hooks/checks/git-safety.d.cts +1 -0
  576. package/hooks/gsd/draht-post-task.js +78 -39
  577. package/hooks/gsd/draht-quality-gate.js +210 -122
  578. package/hooks/gsd/package.json +3 -0
  579. package/package.json +21 -16
  580. package/prompts/commands/atomic-commit.md +8 -6
  581. package/prompts/commands/brainstorm.md +5 -149
  582. package/prompts/commands/create-verification-skill.md +8 -48
  583. package/prompts/commands/discuss-phase.md +6 -10
  584. package/prompts/commands/execute-phase.md +18 -45
  585. package/prompts/commands/fix.md +16 -128
  586. package/prompts/commands/grill.md +6 -53
  587. package/prompts/commands/init-project.md +13 -18
  588. package/prompts/commands/map-codebase.md +3 -3
  589. package/prompts/commands/new-project.md +12 -17
  590. package/prompts/commands/next-milestone.md +4 -8
  591. package/prompts/commands/orchestrate-loop.md +12 -12
  592. package/prompts/commands/orchestrate.md +12 -11
  593. package/prompts/commands/pause-work.md +1 -1
  594. package/prompts/commands/plan-phase.md +15 -37
  595. package/prompts/commands/quick.md +11 -64
  596. package/prompts/commands/resolve-conflicts.md +2 -15
  597. package/prompts/commands/triage.md +3 -14
  598. package/prompts/commands/verify-work.md +15 -63
  599. package/prompts/commands/why.md +18 -118
  600. package/schemas/keybindings.schema.json +433 -0
  601. package/schemas/models.schema.json +1190 -0
  602. package/schemas/settings.schema.json +849 -0
  603. package/schemas/theme.schema.json +365 -0
  604. package/skills/atomic-reasoning/SKILL.md +6 -105
  605. package/skills/blast-radius/SKILL.md +1 -1
  606. package/skills/epistemics/SKILL.md +12 -87
  607. package/skills/explainers/SKILL.md +1 -1
  608. package/skills/typescript-discipline/SKILL.md +12 -42
  609. package/skills/typescript-discipline/references/patterns.md +25 -266
  610. package/skills/unslop/SKILL.md +14 -105
  611. package/dist/bundle/chunks/anthropic-messages-GAKYXF65.js +0 -6
  612. package/dist/bundle/chunks/azure-openai-responses-ZIXMK6JO.js +0 -2
  613. package/dist/bundle/chunks/chunk-2E5VODES.js +0 -2
  614. package/dist/bundle/chunks/chunk-2VAF4XJI.js +0 -146
  615. package/dist/bundle/chunks/chunk-4TVQYRQY.js +0 -2
  616. package/dist/bundle/chunks/chunk-6MSE6LZ3.js +0 -6
  617. package/dist/bundle/chunks/chunk-6ZJKIMU7.js +0 -2
  618. package/dist/bundle/chunks/chunk-736QBNUZ.js +0 -12
  619. package/dist/bundle/chunks/chunk-7TYCZN4Z.js +0 -137
  620. package/dist/bundle/chunks/chunk-BXSHCX3G.js +0 -11
  621. package/dist/bundle/chunks/chunk-GVXA72ZA.js +0 -2
  622. package/dist/bundle/chunks/chunk-I5OKY6RH.js +0 -11
  623. package/dist/bundle/chunks/chunk-IWTUBX6V.js +0 -4
  624. package/dist/bundle/chunks/chunk-KU5HAKZL.js +0 -4
  625. package/dist/bundle/chunks/chunk-MO3SCGBN.js +0 -18
  626. package/dist/bundle/chunks/chunk-N2QZNJT6.js +0 -65
  627. package/dist/bundle/chunks/chunk-PGJAHC3R.js +0 -107
  628. package/dist/bundle/chunks/chunk-QVFELZW2.js +0 -312
  629. package/dist/bundle/chunks/chunk-RZKPFWMH.js +0 -42
  630. package/dist/bundle/chunks/chunk-SDRCE6OP.js +0 -2
  631. package/dist/bundle/chunks/chunk-SVNWI7EV.js +0 -8
  632. package/dist/bundle/chunks/chunk-TIA2T6EO.js +0 -3
  633. package/dist/bundle/chunks/chunk-TOWVIJ2O.js +0 -1623
  634. package/dist/bundle/chunks/chunk-XBUEMKIY.js +0 -2
  635. package/dist/bundle/chunks/chunk-ZA4QNPJY.js +0 -82
  636. package/dist/bundle/chunks/cloudflare-workers-ai-system-one-MJKOAE5S.js +0 -2
  637. package/dist/bundle/chunks/execute-6N7T7VLY.js +0 -18
  638. package/dist/bundle/chunks/google-generative-ai-RPUPQ6PM.js +0 -2
  639. package/dist/bundle/chunks/google-vertex-EZES5QVQ.js +0 -2
  640. package/dist/bundle/chunks/https-proxy-agent-O2PVUIOI.js +0 -13
  641. package/dist/bundle/chunks/lib-XOG5PI3Y.js +0 -9
  642. package/dist/bundle/chunks/mistral-conversations-AOYGU43Y.js +0 -5
  643. package/dist/bundle/chunks/node-LQ52KV6B.js +0 -16
  644. package/dist/bundle/chunks/openai-codex-responses-M2Y77JEQ.js +0 -10
  645. package/dist/bundle/chunks/openai-completions-A4OKYOYV.js +0 -7
  646. package/dist/bundle/chunks/openai-responses-6IXV53T3.js +0 -3
  647. package/dist/bundle/chunks/openrouter-images-LYV4NKFM.js +0 -2
  648. package/dist/bundle/chunks/pi-messages-KKMEUT3Z.js +0 -8
  649. package/dist/bundle/chunks/runtime-363BOYEO.js +0 -3
  650. package/dist/bundle/chunks/runtime-D3KV73AE.js +0 -2
  651. package/dist/bundle/chunks/settings-manager-GEOZJXFQ.js +0 -2
  652. package/dist/bundle/chunks/src-TIBHS42X.js +0 -4
  653. package/dist/bundle/chunks/typesafe-system-one-YBEEY5XU.js +0 -2
  654. package/dist/bundle/chunks/virtual-modules-RLC4Y5MX.js +0 -2
  655. package/dist/core/provider-attribution.d.ts +0 -4
  656. package/dist/core/provider-attribution.d.ts.map +0 -1
  657. package/dist/core/provider-attribution.js +0 -72
  658. package/dist/core/provider-attribution.js.map +0 -1
  659. package/dist/experimental/micro/api.d.ts +0 -81
  660. package/dist/experimental/micro/api.d.ts.map +0 -1
  661. package/dist/experimental/micro/api.js +0 -2
  662. package/dist/experimental/micro/api.js.map +0 -1
  663. package/dist/experimental/micro/main.d.ts +0 -3
  664. package/dist/experimental/micro/main.d.ts.map +0 -1
  665. package/dist/experimental/micro/main.js +0 -21
  666. package/dist/experimental/micro/main.js.map +0 -1
  667. package/dist/experimental/micro/models.d.ts +0 -11
  668. package/dist/experimental/micro/models.d.ts.map +0 -1
  669. package/dist/experimental/micro/models.js +0 -95
  670. package/dist/experimental/micro/models.js.map +0 -1
  671. package/dist/experimental/micro/runtime.d.ts +0 -12
  672. package/dist/experimental/micro/runtime.d.ts.map +0 -1
  673. package/dist/experimental/micro/runtime.js +0 -465
  674. package/dist/experimental/micro/runtime.js.map +0 -1
  675. package/dist/experimental/micro/sessions.d.ts +0 -10
  676. package/dist/experimental/micro/sessions.d.ts.map +0 -1
  677. package/dist/experimental/micro/sessions.js +0 -41
  678. package/dist/experimental/micro/sessions.js.map +0 -1
  679. package/dist/experimental/micro/tools.d.ts +0 -10
  680. package/dist/experimental/micro/tools.d.ts.map +0 -1
  681. package/dist/experimental/micro/tools.js +0 -96
  682. package/dist/experimental/micro/tools.js.map +0 -1
  683. package/dist/experimental/micro/tui.d.ts +0 -3
  684. package/dist/experimental/micro/tui.d.ts.map +0 -1
  685. package/dist/experimental/micro/tui.js +0 -510
  686. package/dist/experimental/micro/tui.js.map +0 -1
  687. package/dist/experimental/mini/main.d.ts +0 -7
  688. package/dist/experimental/mini/main.d.ts.map +0 -1
  689. package/dist/experimental/mini/main.js +0 -21
  690. package/dist/experimental/mini/main.js.map +0 -1
  691. package/dist/experimental/mini/server/entry.d.ts +0 -3
  692. package/dist/experimental/mini/server/entry.d.ts.map +0 -1
  693. package/dist/experimental/mini/server/entry.js +0 -11
  694. package/dist/experimental/mini/server/entry.js.map +0 -1
  695. package/dist/experimental/mini/server/run.d.ts +0 -13
  696. package/dist/experimental/mini/server/run.d.ts.map +0 -1
  697. package/dist/experimental/mini/server/run.js +0 -150
  698. package/dist/experimental/mini/server/run.js.map +0 -1
  699. package/dist/experimental/mini/shared/protocol.d.ts +0 -127
  700. package/dist/experimental/mini/shared/protocol.d.ts.map +0 -1
  701. package/dist/experimental/mini/shared/protocol.js +0 -13
  702. package/dist/experimental/mini/shared/protocol.js.map +0 -1
  703. package/dist/experimental/mini/shared/rpc.d.ts +0 -49
  704. package/dist/experimental/mini/shared/rpc.d.ts.map +0 -1
  705. package/dist/experimental/mini/shared/rpc.js +0 -171
  706. package/dist/experimental/mini/shared/rpc.js.map +0 -1
  707. package/dist/experimental/mini/shared/transport.d.ts +0 -35
  708. package/dist/experimental/mini/shared/transport.d.ts.map +0 -1
  709. package/dist/experimental/mini/shared/transport.js +0 -94
  710. package/dist/experimental/mini/shared/transport.js.map +0 -1
  711. package/dist/experimental/mini/tui/run.d.ts +0 -9
  712. package/dist/experimental/mini/tui/run.d.ts.map +0 -1
  713. package/dist/experimental/mini/tui/run.js +0 -62
  714. package/dist/experimental/mini/tui/run.js.map +0 -1
  715. package/dist/experimental/mini/tui/session.d.ts +0 -26
  716. package/dist/experimental/mini/tui/session.d.ts.map +0 -1
  717. package/dist/experimental/mini/tui/session.js +0 -94
  718. package/dist/experimental/mini/tui/session.js.map +0 -1
  719. package/dist/experimental/mini/tui/view.d.ts +0 -10
  720. package/dist/experimental/mini/tui/view.d.ts.map +0 -1
  721. package/dist/experimental/mini/tui/view.js +0 -461
  722. package/dist/experimental/mini/tui/view.js.map +0 -1
  723. package/dist/experimental/mini/worker/entry.d.ts +0 -3
  724. package/dist/experimental/mini/worker/entry.d.ts.map +0 -1
  725. package/dist/experimental/mini/worker/entry.js +0 -10
  726. package/dist/experimental/mini/worker/entry.js.map +0 -1
  727. package/dist/experimental/mini/worker/lane-service.d.ts +0 -44
  728. package/dist/experimental/mini/worker/lane-service.d.ts.map +0 -1
  729. package/dist/experimental/mini/worker/lane-service.js +0 -97
  730. package/dist/experimental/mini/worker/lane-service.js.map +0 -1
  731. package/dist/experimental/mini/worker/models-service.d.ts +0 -19
  732. package/dist/experimental/mini/worker/models-service.d.ts.map +0 -1
  733. package/dist/experimental/mini/worker/models-service.js +0 -136
  734. package/dist/experimental/mini/worker/models-service.js.map +0 -1
  735. package/dist/experimental/mini/worker/run.d.ts +0 -14
  736. package/dist/experimental/mini/worker/run.d.ts.map +0 -1
  737. package/dist/experimental/mini/worker/run.js +0 -88
  738. package/dist/experimental/mini/worker/run.js.map +0 -1
  739. package/dist/modes/interactive/theme/theme-json.d.ts +0 -85
  740. package/dist/modes/interactive/theme/theme-json.d.ts.map +0 -1
  741. package/dist/modes/interactive/theme/theme-json.js +0 -132
  742. package/dist/modes/interactive/theme/theme-json.js.map +0 -1
  743. package/dist/modes/interactive/theme/theme-schema.json +0 -361
  744. /package/dist/bundle/chunks/{chunk-ZZD35WKM.js → chunk-MOOADNVS.js} +0 -0
@@ -0,0 +1,187 @@
1
+ # Models Configuration
2
+
3
+ <!-- This file is generated from TypeScript source. Do not edit it manually; run npm run generate:references. -->
4
+
5
+ This reference lists the fields of `models.json`. See [Configure a compatible endpoint](models.md#configure-a-compatible-endpoint) for examples and [Configuration](configuration.md#agent-directory) for the file location.
6
+
7
+ Add `"$schema": "https://raw.githubusercontent.com/draht-dev/draht/main/packages/coding-agent/schemas/models.schema.json"` to `models.json` for editor validation and completion.
8
+
9
+ ## Providers
10
+
11
+ Each key under `providers` is a provider ID. A built-in provider ID changes that provider. Any other ID adds a provider, which needs `baseUrl` and an `api` at provider or model level.
12
+
13
+ | Field | Type | Default | Description |
14
+ |---|---|---|---|
15
+ | `name` | string | | Display name. |
16
+ | `baseUrl` | string | | API base URL. Also applies to the provider's built-in models. |
17
+ | `apiKey` | string | | Literal key, "$NAME" environment interpolation, or "!command" output. |
18
+ | `api` | string | | API for the provider's models, such as "openai-completions", "openai-responses", "anthropic-messages", or "google-generative-ai". |
19
+ | `oauth` | `"radius"` | | OAuth login flow. Requires baseUrl. |
20
+ | `headers` | object | | Request headers. Values resolve like apiKey. |
21
+ | `compat` | [object](#compatibility) | | Provider and model compatibility overrides. |
22
+ | `authHeader` | boolean | `false` | Whether to send the resolved API key as Authorization: Bearer. |
23
+ | `models` | [`object[]`](#models) | | |
24
+ | `modelOverrides` | [object](#model-overrides) | | |
25
+
26
+ ## Models
27
+
28
+ Each `models` entry adds a model to the provider. An entry whose `id` matches an existing model replaces it.
29
+
30
+ | Field | Type | Default | Description |
31
+ |---|---|---|---|
32
+ | `id` | string | | Required. Model ID sent to the API. |
33
+ | `name` | string | | Display name, also matched by --model patterns. |
34
+ | `api` | string | | Overrides the provider api. |
35
+ | `baseUrl` | string | | Overrides the provider baseUrl. |
36
+ | `reasoning` | boolean | `false` | Whether the model supports thinking. |
37
+ | `thinkingLevelMap` | object | | Provider value sent for each thinking level. null marks a level unsupported. Levels the model does not map use the provider's default value through high; xhigh and max are unsupported. |
38
+ | `input` | `("text" \| "image")[]` | `["text"]` | |
39
+ | `inputLimits` | [object](#input-limits) | | |
40
+ | `cost` | object | | |
41
+ | `cost.input` | number | | Required. Input cost in USD per million tokens. |
42
+ | `cost.output` | number | | Required. Output cost in USD per million tokens. |
43
+ | `cost.cacheRead` | number | | Required. Cache-read cost in USD per million tokens. |
44
+ | `cost.cacheWrite` | number | | Required. Cache-write cost in USD per million tokens. |
45
+ | `cost.tiers` | `object[]` | | Request-wide pricing tiers. The highest matching input threshold applies to the full request. |
46
+ | `cost.tiers[].inputTokensAbove` | number | | Required. Use this tier when total request input exceeds this token count. |
47
+ | `cost.tiers[].input` | number | | Required. Input cost in USD per million tokens. |
48
+ | `cost.tiers[].output` | number | | Required. Output cost in USD per million tokens. |
49
+ | `cost.tiers[].cacheRead` | number | | Required. Cache-read cost in USD per million tokens. |
50
+ | `cost.tiers[].cacheWrite` | number | | Required. Cache-write cost in USD per million tokens. |
51
+ | `promptCache` | object | | Best-effort prompt cache lifetime in seconds for the short and long retention tiers. draht warms only tiers with a known lifetime. |
52
+ | `contextWindow` | number | `128000` | Context window in tokens. |
53
+ | `maxTokens` | number | `16384` | Maximum output tokens. |
54
+ | `samplingParams` | object | | Fields merged into every request body. Applies only to OpenAI-compatible APIs. |
55
+ | `samplingParamsByThinkingLevel` | object | | samplingParams per thinking level, merged over samplingParams. |
56
+ | `headers` | object | | Request headers. Values resolve like apiKey. |
57
+ | `compat` | [object](#compatibility) | | Provider and model compatibility overrides. |
58
+
59
+ ## Model overrides
60
+
61
+ Each `modelOverrides` key is the ID of a built-in or extension model. Unknown IDs are ignored. Object fields, such as `cost`, merge with the model's value field by field; other fields replace it.
62
+
63
+ | Field | Type | Default | Description |
64
+ |---|---|---|---|
65
+ | `name` | string | | Display name, also matched by --model patterns. |
66
+ | `reasoning` | boolean | | Whether the model supports thinking. |
67
+ | `thinkingLevelMap` | object | | Provider value sent for each thinking level. null marks a level unsupported. Levels the model does not map use the provider's default value through high; xhigh and max are unsupported. |
68
+ | `input` | `("text" \| "image")[]` | | |
69
+ | `inputLimits` | [object](#input-limits) | | |
70
+ | `cost` | object | | |
71
+ | `cost.input` | number | | Input cost in USD per million tokens. |
72
+ | `cost.output` | number | | Output cost in USD per million tokens. |
73
+ | `cost.cacheRead` | number | | Cache-read cost in USD per million tokens. |
74
+ | `cost.cacheWrite` | number | | Cache-write cost in USD per million tokens. |
75
+ | `cost.tiers` | `object[]` | | Request-wide pricing tiers. The highest matching input threshold applies to the full request. |
76
+ | `cost.tiers[].inputTokensAbove` | number | | Required. Use this tier when total request input exceeds this token count. |
77
+ | `cost.tiers[].input` | number | | Required. Input cost in USD per million tokens. |
78
+ | `cost.tiers[].output` | number | | Required. Output cost in USD per million tokens. |
79
+ | `cost.tiers[].cacheRead` | number | | Required. Cache-read cost in USD per million tokens. |
80
+ | `cost.tiers[].cacheWrite` | number | | Required. Cache-write cost in USD per million tokens. |
81
+ | `promptCache` | object | | Best-effort prompt cache lifetime in seconds for the short and long retention tiers. draht warms only tiers with a known lifetime. |
82
+ | `contextWindow` | number | | Context window in tokens. |
83
+ | `maxTokens` | number | | Maximum output tokens. |
84
+ | `samplingParams` | object | | Fields merged into every request body. Applies only to OpenAI-compatible APIs. |
85
+ | `samplingParamsByThinkingLevel` | object | | samplingParams per thinking level, merged over samplingParams. |
86
+ | `headers` | object | | Request headers. Values resolve like apiKey. |
87
+ | `compat` | [object](#compatibility) | | Provider and model compatibility overrides. |
88
+
89
+ ## Input limits
90
+
91
+ See [Describe model input and caching](models.md#describe-model-input-and-caching).
92
+
93
+ | Field | Type | Default | Description |
94
+ |---|---|---|---|
95
+ | `maxRequestBytes` | integer | | Maximum serialized provider request size in bytes. |
96
+ | `images` | object | | |
97
+ | `images.resize` | object | | Cache-safe resize profile applied before a new image enters conversation history. |
98
+ | `images.resize.maxWidth` | integer | | |
99
+ | `images.resize.maxHeight` | integer | | |
100
+ | `images.resize.maxBytes` | integer | | Maximum base64-encoded payload size in bytes. |
101
+ | `images.resize.jpegQuality` | integer | | |
102
+ | `images.maxPerMessage` | integer | | Maximum images accepted in one provider message. |
103
+ | `images.maxPerRequest` | integer | | Maximum images accepted across one provider request. |
104
+
105
+ ## Compatibility
106
+
107
+ `compat` describes verified differences from an API's standard request and response behavior. Model values override provider values per field. The fields that apply depend on the model's `api`.
108
+
109
+ ### `openai-completions`
110
+
111
+ | Field | Type | Default | Description |
112
+ |---|---|---|---|
113
+ | `supportsStore` | boolean | | Whether the provider supports the store field. Default: auto-detected from URL. |
114
+ | `supportsDeveloperRole` | boolean | | Whether the provider supports the developer role instead of system. Default: auto-detected from URL. |
115
+ | `supportsReasoningEffort` | boolean | | Whether the provider supports reasoning_effort. Default: auto-detected from URL. |
116
+ | `supportsUsageInStreaming` | boolean | `true` | Whether the provider supports stream_options.include_usage for token usage in streaming responses. |
117
+ | `supportsFinishReason` | boolean | `true` | Whether streamed responses include finish_reason. When false, pi infers stop or toolUse when the stream ends. |
118
+ | `maxTokensField` | `"max_completion_tokens" \| "max_tokens"` | | Which field to use for max tokens. Default: auto-detected from URL. |
119
+ | `requiresToolResultName` | boolean | | Whether tool results require the name field. Default: auto-detected from URL. |
120
+ | `requiresAssistantAfterToolResult` | boolean | | Whether a user message after tool results requires an assistant message in between. Default: auto-detected from URL. |
121
+ | `requiresThinkingAsText` | boolean | | Whether thinking blocks must be converted to text blocks with &lt;thinking> delimiters. Default: auto-detected from URL. |
122
+ | `requiresReasoningContentOnAssistantMessages` | boolean | | Whether all replayed assistant messages must include an empty reasoning_content field when reasoning is enabled. Default: auto-detected from URL. |
123
+ | `thinkingFormat` | `"openai" \| "openrouter" \| "deepseek" \| "together" \| "baseten" \| "zai" \| "qwen" \| "chat-template" \| "qwen-chat-template" \| "string-thinking" \| "ant-ling"` | | Format for reasoning or thinking parameters. When omitted, draht auto-detects the format from the provider URL. "openai" uses reasoning_effort, "openrouter" uses reasoning.effort, "deepseek" uses thinking.type plus reasoning_effort when supported, "together" uses reasoning.enabled plus reasoning_effort when supported, "baseten" uses configurable chat_template_args plus reasoning_effort when supported, "zai" uses thinking.type, "qwen" uses top-level enable_thinking, "qwen-chat-template" uses chat_template_kwargs.enable_thinking and preserve_thinking, "chat-template" uses configurable chat_template_kwargs, "string-thinking" uses top-level thinking, and "ant-ling" uses reasoning.effort only when the mapped effort is non-null. |
124
+ | `chatTemplateKwargs` | object | | Kwargs sent as chat_template_kwargs when thinkingFormat is "chat-template". Use $var with "thinking.enabled", "thinking.effort", or "thinking.budget" for pi-controlled values. |
125
+ | `chatTemplateArgs` | object | | Arguments sent as chat_template_args when thinkingFormat is "baseten". Use $var with "thinking.enabled", "thinking.effort", or "thinking.budget" for pi-controlled values. |
126
+ | `openRouterRouting` | object | | OpenRouter provider routing preferences. Controls which upstream providers OpenRouter routes requests to. Sent as the provider field in the OpenRouter API request body. See https://openrouter.ai/docs/guides/routing/provider-selection. |
127
+ | `vercelGatewayRouting` | object | | Vercel AI Gateway routing preferences. Controls which upstream providers the gateway routes requests to. See https://vercel.com/docs/ai-gateway/models-and-providers/provider-options. |
128
+ | `zaiToolStream` | boolean | `false` | Whether z.ai supports top-level tool_stream for streaming tool call deltas. |
129
+ | `thinkingTokenBudgetField` | `"thinking_token_budget" \| "thinking_budget" \| "thinking_budget_tokens"` | | Top-level request field used to cap reasoning tokens from thinkingBudgets. Reasoning and the answer share max_tokens on these endpoints. "thinking_token_budget" is vLLM, "thinking_budget" is Qwen, DashScope, or SGLang, and "thinking_budget_tokens" is llama.cpp. Off by default and not set on the generated catalog. |
130
+ | `supportsThinkingTokenBudget` | boolean | `false` | Alias for thinkingTokenBudgetField: "thinking_token_budget" (vLLM). Prefer thinkingTokenBudgetField. |
131
+ | `supportsOpenAIGrammarTools` | boolean | `false` | Whether the provider supports OpenAI custom tools with Lark or regex grammar formats. When false, grammar-constrained tools fall back to normal function tools. The generated catalog enables this for capable models. |
132
+ | `supportsMidConvoSystemMessages` | boolean | `false` | Whether the exact model accepts system or developer messages after the conversation has started. When false, later system messages are folded into the leading system message. The generated catalog enables this for verified models. |
133
+ | `supportsMidConvoToolAdditions` | boolean | `false` | Whether system messages can introduce additional tools mid-conversation. Requires supportsMidConvoSystemMessages. The generated catalog enables this for capable models. |
134
+ | `supportsStrictMode` | boolean | `false` | Whether the provider supports the strict field in tool definitions. Generated capable models enable it explicitly. |
135
+ | `cacheControlFormat` | `"anthropic"` | | Cache control convention for prompt caching. Anthropic applies cache_control markers to the system prompt, last tool definition, and last user, assistant, or tool-result text content. |
136
+ | `sendSessionAffinityHeaders` | boolean | | Whether to send session-affinity data from options.sessionId. Default: true for OpenRouter endpoints, false otherwise. |
137
+ | `sessionAffinityFormat` | `"openai" \| "openai-nosession" \| "openrouter"` | | Session-affinity header format. openai sends session_id, x-client-request-id, and x-session-affinity; openai-nosession sends x-client-request-id and x-session-affinity; openrouter sends x-session-id. Does not affect prompt_cache_key. Default: auto-detected. |
138
+ | `supportsLongCacheRetention` | boolean | | Whether the provider supports long prompt cache retention (prompt_cache_retention: "24h" or Anthropic-style cache_control.ttl: "1h", depending on format). Default: auto-detected from provider and URL. |
139
+ | `vllmPriority` | number | | vLLM scheduler priority sent as the top-level priority request field. Lower values are handled earlier and the server default is 0. Only meaningful with --scheduling-policy priority. Off by default and not set on the generated catalog. |
140
+
141
+ ### `openai-responses`
142
+
143
+ Also applies to `azure-openai-responses` and `openai-codex-responses`.
144
+
145
+ | Field | Type | Default | Description |
146
+ |---|---|---|---|
147
+ | `supportsDeveloperRole` | boolean | `true` | Whether the provider supports the developer role instead of system. |
148
+ | `supportsMidConvoSystemMessages` | boolean | `false` | Whether the exact model accepts developer or system messages after the conversation has started. When false, later system messages are folded into the leading system message. The generated catalog enables this for verified models. |
149
+ | `sessionAffinityFormat` | `"openai" \| "openai-nosession" \| "openrouter"` | | Session-affinity header format. openai sends session_id and x-client-request-id; openai-nosession sends x-client-request-id; openrouter sends x-session-id. Does not affect prompt_cache_key. Default: auto-detected. |
150
+ | `supportsLongCacheRetention` | boolean | `true` | Whether the provider supports long prompt cache retention. This uses prompt_cache_options.ttl: "30m" on GPT-5.6+ and prompt_cache_retention: "24h" on earlier models. |
151
+ | `supportsStrictMode` | boolean | | Whether the provider supports strict JSON-schema function tools. Defaults are API-specific; generated OpenAI models enable it explicitly. |
152
+ | `supportsOpenAIGrammarTools` | boolean | `false` | Whether to emit OpenAI custom tools with Lark or regex grammar formats. When false, grammar-constrained tools fall back to normal function tools. The generated catalog enables this for capable models. |
153
+ | `supportsAdditionalTools` | boolean | `false` | Whether the model supports message-anchored additional_tools input items. |
154
+ | `supportsToolSearch` | boolean | `false` | Whether the model supports client-executed tool search for transcript-anchored additions. |
155
+ | `supportsExplicitPromptCacheMode` | boolean | `false` | Whether the model accepts prompt_cache_options. Older OpenAI models reject the parameter. |
156
+ | `supportsMidConvoEffort` | boolean | `false` | Whether thinking level changes are sent as configuration_update input items instead of changing reasoning.effort, so a change keeps the prompt cache. Only used by the openai-responses API, and ignored with Sign in with ChatGPT on the openai provider. |
157
+ | `supportsMaxOutputTokens` | boolean | `true` | Whether the provider accepts max_output_tokens. Some Codex-protocol gateways reject it. |
158
+
159
+ ### `anthropic-messages`
160
+
161
+ | Field | Type | Default | Description |
162
+ |---|---|---|---|
163
+ | `supportsEagerToolInputStreaming` | boolean | `true` | Whether the provider accepts per-tool eager_input_streaming. When false, the Anthropic provider omits tools[].eager_input_streaming and sends the legacy fine-grained-tool-streaming-2025-05-14 beta header for tool-enabled requests. |
164
+ | `supportsLongCacheRetention` | boolean | `true` | Whether the provider supports Anthropic long cache retention through cache_control.ttl. |
165
+ | `sendSessionAffinityHeaders` | boolean | | Whether to send x-session-affinity from options.sessionId when caching is enabled. Required for providers like Fireworks that use session affinity for prompt cache routing; requests to the same replica maximize cache hits. Default: true for OpenRouter endpoints, false otherwise. |
166
+ | `sessionAffinityFormat` | `"openrouter"` | | Session-affinity format. openrouter sends x-session-id; when unset, sends x-session-affinity. |
167
+ | `supportsCacheControlOnTools` | boolean | `true` | Whether the provider supports Anthropic-style cache_control markers on tool definitions. When false, cache_control is omitted from tool parameters. Some Anthropic-compatible providers, such as Fireworks, do not support this field on tools and may reject or ignore it. |
168
+ | `supportsTemperature` | boolean | `true` | Whether the model accepts the Anthropic temperature request field. Claude Opus 4.7+ rejects non-default values. |
169
+ | `forceAdaptiveThinking` | boolean | `false` | Whether to force adaptive thinking (thinking.type: adaptive plus output_config.effort) regardless of model ID. Built-in models that require adaptive thinking set this in generated metadata. Custom Anthropic-compatible providers can set this to true for any model whose upstream requires the adaptive format. Set false to opt out on overridden built-in models. |
170
+ | `allowEmptySignature` | boolean | `false` | Whether to replay empty thinking signatures instead of converting thinking to text. |
171
+ | `supportsStrictTools` | boolean | `false` | Whether the provider supports Anthropic strict tool schemas. Generated Anthropic models enable it explicitly. |
172
+ | `supportsMidConvoEffort` | boolean | `false` | Whether the exact model transport supports effort-only system messages and thinking binding controls. |
173
+ | `supportsMidConvoSystemMessages` | boolean | `false` | Whether the exact model accepts system-role messages inside the conversation. When false, later system messages are folded into the top-level system prompt. |
174
+ | `supportsMidConvoToolChanges` | boolean | `false` | Whether the exact model accepts mid-conversation tool_addition and tool_removal blocks. Requires supportsMidConvoSystemMessages. |
175
+ | `allowedFallbackModels` | `object[]` | | Models Anthropic accepts for server-side refusal fallback, with local pricing metadata for returned fallback responses. When absent or empty, callers must omit fallbacks; Anthropic rejects the field for models with no permitted fallback targets. |
176
+
177
+ ### `bedrock-converse-stream`
178
+
179
+ | Field | Type | Default | Description |
180
+ |---|---|---|---|
181
+ | `supportsStrictMode` | boolean | `false` | Whether the model supports Bedrock strict tool schemas. |
182
+
183
+ ### `mistral-conversations`
184
+
185
+ | Field | Type | Default | Description |
186
+ |---|---|---|---|
187
+ | `supportsMidConvoSystemMessages` | boolean | `false` | Whether the exact model accepts system messages after the conversation has started. When false, later system messages are folded into the leading system message. |
package/docs/models.md CHANGED
@@ -18,7 +18,7 @@ Run `draht --list-models [search]` to list available providers and model IDs. dr
18
18
 
19
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.
20
20
 
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.
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. [Providers](providers.md) lists the variables and provider-specific setup.
22
22
 
23
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.
24
24
 
@@ -52,6 +52,7 @@ Use [`models.json`](configuration.md#agent-directory) when an endpoint speaks an
52
52
 
53
53
  ```json
54
54
  {
55
+ "$schema": "https://raw.githubusercontent.com/draht-dev/draht/main/packages/coding-agent/schemas/models.schema.json",
55
56
  "providers": {
56
57
  "ollama": {
57
58
  "baseUrl": "http://localhost:11434/v1",
@@ -65,10 +66,22 @@ Use [`models.json`](configuration.md#agent-directory) when an endpoint speaks an
65
66
  }
66
67
  ```
67
68
 
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.
69
+ 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`. `$$` and `$!` produce a literal `$` and `!`. Commands in `models.json` run at request time and are not cached by draht.
69
70
 
70
71
  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.
71
72
 
73
+ To route a built-in provider through a proxy, set only its `baseUrl`. Its models and authentication stay unchanged:
74
+
75
+ ```json
76
+ {
77
+ "providers": {
78
+ "anthropic": { "baseUrl": "https://proxy.example.com/v1" }
79
+ }
80
+ }
81
+ ```
82
+
83
+ [Models Configuration](models-configuration.md) lists every field.
84
+
72
85
  ### Describe model input and caching
73
86
 
74
87
  Use `inputLimits.images.resize` to control how draht encodes new image attachments, `read` results, and tool-result images before storing them in conversation history:
@@ -102,22 +115,51 @@ Use `promptCache` to declare the provider's best-effort cache lifetime in second
102
115
 
103
116
  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).
104
117
 
118
+ ### Configure sampling by thinking level
119
+
120
+ OpenAI-compatible APIs support free-form `samplingParams` model defaults and `samplingParamsByThinkingLevel` overrides. The latter uses draht thinking-level keys (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`), not provider values from `thinkingLevelMap`:
121
+
122
+ ```json
123
+ {
124
+ "id": "qwen-thinking-model",
125
+ "reasoning": true,
126
+ "samplingParams": {
127
+ "temperature": 1.0,
128
+ "top_p": 0.95
129
+ },
130
+ "samplingParamsByThinkingLevel": {
131
+ "off": {
132
+ "temperature": 0.7,
133
+ "top_p": 0.8
134
+ },
135
+ "high": {
136
+ "top_k": 20
137
+ }
138
+ }
139
+ }
140
+ ```
141
+
142
+ draht first clamps unsupported thinking levels, then merges model `samplingParams`, the effective level's override, and request-level `samplingParams` in that order. Later values win per key. Missing levels inherit the model defaults. `modelOverrides` merges per-level entries per key with the base model. These fields apply only to `openai-completions`, `openai-responses`, and `azure-openai-responses`; other APIs ignore them.
143
+
105
144
  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.
106
145
 
107
146
  ## Use classifier models
108
147
 
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:
148
+ 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, Cloudflare's Clef and Clef Flash models from Workers AI, and OpenAI's GPT-6 Luna through the [Decisions API](https://developers.openai.com/api/docs/guides/decisions):
110
149
 
111
150
  | Provider | Model IDs | Authentication |
112
151
  |---|---|---|
113
152
  | `typesafe` | `jev-latest` | `TYPESAFE_API_KEY` |
114
153
  | `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` |
154
+ | `cloudflare-workers-ai` | `typesafe/jev`, `@cf/cloudflare/clef`, `@cf/cloudflare/clef-flash` | `CLOUDFLARE_API_KEY` and `CLOUDFLARE_ACCOUNT_ID` |
116
155
  | `vercel-ai-gateway` | `typesafe-ai/jev` | `AI_GATEWAY_API_KEY` |
117
156
  | `opencode` | `jev-1.13`, `jev-1.13-free` | `OPENCODE_API_KEY` |
157
+ | `openai` | `gpt-6-luna` | `OPENAI_API_KEY` |
118
158
 
119
159
  Chat models on a [llama.cpp router](llama-cpp.md#classification) are also listed as classifier models.
120
160
 
161
+ OpenAI's Decisions API needs an API key. Sign in with ChatGPT credentials do not work with it, so `gpt-6-luna` is not listed as available while `openai` is logged in through `/login`, even when `OPENAI_API_KEY` is set; log out of `openai` to use the key. GPT-6 Luna also judges images passed in `images` (see [Codemode](codemode.md#classify)); other classifier models return an error for them. The API rejects inputs above 922K tokens, but requests that run longer than about five seconds, currently above roughly 600K input tokens, fail with a gateway timeout.
162
+
121
163
  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 })`:
122
164
 
123
165
  ```js
@@ -135,10 +177,31 @@ const result = await models.classify(jev, {
135
177
  return result.answers;
136
178
  ```
137
179
 
180
+ [Codemode](codemode.md#classify) describes the question and answer types.
181
+
138
182
  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.
139
183
 
140
184
  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.
141
185
 
186
+ ## Use image models
187
+
188
+ Image models generate images from a prompt and optional input images. draht lists OpenRouter's image models, such as `google/gemini-2.5-flash-image` and `black-forest-labs/flux.2-pro`, under the `openrouter` provider; they use the same `OPENROUTER_API_KEY` or `/login` credential as its chat models.
189
+
190
+ Like classifier models, image models do not appear in `/model`; the model reaches them through the [`codemode`](cli.md#enable-codemode) tool. Scripts list them with `models.getAvailableOfType("image")` and call `models.generateImages(model, { input })`. The result's `output` holds base64 image blocks, which `image()` attaches to the `codemode` result so the model sees them:
191
+
192
+ ```js
193
+ const painter = await models.getModelOfType("image", "openrouter", "google/gemini-2.5-flash-image");
194
+ const result = await models.generateImages(painter, {
195
+ input: [{ type: "text", text: "A red fox in the snow, watercolor" }],
196
+ });
197
+ if (result.stopReason !== "stop") return result.errorMessage;
198
+ for (const block of result.output) if (block.type === "image") image(block);
199
+ ```
200
+
201
+ `input` can also contain `{ type: "image", data, mimeType }` blocks to edit or use as references. draht adds the usage of a script's image calls to the `codemode` tool result, like classifier calls. Generated images are not saved to disk. [Codemode](codemode.md#generate-images) describes the full API.
202
+
203
+ Extensions generate images through `ctx.modelRegistry.generateImages()`, without codemode.
204
+
142
205
  ## Add a custom provider
143
206
 
144
207
  Use an extension when the provider needs custom streaming, model discovery, or authentication behavior. See [Custom Providers](custom-provider.md) for the extension workflow.
@@ -0,0 +1,96 @@
1
+ # Run draht with NVIDIA RTX and llama.cpp
2
+
3
+ [NVIDIA Local AI Inference Recipes](https://nvidia.github.io/local-ai-inference-recipes/index.html) provides llama.cpp settings tuned for specific NVIDIA hardware and models. Each recipe gives a single-model `llama-server` command. draht works with the llama.cpp router, which can serve and manage several models, so this guide converts the recipe command into a router preset.
4
+
5
+ The examples below use Windows PowerShell. See [Local Models with llama.cpp](llama-cpp.md) for draht's complete router and model-management reference.
6
+
7
+ ## Before you begin
8
+
9
+ 1. Open the [recipe catalog](https://nvidia.github.io/local-ai-inference-recipes/index.html), select your hardware, operating system, and model, then choose **llama.cpp**. Check the prerequisites and memory requirements. Keep the recipe's launch command for the conversion below.
10
+ 2. Install llama.cpp with the recipe's setup instructions. The recipe's settings depend on its build, for example CUDA support or speculative decoding options.
11
+ 3. Run `llama-server --help` and check that it lists `--models-preset`. Without it, the build cannot load the recipe as a router preset. Use a newer build that still meets the recipe's requirements.
12
+ 4. Install draht with the [Quickstart](quickstart.md). On native Windows, also see [Run draht on Windows](windows.md).
13
+
14
+ ## Convert the recipe to a preset
15
+
16
+ A preset lists the settings for one or more models. Each section name becomes the model ID shown in draht. Save the preset next to `llama-server`, or pass its full path when starting the router.
17
+
18
+ Convert each option from the recipe command into one preset line:
19
+
20
+ - Remove the leading dashes: `--ctx-size 65536` becomes `ctx-size = 65536`.
21
+ - Write options without a value as `true`: `--jinja` becomes `jinja = true`.
22
+ - Remove quotes and PowerShell line-continuation backticks around values.
23
+ - Leave out `--host` and `--port`. They belong on the router command line.
24
+ - Add `load-on-startup = true` so the router loads the model when it starts.
25
+ - Replace short model-file options with their long preset keys:
26
+
27
+ | Recipe option | Preset key |
28
+ |---|---|
29
+ | `-hf` | `hf-repo` |
30
+ | `-hff` | `hf-file` |
31
+ | `-hfrd` | `hf-repo-draft` |
32
+ | `--spec-draft-model` | `spec-draft-model` |
33
+
34
+ For example, this recipe command:
35
+
36
+ ```powershell
37
+ llama-server.exe -hf "unsloth/Qwen3.8-27B-GGUF" `
38
+ -hff "Qwen3.8-27B-UD-Q4_K_M.gguf" `
39
+ -hfrd "z-lab/Qwen3.8-27B-DFlash2-GGUF" `
40
+ --spec-draft-model "Qwen3.8-27B-DFlash2-Q4_K_M.gguf" `
41
+ --no-mmproj `
42
+ --host 127.0.0.1 `
43
+ --port 9931 `
44
+ --batch-size 4096 `
45
+ --ubatch-size 1024 `
46
+ --ctx-size 65536 `
47
+ --parallel 1 `
48
+ -ngl 999 `
49
+ --jinja `
50
+ --chat-template-kwargs '{"preserve_thinking":true}' `
51
+ --spec-type draft-dflash `
52
+ --spec-draft-n-max 7 `
53
+ --spec-draft-backend-sampling
54
+ ```
55
+
56
+ becomes `qwen3.8-27b.ini`:
57
+
58
+ ```ini
59
+ version = 1
60
+
61
+ [qwen3.8-27b]
62
+ load-on-startup = true
63
+ hf-repo = unsloth/Qwen3.8-27B-GGUF
64
+ hf-file = Qwen3.8-27B-UD-Q4_K_M.gguf
65
+ hf-repo-draft = z-lab/Qwen3.8-27B-DFlash2-GGUF
66
+ spec-draft-model = Qwen3.8-27B-DFlash2-Q4_K_M.gguf
67
+ no-mmproj = true
68
+ batch-size = 4096
69
+ ubatch-size = 1024
70
+ ctx-size = 65536
71
+ parallel = 1
72
+ ngl = 999
73
+ jinja = true
74
+ chat-template-kwargs = {"preserve_thinking":true}
75
+ spec-type = draft-dflash
76
+ spec-draft-n-max = 7
77
+ spec-draft-backend-sampling = true
78
+ ```
79
+
80
+ ## Start the router
81
+
82
+ Open PowerShell in the llama.cpp folder and run:
83
+
84
+ ```powershell
85
+ .\llama-server.exe --models-preset qwen3.8-27b.ini --host 127.0.0.1 --port 8080
86
+ ```
87
+
88
+ If the recipe requires a Hugging Face token, set `$env:HF_TOKEN` in the same PowerShell window before starting the router. On its first start, the router downloads the model files.
89
+
90
+ Use the [router health checks](llama-cpp.md#troubleshooting) to confirm that the server is ready. In Windows PowerShell, use `curl.exe` rather than `curl`, which PowerShell maps to a different command. The model is ready when `/models` lists `qwen3.8-27b` with the status `loaded`.
91
+
92
+ ## Use the model in draht
93
+
94
+ Follow [Configure draht](llama-cpp.md#configure-draht) and connect to `http://127.0.0.1:8080`. The preset section name is the model ID, so select `qwen3.8-27b` in `/model` for this example.
95
+
96
+ NVIDIA recipe memory settings assume that only the selected model uses the GPU. If `/llama` shows other loaded models, unload them before using the recipe model.
package/docs/providers.md CHANGED
@@ -1,4 +1,4 @@
1
- # Provider Authentication
1
+ # Providers
2
2
 
3
3
  Most hosted providers support one or both of these authentication methods:
4
4
 
@@ -17,7 +17,13 @@ Run `/logout` and select a provider to remove its stored credential. This does n
17
17
 
18
18
  `auth.json` can contain API keys and OAuth tokens. Keep it private and do not commit it.
19
19
 
20
- Radius authentication uses its gateway catalog and caches refreshed model metadata for later offline startup. A custom Radius gateway configured in `models.json` uses its own catalog rather than inheriting the built-in public Radius catalog.
20
+ ## OpenCode Console
21
+
22
+ Run `/login opencode-go` for Go or `/login opencode` for Zen and choose browser sign-in. Open the displayed authorization URL, confirm the device code, and select your organization. Draht saves the resulting OAuth credential in its normal credential store and refreshes it when it expires.
23
+
24
+ The browser can run on another machine; this device flow does not need a localhost callback. If authorization expires or is denied, start `/login` again.
25
+
26
+ API-key login and `OPENCODE_API_KEY` remain available. An expired API key is not a refreshable browser credential: use browser sign-in or replace the key. Zen and Go keep separate provider entries in Draht, so sign in to the provider you intend to use.
21
27
 
22
28
  ## Use an API key from the environment
23
29
 
@@ -28,7 +34,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
28
34
  draht
29
35
  ```
30
36
 
31
- This table covers providers with a single primary API-key variable. Providers that need additional configuration or support ambient credentials are covered under [Cloud providers](#cloud-providers).
37
+ This table covers providers with a single primary API-key variable. Providers that need additional configuration or support ambient credentials are covered under [Provider Specific Config](#provider-specific-config).
32
38
 
33
39
  | Provider | Environment variable |
34
40
  |---|---|
@@ -89,9 +95,9 @@ draht runs the command when the key is first needed and caches its standard outp
89
95
 
90
96
  The llama.cpp router is a local provider. Run `/login llama.cpp` to store the router connection, `/llama` to load or unload models, and `/model` to select a loaded model. See [Local Models with llama.cpp](llama-cpp.md) for server setup and the environment variables that configure the same connection without `/login`.
91
97
 
92
- ## Cloud Providers
98
+ ## Provider Specific Config
93
99
 
94
- The providers below need additional settings or can use credentials supplied by their cloud platform.
100
+ The providers below have additional setup, need additional settings, or can use credentials supplied by their platform.
95
101
 
96
102
  A stored API-key credential can include an `env` object. Its values take priority over the process environment for that provider:
97
103
 
@@ -107,8 +113,44 @@ A stored API-key credential can include an `env` object. Its values take priorit
107
113
  }
108
114
  ```
109
115
 
116
+ ### Radius
117
+
118
+ Radius is an AI gateway by Earendil Works. It provides organization-level controls, analytics, and artifacts for sharing work.
119
+
120
+ To get started, run `/login radius` in draht. This adds Radius as a provider, and its models appear in `/model` like any other provider's.
121
+
122
+ Radius also has an MCP server, so draht can manage Radius for you.
123
+
124
+ Radius is currently in early alpha and evolving quickly. See [radius.earendil.com](https://radius.earendil.com) for more.
125
+
126
+ Radius authentication uses its gateway catalog and caches refreshed model metadata for later offline startup. A custom Radius gateway configured in `models.json` uses its own catalog rather than inheriting the built-in public Radius catalog.
127
+
128
+ ### OpenRouter
129
+
130
+ Authenticate with `/login openrouter` or `OPENROUTER_API_KEY`.
131
+
132
+ With a key, Draht lists only the OpenRouter chat models that key may use, with the key's context size, max output, and prices. These come from OpenRouter's `/models/user` endpoint and reflect guardrails and provider restrictions set in OpenRouter. Image and classifier models are not filtered.
133
+
134
+ Draht refreshes the list in the background at startup in interactive mode, when `/model` opens, after `/login`, and on `draht update --models`. The last list is saved and used offline and in `draht -p` and RPC mode. After switching keys outside `/login`, the previous key's list stays until the next refresh.
135
+
136
+ Regional endpoints filter models to their region. To use one, set the base URL in [`models.json`](models.md#configure-a-compatible-endpoint):
137
+
138
+ ```json
139
+ {
140
+ "providers": {
141
+ "openrouter": { "baseUrl": "https://us.openrouter.ai/api/v1" }
142
+ }
143
+ }
144
+ ```
145
+
146
+ If the base URL rejects the key at `/models/user` or does not have that endpoint, for example a proxy configured as the OpenRouter base URL, Draht lists every OpenRouter model.
147
+
110
148
  ### Azure OpenAI
111
149
 
150
+ The provider ID is `azure` (formerly `azure-openai-responses`). Use it as the key in `auth.json`, `models.json`, and `settings.json`, and in model references such as `--model azure/gpt-5.4`.
151
+
152
+ The `azure` provider serves OpenAI models through the Responses API and Microsoft Foundry models through Chat Completions, such as `azure/deepseek-v4-pro`.
153
+
112
154
  Set an API key plus either a base URL or resource name:
113
155
 
114
156
  ```bash
@@ -120,6 +162,29 @@ export AZURE_OPENAI_RESOURCE_NAME=your-resource
120
162
 
121
163
  Resource root URLs under `ai.azure.com`, `cognitiveservices.azure.com`, and `openai.azure.com` are normalized to the OpenAI API path.
122
164
 
165
+ Draht sends the model ID as the deployment name. If a deployment has a different name, map it with `AZURE_OPENAI_DEPLOYMENT_NAME_MAP`:
166
+
167
+ ```bash
168
+ export AZURE_OPENAI_DEPLOYMENT_NAME_MAP=gpt-5.4=my-gpt-deployment,deepseek-v4-pro=my-deepseek
169
+ ```
170
+
171
+ `AZURE_OPENAI_API_VERSION` overrides the API version for OpenAI models (default `v1`).
172
+
173
+ To use a Foundry model that Draht does not include, add it under `azure` in [`models.json`](models.md#configure-a-compatible-endpoint) with `api: "openai-completions"`. Custom models require a `baseUrl`; `AZURE_OPENAI_BASE_URL` and `AZURE_OPENAI_RESOURCE_NAME` take priority over it when set:
174
+
175
+ ```json
176
+ {
177
+ "providers": {
178
+ "azure": {
179
+ "baseUrl": "https://your-resource.services.ai.azure.com",
180
+ "models": [
181
+ { "id": "your-deployment", "api": "openai-completions" }
182
+ ]
183
+ }
184
+ }
185
+ }
186
+ ```
187
+
123
188
  ### Amazon Bedrock
124
189
 
125
190
  Bedrock can use a bearer token or an ambient AWS credential source:
package/docs/sdk.md CHANGED
@@ -140,7 +140,7 @@ See the focused examples for [models](../examples/sdk/02-custom-model.ts), [tool
140
140
 
141
141
  ## Resources
142
142
 
143
- - [Choose a Model](models.md) covers model selection and compatible endpoints; [Provider Authentication](providers.md) covers credentials and cloud-provider setup.
143
+ - [Choose a Model](models.md) covers model selection and compatible endpoints; [Providers](providers.md) covers credentials and provider-specific setup.
144
144
  - [Configuration](configuration.md) explains normal discovery and settings; [Settings](settings.md) lists every setting.
145
145
  - [Sessions and Context](sessions.md) explains session behavior; [Session Format](session-format.md) defines persisted entries; [Message Types](message-types.md) defines shared transcript values.
146
146
  - [Extensions](extensions.md), [Skills](skills.md), and [Prompt Templates](prompt-templates.md) document resources supplied through a `ResourceLoader`.
package/docs/settings.md CHANGED
@@ -2,6 +2,8 @@
2
2
 
3
3
  This reference lists user-configurable settings, their types, defaults, and purposes. Project settings override agent-directory settings. Resource lists are combined. See [Configuration](configuration.md) for file locations and trust behavior.
4
4
 
5
+ Add `"$schema": "https://raw.githubusercontent.com/draht-dev/draht/main/packages/coding-agent/schemas/settings.schema.json"` to `settings.json` for editor validation and completion.
6
+
5
7
  ## Model and thinking
6
8
 
7
9
  <a id="model-cycling"></a>
@@ -39,7 +41,7 @@ See [Choose a Model](models.md) for model selection and thinking controls.
39
41
  | Setting | Type | Default | Description |
40
42
  |---|---|---|---|
41
43
  | `defaultTools` | `string[]` | `read`, `bash`, `edit`, `write` | Tools enabled at startup. Plain names replace the defaults; `+name` adds a tool and `-name` removes one. An empty array disables all built-in tools but not extension or SDK tools. |
42
- | `codemode.mode` | `"on"` \| `"only"` | `"on"` | How the `codemode` tool presents tools while it is active. `on`: declared tools get their `codemode` declaration appended to their description, and `codemode` lists only tools that are not declared. `only`: `codemode` lists every tool scripts can call, and active built-in and extension tools are hidden from the model, so it reaches them through `codemode`. |
44
+ | `codemode.mode` | `"on"` \| `"only"` | `"on"` | How the `codemode` tool presents tools while it is active. `on`: declared tools get a note on calling them from scripts appended to their description, and `codemode` lists only tools that are not declared. `only`: `codemode` lists every tool scripts can call, and active built-in and extension tools are hidden from the model, so it reaches them through `codemode`. |
43
45
  | `codemode.inlineBudget` | number | `3000` | Estimated tokens (characters / 4) the `codemode` tool's description may spend on tool declarations. Tools that do not fit are left out and found with `searchTools()`. `0` lists only namespaces. |
44
46
  | `polyphase.maxConcurrency` | number | `clamp(availableParallelism() - 2, 2, 8)` | Child agent processes at once across the session (`subagent`, `workflow`, duet). Range 1-16. |
45
47
  | `polyphase.maxAgentsPerRun` | number | `200` | `agent()` calls allowed per workflow run. Range 1-1000. |
@@ -66,9 +68,9 @@ A list of only `+name` and `-name` entries changes the inherited selection inste
66
68
 
67
69
  This replaces `bash` with `powershell` and enables `grep`: `["-bash", "+powershell", "+grep"]`. Project settings apply on top of user settings: a project list with only `+name` and `-name` entries changes the user's selection, and a project list with a plain name replaces it. In one list, plain names form the selection, and `+name` and `-name` then apply in order.
68
70
 
69
- `/reload` enables tools newly added to `defaultTools`. It does not disable tools removed from it or re-enable unchanged tools you turned off. `--tools`, `--no-tools`, and `--no-builtin-tools` override `defaultTools`, also on reload.
71
+ `/reload` enables tools newly added to `defaultTools`. It does not disable tools removed from it or re-enable unchanged tools you turned off. `--tools` with plain names, `--no-tools`, and `--no-builtin-tools` override `defaultTools`, also on reload.
70
72
 
71
- CLI tool options override this setting for one invocation; `--tools` does not accept `+name` or `-name`. See [Command Line](cli.md#tools).
73
+ CLI tool options override this setting for one invocation. `--tools` with only `+name` and `-name` entries changes the resolved `defaultTools` selection instead, for example `draht --tools +codemode`. On `/reload`, these entries apply to the reloaded setting too, so a tool removed with `-name` stays removed. See [Command Line](cli.md#tools).
72
74
 
73
75
  ## Sessions and context
74
76
 
@@ -81,7 +83,7 @@ CLI tool options override this setting for one invocation; `--tools` does not ac
81
83
  | Setting | Type | Default | Description |
82
84
  |---|---|---|---|
83
85
  | `compaction.enabled` | boolean | `true` | Enable automatic compaction. |
84
- | `compaction.reserveTokens` | number | `16384` | Tokens reserved for the model response. |
86
+ | `compaction.reserveTokens` | number | `16384` | Free context tokens below which automatic compaction starts. |
85
87
  | `compaction.keepRecentTokens` | number | `20000` | Recent tokens retained without summarization. |
86
88
  | `compaction.modelOverrides` | object | None | Per-model token settings keyed by exact `provider/modelId`. |
87
89
 
@@ -112,16 +114,16 @@ Checkpoints back `/rewind`. See [Checkpoint commands](cli.md#checkpoint-commands
112
114
  | Setting | Type | Default | Description |
113
115
  |---|---|---|---|
114
116
  | `theme` | string | detected `dark`/`light` | Built-in or custom theme name. Unset detects the terminal's dark/light appearance; `system` derives colors from the terminal theme instead and must be set explicitly. |
115
- | `quietStartup` | boolean | `false` | Hide the startup header. |
116
- | `tuiMode` | `"regular" \| "fullscreen"` | `"regular"` | Interactive terminal UI mode. |
117
+ | `quietStartup` | boolean \| `"header"` | `false` | `true` hides the startup header and loaded-resource listing. `"header"` keeps the header (version and key hints) but hides the model scope line and loaded-resource listing. |
118
+ | `tuiMode` | `"regular" \| "fullscreen"` | `"fullscreen"` | Interactive terminal UI mode. |
117
119
  | `fullscreenExitOutput` | `"transcript" \| "resume-hint"` | `"transcript"` | Output printed when fullscreen mode exits. |
118
120
  | `fullscreenScrollbar` | `"auto" \| "always" \| "hidden"` | `"auto"` | Fullscreen transcript scrollbar behavior. |
119
121
  | `fullscreenCopyOnSelect` | boolean | `true` | Copy selected text automatically in fullscreen mode. |
120
122
  | `fullscreenWheelScrollLines` | `"auto"` \| number | `"auto"` | Lines per mouse-wheel event in fullscreen mode, from 1 to 100. `"auto"` moves one line per event in local macOS terminals, which already accelerate wheel and trackpad input; elsewhere, and over SSH, it speeds up fast wheel spins to at most 6 lines per event. Alt+wheel moves five times as far. |
121
123
  | `editorPaddingX` | number | `0` | Horizontal editor padding from 0 to 3 cells. |
122
- | `outputPad` | `0 \| 1` | `1` | Horizontal transcript padding. |
124
+ | `outputPad` | `0 \| 1` | `1` | Horizontal transcript padding for messages, tool output, `!` command output, and summary blocks. |
123
125
  | `autocompleteMaxVisible` | number | `5` | Visible autocomplete entries, from 3 to 20. |
124
- | `showHardwareCursor` | boolean | `false` | Show the terminal cursor while draht positions it for input methods. |
126
+ | `showHardwareCursor` | boolean | `false` | Use the terminal cursor instead of draht's drawn cursor. draht still positions it for input methods. |
125
127
  | `terminal.showImages` | boolean | `true` | Display inline images when supported. |
126
128
  | `terminal.imageWidthCells` | number | `60` | Preferred inline image width in terminal cells. |
127
129
  | `terminal.clearOnShrink` | boolean | `false` | Clear empty rows when rendered content shrinks. |
@@ -236,3 +236,17 @@ draht automatically detects OSC 8 hyperlinks, inline image protocols, and trueco
236
236
  Settings take precedence over environment variables. An unset value or `auto` preserves automatic detection.
237
237
 
238
238
  Only force a capability supported by the complete terminal path. Unsupported escape sequences can corrupt rendering. See [Environment Variables](environment-variables.md#draht-process-configuration) and [Settings](settings.md) for the canonical value definitions.
239
+
240
+ ## Program status
241
+
242
+ draht reports its state with the [Program Status Protocol (OSC 7501)](https://www.superlogical.com/rex/docs/build/program-status), so terminals and agent dashboards can show whether it is working, waiting for you, done, or failed:
243
+
244
+ | State | When |
245
+ |---|---|
246
+ | `working` | An agent run or compaction is in progress. The message is the session name. |
247
+ | `blocked` | An extension dialog or login waits for you. The message is the dialog title. |
248
+ | `done` | A run finished. The message is the session name. |
249
+ | `error` | A run ended with an error that is not retried. The message is the first line of the error. |
250
+ | `idle` | draht started, or you cancelled the run. |
251
+
252
+ Reports never contain prompts or model output. draht sends them only after the terminal answers the protocol's support query; tmux and screen do not forward them. Set `DRAHT_PROGRAM_STATUS=1` to send reports without asking, or `DRAHT_PROGRAM_STATUS=0` to turn them off.