@draht/coding-agent 2026.5.12 → 2026.6.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (605) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/bin/draht-tools.cjs +3756 -1
  3. package/dist/bun/cli.d.ts.map +1 -1
  4. package/dist/bun/cli.js +4 -2
  5. package/dist/bun/cli.js.map +1 -1
  6. package/dist/bun/restore-sandbox-env.d.ts +13 -0
  7. package/dist/bun/restore-sandbox-env.d.ts.map +1 -0
  8. package/dist/bun/restore-sandbox-env.js +32 -0
  9. package/dist/bun/restore-sandbox-env.js.map +1 -0
  10. package/dist/cli/args.d.ts +9 -4
  11. package/dist/cli/args.d.ts.map +1 -1
  12. package/dist/cli/args.js +88 -35
  13. package/dist/cli/args.js.map +1 -1
  14. package/dist/cli/config-selector.d.ts +2 -2
  15. package/dist/cli/config-selector.d.ts.map +1 -1
  16. package/dist/cli/config-selector.js +1 -1
  17. package/dist/cli/config-selector.js.map +1 -1
  18. package/dist/cli/file-processor.d.ts.map +1 -1
  19. package/dist/cli/file-processor.js +2 -3
  20. package/dist/cli/file-processor.js.map +1 -1
  21. package/dist/cli/initial-message.d.ts +1 -1
  22. package/dist/cli/initial-message.d.ts.map +1 -1
  23. package/dist/cli/initial-message.js.map +1 -1
  24. package/dist/cli/list-models.d.ts +1 -1
  25. package/dist/cli/list-models.d.ts.map +1 -1
  26. package/dist/cli/list-models.js +7 -1
  27. package/dist/cli/list-models.js.map +1 -1
  28. package/dist/cli/project-trust.d.ts +10 -0
  29. package/dist/cli/project-trust.d.ts.map +1 -0
  30. package/dist/cli/project-trust.js +48 -0
  31. package/dist/cli/project-trust.js.map +1 -0
  32. package/dist/cli/session-picker.d.ts +1 -1
  33. package/dist/cli/session-picker.d.ts.map +1 -1
  34. package/dist/cli/session-picker.js.map +1 -1
  35. package/dist/cli/startup-ui.d.ts +16 -0
  36. package/dist/cli/startup-ui.d.ts.map +1 -0
  37. package/dist/cli/startup-ui.js +112 -0
  38. package/dist/cli/startup-ui.js.map +1 -0
  39. package/dist/cli.d.ts.map +1 -1
  40. package/dist/cli.js +7 -4
  41. package/dist/cli.js.map +1 -1
  42. package/dist/config.d.ts +23 -13
  43. package/dist/config.d.ts.map +1 -1
  44. package/dist/config.js +264 -62
  45. package/dist/config.js.map +1 -1
  46. package/dist/core/agent-session-runtime.d.ts +45 -9
  47. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  48. package/dist/core/agent-session-runtime.js +100 -33
  49. package/dist/core/agent-session-runtime.js.map +1 -1
  50. package/dist/core/agent-session-services.d.ts +6 -4
  51. package/dist/core/agent-session-services.d.ts.map +1 -1
  52. package/dist/core/agent-session-services.js +7 -4
  53. package/dist/core/agent-session-services.js.map +1 -1
  54. package/dist/core/agent-session.d.ts +47 -31
  55. package/dist/core/agent-session.d.ts.map +1 -1
  56. package/dist/core/agent-session.js +470 -443
  57. package/dist/core/agent-session.js.map +1 -1
  58. package/dist/core/auth-guidance.d.ts +5 -0
  59. package/dist/core/auth-guidance.d.ts.map +1 -0
  60. package/dist/core/auth-guidance.js +21 -0
  61. package/dist/core/auth-guidance.js.map +1 -0
  62. package/dist/core/auth-storage.d.ts +10 -1
  63. package/dist/core/auth-storage.d.ts.map +1 -1
  64. package/dist/core/auth-storage.js +27 -6
  65. package/dist/core/auth-storage.js.map +1 -1
  66. package/dist/core/bash-executor.d.ts +1 -15
  67. package/dist/core/bash-executor.d.ts.map +1 -1
  68. package/dist/core/bash-executor.js +10 -24
  69. package/dist/core/bash-executor.js.map +1 -1
  70. package/dist/core/builtins/subagent.d.ts.map +1 -1
  71. package/dist/core/builtins/subagent.js +1 -2
  72. package/dist/core/builtins/subagent.js.map +1 -1
  73. package/dist/core/compaction/branch-summarization.d.ts +6 -4
  74. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  75. package/dist/core/compaction/branch-summarization.js +9 -3
  76. package/dist/core/compaction/branch-summarization.js.map +1 -1
  77. package/dist/core/compaction/compaction.d.ts +5 -5
  78. package/dist/core/compaction/compaction.d.ts.map +1 -1
  79. package/dist/core/compaction/compaction.js +43 -37
  80. package/dist/core/compaction/compaction.js.map +1 -1
  81. package/dist/core/compaction/index.d.ts +3 -3
  82. package/dist/core/compaction/index.d.ts.map +1 -1
  83. package/dist/core/compaction/index.js.map +1 -1
  84. package/dist/core/compaction/utils.d.ts +1 -1
  85. package/dist/core/compaction/utils.d.ts.map +1 -1
  86. package/dist/core/compaction/utils.js +1 -1
  87. package/dist/core/compaction/utils.js.map +1 -1
  88. package/dist/core/exec.d.ts.map +1 -1
  89. package/dist/core/exec.js.map +1 -1
  90. package/dist/core/experimental.d.ts +2 -0
  91. package/dist/core/experimental.d.ts.map +1 -0
  92. package/dist/core/experimental.js +4 -0
  93. package/dist/core/experimental.js.map +1 -0
  94. package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
  95. package/dist/core/export-html/ansi-to-html.js +1 -1
  96. package/dist/core/export-html/ansi-to-html.js.map +1 -1
  97. package/dist/core/export-html/index.d.ts +1 -1
  98. package/dist/core/export-html/index.d.ts.map +1 -1
  99. package/dist/core/export-html/index.js +13 -11
  100. package/dist/core/export-html/index.js.map +1 -1
  101. package/dist/core/export-html/template.css +69 -4
  102. package/dist/core/export-html/template.js +231 -57
  103. package/dist/core/export-html/tool-renderer.d.ts +0 -6
  104. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  105. package/dist/core/export-html/tool-renderer.js +15 -2
  106. package/dist/core/export-html/tool-renderer.js.map +1 -1
  107. package/dist/core/extensions/index.d.ts +8 -8
  108. package/dist/core/extensions/index.d.ts.map +1 -1
  109. package/dist/core/extensions/index.js.map +1 -1
  110. package/dist/core/extensions/loader.d.ts +3 -3
  111. package/dist/core/extensions/loader.d.ts.map +1 -1
  112. package/dist/core/extensions/loader.js +27 -35
  113. package/dist/core/extensions/loader.js.map +1 -1
  114. package/dist/core/extensions/runner.d.ts +30 -12
  115. package/dist/core/extensions/runner.d.ts.map +1 -1
  116. package/dist/core/extensions/runner.js +215 -32
  117. package/dist/core/extensions/runner.js.map +1 -1
  118. package/dist/core/extensions/types.d.ts +163 -35
  119. package/dist/core/extensions/types.d.ts.map +1 -1
  120. package/dist/core/extensions/types.js.map +1 -1
  121. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  122. package/dist/core/extensions/wrapper.js +2 -2
  123. package/dist/core/extensions/wrapper.js.map +1 -1
  124. package/dist/core/footer-data-provider.d.ts +7 -1
  125. package/dist/core/footer-data-provider.d.ts.map +1 -1
  126. package/dist/core/footer-data-provider.js +78 -54
  127. package/dist/core/footer-data-provider.js.map +1 -1
  128. package/dist/core/http-dispatcher.d.ts +21 -0
  129. package/dist/core/http-dispatcher.d.ts.map +1 -0
  130. package/dist/core/http-dispatcher.js +48 -0
  131. package/dist/core/http-dispatcher.js.map +1 -0
  132. package/dist/core/index.d.ts +9 -8
  133. package/dist/core/index.d.ts.map +1 -1
  134. package/dist/core/index.js +2 -1
  135. package/dist/core/index.js.map +1 -1
  136. package/dist/core/keybindings.d.ts +66 -1
  137. package/dist/core/keybindings.d.ts.map +1 -1
  138. package/dist/core/keybindings.js +56 -1
  139. package/dist/core/keybindings.js.map +1 -1
  140. package/dist/core/model-registry.d.ts +22 -4
  141. package/dist/core/model-registry.d.ts.map +1 -1
  142. package/dist/core/model-registry.js +216 -44
  143. package/dist/core/model-registry.js.map +1 -1
  144. package/dist/core/model-resolver.d.ts +2 -1
  145. package/dist/core/model-resolver.d.ts.map +1 -1
  146. package/dist/core/model-resolver.js +48 -21
  147. package/dist/core/model-resolver.js.map +1 -1
  148. package/dist/core/output-guard.d.ts +1 -0
  149. package/dist/core/output-guard.d.ts.map +1 -1
  150. package/dist/core/output-guard.js +52 -22
  151. package/dist/core/output-guard.js.map +1 -1
  152. package/dist/core/package-manager.d.ts +17 -2
  153. package/dist/core/package-manager.d.ts.map +1 -1
  154. package/dist/core/package-manager.js +363 -121
  155. package/dist/core/package-manager.js.map +1 -1
  156. package/dist/core/project-trust.d.ts +15 -0
  157. package/dist/core/project-trust.d.ts.map +1 -0
  158. package/dist/core/project-trust.js +58 -0
  159. package/dist/core/project-trust.js.map +1 -0
  160. package/dist/core/prompt-templates.d.ts +13 -11
  161. package/dist/core/prompt-templates.d.ts.map +1 -1
  162. package/dist/core/prompt-templates.js +67 -76
  163. package/dist/core/prompt-templates.js.map +1 -1
  164. package/dist/core/provider-attribution.d.ts +4 -0
  165. package/dist/core/provider-attribution.d.ts.map +1 -0
  166. package/dist/core/provider-attribution.js +72 -0
  167. package/dist/core/provider-attribution.js.map +1 -0
  168. package/dist/core/provider-display-names.d.ts +2 -0
  169. package/dist/core/provider-display-names.d.ts.map +1 -0
  170. package/dist/core/provider-display-names.js +36 -0
  171. package/dist/core/provider-display-names.js.map +1 -0
  172. package/dist/core/resolve-config-value.d.ts +9 -1
  173. package/dist/core/resolve-config-value.d.ts.map +1 -1
  174. package/dist/core/resolve-config-value.js +134 -11
  175. package/dist/core/resolve-config-value.js.map +1 -1
  176. package/dist/core/resource-loader.d.ts +34 -14
  177. package/dist/core/resource-loader.d.ts.map +1 -1
  178. package/dist/core/resource-loader.js +165 -76
  179. package/dist/core/resource-loader.js.map +1 -1
  180. package/dist/core/sdk.d.ts +26 -10
  181. package/dist/core/sdk.d.ts.map +1 -1
  182. package/dist/core/sdk.js +45 -16
  183. package/dist/core/sdk.js.map +1 -1
  184. package/dist/core/session-manager.d.ts +11 -12
  185. package/dist/core/session-manager.d.ts.map +1 -1
  186. package/dist/core/session-manager.js +245 -132
  187. package/dist/core/session-manager.js.map +1 -1
  188. package/dist/core/settings-manager.d.ts +52 -5
  189. package/dist/core/settings-manager.d.ts.map +1 -1
  190. package/dist/core/settings-manager.js +202 -38
  191. package/dist/core/settings-manager.js.map +1 -1
  192. package/dist/core/skills.d.ts +10 -10
  193. package/dist/core/skills.d.ts.map +1 -1
  194. package/dist/core/skills.js +13 -35
  195. package/dist/core/skills.js.map +1 -1
  196. package/dist/core/slash-commands.d.ts +1 -1
  197. package/dist/core/slash-commands.d.ts.map +1 -1
  198. package/dist/core/slash-commands.js +7 -4
  199. package/dist/core/slash-commands.js.map +1 -1
  200. package/dist/core/source-info.d.ts +1 -1
  201. package/dist/core/source-info.d.ts.map +1 -1
  202. package/dist/core/source-info.js.map +1 -1
  203. package/dist/core/system-prompt.d.ts +4 -4
  204. package/dist/core/system-prompt.d.ts.map +1 -1
  205. package/dist/core/system-prompt.js +14 -10
  206. package/dist/core/system-prompt.js.map +1 -1
  207. package/dist/core/telemetry.d.ts +3 -0
  208. package/dist/core/telemetry.d.ts.map +1 -0
  209. package/dist/core/telemetry.js +9 -0
  210. package/dist/core/telemetry.js.map +1 -0
  211. package/dist/core/tools/bash.d.ts +11 -16
  212. package/dist/core/tools/bash.d.ts.map +1 -1
  213. package/dist/core/tools/bash.js +162 -177
  214. package/dist/core/tools/bash.js.map +1 -1
  215. package/dist/core/tools/edit-diff.d.ts +3 -1
  216. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  217. package/dist/core/tools/edit-diff.js +11 -3
  218. package/dist/core/tools/edit-diff.js.map +1 -1
  219. package/dist/core/tools/edit.d.ts +22 -24
  220. package/dist/core/tools/edit.d.ts.map +1 -1
  221. package/dist/core/tools/edit.js +199 -111
  222. package/dist/core/tools/edit.js.map +1 -1
  223. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  224. package/dist/core/tools/file-mutation-queue.js +27 -12
  225. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  226. package/dist/core/tools/find.d.ts +7 -18
  227. package/dist/core/tools/find.d.ts.map +1 -1
  228. package/dist/core/tools/find.js +134 -95
  229. package/dist/core/tools/find.js.map +1 -1
  230. package/dist/core/tools/grep.d.ts +11 -30
  231. package/dist/core/tools/grep.d.ts.map +1 -1
  232. package/dist/core/tools/grep.js +23 -12
  233. package/dist/core/tools/grep.js.map +1 -1
  234. package/dist/core/tools/index.d.ts +26 -101
  235. package/dist/core/tools/index.d.ts.map +1 -1
  236. package/dist/core/tools/index.js +78 -52
  237. package/dist/core/tools/index.js.map +1 -1
  238. package/dist/core/tools/ls.d.ts +6 -15
  239. package/dist/core/tools/ls.d.ts.map +1 -1
  240. package/dist/core/tools/ls.js +12 -17
  241. package/dist/core/tools/ls.js.map +1 -1
  242. package/dist/core/tools/output-accumulator.d.ts +52 -0
  243. package/dist/core/tools/output-accumulator.d.ts.map +1 -0
  244. package/dist/core/tools/output-accumulator.js +184 -0
  245. package/dist/core/tools/output-accumulator.js.map +1 -0
  246. package/dist/core/tools/path-utils.d.ts +2 -0
  247. package/dist/core/tools/path-utils.d.ts.map +1 -1
  248. package/dist/core/tools/path-utils.js +40 -22
  249. package/dist/core/tools/path-utils.js.map +1 -1
  250. package/dist/core/tools/read.d.ts +7 -18
  251. package/dist/core/tools/read.d.ts.map +1 -1
  252. package/dist/core/tools/read.js +100 -36
  253. package/dist/core/tools/read.js.map +1 -1
  254. package/dist/core/tools/render-utils.d.ts +5 -2
  255. package/dist/core/tools/render-utils.d.ts.map +1 -1
  256. package/dist/core/tools/render-utils.js +18 -2
  257. package/dist/core/tools/render-utils.js.map +1 -1
  258. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  259. package/dist/core/tools/tool-definition-wrapper.js +2 -0
  260. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  261. package/dist/core/tools/truncate.d.ts.map +1 -1
  262. package/dist/core/tools/truncate.js +12 -2
  263. package/dist/core/tools/truncate.js.map +1 -1
  264. package/dist/core/tools/write.d.ts +5 -14
  265. package/dist/core/tools/write.d.ts.map +1 -1
  266. package/dist/core/tools/write.js +27 -46
  267. package/dist/core/tools/write.js.map +1 -1
  268. package/dist/core/trust-manager.d.ts +31 -0
  269. package/dist/core/trust-manager.d.ts.map +1 -0
  270. package/dist/core/trust-manager.js +187 -0
  271. package/dist/core/trust-manager.js.map +1 -0
  272. package/dist/index.d.ts +31 -29
  273. package/dist/index.d.ts.map +1 -1
  274. package/dist/index.js +9 -8
  275. package/dist/index.js.map +1 -1
  276. package/dist/main.d.ts +5 -1
  277. package/dist/main.d.ts.map +1 -1
  278. package/dist/main.js +170 -87
  279. package/dist/main.js.map +1 -1
  280. package/dist/migrations.d.ts +2 -2
  281. package/dist/migrations.d.ts.map +1 -1
  282. package/dist/migrations.js +127 -5
  283. package/dist/migrations.js.map +1 -1
  284. package/dist/modes/index.d.ts +5 -5
  285. package/dist/modes/index.d.ts.map +1 -1
  286. package/dist/modes/index.js.map +1 -1
  287. package/dist/modes/interactive/components/assistant-message.d.ts +2 -0
  288. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  289. package/dist/modes/interactive/components/assistant-message.js +14 -0
  290. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  291. package/dist/modes/interactive/components/bash-execution.d.ts +1 -1
  292. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
  293. package/dist/modes/interactive/components/bash-execution.js +3 -3
  294. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  295. package/dist/modes/interactive/components/bordered-loader.d.ts.map +1 -1
  296. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  297. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  298. package/dist/modes/interactive/components/config-selector.d.ts +4 -4
  299. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  300. package/dist/modes/interactive/components/config-selector.js +38 -11
  301. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  302. package/dist/modes/interactive/components/countdown-timer.d.ts +2 -2
  303. package/dist/modes/interactive/components/countdown-timer.d.ts.map +1 -1
  304. package/dist/modes/interactive/components/countdown-timer.js +2 -2
  305. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  306. package/dist/modes/interactive/components/custom-editor.d.ts +1 -1
  307. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  308. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  309. package/dist/modes/interactive/components/custom-message.d.ts +2 -2
  310. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  311. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  312. package/dist/modes/interactive/components/diff.d.ts.map +1 -1
  313. package/dist/modes/interactive/components/diff.js.map +1 -1
  314. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -1
  315. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -1
  316. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  317. package/dist/modes/interactive/components/extension-editor.js +14 -6
  318. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  319. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  320. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  321. package/dist/modes/interactive/components/extension-selector.d.ts +2 -0
  322. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  323. package/dist/modes/interactive/components/extension-selector.js +8 -3
  324. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  325. package/dist/modes/interactive/components/first-time-setup.d.ts +25 -0
  326. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -0
  327. package/dist/modes/interactive/components/first-time-setup.js +103 -0
  328. package/dist/modes/interactive/components/first-time-setup.js.map +1 -0
  329. package/dist/modes/interactive/components/footer.d.ts +2 -1
  330. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  331. package/dist/modes/interactive/components/footer.js +23 -7
  332. package/dist/modes/interactive/components/footer.js.map +1 -1
  333. package/dist/modes/interactive/components/index.d.ts +33 -31
  334. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  335. package/dist/modes/interactive/components/index.js +2 -0
  336. package/dist/modes/interactive/components/index.js.map +1 -1
  337. package/dist/modes/interactive/components/keybinding-hints.d.ts +5 -0
  338. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -1
  339. package/dist/modes/interactive/components/keybinding-hints.js +19 -5
  340. package/dist/modes/interactive/components/keybinding-hints.js.map +1 -1
  341. package/dist/modes/interactive/components/login-dialog.d.ts +12 -2
  342. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  343. package/dist/modes/interactive/components/login-dialog.js +46 -11
  344. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  345. package/dist/modes/interactive/components/model-selector.d.ts +2 -2
  346. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  347. package/dist/modes/interactive/components/model-selector.js +8 -5
  348. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  349. package/dist/modes/interactive/components/oauth-selector.d.ts +18 -6
  350. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  351. package/dist/modes/interactive/components/oauth-selector.js +93 -25
  352. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  353. package/dist/modes/interactive/components/scoped-models-selector.d.ts +5 -12
  354. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  355. package/dist/modes/interactive/components/scoped-models-selector.js +45 -30
  356. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  357. package/dist/modes/interactive/components/session-selector.d.ts +2 -1
  358. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  359. package/dist/modes/interactive/components/session-selector.js +20 -7
  360. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  361. package/dist/modes/interactive/components/settings-selector.d.ts +13 -0
  362. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  363. package/dist/modes/interactive/components/settings-selector.js +113 -4
  364. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  365. package/dist/modes/interactive/components/skill-invocation-message.d.ts +1 -1
  366. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  367. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  368. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  369. package/dist/modes/interactive/components/thinking-selector.js +1 -1
  370. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  371. package/dist/modes/interactive/components/tool-execution.d.ts +6 -1
  372. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  373. package/dist/modes/interactive/components/tool-execution.js +57 -14
  374. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  375. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  376. package/dist/modes/interactive/components/tree-selector.js +18 -9
  377. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  378. package/dist/modes/interactive/components/trust-selector.d.ts +23 -0
  379. package/dist/modes/interactive/components/trust-selector.d.ts.map +1 -0
  380. package/dist/modes/interactive/components/trust-selector.js +91 -0
  381. package/dist/modes/interactive/components/trust-selector.js.map +1 -0
  382. package/dist/modes/interactive/components/user-message-selector.d.ts +2 -2
  383. package/dist/modes/interactive/components/user-message-selector.d.ts.map +1 -1
  384. package/dist/modes/interactive/components/user-message-selector.js +8 -7
  385. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  386. package/dist/modes/interactive/components/user-message.d.ts +1 -0
  387. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  388. package/dist/modes/interactive/components/user-message.js +8 -7
  389. package/dist/modes/interactive/components/user-message.js.map +1 -1
  390. package/dist/modes/interactive/interactive-mode.d.ts +68 -13
  391. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  392. package/dist/modes/interactive/interactive-mode.js +1100 -319
  393. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  394. package/dist/modes/interactive/theme/dark.json +5 -4
  395. package/dist/modes/interactive/theme/light.json +5 -4
  396. package/dist/modes/interactive/theme/theme.d.ts +22 -3
  397. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  398. package/dist/modes/interactive/theme/theme.js +160 -105
  399. package/dist/modes/interactive/theme/theme.js.map +1 -1
  400. package/dist/modes/print-mode.d.ts.map +1 -1
  401. package/dist/modes/print-mode.js +40 -20
  402. package/dist/modes/print-mode.js.map +1 -1
  403. package/dist/modes/rpc/rpc-client.d.ts +11 -1
  404. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  405. package/dist/modes/rpc/rpc-client.js +73 -8
  406. package/dist/modes/rpc/rpc-client.js.map +1 -1
  407. package/dist/modes/rpc/rpc-mode.d.ts +2 -2
  408. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  409. package/dist/modes/rpc/rpc-mode.js +96 -30
  410. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  411. package/dist/modes/rpc/rpc-types.d.ts +16 -4
  412. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  413. package/dist/modes/rpc/rpc-types.js.map +1 -1
  414. package/dist/package-manager-cli.d.ts +6 -2
  415. package/dist/package-manager-cli.d.ts.map +1 -1
  416. package/dist/package-manager-cli.js +396 -21
  417. package/dist/package-manager-cli.js.map +1 -1
  418. package/dist/prompts/commands/map-codebase.md +14 -0
  419. package/dist/utils/ansi.d.ts +2 -0
  420. package/dist/utils/ansi.d.ts.map +1 -0
  421. package/dist/utils/ansi.js +52 -0
  422. package/dist/utils/ansi.js.map +1 -0
  423. package/dist/utils/changelog.d.ts +2 -1
  424. package/dist/utils/changelog.d.ts.map +1 -1
  425. package/dist/utils/changelog.js +78 -0
  426. package/dist/utils/changelog.js.map +1 -1
  427. package/dist/utils/child-process.d.ts +5 -1
  428. package/dist/utils/child-process.d.ts.map +1 -1
  429. package/dist/utils/child-process.js +10 -0
  430. package/dist/utils/child-process.js.map +1 -1
  431. package/dist/utils/clipboard-image.d.ts.map +1 -1
  432. package/dist/utils/clipboard-image.js +2 -2
  433. package/dist/utils/clipboard-image.js.map +1 -1
  434. package/dist/utils/clipboard-native.d.ts +3 -1
  435. package/dist/utils/clipboard-native.d.ts.map +1 -1
  436. package/dist/utils/clipboard-native.js +14 -8
  437. package/dist/utils/clipboard-native.js.map +1 -1
  438. package/dist/utils/clipboard.d.ts.map +1 -1
  439. package/dist/utils/clipboard.js +84 -45
  440. package/dist/utils/clipboard.js.map +1 -1
  441. package/dist/utils/deprecation.d.ts +4 -0
  442. package/dist/utils/deprecation.d.ts.map +1 -0
  443. package/dist/utils/deprecation.js +13 -0
  444. package/dist/utils/deprecation.js.map +1 -0
  445. package/dist/utils/exif-orientation.d.ts +1 -1
  446. package/dist/utils/exif-orientation.d.ts.map +1 -1
  447. package/dist/utils/exif-orientation.js.map +1 -1
  448. package/dist/utils/fs-watch.d.ts +5 -0
  449. package/dist/utils/fs-watch.d.ts.map +1 -0
  450. package/dist/utils/fs-watch.js +25 -0
  451. package/dist/utils/fs-watch.js.map +1 -0
  452. package/dist/utils/git.d.ts.map +1 -1
  453. package/dist/utils/git.js +54 -22
  454. package/dist/utils/git.js.map +1 -1
  455. package/dist/utils/html.d.ts +7 -0
  456. package/dist/utils/html.d.ts.map +1 -0
  457. package/dist/utils/html.js +40 -0
  458. package/dist/utils/html.js.map +1 -0
  459. package/dist/utils/image-convert.d.ts.map +1 -1
  460. package/dist/utils/image-convert.js.map +1 -1
  461. package/dist/utils/image-resize-core.d.ts +30 -0
  462. package/dist/utils/image-resize-core.d.ts.map +1 -0
  463. package/dist/utils/image-resize-core.js +124 -0
  464. package/dist/utils/image-resize-core.js.map +1 -0
  465. package/dist/utils/image-resize-worker.d.ts +2 -0
  466. package/dist/utils/image-resize-worker.d.ts.map +1 -0
  467. package/dist/utils/image-resize-worker.js +31 -0
  468. package/dist/utils/image-resize-worker.js.map +1 -0
  469. package/dist/utils/image-resize.d.ts +7 -27
  470. package/dist/utils/image-resize.d.ts.map +1 -1
  471. package/dist/utils/image-resize.js +75 -115
  472. package/dist/utils/image-resize.js.map +1 -1
  473. package/dist/utils/json.d.ts +3 -0
  474. package/dist/utils/json.d.ts.map +1 -0
  475. package/dist/utils/json.js +7 -0
  476. package/dist/utils/json.js.map +1 -0
  477. package/dist/utils/mime.d.ts +1 -0
  478. package/dist/utils/mime.d.ts.map +1 -1
  479. package/dist/utils/mime.js +59 -16
  480. package/dist/utils/mime.js.map +1 -1
  481. package/dist/utils/open-browser.d.ts +9 -0
  482. package/dist/utils/open-browser.d.ts.map +1 -0
  483. package/dist/utils/open-browser.js +22 -0
  484. package/dist/utils/open-browser.js.map +1 -0
  485. package/dist/utils/paths.d.ts +25 -1
  486. package/dist/utils/paths.d.ts.map +1 -1
  487. package/dist/utils/paths.js +75 -2
  488. package/dist/utils/paths.js.map +1 -1
  489. package/dist/utils/pi-user-agent.d.ts +2 -0
  490. package/dist/utils/pi-user-agent.d.ts.map +1 -0
  491. package/dist/utils/pi-user-agent.js +5 -0
  492. package/dist/utils/pi-user-agent.js.map +1 -0
  493. package/dist/utils/shell.d.ts +10 -6
  494. package/dist/utils/shell.d.ts.map +1 -1
  495. package/dist/utils/shell.js +35 -26
  496. package/dist/utils/shell.js.map +1 -1
  497. package/dist/utils/syntax-highlight.d.ts +12 -0
  498. package/dist/utils/syntax-highlight.d.ts.map +1 -0
  499. package/dist/utils/syntax-highlight.js +118 -0
  500. package/dist/utils/syntax-highlight.js.map +1 -0
  501. package/dist/utils/tools-manager.d.ts.map +1 -1
  502. package/dist/utils/tools-manager.js +86 -10
  503. package/dist/utils/tools-manager.js.map +1 -1
  504. package/dist/utils/version-check.d.ts +15 -0
  505. package/dist/utils/version-check.d.ts.map +1 -0
  506. package/dist/utils/version-check.js +82 -0
  507. package/dist/utils/version-check.js.map +1 -0
  508. package/dist/utils/windows-self-update.d.ts +3 -0
  509. package/dist/utils/windows-self-update.d.ts.map +1 -0
  510. package/dist/utils/windows-self-update.js +77 -0
  511. package/dist/utils/windows-self-update.js.map +1 -0
  512. package/docs/compaction.md +12 -12
  513. package/docs/containerization.md +111 -0
  514. package/docs/custom-provider.md +187 -47
  515. package/docs/development.md +5 -5
  516. package/docs/docs.json +156 -0
  517. package/docs/extensions.md +465 -71
  518. package/docs/index.md +82 -0
  519. package/docs/json.md +4 -4
  520. package/docs/keybindings.md +23 -1
  521. package/docs/models.md +119 -17
  522. package/docs/packages.md +17 -9
  523. package/docs/prompt-templates.md +30 -2
  524. package/docs/providers.md +83 -22
  525. package/docs/quickstart.md +165 -0
  526. package/docs/rpc.md +41 -10
  527. package/docs/sdk.md +68 -50
  528. package/docs/security.md +55 -0
  529. package/docs/{session.md → session-format.md} +11 -11
  530. package/docs/sessions.md +145 -0
  531. package/docs/settings.md +61 -11
  532. package/docs/skills.md +16 -17
  533. package/docs/terminal-setup.md +44 -2
  534. package/docs/termux.md +4 -4
  535. package/docs/themes.md +3 -3
  536. package/docs/tmux.md +4 -2
  537. package/docs/tui.md +44 -4
  538. package/docs/usage.md +305 -0
  539. package/examples/extensions/border-status-editor.ts +145 -0
  540. package/examples/extensions/built-in-tool-renderer.ts +3 -0
  541. package/examples/extensions/custom-header.ts +1 -1
  542. package/examples/extensions/custom-provider-anthropic/index.ts +1 -1
  543. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  544. package/examples/extensions/custom-provider-anthropic/package.json +2 -2
  545. package/examples/extensions/custom-provider-gitlab-duo/index.ts +55 -4
  546. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  547. package/examples/extensions/custom-provider-gitlab-duo/test.ts +1 -1
  548. package/examples/extensions/doom-overlay/doom-component.ts +2 -2
  549. package/examples/extensions/doom-overlay/index.ts +1 -1
  550. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  551. package/examples/extensions/dynamic-tools.ts +2 -2
  552. package/examples/extensions/git-merge-and-resolve.ts +115 -0
  553. package/examples/extensions/github-issue-autocomplete.ts +185 -0
  554. package/examples/extensions/gondolin/index.ts +531 -0
  555. package/examples/extensions/gondolin/package-lock.json +185 -0
  556. package/examples/extensions/gondolin/package.json +19 -0
  557. package/examples/extensions/handoff.ts +50 -12
  558. package/examples/extensions/input-transform-streaming.ts +39 -0
  559. package/examples/extensions/interactive-shell.ts +1 -1
  560. package/examples/extensions/notify.ts +2 -9
  561. package/examples/extensions/overlay-qa-tests.ts +240 -138
  562. package/examples/extensions/overlay-test.ts +7 -4
  563. package/examples/extensions/plan-mode/utils.ts +1 -1
  564. package/examples/extensions/preset.ts +36 -3
  565. package/examples/extensions/project-trust.ts +64 -0
  566. package/examples/extensions/prompt-customizer.ts +97 -0
  567. package/examples/extensions/provider-payload.ts +4 -0
  568. package/examples/extensions/qna.ts +1 -1
  569. package/examples/extensions/question.ts +2 -2
  570. package/examples/extensions/questionnaire.ts +2 -2
  571. package/examples/extensions/reload-runtime.ts +1 -1
  572. package/examples/extensions/sandbox/index.ts +4 -4
  573. package/examples/extensions/sandbox/package-lock.json +5 -5
  574. package/examples/extensions/sandbox/package.json +2 -2
  575. package/examples/extensions/shutdown-command.ts +1 -1
  576. package/examples/extensions/snake.ts +1 -1
  577. package/examples/extensions/space-invaders.ts +1 -1
  578. package/examples/extensions/structured-output.ts +65 -0
  579. package/examples/extensions/subagent/index.ts +51 -28
  580. package/examples/extensions/summarize.ts +1 -1
  581. package/examples/extensions/tic-tac-toe.ts +1008 -0
  582. package/examples/extensions/titlebar-spinner.ts +2 -2
  583. package/examples/extensions/todo.ts +2 -2
  584. package/examples/extensions/tool-override.ts +1 -1
  585. package/examples/extensions/tools.ts +5 -0
  586. package/examples/extensions/truncated-tool.ts +1 -1
  587. package/examples/extensions/with-deps/index.ts +1 -1
  588. package/examples/extensions/with-deps/package-lock.json +2 -2
  589. package/examples/extensions/with-deps/package.json +3 -3
  590. package/examples/extensions/working-indicator.ts +123 -0
  591. package/examples/extensions/working-message-test.ts +25 -0
  592. package/examples/sdk/01-minimal.ts +14 -10
  593. package/examples/sdk/02-custom-model.ts +12 -8
  594. package/examples/sdk/03-custom-prompt.ts +32 -17
  595. package/examples/sdk/04-skills.ts +5 -2
  596. package/examples/sdk/05-tools.ts +23 -31
  597. package/examples/sdk/06-extensions.ts +14 -8
  598. package/examples/sdk/07-context-files.ts +5 -3
  599. package/examples/sdk/08-prompt-templates.ts +5 -2
  600. package/examples/sdk/09-api-keys-and-oauth.ts +8 -4
  601. package/examples/sdk/10-settings.ts +8 -6
  602. package/examples/sdk/11-sessions.ts +4 -0
  603. package/examples/sdk/12-full-control.ts +13 -17
  604. package/package.json +13 -6
  605. package/prompts/commands/map-codebase.md +14 -0
