@draht/coding-agent 2026.4.26 → 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 (621) hide show
  1. package/CHANGELOG.md +43 -0
  2. package/bin/draht-tools.cjs +3809 -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/atomic-commit.md +12 -0
  419. package/dist/prompts/commands/execute-phase.md +48 -17
  420. package/dist/prompts/commands/fix.md +86 -23
  421. package/dist/prompts/commands/map-codebase.md +17 -3
  422. package/dist/prompts/commands/orchestrate.md +31 -6
  423. package/dist/prompts/commands/plan-phase.md +39 -6
  424. package/dist/prompts/commands/quick.md +36 -6
  425. package/dist/prompts/commands/review.md +28 -11
  426. package/dist/prompts/commands/verify-work.md +34 -17
  427. package/dist/utils/ansi.d.ts +2 -0
  428. package/dist/utils/ansi.d.ts.map +1 -0
  429. package/dist/utils/ansi.js +52 -0
  430. package/dist/utils/ansi.js.map +1 -0
  431. package/dist/utils/changelog.d.ts +2 -1
  432. package/dist/utils/changelog.d.ts.map +1 -1
  433. package/dist/utils/changelog.js +78 -0
  434. package/dist/utils/changelog.js.map +1 -1
  435. package/dist/utils/child-process.d.ts +5 -1
  436. package/dist/utils/child-process.d.ts.map +1 -1
  437. package/dist/utils/child-process.js +10 -0
  438. package/dist/utils/child-process.js.map +1 -1
  439. package/dist/utils/clipboard-image.d.ts.map +1 -1
  440. package/dist/utils/clipboard-image.js +2 -2
  441. package/dist/utils/clipboard-image.js.map +1 -1
  442. package/dist/utils/clipboard-native.d.ts +3 -1
  443. package/dist/utils/clipboard-native.d.ts.map +1 -1
  444. package/dist/utils/clipboard-native.js +14 -8
  445. package/dist/utils/clipboard-native.js.map +1 -1
  446. package/dist/utils/clipboard.d.ts.map +1 -1
  447. package/dist/utils/clipboard.js +84 -45
  448. package/dist/utils/clipboard.js.map +1 -1
  449. package/dist/utils/deprecation.d.ts +4 -0
  450. package/dist/utils/deprecation.d.ts.map +1 -0
  451. package/dist/utils/deprecation.js +13 -0
  452. package/dist/utils/deprecation.js.map +1 -0
  453. package/dist/utils/exif-orientation.d.ts +1 -1
  454. package/dist/utils/exif-orientation.d.ts.map +1 -1
  455. package/dist/utils/exif-orientation.js.map +1 -1
  456. package/dist/utils/fs-watch.d.ts +5 -0
  457. package/dist/utils/fs-watch.d.ts.map +1 -0
  458. package/dist/utils/fs-watch.js +25 -0
  459. package/dist/utils/fs-watch.js.map +1 -0
  460. package/dist/utils/git.d.ts.map +1 -1
  461. package/dist/utils/git.js +54 -22
  462. package/dist/utils/git.js.map +1 -1
  463. package/dist/utils/html.d.ts +7 -0
  464. package/dist/utils/html.d.ts.map +1 -0
  465. package/dist/utils/html.js +40 -0
  466. package/dist/utils/html.js.map +1 -0
  467. package/dist/utils/image-convert.d.ts.map +1 -1
  468. package/dist/utils/image-convert.js.map +1 -1
  469. package/dist/utils/image-resize-core.d.ts +30 -0
  470. package/dist/utils/image-resize-core.d.ts.map +1 -0
  471. package/dist/utils/image-resize-core.js +124 -0
  472. package/dist/utils/image-resize-core.js.map +1 -0
  473. package/dist/utils/image-resize-worker.d.ts +2 -0
  474. package/dist/utils/image-resize-worker.d.ts.map +1 -0
  475. package/dist/utils/image-resize-worker.js +31 -0
  476. package/dist/utils/image-resize-worker.js.map +1 -0
  477. package/dist/utils/image-resize.d.ts +7 -27
  478. package/dist/utils/image-resize.d.ts.map +1 -1
  479. package/dist/utils/image-resize.js +75 -115
  480. package/dist/utils/image-resize.js.map +1 -1
  481. package/dist/utils/json.d.ts +3 -0
  482. package/dist/utils/json.d.ts.map +1 -0
  483. package/dist/utils/json.js +7 -0
  484. package/dist/utils/json.js.map +1 -0
  485. package/dist/utils/mime.d.ts +1 -0
  486. package/dist/utils/mime.d.ts.map +1 -1
  487. package/dist/utils/mime.js +59 -16
  488. package/dist/utils/mime.js.map +1 -1
  489. package/dist/utils/open-browser.d.ts +9 -0
  490. package/dist/utils/open-browser.d.ts.map +1 -0
  491. package/dist/utils/open-browser.js +22 -0
  492. package/dist/utils/open-browser.js.map +1 -0
  493. package/dist/utils/paths.d.ts +25 -1
  494. package/dist/utils/paths.d.ts.map +1 -1
  495. package/dist/utils/paths.js +75 -2
  496. package/dist/utils/paths.js.map +1 -1
  497. package/dist/utils/pi-user-agent.d.ts +2 -0
  498. package/dist/utils/pi-user-agent.d.ts.map +1 -0
  499. package/dist/utils/pi-user-agent.js +5 -0
  500. package/dist/utils/pi-user-agent.js.map +1 -0
  501. package/dist/utils/shell.d.ts +10 -6
  502. package/dist/utils/shell.d.ts.map +1 -1
  503. package/dist/utils/shell.js +35 -26
  504. package/dist/utils/shell.js.map +1 -1
  505. package/dist/utils/syntax-highlight.d.ts +12 -0
  506. package/dist/utils/syntax-highlight.d.ts.map +1 -0
  507. package/dist/utils/syntax-highlight.js +118 -0
  508. package/dist/utils/syntax-highlight.js.map +1 -0
  509. package/dist/utils/tools-manager.d.ts.map +1 -1
  510. package/dist/utils/tools-manager.js +86 -10
  511. package/dist/utils/tools-manager.js.map +1 -1
  512. package/dist/utils/version-check.d.ts +15 -0
  513. package/dist/utils/version-check.d.ts.map +1 -0
  514. package/dist/utils/version-check.js +82 -0
  515. package/dist/utils/version-check.js.map +1 -0
  516. package/dist/utils/windows-self-update.d.ts +3 -0
  517. package/dist/utils/windows-self-update.d.ts.map +1 -0
  518. package/dist/utils/windows-self-update.js +77 -0
  519. package/dist/utils/windows-self-update.js.map +1 -0
  520. package/docs/compaction.md +12 -12
  521. package/docs/containerization.md +111 -0
  522. package/docs/custom-provider.md +187 -47
  523. package/docs/development.md +5 -5
  524. package/docs/docs.json +156 -0
  525. package/docs/extensions.md +465 -71
  526. package/docs/index.md +82 -0
  527. package/docs/json.md +4 -4
  528. package/docs/keybindings.md +23 -1
  529. package/docs/models.md +119 -17
  530. package/docs/packages.md +17 -9
  531. package/docs/prompt-templates.md +30 -2
  532. package/docs/providers.md +83 -22
  533. package/docs/quickstart.md +165 -0
  534. package/docs/rpc.md +41 -10
  535. package/docs/sdk.md +68 -50
  536. package/docs/security.md +55 -0
  537. package/docs/{session.md → session-format.md} +11 -11
  538. package/docs/sessions.md +145 -0
  539. package/docs/settings.md +61 -11
  540. package/docs/skills.md +16 -17
  541. package/docs/terminal-setup.md +44 -2
  542. package/docs/termux.md +4 -4
  543. package/docs/themes.md +3 -3
  544. package/docs/tmux.md +4 -2
  545. package/docs/tui.md +44 -4
  546. package/docs/usage.md +305 -0
  547. package/examples/extensions/border-status-editor.ts +145 -0
  548. package/examples/extensions/built-in-tool-renderer.ts +3 -0
  549. package/examples/extensions/custom-header.ts +1 -1
  550. package/examples/extensions/custom-provider-anthropic/index.ts +1 -1
  551. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  552. package/examples/extensions/custom-provider-anthropic/package.json +2 -2
  553. package/examples/extensions/custom-provider-gitlab-duo/index.ts +55 -4
  554. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  555. package/examples/extensions/custom-provider-gitlab-duo/test.ts +1 -1
  556. package/examples/extensions/doom-overlay/doom-component.ts +2 -2
  557. package/examples/extensions/doom-overlay/index.ts +1 -1
  558. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  559. package/examples/extensions/dynamic-tools.ts +2 -2
  560. package/examples/extensions/git-merge-and-resolve.ts +115 -0
  561. package/examples/extensions/github-issue-autocomplete.ts +185 -0
  562. package/examples/extensions/gondolin/index.ts +531 -0
  563. package/examples/extensions/gondolin/package-lock.json +185 -0
  564. package/examples/extensions/gondolin/package.json +19 -0
  565. package/examples/extensions/handoff.ts +50 -12
  566. package/examples/extensions/input-transform-streaming.ts +39 -0
  567. package/examples/extensions/interactive-shell.ts +1 -1
  568. package/examples/extensions/notify.ts +2 -9
  569. package/examples/extensions/overlay-qa-tests.ts +240 -138
  570. package/examples/extensions/overlay-test.ts +7 -4
  571. package/examples/extensions/plan-mode/utils.ts +1 -1
  572. package/examples/extensions/preset.ts +36 -3
  573. package/examples/extensions/project-trust.ts +64 -0
  574. package/examples/extensions/prompt-customizer.ts +97 -0
  575. package/examples/extensions/provider-payload.ts +4 -0
  576. package/examples/extensions/qna.ts +1 -1
  577. package/examples/extensions/question.ts +2 -2
  578. package/examples/extensions/questionnaire.ts +2 -2
  579. package/examples/extensions/reload-runtime.ts +1 -1
  580. package/examples/extensions/sandbox/index.ts +4 -4
  581. package/examples/extensions/sandbox/package-lock.json +5 -5
  582. package/examples/extensions/sandbox/package.json +2 -2
  583. package/examples/extensions/shutdown-command.ts +1 -1
  584. package/examples/extensions/snake.ts +1 -1
  585. package/examples/extensions/space-invaders.ts +1 -1
  586. package/examples/extensions/structured-output.ts +65 -0
  587. package/examples/extensions/subagent/index.ts +51 -28
  588. package/examples/extensions/summarize.ts +1 -1
  589. package/examples/extensions/tic-tac-toe.ts +1008 -0
  590. package/examples/extensions/titlebar-spinner.ts +2 -2
  591. package/examples/extensions/todo.ts +2 -2
  592. package/examples/extensions/tool-override.ts +1 -1
  593. package/examples/extensions/tools.ts +5 -0
  594. package/examples/extensions/truncated-tool.ts +1 -1
  595. package/examples/extensions/with-deps/index.ts +1 -1
  596. package/examples/extensions/with-deps/package-lock.json +2 -2
  597. package/examples/extensions/with-deps/package.json +3 -3
  598. package/examples/extensions/working-indicator.ts +123 -0
  599. package/examples/extensions/working-message-test.ts +25 -0
  600. package/examples/sdk/01-minimal.ts +14 -10
  601. package/examples/sdk/02-custom-model.ts +12 -8
  602. package/examples/sdk/03-custom-prompt.ts +32 -17
  603. package/examples/sdk/04-skills.ts +5 -2
  604. package/examples/sdk/05-tools.ts +23 -31
  605. package/examples/sdk/06-extensions.ts +14 -8
  606. package/examples/sdk/07-context-files.ts +5 -3
  607. package/examples/sdk/08-prompt-templates.ts +5 -2
  608. package/examples/sdk/09-api-keys-and-oauth.ts +8 -4
  609. package/examples/sdk/10-settings.ts +8 -6
  610. package/examples/sdk/11-sessions.ts +4 -0
  611. package/examples/sdk/12-full-control.ts +13 -17
  612. package/package.json +15 -7
  613. package/prompts/commands/atomic-commit.md +12 -0
  614. package/prompts/commands/execute-phase.md +48 -17
  615. package/prompts/commands/fix.md +86 -23
  616. package/prompts/commands/map-codebase.md +17 -3
  617. package/prompts/commands/orchestrate.md +31 -6
  618. package/prompts/commands/plan-phase.md +39 -6
  619. package/prompts/commands/quick.md +36 -6
  620. package/prompts/commands/review.md +28 -11
  621. package/prompts/commands/verify-work.md +34 -17
