@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
package/docs/packages.md CHANGED
@@ -1,227 +1,131 @@
1
- > draht can help you create draht packages. Ask it to bundle your extensions, skills, prompt templates, or themes.
2
-
3
1
  # draht Packages
4
2
 
5
- draht packages bundle extensions, skills, prompt templates, and themes so you can share them through npm or git. A package can declare resources in `package.json` under the `draht` key, or use conventional directories.
6
-
7
- ## Table of Contents
3
+ draht packages install and distribute extensions, skills, prompt templates, and themes as one unit. Use a package when a customization should be shared through npm or git, or when several resources belong together.
8
4
 
9
- - [Install and Manage](#install-and-manage)
10
- - [Package Sources](#package-sources)
11
- - [Creating a draht Package](#creating-a-draht-package)
12
- - [Package Structure](#package-structure)
13
- - [Dependencies](#dependencies)
14
- - [Package Filtering](#package-filtering)
15
- - [Enable and Disable Resources](#enable-and-disable-resources)
16
- - [Scope and Deduplication](#scope-and-deduplication)
5
+ A package is an ordinary directory or npm package. It can expose conventional resource directories, declare explicit paths under the `draht` key in `package.json`, and carry its own runtime dependencies.
17
6
 
18
- ## Install and Manage
7
+ ## Install and manage packages
19
8
 
20
- > **Security:** draht packages run with full system access. Extensions execute arbitrary code, and skills can instruct the model to perform any action including running executables. Review source code before installing third-party packages.
9
+ Install from npm, git, or a local path:
21
10
 
22
11
  ```bash
23
- draht install npm:@foo/bar@1.0.0
24
- draht install git:github.com/user/repo@v1
25
- draht install https://github.com/user/repo # raw URLs work too
26
- draht install /absolute/path/to/package
27
- draht install ./relative/path/to/package
28
-
29
- draht remove npm:@foo/bar
30
- draht list # show installed packages from settings
31
- draht update # update draht, update packages, and reconcile pinned git refs
32
- draht update --extensions # update packages and reconcile pinned git refs only
33
- draht update --models # refresh model catalogs only
34
- draht update --self # update draht only
35
- draht update --self --force # reinstall draht even if current
36
- draht update npm:@foo/bar # update one package
37
- draht update --extension npm:@foo/bar
38
- ```
39
-
40
- These commands manage draht packages, not the draht CLI installation. To uninstall draht itself, see [Quickstart](quickstart.md#uninstall).
41
-
42
- By default, `install` and `remove` write to user settings (`~/.draht/agent/settings.json`). Use `-l` to write to project settings (`.draht/settings.json`) instead. Project settings can be shared with your team, and draht installs any missing packages automatically on startup after the project is trusted.
43
-
44
- To try a package without installing it, use `--extension` or `-e`. This installs to a temporary directory for the current run only:
45
-
46
- ```bash
47
- draht -e npm:@foo/bar
48
- draht -e git:github.com/user/repo
49
- ```
50
-
51
- ## Package Sources
52
-
53
- draht accepts three source types in settings and `draht install`.
54
-
55
- ### npm
56
-
57
- ```
58
- npm:@scope/pkg@1.2.3
59
- npm:pkg
12
+ draht install npm:@example/my-tools@1.0.0
13
+ draht install git:github.com/example/my-tools@v1
14
+ draht install ./local-package
60
15
  ```
61
16
 
62
- - Versioned specs are pinned and skipped by package updates (`draht update`, `draht update --extensions`).
63
- - User installs go under `~/.draht/agent/npm/`.
64
- - Project installs go under `.draht/npm/`.
65
- - Set `npmCommand` in `settings.json` to pin npm package lookup and install operations to a specific wrapper command such as `mise` or `asdf`.
17
+ `draht list` shows configured packages. Use `draht remove <source>` to remove one and `draht update --extensions` to reconcile package installations. See [Command Line](cli.md#package-commands) for every package command and option.
66
18
 
67
- Example:
19
+ Personal installs are written to `~/.draht/agent/settings.json`. Add `--local` or `-l` to write the package declaration to `.draht/settings.json`. draht reads declarations from that file only after project trust is granted.
68
20
 
69
- ```json
70
- {
71
- "npmCommand": ["mise", "exec", "node@20", "--", "npm"]
72
- }
73
- ```
21
+ Project packages are installed and loaded only after project trust is resolved. Packages can execute extension code and can include skills that instruct the model to run programs. Review third-party package source before installing it. Review project package declarations before granting project trust.
74
22
 
75
- ### git
23
+ Use `--extension` or `-e` to try a package for one invocation without adding it to settings:
76
24
 
77
- ```
78
- git:github.com/user/repo@v1
79
- git:git@github.com:user/repo@v1
80
- https://github.com/user/repo@v1
81
- ssh://git@github.com/user/repo@v1
82
- ```
83
-
84
- - Without `git:` prefix, only protocol URLs are accepted (`https://`, `http://`, `ssh://`, `git://`).
85
- - With `git:` prefix, shorthand formats are accepted, including `github.com/user/repo` and `git@github.com:user/repo`.
86
- - HTTPS and SSH URLs are both supported.
87
- - SSH URLs use your configured SSH keys automatically (respects `~/.ssh/config`).
88
- - For non-interactive runs (for example CI), you can set `GIT_TERMINAL_PROMPT=0` to disable credential prompts and set `GIT_SSH_COMMAND` (for example `ssh -o BatchMode=yes -o ConnectTimeout=5`) to fail fast.
89
- - Refs are pinned tags or commits. `draht update` and `draht update --extensions` do not move them to newer refs, but they do reconcile an existing clone to the configured ref.
90
- - Use `draht install git:host/user/repo@new-ref` to update settings and move an existing package to a new pinned ref.
91
- - Cloned to `~/.draht/agent/git/<host>/<path>` (global) or `.draht/git/<host>/<path>` (project).
92
- - When reconciliation changes the checkout, draht resets and cleans the clone, then runs `npm install` if `package.json` exists.
93
-
94
- **SSH examples:**
95
25
  ```bash
96
- # git@host:path shorthand (requires git: prefix)
97
- draht install git:git@github.com:user/repo
98
-
99
- # ssh:// protocol format
100
- draht install ssh://git@github.com/user/repo
101
-
102
- # With version ref
103
- draht install git:git@github.com:user/repo@v1.0.0
26
+ draht -e npm:@example/my-tools
104
27
  ```
105
28
 
106
- ### Local Paths
29
+ ## Choose a source
107
30
 
108
- ```
109
- /absolute/path/to/package
110
- ./relative/path/to/package
111
- ```
31
+ | Source | Example | Behavior |
32
+ |---|---|---|
33
+ | npm | `npm:@example/my-tools@1.0.0` | Installed under the draht npm directory |
34
+ | git | `git:github.com/example/my-tools@v1` | Cloned and reconciled to the selected ref |
35
+ | URL | `https://github.com/example/my-tools` | Treated as a git source |
36
+ | Local | `./my-tools` | Loaded from the resolved path without copying |
112
37
 
113
- Local paths point to files or directories on disk and are added to settings without copying. Relative paths are resolved against the settings file they appear in. If the path is a file, it loads as a single extension. If it is a directory, draht loads resources using package rules.
38
+ Versioned npm specifications are pinned. Git tags and commits are also pinned; package updates reconcile the checkout but do not move a configured ref.
114
39
 
115
- ## Creating a draht Package
40
+ Relative local paths resolve from the settings file that contains them. A file path loads one extension. A directory follows normal package discovery rules.
116
41
 
117
- Add a `draht` manifest to `package.json` or use conventional directories. Include the `pi-package` keyword for discoverability.
42
+ ## Create a package
118
43
 
119
- ```json
120
- {
121
- "name": "my-package",
122
- "keywords": ["pi-package"],
123
- "draht": {
124
- "extensions": ["./extensions"],
125
- "skills": ["./skills"],
126
- "prompts": ["./prompts"],
127
- "themes": ["./themes"]
128
- }
129
- }
130
- ```
44
+ The simplest package uses conventional directories:
131
45
 
132
- Paths are relative to the package root. Arrays support glob patterns and `!exclusions`.
46
+ ```text
47
+ my-package/
48
+ ├── package.json
49
+ ├── extensions/
50
+ ├── skills/
51
+ ├── prompts/
52
+ └── themes/
53
+ ```
133
54
 
134
- ### Gallery Metadata
55
+ Without a manifest, draht discovers TypeScript and JavaScript extensions, skill directories, Markdown prompts, and JSON themes from those directories.
135
56
 
136
- The [package gallery](https://pi.dev/packages) displays packages tagged with `pi-package`. Add `video` or `image` fields to show a preview:
57
+ Use an explicit manifest when resources live elsewhere or need filtering:
137
58
 
138
59
  ```json
139
60
  {
140
61
  "name": "my-package",
141
62
  "keywords": ["pi-package"],
142
63
  "draht": {
143
- "extensions": ["./extensions"],
144
- "video": "https://example.com/demo.mp4",
145
- "image": "https://example.com/screenshot.png"
64
+ "extensions": ["./src/extension.ts"],
65
+ "skills": ["./resources/skills"],
66
+ "prompts": ["./resources/prompts/*.md"],
67
+ "themes": ["./resources/themes/*.json"]
146
68
  }
147
69
  }
148
70
  ```
149
71
 
150
- - **video**: MP4 only. On desktop, autoplays on hover. Clicking opens a fullscreen player.
151
- - **image**: PNG, JPEG, GIF, or WebP. Displayed as a static preview.
152
-
153
- If both are set, video takes precedence.
154
-
155
- ## Package Structure
72
+ draht reads the `draht` key first. Packages written for pi that declare the same fields under a `pi` key load unchanged when no `draht` key is present.
156
73
 
157
- ### Convention Directories
74
+ Paths are relative to the package root. Arrays accept glob patterns and exclusions. List dot-prefixed or symlinked resource roots directly when traversal through a glob would not discover them.
158
75
 
159
- If no `draht` manifest is present, draht auto-discovers resources from these directories:
76
+ The `pi-package` keyword makes the package findable through npm search. draht has no package gallery of its own; optional `image` and `video` manifest fields are accepted but currently unused.
160
77
 
161
- - `extensions/` loads `.ts` and `.js` files
162
- - `skills/` recursively finds `SKILL.md` folders and loads top-level `.md` files as skills
163
- - `prompts/` loads `.md` files
164
- - `themes/` loads `.json` files
78
+ ## Declare dependencies
165
79
 
166
- ## Dependencies
80
+ Put runtime packages imported by extensions in `dependencies`. draht installs package dependencies when it installs an npm or git source.
167
81
 
168
- Third party runtime dependencies belong in `dependencies` in `package.json`. Dependencies that do not register extensions, skills, prompt templates, or themes also belong in `dependencies`. When draht installs a package from npm or git, it runs `npm install`, so those dependencies are installed automatically.
82
+ draht supplies these packages to extensions and skills:
169
83
 
170
- draht bundles core packages for extensions and skills. If you import any of these, list them in `peerDependencies` with a `"*"` range and do not bundle them: `@draht/ai`, `@draht/agent-core`, `@draht/coding-agent`, `@draht/tui`, `typebox`.
84
+ - `@draht/ai`
85
+ - `@draht/agent-core`
86
+ - `@draht/coding-agent`
87
+ - `@draht/tui`
88
+ - `typebox`
171
89
 
172
- Other draht packages must be bundled in your tarball. Add them to `dependencies` and `bundledDependencies`, then reference their resources through `node_modules/` paths. draht loads packages with separate module roots, so separate installs do not collide or share modules.
90
+ Declare the host-provided packages listed above in `peerDependencies` with a `"*"` range and do not bundle them. draht suppresses automatic peer installation for managed npm packages and git packages installed with npm, pnpm, or Bun. Local packages are not installed or modified, so their dependency tree remains the package author's responsibility.
173
91
 
174
- Example:
92
+ Do not list host-provided packages in `dependencies`. A physical copy can bypass draht's extension module mapping in compiled ESM and create duplicate classes, registries, and initialization work. draht reports an extension warning when it detects this manifest configuration. Other draht packages used as dependencies must be included in the published tarball and referenced through their `node_modules` resource paths.
175
93
 
176
- ```json
177
- {
178
- "dependencies": {
179
- "shitty-extensions": "^1.0.1"
180
- },
181
- "bundledDependencies": ["shitty-extensions"],
182
- "draht": {
183
- "extensions": ["extensions", "node_modules/shitty-extensions/extensions"],
184
- "skills": ["skills", "node_modules/shitty-extensions/skills"]
185
- }
186
- }
187
- ```
94
+ Installed packages load with separate module roots. Do not rely on two packages sharing one dependency instance or one package resolving another package’s undeclared dependency.
188
95
 
189
- ## Package Filtering
96
+ ## Select package resources
190
97
 
191
- Filter what a package loads using the object form in settings:
98
+ The object form in settings narrows which resources load from a package:
192
99
 
193
100
  ```json
194
101
  {
195
102
  "packages": [
196
- "npm:simple-pkg",
197
103
  {
198
- "source": "npm:my-package",
104
+ "source": "npm:@example/my-tools",
199
105
  "extensions": ["extensions/*.ts", "!extensions/legacy.ts"],
200
106
  "skills": [],
201
- "prompts": ["prompts/review.md"],
202
- "themes": ["+themes/legacy.json"]
107
+ "prompts": ["prompts/review.md"]
203
108
  }
204
109
  ]
205
110
  }
206
111
  ```
207
112
 
208
- `+path` and `-path` are exact paths relative to the package root.
113
+ For each resource type:
209
114
 
210
- - Omit a key to load all of that type.
115
+ - Omit the property to load everything allowed by the package.
211
116
  - Use `[]` to load none of that type.
212
- - `!pattern` excludes matches.
213
- - `+path` force-includes an exact path.
214
- - `-path` force-excludes an exact path.
215
- - Filters layer on top of the manifest. They narrow down what is already allowed.
117
+ - Use `!pattern` to exclude glob matches.
118
+ - Use `+path` to include one exact allowed path.
119
+ - Use `-path` to exclude one exact path.
120
+
121
+ Filters narrow the package manifest. They do not expose resources that the package itself did not declare.
216
122
 
217
- ## Enable and Disable Resources
123
+ Run `draht config` to enable or disable discovered resources and draht's built-in extensions. It starts with personal configuration; press Tab to switch scope, or run `draht config --local` to start with project overrides.
218
124
 
219
- Use `draht config` to enable or disable extensions, skills, prompt templates, and themes from installed packages and local directories. `draht config` starts in global settings (`~/.draht/agent/settings.json`); press Tab to switch between global and project-local modes. Use `draht config -l` to start in project overrides (`.draht/settings.json`) with inherited global resources dimmed.
125
+ ## Understand scope and identity
220
126
 
221
- ## Scope and Deduplication
127
+ The same package can appear in personal and project settings. A project entry normally replaces the personal entry. With `autoload: false`, the project entry instead acts as a filtering delta over the personal package.
222
128
 
223
- Packages can appear in both global and project settings. If the same package appears in both, the project entry wins unless the project entry has `autoload: false`, in which case it is applied as a delta over the global entry. Identity is determined by:
129
+ draht identifies npm packages by package name, git packages by repository URL without the ref, and local packages by resolved absolute path. This prevents the same package from loading twice through equivalent declarations.
224
130
 
225
- - npm: package name
226
- - git: repository URL without ref
227
- - local: resolved absolute path
131
+ Use [Extensions](extensions.md), [Skills](skills.md), [Prompt Templates](prompt-templates.md), and [Themes](themes.md) to design each resource before packaging it.
@@ -1,96 +1,59 @@
1
- > draht can create prompt templates. Ask it to build one for your workflow.
2
-
3
1
  # Prompt Templates
4
2
 
5
- Prompt templates are Markdown snippets that expand into full prompts. Type `/name` in the editor to invoke a template, where `name` is the filename without `.md`.
6
-
7
- ## Locations
8
-
9
- draht loads prompt templates from:
3
+ Prompt templates turn Markdown files into reusable `/` commands. Use one when you want to reuse the same prompt without adding executable behavior or a larger set of supporting instructions.
10
4
 
11
- - Global: `~/.draht/agent/prompts/*.md`
12
- - Project: `.draht/prompts/*.md` (only after the project is trusted)
13
- - Packages: `prompts/` directories or `pi.prompts` entries in `package.json`
14
- - Settings: `prompts` array with files or directories
15
- - CLI: `--prompt-template <path>` (repeatable)
5
+ A template can accept arguments and appear in command completion. draht can load templates from personal configuration, project configuration, an explicit path, or a draht package. Project configuration loads only after project trust is granted.
16
6
 
17
- Disable discovery with `--no-prompt-templates`.
7
+ ## Create a template
18
8
 
19
- ## Format
9
+ Create `~/.draht/agent/prompts/review.md`:
20
10
 
21
11
  ```markdown
22
12
  ---
23
13
  description: Review staged git changes
14
+ argument-hint: "[focus]"
24
15
  ---
25
- Review the staged changes (`git diff --cached`). Focus on:
26
- - Bugs and logic errors
27
- - Security issues
28
- - Error handling gaps
16
+ Review the staged changes. Focus on ${1:-correctness, security, and error handling}.
29
17
  ```
30
18
 
31
- - The filename becomes the command name. `review.md` becomes `/review`.
32
- - `description` is optional. If missing, the first non-empty line is used.
33
- - `argument-hint` is optional. When set, the hint is displayed before the description in the autocomplete dropdown.
19
+ The filename becomes the command name, so this template is available as `/review`. The `description` appears in command completion. If it is omitted, draht uses the first non-empty line.
34
20
 
35
- ### Argument Hints
21
+ `argument-hint` is optional. Use `<angle brackets>` for required arguments and `[square brackets]` for optional arguments.
36
22
 
37
- Use `argument-hint` in frontmatter to show expected arguments in autocomplete. Use `<angle brackets>` for required arguments and `[square brackets]` for optional ones:
38
-
39
- ```markdown
40
- ---
41
- description: Review PRs from URLs with structured issue and code analysis
42
- argument-hint: "<PR-URL>"
43
- ---
44
- ```
23
+ Run `/reload` after adding or changing a template in an active session.
45
24
 
46
- This renders in the autocomplete dropdown as:
25
+ <a id="invoke-a-template"></a>
47
26
 
48
- ```
49
- → pr <PR-URL> — Review PRs from URLs with structured issue and code analysis
50
- is <issue> — Analyze GitHub issues (bugs or feature requests)
51
- wr [instructions] — Finish the current task end-to-end
52
- cl — Audit changelog entries before release
53
- ```
27
+ ## Use a template
54
28
 
55
- ## Usage
29
+ Type the template command in the editor:
56
30
 
57
- Type `/` followed by the template name in the editor. Autocomplete shows available templates with descriptions.
58
-
59
- ```
60
- /review # Expands review.md
61
- /component Button # Expands with argument
62
- /component Button "click handler" # Multiple arguments
31
+ ```text
32
+ /review
33
+ /review concurrency
63
34
  ```
64
35
 
65
- ## Arguments
36
+ draht expands the template before the resulting text enters the agent. Extensions receive the raw input first through the `input` event unless an extension command with the same name handles it.
66
37
 
67
- Templates support positional arguments, defaults, and simple slicing:
38
+ Templates support these substitutions:
68
39
 
69
- - `$1`, `$2`, ... positional args
70
- - `$@` or `$ARGUMENTS` for all args joined
71
- - `${1:-default}` uses arg 1 when present/non-empty, otherwise `default`
72
- - `${@:-default}` or `${ARGUMENTS:-default}` uses all arguments when present/non-empty, otherwise `default`
73
- - `${@:N}` for args from the Nth position (1-indexed)
74
- - `${@:N:L}` for `L` args starting at N
40
+ | Syntax | Result |
41
+ |---|---|
42
+ | `$1`, `$2`, … | One positional argument |
43
+ | `$@` or `$ARGUMENTS` | All arguments joined with spaces |
44
+ | `${1:-default}` | First argument, or a default value |
45
+ | `${@:-default}` | All arguments, or a default value |
46
+ | `${@:N}` | Arguments starting at position `N` |
47
+ | `${@:N:L}` | `L` arguments starting at position `N` |
75
48
 
76
- Example:
49
+ Arguments follow shell-like quoting, so `/review "API compatibility"` supplies one argument containing a space.
77
50
 
78
- ```markdown
79
- ---
80
- description: Create a component
81
- ---
82
- Create a React component named $1 with features: $@
83
- ```
84
-
85
- Default values are useful for optional arguments:
51
+ <a id="choose-where-it-loads"></a>
86
52
 
87
- ```markdown
88
- Summarize the current state in ${1:-7} bullet points.
89
- ```
53
+ ## Add it to draht
90
54
 
91
- Usage: `/component Button "onClick handler" "disabled support"`
55
+ Place the template in your user or project prompt directory. Conventional prompt directories load direct `.md` children only.
92
56
 
93
- ## Loading Rules
57
+ Settings and packages can select nested Markdown files; a package manifest can narrow discovery with explicit paths and globs. See [Settings](settings.md#resources) and [draht Packages](packages.md) for these options.
94
58
 
95
- - Template discovery in `prompts/` is non-recursive.
96
- - If you want templates in subdirectories, add them explicitly via `prompts` settings or a package manifest.
59
+ Project templates become commands in the editor after trust is granted. Review their content before trusting an unfamiliar project. See [Security](security.md#understand-project-trust).