@punch-bot/cli 0.85.1 → 1.2.0

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 (1103) hide show
  1. package/CHANGELOG.md +572 -3
  2. package/README.md +82 -174
  3. package/dist/bun/cli.d.ts.map +1 -1
  4. package/dist/bun/restore-sandbox-env.d.ts.map +1 -1
  5. package/dist/bun/restore-sandbox-env.js.map +1 -1
  6. package/dist/bun/runtime-setup.d.ts.map +1 -1
  7. package/dist/bun/runtime-setup.js +4 -1
  8. package/dist/bun/runtime-setup.js.map +1 -1
  9. package/dist/bun/sandbox-env-setup.d.ts.map +1 -1
  10. package/dist/bundle/chunks/anthropic-messages-DA6M7CRN.js +6 -0
  11. package/dist/bundle/chunks/anthropic.js +2 -2
  12. package/dist/bundle/chunks/azure-openai-responses-IJO5RNR3.js +2 -0
  13. package/dist/bundle/chunks/bedrock-converse-stream.js +10 -2
  14. package/dist/bundle/chunks/chunk-22CYIUS4.js +2 -0
  15. package/dist/bundle/chunks/chunk-2M76JOVH.js +8 -0
  16. package/dist/bundle/chunks/chunk-5HTGPCR7.js +2 -0
  17. package/dist/bundle/chunks/chunk-5OD3Y36V.js +11 -0
  18. package/dist/bundle/chunks/chunk-6C5VKHGV.js +50 -0
  19. package/dist/bundle/chunks/chunk-F5ZABL6Z.js +20 -0
  20. package/dist/bundle/chunks/{chunk-3DNTDXPG.js → chunk-FJPXW4TE.js} +3 -3
  21. package/dist/bundle/chunks/chunk-FLX3SJDL.js +1156 -0
  22. package/dist/bundle/chunks/chunk-HACVPRBJ.js +11 -0
  23. package/dist/bundle/chunks/chunk-ITZNWD4K.js +2 -0
  24. package/dist/bundle/chunks/chunk-J7I2NFJ7.js +82 -0
  25. package/dist/bundle/chunks/chunk-JHYQSLCR.js +2 -0
  26. package/dist/bundle/chunks/chunk-LPXNMA2W.js +2 -0
  27. package/dist/bundle/chunks/chunk-OO6DJ3CL.js +31 -0
  28. package/dist/bundle/chunks/chunk-PMRZO46Y.js +2 -0
  29. package/dist/bundle/chunks/{chunk-TRDNDS6A.js → chunk-PYGXRV27.js} +5 -2
  30. package/dist/bundle/chunks/chunk-RDZVAGPR.js +2 -0
  31. package/dist/bundle/chunks/{chunk-XDUWOHPL.js → chunk-S3GGRYIO.js} +2 -2
  32. package/dist/bundle/chunks/chunk-UTB4DTYQ.js +2 -0
  33. package/dist/bundle/chunks/chunk-WUIPA42N.js +14 -0
  34. package/dist/bundle/chunks/chunk-XIX7LUWI.js +2 -0
  35. package/dist/bundle/chunks/chunk-YWHGLBPB.js +2 -0
  36. package/dist/bundle/chunks/chunk-ZBURYEWF.js +2 -0
  37. package/dist/bundle/chunks/cli-QAQLORRY.js +51 -0
  38. package/dist/bundle/chunks/cloudflare-workers-ai-system-one-UTBL2KOF.js +2 -0
  39. package/dist/bundle/chunks/codemode-worker.js +478 -0
  40. package/dist/bundle/chunks/execute-2Z6BN5R3.js +499 -0
  41. package/dist/bundle/chunks/github-copilot.js +1 -1
  42. package/dist/bundle/chunks/google-generative-ai-JSIIVUNP.js +2 -0
  43. package/dist/bundle/chunks/google-vertex-BZ3ID54S.js +2 -0
  44. package/dist/bundle/chunks/image-resize-worker.js +1 -1
  45. package/dist/bundle/chunks/jiti-loader-C3NU2SDH.js +21 -0
  46. package/dist/bundle/chunks/jiti-static-loader-E6ANQD5T.js +2 -0
  47. package/dist/bundle/chunks/{lib-HGQMNYVT.js → lib-TEDK3E5I.js} +2 -2
  48. package/dist/bundle/chunks/llama-cpp-classify-FYN623RH.js +22 -0
  49. package/dist/bundle/chunks/meta.js +2 -0
  50. package/dist/bundle/chunks/mistral-conversations-RMNTDYQK.js +5 -0
  51. package/dist/bundle/chunks/node-N5BSDOA5.js +16 -0
  52. package/dist/bundle/chunks/{node-4PXJTSWH.js → node-TWVVAGPO.js} +1 -1
  53. package/dist/bundle/chunks/openai-chatgpt.js +75 -0
  54. package/dist/bundle/chunks/openai-codex-responses-O3P3UWDP.js +10 -0
  55. package/dist/bundle/chunks/openai-codex.js +2 -2
  56. package/dist/bundle/chunks/openai-completions-G4BKSHGH.js +7 -0
  57. package/dist/bundle/chunks/openai-decisions-WVPMQ4JD.js +5 -0
  58. package/dist/bundle/chunks/openai-responses-377V6EDU.js +3 -0
  59. package/dist/bundle/chunks/{openrouter-images-N4XVVFSD.js → openrouter-images-YU24TD7D.js} +1 -1
  60. package/dist/bundle/chunks/openrouter.js +2 -2
  61. package/dist/bundle/chunks/{pi-messages-ZRYGTSON.js → pi-messages-V27DSLVC.js} +2 -2
  62. package/dist/bundle/chunks/radius.js +2 -2
  63. package/dist/bundle/chunks/runtime-R6O72Q4R.js +2 -0
  64. package/dist/bundle/chunks/typesafe-system-one-ZSK3RN4B.js +2 -0
  65. package/dist/bundle/chunks/virtual-modules-FOSN3OT2.js +2 -0
  66. package/dist/bundle/cli-runtime.js +3 -0
  67. package/dist/bundle/cli.js +4 -2
  68. package/dist/bundle/index.js +1 -1
  69. package/dist/bundle/rpc-entry.js +1 -1
  70. package/dist/cli/args.d.ts +1 -2
  71. package/dist/cli/args.d.ts.map +1 -1
  72. package/dist/cli/args.js +73 -53
  73. package/dist/cli/args.js.map +1 -1
  74. package/dist/cli/auth-check.d.ts.map +1 -1
  75. package/dist/cli/auth-check.js.map +1 -1
  76. package/dist/cli/auth-command.d.ts.map +1 -1
  77. package/dist/cli/auth-command.js.map +1 -1
  78. package/dist/cli/credential-print.d.ts.map +1 -1
  79. package/dist/cli/credential-print.js.map +1 -1
  80. package/dist/cli/experimental/transport-address.d.ts +21 -0
  81. package/dist/cli/experimental/transport-address.d.ts.map +1 -0
  82. package/dist/cli/experimental/transport-address.js +89 -0
  83. package/dist/cli/experimental/transport-address.js.map +1 -0
  84. package/dist/cli/file-processor.d.ts +1 -1
  85. package/dist/cli/file-processor.d.ts.map +1 -1
  86. package/dist/cli/file-processor.js.map +1 -1
  87. package/dist/cli/initial-message.d.ts +1 -1
  88. package/dist/cli/initial-message.d.ts.map +1 -1
  89. package/dist/cli/initial-message.js.map +1 -1
  90. package/dist/cli/list-models.d.ts.map +1 -1
  91. package/dist/cli/list-models.js +1 -1
  92. package/dist/cli/list-models.js.map +1 -1
  93. package/dist/cli/project-trust.d.ts.map +1 -1
  94. package/dist/cli/project-trust.js +5 -35
  95. package/dist/cli/project-trust.js.map +1 -1
  96. package/dist/cli/setup.d.ts.map +1 -1
  97. package/dist/cli/setup.js.map +1 -1
  98. package/dist/cli.d.ts.map +1 -1
  99. package/dist/config.d.ts +30 -11
  100. package/dist/config.d.ts.map +1 -1
  101. package/dist/config.js +72 -21
  102. package/dist/config.js.map +1 -1
  103. package/dist/core/agent-session-runtime.d.ts +4 -3
  104. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  105. package/dist/core/agent-session-runtime.js +37 -27
  106. package/dist/core/agent-session-runtime.js.map +1 -1
  107. package/dist/core/agent-session-services.d.ts +1 -0
  108. package/dist/core/agent-session-services.d.ts.map +1 -1
  109. package/dist/core/agent-session-services.js +14 -0
  110. package/dist/core/agent-session-services.js.map +1 -1
  111. package/dist/core/agent-session.d.ts +270 -22
  112. package/dist/core/agent-session.d.ts.map +1 -1
  113. package/dist/core/agent-session.js +1174 -410
  114. package/dist/core/agent-session.js.map +1 -1
  115. package/dist/core/auth-guidance.d.ts.map +1 -1
  116. package/dist/core/auth-guidance.js.map +1 -1
  117. package/dist/core/auth-storage.d.ts.map +1 -1
  118. package/dist/core/auth-storage.js +20 -13
  119. package/dist/core/auth-storage.js.map +1 -1
  120. package/dist/core/bash-executor.d.ts.map +1 -1
  121. package/dist/core/bash-executor.js +42 -52
  122. package/dist/core/bash-executor.js.map +1 -1
  123. package/dist/core/bug-report-upload.d.ts +12 -0
  124. package/dist/core/bug-report-upload.d.ts.map +1 -0
  125. package/dist/core/bug-report-upload.js +22 -0
  126. package/dist/core/bug-report-upload.js.map +1 -0
  127. package/dist/core/bug-report.d.ts +184 -0
  128. package/dist/core/bug-report.d.ts.map +1 -0
  129. package/dist/core/bug-report.js +292 -0
  130. package/dist/core/bug-report.js.map +1 -0
  131. package/dist/core/cache-stats.d.ts.map +1 -1
  132. package/dist/core/cache-stats.js +12 -1
  133. package/dist/core/cache-stats.js.map +1 -1
  134. package/dist/core/cache-warmer.d.ts +103 -0
  135. package/dist/core/cache-warmer.d.ts.map +1 -0
  136. package/dist/core/cache-warmer.js +356 -0
  137. package/dist/core/cache-warmer.js.map +1 -0
  138. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  139. package/dist/core/compaction/branch-summarization.js +2 -2
  140. package/dist/core/compaction/branch-summarization.js.map +1 -1
  141. package/dist/core/compaction/compaction.d.ts +5 -3
  142. package/dist/core/compaction/compaction.d.ts.map +1 -1
  143. package/dist/core/compaction/compaction.js +164 -88
  144. package/dist/core/compaction/compaction.js.map +1 -1
  145. package/dist/core/compaction/index.d.ts.map +1 -1
  146. package/dist/core/compaction/utils.d.ts +8 -1
  147. package/dist/core/compaction/utils.d.ts.map +1 -1
  148. package/dist/core/compaction/utils.js +32 -26
  149. package/dist/core/compaction/utils.js.map +1 -1
  150. package/dist/core/crash-log.d.ts +27 -0
  151. package/dist/core/crash-log.d.ts.map +1 -0
  152. package/dist/core/crash-log.js +140 -0
  153. package/dist/core/crash-log.js.map +1 -0
  154. package/dist/core/defaults.d.ts.map +1 -1
  155. package/dist/core/delivery.d.ts.map +1 -1
  156. package/dist/core/delivery.js.map +1 -1
  157. package/dist/core/diagnostics.d.ts.map +1 -1
  158. package/dist/core/event-bus.d.ts.map +1 -1
  159. package/dist/core/event-bus.js.map +1 -1
  160. package/dist/core/exec.d.ts.map +1 -1
  161. package/dist/core/exec.js.map +1 -1
  162. package/dist/core/experimental.d.ts.map +1 -1
  163. package/dist/core/experimental.js.map +1 -1
  164. package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
  165. package/dist/core/export-html/ansi-to-html.js.map +1 -1
  166. package/dist/core/export-html/index.d.ts.map +1 -1
  167. package/dist/core/export-html/index.js +1 -1
  168. package/dist/core/export-html/index.js.map +1 -1
  169. package/dist/core/export-html/template.css +10 -0
  170. package/dist/core/export-html/template.js +93 -34
  171. package/dist/core/export-html/tool-renderer.d.ts +5 -11
  172. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  173. package/dist/core/export-html/tool-renderer.js +8 -99
  174. package/dist/core/export-html/tool-renderer.js.map +1 -1
  175. package/dist/core/extensions/index.d.ts +1 -1
  176. package/dist/core/extensions/index.d.ts.map +1 -1
  177. package/dist/core/extensions/index.js.map +1 -1
  178. package/dist/core/extensions/jiti-loader.d.ts +2 -0
  179. package/dist/core/extensions/jiti-loader.d.ts.map +1 -0
  180. package/dist/core/extensions/jiti-loader.js +4 -0
  181. package/dist/core/extensions/jiti-loader.js.map +1 -0
  182. package/dist/core/extensions/jiti-static-loader.d.ts +2 -0
  183. package/dist/core/extensions/jiti-static-loader.d.ts.map +1 -0
  184. package/dist/core/extensions/jiti-static-loader.js +4 -0
  185. package/dist/core/extensions/jiti-static-loader.js.map +1 -0
  186. package/dist/core/extensions/loader.d.ts.map +1 -1
  187. package/dist/core/extensions/loader.js +102 -74
  188. package/dist/core/extensions/loader.js.map +1 -1
  189. package/dist/core/extensions/runner.d.ts +44 -14
  190. package/dist/core/extensions/runner.d.ts.map +1 -1
  191. package/dist/core/extensions/runner.js +297 -169
  192. package/dist/core/extensions/runner.js.map +1 -1
  193. package/dist/core/extensions/types.d.ts +482 -238
  194. package/dist/core/extensions/types.d.ts.map +1 -1
  195. package/dist/core/extensions/types.js.map +1 -1
  196. package/dist/core/extensions/virtual-modules.d.ts +3 -0
  197. package/dist/core/extensions/virtual-modules.d.ts.map +1 -0
  198. package/dist/core/extensions/virtual-modules.js +35 -0
  199. package/dist/core/extensions/virtual-modules.js.map +1 -0
  200. package/dist/core/extensions/wrapper.d.ts +2 -2
  201. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  202. package/dist/core/extensions/wrapper.js +3 -22
  203. package/dist/core/extensions/wrapper.js.map +1 -1
  204. package/dist/core/footer-data-provider.d.ts.map +1 -1
  205. package/dist/core/footer-data-provider.js.map +1 -1
  206. package/dist/core/http-dispatcher.d.ts +13 -0
  207. package/dist/core/http-dispatcher.d.ts.map +1 -1
  208. package/dist/core/http-dispatcher.js +13 -4
  209. package/dist/core/http-dispatcher.js.map +1 -1
  210. package/dist/core/index.d.ts +2 -1
  211. package/dist/core/index.d.ts.map +1 -1
  212. package/dist/core/index.js.map +1 -1
  213. package/dist/core/mcp-servers.d.ts +139 -0
  214. package/dist/core/mcp-servers.d.ts.map +1 -0
  215. package/dist/core/mcp-servers.js +232 -0
  216. package/dist/core/mcp-servers.js.map +1 -0
  217. package/dist/core/messages.d.ts.map +1 -1
  218. package/dist/core/messages.js +1 -0
  219. package/dist/core/messages.js.map +1 -1
  220. package/dist/{modes/interactive → core}/model-catalog-refresh.d.ts +2 -2
  221. package/dist/core/model-catalog-refresh.d.ts.map +1 -0
  222. package/dist/{modes/interactive → core}/model-catalog-refresh.js +2 -2
  223. package/dist/core/model-catalog-refresh.js.map +1 -0
  224. package/dist/core/model-config.d.ts +886 -80
  225. package/dist/core/model-config.d.ts.map +1 -1
  226. package/dist/core/model-config.js +33 -148
  227. package/dist/core/model-config.js.map +1 -1
  228. package/dist/core/model-registry.d.ts +15 -1
  229. package/dist/core/model-registry.d.ts.map +1 -1
  230. package/dist/core/model-registry.js +29 -0
  231. package/dist/core/model-registry.js.map +1 -1
  232. package/dist/core/model-resolver.d.ts +19 -46
  233. package/dist/core/model-resolver.d.ts.map +1 -1
  234. package/dist/core/model-resolver.js +149 -359
  235. package/dist/core/model-resolver.js.map +1 -1
  236. package/dist/core/model-runtime.d.ts +47 -3
  237. package/dist/core/model-runtime.d.ts.map +1 -1
  238. package/dist/core/model-runtime.js +205 -43
  239. package/dist/core/model-runtime.js.map +1 -1
  240. package/dist/core/models-store.d.ts.map +1 -1
  241. package/dist/core/models-store.js.map +1 -1
  242. package/dist/core/nested-tool-calls.d.ts +103 -0
  243. package/dist/core/nested-tool-calls.d.ts.map +1 -0
  244. package/dist/core/nested-tool-calls.js +179 -0
  245. package/dist/core/nested-tool-calls.js.map +1 -0
  246. package/dist/core/output-guard.d.ts.map +1 -1
  247. package/dist/core/output-guard.js.map +1 -1
  248. package/dist/core/package-manager.d.ts +4 -0
  249. package/dist/core/package-manager.d.ts.map +1 -1
  250. package/dist/core/package-manager.js +62 -15
  251. package/dist/core/package-manager.js.map +1 -1
  252. package/dist/core/pi-manifest.d.ts.map +1 -1
  253. package/dist/core/pi-manifest.js.map +1 -1
  254. package/dist/core/project-trust.d.ts.map +1 -1
  255. package/dist/core/project-trust.js +2 -1
  256. package/dist/core/project-trust.js.map +1 -1
  257. package/dist/core/prompt-templates.d.ts +6 -1
  258. package/dist/core/prompt-templates.d.ts.map +1 -1
  259. package/dist/core/prompt-templates.js +68 -37
  260. package/dist/core/prompt-templates.js.map +1 -1
  261. package/dist/core/provider-attribution.d.ts.map +1 -1
  262. package/dist/core/provider-attribution.js.map +1 -1
  263. package/dist/core/provider-composer.d.ts +42 -20
  264. package/dist/core/provider-composer.d.ts.map +1 -1
  265. package/dist/core/provider-composer.js +126 -40
  266. package/dist/core/provider-composer.js.map +1 -1
  267. package/dist/core/radius.d.ts +5 -0
  268. package/dist/core/radius.d.ts.map +1 -1
  269. package/dist/core/radius.js +8 -0
  270. package/dist/core/radius.js.map +1 -1
  271. package/dist/core/remote-catalog-provider.d.ts +19 -1
  272. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  273. package/dist/core/remote-catalog-provider.js +102 -34
  274. package/dist/core/remote-catalog-provider.js.map +1 -1
  275. package/dist/core/resolve-config-value.d.ts.map +1 -1
  276. package/dist/core/resolve-config-value.js.map +1 -1
  277. package/dist/core/resource-loader.d.ts +11 -2
  278. package/dist/core/resource-loader.d.ts.map +1 -1
  279. package/dist/core/resource-loader.js +170 -42
  280. package/dist/core/resource-loader.js.map +1 -1
  281. package/dist/core/runtime-credentials.d.ts.map +1 -1
  282. package/dist/core/runtime-credentials.js.map +1 -1
  283. package/dist/core/sdk.d.ts +16 -5
  284. package/dist/core/sdk.d.ts.map +1 -1
  285. package/dist/core/sdk.js +124 -52
  286. package/dist/core/sdk.js.map +1 -1
  287. package/dist/core/session-cwd.d.ts.map +1 -1
  288. package/dist/core/session-cwd.js.map +1 -1
  289. package/dist/core/session-export.d.ts +6 -2
  290. package/dist/core/session-export.d.ts.map +1 -1
  291. package/dist/core/session-export.js +14 -13
  292. package/dist/core/session-export.js.map +1 -1
  293. package/dist/core/session-manager.d.ts +72 -13
  294. package/dist/core/session-manager.d.ts.map +1 -1
  295. package/dist/core/session-manager.js +277 -124
  296. package/dist/core/session-manager.js.map +1 -1
  297. package/dist/core/settings-defaults.d.ts +65 -0
  298. package/dist/core/settings-defaults.d.ts.map +1 -0
  299. package/dist/core/settings-defaults.js +66 -0
  300. package/dist/core/settings-defaults.js.map +1 -0
  301. package/dist/core/settings-diagnostics.d.ts.map +1 -1
  302. package/dist/core/settings-diagnostics.js.map +1 -1
  303. package/dist/core/settings-manager.d.ts +41 -126
  304. package/dist/core/settings-manager.d.ts.map +1 -1
  305. package/dist/core/settings-manager.js +165 -52
  306. package/dist/core/settings-manager.js.map +1 -1
  307. package/dist/core/settings-schema.d.ts +224 -0
  308. package/dist/core/settings-schema.d.ts.map +1 -0
  309. package/dist/core/settings-schema.js +285 -0
  310. package/dist/core/settings-schema.js.map +1 -0
  311. package/dist/core/skills.d.ts +4 -1
  312. package/dist/core/skills.d.ts.map +1 -1
  313. package/dist/core/skills.js +6 -1
  314. package/dist/core/skills.js.map +1 -1
  315. package/dist/core/slash-commands.d.ts.map +1 -1
  316. package/dist/core/slash-commands.js +3 -2
  317. package/dist/core/slash-commands.js.map +1 -1
  318. package/dist/core/source-info.d.ts +8 -0
  319. package/dist/core/source-info.d.ts.map +1 -1
  320. package/dist/core/source-info.js +16 -0
  321. package/dist/core/source-info.js.map +1 -1
  322. package/dist/core/system-prompt.d.ts +55 -6
  323. package/dist/core/system-prompt.d.ts.map +1 -1
  324. package/dist/core/system-prompt.js +128 -93
  325. package/dist/core/system-prompt.js.map +1 -1
  326. package/dist/core/telemetry.d.ts +2 -0
  327. package/dist/core/telemetry.d.ts.map +1 -1
  328. package/dist/core/telemetry.js +45 -0
  329. package/dist/core/telemetry.js.map +1 -1
  330. package/dist/core/theme/dark.json +78 -0
  331. package/dist/core/theme/light.json +78 -0
  332. package/dist/core/theme/system-theme.d.ts +54 -0
  333. package/dist/core/theme/system-theme.d.ts.map +1 -0
  334. package/dist/core/theme/system-theme.js +547 -0
  335. package/dist/core/theme/system-theme.js.map +1 -0
  336. package/dist/core/theme/theme-schema.d.ts +28 -0
  337. package/dist/core/theme/theme-schema.d.ts.map +1 -0
  338. package/dist/core/theme/theme-schema.js +105 -0
  339. package/dist/core/theme/theme-schema.js.map +1 -0
  340. package/dist/core/theme/theme-tokens.d.ts +257 -0
  341. package/dist/core/theme/theme-tokens.d.ts.map +1 -0
  342. package/dist/core/theme/theme-tokens.js +94 -0
  343. package/dist/core/theme/theme-tokens.js.map +1 -0
  344. package/dist/core/theme/theme.d.ts +162 -0
  345. package/dist/core/theme/theme.d.ts.map +1 -0
  346. package/dist/{modes/interactive → core}/theme/theme.js +265 -402
  347. package/dist/core/theme/theme.js.map +1 -0
  348. package/dist/core/timings.d.ts.map +1 -1
  349. package/dist/core/timings.js.map +1 -1
  350. package/dist/core/tools/bash.d.ts +14 -1
  351. package/dist/core/tools/bash.d.ts.map +1 -1
  352. package/dist/core/tools/bash.js +43 -6
  353. package/dist/core/tools/bash.js.map +1 -1
  354. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  355. package/dist/core/tools/edit-diff.js.map +1 -1
  356. package/dist/core/tools/edit.d.ts +1 -2
  357. package/dist/core/tools/edit.d.ts.map +1 -1
  358. package/dist/core/tools/edit.js +0 -3
  359. package/dist/core/tools/edit.js.map +1 -1
  360. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  361. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  362. package/dist/core/tools/find.d.ts.map +1 -1
  363. package/dist/core/tools/find.js +0 -2
  364. package/dist/core/tools/find.js.map +1 -1
  365. package/dist/core/tools/grep.d.ts.map +1 -1
  366. package/dist/core/tools/grep.js +0 -2
  367. package/dist/core/tools/grep.js.map +1 -1
  368. package/dist/core/tools/index.d.ts.map +1 -1
  369. package/dist/core/tools/index.js.map +1 -1
  370. package/dist/core/tools/ls.d.ts.map +1 -1
  371. package/dist/core/tools/ls.js +0 -2
  372. package/dist/core/tools/ls.js.map +1 -1
  373. package/dist/core/tools/output-accumulator.d.ts +11 -0
  374. package/dist/core/tools/output-accumulator.d.ts.map +1 -1
  375. package/dist/core/tools/output-accumulator.js +40 -10
  376. package/dist/core/tools/output-accumulator.js.map +1 -1
  377. package/dist/core/tools/path-utils.d.ts.map +1 -1
  378. package/dist/core/tools/path-utils.js.map +1 -1
  379. package/dist/core/tools/powershell.d.ts.map +1 -1
  380. package/dist/core/tools/powershell.js.map +1 -1
  381. package/dist/core/tools/read.d.ts +17 -1
  382. package/dist/core/tools/read.d.ts.map +1 -1
  383. package/dist/core/tools/read.js +23 -4
  384. package/dist/core/tools/read.js.map +1 -1
  385. package/dist/core/tools/tool-definition-wrapper.d.ts +5 -3
  386. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  387. package/dist/core/tools/tool-definition-wrapper.js +3 -1
  388. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  389. package/dist/core/tools/truncate.d.ts +14 -0
  390. package/dist/core/tools/truncate.d.ts.map +1 -1
  391. package/dist/core/tools/truncate.js +29 -0
  392. package/dist/core/tools/truncate.js.map +1 -1
  393. package/dist/core/tools/write.d.ts.map +1 -1
  394. package/dist/core/tools/write.js +0 -2
  395. package/dist/core/tools/write.js.map +1 -1
  396. package/dist/core/trust-manager.d.ts.map +1 -1
  397. package/dist/core/trust-manager.js +1 -0
  398. package/dist/core/trust-manager.js.map +1 -1
  399. package/dist/core/usage-totals.d.ts +3 -1
  400. package/dist/core/usage-totals.d.ts.map +1 -1
  401. package/dist/core/usage-totals.js +28 -1
  402. package/dist/core/usage-totals.js.map +1 -1
  403. package/dist/core/virtual-models.d.ts +117 -0
  404. package/dist/core/virtual-models.d.ts.map +1 -0
  405. package/dist/core/virtual-models.js +124 -0
  406. package/dist/core/virtual-models.js.map +1 -0
  407. package/dist/extensions/browser/index.d.ts.map +1 -1
  408. package/dist/extensions/browser/index.js.map +1 -1
  409. package/dist/extensions/codemode/execute.d.ts +16 -0
  410. package/dist/extensions/codemode/execute.d.ts.map +1 -0
  411. package/dist/extensions/codemode/execute.js +665 -0
  412. package/dist/extensions/codemode/execute.js.map +1 -0
  413. package/dist/extensions/codemode/execute.lazy.d.ts +3 -0
  414. package/dist/extensions/codemode/execute.lazy.d.ts.map +1 -0
  415. package/dist/extensions/codemode/execute.lazy.js +3 -0
  416. package/dist/extensions/codemode/execute.lazy.js.map +1 -0
  417. package/dist/extensions/codemode/index.d.ts +21 -0
  418. package/dist/extensions/codemode/index.d.ts.map +1 -0
  419. package/dist/extensions/codemode/index.js +33 -0
  420. package/dist/extensions/codemode/index.js.map +1 -0
  421. package/dist/extensions/codemode/tool.d.ts +124 -0
  422. package/dist/extensions/codemode/tool.d.ts.map +1 -0
  423. package/dist/extensions/codemode/tool.js +286 -0
  424. package/dist/extensions/codemode/tool.js.map +1 -0
  425. package/dist/extensions/codemode/worker.d.ts +7 -0
  426. package/dist/extensions/codemode/worker.d.ts.map +1 -0
  427. package/dist/extensions/codemode/worker.js +7 -0
  428. package/dist/extensions/codemode/worker.js.map +1 -0
  429. package/dist/extensions/context-pruning/compress_context.d.ts.map +1 -1
  430. package/dist/extensions/context-pruning/compress_context.js +1 -3
  431. package/dist/extensions/context-pruning/compress_context.js.map +1 -1
  432. package/dist/extensions/context-pruning/context-pruning-state.d.ts.map +1 -1
  433. package/dist/extensions/context-pruning/context-pruning-state.js.map +1 -1
  434. package/dist/extensions/index.d.ts.map +1 -1
  435. package/dist/extensions/index.js +6 -2
  436. package/dist/extensions/index.js.map +1 -1
  437. package/dist/extensions/llama/client.d.ts +2 -0
  438. package/dist/extensions/llama/client.d.ts.map +1 -1
  439. package/dist/extensions/llama/client.js +7 -3
  440. package/dist/extensions/llama/client.js.map +1 -1
  441. package/dist/extensions/llama/huggingface.d.ts.map +1 -1
  442. package/dist/extensions/llama/huggingface.js.map +1 -1
  443. package/dist/extensions/llama/index.d.ts.map +1 -1
  444. package/dist/extensions/llama/index.js +0 -4
  445. package/dist/extensions/llama/index.js.map +1 -1
  446. package/dist/extensions/llama/provider.d.ts +1 -1
  447. package/dist/extensions/llama/provider.d.ts.map +1 -1
  448. package/dist/extensions/llama/provider.js +103 -13
  449. package/dist/extensions/llama/provider.js.map +1 -1
  450. package/dist/extensions/llama/ui.d.ts +3 -2
  451. package/dist/extensions/llama/ui.d.ts.map +1 -1
  452. package/dist/extensions/llama/ui.js +106 -364
  453. package/dist/extensions/llama/ui.js.map +1 -1
  454. package/dist/extensions/mcp/cli.d.ts +21 -0
  455. package/dist/extensions/mcp/cli.d.ts.map +1 -0
  456. package/dist/extensions/mcp/cli.js +494 -0
  457. package/dist/extensions/mcp/cli.js.map +1 -0
  458. package/dist/extensions/mcp/cli.lazy.d.ts +3 -0
  459. package/dist/extensions/mcp/cli.lazy.d.ts.map +1 -0
  460. package/dist/extensions/mcp/cli.lazy.js +3 -0
  461. package/dist/extensions/mcp/cli.lazy.js.map +1 -0
  462. package/dist/extensions/mcp/config.d.ts +84 -0
  463. package/dist/extensions/mcp/config.d.ts.map +1 -0
  464. package/dist/extensions/mcp/config.js +196 -0
  465. package/dist/extensions/mcp/config.js.map +1 -0
  466. package/dist/extensions/mcp/index.d.ts +71 -2
  467. package/dist/extensions/mcp/index.d.ts.map +1 -1
  468. package/dist/extensions/mcp/index.js +839 -131
  469. package/dist/extensions/mcp/index.js.map +1 -1
  470. package/dist/extensions/mcp/log.d.ts +16 -0
  471. package/dist/extensions/mcp/log.d.ts.map +1 -0
  472. package/dist/extensions/mcp/log.js +66 -0
  473. package/dist/extensions/mcp/log.js.map +1 -0
  474. package/dist/extensions/mcp/oauth.d.ts +102 -0
  475. package/dist/extensions/mcp/oauth.d.ts.map +1 -0
  476. package/dist/extensions/mcp/oauth.js +428 -0
  477. package/dist/extensions/mcp/oauth.js.map +1 -0
  478. package/dist/extensions/mcp/resources.d.ts +36 -0
  479. package/dist/extensions/mcp/resources.d.ts.map +1 -0
  480. package/dist/extensions/mcp/resources.js +261 -0
  481. package/dist/extensions/mcp/resources.js.map +1 -0
  482. package/dist/extensions/mcp/runtime.d.ts +98 -0
  483. package/dist/extensions/mcp/runtime.d.ts.map +1 -0
  484. package/dist/extensions/mcp/runtime.js +378 -0
  485. package/dist/extensions/mcp/runtime.js.map +1 -0
  486. package/dist/extensions/mcp/runtime.lazy.d.ts +3 -0
  487. package/dist/extensions/mcp/runtime.lazy.d.ts.map +1 -0
  488. package/dist/extensions/mcp/runtime.lazy.js +3 -0
  489. package/dist/extensions/mcp/runtime.lazy.js.map +1 -0
  490. package/dist/extensions/mcp/tools.d.ts +84 -0
  491. package/dist/extensions/mcp/tools.d.ts.map +1 -0
  492. package/dist/extensions/mcp/tools.js +263 -0
  493. package/dist/extensions/mcp/tools.js.map +1 -0
  494. package/dist/extensions/punch/a2a-listen.d.ts +9 -0
  495. package/dist/extensions/punch/a2a-listen.d.ts.map +1 -0
  496. package/dist/extensions/punch/a2a-listen.js +88 -0
  497. package/dist/extensions/punch/a2a-listen.js.map +1 -0
  498. package/dist/extensions/punch/a2a.d.ts +12 -0
  499. package/dist/extensions/punch/a2a.d.ts.map +1 -0
  500. package/dist/extensions/punch/a2a.js +106 -0
  501. package/dist/extensions/punch/a2a.js.map +1 -0
  502. package/dist/extensions/punch/auth.d.ts.map +1 -1
  503. package/dist/extensions/punch/auth.js.map +1 -1
  504. package/dist/extensions/punch/collabs.d.ts.map +1 -1
  505. package/dist/extensions/punch/collabs.js.map +1 -1
  506. package/dist/extensions/punch/index.d.ts.map +1 -1
  507. package/dist/extensions/punch/index.js +9 -14
  508. package/dist/extensions/punch/index.js.map +1 -1
  509. package/dist/extensions/punch/routines.d.ts +1 -3
  510. package/dist/extensions/punch/routines.d.ts.map +1 -1
  511. package/dist/extensions/punch/routines.js +1 -121
  512. package/dist/extensions/punch/routines.js.map +1 -1
  513. package/dist/extensions/punch/server.d.ts.map +1 -1
  514. package/dist/extensions/punch/server.js.map +1 -1
  515. package/dist/extensions/punch/timezone.d.ts.map +1 -1
  516. package/dist/extensions/punch/timezone.js.map +1 -1
  517. package/dist/extensions/punch/todos.d.ts.map +1 -1
  518. package/dist/extensions/punch/todos.js.map +1 -1
  519. package/dist/extensions/report-progress/index.d.ts.map +1 -1
  520. package/dist/extensions/report-progress/index.js.map +1 -1
  521. package/dist/extensions/subagent/agents.d.ts.map +1 -1
  522. package/dist/extensions/subagent/agents.js.map +1 -1
  523. package/dist/extensions/subagent/index.d.ts.map +1 -1
  524. package/dist/extensions/subagent/index.js +0 -372
  525. package/dist/extensions/subagent/index.js.map +1 -1
  526. package/dist/extensions/tool-search/index.d.ts +12 -0
  527. package/dist/extensions/tool-search/index.d.ts.map +1 -0
  528. package/dist/extensions/tool-search/index.js +15 -0
  529. package/dist/extensions/tool-search/index.js.map +1 -0
  530. package/dist/extensions/tool-search/tool.d.ts +71 -0
  531. package/dist/extensions/tool-search/tool.d.ts.map +1 -0
  532. package/dist/extensions/tool-search/tool.js +187 -0
  533. package/dist/extensions/tool-search/tool.js.map +1 -0
  534. package/dist/extensions/webfetch/index.d.ts.map +1 -1
  535. package/dist/extensions/webfetch/index.js.map +1 -1
  536. package/dist/extensions/websearch/index.d.ts.map +1 -1
  537. package/dist/extensions/websearch/index.js.map +1 -1
  538. package/dist/index.d.ts +13 -6
  539. package/dist/index.d.ts.map +1 -1
  540. package/dist/index.js +9 -6
  541. package/dist/index.js.map +1 -1
  542. package/dist/main.d.ts +1 -1
  543. package/dist/main.d.ts.map +1 -1
  544. package/dist/main.js +139 -173
  545. package/dist/main.js.map +1 -1
  546. package/dist/migrations.d.ts.map +1 -1
  547. package/dist/migrations.js +0 -20
  548. package/dist/migrations.js.map +1 -1
  549. package/dist/modes/index.d.ts +0 -1
  550. package/dist/modes/index.d.ts.map +1 -1
  551. package/dist/modes/index.js +0 -1
  552. package/dist/modes/index.js.map +1 -1
  553. package/dist/modes/json-event.d.ts.map +1 -1
  554. package/dist/modes/json-event.js.map +1 -1
  555. package/dist/modes/print-mode.d.ts.map +1 -1
  556. package/dist/modes/print-mode.js +4 -0
  557. package/dist/modes/print-mode.js.map +1 -1
  558. package/dist/modes/rpc/jsonl.d.ts.map +1 -1
  559. package/dist/modes/rpc/jsonl.js.map +1 -1
  560. package/dist/modes/rpc/rpc-client.d.ts +6 -6
  561. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  562. package/dist/modes/rpc/rpc-client.js +12 -8
  563. package/dist/modes/rpc/rpc-client.js.map +1 -1
  564. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  565. package/dist/modes/rpc/rpc-mode.js +16 -46
  566. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  567. package/dist/modes/rpc/rpc-types.d.ts +10 -1
  568. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  569. package/dist/modes/rpc/rpc-types.js.map +1 -1
  570. package/dist/package-manager-cli.d.ts.map +1 -1
  571. package/dist/package-manager-cli.js +43 -43
  572. package/dist/package-manager-cli.js.map +1 -1
  573. package/dist/rpc-entry.d.ts.map +1 -1
  574. package/dist/rpc-entry.js.map +1 -1
  575. package/dist/server/a2a/harness-runner.d.ts.map +1 -1
  576. package/dist/server/a2a/harness-runner.js.map +1 -1
  577. package/dist/server/a2a/run-server.d.ts.map +1 -1
  578. package/dist/server/a2a/run-server.js.map +1 -1
  579. package/dist/utils/abort.d.ts.map +1 -1
  580. package/dist/utils/abort.js.map +1 -1
  581. package/dist/utils/ansi.d.ts +8 -0
  582. package/dist/utils/ansi.d.ts.map +1 -1
  583. package/dist/utils/ansi.js +30 -11
  584. package/dist/utils/ansi.js.map +1 -1
  585. package/dist/utils/changelog.d.ts.map +1 -1
  586. package/dist/utils/changelog.js +5 -2
  587. package/dist/utils/changelog.js.map +1 -1
  588. package/dist/utils/child-process.d.ts.map +1 -1
  589. package/dist/utils/child-process.js.map +1 -1
  590. package/dist/utils/clipboard-command.d.ts.map +1 -1
  591. package/dist/utils/clipboard-command.js.map +1 -1
  592. package/dist/utils/clipboard-image.d.ts.map +1 -1
  593. package/dist/utils/clipboard-image.js +15 -41
  594. package/dist/utils/clipboard-image.js.map +1 -1
  595. package/dist/utils/clipboard.d.ts.map +1 -1
  596. package/dist/utils/clipboard.js +96 -38
  597. package/dist/utils/clipboard.js.map +1 -1
  598. package/dist/utils/colors.d.ts +73 -0
  599. package/dist/utils/colors.d.ts.map +1 -0
  600. package/dist/utils/colors.js +273 -0
  601. package/dist/utils/colors.js.map +1 -0
  602. package/dist/utils/deprecation.d.ts.map +1 -1
  603. package/dist/utils/deprecation.js.map +1 -1
  604. package/dist/utils/exif-orientation.d.ts.map +1 -1
  605. package/dist/utils/exif-orientation.js.map +1 -1
  606. package/dist/utils/frontmatter.d.ts.map +1 -1
  607. package/dist/utils/frontmatter.js.map +1 -1
  608. package/dist/utils/fs-watch.d.ts.map +1 -1
  609. package/dist/utils/fs-watch.js.map +1 -1
  610. package/dist/utils/fuzzy.d.ts +16 -0
  611. package/dist/utils/fuzzy.d.ts.map +1 -0
  612. package/dist/utils/fuzzy.js +111 -0
  613. package/dist/utils/fuzzy.js.map +1 -0
  614. package/dist/utils/git.d.ts.map +1 -1
  615. package/dist/utils/git.js.map +1 -1
  616. package/dist/utils/html.d.ts.map +1 -1
  617. package/dist/utils/html.js.map +1 -1
  618. package/dist/utils/image-convert.d.ts.map +1 -1
  619. package/dist/utils/image-convert.js.map +1 -1
  620. package/dist/utils/image-process.d.ts.map +1 -1
  621. package/dist/utils/image-process.js.map +1 -1
  622. package/dist/utils/image-resize-core.d.ts +12 -0
  623. package/dist/utils/image-resize-core.d.ts.map +1 -1
  624. package/dist/utils/image-resize-core.js +5 -0
  625. package/dist/utils/image-resize-core.js.map +1 -1
  626. package/dist/utils/image-resize-worker.d.ts.map +1 -1
  627. package/dist/utils/image-resize-worker.js +3 -2
  628. package/dist/utils/image-resize-worker.js.map +1 -1
  629. package/dist/utils/image-resize.d.ts.map +1 -1
  630. package/dist/utils/image-resize.js +9 -10
  631. package/dist/utils/image-resize.js.map +1 -1
  632. package/dist/utils/json.d.ts.map +1 -1
  633. package/dist/utils/json.js.map +1 -1
  634. package/dist/utils/management-http.d.ts.map +1 -1
  635. package/dist/utils/management-http.js.map +1 -1
  636. package/dist/utils/mime.d.ts.map +1 -1
  637. package/dist/utils/mime.js +1 -1
  638. package/dist/utils/mime.js.map +1 -1
  639. package/dist/utils/oklab.d.ts +43 -0
  640. package/dist/utils/oklab.d.ts.map +1 -0
  641. package/dist/utils/oklab.js +210 -0
  642. package/dist/utils/oklab.js.map +1 -0
  643. package/dist/utils/open-browser.d.ts.map +1 -1
  644. package/dist/utils/open-browser.js.map +1 -1
  645. package/dist/utils/output-files.d.ts +15 -0
  646. package/dist/utils/output-files.d.ts.map +1 -0
  647. package/dist/utils/output-files.js +30 -0
  648. package/dist/utils/output-files.js.map +1 -0
  649. package/dist/utils/paths.d.ts +3 -3
  650. package/dist/utils/paths.d.ts.map +1 -1
  651. package/dist/utils/paths.js +5 -4
  652. package/dist/utils/paths.js.map +1 -1
  653. package/dist/utils/photon.d.ts.map +1 -1
  654. package/dist/utils/photon.js.map +1 -1
  655. package/dist/utils/pi-user-agent.d.ts.map +1 -1
  656. package/dist/utils/pi-user-agent.js.map +1 -1
  657. package/dist/utils/shell.d.ts +1 -3
  658. package/dist/utils/shell.d.ts.map +1 -1
  659. package/dist/utils/shell.js +3 -30
  660. package/dist/utils/shell.js.map +1 -1
  661. package/dist/utils/sleep.d.ts.map +1 -1
  662. package/dist/utils/sleep.js.map +1 -1
  663. package/dist/utils/syntax-highlight.d.ts.map +1 -1
  664. package/dist/utils/syntax-highlight.js +8 -1
  665. package/dist/utils/syntax-highlight.js.map +1 -1
  666. package/dist/utils/text.d.ts.map +1 -1
  667. package/dist/utils/text.js.map +1 -1
  668. package/dist/utils/tool-result-images.d.ts +3 -1
  669. package/dist/utils/tool-result-images.d.ts.map +1 -1
  670. package/dist/utils/tool-result-images.js +4 -1
  671. package/dist/utils/tool-result-images.js.map +1 -1
  672. package/dist/utils/tools-manager.d.ts.map +1 -1
  673. package/dist/utils/tools-manager.js.map +1 -1
  674. package/dist/utils/version-check.d.ts.map +1 -1
  675. package/dist/utils/version-check.js.map +1 -1
  676. package/dist/utils/windows-self-update.d.ts.map +1 -1
  677. package/dist/utils/windows-self-update.js.map +1 -1
  678. package/dist/utils/wsl.d.ts +3 -0
  679. package/dist/utils/wsl.d.ts.map +1 -0
  680. package/dist/utils/wsl.js +15 -0
  681. package/dist/utils/wsl.js.map +1 -0
  682. package/dist/utils/zip.d.ts +7 -0
  683. package/dist/utils/zip.d.ts.map +1 -0
  684. package/dist/utils/zip.js +60 -0
  685. package/dist/utils/zip.js.map +1 -0
  686. package/docs/cli-integration.md +106 -0
  687. package/docs/cli.md +333 -0
  688. package/docs/codemode.md +230 -0
  689. package/docs/compaction.md +47 -28
  690. package/docs/configuration.md +47 -0
  691. package/docs/containerization.md +109 -82
  692. package/docs/custom-provider.md +109 -713
  693. package/docs/docs.json +148 -96
  694. package/docs/environment-variables.md +18 -3
  695. package/docs/extensions.md +284 -604
  696. package/docs/how-pi-works.md +49 -0
  697. package/docs/images/interactive-mode.png +0 -0
  698. package/docs/index.md +24 -69
  699. package/docs/json.md +193 -65
  700. package/docs/keybindings.md +58 -103
  701. package/docs/llama-cpp.md +24 -4
  702. package/docs/mcp.md +272 -0
  703. package/docs/message-types.md +279 -0
  704. package/docs/models.md +124 -489
  705. package/docs/nvidia-rtx-llama-cpp.md +96 -0
  706. package/docs/packages.md +67 -166
  707. package/docs/prompt-templates.md +31 -68
  708. package/docs/providers.md +158 -228
  709. package/docs/quickstart.md +61 -106
  710. package/docs/rpc-commands.md +860 -0
  711. package/docs/rpc-extension-ui.md +200 -0
  712. package/docs/rpc.md +131 -1554
  713. package/docs/sdk.md +79 -1158
  714. package/docs/security.md +72 -32
  715. package/docs/session-format.md +58 -215
  716. package/docs/sessions.md +35 -114
  717. package/docs/settings.md +98 -326
  718. package/docs/shell-aliases.md +85 -5
  719. package/docs/skills.md +51 -190
  720. package/docs/slash-commands.md +60 -0
  721. package/docs/subagents.md +2 -0
  722. package/docs/terminal-setup.md +7 -182
  723. package/docs/termux.md +74 -83
  724. package/docs/themes.md +89 -273
  725. package/docs/tmux.md +31 -39
  726. package/docs/tui.md +74 -910
  727. package/docs/usage.md +52 -129
  728. package/docs/virtual-models.md +114 -0
  729. package/docs/windows.md +45 -17
  730. package/examples/README.md +13 -5
  731. package/examples/extensions/README.md +4 -30
  732. package/examples/extensions/custom-provider-anthropic/index.ts +18 -12
  733. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  734. package/examples/extensions/custom-provider-anthropic/package.json +17 -17
  735. package/examples/extensions/custom-provider-gitlab-duo/index.ts +2 -2
  736. package/examples/extensions/custom-provider-gitlab-duo/package.json +14 -14
  737. package/examples/extensions/custom-provider-gitlab-duo/test.ts +5 -5
  738. package/examples/extensions/debug-provider.ts +69 -0
  739. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  740. package/examples/extensions/gondolin/package-lock.json +5 -5
  741. package/examples/extensions/gondolin/package.json +1 -1
  742. package/examples/extensions/jev-router.ts +113 -0
  743. package/examples/extensions/prompt-customizer.ts +19 -67
  744. package/examples/extensions/sandbox/package-lock.json +2 -2
  745. package/examples/extensions/sandbox/package.json +1 -1
  746. package/examples/extensions/with-deps/package-lock.json +2 -2
  747. package/examples/extensions/with-deps/package.json +20 -20
  748. package/examples/rpc-client.ts +35 -0
  749. package/examples/sdk/14-codemode-mcp.ts +61 -0
  750. package/examples/sdk/README.md +3 -2
  751. package/npm-shrinkwrap.json +2425 -0
  752. package/package.json +20 -29
  753. package/schemas/models.schema.json +1157 -0
  754. package/schemas/settings.schema.json +734 -0
  755. package/schemas/theme.schema.json +365 -0
  756. package/dist/bundle/chunks/anthropic-messages-ASRU76PT.js +0 -6
  757. package/dist/bundle/chunks/azure-openai-responses-UGF6LMEX.js +0 -2
  758. package/dist/bundle/chunks/chunk-5PRUVL6W.js +0 -1770
  759. package/dist/bundle/chunks/chunk-6R7UI4IY.js +0 -2
  760. package/dist/bundle/chunks/chunk-A3JYRWB6.js +0 -2
  761. package/dist/bundle/chunks/chunk-CHB3CEFP.js +0 -2
  762. package/dist/bundle/chunks/chunk-ELBMWBDG.js +0 -11
  763. package/dist/bundle/chunks/chunk-GMWCTUPB.js +0 -2
  764. package/dist/bundle/chunks/chunk-GTBU4EAF.js +0 -2
  765. package/dist/bundle/chunks/chunk-NUHFSC37.js +0 -25
  766. package/dist/bundle/chunks/chunk-UIWY7TU5.js +0 -42
  767. package/dist/bundle/chunks/chunk-XNGRGP62.js +0 -2
  768. package/dist/bundle/chunks/google-generative-ai-VCD2PGIY.js +0 -2
  769. package/dist/bundle/chunks/google-vertex-L6U34ZRC.js +0 -2
  770. package/dist/bundle/chunks/mistral-conversations-IXWQ2YKN.js +0 -5
  771. package/dist/bundle/chunks/node-5YXRXMVN.js +0 -16
  772. package/dist/bundle/chunks/openai-codex-responses-P7HKQLIT.js +0 -10
  773. package/dist/bundle/chunks/openai-completions-O7BFLP3U.js +0 -7
  774. package/dist/bundle/chunks/openai-responses-QAKWAYVG.js +0 -2
  775. package/dist/cli/config-selector.d.ts +0 -16
  776. package/dist/cli/config-selector.d.ts.map +0 -1
  777. package/dist/cli/config-selector.js +0 -32
  778. package/dist/cli/config-selector.js.map +0 -1
  779. package/dist/cli/session-picker.d.ts +0 -10
  780. package/dist/cli/session-picker.d.ts.map +0 -1
  781. package/dist/cli/session-picker.js +0 -36
  782. package/dist/cli/session-picker.js.map +0 -1
  783. package/dist/cli/startup-ui.d.ts +0 -20
  784. package/dist/cli/startup-ui.d.ts.map +0 -1
  785. package/dist/cli/startup-ui.js +0 -185
  786. package/dist/cli/startup-ui.js.map +0 -1
  787. package/dist/core/keybindings.d.ts +0 -428
  788. package/dist/core/keybindings.d.ts.map +0 -1
  789. package/dist/core/keybindings.js +0 -321
  790. package/dist/core/keybindings.js.map +0 -1
  791. package/dist/core/tools/render-utils.d.ts +0 -24
  792. package/dist/core/tools/render-utils.d.ts.map +0 -1
  793. package/dist/core/tools/render-utils.js +0 -65
  794. package/dist/core/tools/render-utils.js.map +0 -1
  795. package/dist/core/tools/renderers/bash.d.ts +0 -12
  796. package/dist/core/tools/renderers/bash.d.ts.map +0 -1
  797. package/dist/core/tools/renderers/bash.js +0 -130
  798. package/dist/core/tools/renderers/bash.js.map +0 -1
  799. package/dist/core/tools/renderers/edit.d.ts +0 -23
  800. package/dist/core/tools/renderers/edit.d.ts.map +0 -1
  801. package/dist/core/tools/renderers/edit.js +0 -167
  802. package/dist/core/tools/renderers/edit.js.map +0 -1
  803. package/dist/core/tools/renderers/find.d.ts +0 -10
  804. package/dist/core/tools/renderers/find.d.ts.map +0 -1
  805. package/dist/core/tools/renderers/find.js +0 -64
  806. package/dist/core/tools/renderers/find.js.map +0 -1
  807. package/dist/core/tools/renderers/grep.d.ts +0 -10
  808. package/dist/core/tools/renderers/grep.d.ts.map +0 -1
  809. package/dist/core/tools/renderers/grep.js +0 -69
  810. package/dist/core/tools/renderers/grep.js.map +0 -1
  811. package/dist/core/tools/renderers/index.d.ts +0 -28
  812. package/dist/core/tools/renderers/index.d.ts.map +0 -1
  813. package/dist/core/tools/renderers/index.js +0 -47
  814. package/dist/core/tools/renderers/index.js.map +0 -1
  815. package/dist/core/tools/renderers/ls.d.ts +0 -10
  816. package/dist/core/tools/renderers/ls.d.ts.map +0 -1
  817. package/dist/core/tools/renderers/ls.js +0 -58
  818. package/dist/core/tools/renderers/ls.js.map +0 -1
  819. package/dist/core/tools/renderers/read.d.ts +0 -11
  820. package/dist/core/tools/renderers/read.d.ts.map +0 -1
  821. package/dist/core/tools/renderers/read.js +0 -129
  822. package/dist/core/tools/renderers/read.js.map +0 -1
  823. package/dist/core/tools/renderers/write.d.ts +0 -10
  824. package/dist/core/tools/renderers/write.d.ts.map +0 -1
  825. package/dist/core/tools/renderers/write.js +0 -153
  826. package/dist/core/tools/renderers/write.js.map +0 -1
  827. package/dist/extensions/mcp/mcp-client.d.ts +0 -31
  828. package/dist/extensions/mcp/mcp-client.d.ts.map +0 -1
  829. package/dist/extensions/mcp/mcp-client.js +0 -149
  830. package/dist/extensions/mcp/mcp-client.js.map +0 -1
  831. package/dist/extensions/mcp/mcp-config.d.ts +0 -47
  832. package/dist/extensions/mcp/mcp-config.d.ts.map +0 -1
  833. package/dist/extensions/mcp/mcp-config.js +0 -281
  834. package/dist/extensions/mcp/mcp-config.js.map +0 -1
  835. package/dist/extensions/mcp/mcp-transport.d.ts +0 -65
  836. package/dist/extensions/mcp/mcp-transport.d.ts.map +0 -1
  837. package/dist/extensions/mcp/mcp-transport.js +0 -278
  838. package/dist/extensions/mcp/mcp-transport.js.map +0 -1
  839. package/dist/modes/interactive/assets/clankolas.png +0 -0
  840. package/dist/modes/interactive/chat-viewport.d.ts +0 -20
  841. package/dist/modes/interactive/chat-viewport.d.ts.map +0 -1
  842. package/dist/modes/interactive/chat-viewport.js +0 -28
  843. package/dist/modes/interactive/chat-viewport.js.map +0 -1
  844. package/dist/modes/interactive/components/armin.d.ts +0 -34
  845. package/dist/modes/interactive/components/armin.d.ts.map +0 -1
  846. package/dist/modes/interactive/components/armin.js +0 -333
  847. package/dist/modes/interactive/components/armin.js.map +0 -1
  848. package/dist/modes/interactive/components/assistant-message.d.ts +0 -26
  849. package/dist/modes/interactive/components/assistant-message.d.ts.map +0 -1
  850. package/dist/modes/interactive/components/assistant-message.js +0 -158
  851. package/dist/modes/interactive/components/assistant-message.js.map +0 -1
  852. package/dist/modes/interactive/components/bash-execution.d.ts +0 -34
  853. package/dist/modes/interactive/components/bash-execution.d.ts.map +0 -1
  854. package/dist/modes/interactive/components/bash-execution.js +0 -175
  855. package/dist/modes/interactive/components/bash-execution.js.map +0 -1
  856. package/dist/modes/interactive/components/bordered-loader.d.ts +0 -16
  857. package/dist/modes/interactive/components/bordered-loader.d.ts.map +0 -1
  858. package/dist/modes/interactive/components/bordered-loader.js +0 -54
  859. package/dist/modes/interactive/components/bordered-loader.js.map +0 -1
  860. package/dist/modes/interactive/components/branch-summary-message.d.ts +0 -16
  861. package/dist/modes/interactive/components/branch-summary-message.d.ts.map +0 -1
  862. package/dist/modes/interactive/components/branch-summary-message.js +0 -44
  863. package/dist/modes/interactive/components/branch-summary-message.js.map +0 -1
  864. package/dist/modes/interactive/components/compaction-summary-message.d.ts +0 -16
  865. package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +0 -1
  866. package/dist/modes/interactive/components/compaction-summary-message.js +0 -45
  867. package/dist/modes/interactive/components/compaction-summary-message.js.map +0 -1
  868. package/dist/modes/interactive/components/config-selector.d.ts +0 -102
  869. package/dist/modes/interactive/components/config-selector.d.ts.map +0 -1
  870. package/dist/modes/interactive/components/config-selector.js +0 -761
  871. package/dist/modes/interactive/components/config-selector.js.map +0 -1
  872. package/dist/modes/interactive/components/countdown-timer.d.ts +0 -14
  873. package/dist/modes/interactive/components/countdown-timer.d.ts.map +0 -1
  874. package/dist/modes/interactive/components/countdown-timer.js +0 -33
  875. package/dist/modes/interactive/components/countdown-timer.js.map +0 -1
  876. package/dist/modes/interactive/components/custom-editor.d.ts +0 -30
  877. package/dist/modes/interactive/components/custom-editor.d.ts.map +0 -1
  878. package/dist/modes/interactive/components/custom-editor.js +0 -115
  879. package/dist/modes/interactive/components/custom-editor.js.map +0 -1
  880. package/dist/modes/interactive/components/custom-entry.d.ts +0 -19
  881. package/dist/modes/interactive/components/custom-entry.d.ts.map +0 -1
  882. package/dist/modes/interactive/components/custom-entry.js +0 -52
  883. package/dist/modes/interactive/components/custom-entry.js.map +0 -1
  884. package/dist/modes/interactive/components/custom-message.d.ts +0 -22
  885. package/dist/modes/interactive/components/custom-message.d.ts.map +0 -1
  886. package/dist/modes/interactive/components/custom-message.js +0 -87
  887. package/dist/modes/interactive/components/custom-message.js.map +0 -1
  888. package/dist/modes/interactive/components/daxnuts.d.ts +0 -23
  889. package/dist/modes/interactive/components/daxnuts.d.ts.map +0 -1
  890. package/dist/modes/interactive/components/daxnuts.js +0 -140
  891. package/dist/modes/interactive/components/daxnuts.js.map +0 -1
  892. package/dist/modes/interactive/components/diff.d.ts +0 -12
  893. package/dist/modes/interactive/components/diff.d.ts.map +0 -1
  894. package/dist/modes/interactive/components/diff.js +0 -133
  895. package/dist/modes/interactive/components/diff.js.map +0 -1
  896. package/dist/modes/interactive/components/dynamic-border.d.ts +0 -15
  897. package/dist/modes/interactive/components/dynamic-border.d.ts.map +0 -1
  898. package/dist/modes/interactive/components/dynamic-border.js +0 -21
  899. package/dist/modes/interactive/components/dynamic-border.js.map +0 -1
  900. package/dist/modes/interactive/components/earendil-announcement.d.ts +0 -5
  901. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +0 -1
  902. package/dist/modes/interactive/components/earendil-announcement.js +0 -40
  903. package/dist/modes/interactive/components/earendil-announcement.js.map +0 -1
  904. package/dist/modes/interactive/components/extension-editor.d.ts +0 -21
  905. package/dist/modes/interactive/components/extension-editor.d.ts.map +0 -1
  906. package/dist/modes/interactive/components/extension-editor.js +0 -98
  907. package/dist/modes/interactive/components/extension-editor.js.map +0 -1
  908. package/dist/modes/interactive/components/extension-input.d.ts +0 -23
  909. package/dist/modes/interactive/components/extension-input.d.ts.map +0 -1
  910. package/dist/modes/interactive/components/extension-input.js +0 -61
  911. package/dist/modes/interactive/components/extension-input.js.map +0 -1
  912. package/dist/modes/interactive/components/extension-selector.d.ts +0 -26
  913. package/dist/modes/interactive/components/extension-selector.d.ts.map +0 -1
  914. package/dist/modes/interactive/components/extension-selector.js +0 -83
  915. package/dist/modes/interactive/components/extension-selector.js.map +0 -1
  916. package/dist/modes/interactive/components/first-time-setup.d.ts +0 -25
  917. package/dist/modes/interactive/components/first-time-setup.d.ts.map +0 -1
  918. package/dist/modes/interactive/components/first-time-setup.js +0 -103
  919. package/dist/modes/interactive/components/first-time-setup.js.map +0 -1
  920. package/dist/modes/interactive/components/footer.d.ts +0 -32
  921. package/dist/modes/interactive/components/footer.d.ts.map +0 -1
  922. package/dist/modes/interactive/components/footer.js +0 -222
  923. package/dist/modes/interactive/components/footer.js.map +0 -1
  924. package/dist/modes/interactive/components/index.d.ts +0 -34
  925. package/dist/modes/interactive/components/index.d.ts.map +0 -1
  926. package/dist/modes/interactive/components/index.js +0 -35
  927. package/dist/modes/interactive/components/index.js.map +0 -1
  928. package/dist/modes/interactive/components/keybinding-hints.d.ts +0 -13
  929. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +0 -1
  930. package/dist/modes/interactive/components/keybinding-hints.js +0 -36
  931. package/dist/modes/interactive/components/keybinding-hints.js.map +0 -1
  932. package/dist/modes/interactive/components/login-dialog.d.ts +0 -52
  933. package/dist/modes/interactive/components/login-dialog.d.ts.map +0 -1
  934. package/dist/modes/interactive/components/login-dialog.js +0 -188
  935. package/dist/modes/interactive/components/login-dialog.js.map +0 -1
  936. package/dist/modes/interactive/components/markdown-transform.d.ts +0 -3
  937. package/dist/modes/interactive/components/markdown-transform.d.ts.map +0 -1
  938. package/dist/modes/interactive/components/markdown-transform.js +0 -19
  939. package/dist/modes/interactive/components/markdown-transform.js.map +0 -1
  940. package/dist/modes/interactive/components/mermaid.d.ts +0 -11
  941. package/dist/modes/interactive/components/mermaid.d.ts.map +0 -1
  942. package/dist/modes/interactive/components/mermaid.js +0 -75
  943. package/dist/modes/interactive/components/mermaid.js.map +0 -1
  944. package/dist/modes/interactive/components/model-selector.d.ts +0 -60
  945. package/dist/modes/interactive/components/model-selector.d.ts.map +0 -1
  946. package/dist/modes/interactive/components/model-selector.js +0 -361
  947. package/dist/modes/interactive/components/model-selector.js.map +0 -1
  948. package/dist/modes/interactive/components/oauth-selector.d.ts +0 -33
  949. package/dist/modes/interactive/components/oauth-selector.d.ts.map +0 -1
  950. package/dist/modes/interactive/components/oauth-selector.js +0 -163
  951. package/dist/modes/interactive/components/oauth-selector.js.map +0 -1
  952. package/dist/modes/interactive/components/question-selector.d.ts +0 -24
  953. package/dist/modes/interactive/components/question-selector.d.ts.map +0 -1
  954. package/dist/modes/interactive/components/question-selector.js +0 -158
  955. package/dist/modes/interactive/components/question-selector.js.map +0 -1
  956. package/dist/modes/interactive/components/scoped-models-selector.d.ts +0 -46
  957. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +0 -1
  958. package/dist/modes/interactive/components/scoped-models-selector.js +0 -326
  959. package/dist/modes/interactive/components/scoped-models-selector.js.map +0 -1
  960. package/dist/modes/interactive/components/session-selector-search.d.ts +0 -23
  961. package/dist/modes/interactive/components/session-selector-search.d.ts.map +0 -1
  962. package/dist/modes/interactive/components/session-selector-search.js +0 -155
  963. package/dist/modes/interactive/components/session-selector-search.js.map +0 -1
  964. package/dist/modes/interactive/components/session-selector.d.ts +0 -95
  965. package/dist/modes/interactive/components/session-selector.d.ts.map +0 -1
  966. package/dist/modes/interactive/components/session-selector.js +0 -867
  967. package/dist/modes/interactive/components/session-selector.js.map +0 -1
  968. package/dist/modes/interactive/components/settings-selector.d.ts +0 -92
  969. package/dist/modes/interactive/components/settings-selector.d.ts.map +0 -1
  970. package/dist/modes/interactive/components/settings-selector.js +0 -709
  971. package/dist/modes/interactive/components/settings-selector.js.map +0 -1
  972. package/dist/modes/interactive/components/settings-submenu.d.ts +0 -72
  973. package/dist/modes/interactive/components/settings-submenu.d.ts.map +0 -1
  974. package/dist/modes/interactive/components/settings-submenu.js +0 -165
  975. package/dist/modes/interactive/components/settings-submenu.js.map +0 -1
  976. package/dist/modes/interactive/components/show-images-selector.d.ts +0 -10
  977. package/dist/modes/interactive/components/show-images-selector.d.ts.map +0 -1
  978. package/dist/modes/interactive/components/show-images-selector.js +0 -39
  979. package/dist/modes/interactive/components/show-images-selector.js.map +0 -1
  980. package/dist/modes/interactive/components/skill-invocation-message.d.ts +0 -17
  981. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +0 -1
  982. package/dist/modes/interactive/components/skill-invocation-message.js +0 -47
  983. package/dist/modes/interactive/components/skill-invocation-message.js.map +0 -1
  984. package/dist/modes/interactive/components/status-indicator.d.ts +0 -30
  985. package/dist/modes/interactive/components/status-indicator.d.ts.map +0 -1
  986. package/dist/modes/interactive/components/status-indicator.js +0 -67
  987. package/dist/modes/interactive/components/status-indicator.js.map +0 -1
  988. package/dist/modes/interactive/components/theme-selector.d.ts +0 -11
  989. package/dist/modes/interactive/components/theme-selector.d.ts.map +0 -1
  990. package/dist/modes/interactive/components/theme-selector.js +0 -50
  991. package/dist/modes/interactive/components/theme-selector.js.map +0 -1
  992. package/dist/modes/interactive/components/thinking-selector.d.ts +0 -23
  993. package/dist/modes/interactive/components/thinking-selector.d.ts.map +0 -1
  994. package/dist/modes/interactive/components/thinking-selector.js +0 -109
  995. package/dist/modes/interactive/components/thinking-selector.js.map +0 -1
  996. package/dist/modes/interactive/components/tool-execution.d.ts +0 -80
  997. package/dist/modes/interactive/components/tool-execution.d.ts.map +0 -1
  998. package/dist/modes/interactive/components/tool-execution.js +0 -328
  999. package/dist/modes/interactive/components/tool-execution.js.map +0 -1
  1000. package/dist/modes/interactive/components/tree-selector.d.ts +0 -94
  1001. package/dist/modes/interactive/components/tree-selector.d.ts.map +0 -1
  1002. package/dist/modes/interactive/components/tree-selector.js +0 -1245
  1003. package/dist/modes/interactive/components/tree-selector.js.map +0 -1
  1004. package/dist/modes/interactive/components/trust-selector.d.ts +0 -23
  1005. package/dist/modes/interactive/components/trust-selector.d.ts.map +0 -1
  1006. package/dist/modes/interactive/components/trust-selector.js +0 -91
  1007. package/dist/modes/interactive/components/trust-selector.js.map +0 -1
  1008. package/dist/modes/interactive/components/user-message-selector.d.ts +0 -30
  1009. package/dist/modes/interactive/components/user-message-selector.d.ts.map +0 -1
  1010. package/dist/modes/interactive/components/user-message-selector.js +0 -114
  1011. package/dist/modes/interactive/components/user-message-selector.js.map +0 -1
  1012. package/dist/modes/interactive/components/user-message.d.ts +0 -16
  1013. package/dist/modes/interactive/components/user-message.d.ts.map +0 -1
  1014. package/dist/modes/interactive/components/user-message.js +0 -49
  1015. package/dist/modes/interactive/components/user-message.js.map +0 -1
  1016. package/dist/modes/interactive/components/visual-truncate.d.ts +0 -24
  1017. package/dist/modes/interactive/components/visual-truncate.d.ts.map +0 -1
  1018. package/dist/modes/interactive/components/visual-truncate.js +0 -33
  1019. package/dist/modes/interactive/components/visual-truncate.js.map +0 -1
  1020. package/dist/modes/interactive/external-editor.d.ts +0 -12
  1021. package/dist/modes/interactive/external-editor.d.ts.map +0 -1
  1022. package/dist/modes/interactive/external-editor.js +0 -38
  1023. package/dist/modes/interactive/external-editor.js.map +0 -1
  1024. package/dist/modes/interactive/interactive-mode.d.ts +0 -443
  1025. package/dist/modes/interactive/interactive-mode.d.ts.map +0 -1
  1026. package/dist/modes/interactive/interactive-mode.js +0 -5604
  1027. package/dist/modes/interactive/interactive-mode.js.map +0 -1
  1028. package/dist/modes/interactive/model-catalog-refresh.d.ts.map +0 -1
  1029. package/dist/modes/interactive/model-catalog-refresh.js.map +0 -1
  1030. package/dist/modes/interactive/model-search.d.ts +0 -12
  1031. package/dist/modes/interactive/model-search.d.ts.map +0 -1
  1032. package/dist/modes/interactive/model-search.js +0 -15
  1033. package/dist/modes/interactive/model-search.js.map +0 -1
  1034. package/dist/modes/interactive/session-share.d.ts +0 -16
  1035. package/dist/modes/interactive/session-share.d.ts.map +0 -1
  1036. package/dist/modes/interactive/session-share.js +0 -184
  1037. package/dist/modes/interactive/session-share.js.map +0 -1
  1038. package/dist/modes/interactive/theme/dark.json +0 -91
  1039. package/dist/modes/interactive/theme/light.json +0 -90
  1040. package/dist/modes/interactive/theme/theme-controller.d.ts +0 -41
  1041. package/dist/modes/interactive/theme/theme-controller.d.ts.map +0 -1
  1042. package/dist/modes/interactive/theme/theme-controller.js +0 -130
  1043. package/dist/modes/interactive/theme/theme-controller.js.map +0 -1
  1044. package/dist/modes/interactive/theme/theme-json.d.ts +0 -84
  1045. package/dist/modes/interactive/theme/theme-json.d.ts.map +0 -1
  1046. package/dist/modes/interactive/theme/theme-json.js +0 -130
  1047. package/dist/modes/interactive/theme/theme-json.js.map +0 -1
  1048. package/dist/modes/interactive/theme/theme-schema.json +0 -356
  1049. package/dist/modes/interactive/theme/theme.d.ts +0 -131
  1050. package/dist/modes/interactive/theme/theme.d.ts.map +0 -1
  1051. package/dist/modes/interactive/theme/theme.js.map +0 -1
  1052. package/dist/modes/interactive/tui-renderer.d.ts +0 -21
  1053. package/dist/modes/interactive/tui-renderer.d.ts.map +0 -1
  1054. package/dist/modes/interactive/tui-renderer.js +0 -66
  1055. package/dist/modes/interactive/tui-renderer.js.map +0 -1
  1056. package/docs/development.md +0 -90
  1057. package/examples/extensions/border-status-editor.ts +0 -145
  1058. package/examples/extensions/built-in-tool-renderer.ts +0 -249
  1059. package/examples/extensions/custom-footer.ts +0 -64
  1060. package/examples/extensions/custom-header.ts +0 -73
  1061. package/examples/extensions/doom-overlay/README.md +0 -46
  1062. package/examples/extensions/doom-overlay/doom/build/doom.js +0 -21
  1063. package/examples/extensions/doom-overlay/doom/build/doom.wasm +0 -0
  1064. package/examples/extensions/doom-overlay/doom/build.sh +0 -152
  1065. package/examples/extensions/doom-overlay/doom/doomgeneric_pi.c +0 -72
  1066. package/examples/extensions/doom-overlay/doom-component.ts +0 -132
  1067. package/examples/extensions/doom-overlay/doom-engine.ts +0 -173
  1068. package/examples/extensions/doom-overlay/doom-keys.ts +0 -104
  1069. package/examples/extensions/doom-overlay/index.ts +0 -74
  1070. package/examples/extensions/doom-overlay/wad-finder.ts +0 -55
  1071. package/examples/extensions/entry-renderer.ts +0 -41
  1072. package/examples/extensions/github-issue-autocomplete.ts +0 -185
  1073. package/examples/extensions/handoff.ts +0 -190
  1074. package/examples/extensions/interactive-shell.ts +0 -196
  1075. package/examples/extensions/kimi-deferred-tools.ts +0 -61
  1076. package/examples/extensions/message-renderer.ts +0 -59
  1077. package/examples/extensions/minimal-mode.ts +0 -426
  1078. package/examples/extensions/modal-editor.ts +0 -85
  1079. package/examples/extensions/overlay-qa-tests.ts +0 -1450
  1080. package/examples/extensions/overlay-test.ts +0 -153
  1081. package/examples/extensions/plan-mode/README.md +0 -66
  1082. package/examples/extensions/plan-mode/index.ts +0 -390
  1083. package/examples/extensions/plan-mode/utils.ts +0 -168
  1084. package/examples/extensions/preset.ts +0 -436
  1085. package/examples/extensions/qna.ts +0 -118
  1086. package/examples/extensions/question.ts +0 -278
  1087. package/examples/extensions/questionnaire.ts +0 -440
  1088. package/examples/extensions/rainbow-editor.ts +0 -88
  1089. package/examples/extensions/snake.ts +0 -343
  1090. package/examples/extensions/space-invaders.ts +0 -560
  1091. package/examples/extensions/structured-output.ts +0 -65
  1092. package/examples/extensions/summarize.ts +0 -199
  1093. package/examples/extensions/tic-tac-toe.ts +0 -1008
  1094. package/examples/extensions/todo.ts +0 -297
  1095. package/examples/extensions/tools.ts +0 -146
  1096. package/examples/extensions/truncated-tool.ts +0 -195
  1097. package/examples/plugins/pi-example-plugin/README.md +0 -38
  1098. package/examples/plugins/pi-example-plugin/package.json +0 -10
  1099. package/examples/plugins/pi-example-plugin/src/contract.ts +0 -13
  1100. package/examples/plugins/pi-example-plugin/src/session.ts +0 -23
  1101. package/examples/plugins/pi-example-plugin/src/tui.ts +0 -31
  1102. package/examples/rpc-extension-ui.ts +0 -641
  1103. /package/dist/bundle/chunks/{chunk-PATAL4PO.js → chunk-7ZC4UXSL.js} +0 -0
