@punch-bot/cli 0.85.1 → 1.3.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 (1121) hide show
  1. package/CHANGELOG.md +609 -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-BUUFZMRE.js +6 -0
  11. package/dist/bundle/chunks/anthropic.js +2 -2
  12. package/dist/bundle/chunks/azure-openai-responses-WZ4GZHD2.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-6C5VKHGV.js +50 -0
  17. package/dist/bundle/chunks/chunk-6WNF4BLC.js +2 -0
  18. package/dist/bundle/chunks/chunk-6YKFJ7FQ.js +1188 -0
  19. package/dist/bundle/chunks/chunk-BYHXHV4K.js +11 -0
  20. package/dist/bundle/chunks/chunk-F5ZABL6Z.js +20 -0
  21. package/dist/bundle/chunks/chunk-HACVPRBJ.js +11 -0
  22. package/dist/bundle/chunks/chunk-ITZNWD4K.js +2 -0
  23. package/dist/bundle/chunks/chunk-J7I2NFJ7.js +82 -0
  24. package/dist/bundle/chunks/chunk-LPXNMA2W.js +2 -0
  25. package/dist/bundle/chunks/chunk-OO6DJ3CL.js +31 -0
  26. package/dist/bundle/chunks/chunk-OWCYH5W2.js +2 -0
  27. package/dist/bundle/chunks/chunk-PMRZO46Y.js +2 -0
  28. package/dist/bundle/chunks/{chunk-TRDNDS6A.js → chunk-PYGXRV27.js} +5 -2
  29. package/dist/bundle/chunks/chunk-RDZVAGPR.js +2 -0
  30. package/dist/bundle/chunks/{chunk-XDUWOHPL.js → chunk-S3GGRYIO.js} +2 -2
  31. package/dist/bundle/chunks/chunk-UTB4DTYQ.js +2 -0
  32. package/dist/bundle/chunks/chunk-WUIPA42N.js +14 -0
  33. package/dist/bundle/chunks/chunk-XIX7LUWI.js +2 -0
  34. package/dist/bundle/chunks/{chunk-3DNTDXPG.js → chunk-YGGF2ZM6.js} +3 -3
  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-S2KXX5PQ.js +2 -0
  43. package/dist/bundle/chunks/google-vertex-LQOUTFJN.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-VNJYBSRF.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-E6BLZPYJ.js +10 -0
  55. package/dist/bundle/chunks/openai-codex.js +2 -2
  56. package/dist/bundle/chunks/openai-completions-LUDIAWSG.js +7 -0
  57. package/dist/bundle/chunks/openai-decisions-WVPMQ4JD.js +5 -0
  58. package/dist/bundle/chunks/openai-responses-IOCBEIVC.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-GZVZPCK3.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 +4 -4
  80. package/dist/cli/credential-print.js.map +1 -1
  81. package/dist/cli/experimental/transport-address.d.ts +21 -0
  82. package/dist/cli/experimental/transport-address.d.ts.map +1 -0
  83. package/dist/cli/experimental/transport-address.js +89 -0
  84. package/dist/cli/experimental/transport-address.js.map +1 -0
  85. package/dist/cli/file-processor.d.ts +1 -1
  86. package/dist/cli/file-processor.d.ts.map +1 -1
  87. package/dist/cli/file-processor.js.map +1 -1
  88. package/dist/cli/initial-message.d.ts +1 -1
  89. package/dist/cli/initial-message.d.ts.map +1 -1
  90. package/dist/cli/initial-message.js.map +1 -1
  91. package/dist/cli/list-models.d.ts.map +1 -1
  92. package/dist/cli/list-models.js +1 -1
  93. package/dist/cli/list-models.js.map +1 -1
  94. package/dist/cli/project-trust.d.ts.map +1 -1
  95. package/dist/cli/project-trust.js +5 -35
  96. package/dist/cli/project-trust.js.map +1 -1
  97. package/dist/cli/setup.d.ts.map +1 -1
  98. package/dist/cli/setup.js.map +1 -1
  99. package/dist/cli.d.ts.map +1 -1
  100. package/dist/config.d.ts +30 -11
  101. package/dist/config.d.ts.map +1 -1
  102. package/dist/config.js +72 -21
  103. package/dist/config.js.map +1 -1
  104. package/dist/core/agent-session-runtime.d.ts +4 -3
  105. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  106. package/dist/core/agent-session-runtime.js +37 -27
  107. package/dist/core/agent-session-runtime.js.map +1 -1
  108. package/dist/core/agent-session-services.d.ts.map +1 -1
  109. package/dist/core/agent-session-services.js +13 -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 +61 -46
  233. package/dist/core/model-resolver.d.ts.map +1 -1
  234. package/dist/core/model-resolver.js +338 -363
  235. package/dist/core/model-resolver.js.map +1 -1
  236. package/dist/core/model-runtime.d.ts +51 -3
  237. package/dist/core/model-runtime.d.ts.map +1 -1
  238. package/dist/core/model-runtime.js +211 -44
  239. package/dist/core/model-runtime.js.map +1 -1
  240. package/dist/core/model-suffix-variants.d.ts +14 -0
  241. package/dist/core/model-suffix-variants.d.ts.map +1 -0
  242. package/dist/core/model-suffix-variants.js +27 -0
  243. package/dist/core/model-suffix-variants.js.map +1 -0
  244. package/dist/core/models-store.d.ts.map +1 -1
  245. package/dist/core/models-store.js.map +1 -1
  246. package/dist/core/nested-tool-calls.d.ts +103 -0
  247. package/dist/core/nested-tool-calls.d.ts.map +1 -0
  248. package/dist/core/nested-tool-calls.js +179 -0
  249. package/dist/core/nested-tool-calls.js.map +1 -0
  250. package/dist/core/output-guard.d.ts.map +1 -1
  251. package/dist/core/output-guard.js.map +1 -1
  252. package/dist/core/package-manager.d.ts +4 -0
  253. package/dist/core/package-manager.d.ts.map +1 -1
  254. package/dist/core/package-manager.js +62 -15
  255. package/dist/core/package-manager.js.map +1 -1
  256. package/dist/core/pi-manifest.d.ts.map +1 -1
  257. package/dist/core/pi-manifest.js.map +1 -1
  258. package/dist/core/project-trust.d.ts.map +1 -1
  259. package/dist/core/project-trust.js +2 -1
  260. package/dist/core/project-trust.js.map +1 -1
  261. package/dist/core/prompt-templates.d.ts +6 -1
  262. package/dist/core/prompt-templates.d.ts.map +1 -1
  263. package/dist/core/prompt-templates.js +68 -37
  264. package/dist/core/prompt-templates.js.map +1 -1
  265. package/dist/core/provider-attribution.d.ts.map +1 -1
  266. package/dist/core/provider-attribution.js.map +1 -1
  267. package/dist/core/provider-composer.d.ts +42 -20
  268. package/dist/core/provider-composer.d.ts.map +1 -1
  269. package/dist/core/provider-composer.js +126 -40
  270. package/dist/core/provider-composer.js.map +1 -1
  271. package/dist/core/radius.d.ts +5 -0
  272. package/dist/core/radius.d.ts.map +1 -1
  273. package/dist/core/radius.js +8 -0
  274. package/dist/core/radius.js.map +1 -1
  275. package/dist/core/remote-catalog-provider.d.ts +19 -1
  276. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  277. package/dist/core/remote-catalog-provider.js +102 -34
  278. package/dist/core/remote-catalog-provider.js.map +1 -1
  279. package/dist/core/resolve-config-value.d.ts.map +1 -1
  280. package/dist/core/resolve-config-value.js.map +1 -1
  281. package/dist/core/resource-loader.d.ts +11 -2
  282. package/dist/core/resource-loader.d.ts.map +1 -1
  283. package/dist/core/resource-loader.js +170 -42
  284. package/dist/core/resource-loader.js.map +1 -1
  285. package/dist/core/runtime-credentials.d.ts.map +1 -1
  286. package/dist/core/runtime-credentials.js.map +1 -1
  287. package/dist/core/sdk.d.ts +14 -5
  288. package/dist/core/sdk.d.ts.map +1 -1
  289. package/dist/core/sdk.js +108 -52
  290. package/dist/core/sdk.js.map +1 -1
  291. package/dist/core/session-cwd.d.ts.map +1 -1
  292. package/dist/core/session-cwd.js.map +1 -1
  293. package/dist/core/session-export.d.ts +6 -2
  294. package/dist/core/session-export.d.ts.map +1 -1
  295. package/dist/core/session-export.js +14 -13
  296. package/dist/core/session-export.js.map +1 -1
  297. package/dist/core/session-manager.d.ts +72 -13
  298. package/dist/core/session-manager.d.ts.map +1 -1
  299. package/dist/core/session-manager.js +277 -124
  300. package/dist/core/session-manager.js.map +1 -1
  301. package/dist/core/settings-defaults.d.ts +65 -0
  302. package/dist/core/settings-defaults.d.ts.map +1 -0
  303. package/dist/core/settings-defaults.js +66 -0
  304. package/dist/core/settings-defaults.js.map +1 -0
  305. package/dist/core/settings-diagnostics.d.ts.map +1 -1
  306. package/dist/core/settings-diagnostics.js.map +1 -1
  307. package/dist/core/settings-manager.d.ts +41 -126
  308. package/dist/core/settings-manager.d.ts.map +1 -1
  309. package/dist/core/settings-manager.js +165 -52
  310. package/dist/core/settings-manager.js.map +1 -1
  311. package/dist/core/settings-schema.d.ts +224 -0
  312. package/dist/core/settings-schema.d.ts.map +1 -0
  313. package/dist/core/settings-schema.js +285 -0
  314. package/dist/core/settings-schema.js.map +1 -0
  315. package/dist/core/skills.d.ts +4 -1
  316. package/dist/core/skills.d.ts.map +1 -1
  317. package/dist/core/skills.js +6 -1
  318. package/dist/core/skills.js.map +1 -1
  319. package/dist/core/slash-commands.d.ts.map +1 -1
  320. package/dist/core/slash-commands.js +3 -2
  321. package/dist/core/slash-commands.js.map +1 -1
  322. package/dist/core/source-info.d.ts +8 -0
  323. package/dist/core/source-info.d.ts.map +1 -1
  324. package/dist/core/source-info.js +16 -0
  325. package/dist/core/source-info.js.map +1 -1
  326. package/dist/core/system-prompt.d.ts +55 -6
  327. package/dist/core/system-prompt.d.ts.map +1 -1
  328. package/dist/core/system-prompt.js +128 -93
  329. package/dist/core/system-prompt.js.map +1 -1
  330. package/dist/core/telemetry.d.ts +2 -0
  331. package/dist/core/telemetry.d.ts.map +1 -1
  332. package/dist/core/telemetry.js +45 -0
  333. package/dist/core/telemetry.js.map +1 -1
  334. package/dist/core/theme/dark.json +78 -0
  335. package/dist/core/theme/light.json +78 -0
  336. package/dist/core/theme/system-theme.d.ts +54 -0
  337. package/dist/core/theme/system-theme.d.ts.map +1 -0
  338. package/dist/core/theme/system-theme.js +547 -0
  339. package/dist/core/theme/system-theme.js.map +1 -0
  340. package/dist/core/theme/theme-schema.d.ts +28 -0
  341. package/dist/core/theme/theme-schema.d.ts.map +1 -0
  342. package/dist/core/theme/theme-schema.js +105 -0
  343. package/dist/core/theme/theme-schema.js.map +1 -0
  344. package/dist/core/theme/theme-tokens.d.ts +257 -0
  345. package/dist/core/theme/theme-tokens.d.ts.map +1 -0
  346. package/dist/core/theme/theme-tokens.js +94 -0
  347. package/dist/core/theme/theme-tokens.js.map +1 -0
  348. package/dist/core/theme/theme.d.ts +162 -0
  349. package/dist/core/theme/theme.d.ts.map +1 -0
  350. package/dist/{modes/interactive → core}/theme/theme.js +265 -402
  351. package/dist/core/theme/theme.js.map +1 -0
  352. package/dist/core/timings.d.ts.map +1 -1
  353. package/dist/core/timings.js.map +1 -1
  354. package/dist/core/tools/bash.d.ts +14 -1
  355. package/dist/core/tools/bash.d.ts.map +1 -1
  356. package/dist/core/tools/bash.js +43 -6
  357. package/dist/core/tools/bash.js.map +1 -1
  358. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  359. package/dist/core/tools/edit-diff.js.map +1 -1
  360. package/dist/core/tools/edit.d.ts +1 -2
  361. package/dist/core/tools/edit.d.ts.map +1 -1
  362. package/dist/core/tools/edit.js +0 -3
  363. package/dist/core/tools/edit.js.map +1 -1
  364. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  365. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  366. package/dist/core/tools/find.d.ts.map +1 -1
  367. package/dist/core/tools/find.js +0 -2
  368. package/dist/core/tools/find.js.map +1 -1
  369. package/dist/core/tools/grep.d.ts.map +1 -1
  370. package/dist/core/tools/grep.js +0 -2
  371. package/dist/core/tools/grep.js.map +1 -1
  372. package/dist/core/tools/index.d.ts.map +1 -1
  373. package/dist/core/tools/index.js.map +1 -1
  374. package/dist/core/tools/ls.d.ts.map +1 -1
  375. package/dist/core/tools/ls.js +0 -2
  376. package/dist/core/tools/ls.js.map +1 -1
  377. package/dist/core/tools/output-accumulator.d.ts +11 -0
  378. package/dist/core/tools/output-accumulator.d.ts.map +1 -1
  379. package/dist/core/tools/output-accumulator.js +40 -10
  380. package/dist/core/tools/output-accumulator.js.map +1 -1
  381. package/dist/core/tools/path-utils.d.ts.map +1 -1
  382. package/dist/core/tools/path-utils.js.map +1 -1
  383. package/dist/core/tools/powershell.d.ts.map +1 -1
  384. package/dist/core/tools/powershell.js.map +1 -1
  385. package/dist/core/tools/read.d.ts +17 -1
  386. package/dist/core/tools/read.d.ts.map +1 -1
  387. package/dist/core/tools/read.js +23 -4
  388. package/dist/core/tools/read.js.map +1 -1
  389. package/dist/core/tools/tool-definition-wrapper.d.ts +5 -3
  390. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  391. package/dist/core/tools/tool-definition-wrapper.js +3 -1
  392. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  393. package/dist/core/tools/truncate.d.ts +14 -0
  394. package/dist/core/tools/truncate.d.ts.map +1 -1
  395. package/dist/core/tools/truncate.js +29 -0
  396. package/dist/core/tools/truncate.js.map +1 -1
  397. package/dist/core/tools/write.d.ts.map +1 -1
  398. package/dist/core/tools/write.js +0 -2
  399. package/dist/core/tools/write.js.map +1 -1
  400. package/dist/core/trust-manager.d.ts.map +1 -1
  401. package/dist/core/trust-manager.js +1 -0
  402. package/dist/core/trust-manager.js.map +1 -1
  403. package/dist/core/usage-totals.d.ts +3 -1
  404. package/dist/core/usage-totals.d.ts.map +1 -1
  405. package/dist/core/usage-totals.js +28 -1
  406. package/dist/core/usage-totals.js.map +1 -1
  407. package/dist/core/virtual-models.d.ts +117 -0
  408. package/dist/core/virtual-models.d.ts.map +1 -0
  409. package/dist/core/virtual-models.js +124 -0
  410. package/dist/core/virtual-models.js.map +1 -0
  411. package/dist/extensions/browser/index.d.ts.map +1 -1
  412. package/dist/extensions/browser/index.js.map +1 -1
  413. package/dist/extensions/codemode/execute.d.ts +16 -0
  414. package/dist/extensions/codemode/execute.d.ts.map +1 -0
  415. package/dist/extensions/codemode/execute.js +665 -0
  416. package/dist/extensions/codemode/execute.js.map +1 -0
  417. package/dist/extensions/codemode/execute.lazy.d.ts +3 -0
  418. package/dist/extensions/codemode/execute.lazy.d.ts.map +1 -0
  419. package/dist/extensions/codemode/execute.lazy.js +3 -0
  420. package/dist/extensions/codemode/execute.lazy.js.map +1 -0
  421. package/dist/extensions/codemode/index.d.ts +21 -0
  422. package/dist/extensions/codemode/index.d.ts.map +1 -0
  423. package/dist/extensions/codemode/index.js +33 -0
  424. package/dist/extensions/codemode/index.js.map +1 -0
  425. package/dist/extensions/codemode/tool.d.ts +124 -0
  426. package/dist/extensions/codemode/tool.d.ts.map +1 -0
  427. package/dist/extensions/codemode/tool.js +286 -0
  428. package/dist/extensions/codemode/tool.js.map +1 -0
  429. package/dist/extensions/codemode/worker.d.ts +7 -0
  430. package/dist/extensions/codemode/worker.d.ts.map +1 -0
  431. package/dist/extensions/codemode/worker.js +7 -0
  432. package/dist/extensions/codemode/worker.js.map +1 -0
  433. package/dist/extensions/context-pruning/compress_context.d.ts.map +1 -1
  434. package/dist/extensions/context-pruning/compress_context.js +1 -3
  435. package/dist/extensions/context-pruning/compress_context.js.map +1 -1
  436. package/dist/extensions/context-pruning/context-pruning-state.d.ts.map +1 -1
  437. package/dist/extensions/context-pruning/context-pruning-state.js.map +1 -1
  438. package/dist/extensions/index.d.ts.map +1 -1
  439. package/dist/extensions/index.js +6 -2
  440. package/dist/extensions/index.js.map +1 -1
  441. package/dist/extensions/llama/client.d.ts +2 -0
  442. package/dist/extensions/llama/client.d.ts.map +1 -1
  443. package/dist/extensions/llama/client.js +7 -3
  444. package/dist/extensions/llama/client.js.map +1 -1
  445. package/dist/extensions/llama/huggingface.d.ts.map +1 -1
  446. package/dist/extensions/llama/huggingface.js.map +1 -1
  447. package/dist/extensions/llama/index.d.ts.map +1 -1
  448. package/dist/extensions/llama/index.js +0 -4
  449. package/dist/extensions/llama/index.js.map +1 -1
  450. package/dist/extensions/llama/provider.d.ts +1 -1
  451. package/dist/extensions/llama/provider.d.ts.map +1 -1
  452. package/dist/extensions/llama/provider.js +103 -13
  453. package/dist/extensions/llama/provider.js.map +1 -1
  454. package/dist/extensions/llama/ui.d.ts +3 -2
  455. package/dist/extensions/llama/ui.d.ts.map +1 -1
  456. package/dist/extensions/llama/ui.js +106 -364
  457. package/dist/extensions/llama/ui.js.map +1 -1
  458. package/dist/extensions/mcp/cli.d.ts +21 -0
  459. package/dist/extensions/mcp/cli.d.ts.map +1 -0
  460. package/dist/extensions/mcp/cli.js +494 -0
  461. package/dist/extensions/mcp/cli.js.map +1 -0
  462. package/dist/extensions/mcp/cli.lazy.d.ts +3 -0
  463. package/dist/extensions/mcp/cli.lazy.d.ts.map +1 -0
  464. package/dist/extensions/mcp/cli.lazy.js +3 -0
  465. package/dist/extensions/mcp/cli.lazy.js.map +1 -0
  466. package/dist/extensions/mcp/config.d.ts +84 -0
  467. package/dist/extensions/mcp/config.d.ts.map +1 -0
  468. package/dist/extensions/mcp/config.js +196 -0
  469. package/dist/extensions/mcp/config.js.map +1 -0
  470. package/dist/extensions/mcp/index.d.ts +71 -2
  471. package/dist/extensions/mcp/index.d.ts.map +1 -1
  472. package/dist/extensions/mcp/index.js +839 -131
  473. package/dist/extensions/mcp/index.js.map +1 -1
  474. package/dist/extensions/mcp/log.d.ts +16 -0
  475. package/dist/extensions/mcp/log.d.ts.map +1 -0
  476. package/dist/extensions/mcp/log.js +66 -0
  477. package/dist/extensions/mcp/log.js.map +1 -0
  478. package/dist/extensions/mcp/oauth.d.ts +102 -0
  479. package/dist/extensions/mcp/oauth.d.ts.map +1 -0
  480. package/dist/extensions/mcp/oauth.js +428 -0
  481. package/dist/extensions/mcp/oauth.js.map +1 -0
  482. package/dist/extensions/mcp/resources.d.ts +36 -0
  483. package/dist/extensions/mcp/resources.d.ts.map +1 -0
  484. package/dist/extensions/mcp/resources.js +261 -0
  485. package/dist/extensions/mcp/resources.js.map +1 -0
  486. package/dist/extensions/mcp/runtime.d.ts +98 -0
  487. package/dist/extensions/mcp/runtime.d.ts.map +1 -0
  488. package/dist/extensions/mcp/runtime.js +378 -0
  489. package/dist/extensions/mcp/runtime.js.map +1 -0
  490. package/dist/extensions/mcp/runtime.lazy.d.ts +3 -0
  491. package/dist/extensions/mcp/runtime.lazy.d.ts.map +1 -0
  492. package/dist/extensions/mcp/runtime.lazy.js +3 -0
  493. package/dist/extensions/mcp/runtime.lazy.js.map +1 -0
  494. package/dist/extensions/mcp/tools.d.ts +84 -0
  495. package/dist/extensions/mcp/tools.d.ts.map +1 -0
  496. package/dist/extensions/mcp/tools.js +263 -0
  497. package/dist/extensions/mcp/tools.js.map +1 -0
  498. package/dist/extensions/punch/a2a-listen.d.ts +9 -0
  499. package/dist/extensions/punch/a2a-listen.d.ts.map +1 -0
  500. package/dist/extensions/punch/a2a-listen.js +88 -0
  501. package/dist/extensions/punch/a2a-listen.js.map +1 -0
  502. package/dist/extensions/punch/a2a.d.ts +12 -0
  503. package/dist/extensions/punch/a2a.d.ts.map +1 -0
  504. package/dist/extensions/punch/a2a.js +106 -0
  505. package/dist/extensions/punch/a2a.js.map +1 -0
  506. package/dist/extensions/punch/auth.d.ts +2 -1
  507. package/dist/extensions/punch/auth.d.ts.map +1 -1
  508. package/dist/extensions/punch/auth.js +5 -1
  509. package/dist/extensions/punch/auth.js.map +1 -1
  510. package/dist/extensions/punch/collabs.d.ts.map +1 -1
  511. package/dist/extensions/punch/collabs.js.map +1 -1
  512. package/dist/extensions/punch/index.d.ts.map +1 -1
  513. package/dist/extensions/punch/index.js +11 -15
  514. package/dist/extensions/punch/index.js.map +1 -1
  515. package/dist/extensions/punch/routines.d.ts +1 -3
  516. package/dist/extensions/punch/routines.d.ts.map +1 -1
  517. package/dist/extensions/punch/routines.js +1 -121
  518. package/dist/extensions/punch/routines.js.map +1 -1
  519. package/dist/extensions/punch/server.d.ts +3 -0
  520. package/dist/extensions/punch/server.d.ts.map +1 -1
  521. package/dist/extensions/punch/server.js +41 -3
  522. package/dist/extensions/punch/server.js.map +1 -1
  523. package/dist/extensions/punch/timezone.d.ts.map +1 -1
  524. package/dist/extensions/punch/timezone.js.map +1 -1
  525. package/dist/extensions/punch/todo-store.d.ts +15 -0
  526. package/dist/extensions/punch/todo-store.d.ts.map +1 -0
  527. package/dist/extensions/punch/todo-store.js +208 -0
  528. package/dist/extensions/punch/todo-store.js.map +1 -0
  529. package/dist/extensions/punch/todos.d.ts +7 -3
  530. package/dist/extensions/punch/todos.d.ts.map +1 -1
  531. package/dist/extensions/punch/todos.js +40 -17
  532. package/dist/extensions/punch/todos.js.map +1 -1
  533. package/dist/extensions/report-progress/index.d.ts.map +1 -1
  534. package/dist/extensions/report-progress/index.js.map +1 -1
  535. package/dist/extensions/subagent/agents.d.ts.map +1 -1
  536. package/dist/extensions/subagent/agents.js.map +1 -1
  537. package/dist/extensions/subagent/index.d.ts.map +1 -1
  538. package/dist/extensions/subagent/index.js +0 -372
  539. package/dist/extensions/subagent/index.js.map +1 -1
  540. package/dist/extensions/tool-search/index.d.ts +12 -0
  541. package/dist/extensions/tool-search/index.d.ts.map +1 -0
  542. package/dist/extensions/tool-search/index.js +15 -0
  543. package/dist/extensions/tool-search/index.js.map +1 -0
  544. package/dist/extensions/tool-search/tool.d.ts +71 -0
  545. package/dist/extensions/tool-search/tool.d.ts.map +1 -0
  546. package/dist/extensions/tool-search/tool.js +187 -0
  547. package/dist/extensions/tool-search/tool.js.map +1 -0
  548. package/dist/extensions/webfetch/index.d.ts.map +1 -1
  549. package/dist/extensions/webfetch/index.js.map +1 -1
  550. package/dist/extensions/websearch/index.d.ts.map +1 -1
  551. package/dist/extensions/websearch/index.js.map +1 -1
  552. package/dist/index.d.ts +13 -6
  553. package/dist/index.d.ts.map +1 -1
  554. package/dist/index.js +9 -6
  555. package/dist/index.js.map +1 -1
  556. package/dist/main.d.ts +1 -1
  557. package/dist/main.d.ts.map +1 -1
  558. package/dist/main.js +140 -173
  559. package/dist/main.js.map +1 -1
  560. package/dist/migrations.d.ts.map +1 -1
  561. package/dist/migrations.js +0 -20
  562. package/dist/migrations.js.map +1 -1
  563. package/dist/modes/index.d.ts +0 -1
  564. package/dist/modes/index.d.ts.map +1 -1
  565. package/dist/modes/index.js +0 -1
  566. package/dist/modes/index.js.map +1 -1
  567. package/dist/modes/json-event.d.ts.map +1 -1
  568. package/dist/modes/json-event.js.map +1 -1
  569. package/dist/modes/print-mode.d.ts.map +1 -1
  570. package/dist/modes/print-mode.js +4 -0
  571. package/dist/modes/print-mode.js.map +1 -1
  572. package/dist/modes/rpc/jsonl.d.ts.map +1 -1
  573. package/dist/modes/rpc/jsonl.js.map +1 -1
  574. package/dist/modes/rpc/rpc-client.d.ts +10 -6
  575. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  576. package/dist/modes/rpc/rpc-client.js +19 -8
  577. package/dist/modes/rpc/rpc-client.js.map +1 -1
  578. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  579. package/dist/modes/rpc/rpc-mode.js +30 -48
  580. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  581. package/dist/modes/rpc/rpc-types.d.ts +21 -1
  582. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  583. package/dist/modes/rpc/rpc-types.js.map +1 -1
  584. package/dist/package-manager-cli.d.ts.map +1 -1
  585. package/dist/package-manager-cli.js +43 -43
  586. package/dist/package-manager-cli.js.map +1 -1
  587. package/dist/rpc-entry.d.ts.map +1 -1
  588. package/dist/rpc-entry.js.map +1 -1
  589. package/dist/server/a2a/harness-runner.d.ts.map +1 -1
  590. package/dist/server/a2a/harness-runner.js.map +1 -1
  591. package/dist/server/a2a/run-server.d.ts.map +1 -1
  592. package/dist/server/a2a/run-server.js.map +1 -1
  593. package/dist/utils/abort.d.ts.map +1 -1
  594. package/dist/utils/abort.js.map +1 -1
  595. package/dist/utils/ansi.d.ts +8 -0
  596. package/dist/utils/ansi.d.ts.map +1 -1
  597. package/dist/utils/ansi.js +30 -11
  598. package/dist/utils/ansi.js.map +1 -1
  599. package/dist/utils/changelog.d.ts.map +1 -1
  600. package/dist/utils/changelog.js +5 -2
  601. package/dist/utils/changelog.js.map +1 -1
  602. package/dist/utils/child-process.d.ts.map +1 -1
  603. package/dist/utils/child-process.js.map +1 -1
  604. package/dist/utils/clipboard-command.d.ts.map +1 -1
  605. package/dist/utils/clipboard-command.js.map +1 -1
  606. package/dist/utils/clipboard-image.d.ts.map +1 -1
  607. package/dist/utils/clipboard-image.js +15 -41
  608. package/dist/utils/clipboard-image.js.map +1 -1
  609. package/dist/utils/clipboard.d.ts.map +1 -1
  610. package/dist/utils/clipboard.js +96 -38
  611. package/dist/utils/clipboard.js.map +1 -1
  612. package/dist/utils/colors.d.ts +73 -0
  613. package/dist/utils/colors.d.ts.map +1 -0
  614. package/dist/utils/colors.js +273 -0
  615. package/dist/utils/colors.js.map +1 -0
  616. package/dist/utils/deprecation.d.ts.map +1 -1
  617. package/dist/utils/deprecation.js.map +1 -1
  618. package/dist/utils/exif-orientation.d.ts.map +1 -1
  619. package/dist/utils/exif-orientation.js.map +1 -1
  620. package/dist/utils/frontmatter.d.ts.map +1 -1
  621. package/dist/utils/frontmatter.js.map +1 -1
  622. package/dist/utils/fs-watch.d.ts.map +1 -1
  623. package/dist/utils/fs-watch.js.map +1 -1
  624. package/dist/utils/fuzzy.d.ts +16 -0
  625. package/dist/utils/fuzzy.d.ts.map +1 -0
  626. package/dist/utils/fuzzy.js +111 -0
  627. package/dist/utils/fuzzy.js.map +1 -0
  628. package/dist/utils/git.d.ts.map +1 -1
  629. package/dist/utils/git.js.map +1 -1
  630. package/dist/utils/html.d.ts.map +1 -1
  631. package/dist/utils/html.js.map +1 -1
  632. package/dist/utils/image-convert.d.ts.map +1 -1
  633. package/dist/utils/image-convert.js.map +1 -1
  634. package/dist/utils/image-process.d.ts.map +1 -1
  635. package/dist/utils/image-process.js.map +1 -1
  636. package/dist/utils/image-resize-core.d.ts +12 -0
  637. package/dist/utils/image-resize-core.d.ts.map +1 -1
  638. package/dist/utils/image-resize-core.js +5 -0
  639. package/dist/utils/image-resize-core.js.map +1 -1
  640. package/dist/utils/image-resize-worker.d.ts.map +1 -1
  641. package/dist/utils/image-resize-worker.js +3 -2
  642. package/dist/utils/image-resize-worker.js.map +1 -1
  643. package/dist/utils/image-resize.d.ts.map +1 -1
  644. package/dist/utils/image-resize.js +9 -10
  645. package/dist/utils/image-resize.js.map +1 -1
  646. package/dist/utils/json.d.ts.map +1 -1
  647. package/dist/utils/json.js.map +1 -1
  648. package/dist/utils/management-http.d.ts.map +1 -1
  649. package/dist/utils/management-http.js.map +1 -1
  650. package/dist/utils/mime.d.ts.map +1 -1
  651. package/dist/utils/mime.js +1 -1
  652. package/dist/utils/mime.js.map +1 -1
  653. package/dist/utils/oklab.d.ts +43 -0
  654. package/dist/utils/oklab.d.ts.map +1 -0
  655. package/dist/utils/oklab.js +210 -0
  656. package/dist/utils/oklab.js.map +1 -0
  657. package/dist/utils/open-browser.d.ts.map +1 -1
  658. package/dist/utils/open-browser.js.map +1 -1
  659. package/dist/utils/output-files.d.ts +15 -0
  660. package/dist/utils/output-files.d.ts.map +1 -0
  661. package/dist/utils/output-files.js +30 -0
  662. package/dist/utils/output-files.js.map +1 -0
  663. package/dist/utils/paths.d.ts +3 -3
  664. package/dist/utils/paths.d.ts.map +1 -1
  665. package/dist/utils/paths.js +5 -4
  666. package/dist/utils/paths.js.map +1 -1
  667. package/dist/utils/photon.d.ts.map +1 -1
  668. package/dist/utils/photon.js.map +1 -1
  669. package/dist/utils/pi-user-agent.d.ts.map +1 -1
  670. package/dist/utils/pi-user-agent.js.map +1 -1
  671. package/dist/utils/shell.d.ts +1 -3
  672. package/dist/utils/shell.d.ts.map +1 -1
  673. package/dist/utils/shell.js +3 -30
  674. package/dist/utils/shell.js.map +1 -1
  675. package/dist/utils/sleep.d.ts.map +1 -1
  676. package/dist/utils/sleep.js.map +1 -1
  677. package/dist/utils/syntax-highlight.d.ts.map +1 -1
  678. package/dist/utils/syntax-highlight.js +8 -1
  679. package/dist/utils/syntax-highlight.js.map +1 -1
  680. package/dist/utils/text.d.ts.map +1 -1
  681. package/dist/utils/text.js.map +1 -1
  682. package/dist/utils/tool-result-images.d.ts +3 -1
  683. package/dist/utils/tool-result-images.d.ts.map +1 -1
  684. package/dist/utils/tool-result-images.js +4 -1
  685. package/dist/utils/tool-result-images.js.map +1 -1
  686. package/dist/utils/tools-manager.d.ts.map +1 -1
  687. package/dist/utils/tools-manager.js.map +1 -1
  688. package/dist/utils/version-check.d.ts.map +1 -1
  689. package/dist/utils/version-check.js.map +1 -1
  690. package/dist/utils/windows-self-update.d.ts.map +1 -1
  691. package/dist/utils/windows-self-update.js.map +1 -1
  692. package/dist/utils/wsl.d.ts +3 -0
  693. package/dist/utils/wsl.d.ts.map +1 -0
  694. package/dist/utils/wsl.js +15 -0
  695. package/dist/utils/wsl.js.map +1 -0
  696. package/dist/utils/zip.d.ts +7 -0
  697. package/dist/utils/zip.d.ts.map +1 -0
  698. package/dist/utils/zip.js +60 -0
  699. package/dist/utils/zip.js.map +1 -0
  700. package/docs/cli-integration.md +106 -0
  701. package/docs/cli.md +333 -0
  702. package/docs/codemode.md +230 -0
  703. package/docs/compaction.md +47 -28
  704. package/docs/configuration.md +47 -0
  705. package/docs/containerization.md +109 -82
  706. package/docs/custom-provider.md +109 -713
  707. package/docs/docs.json +152 -96
  708. package/docs/environment-variables.md +18 -3
  709. package/docs/extensions.md +284 -604
  710. package/docs/how-pi-works.md +49 -0
  711. package/docs/images/interactive-mode.png +0 -0
  712. package/docs/index.md +24 -69
  713. package/docs/json.md +193 -65
  714. package/docs/keybindings.md +58 -103
  715. package/docs/llama-cpp.md +24 -4
  716. package/docs/mcp.md +272 -0
  717. package/docs/message-types.md +279 -0
  718. package/docs/models.md +124 -489
  719. package/docs/nvidia-rtx-llama-cpp.md +96 -0
  720. package/docs/packages.md +67 -166
  721. package/docs/prompt-templates.md +31 -68
  722. package/docs/providers.md +158 -228
  723. package/docs/punch-todos.md +24 -0
  724. package/docs/quickstart.md +61 -106
  725. package/docs/rpc-commands.md +888 -0
  726. package/docs/rpc-extension-ui.md +200 -0
  727. package/docs/rpc.md +131 -1554
  728. package/docs/sdk.md +79 -1158
  729. package/docs/security.md +72 -32
  730. package/docs/session-format.md +58 -215
  731. package/docs/sessions.md +35 -114
  732. package/docs/settings.md +98 -326
  733. package/docs/shell-aliases.md +85 -5
  734. package/docs/skills.md +51 -190
  735. package/docs/slash-commands.md +60 -0
  736. package/docs/subagents.md +2 -0
  737. package/docs/terminal-setup.md +7 -182
  738. package/docs/termux.md +74 -83
  739. package/docs/themes.md +89 -273
  740. package/docs/tmux.md +31 -39
  741. package/docs/tui.md +74 -910
  742. package/docs/usage.md +52 -129
  743. package/docs/virtual-models.md +114 -0
  744. package/docs/windows.md +45 -17
  745. package/examples/README.md +13 -5
  746. package/examples/extensions/README.md +4 -30
  747. package/examples/extensions/custom-provider-anthropic/index.ts +18 -12
  748. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  749. package/examples/extensions/custom-provider-anthropic/package.json +17 -17
  750. package/examples/extensions/custom-provider-gitlab-duo/index.ts +2 -2
  751. package/examples/extensions/custom-provider-gitlab-duo/package.json +14 -14
  752. package/examples/extensions/custom-provider-gitlab-duo/test.ts +5 -5
  753. package/examples/extensions/debug-provider.ts +69 -0
  754. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  755. package/examples/extensions/gondolin/package-lock.json +5 -5
  756. package/examples/extensions/gondolin/package.json +1 -1
  757. package/examples/extensions/jev-router.ts +113 -0
  758. package/examples/extensions/prompt-customizer.ts +19 -67
  759. package/examples/extensions/sandbox/package-lock.json +2 -2
  760. package/examples/extensions/sandbox/package.json +1 -1
  761. package/examples/extensions/with-deps/package-lock.json +2 -2
  762. package/examples/extensions/with-deps/package.json +20 -20
  763. package/examples/rpc-client.ts +35 -0
  764. package/examples/sdk/14-codemode-mcp.ts +61 -0
  765. package/examples/sdk/README.md +3 -2
  766. package/npm-shrinkwrap.json +2425 -0
  767. package/package.json +30 -29
  768. package/schemas/models.schema.json +1157 -0
  769. package/schemas/settings.schema.json +734 -0
  770. package/schemas/theme.schema.json +365 -0
  771. package/src/extensions/punch/sqlite-bun.mjs +1 -0
  772. package/src/extensions/punch/sqlite-driver.d.mts +15 -0
  773. package/src/extensions/punch/sqlite-node.mjs +1 -0
  774. package/dist/bundle/chunks/anthropic-messages-ASRU76PT.js +0 -6
  775. package/dist/bundle/chunks/azure-openai-responses-UGF6LMEX.js +0 -2
  776. package/dist/bundle/chunks/chunk-5PRUVL6W.js +0 -1770
  777. package/dist/bundle/chunks/chunk-6R7UI4IY.js +0 -2
  778. package/dist/bundle/chunks/chunk-A3JYRWB6.js +0 -2
  779. package/dist/bundle/chunks/chunk-CHB3CEFP.js +0 -2
  780. package/dist/bundle/chunks/chunk-ELBMWBDG.js +0 -11
  781. package/dist/bundle/chunks/chunk-GMWCTUPB.js +0 -2
  782. package/dist/bundle/chunks/chunk-GTBU4EAF.js +0 -2
  783. package/dist/bundle/chunks/chunk-NUHFSC37.js +0 -25
  784. package/dist/bundle/chunks/chunk-UIWY7TU5.js +0 -42
  785. package/dist/bundle/chunks/chunk-XNGRGP62.js +0 -2
  786. package/dist/bundle/chunks/google-generative-ai-VCD2PGIY.js +0 -2
  787. package/dist/bundle/chunks/google-vertex-L6U34ZRC.js +0 -2
  788. package/dist/bundle/chunks/mistral-conversations-IXWQ2YKN.js +0 -5
  789. package/dist/bundle/chunks/node-5YXRXMVN.js +0 -16
  790. package/dist/bundle/chunks/openai-codex-responses-P7HKQLIT.js +0 -10
  791. package/dist/bundle/chunks/openai-completions-O7BFLP3U.js +0 -7
  792. package/dist/bundle/chunks/openai-responses-QAKWAYVG.js +0 -2
  793. package/dist/cli/config-selector.d.ts +0 -16
  794. package/dist/cli/config-selector.d.ts.map +0 -1
  795. package/dist/cli/config-selector.js +0 -32
  796. package/dist/cli/config-selector.js.map +0 -1
  797. package/dist/cli/session-picker.d.ts +0 -10
  798. package/dist/cli/session-picker.d.ts.map +0 -1
  799. package/dist/cli/session-picker.js +0 -36
  800. package/dist/cli/session-picker.js.map +0 -1
  801. package/dist/cli/startup-ui.d.ts +0 -20
  802. package/dist/cli/startup-ui.d.ts.map +0 -1
  803. package/dist/cli/startup-ui.js +0 -185
  804. package/dist/cli/startup-ui.js.map +0 -1
  805. package/dist/core/keybindings.d.ts +0 -428
  806. package/dist/core/keybindings.d.ts.map +0 -1
  807. package/dist/core/keybindings.js +0 -321
  808. package/dist/core/keybindings.js.map +0 -1
  809. package/dist/core/tools/render-utils.d.ts +0 -24
  810. package/dist/core/tools/render-utils.d.ts.map +0 -1
  811. package/dist/core/tools/render-utils.js +0 -65
  812. package/dist/core/tools/render-utils.js.map +0 -1
  813. package/dist/core/tools/renderers/bash.d.ts +0 -12
  814. package/dist/core/tools/renderers/bash.d.ts.map +0 -1
  815. package/dist/core/tools/renderers/bash.js +0 -130
  816. package/dist/core/tools/renderers/bash.js.map +0 -1
  817. package/dist/core/tools/renderers/edit.d.ts +0 -23
  818. package/dist/core/tools/renderers/edit.d.ts.map +0 -1
  819. package/dist/core/tools/renderers/edit.js +0 -167
  820. package/dist/core/tools/renderers/edit.js.map +0 -1
  821. package/dist/core/tools/renderers/find.d.ts +0 -10
  822. package/dist/core/tools/renderers/find.d.ts.map +0 -1
  823. package/dist/core/tools/renderers/find.js +0 -64
  824. package/dist/core/tools/renderers/find.js.map +0 -1
  825. package/dist/core/tools/renderers/grep.d.ts +0 -10
  826. package/dist/core/tools/renderers/grep.d.ts.map +0 -1
  827. package/dist/core/tools/renderers/grep.js +0 -69
  828. package/dist/core/tools/renderers/grep.js.map +0 -1
  829. package/dist/core/tools/renderers/index.d.ts +0 -28
  830. package/dist/core/tools/renderers/index.d.ts.map +0 -1
  831. package/dist/core/tools/renderers/index.js +0 -47
  832. package/dist/core/tools/renderers/index.js.map +0 -1
  833. package/dist/core/tools/renderers/ls.d.ts +0 -10
  834. package/dist/core/tools/renderers/ls.d.ts.map +0 -1
  835. package/dist/core/tools/renderers/ls.js +0 -58
  836. package/dist/core/tools/renderers/ls.js.map +0 -1
  837. package/dist/core/tools/renderers/read.d.ts +0 -11
  838. package/dist/core/tools/renderers/read.d.ts.map +0 -1
  839. package/dist/core/tools/renderers/read.js +0 -129
  840. package/dist/core/tools/renderers/read.js.map +0 -1
  841. package/dist/core/tools/renderers/write.d.ts +0 -10
  842. package/dist/core/tools/renderers/write.d.ts.map +0 -1
  843. package/dist/core/tools/renderers/write.js +0 -153
  844. package/dist/core/tools/renderers/write.js.map +0 -1
  845. package/dist/extensions/mcp/mcp-client.d.ts +0 -31
  846. package/dist/extensions/mcp/mcp-client.d.ts.map +0 -1
  847. package/dist/extensions/mcp/mcp-client.js +0 -149
  848. package/dist/extensions/mcp/mcp-client.js.map +0 -1
  849. package/dist/extensions/mcp/mcp-config.d.ts +0 -47
  850. package/dist/extensions/mcp/mcp-config.d.ts.map +0 -1
  851. package/dist/extensions/mcp/mcp-config.js +0 -281
  852. package/dist/extensions/mcp/mcp-config.js.map +0 -1
  853. package/dist/extensions/mcp/mcp-transport.d.ts +0 -65
  854. package/dist/extensions/mcp/mcp-transport.d.ts.map +0 -1
  855. package/dist/extensions/mcp/mcp-transport.js +0 -278
  856. package/dist/extensions/mcp/mcp-transport.js.map +0 -1
  857. package/dist/modes/interactive/assets/clankolas.png +0 -0
  858. package/dist/modes/interactive/chat-viewport.d.ts +0 -20
  859. package/dist/modes/interactive/chat-viewport.d.ts.map +0 -1
  860. package/dist/modes/interactive/chat-viewport.js +0 -28
  861. package/dist/modes/interactive/chat-viewport.js.map +0 -1
  862. package/dist/modes/interactive/components/armin.d.ts +0 -34
  863. package/dist/modes/interactive/components/armin.d.ts.map +0 -1
  864. package/dist/modes/interactive/components/armin.js +0 -333
  865. package/dist/modes/interactive/components/armin.js.map +0 -1
  866. package/dist/modes/interactive/components/assistant-message.d.ts +0 -26
  867. package/dist/modes/interactive/components/assistant-message.d.ts.map +0 -1
  868. package/dist/modes/interactive/components/assistant-message.js +0 -158
  869. package/dist/modes/interactive/components/assistant-message.js.map +0 -1
  870. package/dist/modes/interactive/components/bash-execution.d.ts +0 -34
  871. package/dist/modes/interactive/components/bash-execution.d.ts.map +0 -1
  872. package/dist/modes/interactive/components/bash-execution.js +0 -175
  873. package/dist/modes/interactive/components/bash-execution.js.map +0 -1
  874. package/dist/modes/interactive/components/bordered-loader.d.ts +0 -16
  875. package/dist/modes/interactive/components/bordered-loader.d.ts.map +0 -1
  876. package/dist/modes/interactive/components/bordered-loader.js +0 -54
  877. package/dist/modes/interactive/components/bordered-loader.js.map +0 -1
  878. package/dist/modes/interactive/components/branch-summary-message.d.ts +0 -16
  879. package/dist/modes/interactive/components/branch-summary-message.d.ts.map +0 -1
  880. package/dist/modes/interactive/components/branch-summary-message.js +0 -44
  881. package/dist/modes/interactive/components/branch-summary-message.js.map +0 -1
  882. package/dist/modes/interactive/components/compaction-summary-message.d.ts +0 -16
  883. package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +0 -1
  884. package/dist/modes/interactive/components/compaction-summary-message.js +0 -45
  885. package/dist/modes/interactive/components/compaction-summary-message.js.map +0 -1
  886. package/dist/modes/interactive/components/config-selector.d.ts +0 -102
  887. package/dist/modes/interactive/components/config-selector.d.ts.map +0 -1
  888. package/dist/modes/interactive/components/config-selector.js +0 -761
  889. package/dist/modes/interactive/components/config-selector.js.map +0 -1
  890. package/dist/modes/interactive/components/countdown-timer.d.ts +0 -14
  891. package/dist/modes/interactive/components/countdown-timer.d.ts.map +0 -1
  892. package/dist/modes/interactive/components/countdown-timer.js +0 -33
  893. package/dist/modes/interactive/components/countdown-timer.js.map +0 -1
  894. package/dist/modes/interactive/components/custom-editor.d.ts +0 -30
  895. package/dist/modes/interactive/components/custom-editor.d.ts.map +0 -1
  896. package/dist/modes/interactive/components/custom-editor.js +0 -115
  897. package/dist/modes/interactive/components/custom-editor.js.map +0 -1
  898. package/dist/modes/interactive/components/custom-entry.d.ts +0 -19
  899. package/dist/modes/interactive/components/custom-entry.d.ts.map +0 -1
  900. package/dist/modes/interactive/components/custom-entry.js +0 -52
  901. package/dist/modes/interactive/components/custom-entry.js.map +0 -1
  902. package/dist/modes/interactive/components/custom-message.d.ts +0 -22
  903. package/dist/modes/interactive/components/custom-message.d.ts.map +0 -1
  904. package/dist/modes/interactive/components/custom-message.js +0 -87
  905. package/dist/modes/interactive/components/custom-message.js.map +0 -1
  906. package/dist/modes/interactive/components/daxnuts.d.ts +0 -23
  907. package/dist/modes/interactive/components/daxnuts.d.ts.map +0 -1
  908. package/dist/modes/interactive/components/daxnuts.js +0 -140
  909. package/dist/modes/interactive/components/daxnuts.js.map +0 -1
  910. package/dist/modes/interactive/components/diff.d.ts +0 -12
  911. package/dist/modes/interactive/components/diff.d.ts.map +0 -1
  912. package/dist/modes/interactive/components/diff.js +0 -133
  913. package/dist/modes/interactive/components/diff.js.map +0 -1
  914. package/dist/modes/interactive/components/dynamic-border.d.ts +0 -15
  915. package/dist/modes/interactive/components/dynamic-border.d.ts.map +0 -1
  916. package/dist/modes/interactive/components/dynamic-border.js +0 -21
  917. package/dist/modes/interactive/components/dynamic-border.js.map +0 -1
  918. package/dist/modes/interactive/components/earendil-announcement.d.ts +0 -5
  919. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +0 -1
  920. package/dist/modes/interactive/components/earendil-announcement.js +0 -40
  921. package/dist/modes/interactive/components/earendil-announcement.js.map +0 -1
  922. package/dist/modes/interactive/components/extension-editor.d.ts +0 -21
  923. package/dist/modes/interactive/components/extension-editor.d.ts.map +0 -1
  924. package/dist/modes/interactive/components/extension-editor.js +0 -98
  925. package/dist/modes/interactive/components/extension-editor.js.map +0 -1
  926. package/dist/modes/interactive/components/extension-input.d.ts +0 -23
  927. package/dist/modes/interactive/components/extension-input.d.ts.map +0 -1
  928. package/dist/modes/interactive/components/extension-input.js +0 -61
  929. package/dist/modes/interactive/components/extension-input.js.map +0 -1
  930. package/dist/modes/interactive/components/extension-selector.d.ts +0 -26
  931. package/dist/modes/interactive/components/extension-selector.d.ts.map +0 -1
  932. package/dist/modes/interactive/components/extension-selector.js +0 -83
  933. package/dist/modes/interactive/components/extension-selector.js.map +0 -1
  934. package/dist/modes/interactive/components/first-time-setup.d.ts +0 -25
  935. package/dist/modes/interactive/components/first-time-setup.d.ts.map +0 -1
  936. package/dist/modes/interactive/components/first-time-setup.js +0 -103
  937. package/dist/modes/interactive/components/first-time-setup.js.map +0 -1
  938. package/dist/modes/interactive/components/footer.d.ts +0 -32
  939. package/dist/modes/interactive/components/footer.d.ts.map +0 -1
  940. package/dist/modes/interactive/components/footer.js +0 -222
  941. package/dist/modes/interactive/components/footer.js.map +0 -1
  942. package/dist/modes/interactive/components/index.d.ts +0 -34
  943. package/dist/modes/interactive/components/index.d.ts.map +0 -1
  944. package/dist/modes/interactive/components/index.js +0 -35
  945. package/dist/modes/interactive/components/index.js.map +0 -1
  946. package/dist/modes/interactive/components/keybinding-hints.d.ts +0 -13
  947. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +0 -1
  948. package/dist/modes/interactive/components/keybinding-hints.js +0 -36
  949. package/dist/modes/interactive/components/keybinding-hints.js.map +0 -1
  950. package/dist/modes/interactive/components/login-dialog.d.ts +0 -52
  951. package/dist/modes/interactive/components/login-dialog.d.ts.map +0 -1
  952. package/dist/modes/interactive/components/login-dialog.js +0 -188
  953. package/dist/modes/interactive/components/login-dialog.js.map +0 -1
  954. package/dist/modes/interactive/components/markdown-transform.d.ts +0 -3
  955. package/dist/modes/interactive/components/markdown-transform.d.ts.map +0 -1
  956. package/dist/modes/interactive/components/markdown-transform.js +0 -19
  957. package/dist/modes/interactive/components/markdown-transform.js.map +0 -1
  958. package/dist/modes/interactive/components/mermaid.d.ts +0 -11
  959. package/dist/modes/interactive/components/mermaid.d.ts.map +0 -1
  960. package/dist/modes/interactive/components/mermaid.js +0 -75
  961. package/dist/modes/interactive/components/mermaid.js.map +0 -1
  962. package/dist/modes/interactive/components/model-selector.d.ts +0 -60
  963. package/dist/modes/interactive/components/model-selector.d.ts.map +0 -1
  964. package/dist/modes/interactive/components/model-selector.js +0 -361
  965. package/dist/modes/interactive/components/model-selector.js.map +0 -1
  966. package/dist/modes/interactive/components/oauth-selector.d.ts +0 -33
  967. package/dist/modes/interactive/components/oauth-selector.d.ts.map +0 -1
  968. package/dist/modes/interactive/components/oauth-selector.js +0 -163
  969. package/dist/modes/interactive/components/oauth-selector.js.map +0 -1
  970. package/dist/modes/interactive/components/question-selector.d.ts +0 -24
  971. package/dist/modes/interactive/components/question-selector.d.ts.map +0 -1
  972. package/dist/modes/interactive/components/question-selector.js +0 -158
  973. package/dist/modes/interactive/components/question-selector.js.map +0 -1
  974. package/dist/modes/interactive/components/scoped-models-selector.d.ts +0 -46
  975. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +0 -1
  976. package/dist/modes/interactive/components/scoped-models-selector.js +0 -326
  977. package/dist/modes/interactive/components/scoped-models-selector.js.map +0 -1
  978. package/dist/modes/interactive/components/session-selector-search.d.ts +0 -23
  979. package/dist/modes/interactive/components/session-selector-search.d.ts.map +0 -1
  980. package/dist/modes/interactive/components/session-selector-search.js +0 -155
  981. package/dist/modes/interactive/components/session-selector-search.js.map +0 -1
  982. package/dist/modes/interactive/components/session-selector.d.ts +0 -95
  983. package/dist/modes/interactive/components/session-selector.d.ts.map +0 -1
  984. package/dist/modes/interactive/components/session-selector.js +0 -867
  985. package/dist/modes/interactive/components/session-selector.js.map +0 -1
  986. package/dist/modes/interactive/components/settings-selector.d.ts +0 -92
  987. package/dist/modes/interactive/components/settings-selector.d.ts.map +0 -1
  988. package/dist/modes/interactive/components/settings-selector.js +0 -709
  989. package/dist/modes/interactive/components/settings-selector.js.map +0 -1
  990. package/dist/modes/interactive/components/settings-submenu.d.ts +0 -72
  991. package/dist/modes/interactive/components/settings-submenu.d.ts.map +0 -1
  992. package/dist/modes/interactive/components/settings-submenu.js +0 -165
  993. package/dist/modes/interactive/components/settings-submenu.js.map +0 -1
  994. package/dist/modes/interactive/components/show-images-selector.d.ts +0 -10
  995. package/dist/modes/interactive/components/show-images-selector.d.ts.map +0 -1
  996. package/dist/modes/interactive/components/show-images-selector.js +0 -39
  997. package/dist/modes/interactive/components/show-images-selector.js.map +0 -1
  998. package/dist/modes/interactive/components/skill-invocation-message.d.ts +0 -17
  999. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +0 -1
  1000. package/dist/modes/interactive/components/skill-invocation-message.js +0 -47
  1001. package/dist/modes/interactive/components/skill-invocation-message.js.map +0 -1
  1002. package/dist/modes/interactive/components/status-indicator.d.ts +0 -30
  1003. package/dist/modes/interactive/components/status-indicator.d.ts.map +0 -1
  1004. package/dist/modes/interactive/components/status-indicator.js +0 -67
  1005. package/dist/modes/interactive/components/status-indicator.js.map +0 -1
  1006. package/dist/modes/interactive/components/theme-selector.d.ts +0 -11
  1007. package/dist/modes/interactive/components/theme-selector.d.ts.map +0 -1
  1008. package/dist/modes/interactive/components/theme-selector.js +0 -50
  1009. package/dist/modes/interactive/components/theme-selector.js.map +0 -1
  1010. package/dist/modes/interactive/components/thinking-selector.d.ts +0 -23
  1011. package/dist/modes/interactive/components/thinking-selector.d.ts.map +0 -1
  1012. package/dist/modes/interactive/components/thinking-selector.js +0 -109
  1013. package/dist/modes/interactive/components/thinking-selector.js.map +0 -1
  1014. package/dist/modes/interactive/components/tool-execution.d.ts +0 -80
  1015. package/dist/modes/interactive/components/tool-execution.d.ts.map +0 -1
  1016. package/dist/modes/interactive/components/tool-execution.js +0 -328
  1017. package/dist/modes/interactive/components/tool-execution.js.map +0 -1
  1018. package/dist/modes/interactive/components/tree-selector.d.ts +0 -94
  1019. package/dist/modes/interactive/components/tree-selector.d.ts.map +0 -1
  1020. package/dist/modes/interactive/components/tree-selector.js +0 -1245
  1021. package/dist/modes/interactive/components/tree-selector.js.map +0 -1
  1022. package/dist/modes/interactive/components/trust-selector.d.ts +0 -23
  1023. package/dist/modes/interactive/components/trust-selector.d.ts.map +0 -1
  1024. package/dist/modes/interactive/components/trust-selector.js +0 -91
  1025. package/dist/modes/interactive/components/trust-selector.js.map +0 -1
  1026. package/dist/modes/interactive/components/user-message-selector.d.ts +0 -30
  1027. package/dist/modes/interactive/components/user-message-selector.d.ts.map +0 -1
  1028. package/dist/modes/interactive/components/user-message-selector.js +0 -114
  1029. package/dist/modes/interactive/components/user-message-selector.js.map +0 -1
  1030. package/dist/modes/interactive/components/user-message.d.ts +0 -16
  1031. package/dist/modes/interactive/components/user-message.d.ts.map +0 -1
  1032. package/dist/modes/interactive/components/user-message.js +0 -49
  1033. package/dist/modes/interactive/components/user-message.js.map +0 -1
  1034. package/dist/modes/interactive/components/visual-truncate.d.ts +0 -24
  1035. package/dist/modes/interactive/components/visual-truncate.d.ts.map +0 -1
  1036. package/dist/modes/interactive/components/visual-truncate.js +0 -33
  1037. package/dist/modes/interactive/components/visual-truncate.js.map +0 -1
  1038. package/dist/modes/interactive/external-editor.d.ts +0 -12
  1039. package/dist/modes/interactive/external-editor.d.ts.map +0 -1
  1040. package/dist/modes/interactive/external-editor.js +0 -38
  1041. package/dist/modes/interactive/external-editor.js.map +0 -1
  1042. package/dist/modes/interactive/interactive-mode.d.ts +0 -443
  1043. package/dist/modes/interactive/interactive-mode.d.ts.map +0 -1
  1044. package/dist/modes/interactive/interactive-mode.js +0 -5604
  1045. package/dist/modes/interactive/interactive-mode.js.map +0 -1
  1046. package/dist/modes/interactive/model-catalog-refresh.d.ts.map +0 -1
  1047. package/dist/modes/interactive/model-catalog-refresh.js.map +0 -1
  1048. package/dist/modes/interactive/model-search.d.ts +0 -12
  1049. package/dist/modes/interactive/model-search.d.ts.map +0 -1
  1050. package/dist/modes/interactive/model-search.js +0 -15
  1051. package/dist/modes/interactive/model-search.js.map +0 -1
  1052. package/dist/modes/interactive/session-share.d.ts +0 -16
  1053. package/dist/modes/interactive/session-share.d.ts.map +0 -1
  1054. package/dist/modes/interactive/session-share.js +0 -184
  1055. package/dist/modes/interactive/session-share.js.map +0 -1
  1056. package/dist/modes/interactive/theme/dark.json +0 -91
  1057. package/dist/modes/interactive/theme/light.json +0 -90
  1058. package/dist/modes/interactive/theme/theme-controller.d.ts +0 -41
  1059. package/dist/modes/interactive/theme/theme-controller.d.ts.map +0 -1
  1060. package/dist/modes/interactive/theme/theme-controller.js +0 -130
  1061. package/dist/modes/interactive/theme/theme-controller.js.map +0 -1
  1062. package/dist/modes/interactive/theme/theme-json.d.ts +0 -84
  1063. package/dist/modes/interactive/theme/theme-json.d.ts.map +0 -1
  1064. package/dist/modes/interactive/theme/theme-json.js +0 -130
  1065. package/dist/modes/interactive/theme/theme-json.js.map +0 -1
  1066. package/dist/modes/interactive/theme/theme-schema.json +0 -356
  1067. package/dist/modes/interactive/theme/theme.d.ts +0 -131
  1068. package/dist/modes/interactive/theme/theme.d.ts.map +0 -1
  1069. package/dist/modes/interactive/theme/theme.js.map +0 -1
  1070. package/dist/modes/interactive/tui-renderer.d.ts +0 -21
  1071. package/dist/modes/interactive/tui-renderer.d.ts.map +0 -1
  1072. package/dist/modes/interactive/tui-renderer.js +0 -66
  1073. package/dist/modes/interactive/tui-renderer.js.map +0 -1
  1074. package/docs/development.md +0 -90
  1075. package/examples/extensions/border-status-editor.ts +0 -145
  1076. package/examples/extensions/built-in-tool-renderer.ts +0 -249
  1077. package/examples/extensions/custom-footer.ts +0 -64
  1078. package/examples/extensions/custom-header.ts +0 -73
  1079. package/examples/extensions/doom-overlay/README.md +0 -46
  1080. package/examples/extensions/doom-overlay/doom/build/doom.js +0 -21
  1081. package/examples/extensions/doom-overlay/doom/build/doom.wasm +0 -0
  1082. package/examples/extensions/doom-overlay/doom/build.sh +0 -152
  1083. package/examples/extensions/doom-overlay/doom/doomgeneric_pi.c +0 -72
  1084. package/examples/extensions/doom-overlay/doom-component.ts +0 -132
  1085. package/examples/extensions/doom-overlay/doom-engine.ts +0 -173
  1086. package/examples/extensions/doom-overlay/doom-keys.ts +0 -104
  1087. package/examples/extensions/doom-overlay/index.ts +0 -74
  1088. package/examples/extensions/doom-overlay/wad-finder.ts +0 -55
  1089. package/examples/extensions/entry-renderer.ts +0 -41
  1090. package/examples/extensions/github-issue-autocomplete.ts +0 -185
  1091. package/examples/extensions/handoff.ts +0 -190
  1092. package/examples/extensions/interactive-shell.ts +0 -196
  1093. package/examples/extensions/kimi-deferred-tools.ts +0 -61
  1094. package/examples/extensions/message-renderer.ts +0 -59
  1095. package/examples/extensions/minimal-mode.ts +0 -426
  1096. package/examples/extensions/modal-editor.ts +0 -85
  1097. package/examples/extensions/overlay-qa-tests.ts +0 -1450
  1098. package/examples/extensions/overlay-test.ts +0 -153
  1099. package/examples/extensions/plan-mode/README.md +0 -66
  1100. package/examples/extensions/plan-mode/index.ts +0 -390
  1101. package/examples/extensions/plan-mode/utils.ts +0 -168
  1102. package/examples/extensions/preset.ts +0 -436
  1103. package/examples/extensions/qna.ts +0 -118
  1104. package/examples/extensions/question.ts +0 -278
  1105. package/examples/extensions/questionnaire.ts +0 -440
  1106. package/examples/extensions/rainbow-editor.ts +0 -88
  1107. package/examples/extensions/snake.ts +0 -343
  1108. package/examples/extensions/space-invaders.ts +0 -560
  1109. package/examples/extensions/structured-output.ts +0 -65
  1110. package/examples/extensions/summarize.ts +0 -199
  1111. package/examples/extensions/tic-tac-toe.ts +0 -1008
  1112. package/examples/extensions/todo.ts +0 -297
  1113. package/examples/extensions/tools.ts +0 -146
  1114. package/examples/extensions/truncated-tool.ts +0 -195
  1115. package/examples/plugins/pi-example-plugin/README.md +0 -38
  1116. package/examples/plugins/pi-example-plugin/package.json +0 -10
  1117. package/examples/plugins/pi-example-plugin/src/contract.ts +0 -13
  1118. package/examples/plugins/pi-example-plugin/src/session.ts +0 -23
  1119. package/examples/plugins/pi-example-plugin/src/tui.ts +0 -31
  1120. package/examples/rpc-extension-ui.ts +0 -641
  1121. /package/dist/bundle/chunks/{chunk-PATAL4PO.js → chunk-7ZC4UXSL.js} +0 -0
