@draht/coding-agent 2026.5.12 → 2026.6.11

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 (605) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/bin/draht-tools.cjs +3756 -1
  3. package/dist/bun/cli.d.ts.map +1 -1
  4. package/dist/bun/cli.js +4 -2
  5. package/dist/bun/cli.js.map +1 -1
  6. package/dist/bun/restore-sandbox-env.d.ts +13 -0
  7. package/dist/bun/restore-sandbox-env.d.ts.map +1 -0
  8. package/dist/bun/restore-sandbox-env.js +32 -0
  9. package/dist/bun/restore-sandbox-env.js.map +1 -0
  10. package/dist/cli/args.d.ts +9 -4
  11. package/dist/cli/args.d.ts.map +1 -1
  12. package/dist/cli/args.js +88 -35
  13. package/dist/cli/args.js.map +1 -1
  14. package/dist/cli/config-selector.d.ts +2 -2
  15. package/dist/cli/config-selector.d.ts.map +1 -1
  16. package/dist/cli/config-selector.js +1 -1
  17. package/dist/cli/config-selector.js.map +1 -1
  18. package/dist/cli/file-processor.d.ts.map +1 -1
  19. package/dist/cli/file-processor.js +2 -3
  20. package/dist/cli/file-processor.js.map +1 -1
  21. package/dist/cli/initial-message.d.ts +1 -1
  22. package/dist/cli/initial-message.d.ts.map +1 -1
  23. package/dist/cli/initial-message.js.map +1 -1
  24. package/dist/cli/list-models.d.ts +1 -1
  25. package/dist/cli/list-models.d.ts.map +1 -1
  26. package/dist/cli/list-models.js +7 -1
  27. package/dist/cli/list-models.js.map +1 -1
  28. package/dist/cli/project-trust.d.ts +10 -0
  29. package/dist/cli/project-trust.d.ts.map +1 -0
  30. package/dist/cli/project-trust.js +48 -0
  31. package/dist/cli/project-trust.js.map +1 -0
  32. package/dist/cli/session-picker.d.ts +1 -1
  33. package/dist/cli/session-picker.d.ts.map +1 -1
  34. package/dist/cli/session-picker.js.map +1 -1
  35. package/dist/cli/startup-ui.d.ts +16 -0
  36. package/dist/cli/startup-ui.d.ts.map +1 -0
  37. package/dist/cli/startup-ui.js +112 -0
  38. package/dist/cli/startup-ui.js.map +1 -0
  39. package/dist/cli.d.ts.map +1 -1
  40. package/dist/cli.js +7 -4
  41. package/dist/cli.js.map +1 -1
  42. package/dist/config.d.ts +23 -13
  43. package/dist/config.d.ts.map +1 -1
  44. package/dist/config.js +264 -62
  45. package/dist/config.js.map +1 -1
  46. package/dist/core/agent-session-runtime.d.ts +45 -9
  47. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  48. package/dist/core/agent-session-runtime.js +100 -33
  49. package/dist/core/agent-session-runtime.js.map +1 -1
  50. package/dist/core/agent-session-services.d.ts +6 -4
  51. package/dist/core/agent-session-services.d.ts.map +1 -1
  52. package/dist/core/agent-session-services.js +7 -4
  53. package/dist/core/agent-session-services.js.map +1 -1
  54. package/dist/core/agent-session.d.ts +47 -31
  55. package/dist/core/agent-session.d.ts.map +1 -1
  56. package/dist/core/agent-session.js +470 -443
  57. package/dist/core/agent-session.js.map +1 -1
  58. package/dist/core/auth-guidance.d.ts +5 -0
  59. package/dist/core/auth-guidance.d.ts.map +1 -0
  60. package/dist/core/auth-guidance.js +21 -0
  61. package/dist/core/auth-guidance.js.map +1 -0
  62. package/dist/core/auth-storage.d.ts +10 -1
  63. package/dist/core/auth-storage.d.ts.map +1 -1
  64. package/dist/core/auth-storage.js +27 -6
  65. package/dist/core/auth-storage.js.map +1 -1
  66. package/dist/core/bash-executor.d.ts +1 -15
  67. package/dist/core/bash-executor.d.ts.map +1 -1
  68. package/dist/core/bash-executor.js +10 -24
  69. package/dist/core/bash-executor.js.map +1 -1
  70. package/dist/core/builtins/subagent.d.ts.map +1 -1
  71. package/dist/core/builtins/subagent.js +1 -2
  72. package/dist/core/builtins/subagent.js.map +1 -1
  73. package/dist/core/compaction/branch-summarization.d.ts +6 -4
  74. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  75. package/dist/core/compaction/branch-summarization.js +9 -3
  76. package/dist/core/compaction/branch-summarization.js.map +1 -1
  77. package/dist/core/compaction/compaction.d.ts +5 -5
  78. package/dist/core/compaction/compaction.d.ts.map +1 -1
  79. package/dist/core/compaction/compaction.js +43 -37
  80. package/dist/core/compaction/compaction.js.map +1 -1
  81. package/dist/core/compaction/index.d.ts +3 -3
  82. package/dist/core/compaction/index.d.ts.map +1 -1
  83. package/dist/core/compaction/index.js.map +1 -1
  84. package/dist/core/compaction/utils.d.ts +1 -1
  85. package/dist/core/compaction/utils.d.ts.map +1 -1
  86. package/dist/core/compaction/utils.js +1 -1
  87. package/dist/core/compaction/utils.js.map +1 -1
  88. package/dist/core/exec.d.ts.map +1 -1
  89. package/dist/core/exec.js.map +1 -1
  90. package/dist/core/experimental.d.ts +2 -0
  91. package/dist/core/experimental.d.ts.map +1 -0
  92. package/dist/core/experimental.js +4 -0
  93. package/dist/core/experimental.js.map +1 -0
  94. package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
  95. package/dist/core/export-html/ansi-to-html.js +1 -1
  96. package/dist/core/export-html/ansi-to-html.js.map +1 -1
  97. package/dist/core/export-html/index.d.ts +1 -1
  98. package/dist/core/export-html/index.d.ts.map +1 -1
  99. package/dist/core/export-html/index.js +13 -11
  100. package/dist/core/export-html/index.js.map +1 -1
  101. package/dist/core/export-html/template.css +69 -4
  102. package/dist/core/export-html/template.js +231 -57
  103. package/dist/core/export-html/tool-renderer.d.ts +0 -6
  104. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  105. package/dist/core/export-html/tool-renderer.js +15 -2
  106. package/dist/core/export-html/tool-renderer.js.map +1 -1
  107. package/dist/core/extensions/index.d.ts +8 -8
  108. package/dist/core/extensions/index.d.ts.map +1 -1
  109. package/dist/core/extensions/index.js.map +1 -1
  110. package/dist/core/extensions/loader.d.ts +3 -3
  111. package/dist/core/extensions/loader.d.ts.map +1 -1
  112. package/dist/core/extensions/loader.js +27 -35
  113. package/dist/core/extensions/loader.js.map +1 -1
  114. package/dist/core/extensions/runner.d.ts +30 -12
  115. package/dist/core/extensions/runner.d.ts.map +1 -1
  116. package/dist/core/extensions/runner.js +215 -32
  117. package/dist/core/extensions/runner.js.map +1 -1
  118. package/dist/core/extensions/types.d.ts +163 -35
  119. package/dist/core/extensions/types.d.ts.map +1 -1
  120. package/dist/core/extensions/types.js.map +1 -1
  121. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  122. package/dist/core/extensions/wrapper.js +2 -2
  123. package/dist/core/extensions/wrapper.js.map +1 -1
  124. package/dist/core/footer-data-provider.d.ts +7 -1
  125. package/dist/core/footer-data-provider.d.ts.map +1 -1
  126. package/dist/core/footer-data-provider.js +78 -54
  127. package/dist/core/footer-data-provider.js.map +1 -1
  128. package/dist/core/http-dispatcher.d.ts +21 -0
  129. package/dist/core/http-dispatcher.d.ts.map +1 -0
  130. package/dist/core/http-dispatcher.js +48 -0
  131. package/dist/core/http-dispatcher.js.map +1 -0
  132. package/dist/core/index.d.ts +9 -8
  133. package/dist/core/index.d.ts.map +1 -1
  134. package/dist/core/index.js +2 -1
  135. package/dist/core/index.js.map +1 -1
  136. package/dist/core/keybindings.d.ts +66 -1
  137. package/dist/core/keybindings.d.ts.map +1 -1
  138. package/dist/core/keybindings.js +56 -1
  139. package/dist/core/keybindings.js.map +1 -1
  140. package/dist/core/model-registry.d.ts +22 -4
  141. package/dist/core/model-registry.d.ts.map +1 -1
  142. package/dist/core/model-registry.js +216 -44
  143. package/dist/core/model-registry.js.map +1 -1
  144. package/dist/core/model-resolver.d.ts +2 -1
  145. package/dist/core/model-resolver.d.ts.map +1 -1
  146. package/dist/core/model-resolver.js +48 -21
  147. package/dist/core/model-resolver.js.map +1 -1
  148. package/dist/core/output-guard.d.ts +1 -0
  149. package/dist/core/output-guard.d.ts.map +1 -1
  150. package/dist/core/output-guard.js +52 -22
  151. package/dist/core/output-guard.js.map +1 -1
  152. package/dist/core/package-manager.d.ts +17 -2
  153. package/dist/core/package-manager.d.ts.map +1 -1
  154. package/dist/core/package-manager.js +363 -121
  155. package/dist/core/package-manager.js.map +1 -1
  156. package/dist/core/project-trust.d.ts +15 -0
  157. package/dist/core/project-trust.d.ts.map +1 -0
  158. package/dist/core/project-trust.js +58 -0
  159. package/dist/core/project-trust.js.map +1 -0
  160. package/dist/core/prompt-templates.d.ts +13 -11
  161. package/dist/core/prompt-templates.d.ts.map +1 -1
  162. package/dist/core/prompt-templates.js +67 -76
  163. package/dist/core/prompt-templates.js.map +1 -1
  164. package/dist/core/provider-attribution.d.ts +4 -0
  165. package/dist/core/provider-attribution.d.ts.map +1 -0
  166. package/dist/core/provider-attribution.js +72 -0
  167. package/dist/core/provider-attribution.js.map +1 -0
  168. package/dist/core/provider-display-names.d.ts +2 -0
  169. package/dist/core/provider-display-names.d.ts.map +1 -0
  170. package/dist/core/provider-display-names.js +36 -0
  171. package/dist/core/provider-display-names.js.map +1 -0
  172. package/dist/core/resolve-config-value.d.ts +9 -1
  173. package/dist/core/resolve-config-value.d.ts.map +1 -1
  174. package/dist/core/resolve-config-value.js +134 -11
  175. package/dist/core/resolve-config-value.js.map +1 -1
  176. package/dist/core/resource-loader.d.ts +34 -14
  177. package/dist/core/resource-loader.d.ts.map +1 -1
  178. package/dist/core/resource-loader.js +165 -76
  179. package/dist/core/resource-loader.js.map +1 -1
  180. package/dist/core/sdk.d.ts +26 -10
  181. package/dist/core/sdk.d.ts.map +1 -1
  182. package/dist/core/sdk.js +45 -16
  183. package/dist/core/sdk.js.map +1 -1
  184. package/dist/core/session-manager.d.ts +11 -12
  185. package/dist/core/session-manager.d.ts.map +1 -1
  186. package/dist/core/session-manager.js +245 -132
  187. package/dist/core/session-manager.js.map +1 -1
  188. package/dist/core/settings-manager.d.ts +52 -5
  189. package/dist/core/settings-manager.d.ts.map +1 -1
  190. package/dist/core/settings-manager.js +202 -38
  191. package/dist/core/settings-manager.js.map +1 -1
  192. package/dist/core/skills.d.ts +10 -10
  193. package/dist/core/skills.d.ts.map +1 -1
  194. package/dist/core/skills.js +13 -35
  195. package/dist/core/skills.js.map +1 -1
  196. package/dist/core/slash-commands.d.ts +1 -1
  197. package/dist/core/slash-commands.d.ts.map +1 -1
  198. package/dist/core/slash-commands.js +7 -4
  199. package/dist/core/slash-commands.js.map +1 -1
  200. package/dist/core/source-info.d.ts +1 -1
  201. package/dist/core/source-info.d.ts.map +1 -1
  202. package/dist/core/source-info.js.map +1 -1
  203. package/dist/core/system-prompt.d.ts +4 -4
  204. package/dist/core/system-prompt.d.ts.map +1 -1
  205. package/dist/core/system-prompt.js +14 -10
  206. package/dist/core/system-prompt.js.map +1 -1
  207. package/dist/core/telemetry.d.ts +3 -0
  208. package/dist/core/telemetry.d.ts.map +1 -0
  209. package/dist/core/telemetry.js +9 -0
  210. package/dist/core/telemetry.js.map +1 -0
  211. package/dist/core/tools/bash.d.ts +11 -16
  212. package/dist/core/tools/bash.d.ts.map +1 -1
  213. package/dist/core/tools/bash.js +162 -177
  214. package/dist/core/tools/bash.js.map +1 -1
  215. package/dist/core/tools/edit-diff.d.ts +3 -1
  216. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  217. package/dist/core/tools/edit-diff.js +11 -3
  218. package/dist/core/tools/edit-diff.js.map +1 -1
  219. package/dist/core/tools/edit.d.ts +22 -24
  220. package/dist/core/tools/edit.d.ts.map +1 -1
  221. package/dist/core/tools/edit.js +199 -111
  222. package/dist/core/tools/edit.js.map +1 -1
  223. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  224. package/dist/core/tools/file-mutation-queue.js +27 -12
  225. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  226. package/dist/core/tools/find.d.ts +7 -18
  227. package/dist/core/tools/find.d.ts.map +1 -1
  228. package/dist/core/tools/find.js +134 -95
  229. package/dist/core/tools/find.js.map +1 -1
  230. package/dist/core/tools/grep.d.ts +11 -30
  231. package/dist/core/tools/grep.d.ts.map +1 -1
  232. package/dist/core/tools/grep.js +23 -12
  233. package/dist/core/tools/grep.js.map +1 -1
  234. package/dist/core/tools/index.d.ts +26 -101
  235. package/dist/core/tools/index.d.ts.map +1 -1
  236. package/dist/core/tools/index.js +78 -52
  237. package/dist/core/tools/index.js.map +1 -1
  238. package/dist/core/tools/ls.d.ts +6 -15
  239. package/dist/core/tools/ls.d.ts.map +1 -1
  240. package/dist/core/tools/ls.js +12 -17
  241. package/dist/core/tools/ls.js.map +1 -1
  242. package/dist/core/tools/output-accumulator.d.ts +52 -0
  243. package/dist/core/tools/output-accumulator.d.ts.map +1 -0
  244. package/dist/core/tools/output-accumulator.js +184 -0
  245. package/dist/core/tools/output-accumulator.js.map +1 -0
  246. package/dist/core/tools/path-utils.d.ts +2 -0
  247. package/dist/core/tools/path-utils.d.ts.map +1 -1
  248. package/dist/core/tools/path-utils.js +40 -22
  249. package/dist/core/tools/path-utils.js.map +1 -1
  250. package/dist/core/tools/read.d.ts +7 -18
  251. package/dist/core/tools/read.d.ts.map +1 -1
  252. package/dist/core/tools/read.js +100 -36
  253. package/dist/core/tools/read.js.map +1 -1
  254. package/dist/core/tools/render-utils.d.ts +5 -2
  255. package/dist/core/tools/render-utils.d.ts.map +1 -1
  256. package/dist/core/tools/render-utils.js +18 -2
  257. package/dist/core/tools/render-utils.js.map +1 -1
  258. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  259. package/dist/core/tools/tool-definition-wrapper.js +2 -0
  260. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  261. package/dist/core/tools/truncate.d.ts.map +1 -1
  262. package/dist/core/tools/truncate.js +12 -2
  263. package/dist/core/tools/truncate.js.map +1 -1
  264. package/dist/core/tools/write.d.ts +5 -14
  265. package/dist/core/tools/write.d.ts.map +1 -1
  266. package/dist/core/tools/write.js +27 -46
  267. package/dist/core/tools/write.js.map +1 -1
  268. package/dist/core/trust-manager.d.ts +31 -0
  269. package/dist/core/trust-manager.d.ts.map +1 -0
  270. package/dist/core/trust-manager.js +187 -0
  271. package/dist/core/trust-manager.js.map +1 -0
  272. package/dist/index.d.ts +31 -29
  273. package/dist/index.d.ts.map +1 -1
  274. package/dist/index.js +9 -8
  275. package/dist/index.js.map +1 -1
  276. package/dist/main.d.ts +5 -1
  277. package/dist/main.d.ts.map +1 -1
  278. package/dist/main.js +170 -87
  279. package/dist/main.js.map +1 -1
  280. package/dist/migrations.d.ts +2 -2
  281. package/dist/migrations.d.ts.map +1 -1
  282. package/dist/migrations.js +127 -5
  283. package/dist/migrations.js.map +1 -1
  284. package/dist/modes/index.d.ts +5 -5
  285. package/dist/modes/index.d.ts.map +1 -1
  286. package/dist/modes/index.js.map +1 -1
  287. package/dist/modes/interactive/components/assistant-message.d.ts +2 -0
  288. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  289. package/dist/modes/interactive/components/assistant-message.js +14 -0
  290. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  291. package/dist/modes/interactive/components/bash-execution.d.ts +1 -1
  292. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
  293. package/dist/modes/interactive/components/bash-execution.js +3 -3
  294. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  295. package/dist/modes/interactive/components/bordered-loader.d.ts.map +1 -1
  296. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  297. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  298. package/dist/modes/interactive/components/config-selector.d.ts +4 -4
  299. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  300. package/dist/modes/interactive/components/config-selector.js +38 -11
  301. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  302. package/dist/modes/interactive/components/countdown-timer.d.ts +2 -2
  303. package/dist/modes/interactive/components/countdown-timer.d.ts.map +1 -1
  304. package/dist/modes/interactive/components/countdown-timer.js +2 -2
  305. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  306. package/dist/modes/interactive/components/custom-editor.d.ts +1 -1
  307. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  308. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  309. package/dist/modes/interactive/components/custom-message.d.ts +2 -2
  310. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  311. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  312. package/dist/modes/interactive/components/diff.d.ts.map +1 -1
  313. package/dist/modes/interactive/components/diff.js.map +1 -1
  314. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -1
  315. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -1
  316. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  317. package/dist/modes/interactive/components/extension-editor.js +14 -6
  318. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  319. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  320. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  321. package/dist/modes/interactive/components/extension-selector.d.ts +2 -0
  322. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  323. package/dist/modes/interactive/components/extension-selector.js +8 -3
  324. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  325. package/dist/modes/interactive/components/first-time-setup.d.ts +25 -0
  326. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -0
  327. package/dist/modes/interactive/components/first-time-setup.js +103 -0
  328. package/dist/modes/interactive/components/first-time-setup.js.map +1 -0
  329. package/dist/modes/interactive/components/footer.d.ts +2 -1
  330. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  331. package/dist/modes/interactive/components/footer.js +23 -7
  332. package/dist/modes/interactive/components/footer.js.map +1 -1
  333. package/dist/modes/interactive/components/index.d.ts +33 -31
  334. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  335. package/dist/modes/interactive/components/index.js +2 -0
  336. package/dist/modes/interactive/components/index.js.map +1 -1
  337. package/dist/modes/interactive/components/keybinding-hints.d.ts +5 -0
  338. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -1
  339. package/dist/modes/interactive/components/keybinding-hints.js +19 -5
  340. package/dist/modes/interactive/components/keybinding-hints.js.map +1 -1
  341. package/dist/modes/interactive/components/login-dialog.d.ts +12 -2
  342. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  343. package/dist/modes/interactive/components/login-dialog.js +46 -11
  344. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  345. package/dist/modes/interactive/components/model-selector.d.ts +2 -2
  346. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  347. package/dist/modes/interactive/components/model-selector.js +8 -5
  348. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  349. package/dist/modes/interactive/components/oauth-selector.d.ts +18 -6
  350. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  351. package/dist/modes/interactive/components/oauth-selector.js +93 -25
  352. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  353. package/dist/modes/interactive/components/scoped-models-selector.d.ts +5 -12
  354. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  355. package/dist/modes/interactive/components/scoped-models-selector.js +45 -30
  356. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  357. package/dist/modes/interactive/components/session-selector.d.ts +2 -1
  358. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  359. package/dist/modes/interactive/components/session-selector.js +20 -7
  360. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  361. package/dist/modes/interactive/components/settings-selector.d.ts +13 -0
  362. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  363. package/dist/modes/interactive/components/settings-selector.js +113 -4
  364. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  365. package/dist/modes/interactive/components/skill-invocation-message.d.ts +1 -1
  366. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  367. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  368. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  369. package/dist/modes/interactive/components/thinking-selector.js +1 -1
  370. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  371. package/dist/modes/interactive/components/tool-execution.d.ts +6 -1
  372. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  373. package/dist/modes/interactive/components/tool-execution.js +57 -14
  374. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  375. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  376. package/dist/modes/interactive/components/tree-selector.js +18 -9
  377. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  378. package/dist/modes/interactive/components/trust-selector.d.ts +23 -0
  379. package/dist/modes/interactive/components/trust-selector.d.ts.map +1 -0
  380. package/dist/modes/interactive/components/trust-selector.js +91 -0
  381. package/dist/modes/interactive/components/trust-selector.js.map +1 -0
  382. package/dist/modes/interactive/components/user-message-selector.d.ts +2 -2
  383. package/dist/modes/interactive/components/user-message-selector.d.ts.map +1 -1
  384. package/dist/modes/interactive/components/user-message-selector.js +8 -7
  385. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  386. package/dist/modes/interactive/components/user-message.d.ts +1 -0
  387. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  388. package/dist/modes/interactive/components/user-message.js +8 -7
  389. package/dist/modes/interactive/components/user-message.js.map +1 -1
  390. package/dist/modes/interactive/interactive-mode.d.ts +68 -13
  391. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  392. package/dist/modes/interactive/interactive-mode.js +1100 -319
  393. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  394. package/dist/modes/interactive/theme/dark.json +5 -4
  395. package/dist/modes/interactive/theme/light.json +5 -4
  396. package/dist/modes/interactive/theme/theme.d.ts +22 -3
  397. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  398. package/dist/modes/interactive/theme/theme.js +160 -105
  399. package/dist/modes/interactive/theme/theme.js.map +1 -1
  400. package/dist/modes/print-mode.d.ts.map +1 -1
  401. package/dist/modes/print-mode.js +40 -20
  402. package/dist/modes/print-mode.js.map +1 -1
  403. package/dist/modes/rpc/rpc-client.d.ts +11 -1
  404. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  405. package/dist/modes/rpc/rpc-client.js +73 -8
  406. package/dist/modes/rpc/rpc-client.js.map +1 -1
  407. package/dist/modes/rpc/rpc-mode.d.ts +2 -2
  408. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  409. package/dist/modes/rpc/rpc-mode.js +96 -30
  410. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  411. package/dist/modes/rpc/rpc-types.d.ts +16 -4
  412. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  413. package/dist/modes/rpc/rpc-types.js.map +1 -1
  414. package/dist/package-manager-cli.d.ts +6 -2
  415. package/dist/package-manager-cli.d.ts.map +1 -1
  416. package/dist/package-manager-cli.js +396 -21
  417. package/dist/package-manager-cli.js.map +1 -1
  418. package/dist/prompts/commands/map-codebase.md +14 -0
  419. package/dist/utils/ansi.d.ts +2 -0
  420. package/dist/utils/ansi.d.ts.map +1 -0
  421. package/dist/utils/ansi.js +52 -0
  422. package/dist/utils/ansi.js.map +1 -0
  423. package/dist/utils/changelog.d.ts +2 -1
  424. package/dist/utils/changelog.d.ts.map +1 -1
  425. package/dist/utils/changelog.js +78 -0
  426. package/dist/utils/changelog.js.map +1 -1
  427. package/dist/utils/child-process.d.ts +5 -1
  428. package/dist/utils/child-process.d.ts.map +1 -1
  429. package/dist/utils/child-process.js +10 -0
  430. package/dist/utils/child-process.js.map +1 -1
  431. package/dist/utils/clipboard-image.d.ts.map +1 -1
  432. package/dist/utils/clipboard-image.js +2 -2
  433. package/dist/utils/clipboard-image.js.map +1 -1
  434. package/dist/utils/clipboard-native.d.ts +3 -1
  435. package/dist/utils/clipboard-native.d.ts.map +1 -1
  436. package/dist/utils/clipboard-native.js +14 -8
  437. package/dist/utils/clipboard-native.js.map +1 -1
  438. package/dist/utils/clipboard.d.ts.map +1 -1
  439. package/dist/utils/clipboard.js +84 -45
  440. package/dist/utils/clipboard.js.map +1 -1
  441. package/dist/utils/deprecation.d.ts +4 -0
  442. package/dist/utils/deprecation.d.ts.map +1 -0
  443. package/dist/utils/deprecation.js +13 -0
  444. package/dist/utils/deprecation.js.map +1 -0
  445. package/dist/utils/exif-orientation.d.ts +1 -1
  446. package/dist/utils/exif-orientation.d.ts.map +1 -1
  447. package/dist/utils/exif-orientation.js.map +1 -1
  448. package/dist/utils/fs-watch.d.ts +5 -0
  449. package/dist/utils/fs-watch.d.ts.map +1 -0
  450. package/dist/utils/fs-watch.js +25 -0
  451. package/dist/utils/fs-watch.js.map +1 -0
  452. package/dist/utils/git.d.ts.map +1 -1
  453. package/dist/utils/git.js +54 -22
  454. package/dist/utils/git.js.map +1 -1
  455. package/dist/utils/html.d.ts +7 -0
  456. package/dist/utils/html.d.ts.map +1 -0
  457. package/dist/utils/html.js +40 -0
  458. package/dist/utils/html.js.map +1 -0
  459. package/dist/utils/image-convert.d.ts.map +1 -1
  460. package/dist/utils/image-convert.js.map +1 -1
  461. package/dist/utils/image-resize-core.d.ts +30 -0
  462. package/dist/utils/image-resize-core.d.ts.map +1 -0
  463. package/dist/utils/image-resize-core.js +124 -0
  464. package/dist/utils/image-resize-core.js.map +1 -0
  465. package/dist/utils/image-resize-worker.d.ts +2 -0
  466. package/dist/utils/image-resize-worker.d.ts.map +1 -0
  467. package/dist/utils/image-resize-worker.js +31 -0
  468. package/dist/utils/image-resize-worker.js.map +1 -0
  469. package/dist/utils/image-resize.d.ts +7 -27
  470. package/dist/utils/image-resize.d.ts.map +1 -1
  471. package/dist/utils/image-resize.js +75 -115
  472. package/dist/utils/image-resize.js.map +1 -1
  473. package/dist/utils/json.d.ts +3 -0
  474. package/dist/utils/json.d.ts.map +1 -0
  475. package/dist/utils/json.js +7 -0
  476. package/dist/utils/json.js.map +1 -0
  477. package/dist/utils/mime.d.ts +1 -0
  478. package/dist/utils/mime.d.ts.map +1 -1
  479. package/dist/utils/mime.js +59 -16
  480. package/dist/utils/mime.js.map +1 -1
  481. package/dist/utils/open-browser.d.ts +9 -0
  482. package/dist/utils/open-browser.d.ts.map +1 -0
  483. package/dist/utils/open-browser.js +22 -0
  484. package/dist/utils/open-browser.js.map +1 -0
  485. package/dist/utils/paths.d.ts +25 -1
  486. package/dist/utils/paths.d.ts.map +1 -1
  487. package/dist/utils/paths.js +75 -2
  488. package/dist/utils/paths.js.map +1 -1
  489. package/dist/utils/pi-user-agent.d.ts +2 -0
  490. package/dist/utils/pi-user-agent.d.ts.map +1 -0
  491. package/dist/utils/pi-user-agent.js +5 -0
  492. package/dist/utils/pi-user-agent.js.map +1 -0
  493. package/dist/utils/shell.d.ts +10 -6
  494. package/dist/utils/shell.d.ts.map +1 -1
  495. package/dist/utils/shell.js +35 -26
  496. package/dist/utils/shell.js.map +1 -1
  497. package/dist/utils/syntax-highlight.d.ts +12 -0
  498. package/dist/utils/syntax-highlight.d.ts.map +1 -0
  499. package/dist/utils/syntax-highlight.js +118 -0
  500. package/dist/utils/syntax-highlight.js.map +1 -0
  501. package/dist/utils/tools-manager.d.ts.map +1 -1
  502. package/dist/utils/tools-manager.js +86 -10
  503. package/dist/utils/tools-manager.js.map +1 -1
  504. package/dist/utils/version-check.d.ts +15 -0
  505. package/dist/utils/version-check.d.ts.map +1 -0
  506. package/dist/utils/version-check.js +82 -0
  507. package/dist/utils/version-check.js.map +1 -0
  508. package/dist/utils/windows-self-update.d.ts +3 -0
  509. package/dist/utils/windows-self-update.d.ts.map +1 -0
  510. package/dist/utils/windows-self-update.js +77 -0
  511. package/dist/utils/windows-self-update.js.map +1 -0
  512. package/docs/compaction.md +12 -12
  513. package/docs/containerization.md +111 -0
  514. package/docs/custom-provider.md +187 -47
  515. package/docs/development.md +5 -5
  516. package/docs/docs.json +156 -0
  517. package/docs/extensions.md +465 -71
  518. package/docs/index.md +82 -0
  519. package/docs/json.md +4 -4
  520. package/docs/keybindings.md +23 -1
  521. package/docs/models.md +119 -17
  522. package/docs/packages.md +17 -9
  523. package/docs/prompt-templates.md +30 -2
  524. package/docs/providers.md +83 -22
  525. package/docs/quickstart.md +165 -0
  526. package/docs/rpc.md +41 -10
  527. package/docs/sdk.md +68 -50
  528. package/docs/security.md +55 -0
  529. package/docs/{session.md → session-format.md} +11 -11
  530. package/docs/sessions.md +145 -0
  531. package/docs/settings.md +61 -11
  532. package/docs/skills.md +16 -17
  533. package/docs/terminal-setup.md +44 -2
  534. package/docs/termux.md +4 -4
  535. package/docs/themes.md +3 -3
  536. package/docs/tmux.md +4 -2
  537. package/docs/tui.md +44 -4
  538. package/docs/usage.md +305 -0
  539. package/examples/extensions/border-status-editor.ts +145 -0
  540. package/examples/extensions/built-in-tool-renderer.ts +3 -0
  541. package/examples/extensions/custom-header.ts +1 -1
  542. package/examples/extensions/custom-provider-anthropic/index.ts +1 -1
  543. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  544. package/examples/extensions/custom-provider-anthropic/package.json +2 -2
  545. package/examples/extensions/custom-provider-gitlab-duo/index.ts +55 -4
  546. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  547. package/examples/extensions/custom-provider-gitlab-duo/test.ts +1 -1
  548. package/examples/extensions/doom-overlay/doom-component.ts +2 -2
  549. package/examples/extensions/doom-overlay/index.ts +1 -1
  550. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  551. package/examples/extensions/dynamic-tools.ts +2 -2
  552. package/examples/extensions/git-merge-and-resolve.ts +115 -0
  553. package/examples/extensions/github-issue-autocomplete.ts +185 -0
  554. package/examples/extensions/gondolin/index.ts +531 -0
  555. package/examples/extensions/gondolin/package-lock.json +185 -0
  556. package/examples/extensions/gondolin/package.json +19 -0
  557. package/examples/extensions/handoff.ts +50 -12
  558. package/examples/extensions/input-transform-streaming.ts +39 -0
  559. package/examples/extensions/interactive-shell.ts +1 -1
  560. package/examples/extensions/notify.ts +2 -9
  561. package/examples/extensions/overlay-qa-tests.ts +240 -138
  562. package/examples/extensions/overlay-test.ts +7 -4
  563. package/examples/extensions/plan-mode/utils.ts +1 -1
  564. package/examples/extensions/preset.ts +36 -3
  565. package/examples/extensions/project-trust.ts +64 -0
  566. package/examples/extensions/prompt-customizer.ts +97 -0
  567. package/examples/extensions/provider-payload.ts +4 -0
  568. package/examples/extensions/qna.ts +1 -1
  569. package/examples/extensions/question.ts +2 -2
  570. package/examples/extensions/questionnaire.ts +2 -2
  571. package/examples/extensions/reload-runtime.ts +1 -1
  572. package/examples/extensions/sandbox/index.ts +4 -4
  573. package/examples/extensions/sandbox/package-lock.json +5 -5
  574. package/examples/extensions/sandbox/package.json +2 -2
  575. package/examples/extensions/shutdown-command.ts +1 -1
  576. package/examples/extensions/snake.ts +1 -1
  577. package/examples/extensions/space-invaders.ts +1 -1
  578. package/examples/extensions/structured-output.ts +65 -0
  579. package/examples/extensions/subagent/index.ts +51 -28
  580. package/examples/extensions/summarize.ts +1 -1
  581. package/examples/extensions/tic-tac-toe.ts +1008 -0
  582. package/examples/extensions/titlebar-spinner.ts +2 -2
  583. package/examples/extensions/todo.ts +2 -2
  584. package/examples/extensions/tool-override.ts +1 -1
  585. package/examples/extensions/tools.ts +5 -0
  586. package/examples/extensions/truncated-tool.ts +1 -1
  587. package/examples/extensions/with-deps/index.ts +1 -1
  588. package/examples/extensions/with-deps/package-lock.json +2 -2
  589. package/examples/extensions/with-deps/package.json +3 -3
  590. package/examples/extensions/working-indicator.ts +123 -0
  591. package/examples/extensions/working-message-test.ts +25 -0
  592. package/examples/sdk/01-minimal.ts +14 -10
  593. package/examples/sdk/02-custom-model.ts +12 -8
  594. package/examples/sdk/03-custom-prompt.ts +32 -17
  595. package/examples/sdk/04-skills.ts +5 -2
  596. package/examples/sdk/05-tools.ts +23 -31
  597. package/examples/sdk/06-extensions.ts +14 -8
  598. package/examples/sdk/07-context-files.ts +5 -3
  599. package/examples/sdk/08-prompt-templates.ts +5 -2
  600. package/examples/sdk/09-api-keys-and-oauth.ts +8 -4
  601. package/examples/sdk/10-settings.ts +8 -6
  602. package/examples/sdk/11-sessions.ts +4 -0
  603. package/examples/sdk/12-full-control.ts +13 -17
  604. package/package.json +13 -6
  605. package/prompts/commands/map-codebase.md +14 -0