@@ -1,147 +1,855 @@
1
- import { readFile } from "node:fs/promises";
2
- import * as path from "node:path";
3
- import { jsonSchemaToTypeBox, McpClient } from "./mcp-client.js";
4
- import { punchRegistryToMcpServers } from "./mcp-config.js";
5
- import { StdioMcpTransport, StreamableHttpMcpTransport } from "./mcp-transport.js";
6
- const clients = [];
7
- let extensionGeneration = 0;
8
- function trackClient(client) {
9
- clients.push(client);
1
+ /**
2
+ * Built-in MCP integration.
3
+ *
4
+ * Connects the servers from `mcp.json` and the servers extensions register with
5
+ * `pi.registerMcpServer()` when a session starts, and servers registered later right away. A server
6
+ * in `mcp.json` takes precedence over a registered server of the same name. Connections run in the
7
+ * background: the first prompt waits only for servers with `direct` tools, and codemode scripts,
8
+ * `tool_search`, and the resource tools wait for the servers they need when they run. Tools are
9
+ * registered as `mcp__<server>__<tool>`. By default (`"exposure": "codemode"`) the tools are only
10
+ * callable from codemode scripts, which keeps MCP tools out of the model's tool declarations and
11
+ * the codemode description: scripts find the tools with `searchTools()` and the server instructions
12
+ * with `describeNamespace()`. The codemode tool is activated for that unless `autoEnableCodemode` is
13
+ * false. `"deferred"` declares the tools to the model once the `tool_search` tool loads them, and
14
+ * activates `tool_search` instead of codemode.
15
+ * `"exposure": "direct"` declares them to the model right away, and `"hidden"` makes them
16
+ * unreachable. `toolExposure` overrides the exposure of single tools. Servers with resources are
17
+ * reached through Codex's `list_mcp_resources`, `list_mcp_resource_templates`, and
18
+ * `read_mcp_resource` tools (resources.ts).
19
+ *
20
+ * Every call runs through pi's tool pipeline, so `tool_call`/`tool_result` hooks and permission
21
+ * extensions apply to MCP tools the same way they do to built-in tools.
22
+ *
23
+ * Problems found at startup (config errors, failed connections, servers that need a sign-in) are
24
+ * reported once. `/mcp` shows status; its subcommands sign in, sign out, and reconnect servers.
25
+ */
26
+ import { join, resolve } from "node:path";
27
+ import { getAgentDir } from "../../config.js";
28
+ import { mcpNamespace } from "../../core/mcp-servers.js";
29
+ import { openBrowser } from "../../utils/open-browser.js";
30
+ import { CODEMODE_TOOL_NAME } from "../codemode/tool.js";
31
+ import { TOOL_SEARCH_TOOL_NAME } from "../tool-search/tool.js";
32
+ import { getMcpToolExposure, loadMcpConfig, } from "./config.js";
33
+ import { createMcpResourceToolDefinitions, LIST_MCP_RESOURCE_TEMPLATES_TOOL, LIST_MCP_RESOURCES_TOOL, READ_MCP_RESOURCE_TOOL, } from "./resources.js";
34
+ import { loadMcpRuntime } from "./runtime.lazy.js";
35
+ import { createMcpToolDefinition, createMcpToolName } from "./tools.js";
36
+ const DEFAULT_STARTUP_WAIT_MS = 10_000;
37
+ const RESOURCE_TOOL_NAMES = new Set([
38
+ LIST_MCP_RESOURCES_TOOL,
39
+ LIST_MCP_RESOURCE_TEMPLATES_TOOL,
40
+ READ_MCP_RESOURCE_TOOL,
41
+ ]);
42
+ function errorMessage(error) {
43
+ return error instanceof Error ? error.message : String(error);
10
44
  }
11
- function closeClients() {
12
- extensionGeneration++;
13
- for (const client of clients) {
14
- void client.close();
15
- }
16
- clients.length = 0;
45
+ function firstLine(text) {
46
+ return text.split("\n", 1)[0] ?? "";
17
47
  }
18
- function resolveEnvRef(value) {
19
- const match = /^\$\{([^}]+)\}$/.exec(value);
20
- if (!match)
21
- return undefined;
22
- return process.env[match[1]];
48
+ function isEnabled(server) {
49
+ return server.entry.config.enabled !== false;
23
50
  }
24
- function sanitizeHeaderValue(value) {
25
- return value.replace(/[\r\n]/g, "");
51
+ function exposureOf(entry) {
52
+ return entry.config.exposure ?? "codemode";
26
53
  }
27
- function buildTransport(entry) {
28
- if (entry.url) {
29
- const headers = {};
30
- for (const [key, value] of Object.entries(entry.headers ?? {})) {
31
- headers[key] = sanitizeHeaderValue(resolveEnvRef(value) ?? value);
32
- }
33
- if (entry.bearerTokenEnv) {
34
- const token = process.env[entry.bearerTokenEnv];
35
- if (token)
36
- headers.Authorization = `Bearer ${sanitizeHeaderValue(token)}`;
37
- }
38
- return new StreamableHttpMcpTransport({ url: entry.url, headers });
39
- }
40
- const env = {};
41
- for (const [key, value] of Object.entries(entry.env ?? {})) {
42
- env[key] = resolveEnvRef(value) ?? value;
43
- }
44
- if (entry.bearerTokenEnv) {
45
- const token = process.env[entry.bearerTokenEnv];
46
- if (token)
47
- env.API_KEY = token;
48
- }
49
- return new StdioMcpTransport({
50
- command: entry.command ?? "",
51
- args: entry.args ?? [],
52
- env,
53
- cwd: process.cwd(),
54
+ /** Exposures the server's tools can have, known from its config before it connects. */
55
+ function configuredExposures(entry) {
56
+ return new Set([exposureOf(entry), ...Object.values(entry.config.toolExposure ?? {})]);
57
+ }
58
+ /** Whether some of the server's tools are declared to the model, so the first prompt waits for them. */
59
+ function hasDirectTools(entry) {
60
+ return configuredExposures(entry).has("direct");
61
+ }
62
+ /** Whether some of the server's tools are reached through codemode or tool_search. */
63
+ function hasIndirectTools(entry) {
64
+ const exposures = configuredExposures(entry);
65
+ return exposures.has("codemode") || exposures.has("deferred");
66
+ }
67
+ /** Name of the system prompt section that lists the servers whose tools are not declared. */
68
+ export const MCP_SERVERS_SECTION = "mcp_servers";
69
+ /** Characters of a server description in the section, as Codex allows for deferred namespaces. */
70
+ const MAX_SERVER_DESCRIPTION_CHARS = 250;
71
+ /**
72
+ * Characters of the whole section. Descriptions shrink to fit; when the server lines alone do not
73
+ * fit, the last servers are left out and counted in a closing line.
74
+ */
75
+ export const MAX_SERVERS_SECTION_CHARS = 4096;
76
+ /** The section's first line. It explains only the ways of reaching tools that the listed servers use. */
77
+ function serversSectionIntro(reaches) {
78
+ let intro = "MCP servers whose tools are not declared to you.";
79
+ if (reaches.has("codemode"))
80
+ intro += " Call the tools of `codemode` servers from codemode scripts.";
81
+ if (reaches.has("tool_search"))
82
+ intro += " Load the tools of `tool_search` servers with `tool_search`.";
83
+ return intro;
84
+ }
85
+ function truncate(text, max) {
86
+ if (text.length <= max)
87
+ return text;
88
+ return max <= 1 ? "" : `${text.slice(0, max - 1).trimEnd()}…`;
89
+ }
90
+ /** First line of the configured description, or of the server instructions once connected. */
91
+ function serverSummary(server) {
92
+ const text = server.entry.config.description?.trim() || server.connection?.instructions || "";
93
+ return (text.split("\n", 1)[0] ?? "").trim();
94
+ }
95
+ /**
96
+ * The `mcp_servers` section: every enabled server with codemode or deferred tools, with how its
97
+ * tools are reached and a one-line summary. The model learns of the servers from it, since neither
98
+ * codemode nor tool_search lists them. Undefined when there are no such servers.
99
+ */
100
+ export function renderServersSection(servers) {
101
+ const listed = servers
102
+ .filter((server) => isEnabled(server) && hasIndirectTools(server.entry))
103
+ .sort((a, b) => a.entry.name.localeCompare(b.entry.name));
104
+ if (listed.length === 0)
105
+ return undefined;
106
+ const reaches = listed.map((server) => configuredExposures(server.entry).has("codemode") ? "codemode" : "tool_search");
107
+ const intro = serversSectionIntro(new Set(reaches));
108
+ const heads = listed.map((server, index) => `- ${mcpNamespace(server.entry.name)} (${reaches[index]})`);
109
+ const omitted = (count) => count > 0 ? [`- … ${count} more server${count === 1 ? "" : "s"}; find their tools with searchTools()`] : [];
110
+ // Characters of the intro, the first `kept` server lines without descriptions, and the omission line.
111
+ const size = (kept) => [intro, ...heads.slice(0, kept), ...omitted(listed.length - kept)].join("\n").length;
112
+ let kept = listed.length;
113
+ while (kept > 0 && size(kept) > MAX_SERVERS_SECTION_CHARS)
114
+ kept--;
115
+ // Each description also takes a ": " separator.
116
+ const perServer = kept === 0
117
+ ? 0
118
+ : Math.min(MAX_SERVER_DESCRIPTION_CHARS, Math.floor((MAX_SERVERS_SECTION_CHARS - size(kept)) / kept) - 2);
119
+ const lines = listed.slice(0, kept).map((server, index) => {
120
+ const summary = perServer > 0 ? truncate(serverSummary(server), perServer) : "";
121
+ return summary ? `${heads[index]}: ${summary}` : heads[index];
54
122
  });
123
+ return [intro, ...lines, ...omitted(listed.length - kept)].join("\n");
55
124
  }
56
- async function registerMcpServer(pi, name, entry, generation) {
57
- if (entry.disabled)
58
- return;
59
- const client = new McpClient(buildTransport(entry));
60
- trackClient(client);
61
- let tools;
62
- try {
63
- await client.start();
64
- if (generation !== extensionGeneration) {
65
- void client.close();
66
- return;
67
- }
68
- tools = await client.listTools();
69
- if (generation !== extensionGeneration) {
70
- void client.close();
71
- return;
125
+ /**
126
+ * Whether a call that reaches `reach` (see `ToolDefinition.reachesTools`) needs the server: it
127
+ * reaches every tool, or one of its words contains the server's namespace.
128
+ */
129
+ function reachesServer(reach, server) {
130
+ if (reach === "all")
131
+ return true;
132
+ const namespace = mcpNamespace(server);
133
+ return reach.some((word) => word.includes(namespace));
134
+ }
135
+ /** Short state for lists and the startup report. `withError` appends the first line of a failure. */
136
+ function describeState(server, withError = true) {
137
+ if (!isEnabled(server))
138
+ return "disabled";
139
+ const connection = server.connection;
140
+ if (!connection)
141
+ return "starting";
142
+ switch (connection.state) {
143
+ case "needs-auth":
144
+ return "needs sign-in";
145
+ case "failed":
146
+ return withError ? `failed: ${firstLine(connection.error ?? "unknown error")}` : "failed";
147
+ case "connected": {
148
+ const { tools, hasResources } = connection;
149
+ return `connected · ${tools.length} tool${tools.length === 1 ? "" : "s"}${hasResources ? " · resources" : ""}`;
72
150
  }
151
+ case "connecting":
152
+ return "connecting…";
153
+ default:
154
+ return connection.state;
73
155
  }
74
- catch (err) {
75
- void client.close();
76
- if (generation !== extensionGeneration)
77
- return;
78
- pi.sendUserMessage(`mcp: failed to connect to server "${name}": ${err.message}`);
79
- return;
80
- }
81
- for (const tool of tools) {
82
- const toolName = `mcp__${name}__${tool.name}`;
83
- let parameters;
84
- try {
85
- parameters = jsonSchemaToTypeBox(tool.inputSchema);
86
- }
87
- catch (err) {
88
- pi.sendUserMessage(`mcp: skipped tool "${name}.${tool.name}": ${err.message}`);
89
- continue;
90
- }
91
- pi.registerTool({
92
- name: toolName,
93
- label: tool.name,
94
- description: tool.description ?? `MCP tool from server ${name}`,
95
- parameters,
96
- async execute(_toolCallId, args, _signal, _onUpdate, _ctx) {
156
+ }
157
+ const MCP_USAGE = "Usage: /mcp, /mcp login [server], /mcp logout [server], /mcp reconnect [server]";
158
+ export function createMcpExtension(options = {}) {
159
+ return (pi) => {
160
+ let servers = [];
161
+ /** Servers from `mcp.json`, which take precedence over registered servers of the same name. */
162
+ let configuredEntries = [];
163
+ let configErrors = [];
164
+ /** Registered servers that `mcp.json` overrides, shown in `/mcp`. */
165
+ let overridden = [];
166
+ let autoEnableCodemode = true;
167
+ /** Whether the "codemode tools unreachable" warning was shown since the session started. */
168
+ let warnedUnreachable = false;
169
+ let pending;
170
+ /** Whether a prompt already waited for the startup connections since the session started. */
171
+ let waitedForStartup = false;
172
+ const startupWaitMs = options.startupWaitMs ?? DEFAULT_STARTUP_WAIT_MS;
173
+ /** Working directory of the session, for stdio servers. */
174
+ let sessionCwd = process.cwd();
175
+ let credentials = options.credentials;
176
+ /** The session's model registry, which resolves `auth.provider` tokens. */
177
+ let modelRegistry;
178
+ let serverLog;
179
+ const openUrl = options.openUrl ?? openBrowser;
180
+ /**
181
+ * Lifetime of the current session: aborted on session_shutdown, and before the first session_start
182
+ * (registrations before that are read on session_start). Work captures `session.signal` when it
183
+ * starts and drops late results once it aborted, for example a runtime load that resolves after
184
+ * shutdown. Work that outlives the command that started it also stops on the signal and is
185
+ * registered with `track`, so shutdown can wait for its cleanup.
186
+ */
187
+ let session = new AbortController();
188
+ session.abort();
189
+ /** Work registered with `track`: sign-ins, which shutdown waits for. */
190
+ const backgroundActions = new Set();
191
+ const track = (work) => {
192
+ const task = work.then(() => undefined, () => undefined);
193
+ backgroundActions.add(task);
194
+ void task.finally(() => backgroundActions.delete(task));
195
+ return work;
196
+ };
197
+ const connections = () => servers.flatMap((server) => (server.connection ? [server.connection] : []));
198
+ const findServer = (name) => servers.find((server) => server.entry.name === name);
199
+ /** Servers extensions registered, except names `mcp.json` defines, which take precedence. */
200
+ const registeredServers = () => {
201
+ const registered = [];
202
+ const overriddenNames = [];
203
+ for (const { name, config, extensionPath } of pi.getMcpServers()) {
204
+ const configured = configuredEntries.find((entry) => mcpNamespace(entry.name) === mcpNamespace(name));
205
+ if (configured) {
206
+ overriddenNames.push(`"${name}" registered by ${extensionPath} is overridden by "${configured.name}" in ${configured.source}`);
207
+ continue;
208
+ }
209
+ registered.push({
210
+ entry: { name, config, source: extensionPath, scope: "extension" },
211
+ registeredConfig: JSON.stringify(config),
212
+ });
213
+ }
214
+ return { servers: registered, overridden: overriddenNames };
215
+ };
216
+ const getCredentials = (runtime) => {
217
+ credentials ??= new runtime.McpOAuthCredentialStore();
218
+ return credentials;
219
+ };
220
+ const getServerLog = (runtime) => {
221
+ serverLog ??= new runtime.McpServerLog(options.logPath ?? join(getAgentDir(), "mcp.log"));
222
+ return serverLog;
223
+ };
224
+ /** pi tool name to the `<server>\0<tool>` it was assigned to, so names stay unique and stable. */
225
+ const toolOwners = new Map();
226
+ /** Tool names currently offered by each server. */
227
+ const serverTools = new Map();
228
+ /** Last definition registered under each tool name, to re-register withdrawn tools as hidden. */
229
+ const definitions = new Map();
230
+ const registerTools = (connection) => {
231
+ const server = connection.entry.name;
232
+ const entry = findServer(server)?.entry ?? connection.entry;
233
+ const description = entry.config.description?.trim();
234
+ const namespace = {
235
+ name: mcpNamespace(server),
236
+ // `describeNamespace("docs")` finds `mcp__docs`.
237
+ aliases: [server],
238
+ ...(description ? { description } : {}),
239
+ ...(connection.instructions ? { instructions: connection.instructions } : {}),
240
+ };
241
+ const previous = serverTools.get(server) ?? new Set();
242
+ const current = new Set();
243
+ // Like Codex, all tools whose names sanitize to the same name get the hash suffix, so which
244
+ // one would keep the plain name does not depend on the order of the list.
245
+ const plain = [...new Set(connection.tools.map((tool) => tool.name))].map((tool) => createMcpToolName(server, tool));
246
+ const assignName = (tool, owner) => {
247
+ const name = createMcpToolName(server, tool, (candidate) => {
248
+ const existing = toolOwners.get(candidate);
249
+ return ((existing !== undefined && existing !== owner) ||
250
+ current.has(candidate) ||
251
+ plain.indexOf(candidate) !== plain.lastIndexOf(candidate));
252
+ });
253
+ toolOwners.set(name, owner);
254
+ current.add(name);
255
+ return name;
256
+ };
257
+ for (const tool of connection.tools) {
258
+ const definition = createMcpToolDefinition({
259
+ server,
260
+ tool,
261
+ name: assignName(tool.name, `${server}\0${tool.name}`),
262
+ exposure: getMcpToolExposure(entry.config, tool.name),
263
+ namespace,
264
+ timeoutMs: connection.timeoutMs,
265
+ getClient: async () => {
266
+ // A prepared call can outlive this definition's connection while the readiness
267
+ // hook waits for a disable/re-enable. Resolve the replacement at execution time.
268
+ const current = findServer(server);
269
+ if (!current || !isEnabled(current))
270
+ throw new Error(`MCP server "${server}" is disabled.`);
271
+ const client = current.connection;
272
+ if (!client)
273
+ throw new Error(`MCP server "${server}" is still starting.`);
274
+ if (getMcpToolExposure(current.entry.config, tool.name) === "hidden" ||
275
+ (client.state === "connected" && !client.tools.some((offered) => offered.name === tool.name))) {
276
+ throw new Error(`MCP tool "${server}/${tool.name}" is no longer available.`);
277
+ }
278
+ return client;
279
+ },
280
+ readableResources: () => resourceServers().some((current) => current.name === server),
281
+ });
282
+ definitions.set(definition.name, definition);
283
+ pi.registerTool(definition);
284
+ }
285
+ serverTools.set(server, current);
286
+ // Tools cannot be unregistered, so tools the server dropped are re-registered as hidden. When
287
+ // the server offers them again they are registered with their configured exposure above.
288
+ for (const name of previous) {
289
+ const definition = definitions.get(name);
290
+ if (!current.has(name) && definition)
291
+ pi.registerTool({ ...definition, exposure: "hidden" });
292
+ }
293
+ syncResourceTools();
294
+ };
295
+ /** Make a disabled server's tools unreachable. */
296
+ const hideTools = (server) => {
297
+ for (const name of serverTools.get(server) ?? []) {
298
+ const definition = definitions.get(name);
299
+ if (definition)
300
+ pi.registerTool({ ...definition, exposure: "hidden" });
301
+ }
302
+ serverTools.set(server, new Set());
303
+ syncResourceTools();
304
+ };
305
+ /** Enabled servers with resources whose exposure is not `hidden`, which the resource tools reach. */
306
+ const serversWithResources = () => servers.filter((server) => server.connection?.hasResources && isEnabled(server) && exposureOf(server.entry) !== "hidden");
307
+ const resourceServers = () => serversWithResources().flatMap((server) => (server.connection ? [server.connection] : []));
308
+ /** Exposure the resource tools were last registered with; undefined until a server has resources. */
309
+ let resourceToolsExposure;
310
+ /**
311
+ * Register the resource tools with the widest exposure of the servers they reach: `direct` when
312
+ * one of them is direct, and so on. They are hidden when no server has resources.
313
+ */
314
+ const syncResourceTools = () => {
315
+ const exposures = new Set(serversWithResources().map((server) => exposureOf(server.entry)));
316
+ const exposure = ["direct", "codemode", "deferred"].find((candidate) => exposures.has(candidate));
317
+ const next = exposure ?? "hidden";
318
+ if (next === resourceToolsExposure || (resourceToolsExposure === undefined && next === "hidden"))
319
+ return;
320
+ const wasDirect = resourceToolsExposure === "direct";
321
+ resourceToolsExposure = next;
322
+ const resourceDefinitions = createMcpResourceToolDefinitions({ exposure: next, servers: resourceServers });
323
+ for (const definition of resourceDefinitions)
324
+ pi.registerTool(definition);
325
+ if (wasDirect) {
326
+ const names = new Set(resourceDefinitions.map((definition) => definition.name));
327
+ pi.setActiveTools(pi.getActiveTools().filter((name) => !names.has(name)));
328
+ }
329
+ };
330
+ /**
331
+ * Tools that are not declared to the model are reached through the codemode tool (scripts call
332
+ * them) or the tool_search tool (it declares them). Either reaches every such tool. Activate the
333
+ * one the tools' exposure asks for: codemode for `codemode` unless `autoEnableCodemode` is false,
334
+ * tool_search for `deferred`.
335
+ */
336
+ const ensureDiscoveryActive = (ctx) => {
337
+ // From the config, so the tool is active before the servers connect. Resource tools share
338
+ // their server's exposure.
339
+ const exposures = new Set();
340
+ for (const server of servers) {
341
+ if (isEnabled(server))
342
+ for (const exposure of configuredExposures(server.entry))
343
+ exposures.add(exposure);
344
+ }
345
+ const needsCodemode = exposures.has("codemode");
346
+ const needsToolSearch = exposures.has("deferred");
347
+ if (!needsCodemode && !needsToolSearch)
348
+ return;
349
+ // Only a tool of these names that declares `reachesTools` can reach MCP tools; another
350
+ // extension's tool of the same name without it is never activated.
351
+ const tools = pi.getAllTools();
352
+ const hasReachingTool = (name) => tools.some((tool) => tool.name === name && tool.reachesTools);
353
+ const hasCodemode = hasReachingTool(CODEMODE_TOOL_NAME);
354
+ const hasToolSearch = hasReachingTool(TOOL_SEARCH_TOOL_NAME);
355
+ const active = pi.getActiveTools();
356
+ const activate = [];
357
+ if (needsCodemode && hasCodemode && autoEnableCodemode && !active.includes(CODEMODE_TOOL_NAME)) {
358
+ activate.push(CODEMODE_TOOL_NAME);
359
+ }
360
+ if (needsToolSearch && hasToolSearch && !active.includes(TOOL_SEARCH_TOOL_NAME)) {
361
+ activate.push(TOOL_SEARCH_TOOL_NAME);
362
+ }
363
+ if (activate.length > 0)
364
+ pi.setActiveTools([...active, ...activate]);
365
+ const reachable = [...active, ...activate];
366
+ if (hasCodemode && reachable.includes(CODEMODE_TOOL_NAME))
367
+ return;
368
+ if (hasToolSearch && reachable.includes(TOOL_SEARCH_TOOL_NAME))
369
+ return;
370
+ if (warnedUnreachable)
371
+ return;
372
+ warnedUnreachable = true;
373
+ const reason = needsCodemode && hasCodemode && !autoEnableCodemode ? " (autoEnableCodemode is false)" : "";
374
+ ctx.ui.notify(`MCP tools are only reachable from the codemode or tool_search tool, but neither is active${reason}; they cannot be called.`, "warning");
375
+ };
376
+ /**
377
+ * Stored tokens of servers waiting for a sign-in, as they were when the sign-in was needed.
378
+ * `pi mcp login` in another process (for example run by the agent) changes them.
379
+ */
380
+ const tokensAtSignIn = new Map();
381
+ const storedTokens = (connection) => {
382
+ const url = connection.oauthUrl;
383
+ return url && credentials ? JSON.stringify(credentials.tokens(connection.name, url) ?? null) : "null";
384
+ };
385
+ const onConnectionChange = (connection) => {
386
+ if (connection.state !== "needs-auth")
387
+ tokensAtSignIn.delete(connection);
388
+ else if (!tokensAtSignIn.has(connection))
389
+ tokensAtSignIn.set(connection, storedTokens(connection));
390
+ };
391
+ /** Reconnect servers that need a sign-in when their credentials were stored since. */
392
+ const reconnectSignedIn = async (ctx) => {
393
+ const signedIn = [...tokensAtSignIn].filter(([connection, tokens]) => storedTokens(connection) !== tokens);
394
+ if (signedIn.length === 0)
395
+ return;
396
+ for (const [connection] of signedIn)
397
+ tokensAtSignIn.delete(connection);
398
+ await Promise.allSettled(signedIn.map(([connection]) => connection.reconnect()));
399
+ ensureDiscoveryActive(ctx);
400
+ };
401
+ /** Create the server's connection, loading the MCP runtime on first use. */
402
+ const createConnection = async (server, isCurrent) => {
403
+ const runtime = await loadMcpRuntime();
404
+ if (!isCurrent())
405
+ return undefined;
406
+ const connection = new runtime.McpServerConnection({
407
+ entry: server.entry,
408
+ cwd: sessionCwd,
409
+ createTransport: options.createTransport ?? runtime.createDefaultTransport,
410
+ credentials: getCredentials(runtime),
411
+ providerToken: async (provider) => modelRegistry?.getApiKeyForProvider(provider),
412
+ log: getServerLog(runtime),
413
+ onTools: (connection) => {
414
+ if (isCurrent())
415
+ registerTools(connection);
416
+ },
417
+ onChange: (connection) => {
418
+ if (isCurrent())
419
+ onConnectionChange(connection);
420
+ else
421
+ tokensAtSignIn.delete(connection);
422
+ },
423
+ });
424
+ server.connection = connection;
425
+ return connection;
426
+ };
427
+ /**
428
+ * Connect the server in the background. `server.ready` settles when it connected or failed;
429
+ * failures show in its state. It starts after `after`, unless disabled, replaced, or shut down
430
+ * meanwhile. The returned promise rejects when the MCP runtime cannot be loaded.
431
+ */
432
+ const startConnection = (server, after) => {
433
+ const { signal } = session;
434
+ const attempt = Symbol();
435
+ server.attempt = attempt;
436
+ const isCurrent = () => !signal.aborted && server.attempt === attempt && isEnabled(server) && servers.includes(server);
437
+ const ready = (async () => {
438
+ await after;
439
+ if (!isCurrent())
440
+ return;
441
+ const connection = await createConnection(server, isCurrent);
442
+ if (!connection || !isCurrent())
443
+ return;
444
+ await connection.getClient().catch(() => undefined);
445
+ })();
446
+ server.ready = ready.catch(() => undefined);
447
+ return ready;
448
+ };
449
+ /** Wait for the latest connection attempts, including ones queued while waiting, or an abort. */
450
+ const waitForServers = async (waiting, signal) => {
451
+ for (;;) {
452
+ const ready = waiting.flatMap((server) => isEnabled(server) && servers.includes(server) && server.ready ? [{ server, ready: server.ready }] : []);
453
+ if (ready.length === 0 || signal?.aborted)
454
+ return;
455
+ let onAbort;
456
+ await Promise.race([
457
+ Promise.all(ready.map((attempt) => attempt.ready)),
458
+ new Promise((resolve) => {
459
+ onAbort = () => resolve();
460
+ signal?.addEventListener("abort", onAbort, { once: true });
461
+ }),
462
+ ]);
463
+ if (onAbort)
464
+ signal?.removeEventListener("abort", onAbort);
465
+ if (signal?.aborted ||
466
+ ready.every((attempt) => !isEnabled(attempt.server) ||
467
+ !servers.includes(attempt.server) ||
468
+ attempt.ready === attempt.server.ready))
469
+ return;
470
+ }
471
+ };
472
+ /**
473
+ * One message for everything that needs the user after startup, or only for `only`, servers
474
+ * that connected later.
475
+ */
476
+ const reportProblems = (ctx, only) => {
477
+ const lines = only ? [] : configErrors.map((error) => `config: ${error}`);
478
+ for (const server of only ?? servers) {
479
+ const state = server.connection?.state;
480
+ if (state === "needs-auth" || state === "failed")
481
+ lines.push(`${server.entry.name}: ${describeState(server)}`);
482
+ }
483
+ if (lines.length === 0)
484
+ return;
485
+ ctx.ui.notify(`MCP servers need attention:\n${lines.map((line) => ` ${line}`).join("\n")}\nRun /mcp to fix.`, "warning");
486
+ };
487
+ /** Sign in, then reconnect. Returns an error message on failure. The session's end stops the sign-in. */
488
+ const signIn = async (server, prompt) => {
489
+ const connection = server.connection;
490
+ const url = connection?.oauthUrl;
491
+ if (!connection || !url)
492
+ return `MCP server "${server.entry.name}" does not use OAuth.`;
493
+ const runtime = await loadMcpRuntime();
494
+ try {
495
+ await track(runtime.signInMcpServer({
496
+ serverUrl: url,
497
+ store: getCredentials(runtime).forServer(server.entry.name, url),
498
+ settings: connection.oauthSettings(),
499
+ challenge: connection.challenge,
500
+ prompt,
501
+ signal: session.signal,
502
+ }));
503
+ }
504
+ catch (error) {
505
+ if (error instanceof runtime.McpSignInCancelledError)
506
+ return "Sign-in cancelled.";
507
+ return `Sign-in failed: ${errorMessage(error)}`;
508
+ }
509
+ // The challenge that asked for this sign-in (for example for more scope) is answered.
510
+ connection.challenge = undefined;
511
+ try {
512
+ await connection.reconnect();
513
+ }
514
+ catch (error) {
515
+ return `Signed in, but ${errorMessage(error)}`;
516
+ }
517
+ return undefined;
518
+ };
519
+ const signOut = async (server) => {
520
+ const connection = server.connection;
521
+ const url = connection?.oauthUrl;
522
+ if (!connection || !url)
523
+ return false;
524
+ const removed = getCredentials(await loadMcpRuntime()).remove(server.entry.name, url);
525
+ await connection.signOut();
526
+ return removed;
527
+ };
528
+ const reconnect = async (server) => {
529
+ const connection = server.connection;
530
+ if (!connection)
531
+ return `MCP server "${server.entry.name}" is disabled.`;
532
+ const previous = server.ready;
533
+ const ready = (async () => {
534
+ await previous;
535
+ await connection.reconnect();
536
+ })();
537
+ server.ready = ready.catch(() => undefined);
538
+ try {
539
+ await ready;
540
+ return undefined;
541
+ }
542
+ catch (error) {
543
+ return errorMessage(error);
544
+ }
545
+ };
546
+ // ---------------------------------------------------------------------------------------
547
+ // Subcommands and plain status (no TUI)
548
+ // ---------------------------------------------------------------------------------------
549
+ const formatStatus = () => {
550
+ if (servers.length === 0 && configErrors.length === 0 && overridden.length === 0) {
551
+ return `No MCP servers configured. Add them to ${resolve(getAgentDir(), "mcp.json")} or .pi/mcp.json.`;
552
+ }
553
+ const lines = servers.map((server) => {
554
+ const { name } = server.entry;
555
+ const exposure = exposureOf(server.entry);
556
+ const connection = server.connection;
557
+ if (connection?.state === "needs-auth")
558
+ return `${name}: needs sign-in, run /mcp login ${name} (${exposure})`;
559
+ const tools = connection?.state === "connected" ? `, ${connection.tools.length} tools` : "";
560
+ const state = !isEnabled(server)
561
+ ? "disabled"
562
+ : connection?.state === "disconnected"
563
+ ? "disconnected, reconnects on next call"
564
+ : (connection?.state ?? "starting");
565
+ const error = connection?.error && connection.state !== "connected"
566
+ ? `\n ${connection.error.split("\n").join("\n ")}`
567
+ : "";
568
+ return `${name}: ${state}${tools} (${exposure})${error}`;
569
+ });
570
+ for (const error of configErrors)
571
+ lines.push(`config error: ${error}`);
572
+ for (const line of overridden)
573
+ lines.push(`overridden: ${line}`);
574
+ return lines.join("\n");
575
+ };
576
+ /** Resolve the server for a subcommand, asking when the name is omitted and ambiguous. */
577
+ const pickServer = async (name, ctx, options) => {
578
+ if (name) {
579
+ const server = findServer(name);
580
+ if (!server)
581
+ ctx.ui.notify(`No MCP server named "${name}".`, "error");
582
+ else if (!options.eligible(server))
583
+ ctx.ui.notify(options.none, "error");
584
+ return server && options.eligible(server) ? server : undefined;
585
+ }
586
+ const candidates = servers.filter(options.eligible);
587
+ if (candidates.length === 0) {
588
+ ctx.ui.notify(options.none, "info");
589
+ return undefined;
590
+ }
591
+ const preferred = candidates.filter(options.preferred);
592
+ if (candidates.length === 1)
593
+ return candidates[0];
594
+ if (preferred.length === 1)
595
+ return preferred[0];
596
+ const choice = await ctx.ui.select("MCP server", candidates.map((server) => server.entry.name));
597
+ return candidates.find((server) => server.entry.name === choice);
598
+ };
599
+ const usesOAuth = (server) => server.connection?.oauthUrl !== undefined;
600
+ const oauthPick = {
601
+ eligible: usesOAuth,
602
+ preferred: (server) => server.connection?.state === "needs-auth",
603
+ none: "No enabled MCP server uses OAuth. Only HTTP servers without an Authorization header do.",
604
+ };
605
+ const loginCommand = async (server, ctx) => {
606
+ const { name } = server.entry;
607
+ if (!ctx.hasUI) {
608
+ ctx.ui.notify(`Signing in to MCP server "${name}" requires an interactive RPC client.`, "error");
609
+ return;
610
+ }
611
+ const { signal } = session;
612
+ const failure = await signIn(server, {
613
+ showAuthorizationUrl: (url) => {
614
+ ctx.ui.notify(`Sign in to MCP server "${name}" in your browser:\n${url.href}`, "info");
615
+ openUrl(url.href);
616
+ },
617
+ promptForRedirectUrl: (signal) => ctx.ui.input(`Waiting for sign-in to "${name}". If the browser cannot reach this machine, paste the URL it was redirected to.`, "http://127.0.0.1:.../callback?code=...", { signal }),
618
+ });
619
+ // The session ended meanwhile, which cancelled the sign-in and made ctx stale.
620
+ if (signal.aborted)
621
+ return;
622
+ if (failure) {
623
+ ctx.ui.notify(failure, failure === "Sign-in cancelled." ? "info" : "error");
624
+ return;
625
+ }
626
+ ensureDiscoveryActive(ctx);
627
+ ctx.ui.notify(`Signed in to MCP server "${name}" (${server.connection?.tools.length ?? 0} tools).`, "info");
628
+ };
629
+ pi.on("session_start", (_event, ctx) => {
630
+ const loaded = (options.loadConfig ?? defaultLoadConfig)(ctx);
631
+ configErrors = loaded.errors;
632
+ autoEnableCodemode = loaded.autoEnableCodemode ?? true;
633
+ warnedUnreachable = false;
634
+ waitedForStartup = false;
635
+ sessionCwd = ctx.cwd;
636
+ modelRegistry = ctx.modelRegistry;
637
+ session = new AbortController();
638
+ const { signal } = session;
639
+ configuredEntries = loaded.servers;
640
+ const registered = registeredServers();
641
+ overridden = registered.overridden;
642
+ servers = [...loaded.servers.map((entry) => ({ entry })), ...registered.servers];
643
+ // Codemode or tool_search is activated from the config: the first prompt does not wait for
644
+ // servers whose tools are not declared to the model, and scripts or searches wait for them.
645
+ ensureDiscoveryActive(ctx);
646
+ const enabled = servers.filter(isEnabled);
647
+ if (enabled.length === 0) {
648
+ reportProblems(ctx);
649
+ return;
650
+ }
651
+ // The MCP client loads only now, so sessions without servers never pay for it. Waiting one
652
+ // event loop turn lets the first render happen before loading and connecting.
653
+ const runtime = new Promise((resolve) => setImmediate(resolve)).then(() => loadMcpRuntime());
654
+ pending = Promise.all(enabled.map((server) => startConnection(server, runtime)))
655
+ .then(() => {
656
+ if (!signal.aborted)
657
+ reportProblems(ctx);
658
+ })
659
+ .catch((error) => {
660
+ // The session may have been disposed meanwhile, which makes ctx stale.
97
661
  try {
98
- const result = await client.callTool(tool.name, args);
99
- const text = result.content
100
- ?.map((c) => c.text ?? "")
101
- .filter(Boolean)
102
- .join("\n") ?? "";
103
- const images = result.content
104
- ?.filter((c) => c.type === "image" && typeof c.data === "string")
105
- .map((c) => ({ type: "image", data: c.data, mimeType: c.mimeType ?? "image/png" }));
106
- const content = images && images.length > 0 ? images : [{ type: "text", text: text || "(no text output)" }];
107
- return {
108
- content,
109
- details: { server: name, tool: tool.name },
110
- ...(result.isError === true ? { isError: true } : {}),
111
- };
662
+ ctx.ui.notify(`MCP failed to load: ${errorMessage(error)}`, "error");
663
+ }
664
+ catch { }
665
+ });
666
+ });
667
+ // The first prompt waits for servers whose tools are declared to the model, so they are declared
668
+ // in its first request, but not indefinitely: a slow or hanging server must not hold up the
669
+ // prompt. Other servers are waited for when a script or search needs them (below).
670
+ const waitForDirectServers = async (ctx) => {
671
+ if (waitedForStartup)
672
+ return;
673
+ waitedForStartup = true;
674
+ const ready = servers.flatMap((server) => isEnabled(server) && hasDirectTools(server.entry) && server.ready ? [server.ready] : []);
675
+ if (ready.length === 0)
676
+ return;
677
+ let timer;
678
+ const finished = await Promise.race([
679
+ Promise.all(ready).then(() => true),
680
+ new Promise((resolve) => {
681
+ timer = setTimeout(() => resolve(false), startupWaitMs);
682
+ }),
683
+ ]);
684
+ clearTimeout(timer);
685
+ if (!finished) {
686
+ ctx.ui.notify("MCP servers are still connecting; their tools become available once connected.", "info");
687
+ }
688
+ };
689
+ // Every prompt lists the servers in the `mcp_servers` section as they are when it starts. Pi
690
+ // appends the section to the conversation when it changed, for example after a server connected.
691
+ pi.on("before_agent_start", async (event, ctx) => {
692
+ await waitForDirectServers(ctx);
693
+ const { sections } = event.systemPromptOptions;
694
+ const section = renderServersSection(servers);
695
+ if (section)
696
+ sections[MCP_SERVERS_SECTION] = section;
697
+ else
698
+ delete sections[MCP_SERVERS_SECTION];
699
+ });
700
+ // A tool that reaches other tools (`reachesTools`) waits for the servers it may reach, so their
701
+ // tools are registered before it runs: a codemode script for the servers it names, or for every
702
+ // server when it searches or enumerates tools, and tool_search for every server. The resource
703
+ // tools reach every server, so they wait for all of them. Direct MCP calls wait only for their
704
+ // own server, including a reconnect still closing its old transport.
705
+ pi.on("tool_call", async (event, ctx) => {
706
+ const tool = pi.getAllTools().find((candidate) => candidate.name === event.toolName);
707
+ if (!tool)
708
+ return;
709
+ // Readiness can be pending while the display state is still connected: reconnect first
710
+ // closes the old transport, then opens a new one. Settled promises return immediately.
711
+ const readyServers = servers.filter((server) => isEnabled(server) && server.ready);
712
+ if (readyServers.length === 0)
713
+ return;
714
+ let waiting = [];
715
+ const reach = tool.reachesTools?.(event.input);
716
+ if (reach !== undefined) {
717
+ waiting = readyServers.filter((server) => reachesServer(reach, server.entry.name));
718
+ }
719
+ else if (RESOURCE_TOOL_NAMES.has(tool.name)) {
720
+ waiting = readyServers;
721
+ }
722
+ else {
723
+ const owner = toolOwners.get(event.toolName)?.split("\0", 1)[0];
724
+ waiting = readyServers.filter((server) => server.entry.name === owner);
725
+ }
726
+ await waitForServers(waiting, ctx.signal);
727
+ });
728
+ // Pick up sign-ins done outside the session, such as `pi mcp login` run by the agent.
729
+ pi.on("turn_start", async (_event, ctx) => {
730
+ if (tokensAtSignIn.size > 0)
731
+ await reconnectSignedIn(ctx);
732
+ });
733
+ // Servers registered or unregistered during the session connect or disconnect right away.
734
+ pi.on("mcp_servers_change", async (_event, ctx) => {
735
+ const { signal } = session;
736
+ if (signal.aborted)
737
+ return;
738
+ const registered = registeredServers();
739
+ overridden = registered.overridden;
740
+ const next = new Map(registered.servers.map((server) => [server.entry.name, server]));
741
+ // Unregistered servers and re-registered ones with a new config are dropped; the latter come back below.
742
+ const removed = servers.filter((server) => server.entry.scope === "extension" &&
743
+ next.get(server.entry.name)?.registeredConfig !== server.registeredConfig);
744
+ servers = servers.filter((server) => !removed.includes(server));
745
+ for (const server of removed)
746
+ hideTools(server.entry.name);
747
+ const added = registered.servers.filter((server) => !findServer(server.entry.name));
748
+ servers.push(...added);
749
+ ensureDiscoveryActive(ctx);
750
+ await Promise.all(removed.map((server) => server.connection?.close()));
751
+ const connecting = added.filter(isEnabled);
752
+ if (signal.aborted || connecting.length === 0)
753
+ return;
754
+ try {
755
+ await Promise.all(connecting.map((server) => startConnection(server)));
756
+ if (signal.aborted) {
757
+ await Promise.all(connecting.map((server) => server.connection?.close()));
758
+ return;
759
+ }
760
+ }
761
+ catch (error) {
762
+ ctx.ui.notify(`MCP failed to load: ${errorMessage(error)}`, "error");
763
+ return;
764
+ }
765
+ if (signal.aborted)
766
+ return;
767
+ reportProblems(ctx, connecting);
768
+ });
769
+ pi.on("session_shutdown", async () => {
770
+ session.abort();
771
+ const closing = connections();
772
+ servers = [];
773
+ await Promise.all([...backgroundActions, ...closing.map((connection) => connection.close())]);
774
+ });
775
+ pi.registerCommand("mcp", {
776
+ description: "Manage MCP servers: sign in, reconnect, enable or disable, and change exposure",
777
+ getArgumentCompletions: (prefix) => {
778
+ const [action, server, ...rest] = prefix.trimStart().split(/\s+/);
779
+ if (rest.length > 0)
780
+ return null;
781
+ if (server === undefined) {
782
+ return ["login", "logout", "reconnect"]
783
+ .filter((item) => item.startsWith(action ?? ""))
784
+ .map((item) => ({ value: `${item} `, label: item }));
785
+ }
786
+ if (action !== "login" && action !== "logout" && action !== "reconnect")
787
+ return null;
788
+ const items = servers
789
+ .filter((candidate) => action === "reconnect" ? candidate.connection !== undefined : usesOAuth(candidate))
790
+ .filter((candidate) => candidate.entry.name.startsWith(server))
791
+ .map((candidate) => ({
792
+ value: `${action} ${candidate.entry.name}`,
793
+ label: candidate.entry.name,
794
+ description: describeState(candidate),
795
+ }));
796
+ return items.length > 0 ? items : null;
797
+ },
798
+ handler: async (args, ctx) => {
799
+ const [action, name, ...extra] = args.trim().split(/\s+/).filter(Boolean);
800
+ if (action === undefined) {
801
+ await pending;
802
+ ctx.ui.notify(formatStatus(), "info");
803
+ return;
112
804
  }
113
- catch (err) {
114
- throw new Error(`Error calling MCP tool ${name}.${tool.name}: ${err.message}`, {
115
- cause: err,
116
- });
805
+ if (extra.length > 0) {
806
+ ctx.ui.notify(MCP_USAGE, "warning");
807
+ return;
808
+ }
809
+ await pending;
810
+ switch (action) {
811
+ case "login": {
812
+ const server = await pickServer(name, ctx, oauthPick);
813
+ if (server)
814
+ await loginCommand(server, ctx);
815
+ return;
816
+ }
817
+ case "logout": {
818
+ const server = await pickServer(name, ctx, oauthPick);
819
+ if (!server)
820
+ return;
821
+ const removed = await signOut(server);
822
+ ctx.ui.notify(removed
823
+ ? `Signed out of MCP server "${server.entry.name}".`
824
+ : `No stored credentials for MCP server "${server.entry.name}".`, "info");
825
+ return;
826
+ }
827
+ case "reconnect": {
828
+ const server = await pickServer(name, ctx, {
829
+ eligible: (candidate) => candidate.connection !== undefined,
830
+ preferred: (candidate) => candidate.connection?.state === "failed" || candidate.connection?.state === "disconnected",
831
+ none: "No enabled MCP server to reconnect.",
832
+ });
833
+ if (!server)
834
+ return;
835
+ const failure = await reconnect(server);
836
+ if (failure)
837
+ ctx.ui.notify(failure, "error");
838
+ else {
839
+ ensureDiscoveryActive(ctx);
840
+ ctx.ui.notify(`Reconnected to MCP server "${server.entry.name}" (${describeState(server)}).`, "info");
841
+ }
842
+ return;
843
+ }
844
+ default:
845
+ ctx.ui.notify(MCP_USAGE, "warning");
117
846
  }
118
847
  },
119
848
  });
120
- }
849
+ };
121
850
  }
122
- export default function mcpExtension(pi) {
123
- const generation = ++extensionGeneration;
124
- const configPath = process.env.PI_MCP_FILE || path.join(process.cwd(), ".pi", "mcp.json");
125
- void readFile(configPath, "utf8")
126
- .then((raw) => {
127
- if (generation !== extensionGeneration)
128
- return;
129
- const registry = JSON.parse(raw);
130
- const servers = punchRegistryToMcpServers(registry);
131
- for (const [name, entry] of Object.entries(servers)) {
132
- void registerMcpServer(pi, name, entry, generation);
133
- }
134
- })
135
- .catch((err) => {
136
- if (generation !== extensionGeneration)
137
- return;
138
- const code = err.code;
139
- if (code !== "ENOENT") {
140
- pi.sendUserMessage(`mcp: failed to load ${configPath}: ${err.message}`);
141
- }
142
- });
143
- pi.on("session_shutdown", () => {
144
- closeClients();
145
- });
851
+ function defaultLoadConfig(ctx) {
852
+ return loadMcpConfig({ agentDir: getAgentDir(), cwd: ctx.cwd, projectTrusted: ctx.isProjectTrusted() });
146
853
  }
854
+ export default createMcpExtension();
147
855
  //# sourceMappingURL=index.js.map