@@ -7,28 +7,30 @@
7
7
  * - Register commands, keyboard shortcuts, and CLI flags
8
8
  * - Interact with the user via UI primitives
9
9
  */
10
- import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel } from "@draht/agent-core";
10
+ import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel, ToolExecutionMode } from "@draht/agent-core";
11
11
  import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context, ImageContent, Model, OAuthCredentials, OAuthLoginCallbacks, SimpleStreamOptions, TextContent, ToolResultMessage } from "@draht/ai";
12
- import type { AutocompleteItem, Component, EditorComponent, EditorTheme, KeyId, OverlayHandle, OverlayOptions, TUI } from "@draht/tui";
13
- import type { Static, TSchema } from "@sinclair/typebox";
14
- import type { Theme } from "../../modes/interactive/theme/theme.js";
15
- import type { BashResult } from "../bash-executor.js";
16
- import type { CompactionPreparation, CompactionResult } from "../compaction/index.js";
17
- import type { EventBus } from "../event-bus.js";
18
- import type { ExecOptions, ExecResult } from "../exec.js";
19
- import type { ReadonlyFooterDataProvider } from "../footer-data-provider.js";
20
- import type { KeybindingsManager } from "../keybindings.js";
21
- import type { CustomMessage } from "../messages.js";
22
- import type { ModelRegistry } from "../model-registry.js";
23
- import type { BranchSummaryEntry, CompactionEntry, ReadonlySessionManager, SessionEntry, SessionManager } from "../session-manager.js";
24
- import type { SlashCommandInfo } from "../slash-commands.js";
25
- import type { SourceInfo } from "../source-info.js";
26
- import type { BashOperations } from "../tools/bash.js";
27
- import type { EditToolDetails } from "../tools/edit.js";
28
- import type { BashToolDetails, BashToolInput, EditToolInput, FindToolDetails, FindToolInput, GrepToolDetails, GrepToolInput, LsToolDetails, LsToolInput, ReadToolDetails, ReadToolInput, WriteToolInput } from "../tools/index.js";
29
- export type { ExecOptions, ExecResult } from "../exec.js";
30
- export type { AgentToolResult, AgentToolUpdateCallback };
31
- export type { AppKeybinding, KeybindingsManager } from "../keybindings.js";
12
+ import type { AutocompleteItem, AutocompleteProvider, Component, EditorComponent, EditorTheme, KeyId, OverlayHandle, OverlayOptions, TUI } from "@draht/tui";
13
+ import type { Static, TSchema } from "typebox";
14
+ import type { Theme } from "../../modes/interactive/theme/theme.ts";
15
+ import type { BashResult } from "../bash-executor.ts";
16
+ import type { CompactionPreparation, CompactionResult } from "../compaction/index.ts";
17
+ import type { EventBus } from "../event-bus.ts";
18
+ import type { ExecOptions, ExecResult } from "../exec.ts";
19
+ import type { ReadonlyFooterDataProvider } from "../footer-data-provider.ts";
20
+ import type { KeybindingsManager } from "../keybindings.ts";
21
+ import type { CustomMessage } from "../messages.ts";
22
+ import type { ModelRegistry } from "../model-registry.ts";
23
+ import type { BranchSummaryEntry, CompactionEntry, ReadonlySessionManager, SessionEntry, SessionManager } from "../session-manager.ts";
24
+ import type { SlashCommandInfo } from "../slash-commands.ts";
25
+ import type { SourceInfo } from "../source-info.ts";
26
+ import type { BuildSystemPromptOptions } from "../system-prompt.ts";
27
+ import type { BashOperations } from "../tools/bash.ts";
28
+ import type { EditToolDetails } from "../tools/edit.ts";
29
+ import type { BashToolDetails, BashToolInput, EditToolInput, FindToolDetails, FindToolInput, GrepToolDetails, GrepToolInput, LsToolDetails, LsToolInput, ReadToolDetails, ReadToolInput, WriteToolInput } from "../tools/index.ts";
30
+ export type { ExecOptions, ExecResult } from "../exec.ts";
31
+ export type { BuildSystemPromptOptions } from "../system-prompt.ts";
32
+ export type { AgentToolResult, AgentToolUpdateCallback, ToolExecutionMode };
33
+ export type { AppKeybinding, KeybindingsManager } from "../keybindings.ts";
32
34
  /** Options for extension UI dialogs. */
