@punch-bot/cli 1.5.1 → 1.5.3

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 (505) hide show
  1. package/CHANGELOG.md +162 -1
  2. package/README.md +6 -8
  3. package/dist/bundle/chunks/anthropic-messages-WIBS5YKY.js +6 -0
  4. package/dist/bundle/chunks/azure-openai-responses-GP5GDEGO.js +2 -0
  5. package/dist/bundle/chunks/bedrock-converse-stream.js +7 -4
  6. package/dist/bundle/chunks/chunk-35EHANXE.js +2 -0
  7. package/dist/bundle/chunks/chunk-3IMHRFLG.js +6 -0
  8. package/dist/bundle/chunks/chunk-77CRE5SV.js +9 -0
  9. package/dist/bundle/chunks/chunk-CE33JMCE.js +861 -0
  10. package/dist/bundle/chunks/{chunk-MYNHUMKE.js → chunk-CXY7BILM.js} +2 -44
  11. package/dist/bundle/chunks/chunk-EISXNXOQ.js +41 -0
  12. package/dist/bundle/chunks/chunk-ENMVUQHE.js +26 -0
  13. package/dist/bundle/chunks/chunk-FFMDRXC4.js +10 -0
  14. package/dist/bundle/chunks/chunk-GFUN2N5K.js +2 -0
  15. package/dist/bundle/chunks/chunk-HQH636GU.js +361 -0
  16. package/dist/bundle/chunks/chunk-IEBK4HQA.js +2 -0
  17. package/dist/bundle/chunks/chunk-JAJLG57O.js +4 -0
  18. package/dist/bundle/chunks/{chunk-RROECCMX.js → chunk-LOHGXPCL.js} +2 -2
  19. package/dist/bundle/chunks/{chunk-CRILLKNU.js → chunk-OV2VGRRS.js} +1 -1
  20. package/dist/bundle/chunks/chunk-P7FPUEYA.js +2 -0
  21. package/dist/bundle/chunks/chunk-PDENR63J.js +16 -0
  22. package/dist/bundle/chunks/chunk-RHOWRSGK.js +2 -0
  23. package/dist/bundle/chunks/{chunk-HMPP4ECW.js → chunk-UZ3LUZDC.js} +1 -1
  24. package/dist/bundle/chunks/chunk-WN2D4UD4.js +2 -0
  25. package/dist/bundle/chunks/chunk-X4T5TGM4.js +82 -0
  26. package/dist/bundle/chunks/chunk-ZG74NES2.js +2 -0
  27. package/dist/bundle/chunks/cli-OQNR6ESL.js +53 -0
  28. package/dist/bundle/chunks/{cloudflare-workers-ai-system-one-JWAAZATQ.js → cloudflare-workers-ai-system-one-36EDUVVN.js} +1 -1
  29. package/dist/bundle/chunks/codemode-worker.js +2 -0
  30. package/dist/bundle/chunks/{execute-HXULRBCI.js → execute-EHT55MW7.js} +5 -3
  31. package/dist/bundle/chunks/github-copilot.js +1 -1
  32. package/dist/bundle/chunks/{google-generative-ai-EHUU7JII.js → google-generative-ai-KA6FZCHM.js} +1 -1
  33. package/dist/bundle/chunks/{google-vertex-AFMVUS5C.js → google-vertex-DXKQ4IYR.js} +1 -1
  34. package/dist/bundle/chunks/image-resize-worker.js +1 -1
  35. package/dist/bundle/chunks/kimi-coding.js +1 -1
  36. package/dist/bundle/chunks/{llama-cpp-classify-YVA2UOJG.js → llama-cpp-classify-676UCBOD.js} +1 -1
  37. package/dist/bundle/chunks/meta.js +1 -1
  38. package/dist/bundle/chunks/mistral-conversations-PJ56UMXO.js +5 -0
  39. package/dist/bundle/chunks/openai-codex-responses-DWVG7MAQ.js +10 -0
  40. package/dist/bundle/chunks/openai-completions-OKI6KBNP.js +7 -0
  41. package/dist/bundle/chunks/{openai-decisions-GNOLFL74.js → openai-decisions-SO57QA6O.js} +1 -1
  42. package/dist/bundle/chunks/openai-responses-3HV234HB.js +4 -0
  43. package/dist/bundle/chunks/{openrouter-images-ZTNVFSL2.js → openrouter-images-5X6D7HFS.js} +1 -1
  44. package/dist/bundle/chunks/pi-messages-BS5Z34RE.js +8 -0
  45. package/dist/bundle/chunks/radius.js +1 -1
  46. package/dist/bundle/chunks/{runtime-R5GXO4CV.js → runtime-74PFKASL.js} +1 -1
  47. package/dist/bundle/chunks/{typesafe-system-one-I5AHLF6T.js → typesafe-system-one-IPNULX2M.js} +1 -1
  48. package/dist/bundle/chunks/virtual-modules-2Y422I6U.js +2 -0
  49. package/dist/bundle/cli-runtime.js +1 -1
  50. package/dist/bundle/index.js +1 -1
  51. package/dist/bundle/rpc-entry.js +1 -1
  52. package/dist/cli/args.d.ts +0 -1
  53. package/dist/cli/args.d.ts.map +1 -1
  54. package/dist/cli/args.js +8 -12
  55. package/dist/cli/args.js.map +1 -1
  56. package/dist/cli/auth-command.d.ts.map +1 -1
  57. package/dist/cli/auth-command.js +26 -2
  58. package/dist/cli/auth-command.js.map +1 -1
  59. package/dist/cli/auth-login.d.ts +15 -0
  60. package/dist/cli/auth-login.d.ts.map +1 -0
  61. package/dist/cli/auth-login.js +232 -0
  62. package/dist/cli/auth-login.js.map +1 -0
  63. package/dist/cli/auth-logout.d.ts +14 -0
  64. package/dist/cli/auth-logout.d.ts.map +1 -0
  65. package/dist/cli/auth-logout.js +63 -0
  66. package/dist/cli/auth-logout.js.map +1 -0
  67. package/dist/cli/auth-terminal.d.ts +17 -0
  68. package/dist/cli/auth-terminal.d.ts.map +1 -0
  69. package/dist/cli/auth-terminal.js +63 -0
  70. package/dist/cli/auth-terminal.js.map +1 -0
  71. package/dist/cli/project-trust.js +1 -1
  72. package/dist/cli/project-trust.js.map +1 -1
  73. package/dist/config.d.ts +10 -2
  74. package/dist/config.d.ts.map +1 -1
  75. package/dist/config.js +24 -11
  76. package/dist/config.js.map +1 -1
  77. package/dist/core/agent-session-runtime.d.ts +5 -0
  78. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  79. package/dist/core/agent-session-runtime.js +20 -5
  80. package/dist/core/agent-session-runtime.js.map +1 -1
  81. package/dist/core/agent-session.d.ts +31 -15
  82. package/dist/core/agent-session.d.ts.map +1 -1
  83. package/dist/core/agent-session.js +158 -71
  84. package/dist/core/agent-session.js.map +1 -1
  85. package/dist/core/auth-storage.d.ts.map +1 -1
  86. package/dist/core/auth-storage.js +3 -2
  87. package/dist/core/auth-storage.js.map +1 -1
  88. package/dist/core/bash-executor.d.ts.map +1 -1
  89. package/dist/core/bash-executor.js +3 -1
  90. package/dist/core/bash-executor.js.map +1 -1
  91. package/dist/core/cache-warmer.d.ts +4 -37
  92. package/dist/core/cache-warmer.d.ts.map +1 -1
  93. package/dist/core/cache-warmer.js +11 -89
  94. package/dist/core/cache-warmer.js.map +1 -1
  95. package/dist/core/compaction/branch-summarization.d.ts +4 -2
  96. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  97. package/dist/core/compaction/branch-summarization.js +16 -4
  98. package/dist/core/compaction/branch-summarization.js.map +1 -1
  99. package/dist/core/compaction/utils.d.ts.map +1 -1
  100. package/dist/core/compaction/utils.js +2 -1
  101. package/dist/core/compaction/utils.js.map +1 -1
  102. package/dist/core/exec.d.ts +9 -1
  103. package/dist/core/exec.d.ts.map +1 -1
  104. package/dist/core/exec.js +104 -60
  105. package/dist/core/exec.js.map +1 -1
  106. package/dist/core/export-html/template.css +9 -0
  107. package/dist/core/export-html/template.js +165 -45
  108. package/dist/core/extensions/index.d.ts +1 -1
  109. package/dist/core/extensions/index.d.ts.map +1 -1
  110. package/dist/core/extensions/index.js.map +1 -1
  111. package/dist/core/extensions/loader.d.ts.map +1 -1
  112. package/dist/core/extensions/loader.js +10 -13
  113. package/dist/core/extensions/loader.js.map +1 -1
  114. package/dist/core/extensions/pi-ai-extension-view.d.ts +19 -0
  115. package/dist/core/extensions/pi-ai-extension-view.d.ts.map +1 -0
  116. package/dist/core/extensions/pi-ai-extension-view.js +22 -0
  117. package/dist/core/extensions/pi-ai-extension-view.js.map +1 -0
  118. package/dist/core/extensions/runner.d.ts +1 -4
  119. package/dist/core/extensions/runner.d.ts.map +1 -1
  120. package/dist/core/extensions/runner.js +0 -14
  121. package/dist/core/extensions/runner.js.map +1 -1
  122. package/dist/core/extensions/types.d.ts +5 -18
  123. package/dist/core/extensions/types.d.ts.map +1 -1
  124. package/dist/core/extensions/types.js +1 -1
  125. package/dist/core/extensions/types.js.map +1 -1
  126. package/dist/core/extensions/virtual-modules.d.ts.map +1 -1
  127. package/dist/core/extensions/virtual-modules.js +8 -7
  128. package/dist/core/extensions/virtual-modules.js.map +1 -1
  129. package/dist/core/index.d.ts +1 -1
  130. package/dist/core/index.d.ts.map +1 -1
  131. package/dist/core/index.js.map +1 -1
  132. package/dist/core/mcp-servers.d.ts +23 -41
  133. package/dist/core/mcp-servers.d.ts.map +1 -1
  134. package/dist/core/mcp-servers.js +51 -120
  135. package/dist/core/mcp-servers.js.map +1 -1
  136. package/dist/core/model-config.d.ts +1730 -2029
  137. package/dist/core/model-config.d.ts.map +1 -1
  138. package/dist/core/model-config.js +2 -3
  139. package/dist/core/model-config.js.map +1 -1
  140. package/dist/core/model-resolver.d.ts.map +1 -1
  141. package/dist/core/model-resolver.js +36 -29
  142. package/dist/core/model-resolver.js.map +1 -1
  143. package/dist/core/model-runtime.d.ts +5 -0
  144. package/dist/core/model-runtime.d.ts.map +1 -1
  145. package/dist/core/model-runtime.js +11 -4
  146. package/dist/core/model-runtime.js.map +1 -1
  147. package/dist/core/package-manager.d.ts +24 -1
  148. package/dist/core/package-manager.d.ts.map +1 -1
  149. package/dist/core/package-manager.js +210 -51
  150. package/dist/core/package-manager.js.map +1 -1
  151. package/dist/core/pi-ai-schemas.d.ts +167 -0
  152. package/dist/core/pi-ai-schemas.d.ts.map +1 -0
  153. package/dist/core/pi-ai-schemas.js +21 -0
  154. package/dist/core/pi-ai-schemas.js.map +1 -0
  155. package/dist/core/pi-manifest.d.ts +1 -0
  156. package/dist/core/pi-manifest.d.ts.map +1 -1
  157. package/dist/core/pi-manifest.js +4 -0
  158. package/dist/core/pi-manifest.js.map +1 -1
  159. package/dist/core/preferred-providers.d.ts +17 -0
  160. package/dist/core/preferred-providers.d.ts.map +1 -0
  161. package/dist/core/preferred-providers.js +24 -0
  162. package/dist/core/preferred-providers.js.map +1 -0
  163. package/dist/core/project-trust.d.ts +1 -1
  164. package/dist/core/project-trust.d.ts.map +1 -1
  165. package/dist/core/project-trust.js +1 -1
  166. package/dist/core/project-trust.js.map +1 -1
  167. package/dist/core/prompt-templates.d.ts.map +1 -1
  168. package/dist/core/prompt-templates.js +18 -2
  169. package/dist/core/prompt-templates.js.map +1 -1
  170. package/dist/core/provider-composer.d.ts.map +1 -1
  171. package/dist/core/provider-composer.js +3 -1
  172. package/dist/core/provider-composer.js.map +1 -1
  173. package/dist/core/provider-matching.d.ts +11 -0
  174. package/dist/core/provider-matching.d.ts.map +1 -0
  175. package/dist/core/provider-matching.js +14 -0
  176. package/dist/core/provider-matching.js.map +1 -0
  177. package/dist/core/radius-mcp.d.ts +13 -0
  178. package/dist/core/radius-mcp.d.ts.map +1 -0
  179. package/dist/core/radius-mcp.js +29 -0
  180. package/dist/core/radius-mcp.js.map +1 -0
  181. package/dist/core/radius.d.ts +0 -3
  182. package/dist/core/radius.d.ts.map +1 -1
  183. package/dist/core/radius.js +0 -5
  184. package/dist/core/radius.js.map +1 -1
  185. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  186. package/dist/core/remote-catalog-provider.js +2 -0
  187. package/dist/core/remote-catalog-provider.js.map +1 -1
  188. package/dist/core/resource-loader.d.ts +4 -1
  189. package/dist/core/resource-loader.d.ts.map +1 -1
  190. package/dist/core/resource-loader.js +40 -25
  191. package/dist/core/resource-loader.js.map +1 -1
  192. package/dist/core/runtime-credentials.d.ts +8 -0
  193. package/dist/core/runtime-credentials.d.ts.map +1 -1
  194. package/dist/core/runtime-credentials.js +15 -1
  195. package/dist/core/runtime-credentials.js.map +1 -1
  196. package/dist/core/sdk.d.ts.map +1 -1
  197. package/dist/core/sdk.js +3 -1
  198. package/dist/core/sdk.js.map +1 -1
  199. package/dist/core/session-cwd.d.ts +0 -1
  200. package/dist/core/session-cwd.d.ts.map +1 -1
  201. package/dist/core/session-cwd.js +0 -3
  202. package/dist/core/session-cwd.js.map +1 -1
  203. package/dist/core/session-manager.d.ts +7 -0
  204. package/dist/core/session-manager.d.ts.map +1 -1
  205. package/dist/core/session-manager.js +32 -13
  206. package/dist/core/session-manager.js.map +1 -1
  207. package/dist/core/settings-defaults.d.ts +1 -31
  208. package/dist/core/settings-defaults.d.ts.map +1 -1
  209. package/dist/core/settings-defaults.js +1 -31
  210. package/dist/core/settings-defaults.js.map +1 -1
  211. package/dist/core/settings-manager.d.ts +4 -56
  212. package/dist/core/settings-manager.d.ts.map +1 -1
  213. package/dist/core/settings-manager.js +11 -247
  214. package/dist/core/settings-manager.js.map +1 -1
  215. package/dist/core/settings-schema.d.ts +4 -54
  216. package/dist/core/settings-schema.d.ts.map +1 -1
  217. package/dist/core/settings-schema.js +7 -101
  218. package/dist/core/settings-schema.js.map +1 -1
  219. package/dist/core/skills.d.ts.map +1 -1
  220. package/dist/core/skills.js +6 -14
  221. package/dist/core/skills.js.map +1 -1
  222. package/dist/core/slash-commands.d.ts +0 -6
  223. package/dist/core/slash-commands.d.ts.map +1 -1
  224. package/dist/core/slash-commands.js +1 -27
  225. package/dist/core/slash-commands.js.map +1 -1
  226. package/dist/core/source-info.d.ts +9 -0
  227. package/dist/core/source-info.d.ts.map +1 -1
  228. package/dist/core/source-info.js +13 -0
  229. package/dist/core/source-info.js.map +1 -1
  230. package/dist/core/system-prompt.d.ts.map +1 -1
  231. package/dist/core/system-prompt.js +5 -6
  232. package/dist/core/system-prompt.js.map +1 -1
  233. package/dist/core/telemetry.js +1 -1
  234. package/dist/core/telemetry.js.map +1 -1
  235. package/dist/core/theme/theme.d.ts.map +1 -1
  236. package/dist/core/theme/theme.js +5 -1
  237. package/dist/core/theme/theme.js.map +1 -1
  238. package/dist/core/tools/bash.d.ts +2 -2
  239. package/dist/core/tools/bash.d.ts.map +1 -1
  240. package/dist/core/tools/bash.js +35 -5
  241. package/dist/core/tools/bash.js.map +1 -1
  242. package/dist/core/tools/edit-diff.d.ts +23 -14
  243. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  244. package/dist/core/tools/edit-diff.js +182 -41
  245. package/dist/core/tools/edit-diff.js.map +1 -1
  246. package/dist/core/tools/edit.d.ts +3 -3
  247. package/dist/core/tools/edit.d.ts.map +1 -1
  248. package/dist/core/tools/edit.js +10 -11
  249. package/dist/core/tools/edit.js.map +1 -1
  250. package/dist/core/tools/find.d.ts +2 -2
  251. package/dist/core/tools/find.d.ts.map +1 -1
  252. package/dist/core/tools/find.js +82 -36
  253. package/dist/core/tools/find.js.map +1 -1
  254. package/dist/core/tools/grep.d.ts +7 -5
  255. package/dist/core/tools/grep.d.ts.map +1 -1
  256. package/dist/core/tools/grep.js +87 -75
  257. package/dist/core/tools/grep.js.map +1 -1
  258. package/dist/core/tools/ls.d.ts +2 -2
  259. package/dist/core/tools/ls.d.ts.map +1 -1
  260. package/dist/core/tools/ls.js +2 -1
  261. package/dist/core/tools/ls.js.map +1 -1
  262. package/dist/core/tools/powershell.d.ts.map +1 -1
  263. package/dist/core/tools/powershell.js +15 -2
  264. package/dist/core/tools/powershell.js.map +1 -1
  265. package/dist/core/tools/read.d.ts +10 -2
  266. package/dist/core/tools/read.d.ts.map +1 -1
  267. package/dist/core/tools/read.js +141 -25
  268. package/dist/core/tools/read.js.map +1 -1
  269. package/dist/core/tools/tool-definition-wrapper.d.ts +11 -1
  270. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  271. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  272. package/dist/core/tools/truncate.d.ts +4 -14
  273. package/dist/core/tools/truncate.d.ts.map +1 -1
  274. package/dist/core/tools/truncate.js +23 -29
  275. package/dist/core/tools/truncate.js.map +1 -1
  276. package/dist/core/tools/write.d.ts +2 -2
  277. package/dist/core/tools/write.d.ts.map +1 -1
  278. package/dist/core/tools/write.js.map +1 -1
  279. package/dist/core/trust-manager.d.ts.map +1 -1
  280. package/dist/core/trust-manager.js +14 -8
  281. package/dist/core/trust-manager.js.map +1 -1
  282. package/dist/core/usage-totals.d.ts.map +1 -1
  283. package/dist/core/usage-totals.js +2 -0
  284. package/dist/core/usage-totals.js.map +1 -1
  285. package/dist/extensions/codemode/execute.js +4 -4
  286. package/dist/extensions/codemode/execute.js.map +1 -1
  287. package/dist/extensions/codemode/tool.d.ts +2 -1
  288. package/dist/extensions/codemode/tool.d.ts.map +1 -1
  289. package/dist/extensions/codemode/tool.js +59 -12
  290. package/dist/extensions/codemode/tool.js.map +1 -1
  291. package/dist/extensions/llama/client.d.ts +2 -0
  292. package/dist/extensions/llama/client.d.ts.map +1 -1
  293. package/dist/extensions/llama/client.js +23 -2
  294. package/dist/extensions/llama/client.js.map +1 -1
  295. package/dist/extensions/llama/index.d.ts.map +1 -1
  296. package/dist/extensions/llama/index.js +1 -1
  297. package/dist/extensions/llama/index.js.map +1 -1
  298. package/dist/extensions/mcp/cli.d.ts +2 -0
  299. package/dist/extensions/mcp/cli.d.ts.map +1 -1
  300. package/dist/extensions/mcp/cli.js +83 -22
  301. package/dist/extensions/mcp/cli.js.map +1 -1
  302. package/dist/extensions/mcp/config.d.ts.map +1 -1
  303. package/dist/extensions/mcp/config.js +4 -7
  304. package/dist/extensions/mcp/config.js.map +1 -1
  305. package/dist/extensions/mcp/index.d.ts.map +1 -1
  306. package/dist/extensions/mcp/index.js +5 -4
  307. package/dist/extensions/mcp/index.js.map +1 -1
  308. package/dist/extensions/mcp/oauth.d.ts +11 -49
  309. package/dist/extensions/mcp/oauth.d.ts.map +1 -1
  310. package/dist/extensions/mcp/oauth.js +56 -296
  311. package/dist/extensions/mcp/oauth.js.map +1 -1
  312. package/dist/extensions/mcp/resources.d.ts +1 -1
  313. package/dist/extensions/mcp/resources.d.ts.map +1 -1
  314. package/dist/extensions/mcp/resources.js +4 -3
  315. package/dist/extensions/mcp/resources.js.map +1 -1
  316. package/dist/extensions/mcp/runtime.d.ts +4 -3
  317. package/dist/extensions/mcp/runtime.d.ts.map +1 -1
  318. package/dist/extensions/mcp/runtime.js +7 -5
  319. package/dist/extensions/mcp/runtime.js.map +1 -1
  320. package/dist/extensions/mcp/tools.d.ts +2 -23
  321. package/dist/extensions/mcp/tools.d.ts.map +1 -1
  322. package/dist/extensions/mcp/tools.js +6 -58
  323. package/dist/extensions/mcp/tools.js.map +1 -1
  324. package/dist/extensions/punch/index.d.ts.map +1 -1
  325. package/dist/extensions/punch/index.js +1 -1
  326. package/dist/extensions/punch/index.js.map +1 -1
  327. package/dist/extensions/punch/todos.js +1 -1
  328. package/dist/extensions/punch/todos.js.map +1 -1
  329. package/dist/extensions/subagent/index.d.ts.map +1 -1
  330. package/dist/extensions/subagent/index.js +278 -129
  331. package/dist/extensions/subagent/index.js.map +1 -1
  332. package/dist/extensions/tool-search/tool.d.ts +21 -6
  333. package/dist/extensions/tool-search/tool.d.ts.map +1 -1
  334. package/dist/extensions/tool-search/tool.js +122 -42
  335. package/dist/extensions/tool-search/tool.js.map +1 -1
  336. package/dist/index.d.ts +4 -4
  337. package/dist/index.d.ts.map +1 -1
  338. package/dist/index.js +2 -0
  339. package/dist/index.js.map +1 -1
  340. package/dist/main.d.ts.map +1 -1
  341. package/dist/main.js +106 -14
  342. package/dist/main.js.map +1 -1
  343. package/dist/modes/print-mode.d.ts.map +1 -1
  344. package/dist/modes/print-mode.js +19 -10
  345. package/dist/modes/print-mode.js.map +1 -1
  346. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  347. package/dist/modes/rpc/rpc-mode.js +53 -23
  348. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  349. package/dist/package-manager-cli.d.ts.map +1 -1
  350. package/dist/package-manager-cli.js +94 -12
  351. package/dist/package-manager-cli.js.map +1 -1
  352. package/dist/utils/ansi.d.ts.map +1 -1
  353. package/dist/utils/ansi.js +5 -2
  354. package/dist/utils/ansi.js.map +1 -1
  355. package/dist/utils/changelog.d.ts +2 -2
  356. package/dist/utils/changelog.d.ts.map +1 -1
  357. package/dist/utils/changelog.js +12 -9
  358. package/dist/utils/changelog.js.map +1 -1
  359. package/dist/utils/clipboard-command.d.ts.map +1 -1
  360. package/dist/utils/clipboard-command.js +4 -0
  361. package/dist/utils/clipboard-command.js.map +1 -1
  362. package/dist/utils/fuzzy.d.ts.map +1 -1
  363. package/dist/utils/fuzzy.js +59 -44
  364. package/dist/utils/fuzzy.js.map +1 -1
  365. package/dist/utils/git.d.ts +11 -1
  366. package/dist/utils/git.d.ts.map +1 -1
  367. package/dist/utils/git.js +44 -0
  368. package/dist/utils/git.js.map +1 -1
  369. package/dist/utils/image-resize-core.d.ts.map +1 -1
  370. package/dist/utils/image-resize-core.js +5 -3
  371. package/dist/utils/image-resize-core.js.map +1 -1
  372. package/dist/utils/image-resize.d.ts.map +1 -1
  373. package/dist/utils/image-resize.js +3 -1
  374. package/dist/utils/image-resize.js.map +1 -1
  375. package/dist/utils/open-browser.d.ts.map +1 -1
  376. package/dist/utils/open-browser.js +4 -1
  377. package/dist/utils/open-browser.js.map +1 -1
  378. package/dist/utils/paths.d.ts +17 -0
  379. package/dist/utils/paths.d.ts.map +1 -1
  380. package/dist/utils/paths.js +42 -1
  381. package/dist/utils/paths.js.map +1 -1
  382. package/dist/utils/shell.d.ts.map +1 -1
  383. package/dist/utils/shell.js +14 -0
  384. package/dist/utils/shell.js.map +1 -1
  385. package/dist/utils/terminal-question.d.ts +8 -0
  386. package/dist/utils/terminal-question.d.ts.map +1 -0
  387. package/dist/utils/terminal-question.js +24 -0
  388. package/dist/utils/terminal-question.js.map +1 -0
  389. package/dist/utils/text.d.ts +2 -0
  390. package/dist/utils/text.d.ts.map +1 -1
  391. package/dist/utils/text.js +5 -0
  392. package/dist/utils/text.js.map +1 -1
  393. package/dist/utils/tools-manager.d.ts.map +1 -1
  394. package/dist/utils/tools-manager.js +30 -35
  395. package/dist/utils/tools-manager.js.map +1 -1
  396. package/dist/utils/web-url.d.ts +12 -0
  397. package/dist/utils/web-url.d.ts.map +1 -0
  398. package/dist/utils/web-url.js +20 -0
  399. package/dist/utils/web-url.js.map +1 -0
  400. package/docs/cli-integration.md +3 -5
  401. package/docs/cli.md +45 -26
  402. package/docs/compaction.md +9 -9
  403. package/docs/configuration.md +1 -2
  404. package/docs/containerization.md +16 -14
  405. package/docs/custom-provider.md +5 -3
  406. package/docs/docs.json +9 -9
  407. package/docs/environment-variables.md +5 -12
  408. package/docs/extensions.md +683 -757
  409. package/docs/how-pi-works.md +5 -5
  410. package/docs/index.md +5 -5
  411. package/docs/llama-cpp.md +41 -39
  412. package/docs/mcp.md +12 -10
  413. package/docs/message-types.md +1 -1
  414. package/docs/models-configuration.md +6 -1
  415. package/docs/models.md +18 -19
  416. package/docs/nvidia-rtx-llama-cpp.md +1 -1
  417. package/docs/packages.md +21 -1
  418. package/docs/prompt-templates.md +11 -9
  419. package/docs/providers.md +8 -8
  420. package/docs/quickstart.md +28 -52
  421. package/docs/rpc-commands.md +2 -2
  422. package/docs/rpc-extension-ui.md +5 -7
  423. package/docs/rpc.md +4 -2
  424. package/docs/sdk.md +1 -1
  425. package/docs/security.md +9 -5
  426. package/docs/session-format.md +7 -9
  427. package/docs/sessions.md +26 -26
  428. package/docs/settings.md +36 -67
  429. package/docs/shell-aliases.md +7 -7
  430. package/docs/skills.md +4 -4
  431. package/docs/slash-commands.md +50 -58
  432. package/docs/termux.md +8 -9
  433. package/docs/themes.md +21 -41
  434. package/docs/usage.md +59 -177
  435. package/docs/virtual-models.md +4 -4
  436. package/docs/windows.md +8 -10
  437. package/examples/extensions/README.md +3 -2
  438. package/examples/extensions/custom-provider-anthropic/index.ts +27 -31
  439. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  440. package/examples/extensions/custom-provider-anthropic/package.json +1 -1
  441. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  442. package/examples/extensions/gondolin/package-lock.json +16 -26
  443. package/examples/extensions/gondolin/package.json +2 -2
  444. package/examples/extensions/reload-runtime.ts +17 -5
  445. package/examples/extensions/rpc-demo.ts +2 -2
  446. package/examples/extensions/subagent/README.md +14 -11
  447. package/examples/extensions/with-deps/package-lock.json +2 -2
  448. package/examples/extensions/with-deps/package.json +1 -1
  449. package/examples/tsconfig.json +208 -0
  450. package/npm-shrinkwrap.json +32 -34
  451. package/package.json +12 -14
  452. package/schemas/models.schema.json +65 -36
  453. package/schemas/settings.schema.json +17 -243
  454. package/dist/bundle/chunks/anthropic-messages-WAYXCPZL.js +0 -6
  455. package/dist/bundle/chunks/azure-openai-responses-LUIPKPFC.js +0 -2
  456. package/dist/bundle/chunks/chunk-275CIYA5.js +0 -16
  457. package/dist/bundle/chunks/chunk-2W2ATKZM.js +0 -2
  458. package/dist/bundle/chunks/chunk-3V45WARH.js +0 -7
  459. package/dist/bundle/chunks/chunk-4LBJE4YM.js +0 -14
  460. package/dist/bundle/chunks/chunk-4NE64BTO.js +0 -82
  461. package/dist/bundle/chunks/chunk-7SFLP7ZK.js +0 -1197
  462. package/dist/bundle/chunks/chunk-BQU3RKDL.js +0 -2
  463. package/dist/bundle/chunks/chunk-NJK3U3WK.js +0 -8
  464. package/dist/bundle/chunks/chunk-NQWQE4BR.js +0 -11
  465. package/dist/bundle/chunks/chunk-TEPMHNKQ.js +0 -2
  466. package/dist/bundle/chunks/chunk-TRN3ET6M.js +0 -2
  467. package/dist/bundle/chunks/chunk-UE7JCDFW.js +0 -2
  468. package/dist/bundle/chunks/chunk-UKVNB6C4.js +0 -2
  469. package/dist/bundle/chunks/chunk-USJZMAIR.js +0 -2
  470. package/dist/bundle/chunks/cli-W5KJM7YB.js +0 -51
  471. package/dist/bundle/chunks/mistral-conversations-FEBYNTL2.js +0 -5
  472. package/dist/bundle/chunks/openai-codex-responses-MI7TTP3C.js +0 -10
  473. package/dist/bundle/chunks/openai-completions-BVORSTAM.js +0 -7
  474. package/dist/bundle/chunks/openai-responses-TLIV5OQA.js +0 -4
  475. package/dist/bundle/chunks/pi-messages-4MVQCGGY.js +0 -8
  476. package/dist/bundle/chunks/virtual-modules-QK7S56IZ.js +0 -2
  477. package/dist/core/bug-report-upload.d.ts +0 -12
  478. package/dist/core/bug-report-upload.d.ts.map +0 -1
  479. package/dist/core/bug-report-upload.js +0 -22
  480. package/dist/core/bug-report-upload.js.map +0 -1
  481. package/dist/core/bug-report.d.ts +0 -184
  482. package/dist/core/bug-report.d.ts.map +0 -1
  483. package/dist/core/bug-report.js +0 -292
  484. package/dist/core/bug-report.js.map +0 -1
  485. package/dist/core/crash-log.d.ts +0 -27
  486. package/dist/core/crash-log.d.ts.map +0 -1
  487. package/dist/core/crash-log.js +0 -140
  488. package/dist/core/crash-log.js.map +0 -1
  489. package/dist/core/footer-data-provider.d.ts +0 -64
  490. package/dist/core/footer-data-provider.d.ts.map +0 -1
  491. package/dist/core/footer-data-provider.js +0 -338
  492. package/dist/core/footer-data-provider.js.map +0 -1
  493. package/dist/utils/zip.d.ts +0 -7
  494. package/dist/utils/zip.d.ts.map +0 -1
  495. package/dist/utils/zip.js +0 -60
  496. package/dist/utils/zip.js.map +0 -1
  497. package/docs/images/interactive-mode.png +0 -0
  498. package/docs/images/tree-view.png +0 -0
  499. package/docs/keybindings.md +0 -194
  500. package/docs/terminal-setup.md +0 -17
  501. package/docs/tmux.md +0 -55
  502. package/docs/tui.md +0 -125
  503. package/examples/extensions/sandbox/index.ts +0 -321
  504. package/examples/extensions/sandbox/package-lock.json +0 -66
  505. package/examples/extensions/sandbox/package.json +0 -22
