@draht/coding-agent 2026.5.12 → 2026.7.7

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 (652) hide show
  1. package/CHANGELOG.md +41 -0
  2. package/README.md +1 -4
  3. package/bin/draht-tools.cjs +3756 -1
  4. package/dist/bun/cli.d.ts.map +1 -1
  5. package/dist/bun/cli.js +4 -2
  6. package/dist/bun/cli.js.map +1 -1
  7. package/dist/bun/register-bedrock.d.ts.map +1 -1
  8. package/dist/bun/register-bedrock.js +1 -1
  9. package/dist/bun/register-bedrock.js.map +1 -1
  10. package/dist/bun/restore-sandbox-env.d.ts +17 -0
  11. package/dist/bun/restore-sandbox-env.d.ts.map +1 -0
  12. package/dist/bun/restore-sandbox-env.js +36 -0
  13. package/dist/bun/restore-sandbox-env.js.map +1 -0
  14. package/dist/cli/args.d.ts +9 -4
  15. package/dist/cli/args.d.ts.map +1 -1
  16. package/dist/cli/args.js +91 -38
  17. package/dist/cli/args.js.map +1 -1
  18. package/dist/cli/config-selector.d.ts +5 -3
  19. package/dist/cli/config-selector.d.ts.map +1 -1
  20. package/dist/cli/config-selector.js +1 -1
  21. package/dist/cli/config-selector.js.map +1 -1
  22. package/dist/cli/file-processor.d.ts.map +1 -1
  23. package/dist/cli/file-processor.js +13 -26
  24. package/dist/cli/file-processor.js.map +1 -1
  25. package/dist/cli/initial-message.d.ts +1 -1
  26. package/dist/cli/initial-message.d.ts.map +1 -1
  27. package/dist/cli/initial-message.js.map +1 -1
  28. package/dist/cli/list-models.d.ts +1 -1
  29. package/dist/cli/list-models.d.ts.map +1 -1
  30. package/dist/cli/list-models.js +7 -1
  31. package/dist/cli/list-models.js.map +1 -1
  32. package/dist/cli/project-trust.d.ts +10 -0
  33. package/dist/cli/project-trust.d.ts.map +1 -0
  34. package/dist/cli/project-trust.js +48 -0
  35. package/dist/cli/project-trust.js.map +1 -0
  36. package/dist/cli/session-picker.d.ts +3 -2
  37. package/dist/cli/session-picker.d.ts.map +1 -1
  38. package/dist/cli/session-picker.js +5 -4
  39. package/dist/cli/session-picker.js.map +1 -1
  40. package/dist/cli/startup-ui.d.ts +20 -0
  41. package/dist/cli/startup-ui.d.ts.map +1 -0
  42. package/dist/cli/startup-ui.js +184 -0
  43. package/dist/cli/startup-ui.js.map +1 -0
  44. package/dist/cli.d.ts.map +1 -1
  45. package/dist/cli.js +7 -4
  46. package/dist/cli.js.map +1 -1
  47. package/dist/config.d.ts +27 -13
  48. package/dist/config.d.ts.map +1 -1
  49. package/dist/config.js +284 -63
  50. package/dist/config.js.map +1 -1
  51. package/dist/core/agent-session-runtime.d.ts +45 -9
  52. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  53. package/dist/core/agent-session-runtime.js +100 -33
  54. package/dist/core/agent-session-runtime.js.map +1 -1
  55. package/dist/core/agent-session-services.d.ts +6 -4
  56. package/dist/core/agent-session-services.d.ts.map +1 -1
  57. package/dist/core/agent-session-services.js +7 -4
  58. package/dist/core/agent-session-services.js.map +1 -1
  59. package/dist/core/agent-session.d.ts +55 -33
  60. package/dist/core/agent-session.d.ts.map +1 -1
  61. package/dist/core/agent-session.js +560 -492
  62. package/dist/core/agent-session.js.map +1 -1
  63. package/dist/core/auth-guidance.d.ts +5 -0
  64. package/dist/core/auth-guidance.d.ts.map +1 -0
  65. package/dist/core/auth-guidance.js +21 -0
  66. package/dist/core/auth-guidance.js.map +1 -0
  67. package/dist/core/auth-storage.d.ts +21 -13
  68. package/dist/core/auth-storage.d.ts.map +1 -1
  69. package/dist/core/auth-storage.js +48 -28
  70. package/dist/core/auth-storage.js.map +1 -1
  71. package/dist/core/bash-executor.d.ts +1 -15
  72. package/dist/core/bash-executor.d.ts.map +1 -1
  73. package/dist/core/bash-executor.js +10 -24
  74. package/dist/core/bash-executor.js.map +1 -1
  75. package/dist/core/builtins/subagent.d.ts.map +1 -1
  76. package/dist/core/builtins/subagent.js +1 -2
  77. package/dist/core/builtins/subagent.js.map +1 -1
  78. package/dist/core/compaction/branch-summarization.d.ts +9 -5
  79. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  80. package/dist/core/compaction/branch-summarization.js +10 -4
  81. package/dist/core/compaction/branch-summarization.js.map +1 -1
  82. package/dist/core/compaction/compaction.d.ts +8 -7
  83. package/dist/core/compaction/compaction.d.ts.map +1 -1
  84. package/dist/core/compaction/compaction.js +56 -47
  85. package/dist/core/compaction/compaction.js.map +1 -1
  86. package/dist/core/compaction/index.d.ts +3 -3
  87. package/dist/core/compaction/index.d.ts.map +1 -1
  88. package/dist/core/compaction/index.js.map +1 -1
  89. package/dist/core/compaction/utils.d.ts +1 -1
  90. package/dist/core/compaction/utils.d.ts.map +1 -1
  91. package/dist/core/compaction/utils.js +1 -1
  92. package/dist/core/compaction/utils.js.map +1 -1
  93. package/dist/core/exec.d.ts.map +1 -1
  94. package/dist/core/exec.js.map +1 -1
  95. package/dist/core/experimental.d.ts +2 -0
  96. package/dist/core/experimental.d.ts.map +1 -0
  97. package/dist/core/experimental.js +4 -0
  98. package/dist/core/experimental.js.map +1 -0
  99. package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
  100. package/dist/core/export-html/ansi-to-html.js +1 -1
  101. package/dist/core/export-html/ansi-to-html.js.map +1 -1
  102. package/dist/core/export-html/index.d.ts +1 -1
  103. package/dist/core/export-html/index.d.ts.map +1 -1
  104. package/dist/core/export-html/index.js +13 -11
  105. package/dist/core/export-html/index.js.map +1 -1
  106. package/dist/core/export-html/template.css +69 -4
  107. package/dist/core/export-html/template.js +231 -57
  108. package/dist/core/export-html/tool-renderer.d.ts +0 -6
  109. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  110. package/dist/core/export-html/tool-renderer.js +15 -2
  111. package/dist/core/export-html/tool-renderer.js.map +1 -1
  112. package/dist/core/export-html/vendor/marked.min.js +75 -3
  113. package/dist/core/extensions/index.d.ts +8 -8
  114. package/dist/core/extensions/index.d.ts.map +1 -1
  115. package/dist/core/extensions/index.js.map +1 -1
  116. package/dist/core/extensions/loader.d.ts +5 -6
  117. package/dist/core/extensions/loader.d.ts.map +1 -1
  118. package/dist/core/extensions/loader.js +98 -43
  119. package/dist/core/extensions/loader.js.map +1 -1
  120. package/dist/core/extensions/runner.d.ts +31 -12
  121. package/dist/core/extensions/runner.d.ts.map +1 -1
  122. package/dist/core/extensions/runner.js +248 -33
  123. package/dist/core/extensions/runner.js.map +1 -1
  124. package/dist/core/extensions/types.d.ts +191 -36
  125. package/dist/core/extensions/types.d.ts.map +1 -1
  126. package/dist/core/extensions/types.js.map +1 -1
  127. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  128. package/dist/core/extensions/wrapper.js +2 -2
  129. package/dist/core/extensions/wrapper.js.map +1 -1
  130. package/dist/core/footer-data-provider.d.ts +7 -1
  131. package/dist/core/footer-data-provider.d.ts.map +1 -1
  132. package/dist/core/footer-data-provider.js +78 -54
  133. package/dist/core/footer-data-provider.js.map +1 -1
  134. package/dist/core/http-dispatcher.d.ts +22 -0
  135. package/dist/core/http-dispatcher.d.ts.map +1 -0
  136. package/dist/core/http-dispatcher.js +91 -0
  137. package/dist/core/http-dispatcher.js.map +1 -0
  138. package/dist/core/index.d.ts +9 -8
  139. package/dist/core/index.d.ts.map +1 -1
  140. package/dist/core/index.js +2 -1
  141. package/dist/core/index.js.map +1 -1
  142. package/dist/core/keybindings.d.ts +67 -2
  143. package/dist/core/keybindings.d.ts.map +1 -1
  144. package/dist/core/keybindings.js +59 -7
  145. package/dist/core/keybindings.js.map +1 -1
  146. package/dist/core/model-registry.d.ts +24 -5
  147. package/dist/core/model-registry.d.ts.map +1 -1
  148. package/dist/core/model-registry.js +188 -51
  149. package/dist/core/model-registry.js.map +1 -1
  150. package/dist/core/model-resolver.d.ts +12 -1
  151. package/dist/core/model-resolver.d.ts.map +1 -1
  152. package/dist/core/model-resolver.js +84 -39
  153. package/dist/core/model-resolver.js.map +1 -1
  154. package/dist/core/output-guard.d.ts +1 -0
  155. package/dist/core/output-guard.d.ts.map +1 -1
  156. package/dist/core/output-guard.js +52 -22
  157. package/dist/core/output-guard.js.map +1 -1
  158. package/dist/core/package-manager.d.ts +22 -4
  159. package/dist/core/package-manager.d.ts.map +1 -1
  160. package/dist/core/package-manager.js +455 -157
  161. package/dist/core/package-manager.js.map +1 -1
  162. package/dist/core/project-trust.d.ts +15 -0
  163. package/dist/core/project-trust.d.ts.map +1 -0
  164. package/dist/core/project-trust.js +59 -0
  165. package/dist/core/project-trust.js.map +1 -0
  166. package/dist/core/prompt-templates.d.ts +13 -11
  167. package/dist/core/prompt-templates.d.ts.map +1 -1
  168. package/dist/core/prompt-templates.js +67 -76
  169. package/dist/core/prompt-templates.js.map +1 -1
  170. package/dist/core/provider-attribution.d.ts +4 -0
  171. package/dist/core/provider-attribution.d.ts.map +1 -0
  172. package/dist/core/provider-attribution.js +72 -0
  173. package/dist/core/provider-attribution.js.map +1 -0
  174. package/dist/core/provider-display-names.d.ts +2 -0
  175. package/dist/core/provider-display-names.d.ts.map +1 -0
  176. package/dist/core/provider-display-names.js +36 -0
  177. package/dist/core/provider-display-names.js.map +1 -0
  178. package/dist/core/resolve-config-value.d.ts +13 -6
  179. package/dist/core/resolve-config-value.d.ts.map +1 -1
  180. package/dist/core/resolve-config-value.js +143 -22
  181. package/dist/core/resolve-config-value.js.map +1 -1
  182. package/dist/core/resource-loader.d.ts +36 -15
  183. package/dist/core/resource-loader.d.ts.map +1 -1
  184. package/dist/core/resource-loader.js +178 -79
  185. package/dist/core/resource-loader.js.map +1 -1
  186. package/dist/core/sdk.d.ts +34 -18
  187. package/dist/core/sdk.d.ts.map +1 -1
  188. package/dist/core/sdk.js +47 -16
  189. package/dist/core/sdk.js.map +1 -1
  190. package/dist/core/session-manager.d.ts +32 -14
  191. package/dist/core/session-manager.d.ts.map +1 -1
  192. package/dist/core/session-manager.js +366 -209
  193. package/dist/core/session-manager.js.map +1 -1
  194. package/dist/core/settings-manager.d.ts +62 -6
  195. package/dist/core/settings-manager.d.ts.map +1 -1
  196. package/dist/core/settings-manager.js +230 -40
  197. package/dist/core/settings-manager.js.map +1 -1
  198. package/dist/core/skills.d.ts +10 -10
  199. package/dist/core/skills.d.ts.map +1 -1
  200. package/dist/core/skills.js +13 -35
  201. package/dist/core/skills.js.map +1 -1
  202. package/dist/core/slash-commands.d.ts +1 -1
  203. package/dist/core/slash-commands.d.ts.map +1 -1
  204. package/dist/core/slash-commands.js +7 -4
  205. package/dist/core/slash-commands.js.map +1 -1
  206. package/dist/core/source-info.d.ts +1 -1
  207. package/dist/core/source-info.d.ts.map +1 -1
  208. package/dist/core/source-info.js.map +1 -1
  209. package/dist/core/system-prompt.d.ts +4 -4
  210. package/dist/core/system-prompt.d.ts.map +1 -1
  211. package/dist/core/system-prompt.js +20 -16
  212. package/dist/core/system-prompt.js.map +1 -1
  213. package/dist/core/telemetry.d.ts +3 -0
  214. package/dist/core/telemetry.d.ts.map +1 -0
  215. package/dist/core/telemetry.js +9 -0
  216. package/dist/core/telemetry.js.map +1 -0
  217. package/dist/core/timings.d.ts +4 -2
  218. package/dist/core/timings.d.ts.map +1 -1
  219. package/dist/core/timings.js +24 -14
  220. package/dist/core/timings.js.map +1 -1
  221. package/dist/core/tools/bash.d.ts +11 -16
  222. package/dist/core/tools/bash.d.ts.map +1 -1
  223. package/dist/core/tools/bash.js +187 -178
  224. package/dist/core/tools/bash.js.map +1 -1
  225. package/dist/core/tools/edit-diff.d.ts +26 -5
  226. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  227. package/dist/core/tools/edit-diff.js +110 -23
  228. package/dist/core/tools/edit-diff.js.map +1 -1
  229. package/dist/core/tools/edit.d.ts +22 -24
  230. package/dist/core/tools/edit.d.ts.map +1 -1
  231. package/dist/core/tools/edit.js +201 -113
  232. package/dist/core/tools/edit.js.map +1 -1
  233. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  234. package/dist/core/tools/file-mutation-queue.js +27 -12
  235. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  236. package/dist/core/tools/find.d.ts +7 -18
  237. package/dist/core/tools/find.d.ts.map +1 -1
  238. package/dist/core/tools/find.js +148 -101
  239. package/dist/core/tools/find.js.map +1 -1
  240. package/dist/core/tools/grep.d.ts +11 -30
  241. package/dist/core/tools/grep.d.ts.map +1 -1
  242. package/dist/core/tools/grep.js +23 -12
  243. package/dist/core/tools/grep.js.map +1 -1
  244. package/dist/core/tools/index.d.ts +26 -101
  245. package/dist/core/tools/index.d.ts.map +1 -1
  246. package/dist/core/tools/index.js +78 -52
  247. package/dist/core/tools/index.js.map +1 -1
  248. package/dist/core/tools/ls.d.ts +6 -15
  249. package/dist/core/tools/ls.d.ts.map +1 -1
  250. package/dist/core/tools/ls.js +12 -17
  251. package/dist/core/tools/ls.js.map +1 -1
  252. package/dist/core/tools/output-accumulator.d.ts +52 -0
  253. package/dist/core/tools/output-accumulator.d.ts.map +1 -0
  254. package/dist/core/tools/output-accumulator.js +184 -0
  255. package/dist/core/tools/output-accumulator.js.map +1 -0
  256. package/dist/core/tools/path-utils.d.ts +2 -0
  257. package/dist/core/tools/path-utils.d.ts.map +1 -1
  258. package/dist/core/tools/path-utils.js +40 -22
  259. package/dist/core/tools/path-utils.js.map +1 -1
  260. package/dist/core/tools/read.d.ts +7 -18
  261. package/dist/core/tools/read.d.ts.map +1 -1
  262. package/dist/core/tools/read.js +103 -52
  263. package/dist/core/tools/read.js.map +1 -1
  264. package/dist/core/tools/render-utils.d.ts +5 -2
  265. package/dist/core/tools/render-utils.d.ts.map +1 -1
  266. package/dist/core/tools/render-utils.js +18 -2
  267. package/dist/core/tools/render-utils.js.map +1 -1
  268. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  269. package/dist/core/tools/tool-definition-wrapper.js +2 -0
  270. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  271. package/dist/core/tools/truncate.d.ts.map +1 -1
  272. package/dist/core/tools/truncate.js +12 -2
  273. package/dist/core/tools/truncate.js.map +1 -1
  274. package/dist/core/tools/write.d.ts +5 -14
  275. package/dist/core/tools/write.d.ts.map +1 -1
  276. package/dist/core/tools/write.js +27 -46
  277. package/dist/core/tools/write.js.map +1 -1
  278. package/dist/core/trust-manager.d.ts +36 -0
  279. package/dist/core/trust-manager.d.ts.map +1 -0
  280. package/dist/core/trust-manager.js +202 -0
  281. package/dist/core/trust-manager.js.map +1 -0
  282. package/dist/index.d.ts +33 -29
  283. package/dist/index.d.ts.map +1 -1
  284. package/dist/index.js +12 -9
  285. package/dist/index.js.map +1 -1
  286. package/dist/main.d.ts +5 -1
  287. package/dist/main.d.ts.map +1 -1
  288. package/dist/main.js +208 -93
  289. package/dist/main.js.map +1 -1
  290. package/dist/migrations.d.ts +2 -2
  291. package/dist/migrations.d.ts.map +1 -1
  292. package/dist/migrations.js +4 -4
  293. package/dist/migrations.js.map +1 -1
  294. package/dist/modes/index.d.ts +5 -5
  295. package/dist/modes/index.d.ts.map +1 -1
  296. package/dist/modes/index.js.map +1 -1
  297. package/dist/modes/interactive/assets/clankolas.png +0 -0
  298. package/dist/modes/interactive/components/assistant-message.d.ts +5 -1
  299. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  300. package/dist/modes/interactive/components/assistant-message.js +37 -15
  301. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  302. package/dist/modes/interactive/components/bash-execution.d.ts +1 -1
  303. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
  304. package/dist/modes/interactive/components/bash-execution.js +3 -3
  305. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  306. package/dist/modes/interactive/components/bordered-loader.d.ts.map +1 -1
  307. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  308. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  309. package/dist/modes/interactive/components/config-selector.d.ts +36 -5
  310. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  311. package/dist/modes/interactive/components/config-selector.js +318 -36
  312. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  313. package/dist/modes/interactive/components/countdown-timer.d.ts +2 -2
  314. package/dist/modes/interactive/components/countdown-timer.d.ts.map +1 -1
  315. package/dist/modes/interactive/components/countdown-timer.js +2 -2
  316. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  317. package/dist/modes/interactive/components/custom-editor.d.ts +1 -1
  318. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  319. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  320. package/dist/modes/interactive/components/custom-entry.d.ts +19 -0
  321. package/dist/modes/interactive/components/custom-entry.d.ts.map +1 -0
  322. package/dist/modes/interactive/components/custom-entry.js +52 -0
  323. package/dist/modes/interactive/components/custom-entry.js.map +1 -0
  324. package/dist/modes/interactive/components/custom-message.d.ts +2 -2
  325. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  326. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  327. package/dist/modes/interactive/components/diff.d.ts.map +1 -1
  328. package/dist/modes/interactive/components/diff.js.map +1 -1
  329. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -1
  330. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -1
  331. package/dist/modes/interactive/components/extension-editor.d.ts +3 -1
  332. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  333. package/dist/modes/interactive/components/extension-editor.js +26 -9
  334. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  335. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  336. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  337. package/dist/modes/interactive/components/extension-selector.d.ts +2 -0
  338. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  339. package/dist/modes/interactive/components/extension-selector.js +8 -3
  340. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  341. package/dist/modes/interactive/components/first-time-setup.d.ts +25 -0
  342. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -0
  343. package/dist/modes/interactive/components/first-time-setup.js +103 -0
  344. package/dist/modes/interactive/components/first-time-setup.js.map +1 -0
  345. package/dist/modes/interactive/components/footer.d.ts +4 -3
  346. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  347. package/dist/modes/interactive/components/footer.js +27 -7
  348. package/dist/modes/interactive/components/footer.js.map +1 -1
  349. package/dist/modes/interactive/components/index.d.ts +33 -31
  350. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  351. package/dist/modes/interactive/components/index.js +2 -0
  352. package/dist/modes/interactive/components/index.js.map +1 -1
  353. package/dist/modes/interactive/components/keybinding-hints.d.ts +5 -0
  354. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -1
  355. package/dist/modes/interactive/components/keybinding-hints.js +19 -5
  356. package/dist/modes/interactive/components/keybinding-hints.js.map +1 -1
  357. package/dist/modes/interactive/components/login-dialog.d.ts +12 -2
  358. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  359. package/dist/modes/interactive/components/login-dialog.js +45 -11
  360. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  361. package/dist/modes/interactive/components/model-selector.d.ts +2 -2
  362. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  363. package/dist/modes/interactive/components/model-selector.js +10 -6
  364. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  365. package/dist/modes/interactive/components/oauth-selector.d.ts +18 -6
  366. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  367. package/dist/modes/interactive/components/oauth-selector.js +93 -25
  368. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  369. package/dist/modes/interactive/components/scoped-models-selector.d.ts +5 -12
  370. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  371. package/dist/modes/interactive/components/scoped-models-selector.js +49 -31
  372. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  373. package/dist/modes/interactive/components/session-selector.d.ts +2 -2
  374. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  375. package/dist/modes/interactive/components/session-selector.js +33 -14
  376. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  377. package/dist/modes/interactive/components/settings-selector.d.ts +17 -0
  378. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  379. package/dist/modes/interactive/components/settings-selector.js +301 -20
  380. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  381. package/dist/modes/interactive/components/skill-invocation-message.d.ts +1 -1
  382. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  383. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  384. package/dist/modes/interactive/components/status-indicator.d.ts +28 -0
  385. package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -0
  386. package/dist/modes/interactive/components/status-indicator.js +60 -0
  387. package/dist/modes/interactive/components/status-indicator.js.map +1 -0
  388. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  389. package/dist/modes/interactive/components/thinking-selector.js +1 -1
  390. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  391. package/dist/modes/interactive/components/tool-execution.d.ts +6 -1
  392. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  393. package/dist/modes/interactive/components/tool-execution.js +57 -14
  394. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  395. package/dist/modes/interactive/components/tree-selector.d.ts +1 -1
  396. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  397. package/dist/modes/interactive/components/tree-selector.js +137 -13
  398. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  399. package/dist/modes/interactive/components/trust-selector.d.ts +23 -0
  400. package/dist/modes/interactive/components/trust-selector.d.ts.map +1 -0
  401. package/dist/modes/interactive/components/trust-selector.js +91 -0
  402. package/dist/modes/interactive/components/trust-selector.js.map +1 -0
  403. package/dist/modes/interactive/components/user-message-selector.d.ts +2 -2
  404. package/dist/modes/interactive/components/user-message-selector.d.ts.map +1 -1
  405. package/dist/modes/interactive/components/user-message-selector.js +8 -7
  406. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  407. package/dist/modes/interactive/components/user-message.d.ts +6 -1
  408. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  409. package/dist/modes/interactive/components/user-message.js +22 -8
  410. package/dist/modes/interactive/components/user-message.js.map +1 -1
  411. package/dist/modes/interactive/interactive-mode.d.ts +76 -19
  412. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  413. package/dist/modes/interactive/interactive-mode.js +1294 -494
  414. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  415. package/dist/modes/interactive/model-search.d.ts +12 -0
  416. package/dist/modes/interactive/model-search.d.ts.map +1 -0
  417. package/dist/modes/interactive/model-search.js +15 -0
  418. package/dist/modes/interactive/model-search.js.map +1 -0
  419. package/dist/modes/interactive/theme/dark.json +5 -4
  420. package/dist/modes/interactive/theme/light.json +5 -4
  421. package/dist/modes/interactive/theme/theme-controller.d.ts +29 -0
  422. package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -0
  423. package/dist/modes/interactive/theme/theme-controller.js +102 -0
  424. package/dist/modes/interactive/theme/theme-controller.js.map +1 -0
  425. package/dist/modes/interactive/theme/theme-schema.json +2 -1
  426. package/dist/modes/interactive/theme/theme.d.ts +41 -3
  427. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  428. package/dist/modes/interactive/theme/theme.js +183 -106
  429. package/dist/modes/interactive/theme/theme.js.map +1 -1
  430. package/dist/modes/print-mode.d.ts.map +1 -1
  431. package/dist/modes/print-mode.js +40 -20
  432. package/dist/modes/print-mode.js.map +1 -1
  433. package/dist/modes/rpc/rpc-client.d.ts +30 -5
  434. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  435. package/dist/modes/rpc/rpc-client.js +87 -8
  436. package/dist/modes/rpc/rpc-client.js.map +1 -1
  437. package/dist/modes/rpc/rpc-mode.d.ts +2 -2
  438. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  439. package/dist/modes/rpc/rpc-mode.js +113 -31
  440. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  441. package/dist/modes/rpc/rpc-types.d.ts +42 -4
  442. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  443. package/dist/modes/rpc/rpc-types.js.map +1 -1
  444. package/dist/package-manager-cli.d.ts +6 -2
  445. package/dist/package-manager-cli.d.ts.map +1 -1
  446. package/dist/package-manager-cli.js +504 -25
  447. package/dist/package-manager-cli.js.map +1 -1
  448. package/dist/prompts/commands/brainstorm.md +148 -0
  449. package/dist/prompts/commands/map-codebase.md +14 -0
  450. package/dist/rpc-entry.d.ts +3 -0
  451. package/dist/rpc-entry.d.ts.map +1 -0
  452. package/dist/rpc-entry.js +10 -0
  453. package/dist/rpc-entry.js.map +1 -0
  454. package/dist/utils/ansi.d.ts +2 -0
  455. package/dist/utils/ansi.d.ts.map +1 -0
  456. package/dist/utils/ansi.js +52 -0
  457. package/dist/utils/ansi.js.map +1 -0
  458. package/dist/utils/changelog.d.ts +2 -1
  459. package/dist/utils/changelog.d.ts.map +1 -1
  460. package/dist/utils/changelog.js +78 -0
  461. package/dist/utils/changelog.js.map +1 -1
  462. package/dist/utils/child-process.d.ts +12 -5
  463. package/dist/utils/child-process.d.ts.map +1 -1
  464. package/dist/utils/child-process.js +33 -5
  465. package/dist/utils/child-process.js.map +1 -1
  466. package/dist/utils/clipboard-image.d.ts.map +1 -1
  467. package/dist/utils/clipboard-image.js +2 -2
  468. package/dist/utils/clipboard-image.js.map +1 -1
  469. package/dist/utils/clipboard-native.d.ts +3 -1
  470. package/dist/utils/clipboard-native.d.ts.map +1 -1
  471. package/dist/utils/clipboard-native.js +14 -8
  472. package/dist/utils/clipboard-native.js.map +1 -1
  473. package/dist/utils/clipboard.d.ts.map +1 -1
  474. package/dist/utils/clipboard.js +84 -45
  475. package/dist/utils/clipboard.js.map +1 -1
  476. package/dist/utils/deprecation.d.ts +4 -0
  477. package/dist/utils/deprecation.d.ts.map +1 -0
  478. package/dist/utils/deprecation.js +13 -0
  479. package/dist/utils/deprecation.js.map +1 -0
  480. package/dist/utils/exif-orientation.d.ts +1 -1
  481. package/dist/utils/exif-orientation.d.ts.map +1 -1
  482. package/dist/utils/exif-orientation.js.map +1 -1
  483. package/dist/utils/fs-watch.d.ts +5 -0
  484. package/dist/utils/fs-watch.d.ts.map +1 -0
  485. package/dist/utils/fs-watch.js +25 -0
  486. package/dist/utils/fs-watch.js.map +1 -0
  487. package/dist/utils/git.d.ts.map +1 -1
  488. package/dist/utils/git.js +54 -22
  489. package/dist/utils/git.js.map +1 -1
  490. package/dist/utils/html.d.ts +7 -0
  491. package/dist/utils/html.d.ts.map +1 -0
  492. package/dist/utils/html.js +40 -0
  493. package/dist/utils/html.js.map +1 -0
  494. package/dist/utils/image-convert.d.ts +1 -0
  495. package/dist/utils/image-convert.d.ts.map +1 -1
  496. package/dist/utils/image-convert.js +21 -15
  497. package/dist/utils/image-convert.js.map +1 -1
  498. package/dist/utils/image-process.d.ts +18 -0
  499. package/dist/utils/image-process.d.ts.map +1 -0
  500. package/dist/utils/image-process.js +83 -0
  501. package/dist/utils/image-process.js.map +1 -0
  502. package/dist/utils/image-resize-core.d.ts +30 -0
  503. package/dist/utils/image-resize-core.d.ts.map +1 -0
  504. package/dist/utils/image-resize-core.js +124 -0
  505. package/dist/utils/image-resize-core.js.map +1 -0
  506. package/dist/utils/image-resize-worker.d.ts +2 -0
  507. package/dist/utils/image-resize-worker.d.ts.map +1 -0
  508. package/dist/utils/image-resize-worker.js +31 -0
  509. package/dist/utils/image-resize-worker.js.map +1 -0
  510. package/dist/utils/image-resize.d.ts +7 -27
  511. package/dist/utils/image-resize.d.ts.map +1 -1
  512. package/dist/utils/image-resize.js +75 -115
  513. package/dist/utils/image-resize.js.map +1 -1
  514. package/dist/utils/json.d.ts +3 -0
  515. package/dist/utils/json.d.ts.map +1 -0
  516. package/dist/utils/json.js +7 -0
  517. package/dist/utils/json.js.map +1 -0
  518. package/dist/utils/mime.d.ts +1 -0
  519. package/dist/utils/mime.d.ts.map +1 -1
  520. package/dist/utils/mime.js +100 -16
  521. package/dist/utils/mime.js.map +1 -1
  522. package/dist/utils/open-browser.d.ts +9 -0
  523. package/dist/utils/open-browser.d.ts.map +1 -0
  524. package/dist/utils/open-browser.js +22 -0
  525. package/dist/utils/open-browser.js.map +1 -0
  526. package/dist/utils/paths.d.ts +25 -1
  527. package/dist/utils/paths.d.ts.map +1 -1
  528. package/dist/utils/paths.js +75 -2
  529. package/dist/utils/paths.js.map +1 -1
  530. package/dist/utils/pi-user-agent.d.ts +2 -0
  531. package/dist/utils/pi-user-agent.d.ts.map +1 -0
  532. package/dist/utils/pi-user-agent.js +5 -0
  533. package/dist/utils/pi-user-agent.js.map +1 -0
  534. package/dist/utils/shell.d.ts +11 -6
  535. package/dist/utils/shell.d.ts.map +1 -1
  536. package/dist/utils/shell.js +42 -26
  537. package/dist/utils/shell.js.map +1 -1
  538. package/dist/utils/syntax-highlight.d.ts +12 -0
  539. package/dist/utils/syntax-highlight.d.ts.map +1 -0
  540. package/dist/utils/syntax-highlight.js +118 -0
  541. package/dist/utils/syntax-highlight.js.map +1 -0
  542. package/dist/utils/tools-manager.d.ts.map +1 -1
  543. package/dist/utils/tools-manager.js +86 -10
  544. package/dist/utils/tools-manager.js.map +1 -1
  545. package/dist/utils/version-check.d.ts +15 -0
  546. package/dist/utils/version-check.d.ts.map +1 -0
  547. package/dist/utils/version-check.js +59 -0
  548. package/dist/utils/version-check.js.map +1 -0
  549. package/dist/utils/windows-self-update.d.ts +3 -0
  550. package/dist/utils/windows-self-update.d.ts.map +1 -0
  551. package/dist/utils/windows-self-update.js +77 -0
  552. package/dist/utils/windows-self-update.js.map +1 -0
  553. package/docs/compaction.md +12 -12
  554. package/docs/containerization.md +111 -0
  555. package/docs/custom-provider.md +187 -47
  556. package/docs/development.md +5 -5
  557. package/docs/docs.json +156 -0
  558. package/docs/extensions.md +520 -79
  559. package/docs/index.md +82 -0
  560. package/docs/json.md +4 -4
  561. package/docs/keybindings.md +24 -2
  562. package/docs/models.md +119 -17
  563. package/docs/packages.md +19 -11
  564. package/docs/prompt-templates.md +30 -2
  565. package/docs/providers.md +85 -23
  566. package/docs/quickstart.md +165 -0
  567. package/docs/rpc.md +99 -10
  568. package/docs/sdk.md +118 -50
  569. package/docs/security.md +55 -0
  570. package/docs/{session.md → session-format.md} +29 -19
  571. package/docs/sessions.md +145 -0
  572. package/docs/settings.md +71 -11
  573. package/docs/skills.md +16 -17
  574. package/docs/terminal-setup.md +44 -2
  575. package/docs/termux.md +4 -4
  576. package/docs/themes.md +3 -3
  577. package/docs/tmux.md +4 -2
  578. package/docs/tui.md +44 -4
  579. package/docs/usage.md +305 -0
  580. package/examples/extensions/README.md +1 -0
  581. package/examples/extensions/border-status-editor.ts +145 -0
  582. package/examples/extensions/built-in-tool-renderer.ts +3 -0
  583. package/examples/extensions/custom-compaction.ts +2 -1
  584. package/examples/extensions/custom-header.ts +1 -1
  585. package/examples/extensions/custom-provider-anthropic/index.ts +2 -2
  586. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  587. package/examples/extensions/custom-provider-anthropic/package.json +2 -2
  588. package/examples/extensions/custom-provider-gitlab-duo/index.ts +63 -8
  589. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  590. package/examples/extensions/custom-provider-gitlab-duo/test.ts +2 -2
  591. package/examples/extensions/doom-overlay/doom-component.ts +2 -2
  592. package/examples/extensions/doom-overlay/index.ts +1 -1
  593. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  594. package/examples/extensions/dynamic-tools.ts +2 -2
  595. package/examples/extensions/entry-renderer.ts +41 -0
  596. package/examples/extensions/git-merge-and-resolve.ts +115 -0
  597. package/examples/extensions/github-issue-autocomplete.ts +185 -0
  598. package/examples/extensions/gondolin/index.ts +531 -0
  599. package/examples/extensions/gondolin/package-lock.json +185 -0
  600. package/examples/extensions/gondolin/package.json +19 -0
  601. package/examples/extensions/handoff.ts +52 -14
  602. package/examples/extensions/input-transform-streaming.ts +39 -0
  603. package/examples/extensions/interactive-shell.ts +1 -1
  604. package/examples/extensions/notify.ts +2 -9
  605. package/examples/extensions/overlay-qa-tests.ts +240 -138
  606. package/examples/extensions/overlay-test.ts +7 -4
  607. package/examples/extensions/plan-mode/index.ts +87 -37
  608. package/examples/extensions/plan-mode/utils.ts +1 -1
  609. package/examples/extensions/preset.ts +46 -7
  610. package/examples/extensions/project-trust.ts +64 -0
  611. package/examples/extensions/prompt-customizer.ts +97 -0
  612. package/examples/extensions/provider-payload.ts +8 -4
  613. package/examples/extensions/qna.ts +3 -3
  614. package/examples/extensions/question.ts +34 -20
  615. package/examples/extensions/questionnaire.ts +43 -30
  616. package/examples/extensions/reload-runtime.ts +1 -1
  617. package/examples/extensions/sandbox/index.ts +6 -6
  618. package/examples/extensions/sandbox/package-lock.json +5 -5
  619. package/examples/extensions/sandbox/package.json +2 -2
  620. package/examples/extensions/shutdown-command.ts +1 -1
  621. package/examples/extensions/snake.ts +1 -1
  622. package/examples/extensions/space-invaders.ts +1 -1
  623. package/examples/extensions/structured-output.ts +65 -0
  624. package/examples/extensions/subagent/agents.ts +2 -2
  625. package/examples/extensions/subagent/index.ts +58 -29
  626. package/examples/extensions/summarize.ts +3 -2
  627. package/examples/extensions/tic-tac-toe.ts +1008 -0
  628. package/examples/extensions/titlebar-spinner.ts +2 -2
  629. package/examples/extensions/todo.ts +2 -2
  630. package/examples/extensions/tool-override.ts +1 -1
  631. package/examples/extensions/tools.ts +5 -0
  632. package/examples/extensions/truncated-tool.ts +1 -1
  633. package/examples/extensions/with-deps/index.ts +1 -1
  634. package/examples/extensions/with-deps/package-lock.json +2 -2
  635. package/examples/extensions/with-deps/package.json +3 -3
  636. package/examples/extensions/working-indicator.ts +123 -0
  637. package/examples/extensions/working-message-test.ts +25 -0
  638. package/examples/sdk/01-minimal.ts +14 -10
  639. package/examples/sdk/02-custom-model.ts +13 -9
  640. package/examples/sdk/03-custom-prompt.ts +32 -17
  641. package/examples/sdk/04-skills.ts +5 -2
  642. package/examples/sdk/05-tools.ts +23 -31
  643. package/examples/sdk/06-extensions.ts +14 -8
  644. package/examples/sdk/07-context-files.ts +5 -3
  645. package/examples/sdk/08-prompt-templates.ts +5 -2
  646. package/examples/sdk/09-api-keys-and-oauth.ts +8 -4
  647. package/examples/sdk/10-settings.ts +8 -6
  648. package/examples/sdk/11-sessions.ts +4 -0
  649. package/examples/sdk/12-full-control.ts +15 -19
  650. package/package.json +22 -16
  651. package/prompts/commands/brainstorm.md +148 -0
  652. package/prompts/commands/map-codebase.md +14 -0
