@draht/coding-agent 2026.9.5-1 → 2026.10.4-2

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 (1012) hide show
  1. package/CHANGELOG.md +452 -0
  2. package/dist/bun/cli.d.ts +1 -1
  3. package/dist/bun/cli.d.ts.map +1 -1
  4. package/dist/bun/cli.js +6 -3
  5. package/dist/bun/cli.js.map +1 -1
  6. package/dist/bun/sandbox-env-setup.d.ts +2 -0
  7. package/dist/bun/sandbox-env-setup.d.ts.map +1 -0
  8. package/dist/bun/sandbox-env-setup.js +4 -0
  9. package/dist/bun/sandbox-env-setup.js.map +1 -0
  10. package/dist/bundle/chunks/anthropic-messages-GAKYXF65.js +6 -0
  11. package/dist/bundle/chunks/anthropic.js +75 -0
  12. package/dist/bundle/chunks/azure-openai-responses-ZIXMK6JO.js +2 -0
  13. package/dist/bundle/chunks/bedrock-converse-stream.js +79 -0
  14. package/dist/bundle/chunks/chunk-2E5VODES.js +2 -0
  15. package/dist/bundle/chunks/chunk-2FBJKY7F.js +2 -0
  16. package/dist/bundle/chunks/chunk-2N4I6WXC.js +2 -0
  17. package/dist/bundle/chunks/chunk-5VZWYVZB.js +82 -0
  18. package/dist/bundle/chunks/chunk-63BK6WK2.js +2 -0
  19. package/dist/bundle/chunks/chunk-6MSE6LZ3.js +6 -0
  20. package/dist/bundle/chunks/chunk-6ZJKIMU7.js +2 -0
  21. package/dist/bundle/chunks/chunk-736QBNUZ.js +12 -0
  22. package/dist/bundle/chunks/chunk-BXSHCX3G.js +11 -0
  23. package/dist/bundle/chunks/chunk-CEJJ5XF2.js +170 -0
  24. package/dist/bundle/chunks/chunk-COF5JT7R.js +4 -0
  25. package/dist/bundle/chunks/chunk-D6TMD5Q2.js +44 -0
  26. package/dist/bundle/chunks/chunk-DPE4ALPU.js +146 -0
  27. package/dist/bundle/chunks/chunk-EBVYI75P.js +2 -0
  28. package/dist/bundle/chunks/chunk-GVXA72ZA.js +2 -0
  29. package/dist/bundle/chunks/chunk-H6FT43VC.js +137 -0
  30. package/dist/bundle/chunks/chunk-HJ72RANT.js +2 -0
  31. package/dist/bundle/chunks/chunk-HTJ3L72O.js +2 -0
  32. package/dist/bundle/chunks/chunk-HZ2UHMBT.js +2 -0
  33. package/dist/bundle/chunks/chunk-I5OKY6RH.js +11 -0
  34. package/dist/bundle/chunks/chunk-IWTUBX6V.js +4 -0
  35. package/dist/bundle/chunks/chunk-KPO5375S.js +2 -0
  36. package/dist/bundle/chunks/chunk-KVH4HR57.js +31 -0
  37. package/dist/bundle/chunks/chunk-LDAOC5RB.js +18 -0
  38. package/dist/bundle/chunks/chunk-ON6XU6AG.js +2 -0
  39. package/dist/bundle/chunks/chunk-QMN7OD6G.js +2 -0
  40. package/dist/bundle/chunks/chunk-RZKPFWMH.js +42 -0
  41. package/dist/bundle/chunks/chunk-SDRCE6OP.js +2 -0
  42. package/dist/bundle/chunks/chunk-SVNWI7EV.js +8 -0
  43. package/dist/bundle/chunks/chunk-TIA2T6EO.js +3 -0
  44. package/dist/bundle/chunks/chunk-VOFPZOUQ.js +1472 -0
  45. package/dist/bundle/chunks/chunk-XBUEMKIY.js +2 -0
  46. package/dist/bundle/chunks/chunk-XOGEYN4Q.js +2 -0
  47. package/dist/bundle/chunks/chunk-ZZD35WKM.js +2 -0
  48. package/dist/bundle/chunks/cli-SR5QBZH4.js +51 -0
  49. package/dist/bundle/chunks/cloudflare-workers-ai-system-one-MJKOAE5S.js +2 -0
  50. package/dist/bundle/chunks/codemode-worker.js +315 -0
  51. package/dist/bundle/chunks/execute-VCYDHEYA.js +328 -0
  52. package/dist/bundle/chunks/github-copilot.js +2 -0
  53. package/dist/bundle/chunks/google-antigravity.js +75 -0
  54. package/dist/bundle/chunks/google-gemini-cli.js +75 -0
  55. package/dist/bundle/chunks/google-generative-ai-RPUPQ6PM.js +2 -0
  56. package/dist/bundle/chunks/google-vertex-EZES5QVQ.js +2 -0
  57. package/dist/bundle/chunks/https-proxy-agent-O2PVUIOI.js +13 -0
  58. package/dist/bundle/chunks/image-resize-worker.js +2 -0
  59. package/dist/bundle/chunks/jiti-loader-RKXLMQV2.js +2 -0
  60. package/dist/bundle/chunks/kimi-coding.js +2 -0
  61. package/dist/bundle/chunks/lib-XOG5PI3Y.js +9 -0
  62. package/dist/bundle/chunks/llama-cpp-classify-EJ5XMSQL.js +22 -0
  63. package/dist/bundle/chunks/meta.js +2 -0
  64. package/dist/bundle/chunks/mistral-conversations-AOYGU43Y.js +5 -0
  65. package/dist/bundle/chunks/multipart-parser-AZP5BX2W.js +3 -0
  66. package/dist/bundle/chunks/node-C2JGH2OB.js +2 -0
  67. package/dist/bundle/chunks/node-LQ52KV6B.js +16 -0
  68. package/dist/bundle/chunks/openai-chatgpt.js +75 -0
  69. package/dist/bundle/chunks/openai-codex-responses-M2Y77JEQ.js +10 -0
  70. package/dist/bundle/chunks/openai-codex.js +75 -0
  71. package/dist/bundle/chunks/openai-completions-A4OKYOYV.js +7 -0
  72. package/dist/bundle/chunks/openai-responses-6IXV53T3.js +3 -0
  73. package/dist/bundle/chunks/opencode-go.js +2 -0
  74. package/dist/bundle/chunks/openrouter-images-LYV4NKFM.js +2 -0
  75. package/dist/bundle/chunks/openrouter.js +75 -0
  76. package/dist/bundle/chunks/pi-messages-KKMEUT3Z.js +8 -0
  77. package/dist/bundle/chunks/radius.js +75 -0
  78. package/dist/bundle/chunks/runtime-6YJPGSP7.js +2 -0
  79. package/dist/bundle/chunks/settings-manager-D2EG7WDO.js +2 -0
  80. package/dist/bundle/chunks/src-TIBHS42X.js +4 -0
  81. package/dist/bundle/chunks/typesafe-system-one-YBEEY5XU.js +2 -0
  82. package/dist/bundle/chunks/virtual-modules-CBOAFAFT.js +2 -0
  83. package/dist/bundle/chunks/xai.js +75 -0
  84. package/dist/bundle/cli-runtime.js +3 -0
  85. package/dist/bundle/cli.js +5 -0
  86. package/dist/bundle/index.js +2 -0
  87. package/dist/bundle/rpc-entry.js +3 -0
  88. package/dist/cli/args.d.ts +4 -0
  89. package/dist/cli/args.d.ts.map +1 -1
  90. package/dist/cli/args.js +72 -21
  91. package/dist/cli/args.js.map +1 -1
  92. package/dist/cli/auth-check.d.ts +19 -0
  93. package/dist/cli/auth-check.d.ts.map +1 -0
  94. package/dist/cli/auth-check.js +50 -0
  95. package/dist/cli/auth-check.js.map +1 -0
  96. package/dist/cli/auth-command.d.ts +24 -0
  97. package/dist/cli/auth-command.d.ts.map +1 -0
  98. package/dist/cli/auth-command.js +103 -0
  99. package/dist/cli/auth-command.js.map +1 -0
  100. package/dist/cli/config-selector.d.ts.map +1 -1
  101. package/dist/cli/config-selector.js +3 -2
  102. package/dist/cli/config-selector.js.map +1 -1
  103. package/dist/cli/credential-print.d.ts +5 -3
  104. package/dist/cli/credential-print.d.ts.map +1 -1
  105. package/dist/cli/credential-print.js +42 -30
  106. package/dist/cli/credential-print.js.map +1 -1
  107. package/dist/cli/file-processor.d.ts +1 -1
  108. package/dist/cli/file-processor.d.ts.map +1 -1
  109. package/dist/cli/file-processor.js +2 -1
  110. package/dist/cli/file-processor.js.map +1 -1
  111. package/dist/cli/list-models.d.ts +1 -1
  112. package/dist/cli/list-models.d.ts.map +1 -1
  113. package/dist/cli/list-models.js +2 -2
  114. package/dist/cli/list-models.js.map +1 -1
  115. package/dist/cli/session-picker.d.ts +1 -1
  116. package/dist/cli/session-picker.d.ts.map +1 -1
  117. package/dist/cli/session-picker.js.map +1 -1
  118. package/dist/cli/setup.d.ts +2 -0
  119. package/dist/cli/setup.d.ts.map +1 -0
  120. package/dist/cli/setup.js +12 -0
  121. package/dist/cli/setup.js.map +1 -0
  122. package/dist/cli/startup-ui.d.ts +2 -2
  123. package/dist/cli/startup-ui.d.ts.map +1 -1
  124. package/dist/cli/startup-ui.js +42 -33
  125. package/dist/cli/startup-ui.js.map +1 -1
  126. package/dist/cli.js +3 -12
  127. package/dist/cli.js.map +1 -1
  128. package/dist/config.d.ts +20 -4
  129. package/dist/config.d.ts.map +1 -1
  130. package/dist/config.js +42 -6
  131. package/dist/config.js.map +1 -1
  132. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  133. package/dist/core/agent-session-runtime.js +12 -3
  134. package/dist/core/agent-session-runtime.js.map +1 -1
  135. package/dist/core/agent-session-services.d.ts +1 -0
  136. package/dist/core/agent-session-services.d.ts.map +1 -1
  137. package/dist/core/agent-session-services.js +14 -0
  138. package/dist/core/agent-session-services.js.map +1 -1
  139. package/dist/core/agent-session.d.ts +237 -39
  140. package/dist/core/agent-session.d.ts.map +1 -1
  141. package/dist/core/agent-session.js +1386 -565
  142. package/dist/core/agent-session.js.map +1 -1
  143. package/dist/core/auth-storage.d.ts +20 -8
  144. package/dist/core/auth-storage.d.ts.map +1 -1
  145. package/dist/core/auth-storage.js +199 -56
  146. package/dist/core/auth-storage.js.map +1 -1
  147. package/dist/core/bug-report-upload.d.ts +11 -0
  148. package/dist/core/bug-report-upload.d.ts.map +1 -0
  149. package/dist/core/bug-report-upload.js +20 -0
  150. package/dist/core/bug-report-upload.js.map +1 -0
  151. package/dist/core/bug-report.d.ts +176 -0
  152. package/dist/core/bug-report.d.ts.map +1 -0
  153. package/dist/core/bug-report.js +292 -0
  154. package/dist/core/bug-report.js.map +1 -0
  155. package/dist/core/builtins/duet.js +2 -2
  156. package/dist/core/builtins/duet.js.map +1 -1
  157. package/dist/core/cache-stats.d.ts.map +1 -1
  158. package/dist/core/cache-stats.js +12 -1
  159. package/dist/core/cache-stats.js.map +1 -1
  160. package/dist/core/cache-warmer.d.ts +103 -0
  161. package/dist/core/cache-warmer.d.ts.map +1 -0
  162. package/dist/core/cache-warmer.js +356 -0
  163. package/dist/core/cache-warmer.js.map +1 -0
  164. package/dist/core/checkpoints/checkpoint-manager.d.ts +8 -4
  165. package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -1
  166. package/dist/core/checkpoints/checkpoint-manager.js +46 -10
  167. package/dist/core/checkpoints/checkpoint-manager.js.map +1 -1
  168. package/dist/core/checkpoints/rewind.d.ts +4 -2
  169. package/dist/core/checkpoints/rewind.d.ts.map +1 -1
  170. package/dist/core/checkpoints/rewind.js +4 -3
  171. package/dist/core/checkpoints/rewind.js.map +1 -1
  172. package/dist/core/compaction/branch-summarization.js +2 -2
  173. package/dist/core/compaction/branch-summarization.js.map +1 -1
  174. package/dist/core/compaction/compaction.d.ts +9 -6
  175. package/dist/core/compaction/compaction.d.ts.map +1 -1
  176. package/dist/core/compaction/compaction.js +196 -118
  177. package/dist/core/compaction/compaction.js.map +1 -1
  178. package/dist/core/compaction/utils.d.ts +2 -1
  179. package/dist/core/compaction/utils.d.ts.map +1 -1
  180. package/dist/core/compaction/utils.js +25 -18
  181. package/dist/core/compaction/utils.js.map +1 -1
  182. package/dist/core/crash-log.d.ts +27 -0
  183. package/dist/core/crash-log.d.ts.map +1 -0
  184. package/dist/core/crash-log.js +140 -0
  185. package/dist/core/crash-log.js.map +1 -0
  186. package/dist/core/defaults.d.ts +1 -0
  187. package/dist/core/defaults.d.ts.map +1 -1
  188. package/dist/core/defaults.js +9 -0
  189. package/dist/core/defaults.js.map +1 -1
  190. package/dist/core/experimental.js +1 -1
  191. package/dist/core/experimental.js.map +1 -1
  192. package/dist/core/export-html/template.css +10 -0
  193. package/dist/core/export-html/template.js +72 -18
  194. package/dist/core/extensions/index.d.ts +2 -2
  195. package/dist/core/extensions/index.d.ts.map +1 -1
  196. package/dist/core/extensions/index.js +1 -1
  197. package/dist/core/extensions/index.js.map +1 -1
  198. package/dist/core/extensions/jiti-loader.d.ts +2 -0
  199. package/dist/core/extensions/jiti-loader.d.ts.map +1 -0
  200. package/dist/core/extensions/jiti-loader.js +5 -0
  201. package/dist/core/extensions/jiti-loader.js.map +1 -0
  202. package/dist/core/extensions/loader.d.ts.map +1 -1
  203. package/dist/core/extensions/loader.js +228 -89
  204. package/dist/core/extensions/loader.js.map +1 -1
  205. package/dist/core/extensions/runner.d.ts +47 -8
  206. package/dist/core/extensions/runner.d.ts.map +1 -1
  207. package/dist/core/extensions/runner.js +376 -104
  208. package/dist/core/extensions/runner.js.map +1 -1
  209. package/dist/core/extensions/types.d.ts +521 -88
  210. package/dist/core/extensions/types.d.ts.map +1 -1
  211. package/dist/core/extensions/types.js +3 -0
  212. package/dist/core/extensions/types.js.map +1 -1
  213. package/dist/core/extensions/virtual-modules.d.ts +3 -0
  214. package/dist/core/extensions/virtual-modules.d.ts.map +1 -0
  215. package/dist/core/extensions/virtual-modules.js +37 -0
  216. package/dist/core/extensions/virtual-modules.js.map +1 -0
  217. package/dist/core/extensions/wrapper.d.ts +2 -2
  218. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  219. package/dist/core/extensions/wrapper.js +3 -22
  220. package/dist/core/extensions/wrapper.js.map +1 -1
  221. package/dist/core/footer-data-provider.d.ts +1 -1
  222. package/dist/core/footer-data-provider.js +19 -18
  223. package/dist/core/footer-data-provider.js.map +1 -1
  224. package/dist/core/index.d.ts +2 -1
  225. package/dist/core/index.d.ts.map +1 -1
  226. package/dist/core/index.js.map +1 -1
  227. package/dist/core/keybindings.d.ts +83 -13
  228. package/dist/core/keybindings.d.ts.map +1 -1
  229. package/dist/core/keybindings.js +33 -7
  230. package/dist/core/keybindings.js.map +1 -1
  231. package/dist/core/mcp-servers.d.ts +119 -0
  232. package/dist/core/mcp-servers.d.ts.map +1 -0
  233. package/dist/core/mcp-servers.js +191 -0
  234. package/dist/core/mcp-servers.js.map +1 -0
  235. package/dist/core/messages.d.ts +1 -1
  236. package/dist/core/messages.d.ts.map +1 -1
  237. package/dist/core/messages.js +1 -0
  238. package/dist/core/messages.js.map +1 -1
  239. package/dist/core/model-config.d.ts +202 -20
  240. package/dist/core/model-config.d.ts.map +1 -1
  241. package/dist/core/model-config.js +53 -18
  242. package/dist/core/model-config.js.map +1 -1
  243. package/dist/core/model-registry.d.ts +19 -2
  244. package/dist/core/model-registry.d.ts.map +1 -1
  245. package/dist/core/model-registry.js +39 -2
  246. package/dist/core/model-registry.js.map +1 -1
  247. package/dist/core/model-resolver.d.ts +7 -5
  248. package/dist/core/model-resolver.d.ts.map +1 -1
  249. package/dist/core/model-resolver.js +29 -17
  250. package/dist/core/model-resolver.js.map +1 -1
  251. package/dist/core/model-runtime.d.ts +79 -20
  252. package/dist/core/model-runtime.d.ts.map +1 -1
  253. package/dist/core/model-runtime.js +460 -134
  254. package/dist/core/model-runtime.js.map +1 -1
  255. package/dist/core/models-store.d.ts +12 -7
  256. package/dist/core/models-store.d.ts.map +1 -1
  257. package/dist/core/models-store.js +87 -18
  258. package/dist/core/models-store.js.map +1 -1
  259. package/dist/core/multi-agent/fsm.js +8 -3
  260. package/dist/core/multi-agent/fsm.js.map +1 -1
  261. package/dist/core/multi-agent/mailbox.js +1 -3
  262. package/dist/core/multi-agent/mailbox.js.map +1 -1
  263. package/dist/core/multi-agent/permission-gate.d.ts +5 -2
  264. package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
  265. package/dist/core/multi-agent/permission-gate.js +597 -34
  266. package/dist/core/multi-agent/permission-gate.js.map +1 -1
  267. package/dist/core/multi-agent/task-board.js +2 -4
  268. package/dist/core/multi-agent/task-board.js.map +1 -1
  269. package/dist/core/multi-agent/worktree.js +1 -3
  270. package/dist/core/multi-agent/worktree.js.map +1 -1
  271. package/dist/core/nested-tool-calls.d.ts +102 -0
  272. package/dist/core/nested-tool-calls.d.ts.map +1 -0
  273. package/dist/core/nested-tool-calls.js +178 -0
  274. package/dist/core/nested-tool-calls.js.map +1 -0
  275. package/dist/core/package-manager.d.ts +10 -0
  276. package/dist/core/package-manager.d.ts.map +1 -1
  277. package/dist/core/package-manager.js +149 -33
  278. package/dist/core/package-manager.js.map +1 -1
  279. package/dist/core/pi-manifest.d.ts.map +1 -1
  280. package/dist/core/pi-manifest.js +13 -12
  281. package/dist/core/pi-manifest.js.map +1 -1
  282. package/dist/core/prompt-templates.d.ts +6 -1
  283. package/dist/core/prompt-templates.d.ts.map +1 -1
  284. package/dist/core/prompt-templates.js +63 -37
  285. package/dist/core/prompt-templates.js.map +1 -1
  286. package/dist/core/provider-attribution.js +5 -5
  287. package/dist/core/provider-attribution.js.map +1 -1
  288. package/dist/core/provider-composer.d.ts +44 -20
  289. package/dist/core/provider-composer.d.ts.map +1 -1
  290. package/dist/core/provider-composer.js +151 -51
  291. package/dist/core/provider-composer.js.map +1 -1
  292. package/dist/core/radius.d.ts +13 -0
  293. package/dist/core/radius.d.ts.map +1 -1
  294. package/dist/core/radius.js +19 -0
  295. package/dist/core/radius.js.map +1 -1
  296. package/dist/core/remote-catalog-provider.d.ts +10 -3
  297. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  298. package/dist/core/remote-catalog-provider.js +105 -81
  299. package/dist/core/remote-catalog-provider.js.map +1 -1
  300. package/dist/core/resource-loader.d.ts +7 -1
  301. package/dist/core/resource-loader.d.ts.map +1 -1
  302. package/dist/core/resource-loader.js +219 -42
  303. package/dist/core/resource-loader.js.map +1 -1
  304. package/dist/core/runtime-credentials.d.ts +5 -5
  305. package/dist/core/runtime-credentials.d.ts.map +1 -1
  306. package/dist/core/runtime-credentials.js +13 -9
  307. package/dist/core/runtime-credentials.js.map +1 -1
  308. package/dist/core/sandbox/executor.js +1 -0
  309. package/dist/core/sandbox/executor.js.map +1 -1
  310. package/dist/core/sdk.d.ts +7 -5
  311. package/dist/core/sdk.d.ts.map +1 -1
  312. package/dist/core/sdk.js +100 -52
  313. package/dist/core/sdk.js.map +1 -1
  314. package/dist/core/session-cwd.js +1 -0
  315. package/dist/core/session-cwd.js.map +1 -1
  316. package/dist/core/session-export.d.ts +8 -0
  317. package/dist/core/session-export.d.ts.map +1 -0
  318. package/dist/core/session-export.js +33 -0
  319. package/dist/core/session-export.js.map +1 -0
  320. package/dist/core/session-manager.d.ts +75 -15
  321. package/dist/core/session-manager.d.ts.map +1 -1
  322. package/dist/core/session-manager.js +314 -144
  323. package/dist/core/session-manager.js.map +1 -1
  324. package/dist/core/settings-diagnostics.d.ts +9 -0
  325. package/dist/core/settings-diagnostics.d.ts.map +1 -0
  326. package/dist/core/settings-diagnostics.js +21 -0
  327. package/dist/core/settings-diagnostics.js.map +1 -0
  328. package/dist/core/settings-manager.d.ts +84 -4
  329. package/dist/core/settings-manager.d.ts.map +1 -1
  330. package/dist/core/settings-manager.js +239 -25
  331. package/dist/core/settings-manager.js.map +1 -1
  332. package/dist/core/skills.d.ts.map +1 -1
  333. package/dist/core/skills.js +51 -33
  334. package/dist/core/skills.js.map +1 -1
  335. package/dist/core/slash-commands.d.ts.map +1 -1
  336. package/dist/core/slash-commands.js +3 -1
  337. package/dist/core/slash-commands.js.map +1 -1
  338. package/dist/core/soak/soak-log.js +6 -0
  339. package/dist/core/soak/soak-log.js.map +1 -1
  340. package/dist/core/socket-server/socket-server.js +11 -0
  341. package/dist/core/socket-server/socket-server.js.map +1 -1
  342. package/dist/core/socket-server/types.d.ts +2 -1
  343. package/dist/core/socket-server/types.d.ts.map +1 -1
  344. package/dist/core/socket-server/types.js.map +1 -1
  345. package/dist/core/source-info.d.ts +8 -0
  346. package/dist/core/source-info.d.ts.map +1 -1
  347. package/dist/core/source-info.js +16 -0
  348. package/dist/core/source-info.js.map +1 -1
  349. package/dist/core/system-prompt.d.ts +49 -6
  350. package/dist/core/system-prompt.d.ts.map +1 -1
  351. package/dist/core/system-prompt.js +126 -89
  352. package/dist/core/system-prompt.js.map +1 -1
  353. package/dist/core/tools/bash.d.ts +32 -2
  354. package/dist/core/tools/bash.d.ts.map +1 -1
  355. package/dist/core/tools/bash.js +82 -143
  356. package/dist/core/tools/bash.js.map +1 -1
  357. package/dist/core/tools/edit-diff.d.ts +0 -5
  358. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  359. package/dist/core/tools/edit-diff.js +2 -5
  360. package/dist/core/tools/edit-diff.js.map +1 -1
  361. package/dist/core/tools/edit.d.ts +5 -12
  362. package/dist/core/tools/edit.d.ts.map +1 -1
  363. package/dist/core/tools/edit.js +19 -171
  364. package/dist/core/tools/edit.js.map +1 -1
  365. package/dist/core/tools/find.d.ts +4 -0
  366. package/dist/core/tools/find.d.ts.map +1 -1
  367. package/dist/core/tools/find.js +11 -58
  368. package/dist/core/tools/find.js.map +1 -1
  369. package/dist/core/tools/grep.d.ts +4 -0
  370. package/dist/core/tools/grep.d.ts.map +1 -1
  371. package/dist/core/tools/grep.js +10 -62
  372. package/dist/core/tools/grep.js.map +1 -1
  373. package/dist/core/tools/index.d.ts +4 -1
  374. package/dist/core/tools/index.d.ts.map +1 -1
  375. package/dist/core/tools/index.js +18 -1
  376. package/dist/core/tools/index.js.map +1 -1
  377. package/dist/core/tools/ls.d.ts +4 -0
  378. package/dist/core/tools/ls.d.ts.map +1 -1
  379. package/dist/core/tools/ls.js +9 -50
  380. package/dist/core/tools/ls.js.map +1 -1
  381. package/dist/core/tools/output-accumulator.d.ts +11 -0
  382. package/dist/core/tools/output-accumulator.d.ts.map +1 -1
  383. package/dist/core/tools/output-accumulator.js +54 -12
  384. package/dist/core/tools/output-accumulator.js.map +1 -1
  385. package/dist/core/tools/powershell.d.ts +16 -0
  386. package/dist/core/tools/powershell.d.ts.map +1 -0
  387. package/dist/core/tools/powershell.js +39 -0
  388. package/dist/core/tools/powershell.js.map +1 -0
  389. package/dist/core/tools/read.d.ts +8 -1
  390. package/dist/core/tools/read.d.ts.map +1 -1
  391. package/dist/core/tools/read.js +16 -123
  392. package/dist/core/tools/read.js.map +1 -1
  393. package/dist/core/tools/render-utils.d.ts +6 -0
  394. package/dist/core/tools/render-utils.d.ts.map +1 -1
  395. package/dist/core/tools/render-utils.js +26 -0
  396. package/dist/core/tools/render-utils.js.map +1 -1
  397. package/dist/core/tools/renderers/bash.d.ts +12 -0
  398. package/dist/core/tools/renderers/bash.d.ts.map +1 -0
  399. package/dist/core/tools/renderers/bash.js +117 -0
  400. package/dist/core/tools/renderers/bash.js.map +1 -0
  401. package/dist/core/tools/renderers/edit.d.ts +23 -0
  402. package/dist/core/tools/renderers/edit.d.ts.map +1 -0
  403. package/dist/core/tools/renderers/edit.js +167 -0
  404. package/dist/core/tools/renderers/edit.js.map +1 -0
  405. package/dist/core/tools/renderers/find.d.ts +10 -0
  406. package/dist/core/tools/renderers/find.d.ts.map +1 -0
  407. package/dist/core/tools/renderers/find.js +64 -0
  408. package/dist/core/tools/renderers/find.js.map +1 -0
  409. package/dist/core/tools/renderers/grep.d.ts +10 -0
  410. package/dist/core/tools/renderers/grep.d.ts.map +1 -0
  411. package/dist/core/tools/renderers/grep.js +69 -0
  412. package/dist/core/tools/renderers/grep.js.map +1 -0
  413. package/dist/core/tools/renderers/index.d.ts +28 -0
  414. package/dist/core/tools/renderers/index.d.ts.map +1 -0
  415. package/dist/core/tools/renderers/index.js +47 -0
  416. package/dist/core/tools/renderers/index.js.map +1 -0
  417. package/dist/core/tools/renderers/ls.d.ts +10 -0
  418. package/dist/core/tools/renderers/ls.d.ts.map +1 -0
  419. package/dist/core/tools/renderers/ls.js +58 -0
  420. package/dist/core/tools/renderers/ls.js.map +1 -0
  421. package/dist/core/tools/renderers/read.d.ts +11 -0
  422. package/dist/core/tools/renderers/read.d.ts.map +1 -0
  423. package/dist/core/tools/renderers/read.js +130 -0
  424. package/dist/core/tools/renderers/read.js.map +1 -0
  425. package/dist/core/tools/renderers/write.d.ts +10 -0
  426. package/dist/core/tools/renderers/write.d.ts.map +1 -0
  427. package/dist/core/tools/renderers/write.js +153 -0
  428. package/dist/core/tools/renderers/write.js.map +1 -0
  429. package/dist/core/tools/tool-definition-wrapper.d.ts +5 -3
  430. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  431. package/dist/core/tools/tool-definition-wrapper.js +3 -1
  432. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  433. package/dist/core/tools/truncate.d.ts +14 -0
  434. package/dist/core/tools/truncate.d.ts.map +1 -1
  435. package/dist/core/tools/truncate.js +29 -0
  436. package/dist/core/tools/truncate.js.map +1 -1
  437. package/dist/core/tools/write.d.ts +4 -0
  438. package/dist/core/tools/write.d.ts.map +1 -1
  439. package/dist/core/tools/write.js +12 -147
  440. package/dist/core/tools/write.js.map +1 -1
  441. package/dist/core/trust-manager.d.ts.map +1 -1
  442. package/dist/core/trust-manager.js +4 -1
  443. package/dist/core/trust-manager.js.map +1 -1
  444. package/dist/core/usage-totals.d.ts +3 -1
  445. package/dist/core/usage-totals.d.ts.map +1 -1
  446. package/dist/core/usage-totals.js +28 -1
  447. package/dist/core/usage-totals.js.map +1 -1
  448. package/dist/core/virtual-models.d.ts +117 -0
  449. package/dist/core/virtual-models.d.ts.map +1 -0
  450. package/dist/core/virtual-models.js +124 -0
  451. package/dist/core/virtual-models.js.map +1 -0
  452. package/dist/experimental/micro/api.d.ts +81 -0
  453. package/dist/experimental/micro/api.d.ts.map +1 -0
  454. package/dist/experimental/micro/api.js +2 -0
  455. package/dist/experimental/micro/api.js.map +1 -0
  456. package/dist/experimental/micro/main.d.ts +3 -0
  457. package/dist/experimental/micro/main.d.ts.map +1 -0
  458. package/dist/experimental/micro/main.js +21 -0
  459. package/dist/experimental/micro/main.js.map +1 -0
  460. package/dist/experimental/micro/models.d.ts +11 -0
  461. package/dist/experimental/micro/models.d.ts.map +1 -0
  462. package/dist/experimental/micro/models.js +95 -0
  463. package/dist/experimental/micro/models.js.map +1 -0
  464. package/dist/experimental/micro/runtime.d.ts +12 -0
  465. package/dist/experimental/micro/runtime.d.ts.map +1 -0
  466. package/dist/experimental/micro/runtime.js +465 -0
  467. package/dist/experimental/micro/runtime.js.map +1 -0
  468. package/dist/experimental/micro/sessions.d.ts +10 -0
  469. package/dist/experimental/micro/sessions.d.ts.map +1 -0
  470. package/dist/experimental/micro/sessions.js +41 -0
  471. package/dist/experimental/micro/sessions.js.map +1 -0
  472. package/dist/experimental/micro/tools.d.ts +10 -0
  473. package/dist/experimental/micro/tools.d.ts.map +1 -0
  474. package/dist/experimental/micro/tools.js +96 -0
  475. package/dist/experimental/micro/tools.js.map +1 -0
  476. package/dist/experimental/micro/tui.d.ts +3 -0
  477. package/dist/experimental/micro/tui.d.ts.map +1 -0
  478. package/dist/experimental/micro/tui.js +510 -0
  479. package/dist/experimental/micro/tui.js.map +1 -0
  480. package/dist/experimental/mini/main.d.ts +7 -0
  481. package/dist/experimental/mini/main.d.ts.map +1 -0
  482. package/dist/experimental/mini/main.js +21 -0
  483. package/dist/experimental/mini/main.js.map +1 -0
  484. package/dist/experimental/mini/server/entry.d.ts +3 -0
  485. package/dist/experimental/mini/server/entry.d.ts.map +1 -0
  486. package/dist/experimental/mini/server/entry.js +11 -0
  487. package/dist/experimental/mini/server/entry.js.map +1 -0
  488. package/dist/experimental/mini/server/run.d.ts +13 -0
  489. package/dist/experimental/mini/server/run.d.ts.map +1 -0
  490. package/dist/experimental/mini/server/run.js +150 -0
  491. package/dist/experimental/mini/server/run.js.map +1 -0
  492. package/dist/experimental/mini/shared/protocol.d.ts +127 -0
  493. package/dist/experimental/mini/shared/protocol.d.ts.map +1 -0
  494. package/dist/experimental/mini/shared/protocol.js +13 -0
  495. package/dist/experimental/mini/shared/protocol.js.map +1 -0
  496. package/dist/experimental/mini/shared/rpc.d.ts +49 -0
  497. package/dist/experimental/mini/shared/rpc.d.ts.map +1 -0
  498. package/dist/experimental/mini/shared/rpc.js +171 -0
  499. package/dist/experimental/mini/shared/rpc.js.map +1 -0
  500. package/dist/experimental/mini/shared/transport.d.ts +35 -0
  501. package/dist/experimental/mini/shared/transport.d.ts.map +1 -0
  502. package/dist/experimental/mini/shared/transport.js +94 -0
  503. package/dist/experimental/mini/shared/transport.js.map +1 -0
  504. package/dist/experimental/mini/tui/run.d.ts +9 -0
  505. package/dist/experimental/mini/tui/run.d.ts.map +1 -0
  506. package/dist/experimental/mini/tui/run.js +62 -0
  507. package/dist/experimental/mini/tui/run.js.map +1 -0
  508. package/dist/experimental/mini/tui/session.d.ts +26 -0
  509. package/dist/experimental/mini/tui/session.d.ts.map +1 -0
  510. package/dist/experimental/mini/tui/session.js +94 -0
  511. package/dist/experimental/mini/tui/session.js.map +1 -0
  512. package/dist/experimental/mini/tui/view.d.ts +10 -0
  513. package/dist/experimental/mini/tui/view.d.ts.map +1 -0
  514. package/dist/experimental/mini/tui/view.js +461 -0
  515. package/dist/experimental/mini/tui/view.js.map +1 -0
  516. package/dist/experimental/mini/worker/entry.d.ts +3 -0
  517. package/dist/experimental/mini/worker/entry.d.ts.map +1 -0
  518. package/dist/experimental/mini/worker/entry.js +10 -0
  519. package/dist/experimental/mini/worker/entry.js.map +1 -0
  520. package/dist/experimental/mini/worker/lane-service.d.ts +44 -0
  521. package/dist/experimental/mini/worker/lane-service.d.ts.map +1 -0
  522. package/dist/experimental/mini/worker/lane-service.js +97 -0
  523. package/dist/experimental/mini/worker/lane-service.js.map +1 -0
  524. package/dist/experimental/mini/worker/models-service.d.ts +19 -0
  525. package/dist/experimental/mini/worker/models-service.d.ts.map +1 -0
  526. package/dist/experimental/mini/worker/models-service.js +136 -0
  527. package/dist/experimental/mini/worker/models-service.js.map +1 -0
  528. package/dist/experimental/mini/worker/run.d.ts +14 -0
  529. package/dist/experimental/mini/worker/run.d.ts.map +1 -0
  530. package/dist/experimental/mini/worker/run.js +88 -0
  531. package/dist/experimental/mini/worker/run.js.map +1 -0
  532. package/dist/extensions/codemode/execute.d.ts +16 -0
  533. package/dist/extensions/codemode/execute.d.ts.map +1 -0
  534. package/dist/extensions/codemode/execute.js +429 -0
  535. package/dist/extensions/codemode/execute.js.map +1 -0
  536. package/dist/extensions/codemode/execute.lazy.d.ts +3 -0
  537. package/dist/extensions/codemode/execute.lazy.d.ts.map +1 -0
  538. package/dist/extensions/codemode/execute.lazy.js +3 -0
  539. package/dist/extensions/codemode/execute.lazy.js.map +1 -0
  540. package/dist/extensions/codemode/index.d.ts +21 -0
  541. package/dist/extensions/codemode/index.d.ts.map +1 -0
  542. package/dist/extensions/codemode/index.js +31 -0
  543. package/dist/extensions/codemode/index.js.map +1 -0
  544. package/dist/extensions/codemode/renderer.d.ts +12 -0
  545. package/dist/extensions/codemode/renderer.d.ts.map +1 -0
  546. package/dist/extensions/codemode/renderer.js +137 -0
  547. package/dist/extensions/codemode/renderer.js.map +1 -0
  548. package/dist/extensions/codemode/tool.d.ts +123 -0
  549. package/dist/extensions/codemode/tool.d.ts.map +1 -0
  550. package/dist/extensions/codemode/tool.js +315 -0
  551. package/dist/extensions/codemode/tool.js.map +1 -0
  552. package/dist/extensions/codemode/worker.d.ts +7 -0
  553. package/dist/extensions/codemode/worker.d.ts.map +1 -0
  554. package/dist/extensions/codemode/worker.js +7 -0
  555. package/dist/extensions/codemode/worker.js.map +1 -0
  556. package/dist/extensions/index.d.ts.map +1 -1
  557. package/dist/extensions/index.js +9 -1
  558. package/dist/extensions/index.js.map +1 -1
  559. package/dist/extensions/llama/client.d.ts +8 -0
  560. package/dist/extensions/llama/client.d.ts.map +1 -1
  561. package/dist/extensions/llama/client.js +13 -0
  562. package/dist/extensions/llama/client.js.map +1 -1
  563. package/dist/extensions/llama/huggingface.js +2 -0
  564. package/dist/extensions/llama/huggingface.js.map +1 -1
  565. package/dist/extensions/llama/index.d.ts.map +1 -1
  566. package/dist/extensions/llama/index.js +13 -2
  567. package/dist/extensions/llama/index.js.map +1 -1
  568. package/dist/extensions/llama/provider.d.ts +4 -2
  569. package/dist/extensions/llama/provider.d.ts.map +1 -1
  570. package/dist/extensions/llama/provider.js +119 -17
  571. package/dist/extensions/llama/provider.js.map +1 -1
  572. package/dist/extensions/llama/ui.js +28 -12
  573. package/dist/extensions/llama/ui.js.map +1 -1
  574. package/dist/extensions/mcp/cli.d.ts +21 -0
  575. package/dist/extensions/mcp/cli.d.ts.map +1 -0
  576. package/dist/extensions/mcp/cli.js +500 -0
  577. package/dist/extensions/mcp/cli.js.map +1 -0
  578. package/dist/extensions/mcp/cli.lazy.d.ts +3 -0
  579. package/dist/extensions/mcp/cli.lazy.d.ts.map +1 -0
  580. package/dist/extensions/mcp/cli.lazy.js +3 -0
  581. package/dist/extensions/mcp/cli.lazy.js.map +1 -0
  582. package/dist/extensions/mcp/config.d.ts +72 -0
  583. package/dist/extensions/mcp/config.d.ts.map +1 -0
  584. package/dist/extensions/mcp/config.js +158 -0
  585. package/dist/extensions/mcp/config.js.map +1 -0
  586. package/dist/extensions/mcp/index.d.ts +76 -0
  587. package/dist/extensions/mcp/index.d.ts.map +1 -0
  588. package/dist/extensions/mcp/index.js +1055 -0
  589. package/dist/extensions/mcp/index.js.map +1 -0
  590. package/dist/extensions/mcp/log.d.ts +16 -0
  591. package/dist/extensions/mcp/log.d.ts.map +1 -0
  592. package/dist/extensions/mcp/log.js +66 -0
  593. package/dist/extensions/mcp/log.js.map +1 -0
  594. package/dist/extensions/mcp/oauth.d.ts +96 -0
  595. package/dist/extensions/mcp/oauth.d.ts.map +1 -0
  596. package/dist/extensions/mcp/oauth.js +333 -0
  597. package/dist/extensions/mcp/oauth.js.map +1 -0
  598. package/dist/extensions/mcp/resources.d.ts +43 -0
  599. package/dist/extensions/mcp/resources.d.ts.map +1 -0
  600. package/dist/extensions/mcp/resources.js +262 -0
  601. package/dist/extensions/mcp/resources.js.map +1 -0
  602. package/dist/extensions/mcp/runtime.d.ts +98 -0
  603. package/dist/extensions/mcp/runtime.d.ts.map +1 -0
  604. package/dist/extensions/mcp/runtime.js +394 -0
  605. package/dist/extensions/mcp/runtime.js.map +1 -0
  606. package/dist/extensions/mcp/runtime.lazy.d.ts +3 -0
  607. package/dist/extensions/mcp/runtime.lazy.d.ts.map +1 -0
  608. package/dist/extensions/mcp/runtime.lazy.js +3 -0
  609. package/dist/extensions/mcp/runtime.lazy.js.map +1 -0
  610. package/dist/extensions/mcp/tools.d.ts +84 -0
  611. package/dist/extensions/mcp/tools.d.ts.map +1 -0
  612. package/dist/extensions/mcp/tools.js +251 -0
  613. package/dist/extensions/mcp/tools.js.map +1 -0
  614. package/dist/extensions/mcp/ui.d.ts +60 -0
  615. package/dist/extensions/mcp/ui.d.ts.map +1 -0
  616. package/dist/extensions/mcp/ui.js +174 -0
  617. package/dist/extensions/mcp/ui.js.map +1 -0
  618. package/dist/extensions/stub-provider/provider.d.ts +2 -2
  619. package/dist/extensions/stub-provider/provider.d.ts.map +1 -1
  620. package/dist/extensions/stub-provider/provider.js +2 -1
  621. package/dist/extensions/stub-provider/provider.js.map +1 -1
  622. package/dist/extensions/tool-search/index.d.ts +12 -0
  623. package/dist/extensions/tool-search/index.d.ts.map +1 -0
  624. package/dist/extensions/tool-search/index.js +15 -0
  625. package/dist/extensions/tool-search/index.js.map +1 -0
  626. package/dist/extensions/tool-search/tool.d.ts +73 -0
  627. package/dist/extensions/tool-search/tool.d.ts.map +1 -0
  628. package/dist/extensions/tool-search/tool.js +189 -0
  629. package/dist/extensions/tool-search/tool.js.map +1 -0
  630. package/dist/index.d.ts +20 -11
  631. package/dist/index.d.ts.map +1 -1
  632. package/dist/index.js +12 -6
  633. package/dist/index.js.map +1 -1
  634. package/dist/main.d.ts +4 -0
  635. package/dist/main.d.ts.map +1 -1
  636. package/dist/main.js +123 -51
  637. package/dist/main.js.map +1 -1
  638. package/dist/migrations.d.ts +1 -1
  639. package/dist/migrations.js +7 -6
  640. package/dist/migrations.js.map +1 -1
  641. package/dist/modes/index.d.ts +1 -0
  642. package/dist/modes/index.d.ts.map +1 -1
  643. package/dist/modes/index.js.map +1 -1
  644. package/dist/modes/interactive/bug-report.d.ts +19 -0
  645. package/dist/modes/interactive/bug-report.d.ts.map +1 -0
  646. package/dist/modes/interactive/bug-report.js +211 -0
  647. package/dist/modes/interactive/bug-report.js.map +1 -0
  648. package/dist/modes/interactive/chat-viewport.d.ts +20 -0
  649. package/dist/modes/interactive/chat-viewport.d.ts.map +1 -0
  650. package/dist/modes/interactive/chat-viewport.js +28 -0
  651. package/dist/modes/interactive/chat-viewport.js.map +1 -0
  652. package/dist/modes/interactive/components/armin.js +10 -6
  653. package/dist/modes/interactive/components/armin.js.map +1 -1
  654. package/dist/modes/interactive/components/assistant-message.d.ts +6 -2
  655. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  656. package/dist/modes/interactive/components/assistant-message.js +38 -15
  657. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  658. package/dist/modes/interactive/components/bash-execution.js +9 -4
  659. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  660. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  661. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  662. package/dist/modes/interactive/components/branch-summary-message.d.ts +1 -1
  663. package/dist/modes/interactive/components/branch-summary-message.d.ts.map +1 -1
  664. package/dist/modes/interactive/components/branch-summary-message.js +15 -6
  665. package/dist/modes/interactive/components/branch-summary-message.js.map +1 -1
  666. package/dist/modes/interactive/components/compaction-summary-message.d.ts +1 -1
  667. package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +1 -1
  668. package/dist/modes/interactive/components/compaction-summary-message.js +15 -6
  669. package/dist/modes/interactive/components/compaction-summary-message.js.map +1 -1
  670. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  671. package/dist/modes/interactive/components/config-selector.js +35 -8
  672. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  673. package/dist/modes/interactive/components/countdown-timer.js +5 -0
  674. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  675. package/dist/modes/interactive/components/custom-editor.d.ts +10 -1
  676. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  677. package/dist/modes/interactive/components/custom-editor.js +54 -2
  678. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  679. package/dist/modes/interactive/components/custom-entry.js +4 -1
  680. package/dist/modes/interactive/components/custom-entry.js.map +1 -1
  681. package/dist/modes/interactive/components/custom-message.js +7 -1
  682. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  683. package/dist/modes/interactive/components/daxnuts.js +8 -6
  684. package/dist/modes/interactive/components/daxnuts.js.map +1 -1
  685. package/dist/modes/interactive/components/dynamic-border.js +1 -0
  686. package/dist/modes/interactive/components/dynamic-border.js.map +1 -1
  687. package/dist/modes/interactive/components/extension-editor.d.ts +4 -1
  688. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  689. package/dist/modes/interactive/components/extension-editor.js +14 -3
  690. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  691. package/dist/modes/interactive/components/extension-input.d.ts +2 -0
  692. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  693. package/dist/modes/interactive/components/extension-input.js +14 -2
  694. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  695. package/dist/modes/interactive/components/extension-selector.d.ts +1 -0
  696. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  697. package/dist/modes/interactive/components/extension-selector.js +16 -1
  698. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  699. package/dist/modes/interactive/components/first-time-setup.d.ts +4 -4
  700. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -1
  701. package/dist/modes/interactive/components/first-time-setup.js +12 -4
  702. package/dist/modes/interactive/components/first-time-setup.js.map +1 -1
  703. package/dist/modes/interactive/components/footer.d.ts +7 -0
  704. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  705. package/dist/modes/interactive/components/footer.js +51 -6
  706. package/dist/modes/interactive/components/footer.js.map +1 -1
  707. package/dist/modes/interactive/components/index.d.ts +1 -1
  708. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  709. package/dist/modes/interactive/components/index.js.map +1 -1
  710. package/dist/modes/interactive/components/login-dialog.js +9 -3
  711. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  712. package/dist/modes/interactive/components/markdown-transform.d.ts +3 -0
  713. package/dist/modes/interactive/components/markdown-transform.d.ts.map +1 -0
  714. package/dist/modes/interactive/components/markdown-transform.js +19 -0
  715. package/dist/modes/interactive/components/markdown-transform.js.map +1 -0
  716. package/dist/modes/interactive/components/mermaid.d.ts +11 -0
  717. package/dist/modes/interactive/components/mermaid.d.ts.map +1 -0
  718. package/dist/modes/interactive/components/mermaid.js +75 -0
  719. package/dist/modes/interactive/components/mermaid.js.map +1 -0
  720. package/dist/modes/interactive/components/model-selector.d.ts +10 -4
  721. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  722. package/dist/modes/interactive/components/model-selector.js +101 -40
  723. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  724. package/dist/modes/interactive/components/oauth-selector.js +11 -3
  725. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  726. package/dist/modes/interactive/components/scoped-models-selector.d.ts +4 -0
  727. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  728. package/dist/modes/interactive/components/scoped-models-selector.js +60 -32
  729. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  730. package/dist/modes/interactive/components/session-selector.d.ts +5 -5
  731. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  732. package/dist/modes/interactive/components/session-selector.js +128 -78
  733. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  734. package/dist/modes/interactive/components/settings-selector.d.ts +23 -4
  735. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  736. package/dist/modes/interactive/components/settings-selector.js +230 -67
  737. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  738. package/dist/modes/interactive/components/settings-submenu.d.ts +72 -0
  739. package/dist/modes/interactive/components/settings-submenu.d.ts.map +1 -0
  740. package/dist/modes/interactive/components/settings-submenu.js +165 -0
  741. package/dist/modes/interactive/components/settings-submenu.js.map +1 -0
  742. package/dist/modes/interactive/components/show-images-selector.js +1 -0
  743. package/dist/modes/interactive/components/show-images-selector.js.map +1 -1
  744. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  745. package/dist/modes/interactive/components/skill-invocation-message.js +14 -5
  746. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  747. package/dist/modes/interactive/components/status-indicator.d.ts +3 -1
  748. package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -1
  749. package/dist/modes/interactive/components/status-indicator.js +12 -3
  750. package/dist/modes/interactive/components/status-indicator.js.map +1 -1
  751. package/dist/modes/interactive/components/theme-selector.js +2 -0
  752. package/dist/modes/interactive/components/theme-selector.js.map +1 -1
  753. package/dist/modes/interactive/components/themed-text.d.ts +17 -0
  754. package/dist/modes/interactive/components/themed-text.d.ts.map +1 -0
  755. package/dist/modes/interactive/components/themed-text.js +29 -0
  756. package/dist/modes/interactive/components/themed-text.js.map +1 -0
  757. package/dist/modes/interactive/components/thinking-selector.d.ts +15 -3
  758. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  759. package/dist/modes/interactive/components/thinking-selector.js +76 -18
  760. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  761. package/dist/modes/interactive/components/tool-execution.d.ts +21 -4
  762. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  763. package/dist/modes/interactive/components/tool-execution.js +78 -52
  764. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  765. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  766. package/dist/modes/interactive/components/tree-selector.js +44 -18
  767. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  768. package/dist/modes/interactive/components/trust-selector.js +8 -2
  769. package/dist/modes/interactive/components/trust-selector.js.map +1 -1
  770. package/dist/modes/interactive/components/user-message-selector.js +6 -3
  771. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  772. package/dist/modes/interactive/components/user-message.d.ts +3 -1
  773. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  774. package/dist/modes/interactive/components/user-message.js +12 -2
  775. package/dist/modes/interactive/components/user-message.js.map +1 -1
  776. package/dist/modes/interactive/components/visual-truncate.d.ts +27 -3
  777. package/dist/modes/interactive/components/visual-truncate.d.ts.map +1 -1
  778. package/dist/modes/interactive/components/visual-truncate.js +39 -6
  779. package/dist/modes/interactive/components/visual-truncate.js.map +1 -1
  780. package/dist/modes/interactive/external-editor.d.ts.map +1 -1
  781. package/dist/modes/interactive/external-editor.js +2 -1
  782. package/dist/modes/interactive/external-editor.js.map +1 -1
  783. package/dist/modes/interactive/interactive-mode.d.ts +69 -5
  784. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  785. package/dist/modes/interactive/interactive-mode.js +1314 -593
  786. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  787. package/dist/modes/interactive/model-catalog-refresh.d.ts +7 -0
  788. package/dist/modes/interactive/model-catalog-refresh.d.ts.map +1 -0
  789. package/dist/modes/interactive/model-catalog-refresh.js +34 -0
  790. package/dist/modes/interactive/model-catalog-refresh.js.map +1 -0
  791. package/dist/modes/interactive/session-share.d.ts +23 -0
  792. package/dist/modes/interactive/session-share.d.ts.map +1 -0
  793. package/dist/modes/interactive/session-share.js +130 -0
  794. package/dist/modes/interactive/session-share.js.map +1 -0
  795. package/dist/modes/interactive/theme/dark.json +54 -63
  796. package/dist/modes/interactive/theme/light.json +52 -60
  797. package/dist/modes/interactive/theme/system-theme.d.ts +54 -0
  798. package/dist/modes/interactive/theme/system-theme.d.ts.map +1 -0
  799. package/dist/modes/interactive/theme/system-theme.js +535 -0
  800. package/dist/modes/interactive/theme/system-theme.js.map +1 -0
  801. package/dist/modes/interactive/theme/theme-controller.d.ts +59 -7
  802. package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -1
  803. package/dist/modes/interactive/theme/theme-controller.js +164 -51
  804. package/dist/modes/interactive/theme/theme-controller.js.map +1 -1
  805. package/dist/modes/interactive/theme/theme-json.d.ts +85 -0
  806. package/dist/modes/interactive/theme/theme-json.d.ts.map +1 -0
  807. package/dist/modes/interactive/theme/theme-json.js +132 -0
  808. package/dist/modes/interactive/theme/theme-json.js.map +1 -0
  809. package/dist/modes/interactive/theme/theme-schema.json +24 -3
  810. package/dist/modes/interactive/theme/theme.d.ts +80 -42
  811. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  812. package/dist/modes/interactive/theme/theme.js +274 -417
  813. package/dist/modes/interactive/theme/theme.js.map +1 -1
  814. package/dist/modes/interactive/tui-renderer.d.ts +22 -0
  815. package/dist/modes/interactive/tui-renderer.d.ts.map +1 -0
  816. package/dist/modes/interactive/tui-renderer.js +67 -0
  817. package/dist/modes/interactive/tui-renderer.js.map +1 -0
  818. package/dist/modes/json-event.d.ts +34 -0
  819. package/dist/modes/json-event.d.ts.map +1 -0
  820. package/dist/modes/json-event.js +29 -0
  821. package/dist/modes/json-event.js.map +1 -0
  822. package/dist/modes/print-mode.d.ts +1 -1
  823. package/dist/modes/print-mode.d.ts.map +1 -1
  824. package/dist/modes/print-mode.js +12 -2
  825. package/dist/modes/print-mode.js.map +1 -1
  826. package/dist/modes/rpc/rpc-client.d.ts +17 -9
  827. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  828. package/dist/modes/rpc/rpc-client.js +27 -15
  829. package/dist/modes/rpc/rpc-client.js.map +1 -1
  830. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  831. package/dist/modes/rpc/rpc-mode.js +14 -12
  832. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  833. package/dist/modes/rpc/rpc-types.d.ts +22 -1
  834. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  835. package/dist/modes/rpc/rpc-types.js.map +1 -1
  836. package/dist/package-manager-cli.d.ts +1 -0
  837. package/dist/package-manager-cli.d.ts.map +1 -1
  838. package/dist/package-manager-cli.js +217 -63
  839. package/dist/package-manager-cli.js.map +1 -1
  840. package/dist/prompts/commands/plan-phase.md +1 -0
  841. package/dist/prompts/commands/review.md +2 -0
  842. package/dist/prompts/commands/verify-work.md +1 -0
  843. package/dist/prompts/commands/why.md +4 -0
  844. package/dist/rpc-entry.js +1 -0
  845. package/dist/rpc-entry.js.map +1 -1
  846. package/dist/skills/blast-radius/SKILL.md +1 -0
  847. package/dist/skills/explainers/SKILL.md +65 -0
  848. package/dist/skills/unslop/SKILL.md +19 -1
  849. package/dist/utils/abort.d.ts +5 -0
  850. package/dist/utils/abort.d.ts.map +1 -0
  851. package/dist/utils/abort.js +48 -0
  852. package/dist/utils/abort.js.map +1 -0
  853. package/dist/utils/changelog.js +1 -1
  854. package/dist/utils/changelog.js.map +1 -1
  855. package/dist/utils/child-process.d.ts +1 -1
  856. package/dist/utils/child-process.js +1 -1
  857. package/dist/utils/child-process.js.map +1 -1
  858. package/dist/utils/clipboard-command.d.ts +7 -0
  859. package/dist/utils/clipboard-command.d.ts.map +1 -0
  860. package/dist/utils/clipboard-command.js +45 -0
  861. package/dist/utils/clipboard-command.js.map +1 -0
  862. package/dist/utils/clipboard-image.d.ts.map +1 -1
  863. package/dist/utils/clipboard-image.js +60 -91
  864. package/dist/utils/clipboard-image.js.map +1 -1
  865. package/dist/utils/clipboard.d.ts +2 -0
  866. package/dist/utils/clipboard.d.ts.map +1 -1
  867. package/dist/utils/clipboard.js +116 -121
  868. package/dist/utils/clipboard.js.map +1 -1
  869. package/dist/utils/draht-user-agent.d.ts +2 -0
  870. package/dist/utils/draht-user-agent.d.ts.map +1 -0
  871. package/dist/utils/draht-user-agent.js +5 -0
  872. package/dist/utils/draht-user-agent.js.map +1 -0
  873. package/dist/utils/exif-orientation.d.ts +2 -1
  874. package/dist/utils/exif-orientation.d.ts.map +1 -1
  875. package/dist/utils/exif-orientation.js.map +1 -1
  876. package/dist/utils/frontmatter.d.ts.map +1 -1
  877. package/dist/utils/frontmatter.js +2 -1
  878. package/dist/utils/frontmatter.js.map +1 -1
  879. package/dist/utils/management-http.d.ts +25 -0
  880. package/dist/utils/management-http.d.ts.map +1 -0
  881. package/dist/utils/management-http.js +54 -0
  882. package/dist/utils/management-http.js.map +1 -0
  883. package/dist/utils/mime.js +1 -1
  884. package/dist/utils/mime.js.map +1 -1
  885. package/dist/utils/paths.d.ts +4 -3
  886. package/dist/utils/paths.d.ts.map +1 -1
  887. package/dist/utils/paths.js +15 -4
  888. package/dist/utils/paths.js.map +1 -1
  889. package/dist/utils/photon.d.ts +2 -1
  890. package/dist/utils/photon.d.ts.map +1 -1
  891. package/dist/utils/photon.js.map +1 -1
  892. package/dist/utils/shell.d.ts +4 -3
  893. package/dist/utils/shell.d.ts.map +1 -1
  894. package/dist/utils/shell.js +20 -35
  895. package/dist/utils/shell.js.map +1 -1
  896. package/dist/utils/syntax-highlight.d.ts +1 -0
  897. package/dist/utils/syntax-highlight.d.ts.map +1 -1
  898. package/dist/utils/syntax-highlight.js +62 -1
  899. package/dist/utils/syntax-highlight.js.map +1 -1
  900. package/dist/utils/text.d.ts +8 -0
  901. package/dist/utils/text.d.ts.map +1 -0
  902. package/dist/utils/text.js +9 -0
  903. package/dist/utils/text.js.map +1 -0
  904. package/dist/utils/tool-result-images.d.ts +21 -0
  905. package/dist/utils/tool-result-images.d.ts.map +1 -0
  906. package/dist/utils/tool-result-images.js +48 -0
  907. package/dist/utils/tool-result-images.js.map +1 -0
  908. package/dist/utils/tools-manager.d.ts +11 -1
  909. package/dist/utils/tools-manager.d.ts.map +1 -1
  910. package/dist/utils/tools-manager.js +53 -36
  911. package/dist/utils/tools-manager.js.map +1 -1
  912. package/dist/utils/version-check.d.ts +4 -1
  913. package/dist/utils/version-check.d.ts.map +1 -1
  914. package/dist/utils/version-check.js +30 -9
  915. package/dist/utils/version-check.js.map +1 -1
  916. package/dist/utils/wsl.d.ts +3 -0
  917. package/dist/utils/wsl.d.ts.map +1 -0
  918. package/dist/utils/wsl.js +15 -0
  919. package/dist/utils/wsl.js.map +1 -0
  920. package/dist/utils/zip.d.ts +7 -0
  921. package/dist/utils/zip.d.ts.map +1 -0
  922. package/dist/utils/zip.js +60 -0
  923. package/dist/utils/zip.js.map +1 -0
  924. package/docs/cli-integration.md +106 -0
  925. package/docs/cli.md +374 -0
  926. package/docs/compaction.md +91 -29
  927. package/docs/configuration.md +47 -0
  928. package/docs/containerization.md +100 -66
  929. package/docs/custom-provider.md +109 -707
  930. package/docs/docs.json +155 -99
  931. package/docs/environment-variables.md +30 -17
  932. package/docs/extensions.md +169 -2811
  933. package/docs/how-pi-works.md +53 -0
  934. package/docs/images/interactive-mode.png +0 -0
  935. package/docs/index.md +25 -69
  936. package/docs/json.md +197 -56
  937. package/docs/keybindings.md +89 -93
  938. package/docs/llama-cpp.md +18 -3
  939. package/docs/mcp.md +231 -0
  940. package/docs/message-types.md +261 -0
  941. package/docs/models.md +94 -478
  942. package/docs/packages.md +67 -163
  943. package/docs/prompt-templates.md +31 -68
  944. package/docs/providers.md +118 -215
  945. package/docs/quickstart.md +55 -108
  946. package/docs/rpc-commands.md +860 -0
  947. package/docs/rpc-extension-ui.md +200 -0
  948. package/docs/rpc.md +139 -1518
  949. package/docs/sdk.md +79 -1127
  950. package/docs/security.md +76 -32
  951. package/docs/session-format.md +73 -219
  952. package/docs/sessions.md +36 -116
  953. package/docs/settings.md +124 -257
  954. package/docs/shell-aliases.md +85 -5
  955. package/docs/skills.md +52 -189
  956. package/docs/slash-commands.md +61 -0
  957. package/docs/terminal-setup.md +132 -61
  958. package/docs/termux.md +74 -84
  959. package/docs/themes.md +91 -252
  960. package/docs/tmux.md +31 -39
  961. package/docs/tui.md +74 -891
  962. package/docs/usage.md +54 -255
  963. package/docs/virtual-models.md +114 -0
  964. package/docs/windows.md +57 -7
  965. package/examples/extensions/antigravity-image-gen.ts +9 -9
  966. package/examples/extensions/bash-spawn-hook.ts +1 -1
  967. package/examples/extensions/border-status-editor.ts +1 -1
  968. package/examples/extensions/built-in-tool-renderer.ts +16 -40
  969. package/examples/extensions/custom-compaction.ts +1 -16
  970. package/examples/extensions/custom-provider-anthropic/index.ts +20 -13
  971. package/examples/extensions/custom-provider-gitlab-duo/index.ts +4 -3
  972. package/examples/extensions/custom-provider-gitlab-duo/test.ts +5 -5
  973. package/examples/extensions/debug-provider.ts +90 -0
  974. package/examples/extensions/doom-overlay/wad-finder.ts +7 -3
  975. package/examples/extensions/dynamic-resources/dynamic.json +3 -1
  976. package/examples/extensions/git-checkpoint.ts +2 -2
  977. package/examples/extensions/handoff.ts +2 -11
  978. package/examples/extensions/jev-router.ts +113 -0
  979. package/examples/extensions/minimal-mode.ts +24 -96
  980. package/examples/extensions/notify.ts +3 -1
  981. package/examples/extensions/prompt-customizer.ts +19 -67
  982. package/examples/extensions/qna.ts +3 -7
  983. package/examples/extensions/subagent/agents.ts +40 -9
  984. package/examples/extensions/subagent/index.ts +27 -4
  985. package/examples/extensions/summarize.ts +7 -18
  986. package/examples/extensions/titlebar-spinner.ts +1 -1
  987. package/examples/rpc-client.ts +35 -0
  988. package/examples/rpc-extension-ui.ts +38 -9
  989. package/examples/sdk/02-custom-model.ts +1 -2
  990. package/examples/sdk/06-extensions.ts +1 -1
  991. package/examples/sdk/09-api-keys-and-oauth.ts +1 -1
  992. package/examples/sdk/12-full-control.ts +1 -1
  993. package/examples/sdk/14-codemode-mcp.ts +61 -0
  994. package/package.json +25 -30
  995. package/prompts/commands/plan-phase.md +1 -0
  996. package/prompts/commands/review.md +2 -0
  997. package/prompts/commands/verify-work.md +1 -0
  998. package/prompts/commands/why.md +4 -0
  999. package/skills/blast-radius/SKILL.md +1 -0
  1000. package/skills/explainers/SKILL.md +65 -0
  1001. package/skills/unslop/SKILL.md +19 -1
  1002. package/dist/utils/clipboard-native.d.ts +0 -11
  1003. package/dist/utils/clipboard-native.d.ts.map +0 -1
  1004. package/dist/utils/clipboard-native.js +0 -20
  1005. package/dist/utils/clipboard-native.js.map +0 -1
  1006. package/dist/utils/pi-user-agent.d.ts +0 -2
  1007. package/dist/utils/pi-user-agent.d.ts.map +0 -1
  1008. package/dist/utils/pi-user-agent.js +0 -5
  1009. package/dist/utils/pi-user-agent.js.map +0 -1
  1010. package/docs/development.md +0 -71
  1011. package/docs/tree.md +0 -231
  1012. package/examples/extensions/kimi-deferred-tools.ts +0 -61