@@ -1,37 +1,16 @@
1
1
  /**
2
- * OAuth sign-in for remote MCP servers.
2
+ * OAuth sign-in for remote MCP servers: pi's credential store and its side of the sign-in.
3
3
  *
4
4
  * Connections never start a browser flow on their own. They send the stored access token and, after
5
5
  * a 401, try the stored refresh token. When that is not possible they fail with
6
- * `McpOAuthAuthorizationRequiredError`, and the user signs in through `/mcp`, which runs
7
- * the authorization code flow (PKCE, a Client ID Metadata Document or dynamic client registration)
8
- * against a loopback callback.
6
+ * `McpOAuthAuthorizationRequiredError`, and the user signs in through `/mcp` or `pi mcp login`, which
7
+ * run pi-mcp's sign-in (PKCE, pi's Client ID Metadata Document or dynamic client registration) against
8
+ * a loopback callback or a pasted redirect URL.
9
9
  *
10
10
  * Credentials live in `<agent-dir>/mcp-auth.json`, keyed by server name and URL.
11
11
  */
12
- import type { AuthProvider } from "@punch-bot/mcp";
13
- import { type McpOAuthState, type McpOAuthStateStore, type OAuthChallenge } from "@punch-bot/mcp/oauth";
12
+ import { type McpAuthProvider, type McpOAuthServerStore, type McpOAuthSettings, type McpOAuthState, type OAuthChallenge } from "@punch-bot/mcp/oauth";
14
13
  import { type AuthStorageBackend } from "../../core/auth-storage.ts";