package/dist/config.d.ts CHANGED
@@ -6,7 +6,17 @@ export declare const isBunBinary: boolean;
6
6
  /** Detect if Bun is the runtime (compiled binary or bun run) */
7
7
  export declare const isBunRuntime: boolean;
8
8
  export type InstallMethod = "bun-binary" | "npm" | "pnpm" | "yarn" | "bun" | "unknown";
9
+ interface SelfUpdateCommandStep {
10
+ command: string;
11
+ args: string[];
12
+ display: string;
13
+ }
14
+ export interface SelfUpdateCommand extends SelfUpdateCommandStep {
15
+ steps?: SelfUpdateCommandStep[];
16
+ }
9
17
  export declare function detectInstallMethod(): InstallMethod;
18
+ export declare function getSelfUpdateCommand(packageName: string, npmCommand?: string[], updatePackageName?: string): SelfUpdateCommand | undefined;
19
+ export declare function getSelfUpdateUnavailableInstruction(packageName: string, npmCommand?: string[], updatePackageName?: string): string;
10
20
  export declare function getUpdateInstruction(packageName: string): string;
11
21
  /**
12
22
  * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).
@@ -48,20 +58,27 @@ export declare function getChangelogPath(): string;
48
58
  export declare function getInteractiveAssetsDir(): string;
49
59
  /** Get path to a bundled interactive asset */
50
60
  export declare function getBundledInteractiveAssetPath(name: string): string;
61
+ export declare const PACKAGE_NAME: string;
51
62
  export declare const APP_NAME: string;
63
+ export declare const APP_TITLE: string;
52
64
  export declare const CONFIG_DIR_NAME: string;
53
65
  export declare const LEGACY_CONFIG_DIR_NAME = ".pi";
54
66
  export declare const VERSION: string;
67
+ /** True when running from source (src/ directory exists), not a compiled/installed build. */
68
+ export declare const IS_DEV_MODE: boolean;
69
+ /** Version string for display. "dev" in dev mode, the package version otherwise. */
70
+ export declare const DISPLAY_VERSION: string;
55
71
  /**
56
- * Resolve the project config directory. Prefers `CONFIG_DIR_NAME` (`.draht`),
57
- * falls back to `LEGACY_CONFIG_DIR_NAME` (`.pi`) if the primary doesn't exist
58
- * but the legacy one does.
72
+ * Resolve the project config directory. Prefers CONFIG_DIR_NAME (.draht),
73
+ * falls back to LEGACY_CONFIG_DIR_NAME (.pi) if the primary doesn't exist.
59
74
  */
60
75
  export declare function getProjectConfigDir(cwd: string): string;
61
76
  export declare const ENV_AGENT_DIR: string;
77
+ export declare const ENV_SESSION_DIR: string;
78
+ export declare function expandTildePath(path: string): string;
62
79
  /** Get the share viewer URL for a gist ID */
63
80
  export declare function getShareViewerUrl(gistId: string): string;
64
- /** Get the agent config directory (e.g., ~/.draht/agent/) */
81
+ /** Get the agent config directory (e.g., ~/.pi/agent/) */
65
82
  export declare function getAgentDir(): string;
66
83
  /** Get path to user's custom themes directory */
67
84
  export declare function getCustomThemesDir(): string;
@@ -77,18 +94,11 @@ export declare function getToolsDir(): string;
77
94
  export declare function getBinDir(): string;
78
95
  /** Get path to prompt templates directory */
79
96
  export declare function getPromptsDir(): string;
80
- /**
81
- * Get path to shipped prompt templates (bundled with the package).
82
- * - For Bun binary: prompts/ next to executable
83
- * - For Node.js: prompts/ at package root
84
- */
97
+ /** Get path to shipped prompts directory (bundled with the package). */
85
98
  export declare function getShippedPromptsDir(): string;
86
- /**
87
- * Get path to shipped hooks (bundled with the package).
88
- */
89
- export declare function getShippedHooksDir(): string;
90
99
  /** Get path to sessions directory */
91
100
  export declare function getSessionsDir(): string;
92
101
  /** Get path to debug log file */
93
102
  export declare function getDebugLogPath(): string;