@@ -7,32 +7,36 @@
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, ToolExecutionMode } from "@draht/agent-core";
11
- import type { Api, AssistantMessageEvent, AssistantMessageEventStream, ConstrainedSamplingConfig, Context, ImageContent, Model, OAuthCredentials, OAuthLoginCallbacks, Provider, ProviderHeaders, RefreshModelsContext, SimpleStreamOptions, TextContent, ToolResultMessage, Usage } from "@draht/ai";
10
+ import type { AgentMessage, AgentTool, AgentToolCallOutcome, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel, ToolExecutionMode } from "@draht/agent-core";
11
+ import type { AnyModel, Api, AssistantMessageEvent, AssistantMessageEventStream, ClassifierApi, ConstrainedSamplingConfig, ImageApi, ImageContent, JsonValue, Message, Model, OAuthCredentials, OAuthLoginCallbacks, Provider, ProviderClassifier, ProviderHeaders, ProviderId, ProviderImages, RefreshModelsContext, SimpleStreamOptions, TextContent, ToolResultMessage, TranscriptContext, Usage } from "@draht/ai";
12
12
  import type { AutocompleteItem, AutocompleteProvider, Component, EditorComponent, EditorTheme, KeyId, OverlayHandle, OverlayOptions, TUI } from "@draht/tui";