15
- export interface McpOAuthSettings {
16
- clientId?: string;
17
- /** Already resolved. */
18
- clientSecret?: string;
19
- callbackPort?: number;
20
- /** Loopback redirect URI; see `McpOAuthConfig.callbackUrl`. */
21
- callbackUrl?: string;
22
- /** Scopes to request, separated by spaces. */
23
- scope?: string;
24
- /** `client_name` for dynamic client registration. Default: `APP_NAME`. */
25
- clientName?: string;
26
- /** See `McpOAuthConfig.clientRegistration`. */
27
- clientRegistration?: "dcr" | "cimd";
28
- /** See `McpOAuthConfig.authServerMetadataUrl`. */
29
- authServerMetadataUrl?: URL;
30
- }
31
- export interface McpOAuthServerStore extends McpOAuthStateStore {
32
- /** Run `fn` while no other process refreshes the server's tokens. */
33
- withRefreshLock<T>(fn: () => Promise<T>): Promise<T>;
34
- }
35
14
  /** Per-server OAuth state (client registration, tokens, pending PKCE verifier) in `mcp-auth.json`. */
36
15
  export declare class McpOAuthCredentialStore {
37
16
  private readonly backend;
@@ -42,6 +21,7 @@ export declare class McpOAuthCredentialStore {
42
21
  /**
43
22
  * A lock file per server. When the process exits, proper-lockfile removes the locks it holds; when
44
23
  * it is killed, the lock goes stale because it is no longer renewed, and the next process takes it over.
24
+ * Throws `McpRefreshLockBusyError` when another process holds the lock for the whole wait.
45
25
  */
46
26
  private withRefreshLock;
47
27
  /** The stored tokens of a server, for noticing sign-ins done by another process. Does not take over legacy state. */
@@ -50,23 +30,7 @@ export declare class McpOAuthCredentialStore {
50
30
  remove(name: string, serverUrl: string): boolean;
51
31
  private write;
52
32
  }
53
- export interface McpAuthProvider extends AuthProvider {
54
- /** Resolves when no refresh is running, so shutdown does not drop rotated tokens before they are saved. */
55
- settled(): Promise<void>;
56
- }
57
- /**
58
- * Auth provider for MCP connections: sends the stored access token and refreshes it when it is about
59
- * to expire or after a 401. Throws `McpOAuthAuthorizationRequiredError` when the user has to sign in,
60
- * including when the server asks for more scope (`insufficient_scope`). `onChallenge` receives the
61
- * server's `WWW-Authenticate` challenge so sign-in can use its resource metadata URL and scope.
62
- * `settings` is only called when a refresh is needed, so a secret that fails to resolve fails the
63
- * refresh instead of the whole connection setup.
64
- *
65
- * Many servers rotate refresh tokens, so two refreshes with the same refresh token lose the grant.
66
- * Requests in this process share one refresh, and other processes are kept out by the store's
67
- * refresh lock, held from reading the tokens to saving new ones. Tokens that changed meanwhile
68
- * (another process refreshed them, or the user signed in) are used without refreshing.
69
- */
33
+ /** pi-mcp's `createMcpAuthProvider` with pi's client identity. */
70
34
  export declare function createMcpAuthProvider(options: {
71
35
  serverUrl: string;
72
36
  store: McpOAuthServerStore;
@@ -83,17 +47,15 @@ export interface McpSignInPrompt {
83
47
  */
84
48
  promptForRedirectUrl(signal: AbortSignal): Promise<string | undefined>;
85
49
  }
86
- export declare class McpSignInCancelledError extends Error {
87
- constructor();
88
- }
89
50
  /**
90
51
  * Sign in to an MCP server. Uses the stored refresh token when possible; otherwise runs the browser
91
- * authorization code flow. Tokens are saved to `store`. Aborting `signal` stops the sign-in at any
92
- * step with `McpSignInCancelledError`; requests to the authorization server are also time-limited.
52
+ * authorization code flow against a loopback callback or a pasted redirect URL. Tokens are saved to
53
+ * `store`. Aborting `signal` stops the sign-in at any step with `McpSignInCancelledError`; requests to
54
+ * the authorization server are also time-limited.
93
55
  */
94
56
  export declare function signInMcpServer(options: {
95
57
  serverUrl: string;
96
- store: McpOAuthStateStore;
58
+ store: McpOAuthServerStore;
97
59
  settings: McpOAuthSettings;
98
60
  challenge?: OAuthChallenge;
99
61
  prompt: McpSignInPrompt;
@@ -1 +1 @@
1
- {"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAKN,KAAK,aAAa,EAClB,KAAK,kBAAkB,EAIvB,KAAK,cAAc,EAKnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,KAAK,kBAAkB,EAA0B,MAAM,4BAA4B,CAAC;AAsB7F,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACpC,kDAAkD;IAClD,qBAAqB,CAAC,EAAE,GAAG,CAAC;CAC5B;AA8DD,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC9D,qEAAqE;IACrE,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACrD;AAED,sGAAsG;AACtG,qBAAa,uBAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,wGAAwG;IACxG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,YAAY,OAAO,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,MAAM,EAGzD;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAkB9D;IAED;;;OAGG;YACW,eAAe;IAuB7B,qHAAqH;IACrH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAI/D;IAED,+GAA+G;IAC/G,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAS/C;IAED,OAAO,CAAC,KAAK;CAOb;AAuED,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACpD,2GAA2G;IAC3G,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,MAAM,gBAAgB,CAAC;IACjC,WAAW,EAAE,CAAC,SAAS,EAAE,cAAc,KAAK,IAAI,CAAC;CACjD,GAAG,eAAe,CAwDlB;AAED,MAAM,WAAW,eAAe;IAC/B,uEAAuE;IACvE,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvE;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IACjD,cAGC;CACD;AA4ED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8EhB"}
1
+ {"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAIN,KAAK,eAAe,EAEpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAGlB,KAAK,cAAc,EAGnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,KAAK,kBAAkB,EAA0B,MAAM,4BAA4B,CAAC;AA8B7F,sGAAsG;AACtG,qBAAa,uBAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,wGAAwG;IACxG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,YAAY,OAAO,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,MAAM,EAGzD;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAkB9D;IAED;;;;OAIG;YACW,eAAe;IA8B7B,qHAAqH;IACrH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAI/D;IAED,+GAA+G;IAC/G,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAS/C;IAED,OAAO,CAAC,KAAK;CAOb;AAiBD,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,MAAM,gBAAgB,CAAC;IACjC,WAAW,EAAE,CAAC,SAAS,EAAE,cAAc,KAAK,IAAI,CAAC;CACjD,GAAG,eAAe,CAElB;AAED,MAAM,WAAW,eAAe;IAC/B,uEAAuE;IACvE,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvE;AAQD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBhB"}
@@ -1,11 +1,11 @@
1
1
  /**
2
- * OAuth sign-in for remote MCP servers.
2
+ * OAuth sign-in for remote MCP servers: pi's credential store and its side of the sign-in.
3
3
  *
4
4
  * Connections never start a browser flow on their own. They send the stored access token and, after
5
5
  * a 401, try the stored refresh token. When that is not possible they fail with
6
- * `McpOAuthAuthorizationRequiredError`, and the user signs in through `/mcp`, which runs
7
- * the authorization code flow (PKCE, a Client ID Metadata Document or dynamic client registration)
8
- * against a loopback callback.
6
+ * `McpOAuthAuthorizationRequiredError`, and the user signs in through `/mcp` or `pi mcp login`, which
7
+ * run pi-mcp's sign-in (PKCE, pi's Client ID Metadata Document or dynamic client registration) against
8
+ * a loopback callback or a pasted redirect URL.
9
9
  *
10
10
  * Credentials live in `<agent-dir>/mcp-auth.json`, keyed by server name and URL.
11
11
  */
@@ -13,55 +13,17 @@ import { createHash } from "node:crypto";
13
13
  import { mkdirSync } from "node:fs";
14
14
  import { join } from "node:path";
15
15
  import { oauthErrorHtml, oauthSuccessHtml } from "@punch-bot/ai/utils/oauth-page";
16
- import { authorizeMcp, McpOAuthAuthorizationRequiredError, McpOAuthProvider, OAuthCallbackServer, parseWwwAuthenticate, stepUpScope, } from "@punch-bot/mcp/oauth";
16
+ import { mcpNamespace } from "@punch-bot/mcp";
17
+ import { completeMcpSignIn, createMcpAuthProvider as createAuthProvider, listenForLoopbackSignIn, McpRefreshLockBusyError, startMcpSignIn, waitForLoopbackSignIn, } from "@punch-bot/mcp/oauth";
17
18
  import lockfile from "proper-lockfile";
18
19
  import { APP_NAME, getAgentDir } from "../../config.js";
19
20
  import { FileAuthStorageBackend } from "../../core/auth-storage.js";
20
- import { mcpNamespace } from "../../core/mcp-servers.js";
21
- const CALLBACK_HOST = "127.0.0.1";
22
- const CALLBACK_PATH = "/callback";
23
- /** Where pi.dev serves pi's Client ID Metadata Documents: `client.json` and `<callback ID>/client.json`. */
24
- const CLIENT_METADATA_BASE_URL = "https://pi.dev/oauth";
25
- /** Redirect URI for refreshes when none is stored. Refreshing never redirects the user. */
26
- const FALLBACK_REDIRECT_URL = `http://${CALLBACK_HOST}${CALLBACK_PATH}`;
27
- /** Access tokens this close to expiry are refreshed before they are sent. */
28
- const REFRESH_SKEW_MS = 30_000;
29
- /**
30
- * Bounds each request to the authorization server, so an unresponsive one cannot hold the refresh lock,
31
- * delay shutdown, or keep a sign-in waiting for long.
32
- */
33
- const OAUTH_REQUEST_TIMEOUT_MS = 15_000;
21
+ import { isClientMetadataDocumentCallback } from "../../core/mcp-servers.js";
34
22
  /** A refresh lock that its holder stopped renewing (the process was killed) is taken over after this. */
35
23
  const REFRESH_LOCK_STALE_MS = 20_000;
36
24
  /** How long to wait for another process's refresh: longer than a stale lock lives. */
37
25
  const REFRESH_LOCK_WAIT_MS = 25_000;
38
26
  const REFRESH_LOCK_RETRY_MS = 100;
39
- function callbackSettings(settings) {
40
- const url = new URL(settings.callbackUrl ?? `http://${CALLBACK_HOST}${CALLBACK_PATH}`);
41
- const address = url.hostname.replace(/^\[|\]$/g, "");
42
- const port = url.port ? Number(url.port) : settings.callbackPort;
43
- let fixedRedirectUrl;
44
- // A configured URI with a port is sent exactly as written, since servers compare it as a string.
45
- if (url.port)
46
- fixedRedirectUrl = settings.callbackUrl;
47
- else if (port !== undefined) {
48
- url.port = String(port);
49
- fixedRedirectUrl = url.href;
50
- }
51
- return {
52
- // `localhost` is served on 127.0.0.1; browsers fall back to it when ::1 refuses.
53
- host: address === "localhost" ? CALLBACK_HOST : address,
54
- redirectHost: address,
55
- port,
56
- path: url.pathname,
57
- fixedRedirectUrl,
58
- };
59
- }
60
- /** Scopes of both lists, each once. */
61
- function mergeScopes(...scopes) {
62
- const merged = [...new Set(scopes.flatMap((scope) => scope?.split(/\s+/).filter(Boolean) ?? []))];
63
- return merged.length > 0 ? merged.join(" ") : undefined;
64
- }
65
27
  function parseStates(content) {
66
28
  if (!content?.trim())
67
29
  return {};
@@ -109,13 +71,15 @@ export class McpOAuthCredentialStore {
109
71
  /**
110
72
  * A lock file per server. When the process exits, proper-lockfile removes the locks it holds; when
111
73
  * it is killed, the lock goes stale because it is no longer renewed, and the next process takes it over.
74
+ * Throws `McpRefreshLockBusyError` when another process holds the lock for the whole wait.
112
75
  */
113
76
  async withRefreshLock(key, fn) {
114
77
  if (!this.lockDir)
115
78
  return fn();
116
79
  mkdirSync(this.lockDir, { recursive: true, mode: 0o700 });
117
80
  const hash = createHash("sha256").update(key).digest("hex").slice(0, 16);
118
- const release = await lockfile.lock(join(this.lockDir, `mcp-auth-refresh-${hash}`), {
81
+ const release = await lockfile
82
+ .lock(join(this.lockDir, `mcp-auth-refresh-${hash}`), {
119
83
  realpath: false,
120
84
  stale: REFRESH_LOCK_STALE_MS,
121
85
  retries: {
@@ -126,6 +90,12 @@ export class McpOAuthCredentialStore {
126
90
  },
127
91
  // The default throws from a timer. A lost lock at worst lets two refreshes overlap.
128
92
  onCompromised: () => { },
93
+ })
94
+ .catch((error) => {
95
+ // proper-lockfile reports a lock held by another process as `ELOCKED`.
96
+ if (error instanceof Error && "code" in error && error.code === "ELOCKED")
97
+ throw new McpRefreshLockBusyError();
98
+ throw error;
129
99
  });
130
100
  try {
131
101
  return await fn();
@@ -160,266 +130,56 @@ export class McpOAuthCredentialStore {
160
130
  });
161
131
  }
162
132
  }
163
- /** `fetch` with `OAUTH_REQUEST_TIMEOUT_MS` per request, on top of the request's own signal. */
164
- function timedFetch(fetch = globalThis.fetch) {
165
- return (input, init) => {
166
- const timeout = AbortSignal.timeout(OAUTH_REQUEST_TIMEOUT_MS);
167
- return fetch(input, { ...init, signal: init?.signal ? AbortSignal.any([init.signal, timeout]) : timeout });
168
- };
169
- }
170
- function registeredRedirectUrls(client) {
171
- return client && "redirect_uris" in client ? client.redirect_uris : [];
172
- }
173
- /** 12 characters identifying an MCP server URL in callback paths, computed like Codex does. */
174
- function callbackId(serverUrl) {
175
- const url = new URL(serverUrl);
176
- url.hash = "";
177
- return createHash("sha256").update(url.href).digest().subarray(0, 9).toString("base64url");
178
- }
179
- /**
180
- * pi's Client ID Metadata Document, for `clientRegistration: "cimd"`, chosen like Codex chooses its own.
181
- * The configuration ensures the default callback path. Without the `iss` parameter in authorization
182
- * responses (RFC 9207), the redirect URI and the document are specific to the MCP server, so a response
183
- * cannot be mixed up with one from another authorization server (RFC 9700 section 4.4.2.2).
184
- */
185
- function clientMetadataDocument(serverUrl, redirectUrl, metadata) {
186
- if (!metadata?.client_id_metadata_document_supported ||
187
- !metadata.token_endpoint_auth_methods_supported?.includes("none")) {
188
- throw new Error('The authorization server does not support Client ID Metadata Documents for public clients; remove oauth.clientRegistration "cimd"');
189
- }
190
- if (metadata.authorization_response_iss_parameter_supported) {
191
- return { url: `${CLIENT_METADATA_BASE_URL}/client.json`, redirectUrl };
192
- }
193
- const id = callbackId(serverUrl);
194
- const redirect = new URL(redirectUrl);
195
- redirect.pathname = `${CALLBACK_PATH}/${id}`;
196
- return { url: `${CLIENT_METADATA_BASE_URL}/${id}/client.json`, redirectUrl: redirect.href };
197
- }
198
- function createProvider(serverUrl, store, settings, redirectUrl, onRedirect) {
199
- return new McpOAuthProvider({
200
- serverUrl,
201
- redirectUrl,
202
- clientMetadata: { client_name: settings.clientName ?? APP_NAME },
203
- clientMetadataDocument: settings.clientRegistration === "cimd"
204
- ? (metadata) => clientMetadataDocument(serverUrl, redirectUrl, metadata)
205
- : undefined,
206
- clientId: settings.clientId,
207
- clientSecret: settings.clientSecret,
208
- store,
209
- onRedirect,
210
- });
133
+ /** pi's Client ID Metadata Documents on pi.dev: `client.json` and `<callback ID>/client.json`. */
134
+ const PI_CLIENT_METADATA_DOCUMENTS = {
135
+ baseUrl: "https://pi.dev/oauth",
136
+ listsRedirectUrl: isClientMetadataDocumentCallback,
137
+ };
138
+ /** pi's client identity for sign-in and refresh. */
139
+ const PI_CLIENT = { clientName: APP_NAME, clientMetadataDocuments: PI_CLIENT_METADATA_DOCUMENTS };
140
+ /** `settings` for pi-mcp: a rebranded build would show up as pi with pi's documents, so `auto` registers. */
141
+ function piSettings(settings) {
142
+ const auto = (settings.clientRegistration ?? "auto") === "auto";
143
+ return auto && APP_NAME !== "pi" ? { ...settings, clientRegistration: "dcr" } : settings;
211
144
  }
212
- /**
213
- * Auth provider for MCP connections: sends the stored access token and refreshes it when it is about
214
- * to expire or after a 401. Throws `McpOAuthAuthorizationRequiredError` when the user has to sign in,
215
- * including when the server asks for more scope (`insufficient_scope`). `onChallenge` receives the
216
- * server's `WWW-Authenticate` challenge so sign-in can use its resource metadata URL and scope.
217
- * `settings` is only called when a refresh is needed, so a secret that fails to resolve fails the
218
- * refresh instead of the whole connection setup.
219
- *
220
- * Many servers rotate refresh tokens, so two refreshes with the same refresh token lose the grant.
221
- * Requests in this process share one refresh, and other processes are kept out by the store's
222
- * refresh lock, held from reading the tokens to saving new ones. Tokens that changed meanwhile
223
- * (another process refreshed them, or the user signed in) are used without refreshing.
224
- */
145
+ /** pi-mcp's `createMcpAuthProvider` with pi's client identity. */
225
146
  export function createMcpAuthProvider(options) {
226
- const { serverUrl, store } = options;
227
- let refreshing;
228
- /** Replace `staleToken`, the access token that expired or was rejected. */
229
- const refresh = (staleToken, fetch = globalThis.fetch, challenge) => {
230
- refreshing ??= store
231
- .withRefreshLock(async () => {
232
- const state = await store.load();
233
- if (state?.tokens?.access_token !== staleToken)
234
- return;
235
- if (!state?.tokens?.refresh_token)
236
- throw new McpOAuthAuthorizationRequiredError();
237
- const settings = options.settings();
238
- const redirectUrl = callbackSettings(settings).fixedRedirectUrl ??
239
- registeredRedirectUrls(state.clientInformation)[0] ??
240
- FALLBACK_REDIRECT_URL;
241
- const provider = createProvider(serverUrl, store, settings, redirectUrl, () => { });
242
- // Refreshes the tokens, or reports that a new sign-in is needed. Not cancellable: a refresh the
243
- // server answered may have rotated the refresh token, so its answer must be saved.
244
- const result = await authorizeMcp(provider, {
245
- serverUrl,
246
- resourceMetadataUrl: challenge?.resourceMetadataUrl,
247
- authorizationServerMetadataUrl: settings.authServerMetadataUrl,
248
- scope: challenge?.scope,
249
- fetch: timedFetch(fetch),
250
- });
251
- if (result === "REDIRECT")
252
- throw new McpOAuthAuthorizationRequiredError();
253
- })
254
- .finally(() => {
255
- refreshing = undefined;
256
- });
257
- return refreshing;
258
- };
259
- return {
260
- token: async () => {
261
- await refreshing?.catch(() => undefined);
262
- const state = await store.load();
263
- const token = state?.tokens?.access_token;
264
- const expired = state?.tokensExpireAt !== undefined && state.tokensExpireAt - REFRESH_SKEW_MS <= Date.now();
265
- if (!expired || !state?.tokens?.refresh_token)
266
- return token;
267
- // Failures fall through: the request goes out with the old token and a 401 decides what happens.
268
- await refresh(token).catch(() => undefined);
269
- return (await store.load())?.tokens?.access_token;
270
- },
271
- onUnauthorized: async (context) => {
272
- const challenge = parseWwwAuthenticate(context.response.headers.get("www-authenticate"));
273
- options.onChallenge(challenge);
274
- // A refresh keeps the granted scope, so more scope needs a new sign-in.
275
- if (challenge.error === "insufficient_scope")
276
- throw new McpOAuthAuthorizationRequiredError();
277
- await refresh(context.token, context.fetch, challenge);
278
- },
279
- settled: async () => {
280
- await refreshing?.catch(() => undefined);
281
- },
282
- };
283
- }
284
- export class McpSignInCancelledError extends Error {
285
- constructor() {
286
- super("Sign-in cancelled");
287
- this.name = "McpSignInCancelledError";
288
- }
289
- }
290
- function responseFromRedirectUrl(input, state, redirectUrl) {
291
- let url;
292
- try {
293
- url = new URL(input.trim());
294
- }
295
- catch {
296
- throw new Error("Expected the full redirect URL from the browser address bar");
297
- }
298
- // A server-specific redirect URI tells authorization servers apart, so it must match exactly.
299
- if (url.origin !== redirectUrl.origin || url.pathname !== redirectUrl.pathname) {
300
- throw new Error("The redirect URL does not match this sign-in's redirect URI");
301
- }
302
- const error = url.searchParams.get("error");
303
- if (error)
304
- throw new Error(url.searchParams.get("error_description") ?? error);
305
- if (url.searchParams.get("state") !== state)
306
- throw new Error("The redirect URL belongs to a different sign-in");
307
- const code = url.searchParams.get("code");
308
- if (!code)
309
- throw new Error("The redirect URL does not contain an authorization code");
310
- return { code, iss: url.searchParams.get("iss") ?? undefined };
147
+ return createAuthProvider({ ...options, ...PI_CLIENT, settings: () => piSettings(options.settings()) });
311
148
  }
312
- /**
313
- * Wait for the browser callback or a pasted redirect URL, whichever comes first. Aborting `signal`
314
- * aborts the prompt, which then cancels the sign-in.
315
- */
316
- async function waitForAuthorizationResponse(callback, state, redirectUrl, prompt, signal) {
317
- const controller = new AbortController();
318
- const promptSignal = signal ? AbortSignal.any([controller.signal, signal]) : controller.signal;
319
- const fromBrowser = callback.waitForCallback(state, redirectUrl.pathname);
320
- const fromUser = prompt.promptForRedirectUrl(promptSignal).then((input) => {
321
- if (!input?.trim())
322
- throw new McpSignInCancelledError();
323
- return responseFromRedirectUrl(input, state, redirectUrl);
324
- });
325
- try {
326
- return await Promise.race([fromBrowser, fromUser]);
327
- }
328
- finally {
329
- // The losing side rejects once the prompt is aborted or the callback server closes.
330
- controller.abort();
331
- fromBrowser.catch(() => undefined);
332
- fromUser.catch(() => undefined);
333
- }
334
- }
335
- /** Listen on `port`, or on a free port when it is taken and not `required`. */
336
- async function listenForCallback(settings, extraPaths, port, required) {
337
- const options = {
338
- host: settings.host,
339
- redirectHost: settings.redirectHost,
340
- path: settings.path,
341
- extraPaths,
342
- renderPage: (page) => page.ok
343
- ? oauthSuccessHtml("Signed in to the MCP server. You may now close this page.")
344
- : oauthErrorHtml(page.message, page.details),
345
- };
346
- try {
347
- return await OAuthCallbackServer.listen({ ...options, port: port ?? 0 });
348
- }
349
- catch (error) {
350
- if (required || port === undefined)
351
- throw error;
352
- return OAuthCallbackServer.listen(options);
353
- }
149
+ function renderCallbackPage(page) {
150
+ return page.ok
151
+ ? oauthSuccessHtml("Signed in to the MCP server. You may now close this page.")
152
+ : oauthErrorHtml(page.message, page.details);
354
153
  }
355
154
  /**
356
155
  * Sign in to an MCP server. Uses the stored refresh token when possible; otherwise runs the browser
357
- * authorization code flow. Tokens are saved to `store`. Aborting `signal` stops the sign-in at any
358
- * step with `McpSignInCancelledError`; requests to the authorization server are also time-limited.
156
+ * authorization code flow against a loopback callback or a pasted redirect URL. Tokens are saved to
157
+ * `store`. Aborting `signal` stops the sign-in at any step with `McpSignInCancelledError`; requests to
158
+ * the authorization server are also time-limited.
359
159
  */
360
160
  export async function signInMcpServer(options) {
361
- const { serverUrl, store, settings, signal } = options;
362
- if (signal?.aborted)
363
- throw new McpSignInCancelledError();
364
- const stored = await store.load();
365
- const stepUp = options.challenge?.error === "insufficient_scope";
366
- const callbackOptions = callbackSettings(settings);
367
- // Reuse the port of the registered redirect URI so the registered client stays valid.
368
- const registered = registeredRedirectUrls(stored?.clientInformation)[0];
369
- const preferredPort = callbackOptions.port ?? (registered ? Number(new URL(registered).port) || undefined : undefined);
370
- const cimd = settings.clientRegistration === "cimd";
371
- const callback = await listenForCallback(callbackOptions,
372
- // The redirect URI of a server-specific Client ID Metadata Document.
373
- cimd ? [`${CALLBACK_PATH}/${callbackId(serverUrl)}`] : [], preferredPort, callbackOptions.port !== undefined);
374
- const redirectUrl = callbackOptions.fixedRedirectUrl ?? callback.redirectUrl;
161
+ const { serverUrl, store, challenge, prompt, signal } = options;
162
+ const settings = piSettings(options.settings);
163
+ const { callback, redirectUrl } = await listenForLoopbackSignIn({
164
+ serverUrl,
165
+ store,
166
+ settings,
167
+ clientMetadataDocuments: PI_CLIENT_METADATA_DOCUMENTS,
168
+ renderPage: renderCallbackPage,
169
+ });
375
170
  try {
376
- if (stored) {
377
- const next = { ...stored };
378
- // Every sign-in gets a fresh `state` parameter.
379
- delete next.oauthState;
380
- // A registered client cannot use another redirect URI, and its tokens belong to it. A Client ID
381
- // Metadata Document is not stored, so with one, a stored client was registered before and is replaced.
382
- const keepClient = settings.clientId ||
383
- (cimd ? !stored.clientInformation : registeredRedirectUrls(stored.clientInformation).includes(redirectUrl));
384
- if (!keepClient) {
385
- delete next.clientInformation;
386
- delete next.tokens;
387
- delete next.tokensExpireAt;
388
- }
389
- await store.save(next);
390
- }
391
- let authorizationUrl;
392
- const provider = createProvider(serverUrl, store, settings, redirectUrl, (url) => {
393
- authorizationUrl = url;
394
- });
395
- const flow = {
396
- serverUrl,
397
- fetch: timedFetch(),
398
- signal,
399
- resourceMetadataUrl: options.challenge?.resourceMetadataUrl,
400
- authorizationServerMetadataUrl: settings.authServerMetadataUrl,
401
- // A server asking for more scope gets it on top of the configured scope and, since the challenge
402
- // may list only the missing scopes, on top of the scope granted so far.
403
- scope: mergeScopes(settings.scope, stepUp ? stepUpScope(stored?.tokens?.scope, options.challenge?.scope) : options.challenge?.scope),
404
- };
405
- // A refresh keeps the granted scope; a server asking for more needs the browser flow.
406
- const skipRefresh = stepUp;
407
- if ((await authorizeMcp(provider, { ...flow, skipRefresh })) === "AUTHORIZED")
171
+ const signIn = { serverUrl, store, settings, redirectUrl, challenge, signal, ...PI_CLIENT };
172
+ const authorization = await startMcpSignIn(signIn);
173
+ if (authorization.kind === "authorized")
408
174
  return;
409
- if (!authorizationUrl)
410
- throw new Error("OAuth flow did not produce an authorization URL");
411
- const state = await provider.state();
412
- // The flow picks the redirect URI, which may be specific to the MCP server.
413
- const authorizationRedirectUrl = new URL(authorizationUrl.searchParams.get("redirect_uri") ?? redirectUrl);
414
- options.prompt.showAuthorizationUrl(authorizationUrl);
415
- const { code, iss } = await waitForAuthorizationResponse(callback, state, authorizationRedirectUrl, options.prompt, signal);
416
- await authorizeMcp(provider, { ...flow, authorizationCode: code, iss });
417
- }
418
- catch (error) {
419
- // Aborted requests fail with the signal's reason; report them as the cancellation they are.
420
- if (signal?.aborted)
421
- throw new McpSignInCancelledError();
422
- throw error;
175
+ prompt.showAuthorizationUrl(new URL(authorization.authorizationUrl));
176
+ const response = await waitForLoopbackSignIn({
177
+ callback,
178
+ authorization,
179
+ promptForRedirectUrl: (promptSignal) => prompt.promptForRedirectUrl(promptSignal),
180
+ signal,
181
+ });
182
+ await completeMcpSignIn({ ...signIn, authorization, response });
423
183
  }
424
184
  finally {
425
185
  await callback.close();