@@ -13,7 +13,6 @@ See these complete provider examples:
13
13
 
14
14
  - [`examples/extensions/custom-provider-anthropic/`](../examples/extensions/custom-provider-anthropic/)
15
15
  - [`examples/extensions/custom-provider-gitlab-duo/`](../examples/extensions/custom-provider-gitlab-duo/)
16
- - [`examples/extensions/custom-provider-qwen-cli/`](../examples/extensions/custom-provider-qwen-cli/)
17
16
 
18
17
  ## Table of Contents
19
18
 
@@ -24,6 +23,7 @@ See these complete provider examples:
24
23
  - [Unregister Provider](#unregister-provider)
25
24
  - [OAuth Support](#oauth-support)
26
25
  - [Custom Streaming API](#custom-streaming-api)
26
+ - [Context Overflow Errors](#context-overflow-errors)
27
27
  - [Testing Your Implementation](#testing-your-implementation)
28
28
  - [Config Reference](#config-reference)
29
29
  - [Model Definition Reference](#model-definition-reference)
@@ -41,8 +41,9 @@ export default function (pi: ExtensionAPI) {
41
41
 
42
42
  // Register new provider with models
43
43
  pi.registerProvider("my-provider", {
44
+ name: "My Provider",
44
45
  baseUrl: "https://api.example.com",
45
- apiKey: "MY_API_KEY",
46
+ apiKey: "$MY_API_KEY",
46
47
  api: "openai-completions",
47
48
  models: [
48
49
  {
@@ -59,6 +60,8 @@ export default function (pi: ExtensionAPI) {
59
60
  }
60
61
  ```
61
62
 
63
+ The extension factory can also be `async`. For dynamic model discovery, fetch and register models in the factory instead of `session_start`. pi waits for the factory before startup continues, so the provider is available during interactive startup and to `pi --list-models`.
64
+
62
65
  ## Override Existing Provider
63
66
 
64
67
  The simplest use case: redirect an existing provider through a proxy.
@@ -80,7 +83,7 @@ pi.registerProvider("openai", {
80
83
  pi.registerProvider("google", {
81
84
  baseUrl: "https://ai-gateway.corp.com/google",
82
85
  headers: {
83
- "X-Corp-Auth": "CORP_AUTH_TOKEN" // env var or literal
86
+ "X-Corp-Auth": "$CORP_AUTH_TOKEN" // env var or literal
84
87
  }
85
88
  });
86
89
  ```
@@ -91,10 +94,45 @@ When only `baseUrl` and/or `headers` are provided (no `models`), all existing mo
91
94
 
92
95
  To add a completely new provider, specify `models` along with the required configuration.
93
96
 
97
+ If the model list comes from a remote endpoint, use an async extension factory:
98
+
99
+ ```typescript
100
+ import type { ExtensionAPI } from "@draht/coding-agent";
101
+
102
+ export default async function (pi: ExtensionAPI) {
103
+ const response = await fetch("http://localhost:1234/v1/models");
104
+ const payload = (await response.json()) as {
105
+ data: Array<{
106
+ id: string;
107
+ name?: string;
108
+ context_window?: number;
109
+ max_tokens?: number;
110
+ }>;
111
+ };
112
+
113
+ pi.registerProvider("local-openai", {
114
+ baseUrl: "http://localhost:1234/v1",
115
+ apiKey: "$LOCAL_OPENAI_API_KEY",
116
+ api: "openai-completions",
117
+ models: payload.data.map((model) => ({
118
+ id: model.id,
119
+ name: model.name ?? model.id,
120
+ reasoning: false,
121
+ input: ["text"],
122
+ cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
123
+ contextWindow: model.context_window ?? 128000,
124
+ maxTokens: model.max_tokens ?? 4096,
125
+ })),
126
+ });
127
+ }
128
+ ```
129
+
130
+ This registers the fetched models before startup finishes.
131
+
94
132
  ```typescript
95
133
  pi.registerProvider("my-llm", {
96
134
  baseUrl: "https://api.my-llm.com/v1",
97
- apiKey: "MY_LLM_API_KEY", // env var name or literal value
135
+ apiKey: "$MY_LLM_API_KEY", // env var reference
98
136
  api: "openai-completions", // which streaming API to use
99
137
  models: [
100
138
  {
@@ -117,6 +155,8 @@ pi.registerProvider("my-llm", {
117
155
 
118
156
  When `models` is provided, it **replaces** all existing models for that provider.
119
157
 
158
+ `apiKey` and custom header values use the same config value syntax as `models.json`: `!command` at the start executes a command for the whole value, `$ENV_VAR` and `${ENV_VAR}` interpolate environment variables, `$$` emits a literal `$`, and `$!` emits a literal `!`.
159
+
120
160
  ## Unregister Provider
121
161
 
122
162
  Use `pi.unregisterProvider(name)` to remove a provider that was previously registered via `pi.registerProvider(name, ...)`:
@@ -125,7 +165,7 @@ Use `pi.unregisterProvider(name)` to remove a provider that was previously regis
125
165
  // Register
126
166
  pi.registerProvider("my-llm", {
127
167
  baseUrl: "https://api.my-llm.com/v1",
128
- apiKey: "MY_LLM_API_KEY",
168
+ apiKey: "$MY_LLM_API_KEY",
129
169
  api: "openai-completions",
130
170
  models: [
131
171
  {
@@ -161,34 +201,38 @@ The `api` field determines which streaming implementation is used:
161
201
  | `openai-codex-responses` | OpenAI Codex Responses API |
162
202
  | `mistral-conversations` | Mistral SDK Conversations/Chat streaming |
163
203
  | `google-generative-ai` | Google Generative AI API |
164
- | `google-gemini-cli` | Google Cloud Code Assist API |
165
204
  | `google-vertex` | Google Vertex AI API |
166
205
  | `bedrock-converse-stream` | Amazon Bedrock Converse API |
167
206
 
168
- Most OpenAI-compatible providers work with `openai-completions`. Use `compat` for quirks:
207
+ Most OpenAI-compatible providers work with `openai-completions`. Use model-level `thinkingLevelMap` for model-specific thinking levels, and `compat` for provider quirks:
169
208
 
170
209
  ```typescript
171
210
  models: [{
172
211
  id: "custom-model",
173
212
  // ...
213
+ reasoning: true,
214
+ thinkingLevelMap: { // map pi levels to provider values; null hides unsupported levels
215
+ minimal: null,
216
+ low: null,
217
+ medium: null,
218
+ high: "default",
219
+ xhigh: "max"
220
+ },
174
221
  compat: {
175
- supportsDeveloperRole: false, // use "system" instead of "developer"
222
+ supportsDeveloperRole: false, // use "system" instead of "developer"
176
223
  supportsReasoningEffort: true,
177
- reasoningEffortMap: { // map draht-ai levels to provider values
178
- minimal: "default",
179
- low: "default",
180
- medium: "default",
181
- high: "default",
182
- xhigh: "default"
183
- },
184
- maxTokensField: "max_tokens", // instead of "max_completion_tokens"
185
- requiresToolResultName: true, // tool results need name field
186
- thinkingFormat: "qwen" // top-level enable_thinking: true
187
- }
188
- }]
224
+ maxTokensField: "max_tokens", // instead of "max_completion_tokens"
225
+ requiresToolResultName: true, // tool results need name field
226
+ thinkingFormat: "qwen", // top-level enable_thinking: true
227
+ cacheControlFormat: "anthropic" // Anthropic-style cache_control markers
228
+ }
229
+ }]
189
230
  ```
190
231
 
191
- Use `qwen-chat-template` instead for local Qwen-compatible servers that read `chat_template_kwargs.enable_thinking`.
232
+ Use `openrouter` for OpenRouter-style `reasoning: { effort }` controls. Use `together` for Together-style `reasoning: { enabled }` controls; with `supportsReasoningEffort`, it also sends `reasoning_effort`. Use `qwen-chat-template` instead for local Qwen-compatible servers that read `chat_template_kwargs.enable_thinking`.
233
+ Use `cacheControlFormat: "anthropic"` for OpenAI-compatible providers that expose Anthropic-style prompt caching via `cache_control` on the system prompt, last tool definition, and last user/assistant text content.
234
+
235
+ For Anthropic-compatible providers using `api: "anthropic-messages"`, set `compat.forceAdaptiveThinking: true` on models or providers whose upstream model requires adaptive thinking (`thinking.type: "adaptive"` plus `output_config.effort`). Built-in adaptive Claude models set this automatically. Set `compat.allowEmptySignature: true` only for providers that emit empty thinking signatures and expect `signature: ""` on replay.
192
236
 
193
237
  > Migration note: Mistral moved from `openai-completions` to `mistral-conversations`.
194
238
  > Use `mistral-conversations` for native Mistral models.
@@ -201,7 +245,7 @@ If your provider expects `Authorization: Bearer <key>` but doesn't use a standar
201
245
  ```typescript
202
246
  pi.registerProvider("custom-api", {
203
247
  baseUrl: "https://api.example.com",
204
- apiKey: "MY_API_KEY",
248
+ apiKey: "$MY_API_KEY",
205
249
  authHeader: true, // adds Authorization: Bearer header
206
250
  api: "openai-completions",
207
251
  models: [...]
@@ -223,17 +267,28 @@ pi.registerProvider("corporate-ai", {
223
267
  name: "Corporate AI (SSO)",
224
268
 
225
269
  async login(callbacks: OAuthLoginCallbacks): Promise<OAuthCredentials> {
226
- // Option 1: Browser-based OAuth
227
- callbacks.onAuth({ url: "https://sso.corp.com/authorize?..." });
228
-
229
- // Option 2: Device code flow
230
- callbacks.onDeviceCode({
231
- userCode: "ABCD-1234",
232
- verificationUri: "https://sso.corp.com/device"
270
+ const method = await callbacks.onSelect({
271
+ message: "Select login method:",
272
+ options: [
273
+ { id: "browser", label: "Browser OAuth" },
274
+ { id: "device", label: "Device code" }
275
+ ]
233
276
  });
234
-
235
- // Option 3: Prompt for token/code
236
- const code = await callbacks.onPrompt({ message: "Enter SSO code:" });
277
+ if (!method) throw new Error("Login cancelled");
278
+
279
+ let code: string;
280
+ if (method === "device") {
281
+ callbacks.onDeviceCode({
282
+ userCode: "ABCD-1234",
283
+ verificationUri: "https://sso.corp.com/device",
284
+ intervalSeconds: 5,
285
+ expiresInSeconds: 900
286
+ });
287
+ code = await pollDeviceCodeUntilComplete();
288
+ } else {
289
+ callbacks.onAuth({ url: "https://sso.corp.com/authorize?..." });
290
+ code = await callbacks.onPrompt({ message: "Enter SSO code:" });
291
+ }
237
292
 
238
293
  // Exchange for tokens (your implementation)
239
294
  const tokens = await exchangeCodeForTokens(code);
@@ -282,10 +337,21 @@ interface OAuthLoginCallbacks {
282
337
  onAuth(params: { url: string }): void;
283
338
 
284
339
  // Show device code (for device authorization flow)
285
- onDeviceCode(params: { userCode: string; verificationUri: string }): void;
340
+ onDeviceCode(params: {
341
+ userCode: string;
342
+ verificationUri: string;
343
+ intervalSeconds?: number;
344
+ expiresInSeconds?: number;
345
+ }): void;
286
346
 
287
347
  // Prompt user for input (for manual token entry)
288
348
  onPrompt(params: { message: string }): Promise<string>;
349
+
350
+ // Show an interactive selector, e.g. to choose browser OAuth vs device code
351
+ onSelect(params: {
352
+ message: string;
353
+ options: { id: string; label: string }[];
354
+ }): Promise<string | undefined>;
289
355
  }
290
356
  ```
291
357
 
@@ -306,12 +372,12 @@ interface OAuthCredentials {
306
372
  For providers with non-standard APIs, implement `streamSimple`. Study the existing provider implementations before writing your own:
307
373
 
308
374
  **Reference implementations:**
309
- - [anthropic.ts](https://github.com/draht-dev/draht/blob/main/packages/ai/src/providers/anthropic.ts) - Anthropic Messages API
310
- - [mistral.ts](https://github.com/draht-dev/draht/blob/main/packages/ai/src/providers/mistral.ts) - Mistral Conversations API
311
- - [openai-completions.ts](https://github.com/draht-dev/draht/blob/main/packages/ai/src/providers/openai-completions.ts) - OpenAI Chat Completions
312
- - [openai-responses.ts](https://github.com/draht-dev/draht/blob/main/packages/ai/src/providers/openai-responses.ts) - OpenAI Responses API
313
- - [google.ts](https://github.com/draht-dev/draht/blob/main/packages/ai/src/providers/google.ts) - Google Generative AI
314
- - [amazon-bedrock.ts](https://github.com/draht-dev/draht/blob/main/packages/ai/src/providers/amazon-bedrock.ts) - AWS Bedrock
375
+ - [anthropic.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/providers/anthropic.ts) - Anthropic Messages API
376
+ - [mistral.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/providers/mistral.ts) - Mistral Conversations API
377
+ - [openai-completions.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/providers/openai-completions.ts) - OpenAI Chat Completions
378
+ - [openai-responses.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/providers/openai-responses.ts) - OpenAI Responses API
379
+ - [google.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/providers/google.ts) - Google Generative AI
380
+ - [amazon-bedrock.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/providers/amazon-bedrock.ts) - AWS Bedrock
315
381
 
316
382
  ### Stream Pattern
317
383
 
@@ -467,6 +533,60 @@ output.usage.totalTokens = output.usage.input + output.usage.output +
467
533
  calculateCost(model, output.usage);
468
534
  ```
469
535
 
536
+ ### Context Overflow Errors
537
+
538
+ When a request exceeds the model's context window, pi can recover automatically by compacting the conversation and retrying. This recovery only kicks in if pi recognizes the failure as an overflow.
539
+
540
+ Detection runs on the finalized assistant message:
541
+
542
+ - `stopReason === "error"`
543
+ - `errorMessage` matches one of pi's known overflow patterns (see [`packages/ai/src/utils/overflow.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/utils/overflow.ts))
544
+
545
+ If your provider returns overflow errors with a message pi does not recognize, normalize the error from the same extension that registers the provider. Use a `message_end` handler to rewrite the assistant message so its `errorMessage` starts with a phrase pi recognizes. The generic fallback `context_length_exceeded` is the safest choice.
546
+
547
+ ```typescript
548
+ const MY_PROVIDER_OVERFLOW_PATTERN = /your provider's overflow phrase/i;
549
+
550
+ export default function (pi: ExtensionAPI) {
551
+ pi.registerProvider("my-provider", { /* ... */ });
552
+
553
+ pi.on("message_end", (event, ctx) => {
554
+ const message = event.message;
555
+ if (message.role !== "assistant") return;
556
+ if (message.stopReason !== "error") return;
557
+ if (
558
+ message.provider !== "my-provider" &&
559
+ ctx.model?.provider !== "my-provider"
560
+ )
561
+ return;
562
+
563
+ const errorMessage = message.errorMessage ?? "";
564
+ if (errorMessage.includes("context_length_exceeded")) return;
565
+ if (!MY_PROVIDER_OVERFLOW_PATTERN.test(errorMessage)) return;
566
+
567
+ return {
568
+ message: {
569
+ ...message,
570
+ errorMessage: `context_length_exceeded: ${errorMessage}`,
571
+ },
572
+ };
573
+ });
574
+ }
575
+ ```
576
+
577
+ `message_end` runs before pi tracks the assistant message for auto-compaction, so the rewritten `errorMessage` is what pi checks. With this in place, pi will:
578
+
579
+ 1. Detect the overflow from `errorMessage`.
580
+ 2. Drop the failed assistant message from live context.
581
+ 3. Run compaction.
582
+ 4. Retry the request once.
583
+
584
+ Guard the rewrite carefully:
585
+
586
+ - Scope it to your provider (`message.provider` and `ctx.model?.provider`) so unrelated errors from other providers are untouched.
587
+ - Match a provider-specific pattern, not pi's generic overflow patterns. Rewriting rate-limit or throttling errors (`rate limit`, `too many requests`) would falsely trigger compaction instead of pi's normal retry-with-backoff path.
588
+ - Skip when `errorMessage` already includes `context_length_exceeded` so the handler is idempotent.
589
+
470
590
  ### Registration
471
591
 
472
592
  Register your stream function:
@@ -474,7 +594,7 @@ Register your stream function:
474
594
  ```typescript
475
595
  pi.registerProvider("my-provider", {
476
596
  baseUrl: "https://api.example.com",
477
- apiKey: "MY_API_KEY",
597
+ apiKey: "$MY_API_KEY",
478
598
  api: "my-custom-api",
479
599
  models: [...],
480
600
  streamSimple: streamMyProvider
@@ -483,7 +603,7 @@ pi.registerProvider("my-provider", {
483
603
 
484
604
  ## Testing Your Implementation
485
605
 
486
- Test your provider against the same test suites used by built-in providers. Copy and adapt these test files from [packages/ai/test/](https://github.com/draht-dev/draht/tree/main/packages/ai/test):
606
+ Test your provider against the same test suites used by built-in providers. Copy and adapt these test files from [packages/ai/test/](https://github.com/earendil-works/pi-mono/tree/main/packages/ai/test):
487
607
 
488
608
  | Test | Purpose |
489
609
  |------|---------|
@@ -505,10 +625,13 @@ Run tests with your provider/model pairs to verify compatibility.
505
625
 
506
626
  ```typescript
507
627
  interface ProviderConfig {
628
+ /** Display name for the provider in UI such as /login. */
629
+ name?: string;
630
+
508
631
  /** API endpoint URL. Required when defining models. */
509
632
  baseUrl?: string;
510
633
 
511
- /** API key or environment variable name. Required when defining models (unless oauth). */
634
+ /** API key literal, env interpolation ($ENV_VAR or ${ENV_VAR}), or !command. Required when defining models (unless oauth). */
512
635
  apiKey?: string;
513
636
 
514
637
  /** API type for streaming. Required at provider or model level when defining models. */
@@ -521,7 +644,7 @@ interface ProviderConfig {
521
644
  options?: SimpleStreamOptions
522
645
  ) => AssistantMessageEventStream;
523
646
 
524
- /** Custom headers to include in requests. Values can be env var names. */
647
+ /** Custom headers to include in requests. Values use the same resolution syntax as apiKey. */
525
648
  headers?: Record<string, string>;
526
649
 
527
650
  /** If true, adds Authorization: Bearer header with the resolved API key. */
@@ -554,9 +677,15 @@ interface ProviderModelConfig {
554
677
  /** API type override for this specific model. */
555
678
  api?: Api;
556
679
 
680
+ /** API endpoint URL override for this specific model. */
681
+ baseUrl?: string;
682
+
557
683
  /** Whether the model supports extended thinking. */
558
684
  reasoning: boolean;
559
685
 
686
+ /** Maps pi thinking levels to provider/model-specific values; null marks a level unsupported. */
687
+ thinkingLevelMap?: Partial<Record<"off" | "minimal" | "low" | "medium" | "high" | "xhigh", string | null>>;
688
+
560
689
  /** Supported input types. */
561
690
  input: ("text" | "image")[];
562
691
 
@@ -577,20 +706,31 @@ interface ProviderModelConfig {
577
706
  /** Custom headers for this specific model. */
578
707
  headers?: Record<string, string>;
579
708
 
580
- /** OpenAI compatibility settings for openai-completions API. */
709
+ /** Compatibility settings for the selected API. */
581
710
  compat?: {
711
+ // openai-completions
582
712
  supportsStore?: boolean;
583
713
  supportsDeveloperRole?: boolean;
584
714
  supportsReasoningEffort?: boolean;
585
- reasoningEffortMap?: Partial<Record<"minimal" | "low" | "medium" | "high" | "xhigh", string>>;
586
715
  supportsUsageInStreaming?: boolean;
587
716
  maxTokensField?: "max_completion_tokens" | "max_tokens";
588
717
  requiresToolResultName?: boolean;
589
718
  requiresAssistantAfterToolResult?: boolean;
590
719
  requiresThinkingAsText?: boolean;
591
- thinkingFormat?: "openai" | "zai" | "qwen" | "qwen-chat-template";
720
+ requiresReasoningContentOnAssistantMessages?: boolean;
721
+ thinkingFormat?: "openai" | "openrouter" | "deepseek" | "together" | "zai" | "qwen" | "qwen-chat-template";
722
+ cacheControlFormat?: "anthropic";
723
+
724
+ // anthropic-messages
725
+ supportsEagerToolInputStreaming?: boolean;
726
+ supportsLongCacheRetention?: boolean;
727
+ sendSessionAffinityHeaders?: boolean;
728
+ supportsCacheControlOnTools?: boolean;
729
+ forceAdaptiveThinking?: boolean;
730
+ allowEmptySignature?: boolean;
592
731
  };
593
732
  }
594
733
  ```
595
734
 
596
- `qwen` is for DashScope-style top-level `enable_thinking`. Use `qwen-chat-template` for local Qwen-compatible servers that read `chat_template_kwargs.enable_thinking`.
735
+ `openrouter` sends `reasoning: { effort }`. `deepseek` sends `thinking: { type: "enabled" | "disabled" }` and `reasoning_effort` when enabled. `together` sends `reasoning: { enabled }` and also `reasoning_effort` when `supportsReasoningEffort` is enabled. `qwen` is for DashScope-style top-level `enable_thinking`. Use `qwen-chat-template` for local Qwen-compatible servers that read `chat_template_kwargs.enable_thinking`.
736
+ `cacheControlFormat: "anthropic"` applies Anthropic-style `cache_control` markers to the system prompt, last tool definition, and last user/assistant text content.
@@ -1,12 +1,12 @@
1
1
  # Development
2
2
 
3
- See [AGENTS.md](../../../AGENTS.md) for additional guidelines.
3
+ See [AGENTS.md](https://github.com/earendil-works/pi-mono/blob/main/AGENTS.md) for additional guidelines.
4
4
 
5
5
  ## Setup
6
6
 
7
7
  ```bash
8
- git clone https://github.com/draht-dev/draht
9
- cd draht-mono
8
+ git clone https://github.com/earendil-works/pi-mono
9
+ cd pi-mono
10
10
  npm install
11
11
  npm run build
12
12
  ```
@@ -14,7 +14,7 @@ npm run build
14
14
  Run from source:
15
15
 
16
16
  ```bash
17
- /path/to/draht-mono/pi-test.sh
17
+ /path/to/pi-mono/pi-test.sh
18
18
  ```
19
19
 
20
20
  The script can be run from any directory. Pi keeps the caller's current working directory.
@@ -26,7 +26,7 @@ Configure via `package.json`:
26
26
  ```json
27
27
  {
28
28
  "piConfig": {
29
- "name": "draht",
29
+ "name": "pi",
30
30
  "configDir": ".pi"
31
31
  }
32
32
  }
package/docs/docs.json ADDED
@@ -0,0 +1,156 @@
1
+ {
2
+ "navigation": [
3
+ {
4
+ "title": "Start here",
5
+ "items": [
6
+ {
7
+ "title": "Overview",
8
+ "path": "index.md"
9
+ },
10
+ {
11
+ "title": "Quickstart",
12
+ "path": "quickstart.md"
13
+ },
14
+ {
15
+ "title": "Using Pi",
16
+ "path": "usage.md"
17
+ },
18
+ {
19
+ "title": "Providers",
20
+ "path": "providers.md"
21
+ },
22
+ {
23
+ "title": "Security",
24
+ "path": "security.md"
25
+ },
26
+ {
27
+ "title": "Containerization",
28
+ "path": "containerization.md"
29
+ },
30
+ {
31
+ "title": "Settings",
32
+ "path": "settings.md"
33
+ },
34
+ {
35
+ "title": "Keybindings",
36
+ "path": "keybindings.md"
37
+ },
38
+ {
39
+ "title": "Sessions",
40
+ "path": "sessions.md"
41
+ },
42
+ {
43
+ "title": "Compaction",
44
+ "path": "compaction.md"
45
+ }
46
+ ]
47
+ },
48
+ {
49
+ "title": "Customization",
50
+ "items": [
51
+ {
52
+ "title": "Extensions",
53
+ "path": "extensions.md"
54
+ },
55
+ {
56
+ "title": "Skills",
57
+ "path": "skills.md"
58
+ },
59
+ {
60
+ "title": "Prompt Templates",
61
+ "path": "prompt-templates.md"
62
+ },
63
+ {
64
+ "title": "Themes",
65
+ "path": "themes.md"
66
+ },
67
+ {
68
+ "title": "Pi Packages",
69
+ "path": "packages.md"
70
+ },
71
+ {
72
+ "title": "Custom Models",
73
+ "path": "models.md"
74
+ },
75
+ {
76
+ "title": "Custom Providers",
77
+ "path": "custom-provider.md"
78
+ }
79
+ ]
80
+ },
81
+ {
82
+ "title": "Reference",
83
+ "items": [
84
+ {
85
+ "title": "Session Format",
86
+ "path": "session-format.md"
87
+ }
88
+ ]
89
+ },
90
+ {
91
+ "title": "Programmatic Usage",
92
+ "items": [
93
+ {
94
+ "title": "SDK",
95
+ "path": "sdk.md"
96
+ },
97
+ {
98
+ "title": "RPC Mode",
99
+ "path": "rpc.md"
100
+ },
101
+ {
102
+ "title": "JSON Event Stream Mode",
103
+ "path": "json.md"
104
+ },
105
+ {
106
+ "title": "TUI Components",
107
+ "path": "tui.md"
108
+ }
109
+ ]
110
+ },
111
+ {
112
+ "title": "Platform Setup",
113
+ "items": [
114
+ {
115
+ "title": "Windows",
116
+ "path": "windows.md"
117
+ },
118
+ {
119
+ "title": "Termux on Android",
120
+ "path": "termux.md"
121
+ },
122
+ {
123
+ "title": "tmux",
124
+ "path": "tmux.md"
125
+ },
126
+ {
127
+ "title": "Terminal Setup",
128
+ "path": "terminal-setup.md"
129
+ },
130
+ {
131
+ "title": "Shell Aliases",
132
+ "path": "shell-aliases.md"
133
+ }
134
+ ]
135
+ },
136
+ {
137
+ "title": "Development",
138
+ "items": [
139
+ {
140
+ "title": "Development",
141
+ "path": "development.md"
142
+ }
143
+ ]
144
+ }
145
+ ],
146
+ "redirects": [
147
+ {
148
+ "from": "session.md",
149
+ "to": "session-format.md"
150
+ },
151
+ {
152
+ "from": "tree.md",
153
+ "to": "sessions.md"
154
+ }
155
+ ]
156
+ }