@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
@@ -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.79.1",
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.79.1",
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.79.1",
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
+ }
@@ -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();