33
35
  export interface ExtensionUIDialogOptions {
34
36
  /** AbortSignal to programmatically dismiss the dialog. */
@@ -48,6 +50,16 @@ export type TerminalInputHandler = (data: string) => {
48
50
  consume?: boolean;
49
51
  data?: string;
50
52
  } | undefined;
53
+ /** Working indicator configuration for the interactive streaming loader. */
54
+ export interface WorkingIndicatorOptions {
55
+ /** Animation frames. Use an empty array to hide the indicator entirely. Custom frames are rendered verbatim. */
56
+ frames?: string[];
57
+ /** Frame interval in milliseconds for animated indicators. */
58
+ intervalMs?: number;
59
+ }
60
+ /** Wrap the current autocomplete provider with additional behavior. */
61
+ export type AutocompleteProviderFactory = (current: AutocompleteProvider) => AutocompleteProvider;
62
+ export type EditorFactory = (tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => EditorComponent;
51
63
  /**
52
64
  * UI context for extensions to request interactive UI.
53
65
  * Each mode (interactive, RPC, print) provides its own implementation.
@@ -67,6 +79,17 @@ export interface ExtensionUIContext {
67
79
  setStatus(key: string, text: string | undefined): void;
68
80
  /** Set the working/loading message shown during streaming. Call with no argument to restore default. */
69
81
  setWorkingMessage(message?: string): void;
82
+ /** Show or hide the built-in interactive working loader row during streaming. */
83
+ setWorkingVisible(visible: boolean): void;
84
+ /**
85
+ * Configure the interactive working indicator shown during streaming.
86
+ *
87
+ * - Omit the argument to restore the default animated spinner.
88
+ * - Use `frames: ["●"]` for a static indicator.
89
+ * - Use `frames: []` to hide the indicator entirely.
90
+ * - Custom frames are rendered as provided, so extensions must add their own colors.
91
+ */
92
+ setWorkingIndicator(options?: WorkingIndicatorOptions): void;
70
93
  /** Set the label shown for hidden thinking blocks. Call with no argument to restore default. */
71
94
  setHiddenThinkingLabel(label?: string): void;
72
95
  /** Set a widget to display above or below the editor. Accepts string array or component factory. */
@@ -109,6 +132,8 @@ export interface ExtensionUIContext {
109
132
  getEditorText(): string;
110
133
  /** Show a multi-line editor for text editing. */
111
134
  editor(title: string, prefill?: string): Promise<string | undefined>;
135
+ /** Stack additional autocomplete behavior on top of the built-in provider. */
136
+ addAutocompleteProvider(factory: AutocompleteProviderFactory): void;
112
137
  /**
113
138
  * Set a custom editor component via factory function.
114
139
  * Pass undefined to restore the default editor.
@@ -142,7 +167,9 @@ export interface ExtensionUIContext {
142
167
  * );
143
168
  * ```
144
169
  */
145
- setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => EditorComponent) | undefined): void;
170
+ setEditorComponent(factory: EditorFactory | undefined): void;
171
+ /** Get the currently configured custom editor factory, or undefined when using the default editor. */
172
+ getEditorComponent(): EditorFactory | undefined;
146
173
  /** Get the current theme for styling. */
147
174
  readonly theme: Theme;
148
175
  /** Get all available themes with their names and file paths. */
@@ -177,10 +204,13 @@ export interface CompactOptions {
177
204
  /**
178
205
  * Context passed to extension event handlers.
179
206
  */
207
+ export type ExtensionMode = "tui" | "rpc" | "json" | "print";
180
208
  export interface ExtensionContext {
181
209
  /** UI methods for user interaction */
182
210
  ui: ExtensionUIContext;
183
- /** Whether UI is available (false in print/RPC mode) */
211
+ /** Current run mode. Use "tui" to guard terminal-only UI such as custom components. */
212
+ mode: ExtensionMode;
213
+ /** Whether dialog-capable UI is available (true in TUI and RPC modes) */
184
214
  hasUI: boolean;
185
215
  /** Current working directory */
186
216
  cwd: string;
@@ -192,6 +222,8 @@ export interface ExtensionContext {
192
222
  model: Model<any> | undefined;
193
223
  /** Whether the agent is idle (not streaming) */
194
224
  isIdle(): boolean;
225
+ /** Whether project-local trust is active for this context. */
226
+ isProjectTrusted(): boolean;
195
227
  /** The current abort signal, or undefined when the agent is not streaming. */
196
228
  signal: AbortSignal | undefined;
197
229
  /** Abort the current agent operation */
@@ -212,17 +244,23 @@ export interface ExtensionContext {
212
244
  * Includes session control methods only safe in user-initiated commands.
213
245
  */
214
246
  export interface ExtensionCommandContext extends ExtensionContext {
247
+ /** Get the current base system-prompt construction options. */
248
+ getSystemPromptOptions(): BuildSystemPromptOptions;
215
249
  /** Wait for the agent to finish streaming */
216
250
  waitForIdle(): Promise<void>;
217
251
  /** Start a new session, optionally with initialization. */
218
252
  newSession(options?: {
219
253
  parentSession?: string;
220
254
  setup?: (sessionManager: SessionManager) => Promise<void>;
255
+ withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
221
256
  }): Promise<{
222
257
  cancelled: boolean;
223
258
  }>;
224
259
  /** Fork from a specific entry, creating a new session file. */
225
- fork(entryId: string): Promise<{
260
+ fork(entryId: string, options?: {
261
+ position?: "before" | "at";
262
+ withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
263
+ }): Promise<{
226
264
  cancelled: boolean;
227
265
  }>;
228
266
  /** Navigate to a different point in the session tree. */
@@ -235,12 +273,28 @@ export interface ExtensionCommandContext extends ExtensionContext {
235
273
  cancelled: boolean;
236
274
  }>;
237
275
  /** Switch to a different session file. */
238
- switchSession(sessionPath: string): Promise<{
276
+ switchSession(sessionPath: string, options?: {
277
+ withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
278
+ }): Promise<{
239
279
  cancelled: boolean;
240
280
  }>;
241
281
  /** Reload extensions, skills, prompts, and themes. */
242
282
  reload(): Promise<void>;
243
283
  }
284
+ /**
285
+ * Fresh command-capable context bound to the replacement session after a session switch.
286
+ *
287
+ * This is passed to `withSession()` callbacks on `newSession()`, `fork()`, and `switchSession()`.
288
+ */
289
+ export interface ReplacedSessionContext extends ExtensionCommandContext {
290
+ sendMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details">, options?: {
291
+ triggerTurn?: boolean;
292
+ deliverAs?: "steer" | "followUp" | "nextTurn";
293
+ }): Promise<void>;
294
+ sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
295
+ deliverAs?: "steer" | "followUp";
296
+ }): Promise<void>;
297
+ }
244
298
  /** Rendering options for tool results */
245
299
  export interface ToolRenderResultOptions {
246
300
  /** Whether the result view is expanded */
@@ -291,8 +345,18 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
291
345
  promptGuidelines?: string[];
292
346
  /** Parameter schema (TypeBox) */
293
347
  parameters: TParams;
348
+ /** Controls whether ToolExecutionComponent renders the standard colored shell or the tool renders its own framing. */
349
+ renderShell?: "default" | "self";
294
350
  /** Optional compatibility shim to prepare raw tool call arguments before schema validation. Must return an object conforming to TParams. */
295
351
  prepareArguments?: (args: unknown) => Static<TParams>;
352
+ /**
353
+ * Per-tool execution mode override.
354
+ * - "sequential": this tool must execute one at a time with other tool calls.
355
+ * - "parallel": this tool can execute concurrently with other tool calls.
356
+ *
357
+ * If omitted, the default execution mode applies.
358
+ */
359
+ executionMode?: ToolExecutionMode;
296
360
  /** Execute the tool. */
297
361
  execute(toolCallId: string, params: Static<TParams>, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<TDetails> | undefined, ctx: ExtensionContext): Promise<AgentToolResult<TDetails>>;
298
362
  /** Custom rendering for tool call display */
@@ -309,6 +373,22 @@ type AnyToolDefinition = ToolDefinition<any, any, any>;
309
373
  * `unknown`.
310
374
  */
311
375
  export declare function defineTool<TParams extends TSchema, TDetails = unknown, TState = any>(tool: ToolDefinition<TParams, TDetails, TState>): ToolDefinition<TParams, TDetails, TState> & AnyToolDefinition;
376
+ export interface ProjectTrustEvent {
377
+ type: "project_trust";
378
+ cwd: string;
379
+ }
380
+ export type ProjectTrustEventDecision = "yes" | "no" | "undecided";
381
+ export interface ProjectTrustEventResult {
382
+ trusted: ProjectTrustEventDecision;
383
+ remember?: boolean;
384
+ }
385
+ export interface ProjectTrustContext {
386
+ cwd: string;
387
+ mode: ExtensionMode;
388
+ hasUI: boolean;
389
+ ui: Pick<ExtensionUIContext, "select" | "confirm" | "input" | "notify">;
390
+ }
391
+ export type ProjectTrustHandler = (event: ProjectTrustEvent, ctx: ProjectTrustContext) => Promise<ProjectTrustEventResult> | ProjectTrustEventResult;
312
392
  /** Fired after session_start to allow extensions to provide additional resource paths. */
313
393
  export interface ResourcesDiscoverEvent {
314
394
  type: "resources_discover";
@@ -339,6 +419,7 @@ export interface SessionBeforeSwitchEvent {
339
419
  export interface SessionBeforeForkEvent {
340
420
  type: "session_before_fork";
341
421
  entryId: string;
422
+ position: "before" | "at";
342
423
  }
343
424
  /** Fired before context compaction (can be cancelled or customized) */
344
425
  export interface SessionBeforeCompactEvent {
@@ -354,9 +435,12 @@ export interface SessionCompactEvent {
354
435
  compactionEntry: CompactionEntry;
355
436
  fromExtension: boolean;
356
437
  }
357
- /** Fired on process exit */
438
+ /** Fired before an extension runtime is torn down due to quit, reload, or session replacement. */
358
439
  export interface SessionShutdownEvent {
359
440
  type: "session_shutdown";
441
+ reason: "quit" | "reload" | "new" | "resume" | "fork";
442
+ /** Destination session file when shutting down due to session replacement. */
443
+ targetSessionFile?: string;
360
444
  }
361
445
  /** Preparation data for tree navigation */
362
446
  export interface TreePreparation {
@@ -397,12 +481,23 @@ export interface BeforeProviderRequestEvent {
397
481
  type: "before_provider_request";
398
482
  payload: unknown;
399
483
  }
484
+ /** Fired after a provider response is received and before the response stream is consumed. */
485
+ export interface AfterProviderResponseEvent {
486
+ type: "after_provider_response";
487
+ status: number;
488
+ headers: Record<string, string>;
489
+ }
400
490
  /** Fired after user submits prompt but before agent loop. */
401
491
  export interface BeforeAgentStartEvent {
402
492
  type: "before_agent_start";
493
+ /** The raw user prompt text (after expansion). */
403
494
  prompt: string;
495
+ /** Images attached to the user prompt, if any. */
404
496
  images?: ImageContent[];
497
+ /** The fully assembled system prompt string. */
405
498
  systemPrompt: string;
499
+ /** Structured options used to build the system prompt. Extensions can inspect this to understand what Pi loaded without re-discovering resources. */
500
+ systemPromptOptions: BuildSystemPromptOptions;
406
501
  }
407
502
  /** Fired when an agent loop starts */
408
503
  export interface AgentStartEvent {
@@ -473,6 +568,12 @@ export interface ModelSelectEvent {
473
568
  previousModel: Model<any> | undefined;
474
569
  source: ModelSelectSource;
475
570
  }
571
+ /** Fired when a new thinking level is selected */
572
+ export interface ThinkingLevelSelectEvent {
573
+ type: "thinking_level_select";
574
+ level: ThinkingLevel;
575
+ previousLevel: ThinkingLevel;
576
+ }
476
577
  /** Fired when user executes a bash command via ! or !! prefix */
477
578
  export interface UserBashEvent {
478
579
  type: "user_bash";
@@ -494,6 +595,8 @@ export interface InputEvent {
494
595
  images?: ImageContent[];
495
596
  /** Where the input came from */
496
597
  source: InputSource;
598
+ /** How the input will be delivered during streaming, or undefined when idle */
599
+ streamingBehavior?: "steer" | "followUp";
497
600
  }
498
601
  /** Result from input event handler */
499
602
  export type InputEventResult = {
@@ -628,7 +731,7 @@ export declare function isToolCallEventType<TName extends string, TInput extends
628
731
  input: TInput;
629
732
  };
630
733
  /** Union of all event types */
631
- export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | ModelSelectEvent | UserBashEvent | InputEvent | ToolCallEvent | ToolResultEvent;
734
+ export type ExtensionEvent = ProjectTrustEvent | ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | ModelSelectEvent | ThinkingLevelSelectEvent | UserBashEvent | InputEvent | ToolCallEvent | ToolResultEvent;
632
735
  export interface ContextEventResult {
633
736
  messages?: AgentMessage[];
634
737
  }
@@ -650,6 +753,10 @@ export interface ToolResultEventResult {
650
753
  details?: unknown;
651
754
  isError?: boolean;
652
755
  }
756
+ export interface MessageEndEventResult {
757
+ /** Replace the finalized message. The replacement must keep the original message role. */
758
+ message?: AgentMessage;
759
+ }
653
760
  export interface BeforeAgentStartEventResult {
654
761
  message?: Pick<CustomMessage, "customType" | "content" | "display" | "details">;
655
762
  /** Replace the system prompt for this turn. If multiple extensions return this, they are chained. */
@@ -699,6 +806,7 @@ export type ExtensionHandler<E, R = undefined> = (event: E, ctx: ExtensionContex
699
806
  * ExtensionAPI passed to extension factory functions.
700
807
  */
701
808
  export interface ExtensionAPI {
809
+ on(event: "project_trust", handler: ProjectTrustHandler): void;
702
810
  on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
703
811
  on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): void;
704
812
  on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): void;
@@ -710,6 +818,7 @@ export interface ExtensionAPI {
710
818
  on(event: "session_tree", handler: ExtensionHandler<SessionTreeEvent>): void;
711
819
  on(event: "context", handler: ExtensionHandler<ContextEvent, ContextEventResult>): void;
712
820
  on(event: "before_provider_request", handler: ExtensionHandler<BeforeProviderRequestEvent, BeforeProviderRequestEventResult>): void;
821
+ on(event: "after_provider_response", handler: ExtensionHandler<AfterProviderResponseEvent>): void;
713
822
  on(event: "before_agent_start", handler: ExtensionHandler<BeforeAgentStartEvent, BeforeAgentStartEventResult>): void;
714
823
  on(event: "agent_start", handler: ExtensionHandler<AgentStartEvent>): void;
715
824
  on(event: "agent_end", handler: ExtensionHandler<AgentEndEvent>): void;
@@ -717,11 +826,12 @@ export interface ExtensionAPI {
717
826
  on(event: "turn_end", handler: ExtensionHandler<TurnEndEvent>): void;
718
827
  on(event: "message_start", handler: ExtensionHandler<MessageStartEvent>): void;
719
828
  on(event: "message_update", handler: ExtensionHandler<MessageUpdateEvent>): void;
720
- on(event: "message_end", handler: ExtensionHandler<MessageEndEvent>): void;
829
+ on(event: "message_end", handler: ExtensionHandler<MessageEndEvent, MessageEndEventResult>): void;
721
830
  on(event: "tool_execution_start", handler: ExtensionHandler<ToolExecutionStartEvent>): void;
722
831
  on(event: "tool_execution_update", handler: ExtensionHandler<ToolExecutionUpdateEvent>): void;
723
832
  on(event: "tool_execution_end", handler: ExtensionHandler<ToolExecutionEndEvent>): void;
724
833
  on(event: "model_select", handler: ExtensionHandler<ModelSelectEvent>): void;
834
+ on(event: "thinking_level_select", handler: ExtensionHandler<ThinkingLevelSelectEvent>): void;
725
835
  on(event: "tool_call", handler: ExtensionHandler<ToolCallEvent, ToolCallEventResult>): void;
726
836
  on(event: "tool_result", handler: ExtensionHandler<ToolResultEvent, ToolResultEventResult>): void;
727
837
  on(event: "user_bash", handler: ExtensionHandler<UserBashEvent, UserBashEventResult>): void;
@@ -769,7 +879,7 @@ export interface ExtensionAPI {
769
879
  exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
770
880
  /** Get the list of currently active tool names. */
771
881
  getActiveTools(): string[];
772
- /** Get all configured tools with parameter schema and source metadata. */
882
+ /** Get all configured tools with parameter schema, prompt guidelines, and source metadata. */
773
883
  getAllTools(): ToolInfo[];
774
884
  /** Set the active tools by name. */
775
885
  setActiveTools(toolNames: string[]): void;
@@ -798,7 +908,7 @@ export interface ExtensionAPI {
798
908
  * // Register a new provider with custom models
799
909
  * pi.registerProvider("my-proxy", {
800
910
  * baseUrl: "https://proxy.example.com",
801
- * apiKey: "PROXY_API_KEY",
911
+ * apiKey: "$PROXY_API_KEY",
802
912
  * api: "anthropic-messages",
803
913
  * models: [
804
914
  * {
@@ -853,9 +963,11 @@ export interface ExtensionAPI {
853
963
  }
854
964
  /** Configuration for registering a provider via pi.registerProvider(). */
855
965
  export interface ProviderConfig {
966
+ /** Display name for the provider in UI. */
967
+ name?: string;
856
968
  /** Base URL for the API endpoint. Required when defining models. */
857
969
  baseUrl?: string;
858
- /** API key or environment variable name. Required when defining models (unless oauth provided). */
970
+ /** API key literal, env interpolation ($ENV_VAR or ${ENV_VAR}), or leading !command. Required when defining models (unless oauth provided). */
859
971
  apiKey?: string;
860
972
  /** API type. Required at provider or model level when defining models. */
861
973
  api?: Api;
@@ -889,8 +1001,12 @@ export interface ProviderModelConfig {
889
1001
  name: string;
890
1002
  /** API type override for this model. */
891
1003
  api?: Api;
1004
+ /** API endpoint URL override for this model. */
1005
+ baseUrl?: string;
892
1006
  /** Whether the model supports extended thinking. */
893
1007
  reasoning: boolean;
1008
+ /** Maps pi thinking levels to provider/model-specific values; null marks a level unsupported. */
1009
+ thinkingLevelMap?: Model<Api>["thinkingLevelMap"];
894
1010
  /** Supported input types. */
895
1011
  input: ("text" | "image")[];
896
1012
  /** Cost per token (for tracking, can be 0). */
@@ -940,8 +1056,8 @@ export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) =>
940
1056
  export type SetSessionNameHandler = (name: string) => void;
941
1057
  export type GetSessionNameHandler = () => string | undefined;
942
1058
  export type GetActiveToolsHandler = () => string[];
943
- /** Tool info with name, description, parameter schema, and source metadata */
944
- export type ToolInfo = Pick<ToolDefinition, "name" | "description" | "parameters"> & {
1059
+ /** Tool info with name, description, parameter schema, prompt guidelines, and source metadata. */
1060
+ export type ToolInfo = Pick<ToolDefinition, "name" | "description" | "parameters" | "promptGuidelines"> & {
945
1061
  sourceInfo: SourceInfo;
946
1062
  };
947
1063
  export type GetAllToolsHandler = () => ToolInfo[];
@@ -964,6 +1080,10 @@ export interface ExtensionRuntimeState {
964
1080
  config: ProviderConfig;
965
1081
  extensionPath: string;
966
1082
  }>;
1083
+ /** Throws when this extension instance is stale after runtime replacement. */
1084
+ assertActive: () => void;
1085
+ /** Marks this extension instance as stale after runtime replacement or reload. */
1086
+ invalidate: (message?: string) => void;
967
1087
  /**
968
1088
  * Register or unregister a provider.
969
1089
  *
@@ -1000,6 +1120,7 @@ export interface ExtensionActions {
1000
1120
  export interface ExtensionContextActions {
1001
1121
  getModel: () => Model<any> | undefined;
1002
1122
  isIdle: () => boolean;
1123
+ isProjectTrusted: () => boolean;
1003
1124
  getSignal: () => AbortSignal | undefined;
1004
1125
  abort: () => void;
1005
1126
  hasPendingMessages: () => boolean;
@@ -1007,6 +1128,7 @@ export interface ExtensionContextActions {
1007
1128
  getContextUsage: () => ContextUsage | undefined;
1008
1129
  compact: (options?: CompactOptions) => void;
1009
1130
  getSystemPrompt: () => string;
1131
+ getSystemPromptOptions?: () => BuildSystemPromptOptions;
1010
1132
  }
1011
1133
  /**
1012
1134
  * Actions for ExtensionCommandContext (ctx.* in command handlers).
@@ -1017,10 +1139,14 @@ export interface ExtensionCommandContextActions {
1017
1139
  newSession: (options?: {
1018
1140
  parentSession?: string;
1019
1141
  setup?: (sessionManager: SessionManager) => Promise<void>;
1142
+ withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
1020
1143
  }) => Promise<{
1021
1144
  cancelled: boolean;
1022
1145
  }>;
1023
- fork: (entryId: string) => Promise<{
1146
+ fork: (entryId: string, options?: {
1147
+ position?: "before" | "at";
1148
+ withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
1149
+ }) => Promise<{
1024
1150
  cancelled: boolean;
1025
1151
  }>;
1026
1152
  navigateTree: (targetId: string, options?: {
@@ -1031,7 +1157,9 @@ export interface ExtensionCommandContextActions {
1031
1157
  }) => Promise<{
1032
1158
  cancelled: boolean;
1033
1159
  }>;
1034
- switchSession: (sessionPath: string) => Promise<{
1160
+ switchSession: (sessionPath: string, options?: {
1161
+ withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
1162
+ }) => Promise<{
1035
1163
  cancelled: boolean;
1036
1164
  }>;
1037
1165
  reload: () => Promise<void>;