@draht/coding-agent 2026.5.12 → 2026.7.7-1

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 (680) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.md +1 -4
  3. package/bin/draht-tools.cjs +3756 -1
  4. package/dist/bun/cli.d.ts.map +1 -1
  5. package/dist/bun/cli.js +4 -2
  6. package/dist/bun/cli.js.map +1 -1
  7. package/dist/bun/register-bedrock.d.ts.map +1 -1
  8. package/dist/bun/register-bedrock.js +1 -1
  9. package/dist/bun/register-bedrock.js.map +1 -1
  10. package/dist/bun/restore-sandbox-env.d.ts +17 -0
  11. package/dist/bun/restore-sandbox-env.d.ts.map +1 -0
  12. package/dist/bun/restore-sandbox-env.js +36 -0
  13. package/dist/bun/restore-sandbox-env.js.map +1 -0
  14. package/dist/cli/args.d.ts +9 -4
  15. package/dist/cli/args.d.ts.map +1 -1
  16. package/dist/cli/args.js +91 -38
  17. package/dist/cli/args.js.map +1 -1
  18. package/dist/cli/config-selector.d.ts +5 -3
  19. package/dist/cli/config-selector.d.ts.map +1 -1
  20. package/dist/cli/config-selector.js +1 -1
  21. package/dist/cli/config-selector.js.map +1 -1
  22. package/dist/cli/file-processor.d.ts.map +1 -1
  23. package/dist/cli/file-processor.js +13 -26
  24. package/dist/cli/file-processor.js.map +1 -1
  25. package/dist/cli/initial-message.d.ts +1 -1
  26. package/dist/cli/initial-message.d.ts.map +1 -1
  27. package/dist/cli/initial-message.js.map +1 -1
  28. package/dist/cli/list-models.d.ts +1 -1
  29. package/dist/cli/list-models.d.ts.map +1 -1
  30. package/dist/cli/list-models.js +7 -1
  31. package/dist/cli/list-models.js.map +1 -1
  32. package/dist/cli/project-trust.d.ts +10 -0
  33. package/dist/cli/project-trust.d.ts.map +1 -0
  34. package/dist/cli/project-trust.js +48 -0
  35. package/dist/cli/project-trust.js.map +1 -0
  36. package/dist/cli/session-picker.d.ts +3 -2
  37. package/dist/cli/session-picker.d.ts.map +1 -1
  38. package/dist/cli/session-picker.js +5 -4
  39. package/dist/cli/session-picker.js.map +1 -1
  40. package/dist/cli/startup-ui.d.ts +20 -0
  41. package/dist/cli/startup-ui.d.ts.map +1 -0
  42. package/dist/cli/startup-ui.js +184 -0
  43. package/dist/cli/startup-ui.js.map +1 -0
  44. package/dist/cli.d.ts.map +1 -1
  45. package/dist/cli.js +7 -4
  46. package/dist/cli.js.map +1 -1
  47. package/dist/config.d.ts +27 -13
  48. package/dist/config.d.ts.map +1 -1
  49. package/dist/config.js +284 -63
  50. package/dist/config.js.map +1 -1
  51. package/dist/core/agent-session-runtime.d.ts +45 -9
  52. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  53. package/dist/core/agent-session-runtime.js +100 -33
  54. package/dist/core/agent-session-runtime.js.map +1 -1
  55. package/dist/core/agent-session-services.d.ts +6 -4
  56. package/dist/core/agent-session-services.d.ts.map +1 -1
  57. package/dist/core/agent-session-services.js +7 -4
  58. package/dist/core/agent-session-services.js.map +1 -1
  59. package/dist/core/agent-session.d.ts +55 -33
  60. package/dist/core/agent-session.d.ts.map +1 -1
  61. package/dist/core/agent-session.js +560 -492
  62. package/dist/core/agent-session.js.map +1 -1
  63. package/dist/core/auth-guidance.d.ts +5 -0
  64. package/dist/core/auth-guidance.d.ts.map +1 -0
  65. package/dist/core/auth-guidance.js +21 -0
  66. package/dist/core/auth-guidance.js.map +1 -0
  67. package/dist/core/auth-storage.d.ts +21 -13
  68. package/dist/core/auth-storage.d.ts.map +1 -1
  69. package/dist/core/auth-storage.js +48 -28
  70. package/dist/core/auth-storage.js.map +1 -1
  71. package/dist/core/bash-executor.d.ts +1 -15
  72. package/dist/core/bash-executor.d.ts.map +1 -1
  73. package/dist/core/bash-executor.js +10 -24
  74. package/dist/core/bash-executor.js.map +1 -1
  75. package/dist/core/builtins/subagent.d.ts.map +1 -1
  76. package/dist/core/builtins/subagent.js +1 -2
  77. package/dist/core/builtins/subagent.js.map +1 -1
  78. package/dist/core/compaction/branch-summarization.d.ts +9 -5
  79. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  80. package/dist/core/compaction/branch-summarization.js +10 -4
  81. package/dist/core/compaction/branch-summarization.js.map +1 -1
  82. package/dist/core/compaction/compaction.d.ts +8 -7
  83. package/dist/core/compaction/compaction.d.ts.map +1 -1
  84. package/dist/core/compaction/compaction.js +56 -47
  85. package/dist/core/compaction/compaction.js.map +1 -1
  86. package/dist/core/compaction/index.d.ts +3 -3
  87. package/dist/core/compaction/index.d.ts.map +1 -1
  88. package/dist/core/compaction/index.js.map +1 -1
  89. package/dist/core/compaction/utils.d.ts +1 -1
  90. package/dist/core/compaction/utils.d.ts.map +1 -1
  91. package/dist/core/compaction/utils.js +1 -1
  92. package/dist/core/compaction/utils.js.map +1 -1
  93. package/dist/core/exec.d.ts.map +1 -1
  94. package/dist/core/exec.js.map +1 -1
  95. package/dist/core/experimental.d.ts +2 -0
  96. package/dist/core/experimental.d.ts.map +1 -0
  97. package/dist/core/experimental.js +4 -0
  98. package/dist/core/experimental.js.map +1 -0
  99. package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
  100. package/dist/core/export-html/ansi-to-html.js +1 -1
  101. package/dist/core/export-html/ansi-to-html.js.map +1 -1
  102. package/dist/core/export-html/index.d.ts +1 -1
  103. package/dist/core/export-html/index.d.ts.map +1 -1
  104. package/dist/core/export-html/index.js +13 -11
  105. package/dist/core/export-html/index.js.map +1 -1
  106. package/dist/core/export-html/template.css +69 -4
  107. package/dist/core/export-html/template.js +231 -57
  108. package/dist/core/export-html/tool-renderer.d.ts +0 -6
  109. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  110. package/dist/core/export-html/tool-renderer.js +15 -2
  111. package/dist/core/export-html/tool-renderer.js.map +1 -1
  112. package/dist/core/export-html/vendor/marked.min.js +75 -3
  113. package/dist/core/extensions/index.d.ts +8 -8
  114. package/dist/core/extensions/index.d.ts.map +1 -1
  115. package/dist/core/extensions/index.js.map +1 -1
  116. package/dist/core/extensions/loader.d.ts +5 -6
  117. package/dist/core/extensions/loader.d.ts.map +1 -1
  118. package/dist/core/extensions/loader.js +98 -43
  119. package/dist/core/extensions/loader.js.map +1 -1
  120. package/dist/core/extensions/runner.d.ts +31 -12
  121. package/dist/core/extensions/runner.d.ts.map +1 -1
  122. package/dist/core/extensions/runner.js +248 -33
  123. package/dist/core/extensions/runner.js.map +1 -1
  124. package/dist/core/extensions/types.d.ts +191 -36
  125. package/dist/core/extensions/types.d.ts.map +1 -1
  126. package/dist/core/extensions/types.js.map +1 -1
  127. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  128. package/dist/core/extensions/wrapper.js +2 -2
  129. package/dist/core/extensions/wrapper.js.map +1 -1
  130. package/dist/core/footer-data-provider.d.ts +7 -1
  131. package/dist/core/footer-data-provider.d.ts.map +1 -1
  132. package/dist/core/footer-data-provider.js +78 -54
  133. package/dist/core/footer-data-provider.js.map +1 -1
  134. package/dist/core/http-dispatcher.d.ts +22 -0
  135. package/dist/core/http-dispatcher.d.ts.map +1 -0
  136. package/dist/core/http-dispatcher.js +91 -0
  137. package/dist/core/http-dispatcher.js.map +1 -0
  138. package/dist/core/index.d.ts +9 -8
  139. package/dist/core/index.d.ts.map +1 -1
  140. package/dist/core/index.js +2 -1
  141. package/dist/core/index.js.map +1 -1
  142. package/dist/core/keybindings.d.ts +67 -2
  143. package/dist/core/keybindings.d.ts.map +1 -1
  144. package/dist/core/keybindings.js +59 -7
  145. package/dist/core/keybindings.js.map +1 -1
  146. package/dist/core/model-registry.d.ts +24 -5
  147. package/dist/core/model-registry.d.ts.map +1 -1
  148. package/dist/core/model-registry.js +188 -51
  149. package/dist/core/model-registry.js.map +1 -1
  150. package/dist/core/model-resolver.d.ts +12 -1
  151. package/dist/core/model-resolver.d.ts.map +1 -1
  152. package/dist/core/model-resolver.js +84 -39
  153. package/dist/core/model-resolver.js.map +1 -1
  154. package/dist/core/output-guard.d.ts +1 -0
  155. package/dist/core/output-guard.d.ts.map +1 -1
  156. package/dist/core/output-guard.js +52 -22
  157. package/dist/core/output-guard.js.map +1 -1
  158. package/dist/core/package-manager.d.ts +22 -4
  159. package/dist/core/package-manager.d.ts.map +1 -1
  160. package/dist/core/package-manager.js +455 -157
  161. package/dist/core/package-manager.js.map +1 -1
  162. package/dist/core/project-trust.d.ts +15 -0
  163. package/dist/core/project-trust.d.ts.map +1 -0
  164. package/dist/core/project-trust.js +59 -0
  165. package/dist/core/project-trust.js.map +1 -0
  166. package/dist/core/prompt-templates.d.ts +13 -11
  167. package/dist/core/prompt-templates.d.ts.map +1 -1
  168. package/dist/core/prompt-templates.js +67 -76
  169. package/dist/core/prompt-templates.js.map +1 -1
  170. package/dist/core/provider-attribution.d.ts +4 -0
  171. package/dist/core/provider-attribution.d.ts.map +1 -0
  172. package/dist/core/provider-attribution.js +72 -0
  173. package/dist/core/provider-attribution.js.map +1 -0
  174. package/dist/core/provider-display-names.d.ts +2 -0
  175. package/dist/core/provider-display-names.d.ts.map +1 -0
  176. package/dist/core/provider-display-names.js +36 -0
  177. package/dist/core/provider-display-names.js.map +1 -0
  178. package/dist/core/resolve-config-value.d.ts +13 -6
  179. package/dist/core/resolve-config-value.d.ts.map +1 -1
  180. package/dist/core/resolve-config-value.js +143 -22
  181. package/dist/core/resolve-config-value.js.map +1 -1
  182. package/dist/core/resource-loader.d.ts +36 -15
  183. package/dist/core/resource-loader.d.ts.map +1 -1
  184. package/dist/core/resource-loader.js +178 -79
  185. package/dist/core/resource-loader.js.map +1 -1
  186. package/dist/core/sdk.d.ts +34 -18
  187. package/dist/core/sdk.d.ts.map +1 -1
  188. package/dist/core/sdk.js +47 -16
  189. package/dist/core/sdk.js.map +1 -1
  190. package/dist/core/session-manager.d.ts +32 -14
  191. package/dist/core/session-manager.d.ts.map +1 -1
  192. package/dist/core/session-manager.js +366 -209
  193. package/dist/core/session-manager.js.map +1 -1
  194. package/dist/core/settings-manager.d.ts +62 -6
  195. package/dist/core/settings-manager.d.ts.map +1 -1
  196. package/dist/core/settings-manager.js +230 -40
  197. package/dist/core/settings-manager.js.map +1 -1
  198. package/dist/core/skills.d.ts +10 -10
  199. package/dist/core/skills.d.ts.map +1 -1
  200. package/dist/core/skills.js +13 -35
  201. package/dist/core/skills.js.map +1 -1
  202. package/dist/core/slash-commands.d.ts +1 -1
  203. package/dist/core/slash-commands.d.ts.map +1 -1
  204. package/dist/core/slash-commands.js +7 -4
  205. package/dist/core/slash-commands.js.map +1 -1
  206. package/dist/core/source-info.d.ts +1 -1
  207. package/dist/core/source-info.d.ts.map +1 -1
  208. package/dist/core/source-info.js.map +1 -1
  209. package/dist/core/system-prompt.d.ts +4 -4
  210. package/dist/core/system-prompt.d.ts.map +1 -1
  211. package/dist/core/system-prompt.js +20 -16
  212. package/dist/core/system-prompt.js.map +1 -1
  213. package/dist/core/telemetry.d.ts +3 -0
  214. package/dist/core/telemetry.d.ts.map +1 -0
  215. package/dist/core/telemetry.js +9 -0
  216. package/dist/core/telemetry.js.map +1 -0
  217. package/dist/core/timings.d.ts +4 -2
  218. package/dist/core/timings.d.ts.map +1 -1
  219. package/dist/core/timings.js +24 -14
  220. package/dist/core/timings.js.map +1 -1
  221. package/dist/core/tools/bash.d.ts +11 -16
  222. package/dist/core/tools/bash.d.ts.map +1 -1
  223. package/dist/core/tools/bash.js +187 -178
  224. package/dist/core/tools/bash.js.map +1 -1
  225. package/dist/core/tools/edit-diff.d.ts +26 -5
  226. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  227. package/dist/core/tools/edit-diff.js +110 -23
  228. package/dist/core/tools/edit-diff.js.map +1 -1
  229. package/dist/core/tools/edit.d.ts +22 -24
  230. package/dist/core/tools/edit.d.ts.map +1 -1
  231. package/dist/core/tools/edit.js +201 -113
  232. package/dist/core/tools/edit.js.map +1 -1
  233. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  234. package/dist/core/tools/file-mutation-queue.js +27 -12
  235. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  236. package/dist/core/tools/find.d.ts +7 -18
  237. package/dist/core/tools/find.d.ts.map +1 -1
  238. package/dist/core/tools/find.js +148 -101
  239. package/dist/core/tools/find.js.map +1 -1
  240. package/dist/core/tools/grep.d.ts +11 -30
  241. package/dist/core/tools/grep.d.ts.map +1 -1
  242. package/dist/core/tools/grep.js +23 -12
  243. package/dist/core/tools/grep.js.map +1 -1
  244. package/dist/core/tools/index.d.ts +26 -101
  245. package/dist/core/tools/index.d.ts.map +1 -1
  246. package/dist/core/tools/index.js +78 -52
  247. package/dist/core/tools/index.js.map +1 -1
  248. package/dist/core/tools/ls.d.ts +6 -15
  249. package/dist/core/tools/ls.d.ts.map +1 -1
  250. package/dist/core/tools/ls.js +12 -17
  251. package/dist/core/tools/ls.js.map +1 -1
  252. package/dist/core/tools/output-accumulator.d.ts +52 -0
  253. package/dist/core/tools/output-accumulator.d.ts.map +1 -0
  254. package/dist/core/tools/output-accumulator.js +184 -0
  255. package/dist/core/tools/output-accumulator.js.map +1 -0
  256. package/dist/core/tools/path-utils.d.ts +2 -0
  257. package/dist/core/tools/path-utils.d.ts.map +1 -1
  258. package/dist/core/tools/path-utils.js +40 -22
  259. package/dist/core/tools/path-utils.js.map +1 -1
  260. package/dist/core/tools/read.d.ts +7 -18
  261. package/dist/core/tools/read.d.ts.map +1 -1
  262. package/dist/core/tools/read.js +103 -52
  263. package/dist/core/tools/read.js.map +1 -1
  264. package/dist/core/tools/render-utils.d.ts +5 -2
  265. package/dist/core/tools/render-utils.d.ts.map +1 -1
  266. package/dist/core/tools/render-utils.js +18 -2
  267. package/dist/core/tools/render-utils.js.map +1 -1
  268. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  269. package/dist/core/tools/tool-definition-wrapper.js +2 -0
  270. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  271. package/dist/core/tools/truncate.d.ts.map +1 -1
  272. package/dist/core/tools/truncate.js +12 -2
  273. package/dist/core/tools/truncate.js.map +1 -1
  274. package/dist/core/tools/write.d.ts +5 -14
  275. package/dist/core/tools/write.d.ts.map +1 -1
  276. package/dist/core/tools/write.js +27 -46
  277. package/dist/core/tools/write.js.map +1 -1
  278. package/dist/core/trust-manager.d.ts +36 -0
  279. package/dist/core/trust-manager.d.ts.map +1 -0
  280. package/dist/core/trust-manager.js +202 -0
  281. package/dist/core/trust-manager.js.map +1 -0
  282. package/dist/index.d.ts +33 -29
  283. package/dist/index.d.ts.map +1 -1
  284. package/dist/index.js +12 -9
  285. package/dist/index.js.map +1 -1
  286. package/dist/main.d.ts +5 -1
  287. package/dist/main.d.ts.map +1 -1
  288. package/dist/main.js +208 -93
  289. package/dist/main.js.map +1 -1
  290. package/dist/migrations.d.ts +2 -2
  291. package/dist/migrations.d.ts.map +1 -1
  292. package/dist/migrations.js +4 -4
  293. package/dist/migrations.js.map +1 -1
  294. package/dist/modes/index.d.ts +5 -5
  295. package/dist/modes/index.d.ts.map +1 -1
  296. package/dist/modes/index.js.map +1 -1
  297. package/dist/modes/interactive/assets/clankolas.png +0 -0
  298. package/dist/modes/interactive/components/assistant-message.d.ts +5 -1
  299. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  300. package/dist/modes/interactive/components/assistant-message.js +37 -15
  301. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  302. package/dist/modes/interactive/components/bash-execution.d.ts +1 -1
  303. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
  304. package/dist/modes/interactive/components/bash-execution.js +3 -3
  305. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  306. package/dist/modes/interactive/components/bordered-loader.d.ts.map +1 -1
  307. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  308. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  309. package/dist/modes/interactive/components/config-selector.d.ts +36 -5
  310. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  311. package/dist/modes/interactive/components/config-selector.js +318 -36
  312. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  313. package/dist/modes/interactive/components/countdown-timer.d.ts +2 -2
  314. package/dist/modes/interactive/components/countdown-timer.d.ts.map +1 -1
  315. package/dist/modes/interactive/components/countdown-timer.js +2 -2
  316. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  317. package/dist/modes/interactive/components/custom-editor.d.ts +1 -1
  318. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  319. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  320. package/dist/modes/interactive/components/custom-entry.d.ts +19 -0
  321. package/dist/modes/interactive/components/custom-entry.d.ts.map +1 -0
  322. package/dist/modes/interactive/components/custom-entry.js +52 -0
  323. package/dist/modes/interactive/components/custom-entry.js.map +1 -0
  324. package/dist/modes/interactive/components/custom-message.d.ts +2 -2
  325. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  326. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  327. package/dist/modes/interactive/components/diff.d.ts.map +1 -1
  328. package/dist/modes/interactive/components/diff.js.map +1 -1
  329. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -1
  330. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -1
  331. package/dist/modes/interactive/components/extension-editor.d.ts +3 -1
  332. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  333. package/dist/modes/interactive/components/extension-editor.js +26 -9
  334. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  335. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  336. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  337. package/dist/modes/interactive/components/extension-selector.d.ts +2 -0
  338. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  339. package/dist/modes/interactive/components/extension-selector.js +8 -3
  340. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  341. package/dist/modes/interactive/components/first-time-setup.d.ts +25 -0
  342. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -0
  343. package/dist/modes/interactive/components/first-time-setup.js +103 -0
  344. package/dist/modes/interactive/components/first-time-setup.js.map +1 -0
  345. package/dist/modes/interactive/components/footer.d.ts +4 -3
  346. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  347. package/dist/modes/interactive/components/footer.js +27 -7
  348. package/dist/modes/interactive/components/footer.js.map +1 -1
  349. package/dist/modes/interactive/components/index.d.ts +33 -31
  350. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  351. package/dist/modes/interactive/components/index.js +2 -0
  352. package/dist/modes/interactive/components/index.js.map +1 -1
  353. package/dist/modes/interactive/components/keybinding-hints.d.ts +5 -0
  354. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -1
  355. package/dist/modes/interactive/components/keybinding-hints.js +19 -5
  356. package/dist/modes/interactive/components/keybinding-hints.js.map +1 -1
  357. package/dist/modes/interactive/components/login-dialog.d.ts +12 -2
  358. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  359. package/dist/modes/interactive/components/login-dialog.js +45 -11
  360. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  361. package/dist/modes/interactive/components/model-selector.d.ts +2 -2
  362. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  363. package/dist/modes/interactive/components/model-selector.js +10 -6
  364. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  365. package/dist/modes/interactive/components/oauth-selector.d.ts +18 -6
  366. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  367. package/dist/modes/interactive/components/oauth-selector.js +93 -25
  368. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  369. package/dist/modes/interactive/components/scoped-models-selector.d.ts +5 -12
  370. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  371. package/dist/modes/interactive/components/scoped-models-selector.js +49 -31
  372. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  373. package/dist/modes/interactive/components/session-selector.d.ts +2 -2
  374. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  375. package/dist/modes/interactive/components/session-selector.js +33 -14
  376. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  377. package/dist/modes/interactive/components/settings-selector.d.ts +17 -0
  378. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  379. package/dist/modes/interactive/components/settings-selector.js +301 -20
  380. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  381. package/dist/modes/interactive/components/skill-invocation-message.d.ts +1 -1
  382. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  383. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  384. package/dist/modes/interactive/components/status-indicator.d.ts +28 -0
  385. package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -0
  386. package/dist/modes/interactive/components/status-indicator.js +60 -0
  387. package/dist/modes/interactive/components/status-indicator.js.map +1 -0
  388. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  389. package/dist/modes/interactive/components/thinking-selector.js +1 -1
  390. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  391. package/dist/modes/interactive/components/tool-execution.d.ts +6 -1
  392. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  393. package/dist/modes/interactive/components/tool-execution.js +57 -14
  394. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  395. package/dist/modes/interactive/components/tree-selector.d.ts +1 -1
  396. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  397. package/dist/modes/interactive/components/tree-selector.js +137 -13
  398. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  399. package/dist/modes/interactive/components/trust-selector.d.ts +23 -0
  400. package/dist/modes/interactive/components/trust-selector.d.ts.map +1 -0
  401. package/dist/modes/interactive/components/trust-selector.js +91 -0
  402. package/dist/modes/interactive/components/trust-selector.js.map +1 -0
  403. package/dist/modes/interactive/components/user-message-selector.d.ts +2 -2
  404. package/dist/modes/interactive/components/user-message-selector.d.ts.map +1 -1
  405. package/dist/modes/interactive/components/user-message-selector.js +8 -7
  406. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  407. package/dist/modes/interactive/components/user-message.d.ts +6 -1
  408. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  409. package/dist/modes/interactive/components/user-message.js +22 -8
  410. package/dist/modes/interactive/components/user-message.js.map +1 -1
  411. package/dist/modes/interactive/interactive-mode.d.ts +76 -19
  412. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  413. package/dist/modes/interactive/interactive-mode.js +1294 -494
  414. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  415. package/dist/modes/interactive/model-search.d.ts +12 -0
  416. package/dist/modes/interactive/model-search.d.ts.map +1 -0
  417. package/dist/modes/interactive/model-search.js +15 -0
  418. package/dist/modes/interactive/model-search.js.map +1 -0
  419. package/dist/modes/interactive/theme/dark.json +5 -4
  420. package/dist/modes/interactive/theme/light.json +5 -4
  421. package/dist/modes/interactive/theme/theme-controller.d.ts +29 -0
  422. package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -0
  423. package/dist/modes/interactive/theme/theme-controller.js +102 -0
  424. package/dist/modes/interactive/theme/theme-controller.js.map +1 -0
  425. package/dist/modes/interactive/theme/theme-schema.json +2 -1
  426. package/dist/modes/interactive/theme/theme.d.ts +41 -3
  427. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  428. package/dist/modes/interactive/theme/theme.js +183 -106
  429. package/dist/modes/interactive/theme/theme.js.map +1 -1
  430. package/dist/modes/print-mode.d.ts.map +1 -1
  431. package/dist/modes/print-mode.js +40 -20
  432. package/dist/modes/print-mode.js.map +1 -1
  433. package/dist/modes/rpc/rpc-client.d.ts +30 -5
  434. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  435. package/dist/modes/rpc/rpc-client.js +87 -8
  436. package/dist/modes/rpc/rpc-client.js.map +1 -1
  437. package/dist/modes/rpc/rpc-mode.d.ts +2 -2
  438. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  439. package/dist/modes/rpc/rpc-mode.js +113 -31
  440. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  441. package/dist/modes/rpc/rpc-types.d.ts +42 -4
  442. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  443. package/dist/modes/rpc/rpc-types.js.map +1 -1
  444. package/dist/package-manager-cli.d.ts +6 -2
  445. package/dist/package-manager-cli.d.ts.map +1 -1
  446. package/dist/package-manager-cli.js +504 -25
  447. package/dist/package-manager-cli.js.map +1 -1
  448. package/dist/prompts/agents/build.md +38 -0
  449. package/dist/prompts/agents/plan.md +36 -0
  450. package/dist/prompts/agents/verify.md +36 -4
  451. package/dist/prompts/commands/brainstorm.md +162 -0
  452. package/dist/prompts/commands/discuss-phase.md +1 -1
  453. package/dist/prompts/commands/execute-phase.md +4 -1
  454. package/dist/prompts/commands/fix.md +12 -0
  455. package/dist/prompts/commands/init-project.md +1 -0
  456. package/dist/prompts/commands/map-codebase.md +15 -1
  457. package/dist/prompts/commands/new-project.md +1 -0
  458. package/dist/prompts/commands/next-milestone.md +2 -0
  459. package/dist/prompts/commands/orchestrate.md +4 -4
  460. package/dist/prompts/commands/plan-phase.md +5 -0
  461. package/dist/prompts/commands/quick.md +4 -0
  462. package/dist/prompts/commands/review.md +4 -1
  463. package/dist/prompts/commands/verify-work.md +10 -8
  464. package/dist/rpc-entry.d.ts +3 -0
  465. package/dist/rpc-entry.d.ts.map +1 -0
  466. package/dist/rpc-entry.js +10 -0
  467. package/dist/rpc-entry.js.map +1 -0
  468. package/dist/utils/ansi.d.ts +2 -0
  469. package/dist/utils/ansi.d.ts.map +1 -0
  470. package/dist/utils/ansi.js +52 -0
  471. package/dist/utils/ansi.js.map +1 -0
  472. package/dist/utils/changelog.d.ts +2 -1
  473. package/dist/utils/changelog.d.ts.map +1 -1
  474. package/dist/utils/changelog.js +78 -0
  475. package/dist/utils/changelog.js.map +1 -1
  476. package/dist/utils/child-process.d.ts +12 -5
  477. package/dist/utils/child-process.d.ts.map +1 -1
  478. package/dist/utils/child-process.js +33 -5
  479. package/dist/utils/child-process.js.map +1 -1
  480. package/dist/utils/clipboard-image.d.ts.map +1 -1
  481. package/dist/utils/clipboard-image.js +2 -2
  482. package/dist/utils/clipboard-image.js.map +1 -1
  483. package/dist/utils/clipboard-native.d.ts +3 -1
  484. package/dist/utils/clipboard-native.d.ts.map +1 -1
  485. package/dist/utils/clipboard-native.js +14 -8
  486. package/dist/utils/clipboard-native.js.map +1 -1
  487. package/dist/utils/clipboard.d.ts.map +1 -1
  488. package/dist/utils/clipboard.js +84 -45
  489. package/dist/utils/clipboard.js.map +1 -1
  490. package/dist/utils/deprecation.d.ts +4 -0
  491. package/dist/utils/deprecation.d.ts.map +1 -0
  492. package/dist/utils/deprecation.js +13 -0
  493. package/dist/utils/deprecation.js.map +1 -0
  494. package/dist/utils/exif-orientation.d.ts +1 -1
  495. package/dist/utils/exif-orientation.d.ts.map +1 -1
  496. package/dist/utils/exif-orientation.js.map +1 -1
  497. package/dist/utils/fs-watch.d.ts +5 -0
  498. package/dist/utils/fs-watch.d.ts.map +1 -0
  499. package/dist/utils/fs-watch.js +25 -0
  500. package/dist/utils/fs-watch.js.map +1 -0
  501. package/dist/utils/git.d.ts.map +1 -1
  502. package/dist/utils/git.js +54 -22
  503. package/dist/utils/git.js.map +1 -1
  504. package/dist/utils/html.d.ts +7 -0
  505. package/dist/utils/html.d.ts.map +1 -0
  506. package/dist/utils/html.js +40 -0
  507. package/dist/utils/html.js.map +1 -0
  508. package/dist/utils/image-convert.d.ts +1 -0
  509. package/dist/utils/image-convert.d.ts.map +1 -1
  510. package/dist/utils/image-convert.js +21 -15
  511. package/dist/utils/image-convert.js.map +1 -1
  512. package/dist/utils/image-process.d.ts +18 -0
  513. package/dist/utils/image-process.d.ts.map +1 -0
  514. package/dist/utils/image-process.js +83 -0
  515. package/dist/utils/image-process.js.map +1 -0
  516. package/dist/utils/image-resize-core.d.ts +30 -0
  517. package/dist/utils/image-resize-core.d.ts.map +1 -0
  518. package/dist/utils/image-resize-core.js +124 -0
  519. package/dist/utils/image-resize-core.js.map +1 -0
  520. package/dist/utils/image-resize-worker.d.ts +2 -0
  521. package/dist/utils/image-resize-worker.d.ts.map +1 -0
  522. package/dist/utils/image-resize-worker.js +31 -0
  523. package/dist/utils/image-resize-worker.js.map +1 -0
  524. package/dist/utils/image-resize.d.ts +7 -27
  525. package/dist/utils/image-resize.d.ts.map +1 -1
  526. package/dist/utils/image-resize.js +75 -115
  527. package/dist/utils/image-resize.js.map +1 -1
  528. package/dist/utils/json.d.ts +3 -0
  529. package/dist/utils/json.d.ts.map +1 -0
  530. package/dist/utils/json.js +7 -0
  531. package/dist/utils/json.js.map +1 -0
  532. package/dist/utils/mime.d.ts +1 -0
  533. package/dist/utils/mime.d.ts.map +1 -1
  534. package/dist/utils/mime.js +100 -16
  535. package/dist/utils/mime.js.map +1 -1
  536. package/dist/utils/open-browser.d.ts +9 -0
  537. package/dist/utils/open-browser.d.ts.map +1 -0
  538. package/dist/utils/open-browser.js +22 -0
  539. package/dist/utils/open-browser.js.map +1 -0
  540. package/dist/utils/paths.d.ts +25 -1
  541. package/dist/utils/paths.d.ts.map +1 -1
  542. package/dist/utils/paths.js +75 -2
  543. package/dist/utils/paths.js.map +1 -1
  544. package/dist/utils/pi-user-agent.d.ts +2 -0
  545. package/dist/utils/pi-user-agent.d.ts.map +1 -0
  546. package/dist/utils/pi-user-agent.js +5 -0
  547. package/dist/utils/pi-user-agent.js.map +1 -0
  548. package/dist/utils/shell.d.ts +11 -6
  549. package/dist/utils/shell.d.ts.map +1 -1
  550. package/dist/utils/shell.js +42 -26
  551. package/dist/utils/shell.js.map +1 -1
  552. package/dist/utils/syntax-highlight.d.ts +12 -0
  553. package/dist/utils/syntax-highlight.d.ts.map +1 -0
  554. package/dist/utils/syntax-highlight.js +118 -0
  555. package/dist/utils/syntax-highlight.js.map +1 -0
  556. package/dist/utils/tools-manager.d.ts.map +1 -1
  557. package/dist/utils/tools-manager.js +86 -10
  558. package/dist/utils/tools-manager.js.map +1 -1
  559. package/dist/utils/version-check.d.ts +15 -0
  560. package/dist/utils/version-check.d.ts.map +1 -0
  561. package/dist/utils/version-check.js +59 -0
  562. package/dist/utils/version-check.js.map +1 -0
  563. package/dist/utils/windows-self-update.d.ts +3 -0
  564. package/dist/utils/windows-self-update.d.ts.map +1 -0
  565. package/dist/utils/windows-self-update.js +77 -0
  566. package/dist/utils/windows-self-update.js.map +1 -0
  567. package/docs/compaction.md +12 -12
  568. package/docs/containerization.md +111 -0
  569. package/docs/custom-provider.md +187 -47
  570. package/docs/development.md +5 -5
  571. package/docs/docs.json +156 -0
  572. package/docs/extensions.md +520 -79
  573. package/docs/index.md +82 -0
  574. package/docs/json.md +4 -4
  575. package/docs/keybindings.md +24 -2
  576. package/docs/models.md +119 -17
  577. package/docs/packages.md +19 -11
  578. package/docs/prompt-templates.md +30 -2
  579. package/docs/providers.md +85 -23
  580. package/docs/quickstart.md +165 -0
  581. package/docs/rpc.md +99 -10
  582. package/docs/sdk.md +118 -50
  583. package/docs/security.md +55 -0
  584. package/docs/{session.md → session-format.md} +29 -19
  585. package/docs/sessions.md +145 -0
  586. package/docs/settings.md +71 -11
  587. package/docs/skills.md +16 -17
  588. package/docs/terminal-setup.md +44 -2
  589. package/docs/termux.md +4 -4
  590. package/docs/themes.md +3 -3
  591. package/docs/tmux.md +4 -2
  592. package/docs/tui.md +44 -4
  593. package/docs/usage.md +305 -0
  594. package/examples/extensions/README.md +1 -0
  595. package/examples/extensions/border-status-editor.ts +145 -0
  596. package/examples/extensions/built-in-tool-renderer.ts +3 -0
  597. package/examples/extensions/custom-compaction.ts +2 -1
  598. package/examples/extensions/custom-header.ts +1 -1
  599. package/examples/extensions/custom-provider-anthropic/index.ts +2 -2
  600. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  601. package/examples/extensions/custom-provider-anthropic/package.json +2 -2
  602. package/examples/extensions/custom-provider-gitlab-duo/index.ts +63 -8
  603. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  604. package/examples/extensions/custom-provider-gitlab-duo/test.ts +2 -2
  605. package/examples/extensions/doom-overlay/doom-component.ts +2 -2
  606. package/examples/extensions/doom-overlay/index.ts +1 -1
  607. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  608. package/examples/extensions/dynamic-tools.ts +2 -2
  609. package/examples/extensions/entry-renderer.ts +41 -0
  610. package/examples/extensions/git-merge-and-resolve.ts +115 -0
  611. package/examples/extensions/github-issue-autocomplete.ts +185 -0
  612. package/examples/extensions/gondolin/index.ts +531 -0
  613. package/examples/extensions/gondolin/package-lock.json +185 -0
  614. package/examples/extensions/gondolin/package.json +19 -0
  615. package/examples/extensions/handoff.ts +52 -14
  616. package/examples/extensions/input-transform-streaming.ts +39 -0
  617. package/examples/extensions/interactive-shell.ts +1 -1
  618. package/examples/extensions/notify.ts +2 -9
  619. package/examples/extensions/overlay-qa-tests.ts +240 -138
  620. package/examples/extensions/overlay-test.ts +7 -4
  621. package/examples/extensions/plan-mode/index.ts +87 -37
  622. package/examples/extensions/plan-mode/utils.ts +1 -1
  623. package/examples/extensions/preset.ts +46 -7
  624. package/examples/extensions/project-trust.ts +64 -0
  625. package/examples/extensions/prompt-customizer.ts +97 -0
  626. package/examples/extensions/provider-payload.ts +8 -4
  627. package/examples/extensions/qna.ts +3 -3
  628. package/examples/extensions/question.ts +34 -20
  629. package/examples/extensions/questionnaire.ts +43 -30
  630. package/examples/extensions/reload-runtime.ts +1 -1
  631. package/examples/extensions/sandbox/index.ts +6 -6
  632. package/examples/extensions/sandbox/package-lock.json +5 -5
  633. package/examples/extensions/sandbox/package.json +2 -2
  634. package/examples/extensions/shutdown-command.ts +1 -1
  635. package/examples/extensions/snake.ts +1 -1
  636. package/examples/extensions/space-invaders.ts +1 -1
  637. package/examples/extensions/structured-output.ts +65 -0
  638. package/examples/extensions/subagent/agents.ts +2 -2
  639. package/examples/extensions/subagent/index.ts +58 -29
  640. package/examples/extensions/summarize.ts +3 -2
  641. package/examples/extensions/tic-tac-toe.ts +1008 -0
  642. package/examples/extensions/titlebar-spinner.ts +2 -2
  643. package/examples/extensions/todo.ts +2 -2
  644. package/examples/extensions/tool-override.ts +1 -1
  645. package/examples/extensions/tools.ts +5 -0
  646. package/examples/extensions/truncated-tool.ts +1 -1
  647. package/examples/extensions/with-deps/index.ts +1 -1
  648. package/examples/extensions/with-deps/package-lock.json +2 -2
  649. package/examples/extensions/with-deps/package.json +3 -3
  650. package/examples/extensions/working-indicator.ts +123 -0
  651. package/examples/extensions/working-message-test.ts +25 -0
  652. package/examples/sdk/01-minimal.ts +14 -10
  653. package/examples/sdk/02-custom-model.ts +13 -9
  654. package/examples/sdk/03-custom-prompt.ts +32 -17
  655. package/examples/sdk/04-skills.ts +5 -2
  656. package/examples/sdk/05-tools.ts +23 -31
  657. package/examples/sdk/06-extensions.ts +14 -8
  658. package/examples/sdk/07-context-files.ts +5 -3
  659. package/examples/sdk/08-prompt-templates.ts +5 -2
  660. package/examples/sdk/09-api-keys-and-oauth.ts +8 -4
  661. package/examples/sdk/10-settings.ts +8 -6
  662. package/examples/sdk/11-sessions.ts +4 -0
  663. package/examples/sdk/12-full-control.ts +15 -19
  664. package/package.json +22 -16
  665. package/prompts/agents/build.md +38 -0
  666. package/prompts/agents/plan.md +36 -0
  667. package/prompts/agents/verify.md +36 -4
  668. package/prompts/commands/brainstorm.md +162 -0
  669. package/prompts/commands/discuss-phase.md +1 -1
  670. package/prompts/commands/execute-phase.md +4 -1
  671. package/prompts/commands/fix.md +12 -0
  672. package/prompts/commands/init-project.md +1 -0
  673. package/prompts/commands/map-codebase.md +15 -1
  674. package/prompts/commands/new-project.md +1 -0
  675. package/prompts/commands/next-milestone.md +2 -0
  676. package/prompts/commands/orchestrate.md +4 -4
  677. package/prompts/commands/plan-phase.md +5 -0
  678. package/prompts/commands/quick.md +4 -0
  679. package/prompts/commands/review.md +4 -1
  680. package/prompts/commands/verify-work.md +10 -8