13
13
  import type { Static, TSchema } from "typebox";
14
14
  import type { Theme } from "../../modes/interactive/theme/theme.ts";
15
15
  import type { BashResult } from "../bash-executor.ts";
16
+ import type { CacheWarmingDecisionEvent, CacheWarmingDecisionEventResult } from "../cache-warmer.ts";
16
17
  import type { CheckpointCaptureResult, CheckpointManager, CheckpointRecord, CheckpointRestoreOptions, CheckpointRestoreResult } from "../checkpoints/checkpoint-manager.ts";
17
18
  import type { CompactionPreparation, CompactionResult } from "../compaction/index.ts";
18
19
  import type { EventBus } from "../event-bus.ts";
19
20
  import type { ExecOptions, ExecResult } from "../exec.ts";
20
21
  import type { ReadonlyFooterDataProvider } from "../footer-data-provider.ts";
21
22
  import type { KeybindingsManager } from "../keybindings.ts";
23
+ import type { McpServerConfig, McpServerRegistry, RegisteredMcpServer } from "../mcp-servers.ts";
22
24
  import type { CustomMessage } from "../messages.ts";
23
25
  import type { ModelRegistry } from "../model-registry.ts";
24
26
  import type { ScopedModel } from "../model-resolver.ts";
25
27
  import type { RelayOutcome } from "../permission-relay/types.ts";