@@ -0,0 +1,84 @@
1
+ /**
2
+ * MCP server configuration.
3
+ *
4
+ * Servers are read from `mcp.json` in the agent directory and, for trusted projects, from
5
+ * `<project>/.pi/mcp.json`. Both use the `mcpServers` shape shared by other MCP clients, so
6
+ * existing configurations can be copied over. Project entries replace global entries with the
7
+ * same name.
8
+ *
9
+ * A project entry without `command`, `url`, or `type` overrides only `enabled`, `exposure`, and
10
+ * `toolExposure` of the global server with the same name, for example to turn it off in one project:
11
+ * `{ "mcpServers": { "internal-tools": { "enabled": false } } }`. The rest of the global entry is kept,
12
+ * including credentials the project could not set itself.
13
+ *
14
+ * ```json
15
+ * {
16
+ * "mcpServers": {
17
+ * "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."] },
18
+ * "docs": { "url": "https://example.com/mcp", "headers": { "Authorization": "Bearer ${DOCS_TOKEN}" } },
19
+ * "sentry": { "url": "https://mcp.sentry.dev/mcp" }
20
+ * }
21
+ * }
22
+ * ```
23
+ *
24
+ * HTTP servers without an `Authorization` header use OAuth when they answer 401 (sign in with `/mcp`).
25
+ * `"auth": { "provider": "<provider>" }` sends the token of a `/login` provider instead. Project files
26
+ * cannot use it, so a repository cannot pick where the credential goes.
27
+ *
28
+ * The top-level `autoEnableCodemode` (default true) activates the codemode tool when a server
29
+ * with `codemode` exposure connects. A project value overrides the global one.
30
+ */
31
+ import { type McpExposure, type McpServerConfig } from "../../core/mcp-servers.ts";
32
+ export type { McpExposure, McpHttpServerConfig, McpOAuthConfig, McpServerConfig, McpStdioServerConfig, } from "../../core/mcp-servers.ts";
33
+ export { getMcpToolExposure } from "../../core/mcp-servers.ts";
34
+ export interface McpServerEntry {
35
+ name: string;
36
+ config: McpServerConfig;
37
+ /** Config file that defined the entry, or the path of the extension that registered it. */
38
+ source: string;
39
+ /**
40
+ * The global or the project `mcp.json`, or `extension` for servers registered with
41
+ * `pi.registerMcpServer()`. Changes to extension servers are not saved.
42
+ */
43
+ scope?: "global" | "project" | "extension";
44
+ /** Project `mcp.json` with an override of this global server's `enabled`, `exposure`, or `toolExposure`. */
45
+ override?: string;
46
+ }
47
+ export interface LoadedMcpConfig {
48
+ servers: McpServerEntry[];
49
+ /** Activate the codemode tool when `codemode` servers connect. Default: true. */
50
+ autoEnableCodemode?: boolean;
51
+ errors: string[];
52
+ /** The project `mcp.json` when the project is trusted, where `/mcp` saves project overrides. */
53
+ projectConfig?: string;
54
+ }
55
+ /**
56
+ * Load global and (when trusted) project MCP configuration. Disabled servers are included with
57
+ * `enabled: false`, so they can be enabled again.
58
+ */
59
+ export declare function loadMcpConfig(options: {
60
+ agentDir: string;
61
+ cwd: string;
62
+ projectTrusted: boolean;
63
+ }): LoadedMcpConfig;
64
+ /** Settings `/mcp` changes. `enabled: true` and `exposure: "codemode"` are the defaults and remove the key. */
65
+ export interface McpServerConfigPatch {
66
+ enabled?: boolean;
67
+ exposure?: McpExposure;
68
+ }
69
+ /**
70
+ * Change one server's settings in the `mcp.json` that defines or overrides it. With `override`, a
71
+ * missing entry is added as an override. Overrides keep default values, since they replace the global
72
+ * server's. Other content is kept; the file is rewritten with its indentation.
73
+ */
74
+ export declare function updateMcpServerConfig(path: string, name: string, patch: McpServerConfigPatch, options?: {
75
+ override?: boolean;
76
+ }): void;
77
+ /**
78
+ * Add a server to an `mcp.json`, creating the file when missing. An existing entry with the same
79
+ * name is replaced. Returns true when an entry was replaced.
80
+ */
81
+ export declare function addMcpServerConfig(path: string, name: string, config: McpServerConfig): boolean;
82
+ /** Remove a server from an `mcp.json`. Returns false when the file does not define it. */
83
+ export declare function removeMcpServerConfig(path: string, name: string): boolean;
84
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,eAAe,EAGpB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACX,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,oBAAoB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAC3C,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gGAAgG;IAChG,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAqED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,GAAG,eAAe,CAWlH;AAED,+GAA+G;AAC/G,MAAM,WAAW,oBAAoB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,IAAI,CAmBN;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAU/F;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUzE"}
@@ -0,0 +1,196 @@
1
+ /**
2
+ * MCP server configuration.
3
+ *
4
+ * Servers are read from `mcp.json` in the agent directory and, for trusted projects, from
5
+ * `<project>/.pi/mcp.json`. Both use the `mcpServers` shape shared by other MCP clients, so
6
+ * existing configurations can be copied over. Project entries replace global entries with the
7
+ * same name.
8
+ *
9
+ * A project entry without `command`, `url`, or `type` overrides only `enabled`, `exposure`, and
10
+ * `toolExposure` of the global server with the same name, for example to turn it off in one project:
11
+ * `{ "mcpServers": { "internal-tools": { "enabled": false } } }`. The rest of the global entry is kept,
12
+ * including credentials the project could not set itself.
13
+ *
14
+ * ```json
15
+ * {
16
+ * "mcpServers": {
17
+ * "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."] },
18
+ * "docs": { "url": "https://example.com/mcp", "headers": { "Authorization": "Bearer ${DOCS_TOKEN}" } },
19
+ * "sentry": { "url": "https://mcp.sentry.dev/mcp" }
20
+ * }
21
+ * }
22
+ * ```
23
+ *
24
+ * HTTP servers without an `Authorization` header use OAuth when they answer 401 (sign in with `/mcp`).
25
+ * `"auth": { "provider": "<provider>" }` sends the token of a `/login` provider instead. Project files
26
+ * cannot use it, so a repository cannot pick where the credential goes.
27
+ *
28
+ * The top-level `autoEnableCodemode` (default true) activates the codemode tool when a server
29
+ * with `codemode` exposure connects. A project value overrides the global one.
30
+ */
31
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
32
+ import { dirname, join } from "node:path";
33
+ import { CONFIG_DIR_NAME } from "../../config.js";
34
+ import { mcpNamespace, validateMcpServerConfig, } from "../../core/mcp-servers.js";
35
+ export { getMcpToolExposure } from "../../core/mcp-servers.js";
36
+ const OVERRIDE_KEYS = ["enabled", "exposure", "toolExposure"];
37
+ /** Whether an entry overrides a server defined elsewhere instead of defining one. */
38
+ function isOverride(value) {
39
+ return value.command === undefined && value.url === undefined && value.type === undefined;
40
+ }
41
+ function isRecord(value) {
42
+ return typeof value === "object" && value !== null && !Array.isArray(value);
43
+ }
44
+ function readConfigFile(path, scope, state) {
45
+ const { servers, errors } = state;
46
+ if (!existsSync(path))
47
+ return;
48
+ let parsed;
49
+ try {
50
+ parsed = JSON.parse(readFileSync(path, "utf8"));
51
+ }
52
+ catch (error) {
53
+ errors.push(`${path}: ${error instanceof Error ? error.message : String(error)}`);
54
+ return;
55
+ }
56
+ if (!isRecord(parsed) || (parsed.mcpServers !== undefined && !isRecord(parsed.mcpServers))) {
57
+ errors.push(`${path}: expected an object with an "mcpServers" object`);
58
+ return;
59
+ }
60
+ if (typeof parsed.autoEnableCodemode === "boolean")
61
+ state.autoEnableCodemode = parsed.autoEnableCodemode;
62
+ else if (parsed.autoEnableCodemode !== undefined)
63
+ errors.push(`${path}: autoEnableCodemode must be a boolean`);
64
+ for (const [name, value] of Object.entries(parsed.mcpServers ?? {})) {
65
+ if (scope === "project" && isRecord(value) && isOverride(value)) {
66
+ const base = servers.get(name);
67
+ const extra = Object.keys(value).filter((key) => !OVERRIDE_KEYS.includes(key));
68
+ if (!base) {
69
+ errors.push(`${path}: server "${name}" needs "command" or "url", or a global server to override`);
70
+ }
71
+ else if (extra.length > 0) {
72
+ errors.push(`${path}: server "${name}": an override can only set ${OVERRIDE_KEYS.join(", ")}`);
73
+ }
74
+ else {
75
+ const config = validateMcpServerConfig(name, { ...base.config, ...value });
76
+ if (typeof config === "string")
77
+ errors.push(`${path}: ${config}`);
78
+ else
79
+ servers.set(name, { ...base, config, override: path });
80
+ }
81
+ continue;
82
+ }
83
+ const config = validateMcpServerConfig(name, value);
84
+ if (typeof config === "string") {
85
+ errors.push(`${path}: ${config}`);
86
+ continue;
87
+ }
88
+ // Names that differ only in `-` and `_` would share a namespace.
89
+ const clash = [...servers.keys()].find((other) => other !== name && mcpNamespace(other) === mcpNamespace(name));
90
+ if (clash) {
91
+ errors.push(`${path}: server "${name}" conflicts with "${clash}"`);
92
+ continue;
93
+ }
94
+ if (scope === "project" && "url" in config && config.auth) {
95
+ errors.push(`${path}: server "${name}": auth is only allowed in the global mcp.json`);
96
+ continue;
97
+ }
98
+ servers.set(name, { name, config, source: path, scope });
99
+ }
100
+ }
101
+ /**
102
+ * Load global and (when trusted) project MCP configuration. Disabled servers are included with
103
+ * `enabled: false`, so they can be enabled again.
104
+ */
105
+ export function loadMcpConfig(options) {
106
+ const state = { servers: new Map(), errors: [] };
107
+ readConfigFile(join(options.agentDir, "mcp.json"), "global", state);
108
+ const projectConfig = options.projectTrusted ? join(options.cwd, CONFIG_DIR_NAME, "mcp.json") : undefined;
109
+ if (projectConfig)
110
+ readConfigFile(projectConfig, "project", state);
111
+ return {
112
+ servers: [...state.servers.values()],
113
+ ...(state.autoEnableCodemode === undefined ? {} : { autoEnableCodemode: state.autoEnableCodemode }),
114
+ errors: state.errors,
115
+ ...(projectConfig ? { projectConfig } : {}),
116
+ };
117
+ }
118
+ /**
119
+ * Change one server's settings in the `mcp.json` that defines or overrides it. With `override`, a
120
+ * missing entry is added as an override. Overrides keep default values, since they replace the global
121
+ * server's. Other content is kept; the file is rewritten with its indentation.
122
+ */
123
+ export function updateMcpServerConfig(path, name, patch, options = {}) {
124
+ editMcpServers(path, (servers, parsed) => {
125
+ let server = servers?.[name];
126
+ if (server === undefined && options.override) {
127
+ server = {};
128
+ parsed.mcpServers = { ...servers, [name]: server };
129
+ }
130
+ if (!isRecord(server))
131
+ throw new Error(`${path} does not define MCP server "${name}"`);
132
+ const keepDefaults = isOverride(server);
133
+ if (patch.enabled !== undefined) {
134
+ if (patch.enabled && !keepDefaults)
135
+ delete server.enabled;
136
+ else
137
+ server.enabled = patch.enabled;
138
+ }
139
+ if (patch.exposure !== undefined) {
140
+ if (patch.exposure === "codemode" && !keepDefaults)
141
+ delete server.exposure;
142
+ else
143
+ server.exposure = patch.exposure;
144
+ }
145
+ return true;
146
+ });
147
+ }
148
+ /**
149
+ * Add a server to an `mcp.json`, creating the file when missing. An existing entry with the same
150
+ * name is replaced. Returns true when an entry was replaced.
151
+ */
152
+ export function addMcpServerConfig(path, name, config) {
153
+ let replaced = false;
154
+ editMcpServers(path, (servers, parsed) => {
155
+ const target = servers ?? {};
156
+ replaced = target[name] !== undefined;
157
+ target[name] = config;
158
+ parsed.mcpServers = target;
159
+ return true;
160
+ });
161
+ return replaced;
162
+ }
163
+ /** Remove a server from an `mcp.json`. Returns false when the file does not define it. */
164
+ export function removeMcpServerConfig(path, name) {
165
+ if (!existsSync(path))
166
+ return false;
167
+ let removed = false;
168
+ editMcpServers(path, (servers) => {
169
+ if (!servers || servers[name] === undefined)
170
+ return false;
171
+ delete servers[name];
172
+ removed = true;
173
+ return true;
174
+ });
175
+ return removed;
176
+ }
177
+ /**
178
+ * Read an `mcp.json` (an empty config when missing), let `edit` change its `mcpServers`, and write
179
+ * it back with its indentation when `edit` returns true. Other content is kept.
180
+ */
181
+ function editMcpServers(path, edit) {
182
+ const text = existsSync(path) ? readFileSync(path, "utf8") : undefined;
183
+ const parsed = text === undefined ? {} : JSON.parse(text);
184
+ if (!isRecord(parsed) || (parsed.mcpServers !== undefined && !isRecord(parsed.mcpServers))) {
185
+ throw new Error(`${path}: expected an object with an "mcpServers" object`);
186
+ }
187
+ const servers = isRecord(parsed.mcpServers) ? parsed.mcpServers : undefined;
188
+ if (!edit(servers, parsed))
189
+ return;
190
+ const indent = (text && /^([ \t]+)\S/m.exec(text)?.[1]) || " ";
191
+ // mcp.json can hold literal credentials. The modes apply only to a newly created directory or file, so existing
192
+ // permissions are kept.
193
+ mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
194
+ writeFileSync(path, `${JSON.stringify(parsed, null, indent)}\n`, { mode: 0o600 });
195
+ }
196
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/extensions/mcp/config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP server configuration.\n *\n * Servers are read from `mcp.json` in the agent directory and, for trusted projects, from\n * `<project>/.pi/mcp.json`. Both use the `mcpServers` shape shared by other MCP clients, so\n * existing configurations can be copied over. Project entries replace global entries with the\n * same name.\n *\n * A project entry without `command`, `url`, or `type` overrides only `enabled`, `exposure`, and\n * `toolExposure` of the global server with the same name, for example to turn it off in one project:\n * `{ \"mcpServers\": { \"internal-tools\": { \"enabled\": false } } }`. The rest of the global entry is kept,\n * including credentials the project could not set itself.\n *\n * ```json\n * {\n * \"mcpServers\": {\n * \"filesystem\": { \"command\": \"npx\", \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem\", \".\"] },\n * \"docs\": { \"url\": \"https://example.com/mcp\", \"headers\": { \"Authorization\": \"Bearer ${DOCS_TOKEN}\" } },\n * \"sentry\": { \"url\": \"https://mcp.sentry.dev/mcp\" }\n * }\n * }\n * ```\n *\n * HTTP servers without an `Authorization` header use OAuth when they answer 401 (sign in with `/mcp`).\n * `\"auth\": { \"provider\": \"<provider>\" }` sends the token of a `/login` provider instead. Project files\n * cannot use it, so a repository cannot pick where the credential goes.\n *\n * The top-level `autoEnableCodemode` (default true) activates the codemode tool when a server\n * with `codemode` exposure connects. A project value overrides the global one.\n */\n\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { CONFIG_DIR_NAME } from \"../../config.ts\";\nimport {\n\ttype McpExposure,\n\ttype McpServerConfig,\n\tmcpNamespace,\n\tvalidateMcpServerConfig,\n} from \"../../core/mcp-servers.ts\";\n\nexport type {\n\tMcpExposure,\n\tMcpHttpServerConfig,\n\tMcpOAuthConfig,\n\tMcpServerConfig,\n\tMcpStdioServerConfig,\n} from \"../../core/mcp-servers.ts\";\nexport { getMcpToolExposure } from \"../../core/mcp-servers.ts\";\n\nexport interface McpServerEntry {\n\tname: string;\n\tconfig: McpServerConfig;\n\t/** Config file that defined the entry, or the path of the extension that registered it. */\n\tsource: string;\n\t/**\n\t * The global or the project `mcp.json`, or `extension` for servers registered with\n\t * `pi.registerMcpServer()`. Changes to extension servers are not saved.\n\t */\n\tscope?: \"global\" | \"project\" | \"extension\";\n\t/** Project `mcp.json` with an override of this global server's `enabled`, `exposure`, or `toolExposure`. */\n\toverride?: string;\n}\n\nexport interface LoadedMcpConfig {\n\tservers: McpServerEntry[];\n\t/** Activate the codemode tool when `codemode` servers connect. Default: true. */\n\tautoEnableCodemode?: boolean;\n\terrors: string[];\n\t/** The project `mcp.json` when the project is trusted, where `/mcp` saves project overrides. */\n\tprojectConfig?: string;\n}\n\nconst OVERRIDE_KEYS = [\"enabled\", \"exposure\", \"toolExposure\"];\n\n/** Whether an entry overrides a server defined elsewhere instead of defining one. */\nfunction isOverride(value: Record<string, unknown>): boolean {\n\treturn value.command === undefined && value.url === undefined && value.type === undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\ninterface McpConfigState {\n\tservers: Map<string, McpServerEntry>;\n\tautoEnableCodemode?: boolean;\n\terrors: string[];\n}\n\nfunction readConfigFile(path: string, scope: \"global\" | \"project\", state: McpConfigState): void {\n\tconst { servers, errors } = state;\n\tif (!existsSync(path)) return;\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(readFileSync(path, \"utf8\"));\n\t} catch (error) {\n\t\terrors.push(`${path}: ${error instanceof Error ? error.message : String(error)}`);\n\t\treturn;\n\t}\n\tif (!isRecord(parsed) || (parsed.mcpServers !== undefined && !isRecord(parsed.mcpServers))) {\n\t\terrors.push(`${path}: expected an object with an \"mcpServers\" object`);\n\t\treturn;\n\t}\n\tif (typeof parsed.autoEnableCodemode === \"boolean\") state.autoEnableCodemode = parsed.autoEnableCodemode;\n\telse if (parsed.autoEnableCodemode !== undefined) errors.push(`${path}: autoEnableCodemode must be a boolean`);\n\tfor (const [name, value] of Object.entries(parsed.mcpServers ?? {})) {\n\t\tif (scope === \"project\" && isRecord(value) && isOverride(value)) {\n\t\t\tconst base = servers.get(name);\n\t\t\tconst extra = Object.keys(value).filter((key) => !OVERRIDE_KEYS.includes(key));\n\t\t\tif (!base) {\n\t\t\t\terrors.push(`${path}: server \"${name}\" needs \"command\" or \"url\", or a global server to override`);\n\t\t\t} else if (extra.length > 0) {\n\t\t\t\terrors.push(`${path}: server \"${name}\": an override can only set ${OVERRIDE_KEYS.join(\", \")}`);\n\t\t\t} else {\n\t\t\t\tconst config = validateMcpServerConfig(name, { ...base.config, ...value });\n\t\t\t\tif (typeof config === \"string\") errors.push(`${path}: ${config}`);\n\t\t\t\telse servers.set(name, { ...base, config, override: path });\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tconst config = validateMcpServerConfig(name, value);\n\t\tif (typeof config === \"string\") {\n\t\t\terrors.push(`${path}: ${config}`);\n\t\t\tcontinue;\n\t\t}\n\t\t// Names that differ only in `-` and `_` would share a namespace.\n\t\tconst clash = [...servers.keys()].find((other) => other !== name && mcpNamespace(other) === mcpNamespace(name));\n\t\tif (clash) {\n\t\t\terrors.push(`${path}: server \"${name}\" conflicts with \"${clash}\"`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (scope === \"project\" && \"url\" in config && config.auth) {\n\t\t\terrors.push(`${path}: server \"${name}\": auth is only allowed in the global mcp.json`);\n\t\t\tcontinue;\n\t\t}\n\t\tservers.set(name, { name, config, source: path, scope });\n\t}\n}\n\n/**\n * Load global and (when trusted) project MCP configuration. Disabled servers are included with\n * `enabled: false`, so they can be enabled again.\n */\nexport function loadMcpConfig(options: { agentDir: string; cwd: string; projectTrusted: boolean }): LoadedMcpConfig {\n\tconst state: McpConfigState = { servers: new Map(), errors: [] };\n\treadConfigFile(join(options.agentDir, \"mcp.json\"), \"global\", state);\n\tconst projectConfig = options.projectTrusted ? join(options.cwd, CONFIG_DIR_NAME, \"mcp.json\") : undefined;\n\tif (projectConfig) readConfigFile(projectConfig, \"project\", state);\n\treturn {\n\t\tservers: [...state.servers.values()],\n\t\t...(state.autoEnableCodemode === undefined ? {} : { autoEnableCodemode: state.autoEnableCodemode }),\n\t\terrors: state.errors,\n\t\t...(projectConfig ? { projectConfig } : {}),\n\t};\n}\n\n/** Settings `/mcp` changes. `enabled: true` and `exposure: \"codemode\"` are the defaults and remove the key. */\nexport interface McpServerConfigPatch {\n\tenabled?: boolean;\n\texposure?: McpExposure;\n}\n\n/**\n * Change one server's settings in the `mcp.json` that defines or overrides it. With `override`, a\n * missing entry is added as an override. Overrides keep default values, since they replace the global\n * server's. Other content is kept; the file is rewritten with its indentation.\n */\nexport function updateMcpServerConfig(\n\tpath: string,\n\tname: string,\n\tpatch: McpServerConfigPatch,\n\toptions: { override?: boolean } = {},\n): void {\n\teditMcpServers(path, (servers, parsed) => {\n\t\tlet server = servers?.[name];\n\t\tif (server === undefined && options.override) {\n\t\t\tserver = {};\n\t\t\tparsed.mcpServers = { ...servers, [name]: server };\n\t\t}\n\t\tif (!isRecord(server)) throw new Error(`${path} does not define MCP server \"${name}\"`);\n\t\tconst keepDefaults = isOverride(server);\n\t\tif (patch.enabled !== undefined) {\n\t\t\tif (patch.enabled && !keepDefaults) delete server.enabled;\n\t\t\telse server.enabled = patch.enabled;\n\t\t}\n\t\tif (patch.exposure !== undefined) {\n\t\t\tif (patch.exposure === \"codemode\" && !keepDefaults) delete server.exposure;\n\t\t\telse server.exposure = patch.exposure;\n\t\t}\n\t\treturn true;\n\t});\n}\n\n/**\n * Add a server to an `mcp.json`, creating the file when missing. An existing entry with the same\n * name is replaced. Returns true when an entry was replaced.\n */\nexport function addMcpServerConfig(path: string, name: string, config: McpServerConfig): boolean {\n\tlet replaced = false;\n\teditMcpServers(path, (servers, parsed) => {\n\t\tconst target = servers ?? {};\n\t\treplaced = target[name] !== undefined;\n\t\ttarget[name] = config;\n\t\tparsed.mcpServers = target;\n\t\treturn true;\n\t});\n\treturn replaced;\n}\n\n/** Remove a server from an `mcp.json`. Returns false when the file does not define it. */\nexport function removeMcpServerConfig(path: string, name: string): boolean {\n\tif (!existsSync(path)) return false;\n\tlet removed = false;\n\teditMcpServers(path, (servers) => {\n\t\tif (!servers || servers[name] === undefined) return false;\n\t\tdelete servers[name];\n\t\tremoved = true;\n\t\treturn true;\n\t});\n\treturn removed;\n}\n\n/**\n * Read an `mcp.json` (an empty config when missing), let `edit` change its `mcpServers`, and write\n * it back with its indentation when `edit` returns true. Other content is kept.\n */\nfunction editMcpServers(\n\tpath: string,\n\tedit: (servers: Record<string, unknown> | undefined, parsed: Record<string, unknown>) => boolean,\n): void {\n\tconst text = existsSync(path) ? readFileSync(path, \"utf8\") : undefined;\n\tconst parsed: unknown = text === undefined ? {} : JSON.parse(text);\n\tif (!isRecord(parsed) || (parsed.mcpServers !== undefined && !isRecord(parsed.mcpServers))) {\n\t\tthrow new Error(`${path}: expected an object with an \"mcpServers\" object`);\n\t}\n\tconst servers = isRecord(parsed.mcpServers) ? parsed.mcpServers : undefined;\n\tif (!edit(servers, parsed)) return;\n\tconst indent = (text && /^([ \\t]+)\\S/m.exec(text)?.[1]) || \" \";\n\t// mcp.json can hold literal credentials. The modes apply only to a newly created directory or file, so existing\n\t// permissions are kept.\n\tmkdirSync(dirname(path), { recursive: true, mode: 0o700 });\n\twriteFileSync(path, `${JSON.stringify(parsed, null, indent)}\\n`, { mode: 0o600 });\n}\n"]}
@@ -1,3 +1,72 @@
1
- import type { ExtensionAPI } from "../../core/extensions/types.ts";
2
- export default function mcpExtension(pi: ExtensionAPI): void;
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 type { ExtensionContext, ExtensionFactory } from "../../core/extensions/types.ts";
27
+ import { type LoadedMcpConfig, type McpServerEntry } from "./config.ts";
28
+ import type { McpOAuthCredentialStore } from "./oauth.ts";
29
+ import type { McpTransportFactory } from "./runtime.ts";
30
+ export type { McpTransportFactory } from "./runtime.ts";
31
+ export interface McpExtensionOptions {
32
+ /** Defaults to reading `mcp.json` from the agent directory and the trusted project. */
33
+ loadConfig?: (ctx: ExtensionContext) => LoadedMcpConfig;
34
+ /** Defaults to stdio and streamable HTTP transports built from the server config. */
35
+ createTransport?: McpTransportFactory;
36
+ /** Defaults to `mcp-auth.json` in the agent directory. */
37
+ credentials?: McpOAuthCredentialStore;
38
+ /** File server log messages are appended to. Defaults to `mcp.log` in the agent directory. */
39
+ logPath?: string;
40
+ /** Opens the OAuth authorization URL. Defaults to the platform browser. */
41
+ openUrl?: (url: string) => void;
42
+ /**
43
+ * How long the first prompt waits for servers with `direct` tools that are still connecting at
44
+ * startup, in milliseconds. Their tools become available when they connect. Other servers are
45
+ * waited for when a script or search needs them. Default: 10000.
46
+ */
47
+ startupWaitMs?: number;
48
+ }
49
+ /** Name of the system prompt section that lists the servers whose tools are not declared. */
50
+ export declare const MCP_SERVERS_SECTION = "mcp_servers";
51
+ /**
52
+ * Characters of the whole section. Descriptions shrink to fit; when the server lines alone do not
53
+ * fit, the last servers are left out and counted in a closing line.
54
+ */
55
+ export declare const MAX_SERVERS_SECTION_CHARS = 4096;
56
+ /** What the `mcp_servers` section needs of a server. */
57
+ export interface McpServerListing {
58
+ entry: McpServerEntry;
59
+ connection?: {
60
+ instructions?: string;
61
+ };
62
+ }
63
+ /**
64
+ * The `mcp_servers` section: every enabled server with codemode or deferred tools, with how its
65
+ * tools are reached and a one-line summary. The model learns of the servers from it, since neither
66
+ * codemode nor tool_search lists them. Undefined when there are no such servers.
67
+ */
68
+ export declare function renderServersSection(servers: readonly McpServerListing[]): string | undefined;
69
+ export declare function createMcpExtension(options?: McpExtensionOptions): ExtensionFactory;
70
+ declare const _default: ExtensionFactory;
71
+ export default _default;
3
72
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,gCAAgC,CAAC;AA4IrF,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAsB3D","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { TSchema } from \"typebox\";\nimport type { ExtensionAPI, ExtensionContext } from \"../../core/extensions/types.ts\";\nimport { jsonSchemaToTypeBox, McpClient } from \"./mcp-client.ts\";\nimport { type McpAdapterEntry, type McpRegistry, punchRegistryToMcpServers } from \"./mcp-config.ts\";\nimport { type McpTransport, StdioMcpTransport, StreamableHttpMcpTransport } from \"./mcp-transport.ts\";\n\nconst clients: McpClient[] = [];\nlet extensionGeneration = 0;\n\nfunction trackClient(client: McpClient): void {\n\tclients.push(client);\n}\n\nfunction closeClients(): void {\n\textensionGeneration++;\n\tfor (const client of clients) {\n\t\tvoid client.close();\n\t}\n\tclients.length = 0;\n}\n\nfunction resolveEnvRef(value: string): string | undefined {\n\tconst match = /^\\$\\{([^}]+)\\}$/.exec(value);\n\tif (!match) return undefined;\n\treturn process.env[match[1]];\n}\n\nfunction sanitizeHeaderValue(value: string): string {\n\treturn value.replace(/[\\r\\n]/g, \"\");\n}\n\nfunction buildTransport(entry: McpAdapterEntry): McpTransport {\n\tif (entry.url) {\n\t\tconst headers: Record<string, string> = {};\n\t\tfor (const [key, value] of Object.entries(entry.headers ?? {})) {\n\t\t\theaders[key] = sanitizeHeaderValue(resolveEnvRef(value) ?? value);\n\t\t}\n\t\tif (entry.bearerTokenEnv) {\n\t\t\tconst token = process.env[entry.bearerTokenEnv];\n\t\t\tif (token) headers.Authorization = `Bearer ${sanitizeHeaderValue(token)}`;\n\t\t}\n\t\treturn new StreamableHttpMcpTransport({ url: entry.url, headers });\n\t}\n\tconst env: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(entry.env ?? {})) {\n\t\tenv[key] = resolveEnvRef(value) ?? value;\n\t}\n\tif (entry.bearerTokenEnv) {\n\t\tconst token = process.env[entry.bearerTokenEnv];\n\t\tif (token) env.API_KEY = token;\n\t}\n\treturn new StdioMcpTransport({\n\t\tcommand: entry.command ?? \"\",\n\t\targs: entry.args ?? [],\n\t\tenv,\n\t\tcwd: process.cwd(),\n\t});\n}\n\nasync function registerMcpServer(\n\tpi: ExtensionAPI,\n\tname: string,\n\tentry: McpAdapterEntry,\n\tgeneration: number,\n): Promise<void> {\n\tif (entry.disabled) return;\n\tconst client = new McpClient(buildTransport(entry));\n\ttrackClient(client);\n\tlet tools: Awaited<ReturnType<McpClient[\"listTools\"]>>;\n\ttry {\n\t\tawait client.start();\n\t\tif (generation !== extensionGeneration) {\n\t\t\tvoid client.close();\n\t\t\treturn;\n\t\t}\n\t\ttools = await client.listTools();\n\t\tif (generation !== extensionGeneration) {\n\t\t\tvoid client.close();\n\t\t\treturn;\n\t\t}\n\t} catch (err) {\n\t\tvoid client.close();\n\t\tif (generation !== extensionGeneration) return;\n\t\tpi.sendUserMessage(`mcp: failed to connect to server \"${name}\": ${(err as Error).message}`);\n\t\treturn;\n\t}\n\tfor (const tool of tools) {\n\t\tconst toolName = `mcp__${name}__${tool.name}`;\n\t\tlet parameters: TSchema;\n\t\ttry {\n\t\t\tparameters = jsonSchemaToTypeBox(tool.inputSchema);\n\t\t} catch (err) {\n\t\t\tpi.sendUserMessage(`mcp: skipped tool \"${name}.${tool.name}\": ${(err as Error).message}`);\n\t\t\tcontinue;\n\t\t}\n\t\tpi.registerTool({\n\t\t\tname: toolName,\n\t\t\tlabel: tool.name,\n\t\t\tdescription: tool.description ?? `MCP tool from server ${name}`,\n\t\t\tparameters,\n\t\t\tasync execute(\n\t\t\t\t_toolCallId: string,\n\t\t\t\targs: Record<string, unknown>,\n\t\t\t\t_signal: AbortSignal | undefined,\n\t\t\t\t_onUpdate: unknown,\n\t\t\t\t_ctx: ExtensionContext,\n\t\t\t): Promise<{\n\t\t\t\tcontent: { type: \"text\"; text: string }[] | { type: \"image\"; data: string; mimeType: string }[];\n\t\t\t\tdetails: Record<string, unknown>;\n\t\t\t\tisError?: boolean;\n\t\t\t}> {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await client.callTool(tool.name, args);\n\t\t\t\t\tconst text =\n\t\t\t\t\t\tresult.content\n\t\t\t\t\t\t\t?.map((c) => c.text ?? \"\")\n\t\t\t\t\t\t\t.filter(Boolean)\n\t\t\t\t\t\t\t.join(\"\\n\") ?? \"\";\n\t\t\t\t\tconst images = result.content\n\t\t\t\t\t\t?.filter(\n\t\t\t\t\t\t\t(c): c is { type: \"image\"; data: string; mimeType: string } =>\n\t\t\t\t\t\t\t\tc.type === \"image\" && typeof c.data === \"string\",\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.map((c) => ({ type: \"image\" as const, data: c.data, mimeType: c.mimeType ?? \"image/png\" }));\n\t\t\t\t\tconst content =\n\t\t\t\t\t\timages && images.length > 0 ? images : [{ type: \"text\" as const, text: text || \"(no text output)\" }];\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\tdetails: { server: name, tool: tool.name },\n\t\t\t\t\t\t...(result.isError === true ? { isError: true } : {}),\n\t\t\t\t\t};\n\t\t\t\t} catch (err) {\n\t\t\t\t\tthrow new Error(`Error calling MCP tool ${name}.${tool.name}: ${(err as Error).message}`, {\n\t\t\t\t\t\tcause: err,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t}\n}\n\nexport default function mcpExtension(pi: ExtensionAPI): void {\n\tconst generation = ++extensionGeneration;\n\tconst configPath = process.env.PI_MCP_FILE || path.join(process.cwd(), \".pi\", \"mcp.json\");\n\tvoid readFile(configPath, \"utf8\")\n\t\t.then((raw) => {\n\t\t\tif (generation !== extensionGeneration) return;\n\t\t\tconst registry = JSON.parse(raw) as McpRegistry;\n\t\t\tconst servers = punchRegistryToMcpServers(registry);\n\t\t\tfor (const [name, entry] of Object.entries(servers)) {\n\t\t\t\tvoid registerMcpServer(pi, name, entry, generation);\n\t\t\t}\n\t\t})\n\t\t.catch((err: unknown) => {\n\t\t\tif (generation !== extensionGeneration) return;\n\t\t\tconst code = (err as NodeJS.ErrnoException).code;\n\t\t\tif (code !== \"ENOENT\") {\n\t\t\t\tpi.sendUserMessage(`mcp: failed to load ${configPath}: ${(err as Error).message}`);\n\t\t\t}\n\t\t});\n\tpi.on(\"session_shutdown\", () => {\n\t\tcloseClients();\n\t});\n}\n"]}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EAGX,gBAAgB,EAChB,gBAAgB,EAEhB,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EAEN,KAAK,eAAe,EAGpB,KAAK,cAAc,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,uBAAuB,EAAmB,MAAM,YAAY,CAAC;AAS3E,OAAO,KAAK,EAAqC,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG3F,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,mBAAmB;IACnC,uFAAuF;IACvF,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,eAAe,CAAC;IACxD,qFAAqF;IACrF,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAsDD,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAGjD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAe9C,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAQD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,GAAG,SAAS,CA0B7F;AAmCD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,gBAAgB,CAmtBtF"}