@@ -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, CustomEntry, 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";
@@ -329,6 +409,12 @@ export interface SessionStartEvent {
329
409
  /** Previously active session file. Present for "new", "resume", and "fork". */
330
410
  previousSessionFile?: string;
331
411
  }
412
+ /** Fired when the current session metadata changes. */
413
+ export interface SessionInfoChangedEvent {
414
+ type: "session_info_changed";
415
+ /** Current normalized session name. Undefined when the name is cleared. */
416
+ name: string | undefined;
417
+ }
332
418
  /** Fired before switching to another session (can be cancelled) */
333
419
  export interface SessionBeforeSwitchEvent {
334
420
  type: "session_before_switch";
@@ -339,6 +425,7 @@ export interface SessionBeforeSwitchEvent {
339
425
  export interface SessionBeforeForkEvent {
340
426
  type: "session_before_fork";
341
427
  entryId: string;
428
+ position: "before" | "at";
342
429
  }
343
430
  /** Fired before context compaction (can be cancelled or customized) */
344
431
  export interface SessionBeforeCompactEvent {
@@ -346,6 +433,10 @@ export interface SessionBeforeCompactEvent {
346
433
  preparation: CompactionPreparation;
347
434
  branchEntries: SessionEntry[];
348
435
  customInstructions?: string;
436
+ /** What triggered the compaction: manual /compact, the context threshold, or context overflow recovery */
437
+ reason: "manual" | "threshold" | "overflow";
438
+ /** True when the aborted turn is retried after this compaction (overflow recovery) */
439
+ willRetry: boolean;
349
440
  signal: AbortSignal;
350
441
  }
351
442
  /** Fired after context compaction */
@@ -353,10 +444,17 @@ export interface SessionCompactEvent {
353
444
  type: "session_compact";
354
445
  compactionEntry: CompactionEntry;
355
446
  fromExtension: boolean;
447
+ /** What triggered the compaction: manual /compact, the context threshold, or context overflow recovery */
448
+ reason: "manual" | "threshold" | "overflow";
449
+ /** True when the aborted turn is retried after this compaction (overflow recovery) */
450
+ willRetry: boolean;
356
451
  }
357
- /** Fired on process exit */
452
+ /** Fired before an extension runtime is torn down due to quit, reload, or session replacement. */
358
453
  export interface SessionShutdownEvent {
359
454
  type: "session_shutdown";
455
+ reason: "quit" | "reload" | "new" | "resume" | "fork";
456
+ /** Destination session file when shutting down due to session replacement. */
457
+ targetSessionFile?: string;
360
458
  }
361
459
  /** Preparation data for tree navigation */
362
460
  export interface TreePreparation {
@@ -386,7 +484,7 @@ export interface SessionTreeEvent {
386
484
  summaryEntry?: BranchSummaryEntry;
387
485
  fromExtension?: boolean;
388
486
  }
389
- export type SessionEvent = SessionStartEvent | SessionBeforeSwitchEvent | SessionBeforeForkEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionShutdownEvent | SessionBeforeTreeEvent | SessionTreeEvent;
487
+ export type SessionEvent = SessionStartEvent | SessionInfoChangedEvent | SessionBeforeSwitchEvent | SessionBeforeForkEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionShutdownEvent | SessionBeforeTreeEvent | SessionTreeEvent;
390
488
  /** Fired before each LLM call. Can modify messages. */
391
489
  export interface ContextEvent {
392
490
  type: "context";
@@ -397,12 +495,23 @@ export interface BeforeProviderRequestEvent {
397
495
  type: "before_provider_request";
398
496
  payload: unknown;
399
497
  }
498
+ /** Fired after a provider response is received and before the response stream is consumed. */
499
+ export interface AfterProviderResponseEvent {
500
+ type: "after_provider_response";
501
+ status: number;
502
+ headers: Record<string, string>;
503
+ }
400
504
  /** Fired after user submits prompt but before agent loop. */
401
505
  export interface BeforeAgentStartEvent {
402
506
  type: "before_agent_start";
507
+ /** The raw user prompt text (after expansion). */
403
508
  prompt: string;
509
+ /** Images attached to the user prompt, if any. */
404
510
  images?: ImageContent[];
511
+ /** The fully assembled system prompt string. */
405
512
  systemPrompt: string;
513
+ /** Structured options used to build the system prompt. Extensions can inspect this to understand what Pi loaded without re-discovering resources. */
514
+ systemPromptOptions: BuildSystemPromptOptions;
406
515
  }
407
516
  /** Fired when an agent loop starts */
408
517
  export interface AgentStartEvent {
@@ -473,6 +582,12 @@ export interface ModelSelectEvent {
473
582
  previousModel: Model<any> | undefined;
474
583
  source: ModelSelectSource;
475
584
  }
585
+ /** Fired when a new thinking level is selected */
586
+ export interface ThinkingLevelSelectEvent {
587
+ type: "thinking_level_select";
588
+ level: ThinkingLevel;
589
+ previousLevel: ThinkingLevel;
590
+ }
476
591
  /** Fired when user executes a bash command via ! or !! prefix */
477
592
  export interface UserBashEvent {
478
593
  type: "user_bash";
@@ -494,6 +609,8 @@ export interface InputEvent {
494
609
  images?: ImageContent[];
495
610
  /** Where the input came from */
496
611
  source: InputSource;
612
+ /** How the input will be delivered during streaming, or undefined when idle */
613
+ streamingBehavior?: "steer" | "followUp";
497
614
  }
498
615
  /** Result from input event handler */
499
616
  export type InputEventResult = {
@@ -628,7 +745,7 @@ export declare function isToolCallEventType<TName extends string, TInput extends
628
745
  input: TInput;
629
746
  };
630
747
  /** 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;
748
+ 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
749
  export interface ContextEventResult {
633
750
  messages?: AgentMessage[];
634
751
  }
@@ -650,6 +767,10 @@ export interface ToolResultEventResult {
650
767
  details?: unknown;
651
768
  isError?: boolean;
652
769
  }
770
+ export interface MessageEndEventResult {
771
+ /** Replace the finalized message. The replacement must keep the original message role. */
772
+ message?: AgentMessage;
773
+ }
653
774
  export interface BeforeAgentStartEventResult {
654
775
  message?: Pick<CustomMessage, "customType" | "content" | "display" | "details">;
655
776
  /** Replace the system prompt for this turn. If multiple extensions return this, they are chained. */
@@ -682,7 +803,11 @@ export interface SessionBeforeTreeResult {
682
803
  export interface MessageRenderOptions {
683
804
  expanded: boolean;
684
805
  }
806
+ export interface EntryRenderOptions {
807
+ expanded: boolean;
808
+ }
685
809
  export type MessageRenderer<T = unknown> = (message: CustomMessage<T>, options: MessageRenderOptions, theme: Theme) => Component | undefined;
810
+ export type EntryRenderer<T = unknown> = (entry: CustomEntry<T>, options: EntryRenderOptions, theme: Theme) => Component | undefined;
686
811
  export interface RegisteredCommand {
687
812
  name: string;
688
813
  sourceInfo: SourceInfo;
@@ -699,8 +824,10 @@ export type ExtensionHandler<E, R = undefined> = (event: E, ctx: ExtensionContex
699
824
  * ExtensionAPI passed to extension factory functions.
700
825
  */
701
826
  export interface ExtensionAPI {
827
+ on(event: "project_trust", handler: ProjectTrustHandler): void;
702
828
  on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
703
829
  on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): void;
830
+ on(event: "session_info_changed", handler: ExtensionHandler<SessionInfoChangedEvent>): void;
704
831
  on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): void;
705
832
  on(event: "session_before_fork", handler: ExtensionHandler<SessionBeforeForkEvent, SessionBeforeForkResult>): void;
706
833
  on(event: "session_before_compact", handler: ExtensionHandler<SessionBeforeCompactEvent, SessionBeforeCompactResult>): void;
@@ -710,6 +837,7 @@ export interface ExtensionAPI {
710
837
  on(event: "session_tree", handler: ExtensionHandler<SessionTreeEvent>): void;
711
838
  on(event: "context", handler: ExtensionHandler<ContextEvent, ContextEventResult>): void;
712
839
  on(event: "before_provider_request", handler: ExtensionHandler<BeforeProviderRequestEvent, BeforeProviderRequestEventResult>): void;
840
+ on(event: "after_provider_response", handler: ExtensionHandler<AfterProviderResponseEvent>): void;
713
841
  on(event: "before_agent_start", handler: ExtensionHandler<BeforeAgentStartEvent, BeforeAgentStartEventResult>): void;
714
842
  on(event: "agent_start", handler: ExtensionHandler<AgentStartEvent>): void;
715
843
  on(event: "agent_end", handler: ExtensionHandler<AgentEndEvent>): void;
@@ -717,11 +845,12 @@ export interface ExtensionAPI {
717
845
  on(event: "turn_end", handler: ExtensionHandler<TurnEndEvent>): void;
718
846
  on(event: "message_start", handler: ExtensionHandler<MessageStartEvent>): void;
719
847
  on(event: "message_update", handler: ExtensionHandler<MessageUpdateEvent>): void;
720
- on(event: "message_end", handler: ExtensionHandler<MessageEndEvent>): void;
848
+ on(event: "message_end", handler: ExtensionHandler<MessageEndEvent, MessageEndEventResult>): void;
721
849
  on(event: "tool_execution_start", handler: ExtensionHandler<ToolExecutionStartEvent>): void;
722
850
  on(event: "tool_execution_update", handler: ExtensionHandler<ToolExecutionUpdateEvent>): void;
723
851
  on(event: "tool_execution_end", handler: ExtensionHandler<ToolExecutionEndEvent>): void;
724
852
  on(event: "model_select", handler: ExtensionHandler<ModelSelectEvent>): void;
853
+ on(event: "thinking_level_select", handler: ExtensionHandler<ThinkingLevelSelectEvent>): void;
725
854
  on(event: "tool_call", handler: ExtensionHandler<ToolCallEvent, ToolCallEventResult>): void;
726
855
  on(event: "tool_result", handler: ExtensionHandler<ToolResultEvent, ToolResultEventResult>): void;
727
856
  on(event: "user_bash", handler: ExtensionHandler<UserBashEvent, UserBashEventResult>): void;
@@ -745,6 +874,8 @@ export interface ExtensionAPI {
745
874
  getFlag(name: string): boolean | string | undefined;
746
875
  /** Register a custom renderer for CustomMessageEntry. */
747
876
  registerMessageRenderer<T = unknown>(customType: string, renderer: MessageRenderer<T>): void;
877
+ /** Register a custom renderer for CustomEntry. Custom entries do not participate in LLM context. */
878
+ registerEntryRenderer<T = unknown>(customType: string, renderer: EntryRenderer<T>): void;
748
879
  /** Send a custom message to the session. */
749
880
  sendMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details">, options?: {
750
881
  triggerTurn?: boolean;
@@ -769,7 +900,7 @@ export interface ExtensionAPI {
769
900
  exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
770
901
  /** Get the list of currently active tool names. */
771
902
  getActiveTools(): string[];
772
- /** Get all configured tools with parameter schema and source metadata. */
903
+ /** Get all configured tools with parameter schema, prompt guidelines, and source metadata. */
773
904
  getAllTools(): ToolInfo[];
774
905
  /** Set the active tools by name. */
775
906
  setActiveTools(toolNames: string[]): void;
@@ -798,7 +929,7 @@ export interface ExtensionAPI {
798
929
  * // Register a new provider with custom models
799
930
  * pi.registerProvider("my-proxy", {
800
931
  * baseUrl: "https://proxy.example.com",
801
- * apiKey: "PROXY_API_KEY",
932
+ * apiKey: "$PROXY_API_KEY",
802
933
  * api: "anthropic-messages",
803
934
  * models: [
804
935
  * {
@@ -853,9 +984,11 @@ export interface ExtensionAPI {
853
984
  }
854
985
  /** Configuration for registering a provider via pi.registerProvider(). */
855
986
  export interface ProviderConfig {
987
+ /** Display name for the provider in UI. */
988
+ name?: string;
856
989
  /** Base URL for the API endpoint. Required when defining models. */
857
990
  baseUrl?: string;
858
- /** API key or environment variable name. Required when defining models (unless oauth provided). */
991
+ /** API key literal, env interpolation ($ENV_VAR or ${ENV_VAR}), or leading !command. Required when defining models (unless oauth provided). */
859
992
  apiKey?: string;
860
993
  /** API type. Required at provider or model level when defining models. */
861
994
  api?: Api;
@@ -889,8 +1022,12 @@ export interface ProviderModelConfig {
889
1022
  name: string;
890
1023
  /** API type override for this model. */
891
1024
  api?: Api;
1025
+ /** API endpoint URL override for this model. */
1026
+ baseUrl?: string;
892
1027
  /** Whether the model supports extended thinking. */
893
1028
  reasoning: boolean;
1029
+ /** Maps pi thinking levels to provider/model-specific values; null marks a level unsupported. */
1030
+ thinkingLevelMap?: Model<Api>["thinkingLevelMap"];
894
1031
  /** Supported input types. */
895
1032
  input: ("text" | "image")[];
896
1033
  /** Cost per token (for tracking, can be 0). */
@@ -911,6 +1048,11 @@ export interface ProviderModelConfig {
911
1048
  }
912
1049
  /** Extension factory function type. Supports both sync and async initialization. */
913
1050
  export type ExtensionFactory = (pi: ExtensionAPI) => void | Promise<void>;
1051
+ export type InlineExtension = ExtensionFactory | {
1052
+ /** Display name shown as `<inline:name>` in the startup Extensions list. */
1053
+ name: string;
1054
+ factory: ExtensionFactory;
1055
+ };
914
1056
  export interface RegisteredTool {
915
1057
  definition: ToolDefinition;
916
1058
  sourceInfo: SourceInfo;
@@ -940,8 +1082,8 @@ export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) =>
940
1082
  export type SetSessionNameHandler = (name: string) => void;
941
1083
  export type GetSessionNameHandler = () => string | undefined;
942
1084
  export type GetActiveToolsHandler = () => string[];
943
- /** Tool info with name, description, parameter schema, and source metadata */
944
- export type ToolInfo = Pick<ToolDefinition, "name" | "description" | "parameters"> & {
1085
+ /** Tool info with name, description, parameter schema, prompt guidelines, and source metadata. */
1086
+ export type ToolInfo = Pick<ToolDefinition, "name" | "description" | "parameters" | "promptGuidelines"> & {
945
1087
  sourceInfo: SourceInfo;
946
1088
  };
947
1089
  export type GetAllToolsHandler = () => ToolInfo[];
@@ -964,6 +1106,10 @@ export interface ExtensionRuntimeState {
964
1106
  config: ProviderConfig;
965
1107
  extensionPath: string;
966
1108
  }>;
1109
+ /** Throws when this extension instance is stale after runtime replacement. */
1110
+ assertActive: () => void;
1111
+ /** Marks this extension instance as stale after runtime replacement or reload. */
1112
+ invalidate: (message?: string) => void;
967
1113
  /**
968
1114
  * Register or unregister a provider.
969
1115
  *
@@ -1000,6 +1146,7 @@ export interface ExtensionActions {
1000
1146
  export interface ExtensionContextActions {
1001
1147
  getModel: () => Model<any> | undefined;
1002
1148
  isIdle: () => boolean;
1149
+ isProjectTrusted: () => boolean;
1003
1150
  getSignal: () => AbortSignal | undefined;
1004
1151
  abort: () => void;
1005
1152
  hasPendingMessages: () => boolean;
@@ -1007,6 +1154,7 @@ export interface ExtensionContextActions {
1007
1154
  getContextUsage: () => ContextUsage | undefined;
1008
1155
  compact: (options?: CompactOptions) => void;
1009
1156
  getSystemPrompt: () => string;
1157
+ getSystemPromptOptions?: () => BuildSystemPromptOptions;
1010
1158
  }
1011
1159
  /**
1012
1160
  * Actions for ExtensionCommandContext (ctx.* in command handlers).
@@ -1017,10 +1165,14 @@ export interface ExtensionCommandContextActions {
1017
1165
  newSession: (options?: {
1018
1166
  parentSession?: string;
1019
1167
  setup?: (sessionManager: SessionManager) => Promise<void>;
1168
+ withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
1020
1169
  }) => Promise<{
1021
1170
  cancelled: boolean;
1022
1171
  }>;
1023
- fork: (entryId: string) => Promise<{
1172
+ fork: (entryId: string, options?: {
1173
+ position?: "before" | "at";
1174
+ withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
1175
+ }) => Promise<{
1024
1176
  cancelled: boolean;
1025
1177
  }>;
1026
1178
  navigateTree: (targetId: string, options?: {
@@ -1031,7 +1183,9 @@ export interface ExtensionCommandContextActions {
1031
1183
  }) => Promise<{
1032
1184
  cancelled: boolean;
1033
1185
  }>;
1034
- switchSession: (sessionPath: string) => Promise<{
1186
+ switchSession: (sessionPath: string, options?: {
1187
+ withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
1188
+ }) => Promise<{
1035
1189
  cancelled: boolean;
1036
1190
  }>;
1037
1191
  reload: () => Promise<void>;
@@ -1050,6 +1204,7 @@ export interface Extension {
1050
1204
  handlers: Map<string, HandlerFn[]>;
1051
1205
  tools: Map<string, RegisteredTool>;
1052
1206
  messageRenderers: Map<string, MessageRenderer>;
1207
+ entryRenderers?: Map<string, EntryRenderer>;
1053
1208
  commands: Map<string, RegisteredCommand>;
1054
1209
  flags: Map<string, ExtensionFlag>;
1055
1210
  shortcuts: Map<KeyId, ExtensionShortcut>;