26
- import type { BranchSummaryEntry, CompactionEntry, CustomEntry, ReadonlySessionManager, SessionEntry, SessionManager } from "../session-manager.ts";
28
+ import type { BranchSummaryEntry, CompactionEntry, ContextEditEntry, CustomEntry, ProjectedSessionEntry, ReadonlySessionManager, SessionEntry, SessionManager } from "../session-manager.ts";
29
+ import type { Settings } from "../settings-manager.ts";
27
30
  import type { SlashCommandInfo } from "../slash-commands.ts";
28
31
  import type { SourceInfo } from "../source-info.ts";
29
- import type { BuildSystemPromptOptions } from "../system-prompt.ts";
32
+ import type { BuildSystemPromptOptions, NormalizedBuildSystemPromptOptions } from "../system-prompt.ts";
30
33
  import type { BashOperations } from "../tools/bash.ts";
31
34
  import type { EditToolDetails } from "../tools/edit.ts";
32
- import type { BashToolDetails, BashToolInput, EditToolInput, FindToolDetails, FindToolInput, GrepToolDetails, GrepToolInput, LsToolDetails, LsToolInput, ReadToolDetails, ReadToolInput, WriteToolInput } from "../tools/index.ts";
35
+ import type { BashToolDetails, BashToolInput, EditToolInput, FindToolDetails, FindToolInput, GrepToolDetails, GrepToolInput, LsToolDetails, LsToolInput, PowerShellToolDetails, PowerShellToolInput, ReadToolDetails, ReadToolInput, WriteToolInput } from "../tools/index.ts";
36
+ import type { ModelRoute, ModelRouteRequest, VirtualModelDefinition } from "../virtual-models.ts";
33
37
  export type { AutocompleteItem } from "@draht/tui";