@@ -16,7 +16,7 @@ const BRAILLE_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧",
16
16
  function getBaseTitle(pi: ExtensionAPI): string {
17
17
  const cwd = path.basename(process.cwd());
18
18
  const session = pi.getSessionName();
19
- return session ? `D - ${session} - ${cwd}` : `D - ${cwd}`;
19
+ return session ? `π - ${session} - ${cwd}` : `π - ${cwd}`;
20
20
  }
21
21
 
22
22
  export default function (pi: ExtensionAPI) {
@@ -38,7 +38,7 @@ export default function (pi: ExtensionAPI) {
38
38
  const frame = BRAILLE_FRAMES[frameIndex % BRAILLE_FRAMES.length];
39
39
  const cwd = path.basename(process.cwd());
40
40
  const session = pi.getSessionName();
41
- const title = session ? `${frame} D - ${session} - ${cwd}` : `${frame} D - ${cwd}`;
41
+ const title = session ? `${frame} π - ${session} - ${cwd}` : `${frame} π - ${cwd}`;
42
42
  ctx.ui.setTitle(title);
43
43
  frameIndex++;
44
44
  }, 80);
@@ -13,7 +13,7 @@
13
13
  import { StringEnum } from "@draht/ai";
14
14
  import type { ExtensionAPI, ExtensionContext, Theme } from "@draht/coding-agent";