103
+ export {};
94
104
  //# sourceMappingURL=config.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,eAAO,MAAM,WAAW,SACqF,CAAC;AAE9G,gEAAgE;AAChE,eAAO,MAAM,YAAY,SAAyB,CAAC;AAMnD,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAEvF,wBAAgB,mBAAmB,IAAI,aAAa,CAqBnD;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAgBhE;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAuBtC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAQrC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAO7C;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,iCAAiC;AACjC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,qCAAqC;AACrC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAOhD;AAED,8CAA8C;AAC9C,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE;AAQD,eAAO,MAAM,QAAQ,EAAE,MAAyC,CAAC;AACjE,eAAO,MAAM,eAAe,EAAE,MAA+C,CAAC;AAC9E,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAC5C,eAAO,MAAM,OAAO,EAAE,MAAwE,CAAC;AAE/F;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMvD;AAGD,eAAO,MAAM,aAAa,QAA+C,CAAC;AAI1E,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxD;AAMD,6DAA6D;AAC7D,wBAAgB,WAAW,IAAI,MAAM,CASpC;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,8BAA8B;AAC9B,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,4BAA4B;AAC5B,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,gCAAgC;AAChC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,kCAAkC;AAClC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,sDAAsD;AACtD,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAK7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAK3C;AAED,qCAAqC;AACrC,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iCAAiC;AACjC,wBAAgB,eAAe,IAAI,MAAM,CAExC","sourcesContent":["import { existsSync, readFileSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { dirname, join, resolve } from \"path\";\nimport { fileURLToPath } from \"url\";\n\n// =============================================================================\n// Package Detection\n// =============================================================================\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n/**\n * Detect if we're running as a Bun compiled binary.\n * Bun binaries have import.meta.url containing \"$bunfs\", \"~BUN\", or \"%7EBUN\" (Bun's virtual filesystem path)\n */\nexport const isBunBinary =\n\timport.meta.url.includes(\"$bunfs\") || import.meta.url.includes(\"~BUN\") || import.meta.url.includes(\"%7EBUN\");\n\n/** Detect if Bun is the runtime (compiled binary or bun run) */\nexport const isBunRuntime = !!process.versions.bun;\n\n// =============================================================================\n// Install Method Detection\n// =============================================================================\n\nexport type InstallMethod = \"bun-binary\" | \"npm\" | \"pnpm\" | \"yarn\" | \"bun\" | \"unknown\";\n\nexport function detectInstallMethod(): InstallMethod {\n\tif (isBunBinary) {\n\t\treturn \"bun-binary\";\n\t}\n\n\tconst resolvedPath = `${__dirname}\\0${process.execPath || \"\"}`.toLowerCase();\n\n\tif (resolvedPath.includes(\"/pnpm/\") || resolvedPath.includes(\"/.pnpm/\") || resolvedPath.includes(\"\\\\pnpm\\\\\")) {\n\t\treturn \"pnpm\";\n\t}\n\tif (resolvedPath.includes(\"/yarn/\") || resolvedPath.includes(\"/.yarn/\") || resolvedPath.includes(\"\\\\yarn\\\\\")) {\n\t\treturn \"yarn\";\n\t}\n\tif (isBunRuntime) {\n\t\treturn \"bun\";\n\t}\n\tif (resolvedPath.includes(\"/npm/\") || resolvedPath.includes(\"/node_modules/\") || resolvedPath.includes(\"\\\\npm\\\\\")) {\n\t\treturn \"npm\";\n\t}\n\n\treturn \"unknown\";\n}\n\nexport function getUpdateInstruction(packageName: string): string {\n\tconst method = detectInstallMethod();\n\tswitch (method) {\n\t\tcase \"bun-binary\":\n\t\t\treturn `Download from: https://github.com/draht-dev/draht/releases/latest`;\n\t\tcase \"pnpm\":\n\t\t\treturn `Run: pnpm install -g ${packageName}`;\n\t\tcase \"yarn\":\n\t\t\treturn `Run: yarn global add ${packageName}`;\n\t\tcase \"bun\":\n\t\t\treturn `Run: bun add -g ${packageName}`;\n\t\tcase \"npm\":\n\t\t\treturn `Run: npm install -g ${packageName}`;\n\t\tdefault:\n\t\t\treturn `Run: bun add -g ${packageName}`;\n\t}\n}\n\n// =============================================================================\n// Package Asset Paths (shipped with executable)\n// =============================================================================\n\n/**\n * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).\n * - For Bun binary: returns the directory containing the executable\n * - For Node.js (dist/): returns __dirname (the dist/ directory)\n * - For tsx (src/): returns parent directory (the package root)\n */\nexport function getPackageDir(): string {\n\t// Allow override via environment variable (useful for Nix/Guix where store paths tokenize poorly)\n\tconst envDir = process.env.DRAHT_PACKAGE_DIR;\n\tif (envDir) {\n\t\tif (envDir === \"~\") return homedir();\n\t\tif (envDir.startsWith(\"~/\")) return homedir() + envDir.slice(1);\n\t\treturn envDir;\n\t}\n\n\tif (isBunBinary) {\n\t\t// Bun binary: process.execPath points to the compiled executable\n\t\treturn dirname(process.execPath);\n\t}\n\t// Node.js: walk up from __dirname until we find package.json\n\tlet dir = __dirname;\n\twhile (dir !== dirname(dir)) {\n\t\tif (existsSync(join(dir, \"package.json\"))) {\n\t\t\treturn dir;\n\t\t}\n\t\tdir = dirname(dir);\n\t}\n\t// Fallback (shouldn't happen)\n\treturn __dirname;\n}\n\n/**\n * Get path to built-in themes directory (shipped with package)\n * - For Bun binary: theme/ next to executable\n * - For Node.js (dist/): dist/modes/interactive/theme/\n * - For tsx (src/): src/modes/interactive/theme/\n */\nexport function getThemesDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(dirname(process.execPath), \"theme\");\n\t}\n\t// Theme is in modes/interactive/theme/ relative to src/ or dist/\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"modes\", \"interactive\", \"theme\");\n}\n\n/**\n * Get path to HTML export template directory (shipped with package)\n * - For Bun binary: export-html/ next to executable\n * - For Node.js (dist/): dist/core/export-html/\n * - For tsx (src/): src/core/export-html/\n */\nexport function getExportTemplateDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(dirname(process.execPath), \"export-html\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"core\", \"export-html\");\n}\n\n/** Get path to package.json */\nexport function getPackageJsonPath(): string {\n\treturn join(getPackageDir(), \"package.json\");\n}\n\n/** Get path to README.md */\nexport function getReadmePath(): string {\n\treturn resolve(join(getPackageDir(), \"README.md\"));\n}\n\n/** Get path to docs directory */\nexport function getDocsPath(): string {\n\treturn resolve(join(getPackageDir(), \"docs\"));\n}\n\n/** Get path to examples directory */\nexport function getExamplesPath(): string {\n\treturn resolve(join(getPackageDir(), \"examples\"));\n}\n\n/** Get path to CHANGELOG.md */\nexport function getChangelogPath(): string {\n\treturn resolve(join(getPackageDir(), \"CHANGELOG.md\"));\n}\n\n/**\n * Get path to built-in interactive assets directory.\n * - For Bun binary: assets/ next to executable\n * - For Node.js (dist/): dist/modes/interactive/assets/\n * - For tsx (src/): src/modes/interactive/assets/\n */\nexport function getInteractiveAssetsDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(dirname(process.execPath), \"assets\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"modes\", \"interactive\", \"assets\");\n}\n\n/** Get path to a bundled interactive asset */\nexport function getBundledInteractiveAssetPath(name: string): string {\n\treturn join(getInteractiveAssetsDir(), name);\n}\n\n// =============================================================================\n// App Config (from package.json drahtConfig)\n// =============================================================================\n\nconst pkg = JSON.parse(readFileSync(getPackageJsonPath(), \"utf-8\"));\n\nexport const APP_NAME: string = pkg.drahtConfig?.name || \"draht\";\nexport const CONFIG_DIR_NAME: string = pkg.drahtConfig?.configDir || \".draht\";\nexport const LEGACY_CONFIG_DIR_NAME = \".pi\";\nexport const VERSION: string = existsSync(join(getPackageDir(), \".dev\")) ? \"dev\" : pkg.version;\n\n/**\n * Resolve the project config directory. Prefers `CONFIG_DIR_NAME` (`.draht`),\n * falls back to `LEGACY_CONFIG_DIR_NAME` (`.pi`) if the primary doesn't exist\n * but the legacy one does.\n */\nexport function getProjectConfigDir(cwd: string): string {\n\tconst primary = join(cwd, CONFIG_DIR_NAME);\n\tif (existsSync(primary)) return primary;\n\tconst legacy = join(cwd, LEGACY_CONFIG_DIR_NAME);\n\tif (existsSync(legacy)) return legacy;\n\treturn primary; // default to primary even if it doesn't exist yet\n}\n\n// e.g., DRAHT_CODING_AGENT_DIR or TAU_CODING_AGENT_DIR\nexport const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;\n\nconst DEFAULT_SHARE_VIEWER_URL = \"https://draht.dev/session/\";\n\n/** Get the share viewer URL for a gist ID */\nexport function getShareViewerUrl(gistId: string): string {\n\tconst baseUrl = process.env.DRAHT_SHARE_VIEWER_URL || DEFAULT_SHARE_VIEWER_URL;\n\treturn `${baseUrl}#${gistId}`;\n}\n\n// =============================================================================\n// User Config Paths (~/.draht/agent/*)\n// =============================================================================\n\n/** Get the agent config directory (e.g., ~/.draht/agent/) */\nexport function getAgentDir(): string {\n\tconst envDir = process.env[ENV_AGENT_DIR];\n\tif (envDir) {\n\t\t// Expand tilde to home directory\n\t\tif (envDir === \"~\") return homedir();\n\t\tif (envDir.startsWith(\"~/\")) return homedir() + envDir.slice(1);\n\t\treturn envDir;\n\t}\n\treturn join(homedir(), CONFIG_DIR_NAME, \"agent\");\n}\n\n/** Get path to user's custom themes directory */\nexport function getCustomThemesDir(): string {\n\treturn join(getAgentDir(), \"themes\");\n}\n\n/** Get path to models.json */\nexport function getModelsPath(): string {\n\treturn join(getAgentDir(), \"models.json\");\n}\n\n/** Get path to auth.json */\nexport function getAuthPath(): string {\n\treturn join(getAgentDir(), \"auth.json\");\n}\n\n/** Get path to settings.json */\nexport function getSettingsPath(): string {\n\treturn join(getAgentDir(), \"settings.json\");\n}\n\n/** Get path to tools directory */\nexport function getToolsDir(): string {\n\treturn join(getAgentDir(), \"tools\");\n}\n\n/** Get path to managed binaries directory (fd, rg) */\nexport function getBinDir(): string {\n\treturn join(getAgentDir(), \"bin\");\n}\n\n/** Get path to prompt templates directory */\nexport function getPromptsDir(): string {\n\treturn join(getAgentDir(), \"prompts\");\n}\n\n/**\n * Get path to shipped prompt templates (bundled with the package).\n * - For Bun binary: prompts/ next to executable\n * - For Node.js: prompts/ at package root\n */\nexport function getShippedPromptsDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(dirname(process.execPath), \"prompts\");\n\t}\n\treturn join(getPackageDir(), \"prompts\");\n}\n\n/**\n * Get path to shipped hooks (bundled with the package).\n */\nexport function getShippedHooksDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(dirname(process.execPath), \"hooks\");\n\t}\n\treturn join(getPackageDir(), \"hooks\");\n}\n\n/** Get path to sessions directory */\nexport function getSessionsDir(): string {\n\treturn join(getAgentDir(), \"sessions\");\n}\n\n/** Get path to debug log file */\nexport function getDebugLogPath(): string {\n\treturn join(getAgentDir(), `${APP_NAME}-debug.log`);\n}\n"]}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,eAAO,MAAM,WAAW,SACqF,CAAC;AAE9G,gEAAgE;AAChE,eAAO,MAAM,YAAY,SAAyB,CAAC;AAMnD,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAEvF,UAAU,qBAAqB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC/D,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAsBD,wBAAgB,mBAAmB,IAAI,aAAa,CAqBnD;AAkND,wBAAgB,oBAAoB,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,iBAAiB,SAAc,GAC7B,iBAAiB,GAAG,SAAS,CAO/B;AAED,wBAAgB,mCAAmC,CAClD,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,iBAAiB,SAAc,GAC7B,MAAM,CAaR;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOhE;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAqBtC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAQrC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAO7C;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,iCAAiC;AACjC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,qCAAqC;AACrC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAOhD;AAED,8CAA8C;AAC9C,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE;AAwBD,eAAO,MAAM,YAAY,EAAE,MAA0C,CAAC;AACtE,eAAO,MAAM,QAAQ,EAAE,MAAmC,CAAC;AAC3D,eAAO,MAAM,SAAS,EAAE,MAA6C,CAAC;AACtE,eAAO,MAAM,eAAe,EAAE,MAA+C,CAAC;AAC9E,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAC5C,eAAO,MAAM,OAAO,EAAE,MAA+B,CAAC;AAEtD,6FAA6F;AAC7F,eAAO,MAAM,WAAW,EAAE,OAAkD,CAAC;AAE7E,oFAAoF;AACpF,eAAO,MAAM,eAAe,EAAE,MAAsC,CAAC;AAErE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMvD;AAGD,eAAO,MAAM,aAAa,QAA+C,CAAC;AAC1E,eAAO,MAAM,eAAe,QAAuD,CAAC;AAEpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAID,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxD;AAMD,0DAA0D;AAC1D,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,8BAA8B;AAC9B,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,4BAA4B;AAC5B,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,gCAAgC;AAChC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,kCAAkC;AAClC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,sDAAsD;AACtD,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,qCAAqC;AACrC,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iCAAiC;AACjC,wBAAgB,eAAe,IAAI,MAAM,CAExC","sourcesContent":["import { accessSync, constants, existsSync, readFileSync, realpathSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { basename, dirname, join, resolve, sep, win32 } from \"path\";\nimport { fileURLToPath } from \"url\";\nimport { spawnProcessSync } from \"./utils/child-process.ts\";\nimport { normalizePath } from \"./utils/paths.ts\";\n\n// =============================================================================\n// Package Detection\n// =============================================================================\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n/**\n * Detect if we're running as a Bun compiled binary.\n * Bun binaries have import.meta.url containing \"$bunfs\", \"~BUN\", or \"%7EBUN\" (Bun's virtual filesystem path)\n */\nexport const isBunBinary =\n\timport.meta.url.includes(\"$bunfs\") || import.meta.url.includes(\"~BUN\") || import.meta.url.includes(\"%7EBUN\");\n\n/** Detect if Bun is the runtime (compiled binary or bun run) */\nexport const isBunRuntime = !!process.versions.bun;\n\n// =============================================================================\n// Install Method Detection\n// =============================================================================\n\nexport type InstallMethod = \"bun-binary\" | \"npm\" | \"pnpm\" | \"yarn\" | \"bun\" | \"unknown\";\n\ninterface SelfUpdateCommandStep {\n\tcommand: string;\n\targs: string[];\n\tdisplay: string;\n}\n\nexport interface SelfUpdateCommand extends SelfUpdateCommandStep {\n\tsteps?: SelfUpdateCommandStep[];\n}\n\nfunction makeSelfUpdateCommand(\n\tinstallStep: SelfUpdateCommandStep,\n\tuninstallStep?: SelfUpdateCommandStep,\n): SelfUpdateCommand {\n\tif (!uninstallStep) return installStep;\n\treturn {\n\t\t...installStep,\n\t\tdisplay: `${uninstallStep.display} && ${installStep.display}`,\n\t\tsteps: [uninstallStep, installStep],\n\t};\n}\n\nfunction makeSelfUpdateCommandStep(command: string, args: string[]): SelfUpdateCommandStep {\n\treturn {\n\t\tcommand,\n\t\targs,\n\t\tdisplay: [command, ...args].map((arg) => (/\\s/.test(arg) ? `\"${arg}\"` : arg)).join(\" \"),\n\t};\n}\n\nexport function detectInstallMethod(): InstallMethod {\n\tif (isBunBinary) {\n\t\treturn \"bun-binary\";\n\t}\n\n\tconst resolvedPath = `${__dirname}\\0${process.execPath || \"\"}`.toLowerCase().replace(/\\\\/g, \"/\");\n\n\tif (resolvedPath.includes(\"/pnpm/\") || resolvedPath.includes(\"/.pnpm/\")) {\n\t\treturn \"pnpm\";\n\t}\n\tif (resolvedPath.includes(\"/yarn/\") || resolvedPath.includes(\"/.yarn/\")) {\n\t\treturn \"yarn\";\n\t}\n\tif (isBunRuntime || resolvedPath.includes(\"/install/global/node_modules/\")) {\n\t\treturn \"bun\";\n\t}\n\tif (resolvedPath.includes(\"/npm/\") || resolvedPath.includes(\"/node_modules/\")) {\n\t\treturn \"npm\";\n\t}\n\n\treturn \"unknown\";\n}\n\nfunction getInferredNpmInstall(): { root: string; prefix: string } | undefined {\n\tconst packageDir = getPackageDir();\n\tconst path = process.platform === \"win32\" || packageDir.includes(\"\\\\\") ? win32 : { basename, dirname };\n\tconst parent = path.dirname(packageDir);\n\tlet root: string | undefined;\n\tif (path.basename(parent).startsWith(\"@\") && path.basename(path.dirname(parent)) === \"node_modules\") {\n\t\troot = path.dirname(parent);\n\t} else if (path.basename(parent) === \"node_modules\") {\n\t\troot = parent;\n\t}\n\tif (!root) return undefined;\n\tconst rootParent = path.dirname(root);\n\tif (path.basename(rootParent) === \"lib\") return { root, prefix: path.dirname(rootParent) };\n\t// Windows global npm prefixes use `<prefix>\\\\node_modules`, which is\n\t// indistinguishable from local project installs by path shape alone. Do not\n\t// infer unsupported Windows custom prefixes without `npm root -g` evidence.\n\treturn undefined;\n}\n\nfunction getSelfUpdateCommandForMethod(\n\tmethod: InstallMethod,\n\tinstalledPackageName: string,\n\tupdatePackageName = installedPackageName,\n\tnpmCommand?: string[],\n): SelfUpdateCommand | undefined {\n\tswitch (method) {\n\t\tcase \"bun-binary\":\n\t\t\treturn undefined;\n\t\tcase \"pnpm\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"pnpm\", [\n\t\t\t\t\t\"install\",\n\t\t\t\t\t\"-g\",\n\t\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\t\"--config.minimumReleaseAge=0\",\n\t\t\t\t\tupdatePackageName,\n\t\t\t\t]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"pnpm\", [\"remove\", \"-g\", installedPackageName]),\n\t\t\t);\n\t\tcase \"yarn\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"yarn\", [\"global\", \"add\", \"--ignore-scripts\", updatePackageName]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"yarn\", [\"global\", \"remove\", installedPackageName]),\n\t\t\t);\n\t\tcase \"bun\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"bun\", [\n\t\t\t\t\t\"install\",\n\t\t\t\t\t\"-g\",\n\t\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\t\"--minimum-release-age=0\",\n\t\t\t\t\tupdatePackageName,\n\t\t\t\t]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"bun\", [\"uninstall\", \"-g\", installedPackageName]),\n\t\t\t);\n\t\tcase \"npm\": {\n\t\t\tconst [command = \"npm\", ...npmArgs] = npmCommand ?? [];\n\t\t\tconst inferred = npmCommand?.length ? undefined : getInferredNpmInstall();\n\t\t\tconst prefixArgs = [...npmArgs, ...(inferred ? [\"--prefix\", inferred.prefix] : [])];\n\t\t\tconst installStep = makeSelfUpdateCommandStep(command, [\n\t\t\t\t...prefixArgs,\n\t\t\t\t\"install\",\n\t\t\t\t\"-g\",\n\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\"--min-release-age=0\",\n\t\t\t\tupdatePackageName,\n\t\t\t]);\n\t\t\tconst uninstallStep =\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(command, [...prefixArgs, \"uninstall\", \"-g\", installedPackageName]);\n\t\t\treturn makeSelfUpdateCommand(installStep, uninstallStep);\n\t\t}\n\t\tcase \"unknown\":\n\t\t\treturn undefined;\n\t}\n}\n\nfunction readCommandOutput(\n\tcommand: string,\n\targs: string[],\n\toptions: { requireSuccess?: boolean } = {},\n): string | undefined {\n\tconst result = spawnProcessSync(command, args, {\n\t\tencoding: \"utf-8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t});\n\tif (result.status === 0) return result.stdout.trim() || undefined;\n\tif (options.requireSuccess) {\n\t\tconst reason = result.error?.message || result.stderr.trim() || `exit code ${result.status ?? \"unknown\"}`;\n\t\tthrow new Error(`Failed to run ${[command, ...args].join(\" \")}: ${reason}`);\n\t}\n\treturn undefined;\n}\n\nfunction getGlobalPackageRoots(method: InstallMethod, _packageName: string, npmCommand?: string[]): string[] {\n\tswitch (method) {\n\t\tcase \"npm\": {\n\t\t\tconst configured = !!npmCommand?.length;\n\t\t\tconst [command = \"npm\", ...npmArgs] = npmCommand ?? [];\n\t\t\tif (configured && command === \"bun\") {\n\t\t\t\tconst bunBin = readCommandOutput(command, [...npmArgs, \"pm\", \"bin\", \"-g\"], {\n\t\t\t\t\trequireSuccess: true,\n\t\t\t\t});\n\t\t\t\tconst roots = [join(homedir(), \".bun\", \"install\", \"global\", \"node_modules\")];\n\t\t\t\tif (bunBin) {\n\t\t\t\t\troots.push(join(dirname(bunBin), \"install\", \"global\", \"node_modules\"));\n\t\t\t\t}\n\t\t\t\treturn roots;\n\t\t\t}\n\t\t\tconst root = readCommandOutput(command, [...npmArgs, \"root\", \"-g\"], {\n\t\t\t\trequireSuccess: configured,\n\t\t\t});\n\t\t\tconst inferred = configured ? undefined : getInferredNpmInstall();\n\t\t\treturn [root, inferred?.root].filter((x): x is string => !!x);\n\t\t}\n\t\tcase \"pnpm\": {\n\t\t\tconst root = readCommandOutput(\"pnpm\", [\"root\", \"-g\"]);\n\t\t\treturn root ? [root, dirname(root)] : [];\n\t\t}\n\t\tcase \"yarn\": {\n\t\t\tconst dir = readCommandOutput(\"yarn\", [\"global\", \"dir\"]);\n\t\t\treturn dir ? [dir, join(dir, \"node_modules\")] : [];\n\t\t}\n\t\tcase \"bun\": {\n\t\t\tconst bunBin = readCommandOutput(\"bun\", [\"pm\", \"bin\", \"-g\"]);\n\t\t\tconst roots = [join(homedir(), \".bun\", \"install\", \"global\", \"node_modules\")];\n\t\t\tif (bunBin) {\n\t\t\t\troots.push(join(dirname(bunBin), \"install\", \"global\", \"node_modules\"));\n\t\t\t}\n\t\t\treturn roots;\n\t\t}\n\t\tcase \"bun-binary\":\n\t\tcase \"unknown\":\n\t\t\treturn [];\n\t}\n}\n\nfunction normalizeExistingPathForComparison(path: string, resolveSymlinks: boolean): string | undefined {\n\tconst resolvedPath = resolve(path);\n\tif (!existsSync(resolvedPath)) {\n\t\treturn undefined;\n\t}\n\tlet normalizedPath = resolvedPath;\n\tif (resolveSymlinks) {\n\t\ttry {\n\t\t\tnormalizedPath = realpathSync(resolvedPath);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\tif (process.platform === \"win32\") {\n\t\tnormalizedPath = normalizedPath.toLowerCase();\n\t}\n\treturn normalizedPath;\n}\n\nfunction getPathComparisonCandidates(path: string): string[] {\n\treturn Array.from(\n\t\tnew Set(\n\t\t\t[normalizeExistingPathForComparison(path, false), normalizeExistingPathForComparison(path, true)].filter(\n\t\t\t\t(candidate): candidate is string => !!candidate,\n\t\t\t),\n\t\t),\n\t);\n}\n\nfunction getEntrypointPackageDir(): string | undefined {\n\tconst entrypoint = process.argv[1];\n\tif (!entrypoint) return undefined;\n\tlet dir = dirname(entrypoint);\n\twhile (dir !== dirname(dir)) {\n\t\tif (existsSync(join(dir, \"package.json\"))) {\n\t\t\treturn dir;\n\t\t}\n\t\tdir = dirname(dir);\n\t}\n\treturn undefined;\n}\n\nfunction isSelfUpdatePathWritable(): boolean {\n\tconst packageDir = getPackageDir();\n\ttry {\n\t\taccessSync(packageDir, constants.W_OK);\n\t\taccessSync(dirname(packageDir), constants.W_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isManagedByGlobalPackageManager(method: InstallMethod, packageName: string, npmCommand?: string[]): boolean {\n\tconst packageDirs = [getPackageDir(), getEntrypointPackageDir()].filter((dir): dir is string => !!dir);\n\tconst packageDirCandidates = packageDirs.flatMap((dir) => getPathComparisonCandidates(dir));\n\treturn getGlobalPackageRoots(method, packageName, npmCommand).some((root) => {\n\t\treturn getPathComparisonCandidates(root).some((normalizedRoot) => {\n\t\t\tconst rootPrefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;\n\t\t\treturn packageDirCandidates.some((packageDir) => packageDir.startsWith(rootPrefix));\n\t\t});\n\t});\n}\n\nexport function getSelfUpdateCommand(\n\tpackageName: string,\n\tnpmCommand?: string[],\n\tupdatePackageName = packageName,\n): SelfUpdateCommand | undefined {\n\tconst method = detectInstallMethod();\n\tconst command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);\n\tif (!command || !isManagedByGlobalPackageManager(method, packageName, npmCommand) || !isSelfUpdatePathWritable()) {\n\t\treturn undefined;\n\t}\n\treturn command;\n}\n\nexport function getSelfUpdateUnavailableInstruction(\n\tpackageName: string,\n\tnpmCommand?: string[],\n\tupdatePackageName = packageName,\n): string {\n\tconst method = detectInstallMethod();\n\tif (method === \"bun-binary\") {\n\t\treturn `Download from: https://github.com/earendil-works/pi-mono/releases/latest`;\n\t}\n\tconst command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);\n\tif (command) {\n\t\tif (isManagedByGlobalPackageManager(method, packageName, npmCommand) && !isSelfUpdatePathWritable()) {\n\t\t\treturn `This installation is managed by a global ${method} install, but the install path is not writable. Update it yourself with: ${command.display}`;\n\t\t}\n\t\treturn `This installation is not managed by a global ${method} install. Update it with the package manager, wrapper, or source checkout that provides it.`;\n\t}\n\treturn `Update ${updatePackageName} using the package manager, wrapper, or source checkout that provides this installation.`;\n}\n\nexport function getUpdateInstruction(packageName: string): string {\n\tconst method = detectInstallMethod();\n\tconst command = getSelfUpdateCommandForMethod(method, packageName);\n\tif (command) {\n\t\treturn `Run: ${command.display}`;\n\t}\n\treturn getSelfUpdateUnavailableInstruction(packageName);\n}\n\n// =============================================================================\n// Package Asset Paths (shipped with executable)\n// =============================================================================\n\n/**\n * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).\n * - For Bun binary: returns the directory containing the executable\n * - For Node.js (dist/): returns __dirname (the dist/ directory)\n * - For tsx (src/): returns parent directory (the package root)\n */\nexport function getPackageDir(): string {\n\t// Allow override via environment variable (useful for Nix/Guix where store paths tokenize poorly)\n\tconst envDir = process.env.DRAHT_PACKAGE_DIR;\n\tif (envDir) {\n\t\treturn normalizePath(envDir);\n\t}\n\n\tif (isBunBinary) {\n\t\t// Bun binary: process.execPath points to the compiled executable\n\t\treturn dirname(process.execPath);\n\t}\n\t// Node.js: walk up from __dirname until we find package.json\n\tlet dir = __dirname;\n\twhile (dir !== dirname(dir)) {\n\t\tif (existsSync(join(dir, \"package.json\"))) {\n\t\t\treturn dir;\n\t\t}\n\t\tdir = dirname(dir);\n\t}\n\t// Fallback (shouldn't happen)\n\treturn __dirname;\n}\n\n/**\n * Get path to built-in themes directory (shipped with package)\n * - For Bun binary: theme/ next to executable\n * - For Node.js (dist/): dist/modes/interactive/theme/\n * - For tsx (src/): src/modes/interactive/theme/\n */\nexport function getThemesDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"theme\");\n\t}\n\t// Theme is in modes/interactive/theme/ relative to src/ or dist/\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"modes\", \"interactive\", \"theme\");\n}\n\n/**\n * Get path to HTML export template directory (shipped with package)\n * - For Bun binary: export-html/ next to executable\n * - For Node.js (dist/): dist/core/export-html/\n * - For tsx (src/): src/core/export-html/\n */\nexport function getExportTemplateDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"export-html\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"core\", \"export-html\");\n}\n\n/** Get path to package.json */\nexport function getPackageJsonPath(): string {\n\treturn join(getPackageDir(), \"package.json\");\n}\n\n/** Get path to README.md */\nexport function getReadmePath(): string {\n\treturn resolve(join(getPackageDir(), \"README.md\"));\n}\n\n/** Get path to docs directory */\nexport function getDocsPath(): string {\n\treturn resolve(join(getPackageDir(), \"docs\"));\n}\n\n/** Get path to examples directory */\nexport function getExamplesPath(): string {\n\treturn resolve(join(getPackageDir(), \"examples\"));\n}\n\n/** Get path to CHANGELOG.md */\nexport function getChangelogPath(): string {\n\treturn resolve(join(getPackageDir(), \"CHANGELOG.md\"));\n}\n\n/**\n * Get path to built-in interactive assets directory.\n * - For Bun binary: assets/ next to executable\n * - For Node.js (dist/): dist/modes/interactive/assets/\n * - For tsx (src/): src/modes/interactive/assets/\n */\nexport function getInteractiveAssetsDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"assets\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"modes\", \"interactive\", \"assets\");\n}\n\n/** Get path to a bundled interactive asset */\nexport function getBundledInteractiveAssetPath(name: string): string {\n\treturn join(getInteractiveAssetsDir(), name);\n}\n\n// =============================================================================\n// App Config (from package.json drahtConfig)\n// =============================================================================\n\ninterface PackageJson {\n\tname?: string;\n\tversion?: string;\n\tdrahtConfig?: {\n\t\tname?: string;\n\t\tconfigDir?: string;\n\t};\n}\n\nlet pkg: PackageJson = {};\ntry {\n\tpkg = JSON.parse(readFileSync(getPackageJsonPath(), \"utf-8\")) as PackageJson;\n} catch (e: unknown) {\n\tconst err = e as NodeJS.ErrnoException;\n\tif (err.code !== \"ENOENT\") throw e;\n}\n\nconst drahtConfigName: string | undefined = pkg.drahtConfig?.name;\nexport const PACKAGE_NAME: string = pkg.name || \"@draht/coding-agent\";\nexport const APP_NAME: string = drahtConfigName || \"draht\";\nexport const APP_TITLE: string = drahtConfigName ? APP_NAME : \"draht\";\nexport const CONFIG_DIR_NAME: string = pkg.drahtConfig?.configDir || \".draht\";\nexport const LEGACY_CONFIG_DIR_NAME = \".pi\";\nexport const VERSION: string = pkg.version || \"0.0.0\";\n\n/** True when running from source (src/ directory exists), not a compiled/installed build. */\nexport const IS_DEV_MODE: boolean = existsSync(join(getPackageDir(), \"src\"));\n\n/** Version string for display. \"dev\" in dev mode, the package version otherwise. */\nexport const DISPLAY_VERSION: string = IS_DEV_MODE ? \"dev\" : VERSION;\n\n/**\n * Resolve the project config directory. Prefers CONFIG_DIR_NAME (.draht),\n * falls back to LEGACY_CONFIG_DIR_NAME (.pi) if the primary doesn't exist.\n */\nexport function getProjectConfigDir(cwd: string): string {\n\tconst primary = join(cwd, CONFIG_DIR_NAME);\n\tif (existsSync(primary)) return primary;\n\tconst legacy = join(cwd, LEGACY_CONFIG_DIR_NAME);\n\tif (existsSync(legacy)) return legacy;\n\treturn primary;\n}\n\n// e.g., DRAHT_CODING_AGENT_DIR\nexport const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;\nexport const ENV_SESSION_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_SESSION_DIR`;\n\nexport function expandTildePath(path: string): string {\n\treturn normalizePath(path);\n}\n\nconst DEFAULT_SHARE_VIEWER_URL = \"https://pi.dev/session/\";\n\n/** Get the share viewer URL for a gist ID */\nexport function getShareViewerUrl(gistId: string): string {\n\tconst baseUrl = process.env.DRAHT_SHARE_VIEWER_URL || DEFAULT_SHARE_VIEWER_URL;\n\treturn `${baseUrl}#${gistId}`;\n}\n\n// =============================================================================\n// User Config Paths (~/.pi/agent/*)\n// =============================================================================\n\n/** Get the agent config directory (e.g., ~/.pi/agent/) */\nexport function getAgentDir(): string {\n\tconst envDir = process.env[ENV_AGENT_DIR];\n\tif (envDir) {\n\t\treturn expandTildePath(envDir);\n\t}\n\treturn join(homedir(), CONFIG_DIR_NAME, \"agent\");\n}\n\n/** Get path to user's custom themes directory */\nexport function getCustomThemesDir(): string {\n\treturn join(getAgentDir(), \"themes\");\n}\n\n/** Get path to models.json */\nexport function getModelsPath(): string {\n\treturn join(getAgentDir(), \"models.json\");\n}\n\n/** Get path to auth.json */\nexport function getAuthPath(): string {\n\treturn join(getAgentDir(), \"auth.json\");\n}\n\n/** Get path to settings.json */\nexport function getSettingsPath(): string {\n\treturn join(getAgentDir(), \"settings.json\");\n}\n\n/** Get path to tools directory */\nexport function getToolsDir(): string {\n\treturn join(getAgentDir(), \"tools\");\n}\n\n/** Get path to managed binaries directory (fd, rg) */\nexport function getBinDir(): string {\n\treturn join(getAgentDir(), \"bin\");\n}\n\n/** Get path to prompt templates directory */\nexport function getPromptsDir(): string {\n\treturn join(getAgentDir(), \"prompts\");\n}\n\n/** Get path to shipped prompts directory (bundled with the package). */\nexport function getShippedPromptsDir(): string {\n\treturn join(getPackageDir(), \"prompts\");\n}\n\n/** Get path to sessions directory */\nexport function getSessionsDir(): string {\n\treturn join(getAgentDir(), \"sessions\");\n}\n\n/** Get path to debug log file */\nexport function getDebugLogPath(): string {\n\treturn join(getAgentDir(), `${APP_NAME}-debug.log`);\n}\n"]}