34
38
  export type { ExecOptions, ExecResult } from "../exec.ts";
35
- export type { BuildSystemPromptOptions } from "../system-prompt.ts";
39
+ export type { BuildSystemPromptOptions, NormalizedBuildSystemPromptOptions } from "../system-prompt.ts";
36
40
  export type { AgentToolResult, AgentToolUpdateCallback, ToolExecutionMode };
37
41
  export type { AppKeybinding, KeybindingsManager } from "../keybindings.ts";
38
42
  /**
@@ -200,8 +204,8 @@ export interface ExtensionUIContext {
200
204
  /** Set a custom footer component, or undefined to restore the built-in footer.
201
205
  *
202
206
  * The factory receives a FooterDataProvider for data not otherwise accessible:
203
- * git branch and extension statuses from setStatus(). Token stats, model info,
204
- * etc. are available via ctx.sessionManager and ctx.model.
207
+ * git branch and extension statuses from setStatus(). Context usage is on
208
+ * ctx.getContextUsage(), token stats on ctx.sessionManager.getEntries(), model info on ctx.model.
205
209
  */
206
210
  setFooter(factory: ((tui: TUI, theme: Theme, footerData: ReadonlyFooterDataProvider) => Component & {
207
211
  dispose?(): void;
@@ -355,6 +359,34 @@ export interface ExtensionContext {
355
359
  /** Get the current effective system prompt. */
356
360
  getSystemPrompt(): string;
357
361
  }
362
+ /** Options for {@link ExtensionToolContext.executeTool}. */
363
+ export interface ExecuteToolOptions {
364
+ /** Defaults to the calling tool's signal. */
365
+ signal?: AbortSignal;
366
+ /** Receives partial results of the nested tool, in addition to `tool_execution_update` events. */
367
+ onUpdate?: AgentToolUpdateCallback;
368
+ }
369
+ /**
370
+ * Context passed to tool `execute()` in a session: the extension context plus `executeTool()`
371
+ * for running other tools through the same validation, hooks, and permission checks as
372
+ * model-issued calls.
373
+ *
374
+ * A tool wrapped with `wrapToolDefinition()` without a context factory, such as a built-in tool
375
+ * created with `createBashTool()` and run in a plain `Agent` or called directly, gets no context.
376
+ */
377
+ export interface ExtensionToolContext extends ExtensionContext {
378
+ /** Tools {@link executeTool} can call. */
379
+ readonly tools: readonly AgentTool[];
380
+ /**
381
+ * Run another tool. The call gets the id `<calling id>/<n>`, and the `tool_call`, `tool_result`,
382
+ * and `tool_execution_*` events carry `parentToolCallId`. It does not appear in the transcript;
383
+ * a bounded record of it is kept as `nestedCalls` on the calling tool's result message.
384
+ *
385
+ * Never rejects for tool failures: unknown tools, validation errors, blocked calls, and thrown
386
+ * errors come back as `isError: true`.
387
+ */
388
+ executeTool(name: string, args: unknown, options?: ExecuteToolOptions): Promise<AgentToolCallOutcome>;
389
+ }
358
390
  /**
359
391
  * Extended context for command handlers.
360
392
  * Includes session control methods only safe in user-initiated commands.
@@ -409,6 +441,7 @@ export interface ReplacedSessionContext extends ExtensionCommandContext {
409
441
  }): Promise<void>;
410
442
  sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
411
443
  deliverAs?: "steer" | "followUp";
444
+ expandPromptTemplates?: boolean;
412
445
  }): Promise<void>;
413
446
  }
414
447
  /** Rendering options for tool results */
@@ -445,6 +478,69 @@ export interface ToolRenderContext<TState = any, TArgs = any> {
445
478
  /** Whether the current result is an error. */
446
479
  isError: boolean;
447
480
  }
481
+ /**
482
+ * How the model reaches a tool. "Callable" means callable from other tools through
483
+ * `ctx.executeTool()`, as the `codemode` tool does.
484
+ *
485
+ * - `direct`: declared to the model while active, and callable while active.
486
+ * - `model-only`: declared to the model while active, never callable. Use it for orchestrating or
487
+ * interactive tools.
488
+ * - `codemode`: callable whenever registered. Not declared to the model unless explicitly
489
+ * activated. Codemode tools list it in their description.
490
+ * - `deferred`: like `codemode`, but codemode tools do not list it; tool search can find it.
491
+ * - `hidden`: registered but unreachable. Activating it has no effect.
492
+ *
493
+ * `direct` and `model-only` tools are activated when they are registered; the others are not.
494
+ * The active tool set (`getActiveTools`/`setActiveTools`) is the set declared to the model.
495
+ */
496
+ export type ToolExposure = "direct" | "model-only" | "codemode" | "deferred" | "hidden";
497
+ /**
498
+ * Hints about what a tool does, with the meaning of MCP tool annotations. They come from the tool's
499
+ * author and are not verified; permission extensions can use them to decide which calls to confirm.
500
+ */
501
+ export interface ToolAnnotations {
502
+ /** The tool does not modify its environment. */
503
+ readOnlyHint?: boolean;
504
+ /** The tool may delete or overwrite data, rather than only add to it. Meaningful when not read-only. */
505
+ destructiveHint?: boolean;
506
+ /** Repeating a call with the same arguments has no further effect. Meaningful when not read-only. */
507
+ idempotentHint?: boolean;
508
+ /** The tool reaches an open world of external entities, such as the web, rather than a closed domain. */
509
+ openWorldHint?: boolean;
510
+ }
511
+ /** A group of related tools, such as the tools of one MCP server. Codemode tools list them together. */
512
+ export interface ToolNamespace {
513
+ /** For example `mcp__docs`. */
514
+ name: string;
515
+ /** Short summary shown once with the group in model-facing tool listings. */
516
+ description?: string;
517
+ /**
518
+ * Longer usage guidance, such as MCP server instructions. Not part of tool listings; tools that
519
+ * describe the namespace on request (codemode's `describeNamespace()`) return it.
520
+ */
521
+ instructions?: string;
522
+ }
523
+ /** The tools of a session as {@link ToolDefinition.prepareLoadout} sees them. */
524
+ export interface ToolLoadout {
525
+ /** Tools declared to the model (the active tools), in order, with their original descriptions. */
526
+ readonly declared: readonly AgentTool[];
527
+ /** Tools callable through `ctx.executeTool()`. */
528
+ readonly callable: readonly AgentTool[];
529
+ /** Every registered tool. */
530
+ readonly registered: readonly AgentTool[];
531
+ getExposure(name: string): ToolExposure;
532
+ getNamespace(name: string): ToolNamespace | undefined;
533
+ }
534
+ /** Changes {@link ToolDefinition.prepareLoadout} makes to what the model sees. */
535
+ export interface ToolLoadoutChanges {
536
+ /** Model-facing descriptions of declared tools, by tool name. */
537
+ descriptions?: Readonly<Record<string, string>>;
538
+ /**
539
+ * Declared tools whose declarations requests leave out. They stay active and callable, and the
540
+ * transcript still declares them, so the active set survives `/tree` and resume.
541
+ */
542
+ hiddenDeclarations?: readonly string[];
543
+ }
448
544
  /**
449
545
  * Tool definition for registerTool().
450
546
  */
@@ -467,6 +563,31 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
467
563
  renderShell?: "default" | "self";
468
564
  /** Optional compatibility shim to prepare raw tool call arguments before schema validation. Must return an object conforming to TParams. */
469
565
  prepareArguments?: (args: unknown) => Static<TParams>;
566
+ /**
567
+ * JSON Schema of `structuredContent` in successful results. Tools that declare it should always
568
+ * set `structuredContent`; codemode scripts then receive it instead of the text content.
569
+ */
570
+ outputSchema?: TSchema;
571
+ /**
572
+ * How the model reaches the tool. Default: `"direct"`. See {@link ToolExposure}.
573
+ */
574
+ exposure?: ToolExposure;
575
+ /** Group the tool belongs to, for example its MCP server. */
576
+ namespace?: ToolNamespace;
577
+ /** Hints about what the tool does, for example from an MCP server. */
578
+ annotations?: ToolAnnotations;
579
+ /**
580
+ * Whether registering the tool activates it. Default: `true` for `direct` and `model-only` tools;
581
+ * other exposures are never activated on registration. A tool with `defaultActive: false` is
582
+ * activated by naming it in `--tools` or the `defaultTools` setting, or with `setActiveTools()`.
583
+ */
584
+ defaultActive?: boolean;
585
+ /**
586
+ * Adjust how the loadout is presented to the model while this tool is active. Called whenever
587
+ * the active tools change. Tools that orchestrate other tools use it, for example to list the
588
+ * callable tools in their own description.
589
+ */
590
+ prepareLoadout?: (loadout: ToolLoadout) => ToolLoadoutChanges | undefined;
470
591
  /**
471
592
  * Per-tool execution mode override.
472
593
  * - "sequential": this tool must execute one at a time with other tool calls.
@@ -476,7 +597,7 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
476
597
  */
477
598
  executionMode?: ToolExecutionMode;
478
599
  /** Execute the tool. */
479
- execute(toolCallId: string, params: Static<TParams>, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<TDetails> | undefined, ctx: ExtensionContext): Promise<AgentToolResult<TDetails>>;
600
+ execute(toolCallId: string, params: Static<TParams>, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<TDetails> | undefined, ctx: ExtensionToolContext): Promise<AgentToolResult<TDetails>>;
480
601
  /** Custom rendering for tool call display */
481
602
  renderCall?: (args: Static<TParams>, theme: Theme, context: ToolRenderContext<TState, Static<TParams>>) => Component;
482
603
  /** Custom rendering for tool result display */
@@ -519,6 +640,17 @@ export interface ResourcesDiscoverResult {
519
640
  promptPaths?: string[];
520
641
  themePaths?: string[];
521
642
  }
643
+ /**
644
+ * Fired when an extension registers or unregisters an MCP server after the extensions are bound
645
+ * (see {@link ExtensionAPI.registerMcpServer}). Servers registered while extensions load are read
646
+ * with `pi.getMcpServers()` on `session_start`. Handling this event marks an extension as the one
647
+ * that connects registered servers.
648
+ */
649
+ export interface McpServersChangeEvent {
650
+ type: "mcp_servers_change";
651
+ /** Every registered server after the change. */
652
+ servers: RegisteredMcpServer[];
653
+ }
522
654
  /** Fired when a session is started, loaded, or reloaded */
523
655
  export interface SessionStartEvent {
524
656
  type: "session_start";
@@ -557,7 +689,7 @@ export interface SessionBeforeCompactEvent {
557
689
  willRetry: boolean;
558
690
  signal: AbortSignal;
559
691
  }
560
- /** Fired after context compaction */
692
+ /** Fired after context compaction succeeds */
561
693
  export interface SessionCompactEvent {
562
694
  type: "session_compact";
563
695
  compactionEntry: CompactionEntry;
@@ -567,6 +699,20 @@ export interface SessionCompactEvent {
567
699
  /** True when the aborted turn is retried after this compaction (overflow recovery) */
568
700
  willRetry: boolean;
569
701
  }
702
+ /** Fired after context compaction fails or is aborted */
703
+ export interface SessionCompactFailedEvent {
704
+ type: "session_compact_failed";
705
+ /** What triggered the compaction: manual /compact, the context threshold, or context overflow recovery */
706
+ reason: "manual" | "threshold" | "overflow";
707
+ /** Error text when compaction failed for a non-abort reason. */
708
+ errorMessage?: string;
709
+ /** True when compaction was cancelled or aborted. */
710
+ aborted: boolean;
711
+ /** True when the aborted turn would have been retried after this compaction (overflow recovery) */
712
+ willRetry: boolean;
713
+ /** True when the failing compaction content came from a session_before_compact handler. */
714
+ fromExtension: boolean;
715
+ }
570
716
  /** Fired before an extension runtime is torn down due to quit, reload, or session replacement. */
571
717
  export interface SessionShutdownEvent {
572
718
  type: "session_shutdown";
@@ -616,17 +762,32 @@ export interface SessionTreeEvent {
616
762
  summaryEntry?: BranchSummaryEntry;
617
763
  fromExtension?: boolean;
618
764
  }
619
- export type SessionEvent = SessionStartEvent | SessionInfoChangedEvent | SessionBeforeSwitchEvent | SessionBeforeForkEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionShutdownEvent | SessionBeforeTreeEvent | SessionBeforeRewindEvent | SessionTreeEvent;
765
+ export type SessionEvent = SessionStartEvent | SessionInfoChangedEvent | SessionBeforeSwitchEvent | SessionBeforeForkEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionCompactFailedEvent | SessionShutdownEvent | SessionBeforeTreeEvent | SessionBeforeRewindEvent | SessionTreeEvent;
620
766
  /** Fired after a working-tree checkpoint has been captured and recorded. */
621
767
  export interface CheckpointCreatedEvent {
622
768
  type: "checkpoint_created";
623
769
  record: CheckpointRecord;
624
770
  }
625
- /** Fired before each LLM call. Can modify messages. */
771
+ /**
772
+ * Fired before each LLM call. Can modify messages.
773
+ *
774
+ * `messages` holds the conversation without system messages. The prompt and tool state
775
+ * belong to Pi: it restores them after the handler returns, so a handler cannot drop
776
+ * them and does not need to preserve them.
777
+ */
626
778
  export interface ContextEvent {
627
779
  type: "context";
628
780
  messages: AgentMessage[];
629
781
  }
782
+ /**
783
+ * Fired before each LLM call, after every `context` handler has run and draht has restored
784
+ * the prompt and tool state. `messages` is the full transcript including system messages,
785
+ * and the result is sent as returned: the handler owns the prompt and tool declarations.
786
+ */
787
+ export interface ContextWithSystemEvent {
788
+ type: "context_with_system";
789
+ messages: AgentMessage[];
790
+ }
630
791
  /** Fired before a provider request is sent. Can replace the payload. */
631
792
  export interface BeforeProviderRequestEvent {
632
793
  type: "before_provider_request";
@@ -647,6 +808,14 @@ export interface AfterProviderResponseEvent {
647
808
  status: number;
648
809
  headers: Record<string, string>;
649
810
  }
811
+ /** Fired for a parsed provider stream event before Pi normalizes it. */
812
+ export interface ProviderStreamEvent {
813
+ type: "provider_stream_event";
814
+ provider: ProviderId;
815
+ api: Api;
816
+ model: string;
817
+ data: unknown;
818
+ }
650
819
  /** Fired after user submits prompt but before agent loop. */
651
820
  export interface BeforeAgentStartEvent {
652
821
  type: "before_agent_start";
@@ -654,10 +823,10 @@ export interface BeforeAgentStartEvent {
654
823
  prompt: string;
655
824
  /** Images attached to the user prompt, if any. */
656
825
  images?: ImageContent[];
657
- /** The fully assembled system prompt string. */
658
- systemPrompt: string;
659
- /** Structured options used to build the system prompt. Extensions can inspect this to understand what Pi loaded without re-discovering resources. */
660
- systemPromptOptions: BuildSystemPromptOptions;
826
+ /** The current system prompt, rendered from systemPromptOptions and earlier handler changes. */
827
+ readonly systemPrompt: string;
828
+ /** Mutable prompt sections. Later handlers observe mutations made by earlier handlers. */
829
+ systemPromptOptions: NormalizedBuildSystemPromptOptions;
661
830
  }
662
831
  /** Fired when an agent loop starts */
663
832
  export interface AgentStartEvent {
@@ -668,10 +837,73 @@ export interface AgentEndEvent {
668
837
  type: "agent_end";
669
838
  messages: AgentMessage[];
670
839
  }
840
+ export type AgentActivityOutcome = "completed" | "aborted" | "error";
841
+ export interface CustomEntryDraft {
842
+ type: "custom";
843
+ customType: string;
844
+ data?: unknown;
845
+ }
846
+ export interface CustomMessageEntryDraft {
847
+ type: "custom_message";
848
+ customType: string;
849
+ content: string | (TextContent | ImageContent)[];
850
+ display: boolean;
851
+ details?: unknown;
852
+ }
853
+ export interface ContextEditEntryDraft {
854
+ type: "context_edit";
855
+ targetId: string;
856
+ replacement: ContextEditEntry["replacement"];
857
+ }
858
+ export interface CompactionEntryDraft {
859
+ type: "compaction";
860
+ summary: string;
861
+ /** Null creates a self-retaining compaction that keeps no preceding entries. */
862
+ firstKeptEntryId: string | null;
863
+ details?: unknown;
864
+ usage?: Usage;
865
+ }
866
+ export type SessionBoundaryDraft = CustomEntryDraft | CustomMessageEntryDraft | ContextEditEntryDraft | CompactionEntryDraft;
867
+ export interface BoundaryContextPreview {
868
+ contextEntries: ProjectedSessionEntry[];
869
+ contextMessages: AgentMessage[];
870
+ llmMessages: Message[];
871
+ pendingMessages: AgentMessage[];
872
+ canContinue: boolean;
873
+ }
874
+ export interface BoundaryState {
875
+ entries: SessionBoundaryDraft[];
876
+ continue: boolean;
877
+ context: BoundaryContextPreview;
878
+ outcome: AgentActivityOutcome;
879
+ }
880
+ export interface BoundaryResult {
881
+ entries?: SessionBoundaryDraft[];
882
+ continue?: boolean;
883
+ }
884
+ /** Fired before final settlement. May append entries and ensure one next provider request. */
885
+ export interface AgentBeforeSettleEvent extends BoundaryState {
886
+ type: "agent_before_settle";
887
+ }
671
888
  /** Fired after an agent run has fully settled and no automatic retry, compaction, or queued continuation will run. */
672
889
  export interface AgentSettledEvent {
673
890
  type: "agent_settled";
674
891
  }
892
+ export type UIPromptKind = "select" | "confirm" | "input" | "editor" | "custom";
893
+ /** Fired when Pi starts waiting on a blocking user-facing extension UI prompt. */
894
+ export interface UIPromptStartEvent {
895
+ type: "ui_prompt_start";
896
+ reason: "ui_prompt";
897
+ kind: UIPromptKind;
898
+ title?: string;
899
+ }
900
+ /** Fired when Pi is no longer waiting on a blocking user-facing extension UI prompt. */
901
+ export interface UIPromptEndEvent {
902
+ type: "ui_prompt_end";
903
+ reason: "ui_prompt";
904
+ kind: UIPromptKind;
905
+ title?: string;
906
+ }
675
907
  /** Fired at the start of each turn */
676
908
  export interface TurnStartEvent {
677
909
  type: "turn_start";
@@ -679,11 +911,13 @@ export interface TurnStartEvent {
679
911
  timestamp: number;
680
912
  }
681
913
  /** Fired at the end of each turn */
682
- export interface TurnEndEvent {
914
+ export interface TurnEndEvent extends BoundaryState {
683
915
  type: "turn_end";
684
916
  turnIndex: number;
685
917
  message: AgentMessage;
686
918
  toolResults: ToolResultMessage[];
919
+ messageEntryId: string;
920
+ toolResultEntryIds: string[];
687
921
  }
688
922
  /** Fired when a message starts (user, assistant, or toolResult) */
689
923
  export interface MessageStartEvent {
@@ -707,6 +941,8 @@ export interface ToolExecutionStartEvent {
707
941
  toolCallId: string;
708
942
  toolName: string;
709
943
  args: any;
944
+ /** Set when another tool (for example a codemode script) made this call. */
945
+ parentToolCallId?: string;
710
946
  }
711
947
  /** Fired during tool execution with partial/streaming output */
712
948
  export interface ToolExecutionUpdateEvent {
@@ -715,6 +951,8 @@ export interface ToolExecutionUpdateEvent {
715
951
  toolName: string;
716
952
  args: any;
717
953
  partialResult: any;
954
+ /** Set when another tool (for example a codemode script) made this call. */
955
+ parentToolCallId?: string;
718
956
  }
719
957
  /** Fired when a tool finishes executing */
720
958
  export interface ToolExecutionEndEvent {
@@ -723,6 +961,8 @@ export interface ToolExecutionEndEvent {
723
961
  toolName: string;
724
962
  result: any;
725
963
  isError: boolean;
964
+ /** Set when another tool (for example a codemode script) made this call. */
965
+ parentToolCallId?: string;
726
966
  }
727
967
  export type ModelSelectSource = "set" | "cycle" | "restore";
728
968
  /** Fired when a new model is selected */
@@ -774,12 +1014,23 @@ export type InputEventResult = {
774
1014
  };
775
1015
  interface ToolCallEventBase {
776
1016
  type: "tool_call";
1017
+ /**
1018
+ * The call's id. For calls another tool made (with `parentToolCallId` set), pi assigns
1019
+ * `<parent id>/<n>`; such ids never appear as tool calls or tool results in the transcript, only
1020
+ * in the parent result's `nestedCalls` record.
1021
+ */
777
1022
  toolCallId: string;
1023
+ /** Set when another tool (for example a codemode script) issued this call. */
1024
+ parentToolCallId?: string;
778
1025
  }
779
1026
  export interface BashToolCallEvent extends ToolCallEventBase {
780
1027
  toolName: "bash";
781
1028
  input: BashToolInput;
782
1029
  }
1030
+ export interface PowerShellToolCallEvent extends ToolCallEventBase {
1031
+ toolName: "powershell";
1032
+ input: PowerShellToolInput;
1033
+ }
783
1034
  export interface ReadToolCallEvent extends ToolCallEventBase {
784
1035
  toolName: "read";
785
1036
  input: ReadToolInput;
@@ -814,12 +1065,20 @@ export interface CustomToolCallEvent extends ToolCallEventBase {
814
1065
  * `event.input` is mutable. Mutate it in place to patch tool arguments before execution.
815
1066
  * Later `tool_call` handlers see earlier mutations. No re-validation is performed after mutation.
816
1067
  */
817
- export type ToolCallEvent = BashToolCallEvent | ReadToolCallEvent | EditToolCallEvent | WriteToolCallEvent | GrepToolCallEvent | FindToolCallEvent | LsToolCallEvent | CustomToolCallEvent;
1068
+ export type ToolCallEvent = BashToolCallEvent | PowerShellToolCallEvent | ReadToolCallEvent | EditToolCallEvent | WriteToolCallEvent | GrepToolCallEvent | FindToolCallEvent | LsToolCallEvent | CustomToolCallEvent;
818
1069
  interface ToolResultEventBase {
819
1070
  type: "tool_result";
1071
+ /** The call's id; `<parent id>/<n>` for nested calls, see `ToolCallEvent`. */
820
1072
  toolCallId: string;
1073
+ /** Set when another tool (for example a codemode script) issued this call. */
1074
+ parentToolCallId?: string;
821
1075
  input: Record<string, unknown>;
822
1076
  content: (TextContent | ImageContent)[];
1077
+ /**
1078
+ * Machine-readable result for tools that declare an `outputSchema`. Handlers that redact
1079
+ * `content` should also replace this; replacing `content` alone drops it.
1080
+ */
1081
+ structuredContent?: JsonValue;
823
1082
  isError: boolean;
824
1083
  /** Usage from the tool execution itself, if available. */
825
1084
  usage?: Usage;
@@ -828,6 +1087,10 @@ export interface BashToolResultEvent extends ToolResultEventBase {
828
1087
  toolName: "bash";
829
1088
  details: BashToolDetails | undefined;
830
1089
  }
1090
+ export interface PowerShellToolResultEvent extends ToolResultEventBase {
1091
+ toolName: "powershell";
1092
+ details: PowerShellToolDetails | undefined;
1093
+ }
831
1094
  export interface ReadToolResultEvent extends ToolResultEventBase {
832
1095
  toolName: "read";
833
1096
  details: ReadToolDetails | undefined;
@@ -857,8 +1120,9 @@ export interface CustomToolResultEvent extends ToolResultEventBase {
857
1120
  details: unknown;
858
1121
  }
859
1122
  /** Fired after a tool executes. Can modify result. */
860
- export type ToolResultEvent = BashToolResultEvent | ReadToolResultEvent | EditToolResultEvent | WriteToolResultEvent | GrepToolResultEvent | FindToolResultEvent | LsToolResultEvent | CustomToolResultEvent;
1123
+ export type ToolResultEvent = BashToolResultEvent | PowerShellToolResultEvent | ReadToolResultEvent | EditToolResultEvent | WriteToolResultEvent | GrepToolResultEvent | FindToolResultEvent | LsToolResultEvent | CustomToolResultEvent;
861
1124
  export declare function isBashToolResult(e: ToolResultEvent): e is BashToolResultEvent;
1125
+ export declare function isPowerShellToolResult(e: ToolResultEvent): e is PowerShellToolResultEvent;
862
1126
  export declare function isReadToolResult(e: ToolResultEvent): e is ReadToolResultEvent;
863
1127
  export declare function isEditToolResult(e: ToolResultEvent): e is EditToolResultEvent;
864
1128
  export declare function isWriteToolResult(e: ToolResultEvent): e is WriteToolResultEvent;
@@ -886,6 +1150,7 @@ export declare function isLsToolResult(e: ToolResultEvent): e is LsToolResultEve
886
1150
  * CustomToolCallEvent.toolName is `string` which overlaps with all literals.
887
1151
  */
888
1152
  export declare function isToolCallEventType(toolName: "bash", event: ToolCallEvent): event is BashToolCallEvent;
1153
+ export declare function isToolCallEventType(toolName: "powershell", event: ToolCallEvent): event is PowerShellToolCallEvent;
889
1154
  export declare function isToolCallEventType(toolName: "read", event: ToolCallEvent): event is ReadToolCallEvent;
890
1155
  export declare function isToolCallEventType(toolName: "edit", event: ToolCallEvent): event is EditToolCallEvent;
891
1156
  export declare function isToolCallEventType(toolName: "write", event: ToolCallEvent): event is WriteToolCallEvent;
@@ -897,11 +1162,14 @@ export declare function isToolCallEventType<TName extends string, TInput extends
897
1162
  input: TInput;
898
1163
  };
899
1164
  /** Union of all event types */
900
- export type ExtensionEvent = ProjectTrustEvent | ResourcesDiscoverEvent | SessionEvent | CheckpointCreatedEvent | ContextEvent | BeforeProviderRequestEvent | BeforeProviderHeadersEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | AgentSettledEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | ModelSelectEvent | ThinkingLevelSelectEvent | UserBashEvent | InputEvent | ToolCallEvent | ToolResultEvent;
1165
+ export type ExtensionEvent = ProjectTrustEvent | ResourcesDiscoverEvent | McpServersChangeEvent | SessionEvent | CheckpointCreatedEvent | ContextEvent | ContextWithSystemEvent | CacheWarmingDecisionEvent | BeforeProviderRequestEvent | BeforeProviderHeadersEvent | AfterProviderResponseEvent | ProviderStreamEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | AgentBeforeSettleEvent | AgentSettledEvent | UIPromptStartEvent | UIPromptEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | ModelSelectEvent | ThinkingLevelSelectEvent | UserBashEvent | InputEvent | ToolCallEvent | ToolResultEvent;
901
1166
  export interface ContextEventResult {
902
1167
  messages?: AgentMessage[];
903
1168
  }
1169
+ export type TurnEndEventResult = BoundaryResult;
1170
+ export type AgentBeforeSettleEventResult = BoundaryResult;
904
1171
  export type BeforeProviderRequestEventResult = unknown;
1172
+ export type { CacheWarmingDecisionEvent, CacheWarmingDecisionEventResult } from "../cache-warmer.ts";
905
1173
  export interface ToolCallEventResult {
906
1174
  /** Block tool execution. To modify arguments, mutate `event.input` in place instead. */
907
1175
  block?: boolean;
@@ -913,15 +1181,24 @@ export interface ToolCallEventResult {
913
1181
  terminate?: boolean;
914
1182
  }
915
1183
  /** Result from user_bash event handler */
916
- export interface UserBashEventResult {
1184
+ export type UserBashEventResult = {
917
1185
  /** Custom operations to use for execution */
918
- operations?: BashOperations;
1186
+ operations: BashOperations;
1187
+ result?: never;
1188
+ } | {
1189
+ operations?: never;
919
1190
  /** Full replacement: extension handled execution, use this result */
920
- result?: BashResult;
921
- }
1191
+ result: BashResult;
1192
+ };
1193
+ /**
1194
+ * Changes a `tool_result` handler makes. Omitted fields stay as they are, except that replacing
1195
+ * `content` without returning `structuredContent` drops the structured content, because it may no
1196
+ * longer match. Return it along with `content` to keep it.
1197
+ */
922
1198
  export interface ToolResultEventResult {
923
1199
  content?: (TextContent | ImageContent)[];
924
1200
  details?: unknown;
1201
+ structuredContent?: JsonValue;
925
1202
  isError?: boolean;
926
1203
  usage?: Usage;
927
1204
  }
@@ -931,7 +1208,7 @@ export interface MessageEndEventResult {
931
1208
  }
932
1209
  export interface BeforeAgentStartEventResult {
933
1210
  message?: Pick<CustomMessage, "customType" | "content" | "display" | "details">;
934
- /** Replace the system prompt for this turn. If multiple extensions return this, they are chained. */
1211
+ /** Replace the complete system prompt for this turn. Later handlers observe this exact override. */
935
1212
  systemPrompt?: string;
936
1213
  }
937
1214
  export interface SessionBeforeSwitchResult {
@@ -967,6 +1244,12 @@ export interface MessageRenderOptions {
967
1244
  /** Horizontal padding configured by the outputPad setting. */
968
1245
  outputPad: number;
969
1246
  }
1247
+ export interface MarkdownTransformContext {
1248
+ messageType: "user" | "assistant" | "assistant-thinking";
1249
+ isStreaming: boolean;
1250
+ availableWidth: number;
1251
+ }
1252
+ export type MarkdownTransformer = (markdown: string, context: MarkdownTransformContext) => string;
970
1253
  export interface EntryRenderOptions {
971
1254
  expanded: boolean;
972
1255
  }
@@ -988,41 +1271,49 @@ export type ExtensionHandler<E, R = undefined> = (event: E, ctx: ExtensionContex
988
1271
  * ExtensionAPI passed to extension factory functions.
989
1272
  */
990
1273
  export interface ExtensionAPI {
991
- on(event: "project_trust", handler: ProjectTrustHandler): void;
992
- on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
993
- on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): void;
994
- on(event: "session_info_changed", handler: ExtensionHandler<SessionInfoChangedEvent>): void;
995
- on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): void;
996
- on(event: "session_before_fork", handler: ExtensionHandler<SessionBeforeForkEvent, SessionBeforeForkResult>): void;
997
- on(event: "session_before_compact", handler: ExtensionHandler<SessionBeforeCompactEvent, SessionBeforeCompactResult>): void;
998
- on(event: "session_compact", handler: ExtensionHandler<SessionCompactEvent>): void;
999
- on(event: "session_shutdown", handler: ExtensionHandler<SessionShutdownEvent>): void;
1000
- on(event: "session_before_tree", handler: ExtensionHandler<SessionBeforeTreeEvent, SessionBeforeTreeResult>): void;
1001
- on(event: "session_before_rewind", handler: ExtensionHandler<SessionBeforeRewindEvent, SessionBeforeRewindResult>): void;
1002
- on(event: "session_tree", handler: ExtensionHandler<SessionTreeEvent>): void;
1003
- on(event: "checkpoint_created", handler: ExtensionHandler<CheckpointCreatedEvent>): void;
1004
- on(event: "context", handler: ExtensionHandler<ContextEvent, ContextEventResult>): void;
1005
- on(event: "before_provider_request", handler: ExtensionHandler<BeforeProviderRequestEvent, BeforeProviderRequestEventResult>): void;
1006
- on(event: "before_provider_headers", handler: ExtensionHandler<BeforeProviderHeadersEvent>): void;
1007
- on(event: "after_provider_response", handler: ExtensionHandler<AfterProviderResponseEvent>): void;
1008
- on(event: "before_agent_start", handler: ExtensionHandler<BeforeAgentStartEvent, BeforeAgentStartEventResult>): void;
1009
- on(event: "agent_start", handler: ExtensionHandler<AgentStartEvent>): void;
1010
- on(event: "agent_end", handler: ExtensionHandler<AgentEndEvent>): void;
1011
- on(event: "agent_settled", handler: ExtensionHandler<AgentSettledEvent>): void;
1012
- on(event: "turn_start", handler: ExtensionHandler<TurnStartEvent>): void;
1013
- on(event: "turn_end", handler: ExtensionHandler<TurnEndEvent>): void;
1014
- on(event: "message_start", handler: ExtensionHandler<MessageStartEvent>): void;
1015
- on(event: "message_update", handler: ExtensionHandler<MessageUpdateEvent>): void;
1016
- on(event: "message_end", handler: ExtensionHandler<MessageEndEvent, MessageEndEventResult>): void;
1017
- on(event: "tool_execution_start", handler: ExtensionHandler<ToolExecutionStartEvent>): void;
1018
- on(event: "tool_execution_update", handler: ExtensionHandler<ToolExecutionUpdateEvent>): void;
1019
- on(event: "tool_execution_end", handler: ExtensionHandler<ToolExecutionEndEvent>): void;
1020
- on(event: "model_select", handler: ExtensionHandler<ModelSelectEvent>): void;
1021
- on(event: "thinking_level_select", handler: ExtensionHandler<ThinkingLevelSelectEvent>): void;
1022
- on(event: "tool_call", handler: ExtensionHandler<ToolCallEvent, ToolCallEventResult>): void;
1023
- on(event: "tool_result", handler: ExtensionHandler<ToolResultEvent, ToolResultEventResult>): void;
1024
- on(event: "user_bash", handler: ExtensionHandler<UserBashEvent, UserBashEventResult>): void;
1025
- on(event: "input", handler: ExtensionHandler<InputEvent, InputEventResult>): void;
1274
+ on(event: "project_trust", handler: ProjectTrustHandler): () => void;
1275
+ on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): () => void;
1276
+ on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): () => void;
1277
+ on(event: "session_info_changed", handler: ExtensionHandler<SessionInfoChangedEvent>): () => void;
1278
+ on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): () => void;
1279
+ on(event: "session_before_fork", handler: ExtensionHandler<SessionBeforeForkEvent, SessionBeforeForkResult>): () => void;
1280
+ on(event: "session_before_compact", handler: ExtensionHandler<SessionBeforeCompactEvent, SessionBeforeCompactResult>): () => void;
1281
+ on(event: "session_compact", handler: ExtensionHandler<SessionCompactEvent>): () => void;
1282
+ on(event: "session_compact_failed", handler: ExtensionHandler<SessionCompactFailedEvent>): () => void;
1283
+ on(event: "session_shutdown", handler: ExtensionHandler<SessionShutdownEvent>): () => void;
1284
+ on(event: "mcp_servers_change", handler: ExtensionHandler<McpServersChangeEvent>): () => void;
1285
+ on(event: "session_before_tree", handler: ExtensionHandler<SessionBeforeTreeEvent, SessionBeforeTreeResult>): () => void;
1286
+ on(event: "session_before_rewind", handler: ExtensionHandler<SessionBeforeRewindEvent, SessionBeforeRewindResult>): () => void;
1287
+ on(event: "session_tree", handler: ExtensionHandler<SessionTreeEvent>): () => void;
1288
+ on(event: "checkpoint_created", handler: ExtensionHandler<CheckpointCreatedEvent>): () => void;
1289
+ on(event: "context", handler: ExtensionHandler<ContextEvent, ContextEventResult>): () => void;
1290
+ on(event: "context_with_system", handler: ExtensionHandler<ContextWithSystemEvent, ContextEventResult>): () => void;
1291
+ on(event: "cache_warming_decision", handler: ExtensionHandler<CacheWarmingDecisionEvent, CacheWarmingDecisionEventResult>): () => void;
1292
+ on(event: "before_provider_request", handler: ExtensionHandler<BeforeProviderRequestEvent, BeforeProviderRequestEventResult>): () => void;
1293
+ on(event: "before_provider_headers", handler: ExtensionHandler<BeforeProviderHeadersEvent>): () => void;
1294
+ on(event: "after_provider_response", handler: ExtensionHandler<AfterProviderResponseEvent>): () => void;
1295
+ on(event: "provider_stream_event", handler: ExtensionHandler<ProviderStreamEvent>): () => void;
1296
+ on(event: "before_agent_start", handler: ExtensionHandler<BeforeAgentStartEvent, BeforeAgentStartEventResult>): () => void;
1297
+ on(event: "agent_start", handler: ExtensionHandler<AgentStartEvent>): () => void;
1298
+ on(event: "agent_end", handler: ExtensionHandler<AgentEndEvent>): () => void;
1299
+ on(event: "agent_before_settle", handler: ExtensionHandler<AgentBeforeSettleEvent, AgentBeforeSettleEventResult>): () => void;
1300
+ on(event: "agent_settled", handler: ExtensionHandler<AgentSettledEvent>): () => void;
1301
+ on(event: "ui_prompt_start", handler: ExtensionHandler<UIPromptStartEvent>): () => void;
1302
+ on(event: "ui_prompt_end", handler: ExtensionHandler<UIPromptEndEvent>): () => void;
1303
+ on(event: "turn_start", handler: ExtensionHandler<TurnStartEvent>): () => void;
1304
+ on(event: "turn_end", handler: ExtensionHandler<TurnEndEvent, TurnEndEventResult>): () => void;
1305
+ on(event: "message_start", handler: ExtensionHandler<MessageStartEvent>): () => void;
1306
+ on(event: "message_update", handler: ExtensionHandler<MessageUpdateEvent>): () => void;
1307
+ on(event: "message_end", handler: ExtensionHandler<MessageEndEvent, MessageEndEventResult>): () => void;
1308
+ on(event: "tool_execution_start", handler: ExtensionHandler<ToolExecutionStartEvent>): () => void;
1309
+ on(event: "tool_execution_update", handler: ExtensionHandler<ToolExecutionUpdateEvent>): () => void;
1310
+ on(event: "tool_execution_end", handler: ExtensionHandler<ToolExecutionEndEvent>): () => void;
1311
+ on(event: "model_select", handler: ExtensionHandler<ModelSelectEvent>): () => void;
1312
+ on(event: "thinking_level_select", handler: ExtensionHandler<ThinkingLevelSelectEvent>): () => void;
1313
+ on(event: "tool_call", handler: ExtensionHandler<ToolCallEvent, ToolCallEventResult>): () => void;
1314
+ on(event: "tool_result", handler: ExtensionHandler<ToolResultEvent, ToolResultEventResult>): () => void;
1315
+ on(event: "user_bash", handler: ExtensionHandler<UserBashEvent, UserBashEventResult>): () => void;
1316
+ on(event: "input", handler: ExtensionHandler<InputEvent, InputEventResult>): () => void;
1026
1317
  /** Register a tool that the LLM can call. */
1027
1318
  registerTool<TParams extends TSchema = TSchema, TDetails = unknown, TState = any>(tool: ToolDefinition<TParams, TDetails, TState>): void;
1028
1319
  /** Register a custom command. */
@@ -1035,13 +1326,19 @@ export interface ExtensionAPI {
1035
1326
  /** Register a CLI flag. */
1036
1327
  registerFlag(name: string, options: {
1037
1328
  description?: string;
1038
- type: "boolean" | "string";
1039
- default?: boolean | string;
1329
+ type: "boolean";
1330
+ default?: boolean;
1331
+ } | {
1332
+ description?: string;
1333
+ type: "string";
1334
+ default?: string;
1040
1335
  }): void;
1041
1336
  /** Get the value of a registered CLI flag. */
1042
1337
  getFlag(name: string): boolean | string | undefined;
1043
1338
  /** Register a custom renderer for CustomMessageEntry. */
1044
1339
  registerMessageRenderer<T = unknown>(customType: string, renderer: MessageRenderer<T>): void;
1340
+ /** Register a transformer for user and assistant Markdown before Pi renders it in the interactive transcript. */
1341
+ registerMarkdownTransformer(transformer: MarkdownTransformer): void;
1045
1342
  /** Register a custom renderer for CustomEntry. Custom entries do not participate in LLM context. */
1046
1343
  registerEntryRenderer<T = unknown>(customType: string, renderer: EntryRenderer<T>): void;
1047
1344
  /** Send a custom message to the session. */
@@ -1052,9 +1349,11 @@ export interface ExtensionAPI {
1052
1349
  /**
1053
1350
  * Send a user message to the agent. Always triggers a turn.
1054
1351
  * When the agent is streaming, use deliverAs to specify how to queue the message.
1352
+ * Set expandPromptTemplates to dispatch extension commands and expand skill commands and prompt templates.
1055
1353
  */
1056
1354
  sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
1057
1355
  deliverAs?: "steer" | "followUp";
1356
+ expandPromptTemplates?: boolean;
1058
1357
  }): void;
1059
1358
  /** Append a custom entry to the session for state persistence (not sent to LLM). */
1060
1359
  appendEntry<T = unknown>(customType: string, data?: T): void;
@@ -1066,19 +1365,30 @@ export interface ExtensionAPI {
1066
1365
  setLabel(entryId: string, label: string | undefined): void;
1067
1366
  /** Execute a shell command. */
1068
1367
  exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
1069
- /** Get the list of currently active tool names. */
1368
+ /** Get the names of the active tools, which are the tools declared to the model. */
1070
1369
  getActiveTools(): string[];
1071
- /** Get all configured tools with parameter schema, prompt guidelines, and source metadata. */
1370
+ /** Get all configured tools with parameter schema, prompt guidelines, exposure, and source metadata. */
1072
1371
  getAllTools(): ToolInfo[];
1073
- /** Set the active tools by name. */
1372
+ /** Get a copy of the effective settings (global and project settings merged, with overrides). */
1373
+ getSettings(): Settings;
1374
+ /**
1375
+ * Set the active tools by name. Unknown and `hidden` tools are ignored. Tools with `codemode` or
1376
+ * `deferred` exposure stay callable from codemode scripts whether active or not.
1377
+ */
1074
1378
  setActiveTools(toolNames: string[]): void;
1075
1379
  /** Get available slash commands in the current session. */
1076
1380
  getCommands(): SlashCommandInfo[];
1077
- /** Set the current model. Returns false if no API key available. */
1381
+ /**
1382
+ * Set the model for the current session. By default the configured default for new sessions is unchanged;
1383
+ * pass `{ persist: true }` to also update it. Returns false if authentication is not configured for the model's provider.
1384
+ */
1078
1385
  setModel(model: Model<any>, options?: ModelSelectionOptions): Promise<boolean>;
1079
1386
  /** Get current thinking level. */
1080
1387
  getThinkingLevel(): ThinkingLevel;
1081
- /** Set thinking level (clamped to model capabilities). */
1388
+ /**
1389
+ * Set the thinking level (clamped to model capabilities) for the current session. By default the configured default
1390
+ * for new sessions is unchanged; pass `{ persist: true }` to also update it.
1391
+ */
1082
1392
  setThinkingLevel(level: ThinkingLevel, options?: ThinkingLevelSelectionOptions): void;
1083
1393
  /**
1084
1394
  * Register or override a model provider.
@@ -1148,6 +1458,37 @@ export interface ExtensionAPI {
1148
1458
  * pi.unregisterProvider("my-proxy");
1149
1459
  */
1150
1460
  unregisterProvider(name: string): void;
1461
+ /**
1462
+ * Register an MCP server for this session, with the same config as an `mcpServers` entry in
1463
+ * `mcp.json`. The server connects next to the configured servers: on `session_start` when
1464
+ * registered during extension load, right away when registered later. Registering a name again
1465
+ * replaces the extension's earlier registration.
1466
+ *
1467
+ * The registration is not saved; register again on every load. A server of the same name in
1468
+ * `mcp.json` takes precedence. Throws for invalid configs and for names another extension
1469
+ * registered. When no loaded extension handles MCP servers (for example because another MCP
1470
+ * extension replaced the built-in one), the registration is reported as an extension error.
1471
+ *
1472
+ * @example
1473
+ * pi.registerMcpServer("jira", { url: "https://mcp.example.com/jira" });
1474
+ */
1475
+ registerMcpServer(name: string, config: McpServerConfig): void;
1476
+ /** Remove an MCP server this extension registered and close its connection. */
1477
+ unregisterMcpServer(name: string): void;
1478
+ /** Every MCP server registered by extensions. For extensions that connect MCP servers. */
1479
+ getMcpServers(): RegisteredMcpServer[];
1480
+ /**
1481
+ * Register a virtual model: a selectable catalog entry that routes each request to a physical
1482
+ * model. The selection (`ctx.model`, `model_change` entries) names the virtual model; assistant
1483
+ * messages record the physical model and thinking level the router picked.
1484
+ *
1485
+ * `provider` may be any provider id, including one with physical models, and may list several
1486
+ * virtual models. Registering the same provider and id again replaces the virtual model. See
1487
+ * docs/virtual-models.md.
1488
+ */
1489
+ registerVirtualModel<TState = unknown>(model: ExtensionVirtualModel<TState>): void;
1490
+ /** Remove a virtual model registered with `registerVirtualModel()`. */
1491
+ unregisterVirtualModel(provider: string, id: string): void;
1151
1492
  /** Shared event bus for extension communication. */
1152
1493
  events: EventBus;
1153
1494
  /** Working-tree checkpoints for the current session (R42-RWD.8). */
@@ -1167,7 +1508,8 @@ export interface ExtensionCheckpointsAPI {
1167
1508
  /**
1168
1509
  * Restore the working tree to an entry's checkpoint, taking a pre-rewind
1169
1510
  * safety snapshot first and rolling back to it on failure. Never throws:
1170
- * the outcome is on the returned status.
1511
+ * the outcome is on the returned status. Writes are NUL-safe batches;
1512
+ * `onPathsRestored` reports each completed batch and each individual delete.
1171
1513
  */
1172
1514
  restore(options: CheckpointRestoreOptions): Promise<CheckpointRestoreResult>;
1173
1515
  /**
@@ -1181,6 +1523,11 @@ export interface ExtensionCheckpointsAPI {
1181
1523
  */
1182
1524
  capture(entryId: string): Promise<CheckpointCaptureResult>;
1183
1525
  }
1526
+ /** Virtual model registered via pi.registerVirtualModel(). */
1527
+ export interface ExtensionVirtualModel<TState = unknown> extends Omit<VirtualModelDefinition<TState>, "route"> {
1528
+ /** Like `VirtualModelDefinition.route`, with an extension context. */
1529
+ route(request: ModelRouteRequest<TState>, ctx: ExtensionContext): ModelRoute<TState> | Promise<ModelRoute<TState>>;
1530
+ }
1184
1531
  /** Configuration for registering a provider via pi.registerProvider(). */
1185
1532
  export interface ProviderConfig {
1186
1533
  /** Display name for the provider in UI. */
@@ -1191,8 +1538,21 @@ export interface ProviderConfig {
1191
1538
  apiKey?: string;
1192
1539
  /** API type. Required at provider or model level when defining models. */
1193
1540
  api?: Api;
1194
- /** Optional streamSimple handler for custom APIs. */
1195
- streamSimple?: (model: Model<Api>, context: Context, options?: SimpleStreamOptions) => AssistantMessageEventStream;
1541
+ /**
1542
+ * Optional streamSimple handler for custom APIs.
1543
+ * The context is a normalized transcript: read the prompt and tools from its system messages
1544
+ * (`getCurrentSystemPrompt(context.messages)`, `getCurrentTools(context.messages)`).
1545
+ * Implementations must invoke `options.onPayload` before sending the provider request and use any
1546
+ * returned replacement payload. They must invoke `options.onResponse` after receiving the response
1547
+ * and before consuming its body, matching built-in providers. Implementations may invoke
1548
+ * `options.onProviderStreamEvent(data, model)` with parsed stream events before normalization.
1549
+ * Event data is adapter-owned and must be treated as read-only.
1550
+ */
1551
+ streamSimple?: (model: Model<Api>, context: TranscriptContext, options?: SimpleStreamOptions) => AssistantMessageEventStream;
1552
+ /** Image-generation implementations keyed by image API. */
1553
+ images?: Partial<Record<ImageApi, ProviderImages>>;
1554
+ /** Classifier implementations keyed by classifier API. */
1555
+ classifiers?: Partial<Record<ClassifierApi, ProviderClassifier>>;
1196
1556
  /** Custom headers to include in requests. */
1197
1557
  headers?: Record<string, string>;
1198
1558
  /** If true, adds Authorization: Bearer header with the resolved API key. */
@@ -1201,60 +1561,105 @@ export interface ProviderConfig {
1201
1561
  models?: ProviderModelConfig[];
1202
1562
  /**
1203
1563
  * Refresh this provider's model list. The returned list replaces extension-provided models.
1204
- * Use context.store explicitly when the catalog should persist across sessions.
1564
+ * Use context.publish({ persist: entry }) when the catalog should persist across sessions.
1205
1565
  */
1206
1566
  refreshModels?(context: RefreshModelsContext): Promise<ProviderModelConfig[]>;
1207
1567
  /** OAuth provider for /login support. The `id` is set automatically from the provider name. */
1208
1568
  oauth?: {
1209
1569
  /** Display name for the provider in login UI. */
1210
1570
  name: string;
1571
+ /** Whether access through this auth method is backed by a provider subscription. */
1572
+ isSubscription?: boolean;
1211
1573
  /** @deprecated Retained for source compatibility; canonical auth flows ignore it. */
1212
1574
  usesCallbackServer?: boolean;
1213
1575
  /** Run the login flow, return credentials to persist. */
1214
1576
  login(callbacks: OAuthLoginCallbacks): Promise<OAuthCredentials>;
1215
1577
  /** Refresh expired credentials, return updated credentials to persist. */
1216
- refreshToken(credentials: OAuthCredentials): Promise<OAuthCredentials>;
1578
+ refreshToken(credentials: OAuthCredentials, signal: AbortSignal): Promise<OAuthCredentials>;
1217
1579
  /** Convert credentials to API key string for the provider. */
1218
1580
  getApiKey(credentials: OAuthCredentials): string;
1219
1581
  /** Legacy synchronous credential-dependent model projection. */
1220
1582
  modifyModels?(models: Model<Api>[], credentials: OAuthCredentials): Model<Api>[];
1221
1583
  };
1222
1584
  }
1223
- /** Configuration for a model within a provider. */
1224
- export interface ProviderModelConfig {
1225
- /** Model ID (e.g., "claude-sonnet-4-20250514"). */
1585
+ interface ProviderModelConfigBase {
1586
+ /** Model ID. */
1226
1587
  id: string;
1227
- /** Display name (e.g., "Claude 4 Sonnet"). */
1588
+ /** Display name. */
1228
1589
  name: string;
1229
1590
  /** API type override for this model. */
1230
- api?: Api;
1591
+ api?: string;
1231
1592
  /** API endpoint URL override for this model. */
1232
1593
  baseUrl?: string;
1594
+ /** Supported input types. */
1595
+ input: ("text" | "image")[];
1596
+ /** Provider input limits and cache-safe image preprocessing metadata. */
1597
+ inputLimits?: AnyModel["inputLimits"];
1598
+ /** Per-million-token cost rates and optional request-wide input pricing tiers. */
1599
+ cost: AnyModel["cost"];
1600
+ /** Custom headers for this model. */
1601
+ headers?: Record<string, string>;
1602
+ }
1603
+ /** Chat model configuration. Omitted `type` is normalized to `"chat"`. */
1604
+ export interface ProviderChatModelConfig extends ProviderModelConfigBase {
1605
+ type?: "chat";
1606
+ api?: Api;
1233
1607
  /** Whether the model supports extended thinking. */
1234
1608
  reasoning: boolean;
1235
1609
  /** Maps pi thinking levels to provider/model-specific values; null marks a level unsupported. */
1236
1610
  thinkingLevelMap?: Model<Api>["thinkingLevelMap"];
1237
- /** Supported input types. */
1238
- input: ("text" | "image")[];
1239
- /** Per-million-token cost rates and optional request-wide input pricing tiers. */
1240
- cost: Model<Api>["cost"];
1611
+ /** Best-effort prompt cache lifetime in seconds per retention tier. Unset disables cache warming. */
1612
+ promptCache?: Model<Api>["promptCache"];
1241
1613
  /** Maximum context window size in tokens. */
1242
1614
  contextWindow: number;
1243
1615
  /** Maximum output tokens. */
1244
1616
  maxTokens: number;
1245
- /** Custom headers for this model. */
1246
- headers?: Record<string, string>;
1617
+ samplingParams?: Record<string, unknown>;
1247
1618
  /** OpenAI compatibility settings. */
1248
1619
  compat?: Model<Api>["compat"];
1249
1620
  }
1621
+ /** Image-generation model configuration. */
1622
+ export interface ProviderImageModelConfig extends ProviderModelConfigBase {
1623
+ type: "image";
1624
+ api?: ImageApi;
1625
+ output: ("text" | "image")[];
1626
+ }
1627
+ /** Structured classifier model configuration. */
1628
+ export interface ProviderClassifierModelConfig extends ProviderModelConfigBase {
1629
+ type: "classifier";
1630
+ api?: ClassifierApi;
1631
+ contextWindow: number;
1632
+ }
1633
+ /** Configuration for a model within a provider. */
1634
+ export type ProviderModelConfig = ProviderChatModelConfig | ProviderImageModelConfig | ProviderClassifierModelConfig;
1250
1635
  /** Extension factory function type. Supports both sync and async initialization. */
1251
1636
  export type ExtensionFactory = (pi: ExtensionAPI) => void | Promise<void>;
1252
1637
  export type InlineExtension = ExtensionFactory | {
1253
- /** Display name shown as `<inline:name>` in the startup Extensions list. */
1638
+ /**
1639
+ * Display name shown as `<inline:name>` in the startup Extensions list and errors. With
1640
+ * `builtin`, the extension is named `builtin:name` in errors and diagnostics.
1641
+ */
1254
1642
  name: string;
1255
1643
  factory: ExtensionFactory;
1256
1644
  /** Omit this extension from the startup Extensions list. */
1257
1645
  hidden?: boolean;
1646
+ /**
1647
+ * Leave this extension out when another extension registers a tool, command, or flag with a
1648
+ * name it registers during loading, instead of reporting a conflict. The CLI's built-in MCP,
1649
+ * codemode, and tool search extensions use it, so for example an MCP extension that registers
1650
+ * `/mcp` replaces the built-in MCP support. The factory still runs, so it should only register
1651
+ * tools, commands, flags, and event handlers.
1652
+ */
1653
+ replaceable?: boolean;
1654
+ /**
1655
+ * Supply the code of the `builtin:<name>` extension instead of loading as an inline extension.
1656
+ * `builtin:<name>` is an extension resource like a file: it loads by default, `draht config` lists
1657
+ * it, `-builtin:<name>` in the `extensions` setting and `--no-extensions` disable it, and
1658
+ * `-e builtin:<name>` loads it explicitly. It is hidden from the startup Extensions list and
1659
+ * loads after project trust is resolved, so it cannot handle `project_trust`. The CLI's built-in
1660
+ * extensions use it.
1661
+ */
1662
+ builtin?: boolean;
1258
1663
  };
1259
1664
  export interface RegisteredTool {
1260
1665
  definition: ToolDefinition;
@@ -1280,6 +1685,7 @@ export type SendMessageHandler = <T = unknown>(message: Pick<CustomMessage<T>, "
1280
1685
  }) => void;
1281
1686
  export type SendUserMessageHandler = (content: string | (TextContent | ImageContent)[], options?: {
1282
1687
  deliverAs?: "steer" | "followUp";
1688
+ expandPromptTemplates?: boolean;
1283
1689
  }) => void;
1284
1690
  export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) => void;
1285
1691
  export type SetSessionNameHandler = (name: string) => void;
@@ -1287,19 +1693,23 @@ export type GetSessionNameHandler = () => string | undefined;
1287
1693
  export type GetActiveToolsHandler = () => string[];
1288
1694
  /** Tool info with name, description, parameter schema, prompt guidelines, and source metadata. */
1289
1695
  export type ToolInfo = Pick<ToolDefinition, "name" | "description" | "parameters" | "promptGuidelines"> & {
1696
+ exposure: ToolExposure;
1697
+ namespace?: ToolNamespace;
1698
+ annotations?: ToolAnnotations;
1290
1699
  sourceInfo: SourceInfo;
1291
1700
  };
1292
1701
  export type GetAllToolsHandler = () => ToolInfo[];
1702
+ export type GetSettingsHandler = () => Settings;
1293
1703
  export type GetCommandsHandler = () => SlashCommandInfo[];
1294
1704
  export type SetActiveToolsHandler = (toolNames: string[]) => void;
1295
1705
  export type RefreshToolsHandler = () => void;
1296
1706
  export interface ModelSelectionOptions {
1297
- /** Whether to update the global default model. Defaults to true. */
1298
- persistDefault?: boolean;
1707
+ /** Whether to update the global default model. Defaults to false (session-scoped). */
1708
+ persist?: boolean;
1299
1709
  }
1300
1710
  export interface ThinkingLevelSelectionOptions {
1301
- /** Whether to update the global default thinking level. Defaults to true. */
1302
- persistDefault?: boolean;
1711
+ /** Whether to update the global default thinking level. Defaults to false (session-scoped). */
1712
+ persist?: boolean;
1303
1713
  }
1304
1714
  export type SetModelHandler = (model: Model<any>, options?: ModelSelectionOptions) => Promise<boolean>;
1305
1715
  export type GetThinkingLevelHandler = () => ThinkingLevel;
@@ -1328,6 +1738,13 @@ export interface ExtensionRuntimeState {
1328
1738
  * session has no file to hang a checkpoint sidecar off.
1329
1739
  */
1330
1740
  getCheckpointManager: () => CheckpointManager | undefined;
1741
+ /** Virtual model registrations queued during extension loading, processed when runner binds. */
1742
+ pendingVirtualModelRegistrations: Array<{
1743
+ definition: VirtualModelDefinition;
1744
+ extensionPath: string;
1745
+ }>;
1746
+ /** Create an extension context. Throws before the runner binds. */
1747
+ createContext: () => ExtensionContext;
1331
1748
  /** Throws when this extension instance is stale after runtime replacement. */
1332
1749
  assertActive: () => void;
1333
1750
  /** Marks this extension instance as stale after runtime replacement or reload. */
@@ -1343,6 +1760,10 @@ export interface ExtensionRuntimeState {
1343
1760
  registerProvider: (name: string, config: ProviderConfig, extensionPath?: string) => void;
1344
1761
  registerNativeProvider: (provider: Provider, extensionPath?: string) => void;
1345
1762
  unregisterProvider: (name: string, extensionPath?: string) => void;
1763
+ /** Servers registered with `pi.registerMcpServer()`. */
1764
+ mcpServers: McpServerRegistry;
1765
+ registerVirtualModel: (definition: VirtualModelDefinition, extensionPath?: string) => void;
1766
+ unregisterVirtualModel: (provider: string, id: string) => void;
1346
1767
  }
1347
1768
  /**
1348
1769
  * Action implementations for pi.* API methods.
@@ -1357,6 +1778,7 @@ export interface ExtensionActions {
1357
1778
  setLabel: SetLabelHandler;
1358
1779
  getActiveTools: GetActiveToolsHandler;
1359
1780
  getAllTools: GetAllToolsHandler;
1781
+ getSettings: GetSettingsHandler;
1360
1782
  setActiveTools: SetActiveToolsHandler;
1361
1783
  refreshTools: RefreshToolsHandler;
1362
1784
  getCommands: GetCommandsHandler;
@@ -1381,6 +1803,10 @@ export interface ExtensionContextActions {
1381
1803
  compact: (options?: CompactOptions) => void;
1382
1804
  getSystemPrompt: () => string;
1383
1805
  getSystemPromptOptions?: () => BuildSystemPromptOptions;
1806
+ /** Backs `ExtensionToolContext.executeTool()`. Without it, nested calls fail. */
1807
+ executeTool?: (callerId: string, name: string, args: unknown, options: ExecuteToolOptions) => Promise<AgentToolCallOutcome>;
1808
+ /** Backs `ExtensionToolContext.tools`. */
1809
+ getCallableTools?: () => readonly AgentTool[];
1384
1810
  }
1385
1811
  /**
1386
1812
  * Actions for ExtensionCommandContext (ctx.* in command handlers).
@@ -1427,10 +1853,13 @@ export interface Extension {
1427
1853
  path: string;
1428
1854
  resolvedPath: string;
1429
1855
  hidden?: boolean;
1856
+ /** See {@link InlineExtension}. */
1857
+ replaceable?: boolean;
1430
1858
  sourceInfo: SourceInfo;
1431
1859
  handlers: Map<string, HandlerFn[]>;
1432
1860
  tools: Map<string, RegisteredTool>;
1433
1861
  messageRenderers: Map<string, MessageRenderer>;
1862
+ markdownTransformer?: MarkdownTransformer;
1434
1863
  entryRenderers?: Map<string, EntryRenderer>;
1435
1864
  commands: Map<string, RegisteredCommand>;
1436
1865
  flags: Map<string, ExtensionFlag>;
@@ -1443,6 +1872,10 @@ export interface LoadExtensionsResult {
1443
1872
  path: string;
1444
1873
  error: string;
1445
1874
  }>;
1875
+ warnings?: Array<{
1876
+ path: string;
1877
+ warning: string;
1878
+ }>;
1446
1879
  /** Shared runtime - actions are throwing stubs until runner.initialize() */
1447
1880
  runtime: ExtensionRuntime;
1448
1881
  }