15
15
  import { matchesKey, Text, truncateToWidth } from "@draht/tui";
16
- import { Type } from "@sinclair/typebox";
16
+ import { Type } from "typebox";
17
17
 
18
18
  interface Todo {
19
19
  id: number;
@@ -284,7 +284,7 @@ export default function (pi: ExtensionAPI) {
284
284
  pi.registerCommand("todos", {
285
285
  description: "Show all todos on the current branch",
286
286
  handler: async (_args, ctx) => {
287
- if (!ctx.hasUI) {
287
+ if (ctx.mode !== "tui") {
288
288
  ctx.ui.notify("/todos requires interactive mode", "error");
289
289
  return;
290
290
  }
@@ -22,10 +22,10 @@
22
22
 
23
23
  import type { TextContent } from "@draht/ai";
24
24
  import { type ExtensionAPI, getAgentDir, withFileMutationQueue } from "@draht/coding-agent";
25
- import { Type } from "@sinclair/typebox";
26
25
  import { constants, readFileSync } from "fs";
27
26
  import { access, appendFile, readFile } from "fs/promises";
28
27
  import { join, resolve } from "path";
28
+ import { Type } from "typebox";
29
29
 
30
30
  const LOG_FILE = join(getAgentDir(), "read-access.log");
31
31
 
@@ -67,6 +67,11 @@ export default function toolsExtension(pi: ExtensionAPI) {
67
67
  pi.registerCommand("tools", {
68
68
  description: "Enable/disable tools",
69
69
  handler: async (_args, ctx) => {
70
+ if (ctx.mode !== "tui") {
71
+ ctx.ui.notify("/tools requires TUI mode", "error");
72
+ return;
73
+ }
74
+
70
75
  // Refresh tool list
71
76
  allTools = pi.getAllTools();
72
77
 
@@ -25,10 +25,10 @@ import {
25
25
  withFileMutationQueue,
26
26
  } from "@draht/coding-agent";
27
27
  import { Text } from "@draht/tui";
28
- import { Type } from "@sinclair/typebox";
29
28
  import { execSync } from "child_process";
30
29
  import { tmpdir } from "os";
31
30
  import { join } from "path";
31
+ import { Type } from "typebox";
32
32
 
33
33
  const RgParams = Type.Object({
34
34
  pattern: Type.String({ description: "Search pattern (regex)" }),
@@ -6,8 +6,8 @@
6
6
  */
7
7
 
8
8
  import type { ExtensionAPI } from "@draht/coding-agent";
9
- import { Type } from "@sinclair/typebox";
10
9
  import ms from "ms";
10
+ import { Type } from "typebox";
11
11
 
12
12
  export default function (pi: ExtensionAPI) {
13
13
  // Register a tool that uses ms
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "pi-extension-with-deps",
3
- "version": "1.20.0",
3
+ "version": "0.80.3",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "pi-extension-with-deps",
9
- "version": "1.20.0",
9
+ "version": "0.80.3",
10
10
  "dependencies": {
11
11
  "ms": "^2.1.3"
12
12
  },
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "pi-extension-with-deps",
3
3
  "private": true,
4
- "version": "1.20.0",
4
+ "version": "0.80.3",
5
5
  "type": "module",
6
6
  "scripts": {
7
7
  "clean": "echo 'nothing to clean'",
@@ -14,9 +14,9 @@
14
14
  ]
15
15
  },
16
16
  "dependencies": {
17
- "ms": "^2.1.3"
17
+ "ms": "2.1.3"
18
18
  },
19
19
  "devDependencies": {
20
- "@types/ms": "^2.1.0"
20
+ "@types/ms": "2.1.0"
21
21
  }
22
22
  }
@@ -0,0 +1,123 @@
1
+ /**
2
+ * Working Indicator Extension
3
+ *
4
+ * Demonstrates `ctx.ui.setWorkingIndicator()` for customizing the inline
5
+ * working indicator shown while pi is streaming a response.
6
+ *
7
+ * Usage:
8
+ * pi --extension examples/extensions/working-indicator.ts
9
+ *
10
+ * Commands:
11
+ * /working-indicator Show current mode
12
+ * /working-indicator dot Use a static dot indicator
13
+ * /working-indicator pulse Use a custom animated indicator
14
+ * /working-indicator none Hide the indicator entirely
15
+ * /working-indicator spinner Restore an animated spinner
16
+ * /working-indicator reset Restore pi's default spinner
17
+ */
18
+
19
+ import type { ExtensionAPI, ExtensionContext, WorkingIndicatorOptions } from "@draht/coding-agent";
20
+
21
+ type WorkingIndicatorMode = "dot" | "none" | "pulse" | "spinner" | "default";
22
+
23
+ const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
24
+ const PASTEL_RAINBOW = [
25
+ "\x1b[38;2;255;179;186m",
26
+ "\x1b[38;2;255;223;186m",
27
+ "\x1b[38;2;255;255;186m",
28
+ "\x1b[38;2;186;255;201m",
29
+ "\x1b[38;2;186;225;255m",
30
+ "\x1b[38;2;218;186;255m",
31
+ ];
32
+ const RESET_FG = "\x1b[39m";
33
+ const HIDDEN_INDICATOR: WorkingIndicatorOptions = {
34
+ frames: [],
35
+ };
36
+
37
+ function colorize(text: string, color: string): string {
38
+ return `${color}${text}${RESET_FG}`;
39
+ }
40
+
41
+ function getIndicator(mode: WorkingIndicatorMode): WorkingIndicatorOptions | undefined {
42
+ switch (mode) {
43
+ case "dot":
44
+ return {
45
+ frames: [colorize("●", PASTEL_RAINBOW[0])],
46
+ };
47
+ case "none":
48
+ return HIDDEN_INDICATOR;
49
+ case "pulse":
50
+ return {
51
+ frames: [
52
+ colorize("·", PASTEL_RAINBOW[0]),
53
+ colorize("•", PASTEL_RAINBOW[2]),
54
+ colorize("●", PASTEL_RAINBOW[4]),
55
+ colorize("•", PASTEL_RAINBOW[5]),
56
+ ],
57
+ intervalMs: 120,
58
+ };
59
+ case "spinner":
60
+ return {
61
+ frames: SPINNER_FRAMES.map((frame, index) =>
62
+ colorize(frame, PASTEL_RAINBOW[index % PASTEL_RAINBOW.length]!),
63
+ ),
64
+ intervalMs: 80,
65
+ };
66
+ case "default":
67
+ return undefined;
68
+ }
69
+ }
70
+
71
+ function describeMode(mode: WorkingIndicatorMode): string {
72
+ switch (mode) {
73
+ case "dot":
74
+ return "static dot";
75
+ case "none":
76
+ return "hidden";
77
+ case "pulse":
78
+ return "custom pulse";
79
+ case "spinner":
80
+ return "custom spinner";
81
+ case "default":
82
+ return "pi default spinner";
83
+ }
84
+ }
85
+
86
+ export default function (pi: ExtensionAPI) {
87
+ let mode: WorkingIndicatorMode = "spinner";
88
+
89
+ const applyIndicator = (ctx: ExtensionContext) => {
90
+ ctx.ui.setWorkingIndicator(getIndicator(mode));
91
+ ctx.ui.setStatus("working-indicator", ctx.ui.theme.fg("dim", `Indicator: ${describeMode(mode)}`));
92
+ };
93
+
94
+ pi.on("session_start", async (_event, ctx) => {
95
+ applyIndicator(ctx);
96
+ });
97
+
98
+ pi.registerCommand("working-indicator", {
99
+ description: "Set the streaming working indicator: dot, pulse, none, spinner, or reset.",
100
+ handler: async (args, ctx) => {
101
+ const nextMode = args.trim().toLowerCase();
102
+ if (!nextMode) {
103
+ ctx.ui.notify(`Working indicator: ${describeMode(mode)}`, "info");
104
+ return;
105
+ }
106
+
107
+ if (
108
+ nextMode !== "dot" &&
109
+ nextMode !== "none" &&
110
+ nextMode !== "pulse" &&
111
+ nextMode !== "spinner" &&
112
+ nextMode !== "reset"
113
+ ) {
114
+ ctx.ui.notify("Usage: /working-indicator [dot|pulse|none|spinner|reset]", "error");
115
+ return;
116
+ }
117
+
118
+ mode = nextMode === "reset" ? "default" : nextMode;
119
+ applyIndicator(ctx);
120
+ ctx.ui.notify(`Working indicator set to: ${describeMode(mode)}`, "info");
121
+ },
122
+ });
123
+ }
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Working Message Persistence Test
3
+ *
4
+ * Sets a custom working message and indicator on session start so you can
5
+ * verify they survive across loader recreations (e.g. between agent turns).
6
+ *
7
+ * Usage:
8
+ * pi --extension examples/extensions/working-message-test.ts
9
+ *
10
+ * Then send a few messages in interactive mode. The working message should
11
+ * stay "Working... (custom)" with a brown dot indicator every time the
12
+ * loader appears, not revert to the default gray "Working...".
13
+ */
14
+
15
+ import type { ExtensionAPI } from "@draht/coding-agent";
16
+
17
+ const CUSTOM_MESSAGE = "\x1b[38;2;155;86;63mWorking... (custom)\x1b[39m";
18
+ const CUSTOM_INDICATOR = { frames: ["\x1b[38;2;155;86;63m●\x1b[39m"] };
19
+
20
+ export default function (pi: ExtensionAPI) {
21
+ pi.on("session_start", async (_event, ctx) => {
22
+ ctx.ui.setWorkingMessage(CUSTOM_MESSAGE);
23
+ ctx.ui.setWorkingIndicator(CUSTOM_INDICATOR);
24
+ });
25
+ }
@@ -9,14 +9,18 @@ import { createAgentSession } from "@draht/coding-agent";
9
9
 
10
10
  const { session } = await createAgentSession();
11
11
 
12
- session.subscribe((event) => {
13
- if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
14
- process.stdout.write(event.assistantMessageEvent.delta);
15
- }
16
- });
12
+ try {
13
+ session.subscribe((event) => {
14
+ if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
15
+ process.stdout.write(event.assistantMessageEvent.delta);
16
+ }
17
+ });
17
18
 
18
- await session.prompt("What files are in the current directory?");
19
- session.state.messages.forEach((msg) => {
20
- console.log(msg);
21
- });
22
- console.log();
19
+ await session.prompt("What files are in the current directory?");
20
+ session.state.messages.forEach((msg) => {
21
+ console.log(msg);
22
+ });
23
+ console.log();
24
+ } finally {
25
+ session.dispose();
26
+ }
@@ -4,7 +4,7 @@
4
4
  * Shows how to select a specific model and thinking level.
5
5
  */
6
6
 
7
- import { getModel } from "@draht/ai";
7
+ import { getModel } from "@draht/ai/compat";
8
8
  import { AuthStorage, createAgentSession, ModelRegistry } from "@draht/coding-agent";
9
9
 
10
10
  // Set up auth storage and model registry
@@ -38,12 +38,16 @@ if (available.length > 0) {
38
38
  modelRegistry,
39
39
  });
40
40
 
41
- session.subscribe((event) => {
42
- if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
43
- process.stdout.write(event.assistantMessageEvent.delta);
44
- }
45
- });
46
-
47
- await session.prompt("Say hello in one sentence.");
48
- console.log();
41
+ try {
42
+ session.subscribe((event) => {
43
+ if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
44
+ process.stdout.write(event.assistantMessageEvent.delta);
45
+ }
46
+ });
47
+
48
+ await session.prompt("Say hello in one sentence.");
49
+ console.log();
50
+ } finally {
51
+ session.dispose();
52
+ }
49
53
  }
@@ -4,10 +4,15 @@
4
4
  * Shows how to replace or modify the default system prompt.
5
5
  */
6
6
 
7
- import { createAgentSession, DefaultResourceLoader, SessionManager } from "@draht/coding-agent";
7
+ import { createAgentSession, DefaultResourceLoader, getAgentDir, SessionManager } from "@draht/coding-agent";
8
+
9
+ const cwd = process.cwd();
10
+ const agentDir = getAgentDir();
8
11
 
9
12
  // Option 1: Replace prompt entirely
10
13
  const loader1 = new DefaultResourceLoader({
14
+ cwd,
15
+ agentDir,
11
16
  systemPromptOverride: () => `You are a helpful assistant that speaks like a pirate.
12
17
  Always end responses with "Arrr!"`,
13
18
  // Needed to avoid DefaultResourceLoader appending APPEND_SYSTEM.md from ~/.pi/agent or <cwd>/.pi.
@@ -20,18 +25,24 @@ const { session: session1 } = await createAgentSession({
20
25
  sessionManager: SessionManager.inMemory(),
21
26
  });
22
27
 
23
- session1.subscribe((event) => {
24
- if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
25
- process.stdout.write(event.assistantMessageEvent.delta);
26
- }
27
- });
28
+ try {
29
+ session1.subscribe((event) => {
30
+ if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
31
+ process.stdout.write(event.assistantMessageEvent.delta);
32
+ }
33
+ });
28
34
 
29
- console.log("=== Replace prompt ===");
30
- await session1.prompt("What is 2 + 2?");
31
- console.log("\n");
35
+ console.log("=== Replace prompt ===");
36
+ await session1.prompt("What is 2 + 2?");
37
+ console.log("\n");
38
+ } finally {
39
+ session1.dispose();
40
+ }
32
41
 
33
42
  // Option 2: Append instructions to the default prompt
34
43
  const loader2 = new DefaultResourceLoader({
44
+ cwd,
45
+ agentDir,
35
46
  appendSystemPromptOverride: (base) => [
36
47
  ...base,
37
48
  "## Additional Instructions\n- Always be concise\n- Use bullet points when listing things",
@@ -44,12 +55,16 @@ const { session: session2 } = await createAgentSession({
44
55
  sessionManager: SessionManager.inMemory(),
45
56
  });
46
57
 
47
- session2.subscribe((event) => {
48
- if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
49
- process.stdout.write(event.assistantMessageEvent.delta);
50
- }
51
- });
58
+ try {
59
+ session2.subscribe((event) => {
60
+ if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
61
+ process.stdout.write(event.assistantMessageEvent.delta);
62
+ }
63
+ });
52
64
 
53
- console.log("=== Modify prompt ===");
54
- await session2.prompt("List 3 benefits of TypeScript.");
55
- console.log();
65
+ console.log("=== Modify prompt ===");
66
+ await session2.prompt("List 3 benefits of TypeScript.");
67
+ console.log();
68
+ } finally {
69
+ session2.dispose();
70
+ }
@@ -9,6 +9,7 @@ import {
9
9
  createAgentSession,
10
10
  createSyntheticSourceInfo,
11
11
  DefaultResourceLoader,
12
+ getAgentDir,
12
13
  SessionManager,
13
14
  type Skill,
14
15
  } from "@draht/coding-agent";
@@ -24,6 +25,8 @@ const customSkill: Skill = {
24
25
  };
25
26
 
26
27
  const loader = new DefaultResourceLoader({
28
+ cwd: process.cwd(),
29
+ agentDir: getAgentDir(),
27
30
  skillsOverride: (current) => {
28
31
  const filteredSkills = current.skills.filter((s) => s.name.includes("browser") || s.name.includes("search"));
29
32
  return {
@@ -44,9 +47,9 @@ if (diagnostics.length > 0) {
44
47
  console.log("Warnings:", diagnostics);
45
48
  }
46
49
 
47
- await createAgentSession({
50
+ const { session } = await createAgentSession({
48
51
  resourceLoader: loader,
49
52
  sessionManager: SessionManager.inMemory(),
50
53
  });
51
-
52
54
  console.log("Session created with filtered skills");
55
+ session.dispose();
@@ -1,56 +1,48 @@
1
1
  /**
2
2
  * Tools Configuration
3
3
  *
4
- * Use built-in tool sets or individual tools.
4
+ * Use tool names to choose which built-in tools are enabled.
5
5
  *
6
- * IMPORTANT: When using a custom `cwd`, you must use the tool factory functions
7
- * (createCodingTools, createReadOnlyTools, createReadTool, etc.) to ensure
8
- * tools resolve paths relative to your cwd, not process.cwd().
6
+ * Tool names are matched against all available tools. If you use a custom `cwd`,
7
+ * createAgentSession() applies that cwd when it builds the actual built-in tools.
9
8
  *
10
- * For custom tools, see 06-extensions.ts - custom tools are now registered
11
- * via the extensions system using pi.registerTool().
9
+ * For custom tools, see 06-extensions.ts - custom tools are registered via the
10
+ * extensions system using pi.registerTool().
12
11
  */
13
12
 
14
- import {
15
- bashTool,
16
- createAgentSession,
17
- createBashTool,
18
- createCodingTools,
19
- createGrepTool,
20
- createReadTool,
21
- grepTool,
22
- readOnlyTools,
23
- readTool,
24
- SessionManager,
25
- } from "@draht/coding-agent";
13
+ import { createAgentSession, SessionManager } from "@draht/coding-agent";
26
14
 
27
- // Read-only mode (no edit/write) - uses process.cwd()
28
- await createAgentSession({
29
- tools: readOnlyTools,
15
+ // Read-only mode (no edit/write)
16
+ const { session: readOnlySession } = await createAgentSession({
17
+ tools: ["read", "grep", "find", "ls"],
30
18
  sessionManager: SessionManager.inMemory(),
31
19
  });
32
20
  console.log("Read-only session created");
21
+ readOnlySession.dispose();
33
22
 
34
- // Custom tool selection - uses process.cwd()
35
- await createAgentSession({
36
- tools: [readTool, bashTool, grepTool],
23
+ // Custom tool selection
24
+ const { session: customToolsSession } = await createAgentSession({
25
+ tools: ["read", "bash", "grep"],
37
26
  sessionManager: SessionManager.inMemory(),
38
27
  });
39
28
  console.log("Custom tools session created");
29
+ customToolsSession.dispose();
40
30
 
41
- // With custom cwd - MUST use factory functions!
31
+ // With custom cwd
42
32
  const customCwd = "/path/to/project";
43
- await createAgentSession({
33
+ const { session: customCwdSession } = await createAgentSession({
44
34
  cwd: customCwd,
45
- tools: createCodingTools(customCwd), // Tools resolve paths relative to customCwd
46
- sessionManager: SessionManager.inMemory(),
35
+ tools: ["read", "bash", "edit", "write"],
36
+ sessionManager: SessionManager.inMemory(customCwd),
47
37
  });
48
38
  console.log("Custom cwd session created");
39
+ customCwdSession.dispose();
49
40
 
50
41
  // Or pick specific tools for custom cwd
51
- await createAgentSession({
42
+ const { session: specificToolsSession } = await createAgentSession({
52
43
  cwd: customCwd,
53
- tools: [createReadTool(customCwd), createBashTool(customCwd), createGrepTool(customCwd)],
54
- sessionManager: SessionManager.inMemory(),
44
+ tools: ["read", "bash", "grep"],
45
+ sessionManager: SessionManager.inMemory(customCwd),
55
46
  });
56
47
  console.log("Specific tools with custom cwd session created");
48
+ specificToolsSession.dispose();
@@ -13,12 +13,14 @@
13
13
  * export default function (pi: ExtensionAPI) { ... }
14
14
  */
15
15
 
16
- import { createAgentSession, DefaultResourceLoader, SessionManager } from "@draht/coding-agent";
16
+ import { createAgentSession, DefaultResourceLoader, getAgentDir, SessionManager } from "@draht/coding-agent";
17
17
 
18
18
  // Extensions are discovered automatically from standard locations.
19
19
  // You can also add paths via settings.json or DefaultResourceLoader options.
20
20
 
21
21
  const resourceLoader = new DefaultResourceLoader({
22
+ cwd: process.cwd(),
23
+ agentDir: getAgentDir(),
22
24
  additionalExtensionPaths: ["./my-logging-extension.ts", "./my-safety-extension.ts"],
23
25
  extensionFactories: [
24
26
  (pi) => {
@@ -35,14 +37,18 @@ const { session } = await createAgentSession({
35
37
  sessionManager: SessionManager.inMemory(),
36
38
  });
37
39
 
38
- session.subscribe((event) => {
39
- if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
40
- process.stdout.write(event.assistantMessageEvent.delta);
41
- }
42
- });
40
+ try {
41
+ session.subscribe((event) => {
42
+ if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
43
+ process.stdout.write(event.assistantMessageEvent.delta);
44
+ }
45
+ });
43
46
 
44
- await session.prompt("List files in the current directory.");
45
- console.log();
47
+ await session.prompt("List files in the current directory.");
48
+ console.log();
49
+ } finally {
50
+ session.dispose();
51
+ }
46
52
 
47
53
  // Example extension file (./my-logging-extension.ts):
48
54
  /*
@@ -4,10 +4,12 @@
4
4
  * Context files provide project-specific instructions loaded into the system prompt.
5
5
  */
6
6
 
7
- import { createAgentSession, DefaultResourceLoader, SessionManager } from "@draht/coding-agent";
7
+ import { createAgentSession, DefaultResourceLoader, getAgentDir, SessionManager } from "@draht/coding-agent";
8
8
 
9
9
  // Disable context files entirely by returning an empty list in agentsFilesOverride.
10
10
  const loader = new DefaultResourceLoader({
11
+ cwd: process.cwd(),
12
+ agentDir: getAgentDir(),
11
13
  agentsFilesOverride: (current) => ({
12
14
  agentsFiles: [
13
15
  ...current.agentsFiles,
@@ -32,9 +34,9 @@ for (const file of discovered) {
32
34
  console.log(` - ${file.path} (${file.content.length} chars)`);
33
35
  }
34
36
 
35
- await createAgentSession({
37
+ const { session } = await createAgentSession({
36
38
  resourceLoader: loader,
37
39
  sessionManager: SessionManager.inMemory(),
38
40
  });
39
-
40
41
  console.log(`Session created with ${discovered.length + 1} context files`);
42
+ session.dispose();
@@ -8,6 +8,7 @@ import {
8
8
  createAgentSession,
9
9
  createSyntheticSourceInfo,
10
10
  DefaultResourceLoader,
11
+ getAgentDir,
11
12
  type PromptTemplate,
12
13
  SessionManager,
13
14
  } from "@draht/coding-agent";
@@ -26,6 +27,8 @@ const deployTemplate: PromptTemplate = {
26
27
  };
27
28
 
28
29
  const loader = new DefaultResourceLoader({
30
+ cwd: process.cwd(),
31
+ agentDir: getAgentDir(),
29
32
  promptsOverride: (current) => ({
30
33
  prompts: [...current.prompts, deployTemplate],
31
34
  diagnostics: current.diagnostics,
@@ -40,9 +43,9 @@ for (const template of discovered) {
40
43
  console.log(` /${template.name}: ${template.description}`);
41
44
  }
42
45
 
43
- await createAgentSession({
46
+ const { session } = await createAgentSession({
44
47
  resourceLoader: loader,
45
48
  sessionManager: SessionManager.inMemory(),
46
49
  });
47
-
48
50
  console.log(`Session created with ${discovered.length + 1} prompt templates`);
51
+ session.dispose();
@@ -11,38 +11,42 @@ import { AuthStorage, createAgentSession, ModelRegistry, SessionManager } from "
11
11
  const authStorage = AuthStorage.create();
12
12
  const modelRegistry = ModelRegistry.create(authStorage);
13
13
 
14
- await createAgentSession({
14
+ const { session: defaultAuthSession } = await createAgentSession({
15
15
  sessionManager: SessionManager.inMemory(),
16
16
  authStorage,
17
17
  modelRegistry,
18
18
  });
19
19
  console.log("Session with default auth storage and model registry");
20
+ defaultAuthSession.dispose();
20
21
 
21
22
  // Custom auth storage location
22
23
  const customAuthStorage = AuthStorage.create("/tmp/my-app/auth.json");
23
24
  const customModelRegistry = ModelRegistry.create(customAuthStorage, "/tmp/my-app/models.json");
24
25
 
25
- await createAgentSession({
26
+ const { session: customAuthSession } = await createAgentSession({
26
27
  sessionManager: SessionManager.inMemory(),
27
28
  authStorage: customAuthStorage,
28
29
  modelRegistry: customModelRegistry,
29
30
  });
30
31
  console.log("Session with custom auth storage location");
32
+ customAuthSession.dispose();
31
33
 
32
34
  // Runtime API key override (not persisted to disk)
33
35
  authStorage.setRuntimeApiKey("anthropic", "sk-my-temp-key");
34
- await createAgentSession({
36
+ const { session: runtimeKeySession } = await createAgentSession({
35
37
  sessionManager: SessionManager.inMemory(),
36
38
  authStorage,
37
39
  modelRegistry,
38
40
  });
39
41
  console.log("Session with runtime API key override");
42
+ runtimeKeySession.dispose();
40
43
 
41
44
  // No models.json - only built-in models
42
45
  const simpleRegistry = ModelRegistry.inMemory(authStorage);
43
- await createAgentSession({
46
+ const { session: builtInModelsSession } = await createAgentSession({
44
47
  sessionManager: SessionManager.inMemory(),
45
48
  authStorage,
46
49
  modelRegistry: simpleRegistry,
47
50
  });
48
51
  console.log("Session with only built-in models");
52
+ builtInModelsSession.dispose();