package/dist/config.js CHANGED
@@ -1,7 +1,9 @@
1
- import { existsSync, readFileSync } from "fs";
1
+ import { accessSync, constants, existsSync, readFileSync, realpathSync } from "fs";
2
2
  import { homedir } from "os";
3
- import { dirname, join, resolve } from "path";
3
+ import { basename, dirname, join, resolve, sep, win32 } from "path";
4
4
  import { fileURLToPath } from "url";
5
+ import { spawnProcessSync } from "./utils/child-process.js";
6
+ import { normalizePath } from "./utils/paths.js";
5
7
  // =============================================================================
6
8
  // Package Detection
7
9
  // =============================================================================
@@ -14,41 +16,251 @@ const __dirname = dirname(__filename);
14
16
  export const isBunBinary = import.meta.url.includes("$bunfs") || import.meta.url.includes("~BUN") || import.meta.url.includes("%7EBUN");
15
17
  /** Detect if Bun is the runtime (compiled binary or bun run) */
16
18
  export const isBunRuntime = !!process.versions.bun;
19
+ function makeSelfUpdateCommand(installStep, uninstallStep) {
20
+ if (!uninstallStep)
21
+ return installStep;
22
+ return {
23
+ ...installStep,
24
+ display: `${uninstallStep.display} && ${installStep.display}`,
25
+ steps: [uninstallStep, installStep],
26
+ };
27
+ }
28
+ function makeSelfUpdateCommandStep(command, args) {
29
+ return {
30
+ command,
31
+ args,
32
+ display: [command, ...args].map((arg) => (/\s/.test(arg) ? `"${arg}"` : arg)).join(" "),
33
+ };
34
+ }
17
35
  export function detectInstallMethod() {
18
36
  if (isBunBinary) {
19
37
  return "bun-binary";
20
38
  }
21
- const resolvedPath = `${__dirname}\0${process.execPath || ""}`.toLowerCase();
22
- if (resolvedPath.includes("/pnpm/") || resolvedPath.includes("/.pnpm/") || resolvedPath.includes("\\pnpm\\")) {
39
+ const resolvedPath = `${__dirname}\0${process.execPath || ""}`.toLowerCase().replace(/\\/g, "/");
40
+ if (resolvedPath.includes("/pnpm/") || resolvedPath.includes("/.pnpm/")) {
23
41
  return "pnpm";
24
42
  }
25
- if (resolvedPath.includes("/yarn/") || resolvedPath.includes("/.yarn/") || resolvedPath.includes("\\yarn\\")) {
43
+ if (resolvedPath.includes("/yarn/") || resolvedPath.includes("/.yarn/")) {
26
44
  return "yarn";
27
45
  }
28
- if (isBunRuntime) {
46
+ if (isBunRuntime || resolvedPath.includes("/install/global/node_modules/")) {
29
47
  return "bun";
30
48
  }
31
- if (resolvedPath.includes("/npm/") || resolvedPath.includes("/node_modules/") || resolvedPath.includes("\\npm\\")) {
49
+ if (resolvedPath.includes("/npm/") || resolvedPath.includes("/node_modules/")) {
32
50
  return "npm";
33
51
  }
34
52
  return "unknown";
35
53
  }
36
- export function getUpdateInstruction(packageName) {
37
- const method = detectInstallMethod();
54
+ function getInferredNpmInstall() {
55
+ const packageDir = getPackageDir();
56
+ const path = process.platform === "win32" || packageDir.includes("\\") ? win32 : { basename, dirname };
57
+ const parent = path.dirname(packageDir);
58
+ let root;
59
+ if (path.basename(parent).startsWith("@") && path.basename(path.dirname(parent)) === "node_modules") {
60
+ root = path.dirname(parent);
61
+ }
62
+ else if (path.basename(parent) === "node_modules") {
63
+ root = parent;
64
+ }
65
+ if (!root)
66
+ return undefined;
67
+ const rootParent = path.dirname(root);
68
+ if (path.basename(rootParent) === "lib")
69
+ return { root, prefix: path.dirname(rootParent) };
70
+ // Windows global npm prefixes use `<prefix>\\node_modules`, which is
71
+ // indistinguishable from local project installs by path shape alone. Do not
72
+ // infer unsupported Windows custom prefixes without `npm root -g` evidence.
73
+ return undefined;
74
+ }
75
+ function getSelfUpdateCommandForMethod(method, installedPackageName, updatePackageName = installedPackageName, npmCommand) {
38
76
  switch (method) {
39
77
  case "bun-binary":
40
- return `Download from: https://github.com/draht-dev/draht/releases/latest`;
78
+ return undefined;
41
79
  case "pnpm":
42
- return `Run: pnpm install -g ${packageName}`;
80
+ return makeSelfUpdateCommand(makeSelfUpdateCommandStep("pnpm", [
81
+ "install",
82
+ "-g",
83
+ "--ignore-scripts",
84
+ "--config.minimumReleaseAge=0",
85
+ updatePackageName,
86
+ ]), updatePackageName === installedPackageName
87
+ ? undefined
88
+ : makeSelfUpdateCommandStep("pnpm", ["remove", "-g", installedPackageName]));
43
89
  case "yarn":
44
- return `Run: yarn global add ${packageName}`;
90
+ return makeSelfUpdateCommand(makeSelfUpdateCommandStep("yarn", ["global", "add", "--ignore-scripts", updatePackageName]), updatePackageName === installedPackageName
91
+ ? undefined
92
+ : makeSelfUpdateCommandStep("yarn", ["global", "remove", installedPackageName]));
45
93
  case "bun":
46
- return `Run: bun add -g ${packageName}`;
47
- case "npm":
48
- return `Run: npm install -g ${packageName}`;
49
- default:
50
- return `Run: bun add -g ${packageName}`;
94
+ return makeSelfUpdateCommand(makeSelfUpdateCommandStep("bun", [
95
+ "install",
96
+ "-g",
97
+ "--ignore-scripts",
98
+ "--minimum-release-age=0",
99
+ updatePackageName,
100
+ ]), updatePackageName === installedPackageName
101
+ ? undefined
102
+ : makeSelfUpdateCommandStep("bun", ["uninstall", "-g", installedPackageName]));
103
+ case "npm": {
104
+ const [command = "npm", ...npmArgs] = npmCommand ?? [];
105
+ const inferred = npmCommand?.length ? undefined : getInferredNpmInstall();
106
+ const prefixArgs = [...npmArgs, ...(inferred ? ["--prefix", inferred.prefix] : [])];
107
+ const installStep = makeSelfUpdateCommandStep(command, [
108
+ ...prefixArgs,
109
+ "install",
110
+ "-g",
111
+ "--ignore-scripts",
112
+ "--min-release-age=0",
113
+ updatePackageName,
114
+ ]);
115
+ const uninstallStep = updatePackageName === installedPackageName
116
+ ? undefined
117
+ : makeSelfUpdateCommandStep(command, [...prefixArgs, "uninstall", "-g", installedPackageName]);
118
+ return makeSelfUpdateCommand(installStep, uninstallStep);
119
+ }
120
+ case "unknown":
121
+ return undefined;
122
+ }
123
+ }
124
+ function readCommandOutput(command, args, options = {}) {
125
+ const result = spawnProcessSync(command, args, {
126
+ encoding: "utf-8",
127
+ stdio: ["ignore", "pipe", "pipe"],
128
+ });
129
+ if (result.status === 0)
130
+ return result.stdout.trim() || undefined;
131
+ if (options.requireSuccess) {
132
+ const reason = result.error?.message || result.stderr.trim() || `exit code ${result.status ?? "unknown"}`;
133
+ throw new Error(`Failed to run ${[command, ...args].join(" ")}: ${reason}`);
134
+ }
135
+ return undefined;
136
+ }
137
+ function getGlobalPackageRoots(method, _packageName, npmCommand) {
138
+ switch (method) {
139
+ case "npm": {
140
+ const configured = !!npmCommand?.length;
141
+ const [command = "npm", ...npmArgs] = npmCommand ?? [];
142
+ if (configured && command === "bun") {
143
+ const bunBin = readCommandOutput(command, [...npmArgs, "pm", "bin", "-g"], {
144
+ requireSuccess: true,
145
+ });
146
+ const roots = [join(homedir(), ".bun", "install", "global", "node_modules")];
147
+ if (bunBin) {
148
+ roots.push(join(dirname(bunBin), "install", "global", "node_modules"));
149
+ }
150
+ return roots;
151
+ }
152
+ const root = readCommandOutput(command, [...npmArgs, "root", "-g"], {
153
+ requireSuccess: configured,
154
+ });
155
+ const inferred = configured ? undefined : getInferredNpmInstall();
156
+ return [root, inferred?.root].filter((x) => !!x);
157
+ }
158
+ case "pnpm": {
159
+ const root = readCommandOutput("pnpm", ["root", "-g"]);
160
+ return root ? [root, dirname(root)] : [];
161
+ }
162
+ case "yarn": {
163
+ const dir = readCommandOutput("yarn", ["global", "dir"]);
164
+ return dir ? [dir, join(dir, "node_modules")] : [];
165
+ }
166
+ case "bun": {
167
+ const bunBin = readCommandOutput("bun", ["pm", "bin", "-g"]);
168
+ const roots = [join(homedir(), ".bun", "install", "global", "node_modules")];
169
+ if (bunBin) {
170
+ roots.push(join(dirname(bunBin), "install", "global", "node_modules"));
171
+ }
172
+ return roots;
173
+ }
174
+ case "bun-binary":
175
+ case "unknown":
176
+ return [];
177
+ }
178
+ }
179
+ function normalizeExistingPathForComparison(path, resolveSymlinks) {
180
+ const resolvedPath = resolve(path);
181
+ if (!existsSync(resolvedPath)) {
182
+ return undefined;
183
+ }
184
+ let normalizedPath = resolvedPath;
185
+ if (resolveSymlinks) {
186
+ try {
187
+ normalizedPath = realpathSync(resolvedPath);
188
+ }
189
+ catch {
190
+ return undefined;
191
+ }
192
+ }
193
+ if (process.platform === "win32") {
194
+ normalizedPath = normalizedPath.toLowerCase();
195
+ }
196
+ return normalizedPath;
197
+ }
198
+ function getPathComparisonCandidates(path) {
199
+ return Array.from(new Set([normalizeExistingPathForComparison(path, false), normalizeExistingPathForComparison(path, true)].filter((candidate) => !!candidate)));
200
+ }
201
+ function getEntrypointPackageDir() {
202
+ const entrypoint = process.argv[1];
203
+ if (!entrypoint)
204
+ return undefined;
205
+ let dir = dirname(entrypoint);
206
+ while (dir !== dirname(dir)) {
207
+ if (existsSync(join(dir, "package.json"))) {
208
+ return dir;
209
+ }
210
+ dir = dirname(dir);
211
+ }
212
+ return undefined;
213
+ }
214
+ function isSelfUpdatePathWritable() {
215
+ const packageDir = getPackageDir();
216
+ try {
217
+ accessSync(packageDir, constants.W_OK);
218
+ accessSync(dirname(packageDir), constants.W_OK);
219
+ return true;
220
+ }
221
+ catch {
222
+ return false;
223
+ }
224
+ }
225
+ function isManagedByGlobalPackageManager(method, packageName, npmCommand) {
226
+ const packageDirs = [getPackageDir(), getEntrypointPackageDir()].filter((dir) => !!dir);
227
+ const packageDirCandidates = packageDirs.flatMap((dir) => getPathComparisonCandidates(dir));
228
+ return getGlobalPackageRoots(method, packageName, npmCommand).some((root) => {
229
+ return getPathComparisonCandidates(root).some((normalizedRoot) => {
230
+ const rootPrefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;
231
+ return packageDirCandidates.some((packageDir) => packageDir.startsWith(rootPrefix));
232
+ });
233
+ });
234
+ }
235
+ export function getSelfUpdateCommand(packageName, npmCommand, updatePackageName = packageName) {
236
+ const method = detectInstallMethod();
237
+ const command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);
238
+ if (!command || !isManagedByGlobalPackageManager(method, packageName, npmCommand) || !isSelfUpdatePathWritable()) {
239
+ return undefined;
240
+ }
241
+ return command;
242
+ }
243
+ export function getSelfUpdateUnavailableInstruction(packageName, npmCommand, updatePackageName = packageName) {
244
+ const method = detectInstallMethod();
245
+ if (method === "bun-binary") {
246
+ return `Download from: https://github.com/earendil-works/pi-mono/releases/latest`;
247
+ }
248
+ const command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);
249
+ if (command) {
250
+ if (isManagedByGlobalPackageManager(method, packageName, npmCommand) && !isSelfUpdatePathWritable()) {
251
+ return `This installation is managed by a global ${method} install, but the install path is not writable. Update it yourself with: ${command.display}`;
252
+ }
253
+ return `This installation is not managed by a global ${method} install. Update it with the package manager, wrapper, or source checkout that provides it.`;
254
+ }
255
+ return `Update ${updatePackageName} using the package manager, wrapper, or source checkout that provides this installation.`;
256
+ }
257
+ export function getUpdateInstruction(packageName) {
258
+ const method = detectInstallMethod();
259
+ const command = getSelfUpdateCommandForMethod(method, packageName);
260
+ if (command) {
261
+ return `Run: ${command.display}`;
51
262
  }
263
+ return getSelfUpdateUnavailableInstruction(packageName);
52
264
  }
53
265
  // =============================================================================
54
266
  // Package Asset Paths (shipped with executable)
@@ -63,11 +275,7 @@ export function getPackageDir() {
63
275
  // Allow override via environment variable (useful for Nix/Guix where store paths tokenize poorly)
64
276
  const envDir = process.env.DRAHT_PACKAGE_DIR;
65
277
  if (envDir) {
66
- if (envDir === "~")
67
- return homedir();
68
- if (envDir.startsWith("~/"))
69
- return homedir() + envDir.slice(1);
70
- return envDir;
278
+ return normalizePath(envDir);
71
279
  }
72
280
  if (isBunBinary) {
73
281
  // Bun binary: process.execPath points to the compiled executable
@@ -92,7 +300,7 @@ export function getPackageDir() {
92
300
  */
93
301
  export function getThemesDir() {
94
302
  if (isBunBinary) {
95
- return join(dirname(process.execPath), "theme");
303
+ return join(getPackageDir(), "theme");
96
304
  }
97
305
  // Theme is in modes/interactive/theme/ relative to src/ or dist/
98
306
  const packageDir = getPackageDir();
@@ -107,7 +315,7 @@ export function getThemesDir() {
107
315
  */
108
316
  export function getExportTemplateDir() {
109
317
  if (isBunBinary) {
110
- return join(dirname(process.execPath), "export-html");
318
+ return join(getPackageDir(), "export-html");
111
319
  }
112
320
  const packageDir = getPackageDir();
113
321
  const srcOrDist = existsSync(join(packageDir, "src")) ? "src" : "dist";
@@ -141,7 +349,7 @@ export function getChangelogPath() {
141
349
  */
142
350
  export function getInteractiveAssetsDir() {
143
351
  if (isBunBinary) {
144
- return join(dirname(process.execPath), "assets");
352
+ return join(getPackageDir(), "assets");
145
353
  }
146
354
  const packageDir = getPackageDir();
147
355
  const srcOrDist = existsSync(join(packageDir, "src")) ? "src" : "dist";
@@ -151,18 +359,29 @@ export function getInteractiveAssetsDir() {
151
359
  export function getBundledInteractiveAssetPath(name) {
152
360
  return join(getInteractiveAssetsDir(), name);
153
361
  }
154
- // =============================================================================
155
- // App Config (from package.json drahtConfig)
156
- // =============================================================================
157
- const pkg = JSON.parse(readFileSync(getPackageJsonPath(), "utf-8"));
158
- export const APP_NAME = pkg.drahtConfig?.name || "draht";
362
+ let pkg = {};
363
+ try {
364
+ pkg = JSON.parse(readFileSync(getPackageJsonPath(), "utf-8"));
365
+ }
366
+ catch (e) {
367
+ const err = e;
368
+ if (err.code !== "ENOENT")
369
+ throw e;
370
+ }
371
+ const drahtConfigName = pkg.drahtConfig?.name;
372
+ export const PACKAGE_NAME = pkg.name || "@draht/coding-agent";
373
+ export const APP_NAME = drahtConfigName || "draht";
374
+ export const APP_TITLE = drahtConfigName ? APP_NAME : "draht";
159
375
  export const CONFIG_DIR_NAME = pkg.drahtConfig?.configDir || ".draht";
160
376
  export const LEGACY_CONFIG_DIR_NAME = ".pi";
161
- export const VERSION = existsSync(join(getPackageDir(), ".dev")) ? "dev" : pkg.version;
377
+ export const VERSION = pkg.version || "0.0.0";
378
+ /** True when running from source (src/ directory exists), not a compiled/installed build. */
379
+ export const IS_DEV_MODE = existsSync(join(getPackageDir(), "src"));
380
+ /** Version string for display. "dev" in dev mode, the package version otherwise. */
381
+ export const DISPLAY_VERSION = IS_DEV_MODE ? "dev" : VERSION;
162
382
  /**
163
- * Resolve the project config directory. Prefers `CONFIG_DIR_NAME` (`.draht`),
164
- * falls back to `LEGACY_CONFIG_DIR_NAME` (`.pi`) if the primary doesn't exist
165
- * but the legacy one does.
383
+ * Resolve the project config directory. Prefers CONFIG_DIR_NAME (.draht),
384
+ * falls back to LEGACY_CONFIG_DIR_NAME (.pi) if the primary doesn't exist.
166
385
  */
167
386
  export function getProjectConfigDir(cwd) {
168
387
  const primary = join(cwd, CONFIG_DIR_NAME);
@@ -171,29 +390,28 @@ export function getProjectConfigDir(cwd) {
171
390
  const legacy = join(cwd, LEGACY_CONFIG_DIR_NAME);
172
391
  if (existsSync(legacy))
173
392
  return legacy;
174
- return primary; // default to primary even if it doesn't exist yet
393
+ return primary;
175
394
  }
176
- // e.g., DRAHT_CODING_AGENT_DIR or TAU_CODING_AGENT_DIR
395
+ // e.g., DRAHT_CODING_AGENT_DIR
177
396
  export const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;
178
- const DEFAULT_SHARE_VIEWER_URL = "https://draht.dev/session/";
397
+ export const ENV_SESSION_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_SESSION_DIR`;
398
+ export function expandTildePath(path) {
399
+ return normalizePath(path);
400
+ }
401
+ const DEFAULT_SHARE_VIEWER_URL = "https://pi.dev/session/";
179
402
  /** Get the share viewer URL for a gist ID */
180
403
  export function getShareViewerUrl(gistId) {
181
404
  const baseUrl = process.env.DRAHT_SHARE_VIEWER_URL || DEFAULT_SHARE_VIEWER_URL;
182
405
  return `${baseUrl}#${gistId}`;
183
406
  }
184
407
  // =============================================================================
185
- // User Config Paths (~/.draht/agent/*)
408
+ // User Config Paths (~/.pi/agent/*)
186
409
  // =============================================================================
187
- /** Get the agent config directory (e.g., ~/.draht/agent/) */
410
+ /** Get the agent config directory (e.g., ~/.pi/agent/) */
188
411
  export function getAgentDir() {
189
412
  const envDir = process.env[ENV_AGENT_DIR];
190
413
  if (envDir) {
191
- // Expand tilde to home directory
192
- if (envDir === "~")
193
- return homedir();
194
- if (envDir.startsWith("~/"))
195
- return homedir() + envDir.slice(1);
196
- return envDir;
414
+ return expandTildePath(envDir);
197
415
  }
198
416
  return join(homedir(), CONFIG_DIR_NAME, "agent");
199
417
  }
@@ -225,26 +443,10 @@ export function getBinDir() {
225
443
  export function getPromptsDir() {
226
444
  return join(getAgentDir(), "prompts");
227
445
  }
228
- /**
229
- * Get path to shipped prompt templates (bundled with the package).
230
- * - For Bun binary: prompts/ next to executable
231
- * - For Node.js: prompts/ at package root
232
- */
446
+ /** Get path to shipped prompts directory (bundled with the package). */
233
447
  export function getShippedPromptsDir() {
234
- if (isBunBinary) {
235
- return join(dirname(process.execPath), "prompts");
236
- }
237
448
  return join(getPackageDir(), "prompts");
238
449
  }
239
- /**
240
- * Get path to shipped hooks (bundled with the package).
241
- */
242
- export function getShippedHooksDir() {
243
- if (isBunBinary) {
244
- return join(dirname(process.execPath), "hooks");
245
- }
246
- return join(getPackageDir(), "hooks");
247
- }
248
450
  /** Get path to sessions directory */
249
451
  export function getSessionsDir() {
250
452
  return join(getAgentDir(), "sessions");